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

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

# Run this script to create package template
# After running you will still need to type in the terminal to specify the template options
cookiecutter https://github.com/audreyfeldroy/cookiecutter-pypackage.git


Pakkettemplates gebruiken

Versienummers en geschiedenis

CONTRIBUTING.md

# History

## ____
### _____
____
### ____
____

## 0.1.0
### Added
- First release on PyPI.


# History

## 0.2.0
### Fixed
- Bug fixed in `length` subpackage for inches-to-feet conversion.
### Deprecated
- Removed Python 2.7 support.

## 0.1.0
### Added
- First release on PyPI.


Geschiedenisbestand

#!/usr/bin/env python

"""The setup script."""

from setuptools import setup, find_packages

with open('README.md') as readme_file:
    readme = readme_file.read()

with open('HISTORY.md') as history_file:
	history = history_file.read()

setup(
	author="All credit to you",
    author_email='you@chapter4.com',
    description="A package for converting between imperial unit lengths and weights.",
    name='impyrial',
    packages=find_packages(include=['impyrial', 'impyrial.*']),
    version='0.1.0',
    install_requires=['numpy>=1.10', 'pandas'],
    python_requires="==3.6.*",
    classifiers=[
        'Development Status :: 2 - Pre-Alpha',
        'Intended Audience :: Developers',
        'License :: OSI Approved :: MIT License',
        'Natural Language :: English',
        'Programming Language :: Python :: 2',
        'Programming Language :: Python :: 2.7',
        'Programming Language :: Python :: 3',
        'Programming Language :: Python :: 3.6',
    ],
    license="MIT license",
    long_description=readme + '\n\n' + history,
    keywords='impyrial',    
    zip_safe=False,
)


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

__author__ = "All credit to you"
__version__ = '0.1.0'

from . import length  # noqa : F401
from . import weight  # noqa : F401


# Copy and run this command in the terminal to increase the minor package number
bumpversion minor


Versienummer bijhouden met bumpversion

Makefiles en classifiers

#!/usr/bin/env python

"""The setup script."""

from setuptools import setup, find_packages

with open('README.md') as readme_file:
    readme = readme_file.read()

with open('HISTORY.md') as history_file:
    history = history_file.read()

setup(
    author="All credit to you",
    author_email='you@chapter4.com',
    description="A package for converting between imperial unit lengths and weights.",
    name='impyrial',
    packages=find_packages(include=['impyrial', 'impyrial.*']),
    version='0.1.0',
    install_requires=['numpy>=1.10', 'pandas'],
    python_requires="==3.6.*",
    classifiers=[
        'Development Status :: 2 - Pre-Alpha',
        'Intended Audience :: Developers',
        'License :: OSI Approved :: MIT License',
        'Natural Language :: English',
        'Programming Language :: Python :: 3',
        'Programming Language :: Python :: 3.6',
        'Programming Language :: Python :: 3.7',
        'Programming Language :: Python :: 3.8',
    ],
    license="MIT license",
    long_description=readme + '\n\n' + history,
    long_description_content_type='text/markdown',
    keywords='impyrial',    
    zip_safe=False,
)


#!/usr/bin/env python

"""The setup script."""

from setuptools import setup, find_packages

with open('README.md') as readme_file:
    readme = readme_file.read()

with open('HISTORY.md') as history_file:
    history = history_file.read()

setup(
    author="All credit to you",
    author_email='you@chapter4.com',
    description="A package for converting between imperial unit lengths and weights.",
    name='impyrial',
    packages=find_packages(include=['impyrial', 'impyrial.*']),
    version='0.1.0',
    install_requires=['numpy>=1.10', 'pandas'],
    python_requires="==3.6.*",
    classifiers=[
        'Development Status :: 2 - Pre-Alpha',
        'Intended Audience :: Developers',
        'License :: OSI Approved :: MIT License',
        'Natural Language :: English',
        'Programming Language :: Python :: 3',
        'Programming Language :: Python :: 3.6',
    ],
    license="MIT license",
    long_description=readme + '\n\n' + history,
    long_description_content_type='text/markdown',
    keywords='impyrial',    
    zip_safe=False,
)


PyPI-classifiers

# Run this file to complete the exercise 

# Remove old distributions
make clean

# Run tests
make test

# Make new source and wheel distributions
make dist


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.

CONTRIBUTING.md

Python-pakketten ontwikkelen

Interactieve oefening met praktijkervaring