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

Aggiungere lo script di setup

Installare il tuo pacchetto in locale

Usare le installazioni modificabili

Gestire le dipendenze

Dipendenze dell’utente

Dipendenze di sviluppo

Includere le licenze e scrivere i README

Scrivere un README

MANIFEST - Includere file extra nel tuo pacchetto

Pubblicare il tuo pacchetto

Creare una distribuzione

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

from impyrial.length.core import inches_to_feet, inches_to_yards


Creare la directory dei test

from impyrial.length.core import inches_to_feet, inches_to_yards

# Define tests for inches_to_feet function
def ____():
	# Check that 12 inches is converted to 1.0 foot
    ____ ____(____) == 1.0 
    # Check that 2.5 feet is converted to 30.0 inches
    ____ ____(____, reverse=True) == ____


from impyrial.length.core import inches_to_feet, inches_to_yards

# Define tests for inches_to_feet function
def test_inches_to_feet():
	# Check that 12 inches is converted to 1.0 foot
    assert inches_to_feet(12) == 1.0
    # Check that 2.5 feet is converted to 30.0 inches
    assert inches_to_feet(2.5, reverse=True) == 30.0


Scrivere alcuni test di base

from impyrial.length.core import inches_to_feet, inches_to_yards

# Define tests for inches_to_feet function
def test_inches_to_feet():
	# Check that 12 inches is converted to 1 foot
    assert inches_to_feet(12) == 1.0
    # Check that 2.5 feet is converted to 30 inches
    assert inches_to_feet(2.5, reverse=True) == 30.0
    


"""Conversions between inches and larger imperial length units"""
INCHES_PER_FOOT = 120  # 12.0 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 : array_like
        Lengths in feet.
    reverse : bool, optional
        If this is set to true this function converts from feet to inches
        instead of the default behaviour of inches to feet.
    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.
    """
    if reverse:
        return x * INCHES_PER_FOOT
    else:
        return x / INCHES_PER_FOOT


def inches_to_yards(x, reverse=False):
    """Convert lengths between inches and yards.
    Parameters
    ----------
    x : array_like
        Lengths in feet.
    reverse : bool, optional
        If this is set to true this function converts from yards to inches
        instead of the default behaviour of inches to yards.
    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.
    """
    if reverse:
        return x * INCHES_PER_YARD
    else:
        return x / INCHES_PER_YARD


"""Conversions between inches and larger imperial length units"""
INCHES_PER_FOOT = 12.0  # 12.0 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 : array_like
        Lengths in feet.
    reverse : bool, optional
        If this is set to true this function converts from feet to inches
        instead of the default behaviour of inches to feet.
    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.
    """
    if reverse:
        return x * INCHES_PER_FOOT
    else:
        return x / INCHES_PER_FOOT


def inches_to_yards(x, reverse=False):
    """Convert lengths between inches and yards.
    Parameters
    ----------
    x : array_like
        Lengths in feet.
    reverse : bool, optional
        If this is set to true this function converts from yards to inches
        instead of the default behaviour of inches to yards.
    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.
    """
    if reverse:
        return x * INCHES_PER_YARD
    else:
        return x / INCHES_PER_YARD


Esecuzione dei test

Testare il tuo pacchetto in ambienti diversi

[tox]
____

[testenv]
____ = 
	____
____ =
	____


[tox]
envlist = py27, py39

[testenv]
deps = 
	pytest
commands =
	pytest


Configurare tox

[tox]
envlist = py27, py39

[testenv]
deps = 
	pytest
commands =
	pytest
    


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'],
    #python_requires="==____.*",
)


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'],
    python_requires="==3.9.*",
)


Esecuzione di tox

Mantieni il tuo package elegante

Filtrare lo stile in modo appropriato

"""Main module."""

def absolute_value(num):
    """Return the absolute value of the number"""
    if num>=0: return num
    else:
    	return -num


"""Main module."""


def absolute_value(num):
    """Return the absolute value of the number"""
    if num >= 0:
        return num
    else:
        return -num


Usare flake8 per ripulire un file

import numpy as np


def calculate_hypotenuse(side1, side2):
    """Calculate the length of the hypotenuse."""
    l = np.sqrt( side1**2 + side2**2 )  # ____: ____
    return l


import numpy as np


def calculate_hypotenuse(side1, side2):
    """Calculate the length of the hypotenuse."""
    l = np.sqrt( side1**2 + side2**2 )  # noqa: E741
    return l


Ignorare errori specifici

[flake8]

# Ignore F401 violations in the main __init__.py file
# per-file-ignores =
#     ____ : ____
        
# Ignore all violations in the tests directoory
# exclude = ____


from impyrial.length.api import (
    convert_unit,
    unit_to_mixed,
    mixed_to_unit,
)

def test_convert_unit():
    assert convert_unit(30, "ft", "in")==360.0
    assert convert_unit(30, "yd", "ft")==90.0
    assert convert_unit(10, "mi", "yd")==17600.0


[flake8]

# Ignore F401 violations in the main __init__.py file
per-file-ignores =
    impyrial/__init__.py: F401
        
# Ignore all violations in the tests directoory
exclude = tests/*


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.

Esecuzione di tox

Sviluppare pacchetti Python

esercizio interattivo pratico