Відмінності між розподілом, distutils, setuptools та distutils2?

Ситуація

Я намагаюся перенести бібліотеку з відкритим кодом на Python 3. ( SymPy , якщо хтось цікавиться.)

Отже, мені потрібно запустити 2to3автоматично під час створення для Python 3. Для цього мені потрібно скористатися distribute. Тому мені потрібно портувати поточну систему, яка (відповідно до doctest) є distutils.

Проблема

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

Питання

Чи може хтось пояснити відмінності? Що я повинен використовувати? Яке найсучасніше рішення? (Окрім того, я також вдячний би в деякому посібнику щодо перенесення Distribute, але це не виходить за рамки питання ...)

Станом на березень 2020 року більшість інших відповідей на це питання є застарілими на кілька років. Коли ви стикаєтесь із порадами щодо питань упаковки Python, не забудьте переглянути дату публікації та не довіряйте застарілій інформації.

Керівництво користувача Упаковка Python варто прочитати. На кожній сторінці відображається "остання оновлена" дата, тому ви можете перевірити наявність цього посібника, і він досить вичерпний. Той факт, що він розміщений на піддомені python.org Фонду програмного забезпечення Python, просто додає йому довіри. Сторінка "Підсумки проекту " тут особливо актуальна.

Короткий зміст інструментів:

Ось підсумок пейзажу упаковки 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. Він бачить регулярні випуски.

  • _{Офіційні документи | Сторінка Піпі | GitHub repo | setuptoolsрозділ Посібника користувача пакета Python}

• scikit-buildце вдосконалений генератор системи побудови, який використовує внутрішньо CMake для складання компільованих розширень Python. Оскільки scikit-build не заснований на distutils, він насправді не має жодних своїх обмежень. За наявності ніндзя, збірка scikit може збирати великі проекти втричі швидше, ніж альтернативи. З цим слід добре працювати pip.

  • _{Офіційні документи | Сторінка Піпі | GitHub repo | scikit-buildрозділ Посібника користувача пакета Python}

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

  • _{Офіційні Документи | Сторінка Піпі | Bitbucket repo | distlibрозділ Посібника користувача пакета Python}

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

  • _{Офіційні Документи | Сторінка Піпі | GitHub repo | packagingрозділ Посібника користувача пакета Python}

Застарілі / покинуті інструменти:

• distributeбув виделкою setuptools. Він поділяв одне і те саме простір імен, тому, якщо у вас було встановлено Distribute, import setuptoolsфактично було б імпортувати пакет, розподілений разом з Distribute. Distribute було об'єднано назад у Setuptools 0.7 , тому більше не потрібно використовувати Distribute. Насправді версія на 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і т.д.? . (Так, я знаю, я стогну з тобою.)

Я обслуговуючий дистрибутив та розробник пакунків distutils2 / Packaging. Я говорив про упаковку Python на ConFoo 2011, і сьогодні я пишу розширену версію. Він ще не опублікований, тому ось уривки, які повинні допомогти визначити речі.

• Distutils - це стандартний інструмент, який використовується для упаковки. Він працює досить добре для простих потреб, але обмежений і не тривіальний.

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

• Distribute - це вилка Setuptools, яку розпочали розробники, відчуваючи, що темп її розвитку був занадто повільним і еволюціонувати не вдалося. Її розвиток значно сповільнився, коли distutils2 розпочала одна і та ж група. Оновлення 2013 - серпень: розподіл об’єднано назад у setuptools та припинено.

• Distutils2 - це нова бібліотека distutils, створена як вилка кодової бази distutils, з гарними ідеями, взятими з інструментів налаштування (про які деякі були ретельно обговорені в PEPs) та базовим інсталятором, натхненним 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, яка зробила чималу роботу з очищення цього питання.

Так, ти це зрозумів. : -Я думаю, що в даний час кращим пакетом є Distribute , що є роздрібним настроєм, який є розширенням distutils (оригінальна система упаковки). Інсталятор не підтримувався, тому він був роздвоєним та перейменованим, проте при встановленні він використовує назву пакета setuptools! Я думаю, що більшість розробників Python зараз використовують дистрибутив, і я можу точно сказати, що це роблю.

Я розумію, що я відповів на ваше другорядне запитання, не звертаючись до безперечних припущень у вашій початковій проблемі:

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

Ви можете , чи не потрібно . Інші стратегії описані на сторінці http://docs.python.org/dev/howto/pyporting

Для цього мені потрібно використовувати розподіл,

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

Оновлення цього питання наприкінці 2014 року, де, на щастя, хаос упаковки Python був значно очищений менеджером пакетів « conda » компанії Continuum .

Зокрема, conda швидко дає змогу створювати 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.

Крім того, конда має такі особливості:

• Python agnostic
• Поперечна платформа
• Не потрібні права адміністратора
• Інтелектуальне управління залежностями (шляхом вирішення SAT)
• Добре стосується бібліотек C, Fortran та системного рівня, з якими вам, можливо, доведеться зв’язатись

Цей останній момент особливо важливий, якщо ви знаходитесь на арені наукових обчислень.