Zacznij budować pakiet, przekształcając skrypty, które już napisałeś. Stworzysz prosty pakiet, z którego będziesz korzystać na własnym komputerze.

Tworzenie pakietu

Moduły, pakiety i podpakiety

Od skryptu do pakietu

Zastosuj swój pakiet w praktyce

Dokumentacja

Tworzenie dokumentacji funkcji za pomocą pyment

Dokumentowanie funkcji za pomocą pyment – część II

Dokumentacja pakietu i modułu

Strukturyzacja importów

Importy między modułami

Importowanie z pakietów nadrzędnych

Udostępnianie funkcji użytkownikom

Od luźnego kodu do lokalnego pakietu

Spraw, by twój pakiet można było zainstalować — zarówno dla siebie, jak i dla innych. W tym rozdziale nauczysz się zarządzać zależnościami, pisać pliki README oraz dodawać licencje. Przejdziesz też przez wszystkie kroki potrzebne do opublikowania pakietu w PyPI — głównym repozytorium pakietów Pythona.

Instalowanie własnego pakietu

Dodawanie skryptu setup

Lokalna instalacja pakietu

Instalacja w trybie edytowalnym

Zarządzanie zależnościami

Zależności użytkownika

Zależności deweloperskie

Dołączanie licencji i pisanie plików README

Pisanie pliku README

MANIFEST – dołączanie dodatkowych plików do pakietu

Publikowanie pakietu

Tworzenie dystrybucji

Przesyłanie dystrybucji

Instalacja pakietu z dowolnego miejsca

Doprowadź swój pakiet do profesjonalnego poziomu. Dowiesz się, jak używać pytest do wykrywania błędów, tox do testowania zgodności pakietu z różnymi wersjami Pythona oraz flake8 do dbania o styl kodu.

Testowanie pakietu

Tworzenie katalogu testów

Pisanie podstawowych testów

Uruchamianie testów

Testowanie pakietu w różnych środowiskach

Konfiguracja tox

Uruchamianie tox

Dbaj o styl swojego pakietu

Odpowiednie filtrowanie stylu

Porządkowanie pliku za pomocą flake8

Ignorowanie wybranych błędów

Konfigurowanie flake8

Podnoszenie jakości pakietu

Twórz pakiety szybciej i sprawniej. W tym ostatnim rozdziale nauczysz się używać cookiecutter do generowania wszystkich potrzebnych plików pomocniczych, plików Makefile do upraszczania wydawania nowych wersji. Poznasz też ostatnie pliki, które pomogą przyciągnąć użytkowników i współtwórców do twojego pakietu.

Szybsze tworzenie pakietów dzięki szablonom

# Run this script to create package template
# After running you will still need to type in the terminal to specify the template options
cookiecutter https://github.com/audreyfeldroy/cookiecutter-pypackage.git --checkout v0.5.0


Korzystanie z szablonów pakietów

Numery wersji i historia zmian

CONTRIBUTING.md

# History

## ____
### _____
____
### ____
____

## 0.1.0
### Added
- First release on PyPI.


# History

## 0.2.0
### Fixed
- Bug fixed in `length` subpackage for inches-to-feet conversion.
### Deprecated
- Removed Python 2.7 support.

## 0.1.0
### Added
- First release on PyPI.


Plik historii

#!/usr/bin/env python

"""The setup script."""

from setuptools import setup, find_packages

with open('README.md') as readme_file:
    readme = readme_file.read()

with open('HISTORY.md') as history_file:
	history = history_file.read()

setup(
	author="All credit to you",
    author_email='you@chapter4.com',
    description="A package for converting between imperial unit lengths and weights.",
    name='impyrial',
    packages=find_packages(include=['impyrial', 'impyrial.*']),
    version='0.1.0',
    install_requires=['numpy>=1.10', 'pandas'],
    python_requires="==3.6.*",
    classifiers=[
        'Development Status :: 2 - Pre-Alpha',
        'Intended Audience :: Developers',
        'License :: OSI Approved :: MIT License',
        'Natural Language :: English',
        'Programming Language :: Python :: 2',
        'Programming Language :: Python :: 2.7',
        'Programming Language :: Python :: 3',
        'Programming Language :: Python :: 3.6',
    ],
    license="MIT license",
    long_description=readme + '\n\n' + history,
    keywords='impyrial',    
    zip_safe=False,
)


