Bring dein Paket an den Start, indem du bereits geschriebene Skripte umwandelst. Du erstellst ein einfaches Paket, das du auf deinem eigenen Computer verwenden kannst.

Ein Paket starten

Module, Pakete und Subpackages

Vom Skript zum Paket

Dein Paket in Aktion

Dokumentation

Funktionsdokumentation mit pyment schreiben

Funktionsdokumentation mit pyment II schreiben

Paket- und Modul­dokumentation

Imports strukturieren

Imports zwischen Geschwistermodulen

Import aus übergeordneten Paketen

Funktionen für Nutzer freigeben

Von losem Code zum lokalen Paket

Mach dein Paket für dich und andere installierbar. In diesem Kapitel lernst du, mit Abhängigkeiten umzugehen, READMEs zu schreiben und Lizenzen einzubinden. Außerdem durchläufst du alle Schritte, um dein Paket auf PyPI zu veröffentlichen – der Hauptplattform für Python-Pakete.

Dein eigenes Paket installieren

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


Das Setup-Skript hinzufügen

import impyrial

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


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


Dein Paket lokal installieren

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


Editierbare Installationen nutzen

Mit Abhängigkeiten umgehen

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


Abhängigkeiten deiner Nutzenden

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


Entwicklungsabhängigkeiten

Lizenzen einbinden und READMEs schreiben

____

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


Ein README schreiben

# 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 – Zusätzliche Dateien mit deinem Paket einbinden

Dein Paket veröffentlichen

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


Ein Distribution-Paket bauen

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


Distributionen hochladen

Installiere dein Paket von überall

Hebe dein Paket auf ein professionelles Niveau. Entdecke, wie du mit pytest Fehlern vorbeugst, mit tox testest, ob dein Paket mit mehreren Python-Versionen funktioniert, und mit flake8 einen sauberen Codestil sicherstellst.

Dein Paket testen

Das Testverzeichnis erstellen

Ein paar grundlegende Tests schreiben

Deine Tests ausführen

Dein Paket in unterschiedlichen Umgebungen testen

tox einrichten

tox ausführen

Dein Paket stilvoll halten

Passendes Style-Filtering

Mit flake8 eine Datei aufräumen

Bestimmte Fehler ignorieren

flake8 konfigurieren

Die Qualität deines Pakets steigern

Erstelle deine Pakete schneller. In diesem letzten Kapitel lernst du, wie du mit cookiecutter alle unterstützenden Dateien für dein Paket erzeugst, mit Makefiles das Veröffentlichen neuer Versionen vereinfachst und welche letzten Dateien dein Paket braucht, um Nutzer:innen und Beitragende zu überzeugen.

Schnelleres Paket-Development mit Vorlagen

Paketvorlagen verwenden

Versionsnummern und Verlauf

CONTRIBUTING.md

History-Datei

Versionsnummer mit bumpversion nachverfolgen

Makefiles und Klassifizierer

PyPI-Classifiers

Makefiles verwenden

Zusammenfassung

Schnelle Paketentwicklung

Kopierst du denselben Code ständig zwischen Dateien hin und her und wünschst dir, ihn einfacher wiederzuverwenden und zu teilen? Wenn du deinen Code in Python-Pakete packst, geht das! In diesem Kurs lernst du den Paketaufbau kennen und welche zusätzlichen Dateien nötig sind, um losen Code in handliche Pakete zu verwandeln. Außerdem erfährst du, wie du Importe strukturierst, Dokumentation erstellst und mit flake8 einen einheitlichen Codestil beibehältst. Danach beschleunigst du die Paketentwicklung mit Vorlagen und nutzt cookiecutter, um Paketskelette zu erzeugen. Zum Schluss lernst du, wie du mit setuptools und twine deine Pakete baust und auf PyPI veröffentlichst – der zentralen Bühne für Python-Pakete.

Introduction to Shell

Writing Functions in Python

Lerne Paketstruktur, Importstruktur, Dokumentation und Code-Stil. Erstelle Vorlagen und nutze Setuptools.

Python-Pakete entwickeln

Lerne, eigene Python-Pakete zu erstellen, damit dein Code leichter zu nutzen und mit anderen zu teilen ist.

Ein README schreiben

Interaktive praktische Übung