Установка Python пакетов из локального репозитория

Пример 1: установка из wheel-файла с проверкой совместимости

Предположим, есть wheel-файл my_lib-2.1-cp39-cp39-manylinux_2_34_x86_64.whl. Установка:

pip install my_lib-2.1-cp39-cp39-manylinux_2_34_x86_64.whl

Processing ./my_lib-2.1-cp39-cp39-manylinux_2_34_x86_64.whl
Installing collected packages: my-lib
Successfully installed my-lib-2.1

При попытке установить тот же wheel на Python 3.8 возникнет ошибка совместимости. В таком случае используют опцию --force-reinstall или --ignore-requires-python (крайне не рекомендуется). Лучше найти правильный wheel или собрать его заново.

Пример 2: установка в виртуальное окружение с дополнительными индексами

Если основной пакет локальный, но некоторые его зависимости - из приватного PyPI-зеркала, можно совместить --find-links и --extra-index-url:

pip install \
    --find-links=/path/to/local/wheels \
    --extra-index-url=https://private-pypi.example.com/simple \
    ./my_package

Looking in links: /path/to/local/wheels
Looking in indexes: https://private-pypi.example.com/simple, https://pypi.org/simple
Processing ./my_package
Collecting requests>=2.0 (from my-package)
  Found in /path/to/local/wheels/requests-2.31.0-py3-none-any.whl
...
Successfully installed my-package-1.0 requests-2.31.0

Важно: порядок поиска - сначала локальные ссылки, потом внешние индексы. Если пакет есть и там и там, берётся первая подходящая версия.

Пример 3: полная изоляция с --no-index и кэшированием

Для установки на сервере без интернета все колёса заранее скачиваются и помещаются в архив. Команда установки:

pip install \
    --no-index \
    --find-links=/opt/offline-wheels \
    --cache-dir=/tmp/pip-cache \
    my_package==2.0

Looking in links: /opt/offline-wheels
Collecting my-package==2.0
  Found in /opt/offline-wheels/my_package-2.0-py3-none-any.whl
Collecting numpy>=1.20 (from my-package==2.0)
  Found in /opt/offline-wheels/numpy-1.24.3-cp39-cp39-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
...
Successfully installed my-package-2.0 numpy-1.24.3

Флаг --cache-dir позволяет указать временную папку для кэша, что ускоряет повторные установки.

Пример 4: установка пакета с игнорированием зависимостей и их ручной подстановкой

Иногда требуется установить локальный пакет без автоматического разрешения зависимостей, чтобы контролировать порядок или версии:

pip install --no-deps ./my_package
pip install requests==2.28.0
pip install packaging==24.0

Processing ./my_package
Installing collected packages: my_package
Successfully installed my_package-1.0
Collecting requests==2.28.0
...
Successfully installed requests-2.28.0 packaging-24.0

Такой подход используется, когда одна из зависимостей имеет конфликтующие требования, и хочется задать точные версии. После ручной установки стоит запустить pip check, чтобы убедиться в отсутствии несовместимостей.

Пример 5: установка из локального репозитория Git с использованием подмодуля

Если пакет оформлен как git-подмодуль, его можно установить напрямую:

git clone --recurse-submodules https://example.com/main-project.git
cd main-project
git submodule update --init --recursive
pip install ./submodules/my-package

При этом важно, что подмодуль содержит setup.py. Альтернативно, можно использовать синтаксис git+file:// из любого места:

pip install git+file:///абсолютный/путь/к/репозиторию@ветка#egg=my_package
--subdirectory=submodules/my-package

Collecting my-package from git+file:///абсолютный/путь/к/репозиторию@ветка#subdirectory=submodules/my-package
  Cloning...
...
Successfully installed my-package-0.1

Обратите внимание на флаг --subdirectory, который указывает на папку с пакетом внутри репозитория. Эта опция доступна в pip 21.3+.