Differenze tra distribut, distutils, setuptools e distutils2?

La situazione

Sto provando a portare una libreria open source su Python 3. ( SymPy , se qualcuno si sta chiedendo.)

Quindi, devo eseguire 2to3automaticamente quando si crea per Python 3. Per farlo, devo usare distribute. Pertanto, devo portare il sistema attuale, che (secondo il doctest) è distutils.

Il problema

Purtroppo, io non sono sicuro di quello che è la differenza tra questi MODULI distutils, distribute, setuptools. La documentazione è imprecisa nel modo migliore, in quanto sembrano essere una forcella reciproca, intesa per essere compatibile nella maggior parte dei casi (ma in realtà, non tutti) ... e così via, e così via.

La domanda

Qualcuno potrebbe spiegare le differenze? Cosa dovrei usare? Qual è la soluzione più moderna? (A parte, apprezzerei anche qualche guida sul porting Distribute, ma questo è un po 'oltre lo scopo della domanda ...)

A partire da marzo 2020, la maggior parte delle altre risposte a questa domanda sono obsolete da diversi anni. Quando ti imbatti in consigli su problemi di packaging di Python, ricordati di guardare la data di pubblicazione e non fidarti di informazioni obsolete.

La Guida per l'utente Packaging Python è la pena di leggere. Ogni pagina ha una data di "ultimo aggiornamento" visualizzata, quindi puoi controllare la recency del manuale ed è abbastanza completa. Il fatto che sia ospitato su un sottodominio di python.org della Python Software Foundation aggiunge semplicemente credibilità ad esso. La pagina Riepiloghi progetti è particolarmente rilevante qui.

Riepilogo degli strumenti:

Ecco un riepilogo del panorama del packaging di Python:

Strumenti supportati:

• distutilsè ancora lo strumento standard per il packaging in Python. È incluso nella libreria standard (Python 2 e Python 3). È utile per semplici distribuzioni Python, ma manca di funzionalità. Presenta il distutilspacchetto Python che può essere importato nel tuo setup.pyscript.

  • _{Documenti ufficiali | distutilssezione della Guida dell'utente del pacchetto Python}

• setuptoolsè stato sviluppato per superare i limiti di Distutils e non è incluso nella libreria standard. Ha introdotto un'utilità della riga di comando chiamata easy_install. Ha inoltre introdotto il setuptoolspacchetto Python che può essere importato nello setup.pyscript e il pkg_resourcespacchetto Python che può essere importato nel codice per individuare i file di dati installati con una distribuzione. Uno dei suoi gotcha è che corregge le patch del distutilspacchetto Python. Dovrebbe funzionare bene con pip. Vede rilasci regolari.

  • _{Documenti ufficiali | Pagina Pypi | Repository GitHub | setuptoolssezione della Guida dell'utente del pacchetto Python}

• scikit-buildè un generatore di sistema di build migliorato che utilizza internamente CMake per creare estensioni Python compilate. Poiché scikit-build non si basa su distutils, in realtà non presenta alcun limite. Quando è presente ninja-build, scikit-build può compilare grandi progetti tre volte più velocemente delle alternative. Dovrebbe funzionare bene con pip.

  • _{Documenti ufficiali | Pagina Pypi | Repository GitHub | scikit-buildsezione della Guida dell'utente del pacchetto Python}

• distlibè una libreria che fornisce funzionalità utilizzate da strumenti di livello superiore come pip.

  • _{Documenti ufficiali | Pagina Pypi | Repos Bitbucket | distlibsezione della Guida dell'utente del pacchetto Python}

• packagingè anche una libreria che fornisce funzionalità utilizzate da strumenti di livello superiore come pipesetuptools

  • _{Documenti ufficiali | Pagina Pypi | Repository GitHub | packagingsezione della Guida dell'utente del pacchetto Python}

Strumenti obsoleti / abbandonati:

• distributeera una forchetta di setuptools. Condivide lo stesso spazio dei nomi, quindi se avevi installato Distribuire, in import setuptoolsrealtà importa il pacchetto distribuito con Distribuisci. Distribuisci è stato riunito nuovamente in Setuptools 0.7 , quindi non è più necessario utilizzare Distribuisci. In effetti, la versione su Pypi è solo un livello di compatibilità che installa Setuptools.

• distutils2era un tentativo di prendere il meglio di distutils, setuptoolsed distributee diventare lo strumento standard incluso nella libreria standard di Python. L'idea era che distutils2sarebbe stato distribuito per le vecchie versioni di Python e che distutils2sarebbe stato rinominato packagingper Python 3.3, che lo avrebbe incluso nella sua libreria standard. Questi piani non sono andati come previsto, tuttavia, e attualmente, distutils2è un progetto abbandonato . L'ultima versione risale al marzo 2012 e la sua home page di Pypi è stata finalmente aggiornata per riflettere la sua morte.

Altri:

Esistono altri strumenti, se interessati, leggere i riepiloghi dei progetti nella Guida per l'utente di Python Packaging. Io non li elencherò, per non ripetere quella pagina, e per mantenere la risposta corrispondente alla domanda, che era solo circa distribute, distutils, setuptoolse distutils2.

Raccomandazione:

Se tutto ciò è nuovo per te e non sai da dove cominciare, consiglierei di impararesetuptools insieme a pipe virtualenv, che funzionano tutti molto bene insieme.

Se stai cercando in virtualenv, potreste essere interessati a questa domanda: Qual è la differenza tra venv, pyvenv, pyenv, virtualenv, virtualenvwrapper, ecc? . (Sì, lo so, gemo con te.)

Sono un manutentore di distutils e collaboratore di distutils2 / packaging. Ho parlato della confezione di Python al ConFoo 2011 e in questi giorni ne sto scrivendo una versione estesa. Non è ancora stato pubblicato, quindi ecco alcuni estratti che dovrebbero aiutare a definire le cose.

• Distutils è lo strumento standard utilizzato per l'imballaggio. Funziona piuttosto bene per esigenze semplici, ma è limitato e non banale da estendere.

• Setuptools è un progetto nato dal desiderio di riempire la funzionalità distutils mancante ed esplorare nuove direzioni. In alcune sottocomunità, è uno standard di fatto . Usa la magia e il patching delle scimmie che sono disapprovati dagli sviluppatori core di Python.

• Distribuire è un fork di Setuptools che è stato avviato dagli sviluppatori ritenendo che il suo ritmo di sviluppo fosse troppo lento e che non fosse possibile evolverlo. Il suo sviluppo è stato notevolmente rallentato quando distutils2 è stato avviato dallo stesso gruppo. Aggiornamento 2013-agosto: la distribuzione viene nuovamente riunita in setuptools e interrotta.

• Distutils2 è una nuova libreria distutils, iniziata come fork della base di codici distutils, con buone idee tratte da strumenti di installazione (di cui alcuni sono stati discussi a fondo nei PEP) e un programma di installazione di base ispirato a pip. Il nome effettivo che usi per importare Distutils2 è packagingnella libreria standard Python 3.3+ o distutils2in 2.4+ e 3.1–3.2. (A breve sarà disponibile un backport.) Distutils2 non ha rilasciato la versione 3.3 di Python ed è stato messo in attesa.

Ulteriori informazioni:

• Il destino di Distutils - Pycon Summit + Packaging Sprint rapporto dettagliato
• Una rapida differenza tra Distutils e Distutils2

Spero di finire presto la mia guida, conterrà maggiori informazioni sui punti forti e deboli di ogni libreria e una guida alla transizione.

NOTA: Risposta obsoleta, Distribuisci ora obsoleta. Questa risposta non è più valida da quando è stata costituita la Python Packaging Authority e ha fatto molto lavoro per ripulirla.

Sì, ce l'hai. Eeeek !!! Penso che in questo momento il pacchetto preferito sia Distribute , che è un fork di setuptools, che sono un'estensione di distutils (il sistema di packaging originale). Setuptools non veniva mantenuto, quindi è stato biforcato e rinominato, tuttavia quando installato utilizza il nome del pacchetto di setuptools! Penso che la maggior parte degli sviluppatori Python ora usi Distribuisci, e posso dire con certezza che lo faccio.

Mi rendo conto di aver risposto alla tua domanda secondaria senza affrontare ipotesi indiscusse nel tuo problema originale:

Sto provando a eseguire il porting di una libreria open source (SymPy, se qualcuno si sta chiedendo) a Python 3. Per fare questo, ho bisogno di eseguire 2to3 automaticamente quando costruisco per Python 3.

È possibile che non hanno bisogno . Altre strategie sono descritte su http://docs.python.org/dev/howto/pyporting

Per farlo, devo usare distribuire,

È possibile :) distutils conversione 2to3 supporti accumulo di tempo per il codice (non docstring), in un modo diverso che distribuiscono di: http://docs.python.org/dev/howto/pyporting#during-installation

Aggiornamento di questa domanda alla fine del 2014, dove fortunatamente il caos del packaging di Python è stato notevolmente ripulito dal gestore di pacchetti " conda " di Continuum .

In particolare, conda consente rapidamente la creazione di " ambienti " conda . Puoi configurare i tuoi ambienti con diverse versioni di Python. Per esempio:

conda create -n py34 python=3.4 anaconda

conda create -n py26 python=2.6 anaconda

creerà due ambienti ("py34" o "py26") Python con diverse versioni di Python.

Successivamente è possibile richiamare l'ambiente con la versione specifica di Python con:

source activate <env name>

Questa funzione sembra particolarmente utile nel tuo caso in cui devi gestire diverse versioni di Python.

Inoltre, conda ha le seguenti caratteristiche:

• Python agnostico
• Piattaforma incrociata
• Non sono richiesti privilegi di amministratore
• Gestione intelligente delle dipendenze (tramite un solutore SAT)
• Gestisce perfettamente le librerie C, Fortran e di sistema a cui potresti dover fare un collegamento

Quest'ultimo punto è particolarmente importante se ti trovi nell'arena dell'informatica scientifica.