Editable install подключает исходный каталог проекта к виртуальному окружению. После изменения функции не нужно заново собирать и устанавливать wheel. Режим удобен при разработке собственной библиотеки, но не предназначен для production-развертывания.

Базовая команда

python -m pip install -e .

Точка означает текущий проект. В нем должен находиться pyproject.toml или поддерживаемая конфигурация сборки. Современный механизм editable installation стандартизирован PEP 660 и зависит от возможностей выбранного backend.

Что обновляется сразу

Изменения в Python-файлах обычно видны при следующем запуске интерпретатора. Но метаданные проекта, зависимости, консольные команды и конфигурация сборки могут потребовать повторной установки. После изменения секции [project] снова выполните python -m pip install -e ..

Как проверить правильный источник

python -c "import sample_package; print(sample_package.__file__)"
python -m pip show sample-package

Первый путь должен указывать на ожидаемый исходный каталог. Если импорт идет из старой копии, проверьте активный интерпретатор и удалите дубликат пакета.

Почему нужен обычный wheel

Editable-режим может скрыть ошибки включения файлов в дистрибутив. Перед выпуском соберите wheel, установите его в новое окружение и запустите тесты без исходного каталога в рабочей директории. Руководство pip отдельно описывает обычные и editable-установки локальных проектов. Финальный процесс приведен в статье про сборку пакета.