Pomaga zainstalować pakiet Pythona foona twoim komputerze (może być również w virtualenv), abyś mógł zaimportować pakiet fooz innych projektów, a także z [I] monitów Pythona.
Czyni podobną pracę pip, easy_installitd.,
Za pomocą setup.py
Zacznijmy od kilku definicji:
Pakiet - folder / katalog zawierający __init__.pyplik.
Moduł - prawidłowy plik python z .pyrozszerzeniem.
Dystrybucja - jak jeden pakiet odnosi się do innych pakietów i modułów .
Powiedzmy, że chcesz zainstalować pakiet o nazwie foo. To robisz
$ git clone https://github.com/user/foo
$ cd foo
$ python setup.py install
Zamiast tego, jeśli nie chcesz go instalować, ale nadal chcesz go używać. Więc zrób
$ python setup.py develop
To polecenie utworzy dowiązania symboliczne do katalogu źródłowego w pakietach witryn zamiast kopiowania. Z tego powodu jest dość szybki (szczególnie w przypadku dużych paczek).
Tworzenie setup.py
Jeśli masz takie drzewo pakietów,
foo
├── foo
│ ├── data_struct.py
│ ├── __init__.py
│ └── internals.py
├── README
├── requirements.txt
└── setup.py
Następnie wykonaj następujące czynności w setup.pyskrypcie, aby można go było zainstalować na niektórych komputerach:
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
)
Zamiast tego, jeśli twoje drzewo pakietów jest bardziej złożone, jak to poniżej:
foo
├── foo
│ ├── data_struct.py
│ ├── __init__.py
│ └── internals.py
├── README
├── requirements.txt
├── scripts
│ ├── cool
│ └── skype
└── setup.py
Wtedy twój setup.pyw tym przypadku wyglądałby tak:
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',
]
)
Dodaj więcej rzeczy do ( setup.py) i spraw, by było przyzwoite:
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',
]
)
long_descriptionJest stosowany w pypi.org jako opis README z pakietu.
I na koniec, możesz teraz przesłać swój pakiet na PyPi.org , aby inni mogli go zainstalować przy użyciu pip install yourpackage.
Pierwszym krokiem jest zdobycie nazwy i przestrzeni pakietu w pypi przy użyciu:
$ python setup.py register
Po zarejestrowaniu nazwy paczki nikt nie może jej zażądać ani z niej korzystać. Po udanej rejestracji musisz tam przesłać swój pakiet (do chmury),
$ python setup.py upload
Opcjonalnie możesz również podpisać paczkę za GPGpomocą,
$ python setup.py --sign upload
Bonus : Zobacz próbkę setup.pyz prawdziwego projektu tutaj:torchvision-setup.py