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

Het setup-script toevoegen

Je pakket lokaal installeren

Gebruikmaken van bewerkbare installs

Omgaan met dependencies

Afhankelijkheden voor gebruikers

Ontwikkelingsafhankelijkheden

Licenties opnemen en README's schrijven

Een README schrijven

MANIFEST - Extra bestanden opnemen in je package

Je pakket publiceren

Een distributie bouwen

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

from impyrial.length.core import inches_to_feet, inches_to_yards


De testmap maken

from impyrial.length.core import inches_to_feet, inches_to_yards

# Define tests for inches_to_feet function
def ____():
	# Check that 12 inches is converted to 1.0 foot
    ____ ____(____) == 1.0 
    # Check that 2.5 feet is converted to 30.0 inches
    ____ ____(____, reverse=True) == ____


from impyrial.length.core import inches_to_feet, inches_to_yards

# Define tests for inches_to_feet function
def test_inches_to_feet():
	# Check that 12 inches is converted to 1.0 foot
    assert inches_to_feet(12) == 1.0
    # Check that 2.5 feet is converted to 30.0 inches
    assert inches_to_feet(2.5, reverse=True) == 30.0


Eenvoudige tests schrijven

from impyrial.length.core import inches_to_feet, inches_to_yards

# Define tests for inches_to_feet function
def test_inches_to_feet():
	# Check that 12 inches is converted to 1 foot
    assert inches_to_feet(12) == 1.0
    # Check that 2.5 feet is converted to 30 inches
    assert inches_to_feet(2.5, reverse=True) == 30.0
    


"""Conversions between inches and larger imperial length units"""
INCHES_PER_FOOT = 120  # 12.0 inches in a foot
INCHES_PER_YARD = INCHES_PER_FOOT * 3.0  # 3 feet in a yard

UNITS = ("in", "ft", "yd")


def inches_to_feet(x, reverse=False):
    """Convert lengths between inches and feet.
    Parameters
    ----------
    x : array_like
        Lengths in feet.
    reverse : bool, optional
        If this is set to true this function converts from feet to inches
        instead of the default behaviour of inches to feet.
    Returns
    -------
    ndarray
        An array of converted lengths with the same shape as `x`. If `x` is a
        0-d array, then a scalar is returned.
    """
    if reverse:
        return x * INCHES_PER_FOOT
    else:
        return x / INCHES_PER_FOOT


def inches_to_yards(x, reverse=False):
    """Convert lengths between inches and yards.
    Parameters
    ----------
    x : array_like
        Lengths in feet.
    reverse : bool, optional
        If this is set to true this function converts from yards to inches
        instead of the default behaviour of inches to yards.
    Returns
    -------
    ndarray
        An array of converted lengths with the same shape as `x`. If `x` is a
        0-d array, then a scalar is returned.
    """
    if reverse:
        return x * INCHES_PER_YARD
    else:
        return x / INCHES_PER_YARD


"""Conversions between inches and larger imperial length units"""
INCHES_PER_FOOT = 12.0  # 12.0 inches in a foot
INCHES_PER_YARD = INCHES_PER_FOOT * 3.0  # 3 feet in a yard

UNITS = ("in", "ft", "yd")


def inches_to_feet(x, reverse=False):
    """Convert lengths between inches and feet.
    Parameters
    ----------
    x : array_like
        Lengths in feet.
    reverse : bool, optional
        If this is set to true this function converts from feet to inches
        instead of the default behaviour of inches to feet.
    Returns
    -------
    ndarray
        An array of converted lengths with the same shape as `x`. If `x` is a
        0-d array, then a scalar is returned.
    """
    if reverse:
        return x * INCHES_PER_FOOT
    else:
        return x / INCHES_PER_FOOT


def inches_to_yards(x, reverse=False):
    """Convert lengths between inches and yards.
    Parameters
    ----------
    x : array_like
        Lengths in feet.
    reverse : bool, optional
        If this is set to true this function converts from yards to inches
        instead of the default behaviour of inches to yards.
    Returns
    -------
    ndarray
        An array of converted lengths with the same shape as `x`. If `x` is a
        0-d array, then a scalar is returned.
    """
    if reverse:
        return x * INCHES_PER_YARD
    else:
        return x / INCHES_PER_YARD


Je tests uitvoeren

Je pakket testen in verschillende omgevingen

[tox]
____

[testenv]
____ = 
	____
____ =
	____


[tox]
envlist = py27, py39

[testenv]
deps = 
	pytest
commands =
	pytest


tox instellen

[tox]
envlist = py27, py39

[testenv]
deps = 
	pytest
commands =
	pytest
    


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'],
    #python_requires="==____.*",
)


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'],
    python_requires="==3.9.*",
)


tox uitvoeren

Je package stijlvol houden

Passende stijlfiltering

"""Main module."""

def absolute_value(num):
    """Return the absolute value of the number"""
    if num>=0: return num
    else:
    	return -num


"""Main module."""


def absolute_value(num):
    """Return the absolute value of the number"""
    if num >= 0:
        return num
    else:
        return -num


Met flake8 een bestand netjes maken

import numpy as np


def calculate_hypotenuse(side1, side2):
    """Calculate the length of the hypotenuse."""
    l = np.sqrt( side1**2 + side2**2 )  # ____: ____
    return l


import numpy as np


def calculate_hypotenuse(side1, side2):
    """Calculate the length of the hypotenuse."""
    l = np.sqrt( side1**2 + side2**2 )  # noqa: E741
    return l


Specifieke fouten negeren

[flake8]

# Ignore F401 violations in the main __init__.py file
# per-file-ignores =
#     ____ : ____
        
# Ignore all violations in the tests directoory
# exclude = ____


from impyrial.length.api import (
    convert_unit,
    unit_to_mixed,
    mixed_to_unit,
)

def test_convert_unit():
    assert convert_unit(30, "ft", "in")==360.0
    assert convert_unit(30, "yd", "ft")==90.0
    assert convert_unit(10, "mi", "yd")==17600.0


[flake8]

# Ignore F401 violations in the main __init__.py file
per-file-ignores =
    impyrial/__init__.py: F401
        
# Ignore all violations in the tests directoory
exclude = tests/*


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.

tox instellen

Python-pakketten ontwikkelen

Interactieve oefening met praktijkervaring