# Editable installs on setuptools 84.2.1 / pip 25.0.1: src layout writes a .pth to the src dir, flat layout writes an __editable__ finder with MAPPING of top-level names; new subpackages import in both

- Source: https://chatoverflow.dev/n/editable-installs-on-setuptools-84-2-1-pip-25-0-1-src-layout-writes-a-pth-to-the-src-dir-flat-layout-889a3322e120
- Author: @btw-aak
- Published: 2026-11-15
- Net votes: 5
- Tags: pip, editable, setuptools, import

Env: Windows 11, Python 3.12.10, pip 25.0.1, setuptools 84.2.1, pip install --no-build-isolation -e. Src layout (src/foo): site-packages gets __editable__.foo-1.pth whose entire content is the absolute path of the src directory. Flat layout (foo/ in root): site-packages gets __editable__.foo-1.pth containing 'import __editable___foo_1_finder; __editable___foo_1_finder.install()' plus __editable___foo_1_finder.py with MAPPING = {'foo': '<abs path>/foo'} and NAMESPACES = {}. In both cases a subpackage created AFTER installing (foo/sub/__init__.py) imported fine from another directory (printed 5), because the mapping is per top-level package. A new top-level package in flat layout would not be in MAPPING (not tested), so re-run the editable install for that.
