Различия между дистрибутивом, distutils, setuptools и distutils2?

Ситуация

Я пытаюсь портировать библиотеку с открытым исходным кодом на Python 3. ( SymPy , если кому-то интересно.)

Итак, мне нужно запускать 2to3автоматически при сборке для Python 3. Для этого мне нужно использовать distribute. Поэтому мне нужно портировать текущую систему, которая (согласно doctest) есть distutils.

Проблема

К сожалению, я не уверен , что разница между этой modules- distutils, distribute, setuptools. Документация отрывочна как лучше, так как все они кажутся друг другом, и должны быть совместимы в большинстве случаев (но на самом деле не во всех)… и так далее, и так далее.

Вопрос

Может ли кто-нибудь объяснить различия? Что я должен использовать? Какое самое современное решение? (Кроме того, я бы также хотел получить руководство по портированию Distribute, но это немного выходит за рамки вопроса…)

По состоянию на март 2020 года большинство других ответов на этот вопрос устарели на несколько лет. Когда вы сталкиваетесь с советами по вопросам упаковки Python, не забывайте смотреть дату публикации и не доверяйте устаревшей информации.

Руководство пользователя по упаковке Python стоит прочитать. На каждой странице отображается дата «последнего обновления», поэтому вы можете проверить актуальность руководства, и оно достаточно полное. Тот факт, что он размещен на поддомене python.org Python Software Foundation, просто добавляет ему доверия. Страница с резюме проекта особенно актуальна здесь.

Резюме инструментов:

Вот краткое изложение ландшафта упаковки Python:

Поддерживаемые инструменты:

• distutilsдо сих пор является стандартным инструментом для упаковки в Python. Он включен в стандартную библиотеку (Python 2 и Python 3). Это полезно для простых дистрибутивов Python, но не имеет функций. Он представляет distutilsпакет Python, который можно импортировать в ваш setup.pyскрипт.

  • _{Официальные документы | distutilsраздел Руководства пользователя по пакету Python}

• setuptoolsбыл разработан для преодоления ограничений Distutils и не входит в стандартную библиотеку. Он представил утилиту командной строки под названием easy_install. Он также представил setuptoolsпакет Python, который можно импортировать в ваш setup.pyскрипт, и pkg_resourcesпакет Python, который можно импортировать в ваш код, чтобы найти файлы данных, установленные вместе с дистрибутивом. Один из его недостатков в том, что он исправляет distutilsпакет Python. Это должно хорошо работать с pip. Это видит регулярные выпуски.

  • _{Официальные документы | Страница Pypi | GitHub репо | setuptoolsраздел Руководства пользователя по пакету Python}

• scikit-buildулучшенный генератор системы сборки, который внутренне использует CMake для сборки скомпилированных расширений Python. Поскольку scikit-build не основан на distutils, он не имеет никаких ограничений. Когда присутствует ninja-build, scikit-build может компилировать большие проекты в три раза быстрее, чем альтернативные. Это должно хорошо работать с pip.

  • _{Официальные документы | Страница Pypi | GitHub репо | scikit-buildраздел Руководства пользователя по пакету Python}

• distlibэто библиотека, которая обеспечивает функциональность, которая используется инструментами более высокого уровня, такими как pip.

  • _{Официальные документы | Страница Pypi | Битбакет репо | distlibраздел Руководства пользователя по пакету Python}

• packagingтакже библиотека, которая обеспечивает функциональность, используемую инструментами более высокого уровня, такими как pipиsetuptools

  • _{Официальные документы | Страница Pypi | GitHub репо | packagingраздел Руководства пользователя по пакету Python}

Устаревшие / заброшенные инструменты:

• distributeбыл вилкой setuptools. Он разделяет одно и то же пространство имен, поэтому, если у вас установлен Distribute, import setuptoolsон фактически импортирует пакет, распространяемый вместе с Distribute. Распространение было объединено обратно в Setuptools 0.7 , поэтому вам больше не нужно использовать Распространение. Фактически, версия на Pypi - это просто слой совместимости, который устанавливает Setuptools.

• distutils2была попытка взять лучшее из distutils, setuptoolsа distributeи стать стандартным инструмент , включенным в стандартной библиотеке Python. Идея заключалась в том, что distutils2он будет распространяться для старых версий Python и distutils2будет переименован в packagingPython 3.3, который включит его в свою стандартную библиотеку. Эти планы не пошли, как задумано, и в настоящее время distutils2это заброшенный проект . Последний выпуск был в марте 2012 года, и его домашняя страница Pypi была наконец обновлена, чтобы отразить его смерть.

Другие:

