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

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


Ajouter le script d'installation

import impyrial

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


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


Installer votre paquet localement

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


Utiliser les installations modifiables

Gérer les dépendances

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


Dépendances côté utilisateur

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


Dépendances de développement

Inclure des licences et rédiger des READMEs

____

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


Rédiger un README

# 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 - Inclure des fichiers supplémentaires avec votre paquet

Publier votre paquet

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


Créer une distribution

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


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

Utiliser des modèles de progiciels

Numéros de version et historique

CONTRIBUTING.md

Fichier d'historique

Suivre le numéro de version avec bumpversion

Makefiles et classificateurs

Classificateurs PyPI

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.

Installer votre paquet localement

Créer des paquetages Python

Exercice interactif pratique