Полное руководство по работе с пакетами Python

Расширенные примеры управления библиотеками

Дополнительные сценарии работы с пакетами, которые часто встречаются на практике.

Создание собственного пакета и локальная установка

# Структура проекта:
# mypackage/
#   __init__.py
#   module.py
# setup.py

# setup.py
from setuptools import setup, find_packages

setup(
    name='mypackage',
    version='0.1.0',
    packages=find_packages(),
    install_requires=[
        'requests>=2.25.0',
        'click'
    ],
    entry_points={
        'console_scripts': [
            'mycli=mypackage.module:main',
        ],
    },
)

# Установка из текущей папки
pip install .
# Использование в проекте
import mypackage

Successfully installed mypackage-0.1.0

Пояснение: setup.py описывает метаданные и зависимости. После pip install . пакет становится доступным для импорта. Утилита entry_points создаёт консольные команды.

Установка в режиме разработки (editable install)

# В той же структуре
pip install -e .
# Теперь изменения в исходниках сразу видны, без переустановки

Obtaining file:///path/to/project
Installing collected packages: mypackage
  Running setup.py develop for mypackage
Successfully installed mypackage

Пояснение: Режим -e создаёт ссылку на папку проекта. Удобно при активной разработке библиотеки.

Использование pip-tools для компиляции зависимостей

# Установка pip-tools
pip install pip-tools

# Файл requirements.in (непинтованные версии)
flask
numpy

# Компиляция requirements.txt
pip-compile requirements.in

#
# This file is autogenerated by pip-compile
# To update, run:
#
#    pip-compile requirements.in
#
click==8.1.7
    # via flask
flask==3.0.0
    # via -r requirements.in
numpy==1.26.2
    # via -r requirements.in
...

Пояснение: pip-compile создаёт полный список зависимостей с фиксацией версий, что гарантирует воспроизводимость. pip-sync приводит окружение в точное соответствие с requirements.txt.

Работа с приватным репозиторием PyPI

# Установка пакета из частного индекса
pip install mypackage --index-url https://my.private.repo/simple
# Или добавление в requirements.txt
--index-url https://my.private.repo/simple
mypackage>=1.0

Пояснение: Флаг --index-url задаёт альтернативный репозиторий. Можно использовать для внутренних библиотек компании.

Установка из локальной директории с --find-links

# Сохраняем скачанные .whl файлы в папку
ls ./packages/
# mypackage-1.0-py3-none-any.whl  other-2.0.whl
# Устанавливаем все из папки
pip install --no-index --find-links ./packages mypackage

Processing ./packages/mypackage-1.0-py3-none-any.whl
Installing collected packages: mypackage
Successfully installed mypackage-1.0

Пояснение: Позволяет устанавливать пакеты без доступа к Интернету, используя только локальные файлы.

Автоматизация установки через скрипт с парсингом requirements.txt

import subprocess
import sys

def install_requirements():
    with open('requirements.txt', 'r') as f:
        packages = [line.strip() for line in f if line.strip() and not line.startswith('#')]
    for pkg in packages:
        subprocess.check_call([sys.executable, '-m', 'pip', 'install', pkg])

install_requirements()

Пояснение: Скрипт читает файл и устанавливает пакеты программно. Полезно для CI/CD или при нестандартном окружении.

Использование virtualenvwrapper для управления несколькими окружениями

# Установка virtualenvwrapper (Linux/macOS)
pip install virtualenvwrapper
export WORKON_HOME=~/Envs
source /usr/local/bin/virtualenvwrapper.sh

# Создание окружения
mkvirtualenv myenv
# Переключение
workon myenv
# Деактивация
deactivate
# Удаление
rmvirtualenv myenv

Пояснение: Обёртка упрощает создание, переключение и удаление виртуальных окружений. Команды доступны глобально после настройки.

Контейнеризация Python-приложения с помощью Docker

# Dockerfile
FROM python:3.11-slim
WORKDIR /app
COPY requirements.txt .
RUN pip install --no-cache-dir -r requirements.txt
COPY . .
CMD ["python", "app.py"]

# Сборка образа
docker build -t myapp .
# Запуск
docker run myapp

Пояснение: Docker гарантирует изоляцию на уровне ОС. Зависимости устанавливаются внутри образа, что исключает проблемы окружения.