Lancez votre paquetage en convertissant des scripts que vous avez déjà écrits. Vous créerez un paquetage simple que vous pourrez utiliser sur votre propre ordinateur.

Démarrer un paquet

Modules, paquets et sous-paquets

D'un script à un paquet

Mettre votre paquet au travail

Documentation

Rédiger la documentation d'une fonction avec pyment

Rédiger la documentation des fonctions avec pyment II

Documentation du paquet et du module

Structurer les importations

Importations entre modules frères

Importer depuis les répertoires parents

Rendre les fonctions accessibles aux utilisateurs

D'un code épars à un paquetage local

Rendez votre paquetage installable pour vous et pour les autres. Dans ce chapitre, vous apprendrez à gérer les dépendances, à rédiger des READMEs et à inclure des licences. Vous effectuerez aussi toutes les étapes pour publier votre paquetage sur PyPI — l'adresse principale des paquetages Python.

Installer votre propre paquet

Ajouter le script d'installation

Installer votre paquet localement

Utiliser les installations modifiables

Gérer les dépendances

Dépendances côté utilisateur

Dépendances de développement

Inclure des licences et rédiger des READMEs

Rédiger un README

MANIFEST - Inclure des fichiers supplémentaires avec votre paquet

Publier votre paquet

Créer une distribution

Téléverser les distributions

Installer votre paquetage de n'importe où

Amenez votre paquetage à un niveau professionnel. Découvrez comment utiliser pytest pour vous prémunir contre les erreurs, tox pour vérifier si votre paquetage fonctionne avec plusieurs versions de Python, et flake8 pour maintenir un excellent style de code.

Tester votre paquet

Créer le répertoire de tests

Écrire des tests de base

Exécuter vos tests

Tester votre paquet dans différents environnements

Configurer tox

Exécuter tox

Garder votre forfait Python soigné

Filtrage approprié du style

Utiliser flake8 pour remettre un fichier en ordre

Ignorer des erreurs précises

Configurer flake8

Améliorer la qualité de votre paquetage

Créez vos paquetages plus rapidement. Dans ce dernier chapitre, vous apprendrez à utiliser cookiecutter pour générer tous les fichiers de soutien dont votre paquetage a besoin, des Makefiles pour simplifier la sortie de nouvelles versions, et vous serez initié aux derniers fichiers nécessaires pour attirer des utilisateurs et des personnes contributrices.

Accélérez le développement de vos modules avec des gabarits

# 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


Utiliser des modèles de progiciels

Numéros de version et historique

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.


Fichier d'historique

#!/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


Suivre le numéro de version avec bumpversion

Makefiles et classificateurs

#!/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,
)


Classificateurs PyPI

# Run this file to complete the exercise 

# Remove old distributions
make clean

# Run tests
make test

# Make new source and wheel distributions
make dist


Utiliser des makefiles

Récapitulatif

Développement rapide de paquetages

Recopiez-vous souvent le même code d'un fichier à l'autre en souhaitant qu'il soit plus simple à réutiliser et à partager? Regrouper votre code dans des paquetages Python peut vous aider! Dans ce cours, vous apprendrez la structure d'un paquetage et les fichiers additionnels nécessaires pour transformer du code isolé en paquetages pratiques. Vous verrez aussi la structure des importations, la documentation et comment maintenir un style de code uniforme avec flake8. Vous accélérerez ensuite le développement de vos paquetages en bâtissant des gabarits et en utilisant cookiecutter pour créer des squelettes de paquetage. Enfin, vous apprendrez à utiliser setuptools et twine pour construire et publier vos paquetages sur PyPI — la vitrine mondiale des paquetages Python.

Introduction to Shell

Writing Functions in Python

Apprenez la structure des paquets, l'importation, la documentation, le style de code et publiez-les.

Créer des paquetages Python

Apprenez à créer vos propres packages Python pour rendre votre code plus facile à utiliser et à partager.

CONTRIBUTING.md

Créer des paquetages Python

Exercice interactif pratique