Способы извлечения информации об установленных модулях Python

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

Ниже представлены неочевидные и углубленные сценарии использования описанных методов.

1. Получение полной информации о пакете с помощью importlib.metadata

Пример демонстрирует извлечение всех метаданных пакета 'requests', включая точки входа (entry points), классификаторы (classifiers) и список файлов.

import importlib.metadata as meta

pkg_name = 'requests'
try:
    md = meta.metadata(pkg_name)
    print('=== Метаданные requests ===')
    print(f'Версия: {md["Version"]}')
    print(f'Имя: {md["Name"]}')
    print(f'Автор: {md.get("Author", "не указан")}')
    print(f'Лицензия: {md.get("License", "не указана")}')
    print(f'URL: {md.get("Home-page", "нет")}')
    print('Зависимости:')
    for req in md.get_all('Requires-Dist', []):
        print(f'  {req}')
    print('Классификаторы:')
    for cls in md.get_all('Classifier', []):
        print(f'  {cls}')
    # Точки входа
    eps = meta.entry_points(group='console_scripts')
    print('Консольные скрипты:')
    for ep in eps:
        if ep.dist.name == pkg_name:
            print(f'  {ep.name} -> {ep.value}')
except meta.PackageNotFoundError:
    print(f'Пакет {pkg_name} не установлен')

=== Метаданные requests ===
Версия: 2.31.0
Имя: requests
Автор: Kenneth Reitz
Лицензия: Apache 2.0
URL: https://requests.readthedocs.io
Зависимости:
  certifi >=2017.4.17
  charset-normalizer >=2,<4
  idna >=2.5,<4
  urllib3 >=1.21.1,<3
Классификаторы:
  Development Status :: 5 - Production/Stable
  Intended Audience :: Developers
  ...
Консольные скрипты:
  (нет)

2. Обработка ошибок при отсутствии пакета

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

import importlib.metadata as meta

packages_to_check = ['requests', 'nonexistent_package', 'flask']
for pkg in packages_to_check:
    try:
        ver = meta.version(pkg)
        print(f'{pkg}: версия {ver}')
    except meta.PackageNotFoundError:
        print(f'{pkg}: не установлен')
    except Exception as e:
        print(f'{pkg}: ошибка {e}')

requests: версия 2.31.0
nonexistent_package: не установлен
flask: версия 3.0.0

3. Рекурсивный обход файлов пакета с использованием pathlib и importlib.resources

Модуль importlib.resources предоставляет доступ к файлам, входящим в состав пакета (например, данные конфигурации).

import importlib.resources as res
import pathlib

# Пакет 'email' содержит шаблоны
try:
    # Получить путь к файлу 'charsets.py' внутри пакета 'email.mime'
    path = res.files('email.mime').joinpath('charsets.py')
    print(f'Файл существует: {path.is_file()}')
    # Прочитать содержимое
    content = path.read_text(encoding='utf-8')
    print(f'Первые 100 символов: {content[:100]}')
except ModuleNotFoundError:
    print('Пакет email.mime не найден')
except Exception as e:
    print(f'Ошибка: {e}')

Файл существует: True
Первые 100 символов: """Base64 and quoted-printable encodings

This module contains functions for...

4. Сравнение версий пакетов с помощью packaging

Иногда нужно проверить, удовлетворяет ли установленная версия некоторому диапазону.

import importlib.metadata as meta
from packaging.version import Version, VersionSet

def check_version_in_range(pkg_name, min_ver, max_ver):
    try:
        ver = Version(meta.version(pkg_name))
        vs = VersionSet([Version(min_ver), Version(max_ver)])
        return ver in vs
    except meta.PackageNotFoundError:
        return False

print('requests в диапазоне [2.0, 3.0):', check_version_in_range('requests', '2.0', '3.0'))
print('numpy в диапазоне [1.0, 2.0):', check_version_in_range('numpy', '1.0', '2.0'))

requests в диапазоне [2.0, 3.0): True
numpy в диапазоне [1.0, 2.0): True

5. Чтение метаданных из wheel-файла

Можно прочитать метаданные напрямую из .whl файла без установки пакета.

import zipfile
import email.parser

def read_metadata_from_wheel(wheel_path):
    with zipfile.ZipFile(wheel_path, 'r') as zf:
        # Ищем файл *.dist-info/METADATA
        for name in zf.namelist():
            if name.endswith('.dist-info/METADATA'):
                with zf.open(name) as f:
                    data = f.read().decode('utf-8')
                    return email.parser.HeaderParser().parsestr(data)
    return None

# Пример с файлом (путь нужно заменить на существующий)
# metadata = read_metadata_from_wheel('/path/to/some_package-1.0-py3-none-any.whl')
# print(metadata['Name'])

Этот метод полезен для предварительного анализа перед установкой.

6. Использование importlib.metadata для проверки зависимостей всего окружения

Напишем функцию, которая собирает все пакеты и их зависимости.

import importlib.metadata as meta

def get_all_requirements():
    requirements = {}
    for dist in meta.distributions():
        pkg_name = dist.metadata['Name']
        reqs = dist.requires or []
        requirements[pkg_name] = [str(r) for r in reqs]
    return requirements

all_reqs = get_all_requirements()
for pkg, reqs in list(all_reqs.items())[:3]:
    print(f'{pkg}: {reqs}')

requests: ['certifi>=2017.4.17', 'charset-normalizer>=2,<4', 'idna>=2.5,<4', 'urllib3>=1.21.1,<3']
pip: ['setuptools>=40.8.0', 'wheel']
setuptools: []