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

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

# 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


Uso dei template per i package

Numeri di versione e cronologia

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.


File della cronologia

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


Tenere traccia della versione con bumpversion

Makefile e classifier

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


Classifier 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


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.

CONTRIBUTING.md

Sviluppare pacchetti Python

esercizio interattivo pratico