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

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


Adăugarea scriptului de configurare

import impyrial

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


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


Instalarea pachetului tău local

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


Utilizarea instalărilor în mod editabil

Gestionarea dependențelor

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


Dependențe pentru utilizatori

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


Dependențe de dezvoltare

Includerea licențelor și scrierea fișierelor 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
```


Scrierea unui 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 - Includerea fișierelor suplimentare în pachetul tău

Publicarea pachetului tău

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


Construirea unei distribuții

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


Î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

Crearea directorului de teste

Scrierea unor teste de bază

Rularea testelor

Testarea pachetului în diferite medii

Configurarea tox

Rularea tox

Menține stilul pachetului tău

Filtrarea adecvată a stilului

Utilizarea flake8 pentru a ordona un fișier

Ignorarea anumitor erori

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.

Adăugarea scriptului de configurare

Dezvoltarea pachetelor Python

Exercițiu interactiv practic