Rozjeď svůj balíček tak, že převedeš skripty, které už máš napsané. Vytvoříš jednoduchý balíček, který budeš moct používat na vlastním počítači.

Začínáme tvořit balíček

Moduly, balíčky a subbalíčky

Ze skriptu k balíčku

Využij svůj balíček v praxi

Dokumentace

Psaní dokumentace funkcí pomocí pymentu

Psaní dokumentace funkcí pomocí pyment II

Dokumentace balíčku a modulů

Strukturování importů

Importy mezi moduly

Import z nadřazených modulů

Zpřístupnění funkcí uživatelům

Od volného kódu k lokálnímu balíčku

Připrav svůj balíček k instalaci – pro sebe i pro ostatní. V této kapitole se naučíš pracovat se závislostmi, psát README soubory a přidávat licence. Projdeš také všechny kroky potřebné k publikování balíčku na PyPI – hlavním místě pro Python balíčky.

Instalace vlastního balíčku

Přidání instalačního skriptu

Lokální instalace balíčku

Využití editovatelných instalací

Práce se závislostmi

Závislosti pro uživatele

Vývojové závislosti

Licence a soubory README

Psaní README

MANIFEST – přidání dalších souborů do balíčku

Publikování balíčku

Sestavení distribuce

Nahrání distribucí

Instaluj svůj balíček odkudkoli

Posuň svůj balíček na profesionální úroveň. Zjistíš, jak používat pytest k odhalování chyb, tox k testování kompatibility s různými verzemi Pythonu a flake8 k udržování čistého stylu kódu.

Testování balíčku

Vytvoření testovacího adresáře

Píšeme základní testy

Spouštění testů

Testování balíčku v různých prostředích

Nastavení tox

Spuštění tox

Udržuj svůj balíček ve stylu

Vhodné filtrování stylu

Úprava souboru pomocí flake8

Ignorování konkrétních chyb

Konfigurace flake8

Zvyšování kvality balíčku

Vytvárej balíčky rychleji. V této závěrečné kapitole se naučíš používat cookiecutter k automatickému generování podpůrných souborů, Makefiles ke zjednodušení vydávání nových verzí a seznámíš se s posledními soubory, které balíčku pomůžou přilákat uživatele i přispěvatele.

Rychlejší vývoj balíčků pomocí šablon

# 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


Použití šablon balíčků

Čísla verzí a historie

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.


Soubor HISTORY

#!/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


Sledování čísla verze pomocí bumpversion

Makefile a klasifikátory

#!/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,
)


Klasifikátory 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


Používání Makefile

Závěr

Rychlý vývoj balíčků

Kopíruješ stále stejný kód mezi soubory a přeješ si, aby bylo snazší ho znovu používat a sdílet? Řešením jsou Python balíčky! V tomto kurzu se naučíš, jak jsou balíčky strukturované a jaké soubory potřebuješ, abys z volně napsaného kódu vytvořil/a praktický balíček. Zjistíš také, jak fungují importy, jak psát dokumentaci a jak udržovat čistý styl kódu pomocí flake8. Pak zrychlíš vývoj díky šablonám a nástroji cookiecutter, který ti vygeneruje základní strukturu balíčku. Na závěr se naučíš, jak pomocí setuptools a twine sestavit balíček a publikovat ho na PyPI – hlavním místě pro sdílení Python balíčků.

Introduction to Shell

Writing Functions in Python

Naučte se strukturu balíčků, importy, dokumentaci a udržování stylu kódu, pak publikujte šablony.

Developing Python Packages

Vytvářejte vlastní balíčky Python, aby se váš kód snadněji používal a sdílel s ostatními.

CONTRIBUTING.md

Developing Python Packages

Interaktivní praktické cvičení