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

# Import required functions
____

# Call setup function
____(
    author="<your-name>",
    description="____",
    name="____",
    packages=____(____=____),
    version="____",
)


# Import required functions
from setuptools import setup, find_packages

# Call setup function
setup(
    author="<your-name>",
    description="A package for converting imperial lengths and weights.",
    name="impyrial",
    packages=find_packages(include=["impyrial", "impyrial.*"]),
    version="0.1.0",
)


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

import impyrial

result = impyrial.length.convert_unit(10, 'in', 'yd')
print(result)


# Run this to install the package locally
pip install -e .


Lokální instalace balíčku

"""Conversions between ounces and larger imperial weight units"""
OUNCES_PER_POUND = 160  # 16 ounces in a pound
OUNCES_PER_STONE = OUNCES_PER_POUND * 14.0  # 14 pounds in a stone

UNITS = ("oz", "lb", "st")


def ounces_to_pounds(x, reverse=False):
    """Convert weights between ounces and pounds.

    Parameters
    ----------
    x : array_like
        Weights in pounds.
    reverse : bool, optional
        If this is set to true this function converts from pounds to ounces
        instead of the default behaviour of ounces to pounds.

    Returns
    -------
    ndarray
        An array of converted weights with the same shape as `x`. If `x` is a
        0-d array, then a scalar is returned.
    """
    if reverse:
        return x * OUNCES_PER_POUND
    else:
        return x / OUNCES_PER_POUND


def ounces_to_stone(x, reverse=False):
    """Convert weights between ounces and stone.

    Parameters
    ----------
    x : array_like
        Weights in stone.
    reverse : bool, optional
        If this is set to true this function converts from stone to ounces
        instead of the default behaviour of ounces to stone.

    Returns
    -------
    ndarray
        An array of converted weights with the same shape as `x`. If `x` is a
        0-d array, then a scalar is returned.
    """
    if reverse:
        return x * OUNCES_PER_STONE
    else:
        return x / OUNCES_PER_STONE


import impyrial

result = impyrial.weight.convert_unit(2, 'lb', 'oz')
print(result)


"""Conversions between ounces and larger imperial weight units"""
OUNCES_PER_POUND = 16.0  # 16 ounces in a pound
OUNCES_PER_STONE = OUNCES_PER_POUND * 14.0  # 14 pounds in a stone

UNITS = ("oz", "lb", "st")


def ounces_to_pounds(x, reverse=False):
    """Convert weights between ounces and pounds.

    Parameters
    ----------
    x : array_like
        Weights in pounds.
    reverse : bool, optional
        If this is set to true this function converts from pounds to ounces
        instead of the default behaviour of ounces to pounds.

    Returns
    -------
    ndarray
        An array of converted weights with the same shape as `x`. If `x` is a
        0-d array, then a scalar is returned.
    """
    if reverse:
        return x * OUNCES_PER_POUND
    else:
        return x / OUNCES_PER_POUND


def ounces_to_stone(x, reverse=False):
    """Convert weights between ounces and stone.

    Parameters
    ----------
    x : array_like
        Weights in stone.
    reverse : bool, optional
        If this is set to true this function converts from stone to ounces
        instead of the default behaviour of ounces to stone.

    Returns
    -------
    ndarray
        An array of converted weights with the same shape as `x`. If `x` is a
        0-d array, then a scalar is returned.
    """
    if reverse:
        return x * OUNCES_PER_STONE
    else:
        return x / OUNCES_PER_STONE


Využití editovatelných instalací

Práce se závislostmi

from setuptools import setup, find_packages

# Add install requirements
setup(
    author="<your-name>",
    description="A package for converting imperial lengths and weights.",
    name="impyrial",
    packages=find_packages(include=["impyrial", "impyrial.*"]),
    version="0.1.0",
    ____=____,
)


from setuptools import setup, find_packages

# Add install requirements
setup(
    author="<your-name>",
    description="A package for converting imperial lengths and weights.",
    name="impyrial",
    packages=find_packages(include=["impyrial", "impyrial.*"]),
    version="0.1.0",
    install_requires=['numpy>=1.10', 'pandas'],
)


Závislosti pro uživatele

# Run this script to install the package locally
pip freeze > requirements.txt


Vývojové závislosti

Licence a soubory README

____

A package for converting between imperial unit lengths and weights.

This package was created for the ____DataCamp____ course "Developing Python Packages".

### Features

- Convert lengths between miles, yards, feet and inches.
- Convert weights between hundredweight, stone, pounds and ounces.

### Usage

____
import impyrial

# Convert 500 miles to feet
impyrial.length.convert_unit(500, from_unit='yd', to_unit='ft')  # returns 1500.0

# Convert 100 ounces to pounds
impyrial.weight.convert_unit(100, from_unit='oz', to_unit='lb')  # returns 6.25
____


# impyrial

A package for converting between imperial unit lengths and weights.

This package was created for the [DataCamp](https://www.datacamp.com) course "Developing Python Packages".

### Features

- Convert lengths between miles, yards, feet and inches.
- Convert weights between hundredweight, stone, pounds and ounces.

### Usage

```
import impyrial

# Convert 500 miles to feet
impyrial.length.convert_unit(500, from_unit='yd', to_unit='ft')  # returns 1500.0

# Convert 100 ounces to pounds
impyrial.weight.convert_unit(100, from_unit='oz', to_unit='lb')  # returns 6.25
```


Psaní README

# impyrial

A package for converting between imperial unit lengths and weights.

This package was created for the [DataCamp](https://www.datacamp.com) course Developing Python Packages.

### Features

- Convert lengths between miles, yards, feet and inches.
- Convert weights between hundredweight, stone, pounds and ounces.

### Usage

```
import impyrial

# convert 500 miles to feet
impyrial.length.convert_unit(500, from_unit='yd', to_unit='ft')  # returns 1500.0

# convert 100 ounces to pounds
impyrial.weight.convert_unit(100, from_unit='oz', to_unit='lb')  # returns 6.25
```


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

Publikování balíčku

# Run this code to complete the exercise
python3 setup.py sdist bdist_wheel


Sestavení distribuce

# Run the following in the terminal:
# twine upload dist/*


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

Použití šablon balíčků

Čísla verzí a historie

CONTRIBUTING.md

Soubor HISTORY

Sledování čísla verze pomocí bumpversion

Makefile a klasifikátory

Klasifikátory PyPI

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.

Psaní README

Developing Python Packages

Interaktivní praktické cvičení