Как узнать и управлять версией библиотеки в Python

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

Получение версий всех установленных пакетов

import importlib.metadata as md

distributions = md.distributions()
for dist in distributions:
    print(f"{dist.name} == {dist.version}")

certifi == 2023.7.22
charset-normalizer == 3.3.0
idna == 3.4
pip == 23.3.1
requests == 2.31.0
urllib3 == 2.1.0
...

Пояснение: функция distributions() возвращает итератор по всем установленным пакетам с доступом к метаданным. Это позволяет составить полный список зависимостей.

Сравнение версий с учётом pre-release

from packaging.version import Version, parse

v1 = Version("2.0.0a1")
v2 = Version("2.0.0")
print(v1 < v2)  # True, так как альфа-версия меньше релизной

# Использование parse для автоматического определения типа
v = parse("1.2.3.post1")
print(v.major, v.minor, v.micro, v.pre, v.post)

True
1 2 3 None 1

Пояснение: класс Version корректно обрабатывает пререлизные и пост-релизные метки, что важно для точных проверок.

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

import warnings
from importlib.metadata import version, PackageNotFoundError
from packaging.version import Version

try:
    ver = Version(version("numpy"))
    if ver < Version("1.20.0"):
        warnings.warn(f"NumPy {ver} устарел. Рекомендуется обновить до >= 1.20.0", DeprecationWarning)
except PackageNotFoundError:
    raise ImportError("Необходим пакет numpy")

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

Установка конкретной версии библиотеки из скрипта Python

import subprocess
import sys

def install_package(package, version=None):
    cmd = [sys.executable, "-m", "pip", "install"]
    if version:
        cmd.append(f"{package}=={version}")
    else:
        cmd.append(package)
    result = subprocess.run(cmd, capture_output=True, text=True)
    if result.returncode != 0:
        print(f"Ошибка: {result.stderr}")
    else:
        print(f"Установлен {package} версии {version or 'последней'}")

install_package("requests", "2.28.0")

Установлен requests версии 2.28.0

Пояснение: использование sys.executable гарантирует запуск pip из того же интерпретатора, что и скрипт. При указании версии через == pip установит точную версию.

Генерация requirements.txt с указанием версий

import subprocess

with open("requirements.txt", "w") as f:
    subprocess.run(["pip", "freeze", "--local"], stdout=f, text=True)

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

Получение версии библиотеки без импорта самого модуля (только по имени)

import sys
from importlib.metadata import version, distributions

def get_version_by_import_name(import_name):
    # Некоторые пакеты имеют другое имя при установке, чем при импорте.
    # Можно попробовать сопоставить по метаданным.
    for dist in distributions():
        if dist.metadata.get("Name") == import_name:
            return dist.version
    return None

print(get_version_by_import_name("Pillow"))  # обычно импортируется как PIL

10.1.0

Пояснение: этот метод полезен, когда имя пакета для pip (например, Pillow) отличается от имени модуля при импорте (PIL). Он перебирает все установленные дистрибутивы и сравнивает имя из метаданных.

Обработка ситуации, когда пакет установлен в нескольких местах (dist-packages vs site-packages)

import importlib.metadata as md
import sys

# Список всех путей поиска пакетов
for path in sys.path:
    try:
        # Можно использовать metadata.distributions(path=path) если поддерживается
        pass
    except:
        pass
# Простой способ: получить версию из первого найденного дистрибутива
# importlib.metadata уже возвращает первый найденный, что обычно достаточно.
print(md.version("requests"))

Пояснение: importlib.metadata использует стандартные пути поиска, поэтому дублирование версий маловероятно. Если возникает конфликт, помогает проверка порядка путей в sys.path.