Avvia il tuo pacchetto convertendo script che hai già scritto. Creerai un semplice pacchetto che potrai usare sul tuo computer.

Avviare un pacchetto

Moduli, package e subpackage

Da script a package

Mettere al lavoro il tuo package

Documentazione

Scrivere la documentazione delle funzioni con pyment

Scrivere la documentazione delle funzioni con pyment II

Documentazione di package e moduli

Strutturare gli import

Import tra moduli fratelli

Importare dai parent

Rendere disponibili le funzioni agli utenti

Dal codice sparso al pacchetto locale

Rendi il tuo pacchetto installabile per te e per gli altri. In questo capitolo imparerai a gestire le dipendenze, a scrivere i README e a includere le licenze. Completerai anche tutti i passaggi per pubblicare il tuo pacchetto su PyPI — la casa principale dei pacchetti Python.

Installare il tuo pacchetto

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


Aggiungere lo script di setup

import impyrial

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


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


Installare il tuo pacchetto in locale

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


Usare le installazioni modificabili

Gestire le dipendenze

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


Dipendenze dell’utente

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


Dipendenze di sviluppo

Includere le licenze e scrivere i README

____

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


Scrivere 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 - Includere file extra nel tuo pacchetto

Pubblicare il tuo pacchetto

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


Creare una distribuzione

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


Caricare le distribuzioni

Installa il tuo pacchetto da ovunque

Porta il tuo pacchetto a uno standard professionale. Scopri come usare pytest per proteggerti dagli errori, tox per testare il tuo pacchetto con più versioni di Python e flake8 per mantenere uno stile di codice eccellente.

Testare il tuo pacchetto

Creare la directory dei test

Scrivere alcuni test di base

Esecuzione dei test

Testare il tuo pacchetto in ambienti diversi

Configurare tox

Esecuzione di tox

Mantieni il tuo package elegante

Filtrare lo stile in modo appropriato

Usare flake8 per ripulire un file

Ignorare errori specifici

Configurare flake8

Aumentare la qualità del tuo pacchetto

Crea i tuoi pacchetti più velocemente. In questo capitolo finale imparerai a usare cookiecutter per generare tutti i file di supporto necessari al tuo pacchetto, i Makefile per semplificare il rilascio di nuove versioni e conoscerai gli ultimi file utili ad attrarre utenti e contributor.

Sviluppo di pacchetti più rapido con i template

Uso dei template per i package

Numeri di versione e cronologia

CONTRIBUTING.md

File della cronologia

Tenere traccia della versione con bumpversion

Makefile e classifier

Classifier PyPI

Uso dei Makefile

Riepilogo

Sviluppo rapido di pacchetti

Ti capita di copiare e incollare lo stesso codice tra file, desiderando fosse più semplice riutilizzarlo e condividerlo? Impacchettare il tuo codice in pacchetti Python può aiutarti! In questo corso imparerai la struttura di un pacchetto e i file aggiuntivi necessari per trasformare codice sparso in pacchetti pratici. Imparerai anche la struttura degli import, la documentazione e come mantenere lo stile del codice con flake8. Poi velocizzerai lo sviluppo dei pacchetti creando template, usando cookiecutter per generare gli scheletri dei pacchetti. Infine, scoprirai come usare setuptools e twine per creare e pubblicare i tuoi pacchetti su PyPI — il palcoscenico mondiale dei pacchetti Python.

Introduction to Shell

Writing Functions in Python

Scopri struttura pacchetti, importazioni, documentazione, stile codice, crea modelli e pubblicali.

Sviluppare pacchetti Python

Impara a creare i tuoi pacchetti Python per rendere il tuo codice più facile da usare e condividere con gli altri.

Installare il tuo pacchetto in locale

Sviluppare pacchetti Python

esercizio interattivo pratico