Pornește-ți pachetul transformând scripturi pe care le-ai scris deja. Vei crea un pachet simplu pe care îl poți folosi pe propriul calculator.

Crearea unui pachet

Module, pachete și subpachete

De la script la pachet

Pune-ți pachetul la treabă

Documentație

Scrierea documentației funcțiilor cu pyment

Scrierea documentației funcțiilor cu pyment II

Documentația pachetului și a modulului

Structurarea importurilor

Importuri între module surori

Importuri din module părinte

Expunerea funcțiilor către utilizatori

De la cod izolat la pachet local

Fă-ți pachetul instalabil pentru tine și pentru alții. În acest capitol, vei învăța să gestionezi dependențele, să scrii fișiere README și să incluzi licențe. Vei parcurge, de asemenea, toți pașii necesari pentru a publica pachetul pe PyPI – principala platformă pentru pachete Python.

Instalarea propriului tău pachet

Adăugarea scriptului de configurare

Instalarea pachetului tău local

Utilizarea instalărilor în mod editabil

Gestionarea dependențelor

Dependențe pentru utilizatori

Dependențe de dezvoltare

Includerea licențelor și scrierea fișierelor README

Scrierea unui README

MANIFEST - Includerea fișierelor suplimentare în pachetul tău

Publicarea pachetului tău

Construirea unei distribuții

Încărcarea distribuțiilor

Instalează-ți pachetul de oriunde

Ridică pachetul la un standard profesional. Descoperă cum să folosești pytest pentru a preveni erorile, tox pentru a testa compatibilitatea pachetului cu mai multe versiuni de Python și flake8 pentru a menține un stil de cod impecabil.

Testarea pachetului tău

from impyrial.length.core import inches_to_feet, inches_to_yards


Crearea directorului de teste

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


Scrierea unor teste de bază

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


Rularea testelor

Testarea pachetului în diferite medii

[tox]
____

[testenv]
____ = 
	____
____ =
	____


[tox]
envlist = py27, py39

[testenv]
deps = 
	pytest
commands =
	pytest


Configurarea 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.*",
)


Rularea tox

Menține stilul pachetului tău

Filtrarea adecvată a stilului

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


Utilizarea flake8 pentru a ordona un fișier

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


Ignorarea anumitor erori

[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/*


Configurarea flake8

Îmbunătățirea calității pachetului

Creează pachete mai rapid. În acest capitol final, vei învăța să folosești cookiecutter pentru a genera toate fișierele suport de care are nevoie pachetul tău, Makefiles pentru a simplifica lansarea versiunilor noi, și vei face cunoștință cu ultimele fișiere necesare pentru a atrage utilizatori și colaboratori.

Dezvoltare mai rapidă a pachetelor cu șabloane

Utilizarea șabloanelor de pachete

Numere de versiune și istoric

CONTRIBUTING.md

Fișierul de istoric

Urmărirea numărului de versiune cu bumpversion

Makefile-uri și clasificatori

Clasificatori PyPI

Utilizarea fișierelor Makefile

Recapitulare

Dezvoltare rapidă de pachete

Ți s-a întâmplat să copiezi și să lipești același cod între fișiere, dorind să fie mai ușor de reutilizat și de distribuit? Împachetarea codului în pachete Python te poate ajuta! În acest curs, vei învăța despre structura pachetelor și fișierele suplimentare necesare pentru a transforma cod izolat în pachete practice. Vei descoperi, de asemenea, cum să organizezi importurile, să scrii documentație și să menții stilul codului cu flake8. Apoi, vei accelera dezvoltarea pachetelor construind șabloane și folosind cookiecutter pentru a genera scheletele pachetelor. În final, vei învăța să folosești setuptools și twine pentru a compila și publica pachetele pe PyPI – platforma globală pentru pachete Python.

Introduction to Shell

Writing Functions in Python

Învață despre structura pachetelor, importuri, documentație, stilul codului și publicarea cu setup tools.

Dezvoltarea pachetelor Python

Învață să creezi propriile pachete Python pentru a-ți face codul mai ușor de folosit și de partajat cu alții.

Configurarea tox

Dezvoltarea pachetelor Python

Exercițiu interactiv practic