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

Opties

Module

Package

Subpackage

Modules, packages en subpackages

# Open the text file
with open('alice.txt') as file:
    text = file.read()

n = 0
for word in text.split():
    # Count the number of times the words in the list appear
    if word.lower() in ['cat', 'cats']:
        n += 1

print('Lewis Carroll uses the word "cat" {} times'.format(n))


def count_words(filepath, words_list):
    # Open the text file
    with open(filepath) as file:
        text = file.read()
    
    n = 0
    for word in text.split():
        # Count the number of times the words in the list appear
        if word.lower() in words_list:
            n += 1
    return n


Van script naar package

def count_words(filepath, words_list):
    # Open the text file
    with open(filepath) as file:
        text = file.read()
    # Count number of times these words appear
    n = 0
    for word in text.split():
        if word.lower() in words_list:
            n += 1
    return n


from textanalysis.textanalysis import count_words

# Count the number of positive words
nb_positive_words = ____(____, [____, ____])

# Count the number of negative words
nb_negative_words = ____(____, ____)

print("{} positive words.".format(nb_positive_words))
print("{} negative words.".format(nb_negative_words))


from textanalysis.textanalysis import count_words

# Count the number of positive words
nb_positive_words = count_words('hotel-reviews.txt', ['good', 'great'])

# Count the number of negative words
nb_negative_words = count_words('hotel-reviews.txt', ['bad', 'awful'])

print("{} positive words.".format(nb_positive_words))
print("{} negative words.".format(nb_negative_words))


Je pakket aan het werk zetten

Documentatie

INCHES_PER_FOOT = 12.0  # 12 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):
    if reverse:
        return x * INCHES_PER_FOOT
    else:
        return x / INCHES_PER_FOOT


INCHES_PER_FOOT = 12.0  # 12 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):
    """

    Parameters
    ----------
    x :

    reverse :
         (Default value = False)

    Returns
    -------

    """
    if reverse:
        return x * INCHES_PER_FOOT
    else:
        return x / INCHES_PER_FOOT


# Run the following command in the console
# pyment -w -o numpydoc impyrial/length/core.py

Functiedocumentatie schrijven met pyment

INCHES_PER_FOOT = 12.0  # 12 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):
    """

    Parameters
    ----------
    x :

    reverse :
         (Default value = False)

    Returns
    -------

    """
    if reverse:
        return x * INCHES_PER_FOOT
    else:
        return x / INCHES_PER_FOOT


INCHES_PER_FOOT = 12.0  # 12 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 : numpy.ndarray
        Lengths in feet.
    reverse : bool, optional
        If true this function converts from feet to inches 
        instead of the default behavior of inches to feet. 
        (Default value = False)

    Returns
    -------
    numpy.ndarray
    """
    if reverse:
        return x * INCHES_PER_FOOT
    else:
        return x / INCHES_PER_FOOT


Functiedocumentatie schrijven met pyment II

"""
impyrial
========
A package for converting between imperial measurements of length and weight.
"""


"""
impyrial.length
===============
Length conversion between imperial units.
"""


"""Conversions between inches and larger imperial length units"""
INCHES_PER_FOOT = 12.0  # 12 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 : numpy.ndarray
        Lengths in feet.
    reverse : bool, optional
        If true this function converts from feet to inches 
        instead of the default behavior of inches to feet. 
        (Default value = False)

    Returns
    -------
    numpy.ndarray
    """
    if reverse:
        return x * INCHES_PER_FOOT
    else:
        return x / INCHES_PER_FOOT


Documentatie voor package en module

Imports structureren

from ____ import ____

result = convert_unit(10, 'in', 'yd')
print(result)


"""User-facing functions."""
from ____ import (
    ____,
    ____,
    ____
)


def convert_unit(x, from_unit, to_unit):
    """Convert from one length unit to another.

    Parameters
    ----------
    x : array_like
        Lengths to convert.
    from_unit : {'in', 'ft', 'yd'}
        Unit of the input lengths `x`
    to_unit : {'in', 'ft', 'yd'}
        Unit of the returned lengths

    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.
    """
    # Convert length to inches
    if from_unit == "in":
        inches = x
    elif from_unit == "ft":
        inches = inches_to_feet(x, reverse=True)
    elif from_unit == "yd":
        inches = inches_to_yards(x, reverse=True)

    # Convert inches to desired units
    if to_unit == "in":
        value = inches
    elif to_unit == "ft":
        value = inches_to_feet(inches)
    elif to_unit == "yd":
        value = inches_to_yards(inches)

    return value