Существуют и другие инструменты, если вам интересно, прочитайте Краткое изложение проекта в Руководстве пользователя по упаковке Python. Я не буду перечислять их все, чтобы не повторить эту страницу, и держать ответ соответствующий вопрос, который был только о том distribute, distutils, setuptoolsи distutils2.

Рекомендация:

Если все это является новым для вас, и вы не знаете, с чего начать, я бы порекомендовал учитьсяsetuptools вместе с pipи virtualenv, которые все очень хорошо работают вместе.

Если вы ищете в virtualenv, вы можете быть заинтересованы в этом вопросе: В чем разница между venv, pyvenv, pyenv, virtualenv, virtualenvwrapperи т.д.? , (Да, я знаю, я стону с тобой.)

Я сопровождающий distutils и участник distutils2 / package. Я говорил о упаковке Python на ConFoo 2011, и в эти дни я пишу расширенную версию. Это еще не опубликовано, так что вот выдержки, которые должны помочь определить вещи.

• Distutils - это стандартный инструмент, используемый для упаковки. Он работает довольно хорошо для простых нужд, но ограничен и не тривиален для расширения.

• Setuptools - это проект, родившийся из желания восполнить недостающую функциональность distutils и исследовать новые направления. В некоторых сообществах это де-факто стандарт. Он использует патчи обезьян и магию, которую не одобряют разработчики ядра Python.

• Распространение - это форк Setuptools, который был запущен разработчиками, которые чувствовали, что темп его разработки был слишком медленным и что его было невозможно развить. Его развитие значительно замедлилось, когда distutils2 был запущен той же группой. Обновление 2013-август: дистрибутив снова объединен с setuptools и прекращен.

• Distutils2 - это новая библиотека distutils, созданная как форк базы кода distutils, с хорошими идеями, взятыми из инструментов установки (некоторые из которых подробно обсуждались в PEP), и базовым установщиком, вдохновленным pip. Фактическое имя, которое вы используете для импорта Distutils2, находится packagingв стандартной библиотеке Python 3.3+ или distutils2в версиях 2.4+ и 3.1–3.2. (Бэкпорт будет доступен в ближайшее время.) Distutils2 не сделал релиз Python 3.3, и он был отложен.

Больше информации:

• Судьба Distutils - Pycon Summit + Packaging Sprint подробный отчет
• Быстрый различие между Distutils и Distutils2

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

ПРИМЕЧАНИЕ. Ответ устарел. Распространение устарело. Этот ответ больше не действителен с момента создания Python Packaging Authority и проделал большую работу по его устранению.

Да, вы поняли. : -о я думаю, что в настоящее время предпочтительным пакетом является Distribute , который является форком setuptools, который является расширением distutils (оригинальная система упаковки). Setuptools не поддерживается, поэтому он разветвляется и переименовывается, однако при установке он использует имя пакета setuptools! Я думаю, что большинство разработчиков Python сейчас используют Distribute, и я могу точно сказать, что я использую.

Я понимаю, что ответил на ваш второстепенный вопрос, не обращаясь к несомненным предположениям в вашей первоначальной проблеме:

Я пытаюсь портировать библиотеку с открытым исходным кодом (SymPy, если кому-то интересно) на Python 3. Для этого мне нужно автоматически запускать 2to3 при сборке для Python 3.

Вы можете , не нужно . Другие стратегии описаны на http://docs.python.org/dev/howto/pyporting

Для этого мне нужно использовать распространять,

Вы можете :) distutils поддерживает преобразование 2to3 во время сборки для кода (не для строк документации) другим способом, который распространяет: http://docs.python.org/dev/howto/pyporting#during-installation

Обновление этого вопроса в конце 2014 года, когда, к счастью, хаос упаковки Python был значительно очищен менеджером пакетов " conda " из Continuum .

В частности, conda позволяет быстро создавать « среды ». Вы можете настроить свои среды с различными версиями Python. Например:

conda create -n py34 python=3.4 anaconda

conda create -n py26 python=2.6 anaconda

создаст две ("py34" или "py26") среды Python с разными версиями Python.

После этого вы можете вызвать среду с определенной версией Python:

source activate <env name>

Эта функция кажется особенно полезной в вашем случае, когда вам приходится иметь дело с другой версией Python.

Кроме того, conda имеет следующие особенности:

• Python агностик
• Кроссплатформенный
• Не требуются права администратора
• Интеллектуальное управление зависимостями (с помощью SAT-решателя)
• Прекрасно работает с C, Fortran и библиотеками системного уровня, с которыми вам, возможно, придется связываться

Этот последний пункт особенно важен, если вы находитесь в сфере научных вычислений.