__doc__ = """
impyrial
========
A package for converting between imperial measurments of length and weight.
"""

__author__ = "All credit to you"
__version__ = '0.1.0'

from . import length  # noqa : F401
from . import weight  # noqa : F401


# Copy and run this command in the terminal to increase the minor package number
bumpversion minor


Śledzenie numeru wersji za pomocą bumpversion

Pliki Makefile i klasyfikatory

#!/usr/bin/env python

"""The setup script."""

from setuptools import setup, find_packages

with open('README.md') as readme_file:
    readme = readme_file.read()

with open('HISTORY.md') as history_file:
    history = history_file.read()

setup(
    author="All credit to you",
    author_email='you@chapter4.com',
    description="A package for converting between imperial unit lengths and weights.",
    name='impyrial',
    packages=find_packages(include=['impyrial', 'impyrial.*']),
    version='0.1.0',
    install_requires=['numpy>=1.10', 'pandas'],
    python_requires="==3.6.*",
    classifiers=[
        'Development Status :: 2 - Pre-Alpha',
        'Intended Audience :: Developers',
        'License :: OSI Approved :: MIT License',
        'Natural Language :: English',
        'Programming Language :: Python :: 3',
        'Programming Language :: Python :: 3.6',
        'Programming Language :: Python :: 3.7',
        'Programming Language :: Python :: 3.8',
    ],
    license="MIT license",
    long_description=readme + '\n\n' + history,
    long_description_content_type='text/markdown',
    keywords='impyrial',    
    zip_safe=False,
)


#!/usr/bin/env python

"""The setup script."""

from setuptools import setup, find_packages

with open('README.md') as readme_file:
    readme = readme_file.read()

with open('HISTORY.md') as history_file:
    history = history_file.read()

setup(
    author="All credit to you",
    author_email='you@chapter4.com',
    description="A package for converting between imperial unit lengths and weights.",
    name='impyrial',
    packages=find_packages(include=['impyrial', 'impyrial.*']),
    version='0.1.0',
    install_requires=['numpy>=1.10', 'pandas'],
    python_requires="==3.6.*",
    classifiers=[
        'Development Status :: 2 - Pre-Alpha',
        'Intended Audience :: Developers',
        'License :: OSI Approved :: MIT License',
        'Natural Language :: English',
        'Programming Language :: Python :: 3',
        'Programming Language :: Python :: 3.6',
    ],
    license="MIT license",
    long_description=readme + '\n\n' + history,
    long_description_content_type='text/markdown',
    keywords='impyrial',    
    zip_safe=False,
)


Klasyfikatory PyPI

# Run this file to complete the exercise 

# Remove old distributions
make clean

# Run tests
make test

# Make new source and wheel distributions
make dist


Korzystanie z plików Makefile

Podsumowanie

Szybkie tworzenie pakietów

Czy zdarza ci się kopiować ten sam kod między plikami i marzyć o łatwiejszym sposobie na jego ponowne wykorzystanie? Opakowanie kodu w pakiety Pythona rozwiązuje ten problem! W tym kursie poznasz strukturę pakietów i dodatkowe pliki potrzebne do przekształcenia luźnego kodu w wygodne pakiety. Dowiesz się też, jak organizować importy, pisać dokumentację i dbać o styl kodu za pomocą flake8. Następnie przyśpieszysz tworzenie pakietów, korzystając z szablonów i narzędzia cookiecutter do generowania szkieletów pakietów. Na koniec nauczysz się używać setuptools i twine, aby budować pakiety i publikować je w PyPI — głównym repozytorium pakietów Pythona.

Introduction to Shell

Writing Functions in Python

Poznaj strukturę pakietu, import, dokumentację i styl kodu, a następnie twórz szablony i publikuj je.

Tworzenie pakietów w Pythonie

Twórz własne pakiety Python, by ułatwić używanie kodu i dzielenie się nim z innymi.

Korzystanie z szablonów pakietów

Tworzenie pakietów w Pythonie

Interaktywne ćwiczenie praktyczne