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

Menambahkan skrip setup

Menginstal paket Anda secara lokal

Memanfaatkan pemasangan editable

Menangani dependensi

Dependensi pengguna

Dependensi pengembangan

Menyertakan lisensi dan menulis README

Menulis README

MANIFEST - Menyertakan berkas tambahan dalam paket Anda

Menerbitkan paket Anda

Membangun distribusi

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

from impyrial.length.core import inches_to_feet, inches_to_yards


Membuat direktori test

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


Menulis beberapa pengujian dasar

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


Menjalankan pengujian Anda

Menguji paket Anda pada berbagai lingkungan

[tox]
____

[testenv]
____ = 
	____
____ =
	____


[tox]
envlist = py27, py39

[testenv]
deps = 
	pytest
commands =
	pytest


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


Menjalankan tox

Menjaga gaya paket Anda

Penyaringan gaya yang tepat

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


Menggunakan flake8 untuk merapikan sebuah berkas

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


Mengabaikan error tertentu

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


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.

Menggunakan flake8 untuk merapikan sebuah berkas

Mengembangkan Paket Python

Latihan interaktif langsung