Ga aan de slag met je pakket door scripts die je al schreef om te zetten. Je maakt een eenvoudig pakket dat je op je eigen computer kunt gebruiken.

Een pakket starten

Modules, packages en subpackages

Van script naar package

Je pakket aan het werk zetten

Documentatie

Functiedocumentatie schrijven met pyment

Functiedocumentatie schrijven met pyment II

Documentatie voor package en module

Imports structureren

Imports tussen sibling-modules

Importeren uit bovenliggende mappen

Functies beschikbaar maken voor gebruikers

Van losse code naar lokaal pakket

Maak je pakket installeerbaar voor jezelf en anderen. In dit hoofdstuk leer je omgaan met afhankelijkheden, READMEs schrijven en licenties opnemen. Je rondt ook alle stappen af om je pakket te publiceren op PyPI—de hoofdplek voor Python-pakketten.

Je eigen pakket installeren

# 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",
)


Het setup-script toevoegen

import impyrial

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


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


Je pakket lokaal installeren

"""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


Gebruikmaken van bewerkbare installs

Omgaan met dependencies

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'],
)


Afhankelijkheden voor gebruikers

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


Ontwikkelingsafhankelijkheden

Licenties opnemen en README's schrijven

____

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
```


Een README schrijven

# 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 - Extra bestanden opnemen in je package

Je pakket publiceren

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


Een distributie bouwen

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


Distributies uploaden

Installeer je pakket vanaf elke locatie

Breng je pakket op een professioneel niveau. Ontdek hoe je pytest gebruikt om fouten te voorkomen, tox om te testen of je pakket werkt met meerdere Python-versies, en flake8 om een strakke codestijl te behouden.

Je package testen

De testmap maken

Eenvoudige tests schrijven

Je tests uitvoeren

Je pakket testen in verschillende omgevingen

tox instellen

tox uitvoeren

Je package stijlvol houden

Passende stijlfiltering

Met flake8 een bestand netjes maken

Specifieke fouten negeren

flake8 configureren

De kwaliteit van je pakket verhogen

Maak je pakketten sneller. In dit laatste hoofdstuk leer je hoe je cookiecutter gebruikt om alle ondersteunende bestanden te genereren die je pakket nodig heeft, Makefiles om het uitbrengen van nieuwe versies te vereenvoudigen, en maak je kennis met de laatste paar bestanden die je pakket nodig heeft om gebruikers en bijdragers aan te trekken.

Sneller pakketten ontwikkelen met templates

Pakkettemplates gebruiken

Versienummers en geschiedenis

CONTRIBUTING.md

Geschiedenisbestand

Versienummer bijhouden met bumpversion

Makefiles en classifiers

PyPI-classifiers

Makefiles gebruiken

Afronding

Snelle pakketontwikkeling

Kopieer en plak je vaak dezelfde code tussen bestanden en wou je dat hergebruiken en delen makkelijker was? Je code verpakken in Python-pakketten helpt! In deze cursus leer je over de pakketstructuur en de extra bestanden die nodig zijn om losse code om te zetten in handige pakketten. Je leert ook over importstructuur, documentatie en hoe je met flake8 een consistente codestijl bewaakt. Daarna versnel je je pakketontwikkeling met sjablonen en gebruik je cookiecutter om pakketskeletten te maken. Tot slot leer je hoe je met setuptools en twine je pakketten bouwt en publiceert op PyPI—het wereldpodium voor Python-pakketten.

Introduction to Shell

Writing Functions in Python

Leer over pakketstructuur, importstructuur, documentatie en code stijl. Bouw sjablonen en publiceer.

Python-pakketten ontwikkelen

Leer je eigen Python-pakketten maken om je code makkelijker te gebruiken en te delen met anderen.

Het setup-script toevoegen

Python-pakketten ontwikkelen

Interactieve oefening met praktijkervaring