All 15 Modules & Packaging questions
More in Modules & Packaging
What does the `if __name__ == '__main__':` idiom accomplish, and why is it important for modules? How does pyproject.toml serve as the modern standard for defining a Python package's build configuration and dependencies? What is __all__ and how does it control `from module import *` behavior? What is the purpose of a `requirements.txt` file, and how does it differ from dependency declarations in pyproject.toml? How does Python locate modules during import, and what is sys.path's role? What is a namespace package, and how does it differ from a regular package? How does Python resolve circular imports, and what strategies avoid the resulting ImportError? How does importlib let you dynamically import a module by name at runtime? How do entry points in packaging metadata enable a package to register CLI commands or plugins? How does the module search and caching system handle submodule imports like `import package.subpackage.module`?
Advertisement
Back to results for “Modules & Packaging”
Python › Modules & Packaging

What does 'editable install' (pip install -e .) mean, and why is it useful during development?

Intermediate

Answer

An editable install links the installed package directly to your source directory (via a path configuration) instead of copying files into site-packages, so changes to your source code take effect immediately without reinstalling. This is standard practice when developing a package that other local code or tests need to import as if it were properly installed.
# From the project root containing pyproject.toml
pip install -e .

# Now edits to mypackage/*.py are immediately visible
# to any code that does `import mypackage`
Real-world example A developer working on a library alongside a sample application installs the library with `pip install -e .` so changes to the library's source are picked up instantly when running the sample app, without repackaging.

Common follow-ups: How does editable install differ from adding the source directory to PYTHONPATH manually?;What changed with PEP 660's editable install standard?

Virtual Environments & Dependency Management;Modules & Packaging
All 15 Modules & Packaging questions