Извлечь файл WHL

Формат файла .whl, который расшифровывается как «Wheel», представляет собой формат архива на основе ZIP, предназначенный для распространения и установки пакетов Python. Он был представлен в PEP 427 в качестве замены старого формата .egg. Формат .whl обеспечивает более эффективный, быстрый и независимый от платформы способ распространения пакетов Python по сравнению с исходными дистрибутивами.

Файл .whl по сути является архивом ZIP, который следует определенной структуре каталогов и соглашению об именовании. Архив содержит исходный код пакета Python, скомпилированный байт-код и файлы метаданных, необходимые для установки. Формат .whl позволяет ускорить установку, поскольку устраняет необходимость выполнять setup.py и компилировать пакет во время установки.

Соглашение об именовании для файлов .whl следует определенному шаблону: {distribution}-{version}(-{build tag})?-{python tag}-{abi tag}-{platform tag}.whl. Давайте разберем каждый компонент: - {distribution}: имя пакета Python. - {version}: номер версии пакета. - {build tag} (необязательно): тег, указывающий на конкретную сборку пакета. - {python tag}: указывает реализацию и версию Python, например cp38 для CPython 3.8. - {abi tag}: указывает двоичный интерфейс приложения (ABI), например cp38m для CPython 3.8 с Unicode UCS-4. - {platform tag}: указывает целевую платформу, например win_amd64 для 64-битной Windows. Например, файл .whl с именем mypackage-1.0.0-cp38-cp38-win_amd64.whl представляет версию 1.0.0 «mypackage», созданную для CPython 3.8 в 64-битной Windows.

Структура каталогов внутри архива .whl следует определенной схеме. На верхнем уровне находится каталог «{distribution}-{version}.dist-info», содержащий файлы метаданных. Фактический код пакета и ресурсы хранятся в отдельном каталоге с именем «{distribution}-{version}.data».

В каталоге «.dist-info» обычно находятся следующие файлы: - METADATA: содержит метаданные пакета, такие как имя, версия, автор и зависимости. - WHEEL: указывает версию спецификации Wheel и теги совместимости пакета. - RECORD: список всех файлов, включенных в архив .whl, вместе с их хэшами для проверки целостности. - entry_points.txt (необязательно): определяет точки входа для пакета, такие как консольные скрипты или плагины. - LICENSE.txt (необязательно): содержит информацию о лицензии пакета. Каталог «.data» содержит фактический код пакета и ресурсы, организованные в соответствии с внутренней структурой пакета.

Чтобы создать файл .whl, обычно используется такой инструмент, как setuptools или pip. Эти инструменты автоматически генерируют необходимые файлы метаданных и упаковывают код в формат .whl на основе файла setup.py пакета или конфигурации pyproject.toml. Например, выполнение `python setup.py bdist_wheel` или `pip wheel .` в каталоге пакета создаст файл .whl в каталоге «dist».

При установке пакета из файла .whl такие инструменты, как pip, обрабатывают процесс установки. Они извлекают содержимое архива .whl, проверяют целостность файлов с помощью информации в файле RECORD и устанавливают пакет в соответствующее место в среде Python. Файлы метаданных в каталоге «.dist-info» используются для отслеживания установленного пакета и его зависимостей.

Одним из основных преимуществ формата .whl является его способность предоставлять предварительно созданные пакеты для конкретных платформ. Это означает, что пользователи могут устанавливать пакеты без необходимости иметь совместимую среду сборки или компилировать пакет из исходного кода. Файлы .whl могут быть созданы и распространены для разных платформ и версий Python, что упрощает распространение пакетов среди широкого круга пользователей.

Еще одним преимуществом формата .whl является его более высокая скорость установки по сравнению с исходными дистрибутивами. Поскольку файлы .whl содержат предварительно созданный байт-код и не требуют выполнения setup.py во время установки, процесс установки значительно ускоряется. Это особенно заметно для пакетов со сложными процессами сборки или зависимостями.

Формат .whl также поддерживает различные функции и расширения. Например, он позволяет включать скомпилированные расширения (например, расширения C) в архив, что упрощает распространение пакетов с собственным кодом. Он также поддерживает концепцию «прямых ссылок на URL» (PEP 610), которая позволяет указывать URL-адреса для зависимостей пакета, что обеспечивает более гибкие механизмы распространения.

В заключение, формат архива .whl является стандартизованным и эффективным способом распространения пакетов Python. Он обеспечивает независимый от платформы и более быстрый процесс установки по сравнению с исходными дистрибутивами. Следуя определенной структуре каталогов и соглашению об именовании, файлы .whl инкапсулируют код пакета, метаданные и зависимости в одном архиве. Широкое распространение формата .whl значительно упростило распространение и установку пакетов Python, что облегчило разработчикам обмен своими библиотеками, а пользователям — их бесшовную установку.