Aiuta a installare un pacchetto python foosul tuo computer (può anche essere in virtualenv) in modo da poter importare il pacchetto fooda altri progetti e anche dai prompt [I] Python.
Fa il lavoro simile di pip, easy_installecc.,
utilizzando setup.py
Cominciamo con alcune definizioni:
Pacchetto : una cartella / directory che contiene __init__.pyfile.
Modulo : un file Python valido con .pyestensione.
Distribuzione : relazione di un pacchetto con altri pacchetti e moduli .
Supponiamo che tu voglia installare un pacchetto chiamato foo. Poi lo fai
$ git clone https://github.com/user/foo
$ cd foo
$ python setup.py install
Invece, se non si desidera installarlo effettivamente, ma si desidera comunque utilizzarlo. Quindi fa,
$ python setup.py develop
Questo comando creerà collegamenti simbolici alla directory di origine all'interno dei pacchetti del sito invece di copiare le cose. Per questo motivo, è abbastanza veloce (in particolare per i pacchetti di grandi dimensioni).
Creazione setup.py
Se hai l'albero dei pacchetti simile,
foo
├── foo
│ ├── data_struct.py
│ ├── __init__.py
│ └── internals.py
├── README
├── requirements.txt
└── setup.py
Quindi, esegui le seguenti operazioni nel tuo setup.pyscript in modo che possa essere installato su alcuni computer:
from setuptools import setup
setup(
name='foo',
version='1.0',
description='A useful module',
author='Man Foo',
author_email='foomail@foo.com',
packages=['foo'], #same as name
install_requires=['bar', 'greek'], #external packages as dependencies
)
Invece, se l'albero dei pacchetti è più complesso come quello qui sotto:
foo
├── foo
│ ├── data_struct.py
│ ├── __init__.py
│ └── internals.py
├── README
├── requirements.txt
├── scripts
│ ├── cool
│ └── skype
└── setup.py
Quindi, setup.pyin questo caso sarebbe come:
from setuptools import setup
setup(
name='foo',
version='1.0',
description='A useful module',
author='Man Foo',
author_email='foomail@foo.com',
packages=['foo'], #same as name
install_requires=['bar', 'greek'], #external packages as dependencies
scripts=[
'scripts/cool',
'scripts/skype',
]
)
Aggiungi più cose a ( setup.py) e rendilo decente:
from setuptools import setup
with open("README", 'r') as f:
long_description = f.read()
setup(
name='foo',
version='1.0',
description='A useful module',
license="MIT",
long_description=long_description,
author='Man Foo',
author_email='foomail@foo.com',
url="http://www.foopackage.com/",
packages=['foo'], #same as name
install_requires=['bar', 'greek'], #external packages as dependencies
scripts=[
'scripts/cool',
'scripts/skype',
]
)
Il file long_descriptionè usato in pypi.org come descrizione README del pacchetto.
Infine, ora sei pronto per caricare il tuo pacchetto su PyPi.org in modo che altri possano installarlo usando pip install yourpackage.
Il primo passo è rivendicare il nome e lo spazio del pacchetto in pypi usando:
$ python setup.py register
Una volta registrato il nome del pacchetto, nessuno può richiederlo o utilizzarlo. Dopo aver effettuato correttamente la registrazione, devi caricare il tuo pacchetto lì (sul cloud) tramite,
$ python setup.py upload
Facoltativamente, puoi anche firmare il tuo pacchetto con GPG,
$ python setup.py --sign upload
Bonus : vedi un campione setup.pyda un progetto reale qui:torchvision-setup.py