колесо · PyPI

колесо

Формат встроенного пакета для Python.

Колесо представляет собой ZIP-архив со специально отформатированным именем файла. и расширение .whl. Он предназначен для хранения всех файлов для Установка, совместимая с PEP 376, очень близка к установке на диске. формат. Многие пакеты будут правильно установлены только с помощью «Распаковать». шаг (просто извлекая файл на sys.path), и распакованный архив сохраняет достаточно информации для «распространения» (копирования данных и скриптов в свои окончательные местоположения) в любое более позднее время.

Проект колеса содержит команду bdist_wheel для setuptools (требуется setuptools >= 0.8.0). Файлы колес можно установить с помощью новее pip с https://github.com/pypa/pip или с помощью собственной команды колеса линейная утилита.

Документация по колесу находится по адресу http://wheel.rtfd.org/. Формат файла документирован в PEP 427 (http://www.python.org/dev/peps/pep-0427/).

Эталонная реализация находится по адресу https://bitbucket. org/pypa/wheel

Почему не яйцо?

Формат яйца Python предшествует стандартам, связанным с упаковкой, которые у нас есть. сегодня наиболее важным из них является PEP 376 «База данных установленных Python». Дистрибутивы», который указывает каталог .dist-info (вместо .egg-info) и PEP 426 «Метаданные для программных пакетов Python 2.0». который указывает, как выражать зависимости (вместо require.txt в .egg-info).

Wheel реализует эти вещи. Он также обеспечивает более богатое именование файлов соглашение, которое также сообщает о реализации Python и ABI как просто языковая версия, используемая в конкретном пакете.

В отличие от .egg, колесо будет полностью документированным стандартом в двоичном коде. уровень, который действительно легко установить, даже если вы не хотите использовать эталонная реализация.

0.24.0

• Тег python, используемый для пакетов чистого python, теперь называется .pyN (основная версия только). Это изменение фактически произошло в 0. 23.0, когда –python-tag опция была добавлена, но тогда не упоминалась явно в журнале изменений.

• wininst2wheel и egg2wheel удалены. Используйте «конвертировать колесо [архив]» вместо.

• Wheel теперь поддерживает условные требования в стиле setuptools через extras_require={} синтаксис. Отделяйте «лишние» имена от условий, используя персонаж. Собственный setup.py колеса делает это. (пустая строка extra совпадает с install_requires.) Эти условные требования должен работать одинаково независимо от того, установлен пакет с помощью колеса или с помощью setup.py.

0.23.0

• Флаги тега совместимости добавлены в команду bdist_wheel

• sdist должен включать файлы, необходимые для тестов

• «преобразование колеса» теперь также может преобразовывать неупакованные яйца в колесо

• Переименуйте pydist.json в metadata.json, чтобы не наступать на PEP

• Опция –skip-scripts была удалена, а создание скриптов теперь невозможно. по умолчанию. Этот вариант был временным подходом, пока установщики не смогут генерировать скрипты самостоятельно. Теперь это относится к пункту 1.5 и более поздним версиям. Обратите внимание, что использование pip 1.4 для установки колеса без скриптов оставит установка без оберток точки входа. «Скрипты установки колес» В таких случаях можно использовать команду для создания скриптов.

• Спасибо участникам

0.22.0

• Включить entry_points.txt, скрипты, также известные как команды, в экспериментальный pydist.json

• Улучшенный синтаксический анализ test_requires

• Исправления Python 2.6, команда «wheel version» предоставлена ​​pombredanne

0.21.0

• Предварительно созданные сценарии снова используются по умолчанию.

• «setup.py bdist_wheel –skip-scripts» отключает их.

• setuptools больше не является перечисленным требованием для «колеса». упаковка. Это, конечно, все еще требуется для того, чтобы bdist_wheel работать.

• «python -m wheel» избегает импорта pkg_resources до тех пор, пока в этом нет необходимости.

0.20.0

• Больше не включать console_scripts в колеса. Обычные скрипты (файлы оболочки, автономные файлы Python) включены, как обычно.

• Включить новую команду «python -m wheel install-scripts [дистрибутив [дистрибутив …]]» для установки console_scripts (в стиле setuptools скрипты, использующие pkg_resources) для дистрибутива.

0.19.0

0.18.0

0.17.0

0.16.0

1.0.0a2

1.0.0a1

1.0.0a0

• Обновление для версии 1.0 Wheel (принимается PEP).

• Исправление Python 3 для перемещения описания Unicode в тело метаданных

• Включить элементарную документацию API в Sphinx (спасибо Кевину Хорну)

0.

0.14.0

• Изменен формат подписи, чтобы лучше соответствовать текущей спецификации JWS. Разбивает все существующие подписи.

• Включить команду Wheel Unsign для удаления RECORD.jws из архива.

• Поместите описание в новый раздел разрешенной полезной нагрузки PKG-INFO. (МЕТАДАТА).

0.13.0

• Используйте distutils вместо sysconfig для получения путей установки; можно установить заголовки.

• Улучшить сортировку WheelFile().

• Разрешить загрузочную установку без pkg_resources.

0.12.0

0.11.0

• Очистка API

0.10.3

• Исправление скриптов

0.10.2

• Исправить кейген

0.10.1

0.10.0

• Включить копию pkg_resources. Wheel теперь можно установить в виртуальную среду у которого нет дистрибутива (хотя большинству пакетов по-прежнему требуется pkg_resources действительно работает; колесо установить раздать)

• Определите новый раздел setup. cfg [колесо]. универсальный=1 воля примените тег py2.py3-none-any для чистых колес Python.

0,9,7

0.9.6

• require-dist из setup.cfg перезаписывает любые требования из setup.py Следует позаботиться о том, чтобы требования были одинаковыми в обоих случаях, или просто всегда устанавливайте с колеса.

• удалить требование dirspec на win32

• улучшенная утилита командной строки, добавлено «колесо преобразовать [яйцо или wininst]» в конвертировать устаревшие двоичные форматы в колесо

0,9,5

• Собственный файл колеса колеса может быть выполнен Python и может быть установлен самостоятельно: установка колеса python-0.9.5-py27-none-any/wheel…

• Использовать argparse; базовая команда установки колеса должна работать только с stdlib зависимости.

• Разрешить require_dist в разделе [метаданные] файла setup.cfg. В дополнение к зависимости в setup. py, но будут интерпретироваться только при установке от колеса, а не от сдист. Может быть квалифицирован с маркерами окружающей среды.

0.9.4

0.9.3

• Встроенная поддержка цифровых подписей без расширений C.

• Встроенная команда «установить колесо» (один пакет, без зависимости разрешение), включая проверку совместимости.

• Поддержка Python 3.3

• Использовать метаданные 1.3 (PEP 426)

0.9.2

0.9.1

• «Знак колеса» использует ключи, сгенерированные «Кейгеном колеса» (вместо генерации новый ключ каждый раз случайным образом)

• Исправления кодирования/декодирования Python 2/3

• Запустить тесты на Python 2.6 (без проверки подписи)

0,9

• Обновленная схема цифровых подписей

• Поддержка Python 3 для цифровых подписей

• Всегда проверять хэши RECORD при извлечении

• Инструмент командной строки «wheel» для подписи, проверки и распаковки файлов Wheel

0,8

• нет/любое обновление тегов черновика pep

• улучшенный скрипт wininst2wheel

• изменения документа и другие улучшения

0,7

• сортировка .