Mulailah paket Anda dengan mengonversi skrip yang sudah Anda tulis. Anda akan membuat paket sederhana yang dapat digunakan di komputer Anda sendiri.

Memulai sebuah paket

Modul, paket, dan subpaket

Dari skrip ke paket

Memanfaatkan paket Anda

Dokumentasi

Menulis dokumentasi fungsi dengan pyment

Menulis dokumentasi fungsi dengan pyment II

Dokumentasi paket dan modul

Menata impor

Impor saudara

Mengimpor dari induk

Mengekspos fungsi kepada pengguna

Dari Kode Lepas ke Paket Lokal

Jadikan paket Anda dapat diinstal untuk Anda sendiri dan orang lain. Di bab ini, Anda akan belajar menangani dependensi, menulis README, dan menyertakan lisensi. Anda juga akan menyelesaikan semua langkah untuk menerbitkan paket Anda di PyPI—rumah utama paket Python.

Menginstal paket Anda sendiri

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


Menambahkan skrip setup

import impyrial

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


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


Menginstal paket Anda secara lokal

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


Memanfaatkan pemasangan editable

Menangani dependensi

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


Dependensi pengguna

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


Dependensi pengembangan

Menyertakan lisensi dan menulis 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
```


Menulis 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 - Menyertakan berkas tambahan dalam paket Anda

Menerbitkan paket Anda

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


Membangun distribusi

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


Mengunggah distribusi

Instal Paket Anda dari Mana Saja

Tingkatkan paket Anda ke standar profesional. Pelajari cara menggunakan pytest untuk mencegah kesalahan, tox untuk menguji apakah paket Anda berfungsi dengan beberapa versi Python, dan flake8 untuk menjaga gaya kode yang baik.

Menguji paket Anda

Membuat direktori test

Menulis beberapa pengujian dasar

Menjalankan pengujian Anda

Menguji paket Anda pada berbagai lingkungan

Menyiapkan tox

Menjalankan tox

Menjaga gaya paket Anda

Penyaringan gaya yang tepat

Menggunakan flake8 untuk merapikan sebuah berkas

Mengabaikan error tertentu

Mengonfigurasi flake8

Meningkatkan Kualitas Paket Anda

Buat paket Anda lebih cepat. Di bab terakhir ini, Anda akan belajar menggunakan cookiecutter untuk menghasilkan semua berkas pendukung yang dibutuhkan paket Anda, Makefile untuk menyederhanakan rilis versi baru, dan diperkenalkan pada beberapa berkas terakhir yang dibutuhkan paket Anda untuk menarik pengguna serta kontributor.

Pengembangan paket yang lebih cepat dengan templat

Menggunakan templat paket

Nomor versi dan riwayat

CONTRIBUTING.md

Berkas riwayat

Melacak nomor versi dengan bumpversion

Makefile dan classifier

Klasifier PyPI

Menggunakan makefile

Rangkuman

Pengembangan Paket yang Cepat

Apakah Anda sering menyalin dan menempelkan kode yang sama antar berkas, dan berharap lebih mudah untuk digunakan kembali serta dibagikan? Membungkus kode Anda ke dalam paket Python dapat membantu! Di kursus ini, Anda akan mempelajari struktur paket dan berkas tambahan yang diperlukan untuk mengubah kode lepas menjadi paket yang mudah digunakan. Anda juga akan mempelajari struktur import, dokumentasi, dan cara menjaga gaya kode menggunakan flake8. Selanjutnya, Anda akan mempercepat pengembangan paket dengan membangun templat, menggunakan cookiecutter untuk membuat kerangka paket. Terakhir, Anda akan belajar cara menggunakan setuptools dan twine untuk membangun dan menerbitkan paket Anda ke PyPI—panggung dunia bagi paket Python.

Introduction to Shell

Writing Functions in Python

Pelajari struktur paket, impor, dokumentasi, gaya kode, buat template, dan gunakan alat setup.

Mengembangkan Paket Python

Pelajari cara membuat paket Python sendiri agar kode Anda lebih mudah digunakan dan dibagikan dengan orang lain.

Menambahkan skrip setup

Mengembangkan Paket Python

Latihan interaktif langsung