from impyrial.length.api import convert_unit

result = convert_unit(10, 'in', 'yd')
print(result)


"""User-facing functions."""
from impyrial.length.core import (
    UNITS,
    inches_to_feet,
    inches_to_yards
)


def convert_unit(x, from_unit, to_unit):
    """Convert from one length unit to another.

    Parameters
    ----------
    x : array_like
        Lengths to convert.
    from_unit : {'in', 'ft', 'yd'}
        Unit of the input lengths `x`
    to_unit : {'in', 'ft', 'yd'}
        Unit of the returned lengths

    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.
    """
    # Convert length to inches
    if from_unit == "in":
        inches = x
    elif from_unit == "ft":
        inches = inches_to_feet(x, reverse=True)
    elif from_unit == "yd":
        inches = inches_to_yards(x, reverse=True)

    # Convert inches to desired units
    if to_unit == "in":
        value = inches
    elif to_unit == "ft":
        value = inches_to_feet(inches)
    elif to_unit == "yd":
        value = inches_to_yards(inches)

    return value


Imports tussen sibling-modules

from impyrial.length.api import convert_unit

# Make sure unit checking is working by trying examples
print('The following line should run:')
result1 = convert_unit(10, 'in', 'yd')
print(result1)

print('The following line should cause an error:')
result2 = convert_unit(10, 'lb', 'yd')
print(result2)


"""User-facing functions."""
# Import the check_units function
____
from impyrial.length.core import (
    UNITS,
    inches_to_feet,
    inches_to_yards,
)


def convert_unit(x, from_unit, to_unit):
    """Convert from one length unit to another.

    Parameters
    ----------
    x : array_like
        Lengths to convert.
    from_unit : {'in', 'ft', 'yd'}
        Unit of the input lengths `x`
    to_unit : {'in', 'ft', 'yd'}
        Unit of the returned lengths

    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.
    """
    # Check if units are valid length units
    check_units(from_unit, to_unit, UNITS)
    
    # convert length to inches
    if from_unit == "in":
        inches = x
    elif from_unit == "ft":
        inches = inches_to_feet(x, reverse=True)
    elif from_unit == "yd":
        inches = inches_to_yards(x, reverse=True)

    # Convert inches to desired units
    if to_unit == "in":
        value = inches
    elif to_unit == "ft":
        value = inches_to_feet(inches)
    elif to_unit == "yd":
        value = inches_to_yards(inches)

    return value


"""User-facing functions."""
# Import the check_units function
from impyrial.utils import check_units
from impyrial.length.core import (
    UNITS,
    inches_to_feet,
    inches_to_yards,
)


def convert_unit(x, from_unit, to_unit):
    """Convert from one length unit to another.

    Parameters
    ----------
    x : array_like
        Lengths to convert.
    from_unit : {'in', 'ft', 'yd'}
        Unit of the input lengths `x`
    to_unit : {'in', 'ft', 'yd'}
        Unit of the returned lengths

    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.
    """
    # Check if units are valid length units
    check_units(from_unit, to_unit, UNITS)
    
    # Convert length to inches
    if from_unit == "in":
        inches = x
    elif from_unit == "ft":
        inches = inches_to_feet(x, reverse=True)
    elif from_unit == "yd":
        inches = inches_to_yards(x, reverse=True)

    # Convert inches to desired units
    if to_unit == "in":
        value = inches
    elif to_unit == "ft":
        value = inches_to_feet(inches)
    elif to_unit == "yd":
        value = inches_to_yards(inches)

    return value


Importeren uit bovenliggende mappen

# This is the __init__.py file for the impyrial/length subpackage

# Import the convert_unit function from the api.py module
____


# This is the top level __init__.py file

# Import the length subpackage
____


import impyrial

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


# This is the __init__.py file for the impyrial/length subpackage

# Import the convert_unit function from the api.py module
from .api import convert_unit


# This is the top level __init__.py file

# Import the length subpackage
from . import length


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

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.

Functiedocumentatie schrijven met pyment II

Python-pakketten ontwikkelen

Interactieve oefening met praktijkervaring