Kom igång med ditt paket genom att omvandla skript du redan har skrivit. Du skapar ett enkelt paket som du kan använda på din egen dator.

Starta ett paket

Moduler, paket och underpaket

Från skript till paket

Sätt ditt paket i arbete

Dokumentation

Skriv funktionsdokumentation med pyment

Skriva funktionsdokumentation med pyment II

Dokumentation för paket och moduler

Strukturera importer

Syskonimporter

Importera från överordnade moduler

Exponera funktioner för användare

Från lös kod till lokalt paket

Gör ditt paket installerbart för dig själv och andra. I det här kapitlet lär du dig hantera beroenden, skriva README-filer och inkludera licenser. Du går också igenom alla steg för att publicera ditt paket på PyPI – den huvudsakliga platsen för Python-paket.

Installera ditt eget paket

Lägga till installationsskriptet

Installera ditt paket lokalt

Använda redigerbara installationer

Hantera beroenden

Användarberoenden

Utvecklingsberoenden

Licenser och README-filer

Skriva en README

MANIFEST – inkludera extrafiler i ditt paket

Publicera ditt paket

Bygga en distribution

Ladda upp distributioner

Installera ditt paket var som helst

Lyft ditt paket till professionell nivå. Lär dig använda pytest för att skydda mot fel, tox för att testa om ditt paket fungerar med flera Python-versioner och flake8 för att upprätthålla god kodstil.

Testa ditt paket

Skapa testkatalogen

Skriva grundläggande tester

Kör dina tester

Testa ditt paket i olika miljöer

Konfigurera tox

Köra tox

Håll paketet stilrent

Lämplig stilfiltrering

Städa upp en fil med flake8

Ignorera specifika fel

Konfigurera flake8

Förbättra paketets kvalitet

Skapa dina paket snabbare. I det här sista kapitlet lär du dig använda cookiecutter för att generera alla stödfiler ditt paket behöver, Makefiles för att förenkla lansering av nya versioner, och du introduceras till de sista filerna ditt paket behöver för att locka användare och bidragsgivare.

Snabbare paketutveckling med mallar

# 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


Använda paketmallar

Versionsnummer och historik

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.


Historikfil

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


Spåra versionsnummer med bumpversion

Makefiles och klassificerare

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


PyPI-klassificerare

# Run this file to complete the exercise 

# Remove old distributions
make clean

# Run tests
make test

# Make new source and wheel distributions
make dist


Använda makefiles

Avslutning

Snabb paketutveckling

Kopierar du samma kod mellan filer och önskar att det vore enklare att återanvända och dela dina kodsnuttar? Lösningen är att paketera koden som Python-paket! I den här kursen lär du dig om paketstruktur och de extrafiler som behövs för att omvandla lös kod till praktiska paket. Du lär dig också om importstruktur, dokumentation och hur du upprätthåller kodstil med flake8. Sedan effektiviserar du paketutvecklingen genom att bygga mallar och använda cookiecutter för att skapa paketskelett. Slutligen lär du dig hur du använder setuptools och twine för att bygga och publicera dina paket på PyPI – den viktigaste plattformen för Python-paket.

Introduction to Shell

Writing Functions in Python

Lär dig om paketstruktur, importstruktur, dokumentation och kodstil. Bygg mallar och publicera dem.

Att utveckla Python-paket

Lär dig skapa egna Python-paket för att göra din kod enklare att använda och dela med andra.

Använda makefiles

Att utveckla Python-paket

Interaktiv övning med praktiskt arbete