pip update: обновление установленных пакетов в Python

Пример 1: Массовое обновление с помощью скрипта на Bash

Как автоматически обновить все пакеты и сохранить список до обновления?

Создайте скрипт update_all_packages.sh:

#!/bin/bash
# Back up current packages
pip freeze > requirements_backup.txt
echo "Backup saved to requirements_backup.txt"

# Get list of outdated packages and update each one
pip list --outdated --format=json | python -c "
import json, sys, subprocess
data = json.load(sys.stdin)
for pkg in data:
    name = pkg['name']
    print(f'Updating {name}...')
    subprocess.run(['pip', 'install', '--upgrade', name])
"

Результат выполнения (пример вывода):

Backup saved to requirements_backup.txt
Updating numpy...
Successfully installed numpy-1.26.0
Updating pandas...
Successfully installed pandas-2.1.0
...

Пояснение: Скрипт сначала сохраняет текущее состояние окружения, затем получает список устаревших пакетов в формате JSON и обновляет каждый, обрабатывая ошибки через subprocess.

Пример 2: Обновление пакетов с помощью pip-tools

Как безопасно обновлять зависимости проекта, разрешая конфликты автоматически?

Установите pip-tools и используйте команды pip-compile и pip-sync. Пример для файла requirements.in:

# requirements.in
requests
flask
numpy

Выполните сборку:

pip-compile --upgrade requirements.in

Это создаст обновлённый файл requirements.txt с точными версиями:

#
# This file is autogenerated by pip-compile with Python 3.11
# by the following command:
#    pip-compile --upgrade requirements.in
#
click==8.1.7
    # via flask
flask==3.0.0
    # via -r requirements.in
itsdangerous==2.1.2
    # via flask
jinja2==3.1.2
    # via flask
markupsafe==2.1.3
    # via jinja2
numpy==1.26.0
    # via -r requirements.in
requests==2.31.0
    # via -r requirements.in
urllib3==2.0.6
    # via requests
werkzeug==3.0.0
    # via flask

Затем синхронизируйте окружение:

pip-sync requirements.txt

Пояснение: pip-tools гарантирует, что зависимости будут согласованы между собой, и избегает ручного разрешения конфликтов.

Пример 3: Обновление пакета из приватного репозитория

Как обновить пакет, который установлен из собственного индекса пакетов?

Используйте флаг --index-url или --extra-index-url:

pip install --upgrade --index-url https://private-pypi.example.com/simple mypackage

Результат вывода:

Looking in indexes: https://private-pypi.example.com/simple
Collecting mypackage
  Downloading https://private-pypi.example.com/packages/mypackage-2.0.0.tar.gz
Successfully installed mypackage-2.0.0

Пояснение: Если у вас настроен собственный PyPI сервер, укажите его URL. Флаг --extra-index-url добавляет дополнительный источник, сохраняя при этом стандартный PyPI.

Пример 4: Обновление с использованием кэша в офлайн-режиме

Как обновить пакет, если нет доступа к интернету, но кэш уже загружен?

Предварительно скачайте пакет в кэш:

pip download --dest ./cache requests

Затем установите из локального кэша с флагом --find-links:

pip install --upgrade --no-index --find-links ./cache requests

Вывод:

Processing ./cache/requests-2.31.0-py3-none-any.whl
Installing collected packages: requests
Successfully installed requests-2.31.0

Пояснение: Флаг --no-index отключает обращение к PyPI, а --find-links указывает локальный каталог с дистрибутивами.

Пример 5: Обновление с проверкой совместимости через pip check

Как после обновления удостовериться, что все зависимости удовлетворены?

Выполните команду:

pip install --upgrade pandas && pip check

Пример вывода при проблеме:

Successfully installed pandas-2.1.0
pandas 2.1.0 requires numpy>=1.22.4, but you have numpy 1.21.0 which is incompatible.

Пояснение: pip check проверяет, не нарушены ли зависимости. Если обнаружены конфликты, их нужно устранить дополнительным обновлением (например, numpy).

Пример 6: Обновление с помощью pipenv

Как обновить зависимости в проекте, управляемом через Pipenv?

Используйте команду pipenv update:

pipenv update requests

Результат:

Updating requests from 2.28.0 to 2.31.0...
✔ Success! Updated requests to 2.31.0.

Для обновления всех пакетов:

pipenv update

Пояснение: Pipenv автоматически обновляет Pipfile.lock и разрешает зависимости, что снижает риск проблем.

Пример 7: Использование опции --only-binary для ускорения обновления

Как избежать сборки пакетов из исходников при обновлении?

Добавьте флаг --only-binary :all::

pip install --upgrade --only-binary :all: numpy

Вывод:

Looking in indexes: https://pypi.org/simple
Collecting numpy
  Downloading numpy-1.26.0-cp311-cp311-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (18.3 MB)
Successfully installed numpy-1.26.0

Пояснение: Этот флаг заставляет pip использовать только предварительно скомпилированные wheels, что ускоряет установку и снижает нагрузку на CPU.

Пример 8: Обновление с сохранением лога и откатом

Как обновить пакет и в случае неудачи откатить изменения?

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

#!/bin/bash
# Save current state
pip freeze > before_update.txt
# Attempt update
pip install --upgrade requests
if [ $? -ne 0 ]; then
    echo "Update failed. Restoring previous state..."
    pip install -r before_update.txt --force-reinstall
fi

Результат при успешном обновлении:

Successfully installed requests-2.31.0

При ошибке:

Update failed. Restoring previous state...
Installing collected packages: requests
Successfully installed requests-2.28.0

Пояснение: Скрипт сохраняет список текущих версий и, если обновление завершилось с ошибкой, восстанавливает предыдущее состояние через pip install.