Bắt đầu gói của bạn bằng cách chuyển đổi các script bạn đã viết. Bạn sẽ tạo một gói đơn giản để dùng trên chính máy tính của mình.

Bắt đầu một package

Module, package và subpackage

Từ script đến package

Đưa gói của bạn vào sử dụng

Tài liệu

Viết tài liệu hàm với pyment

Viết tài liệu hàm với pyment II

Tài liệu cho package và module

Tổ chức import

Import giữa các mô-đun ngang hàng

Import từ thư mục cha

Cung cấp hàm cho người dùng

Từ mã rời rạc đến gói cục bộ

Giúp gói của bạn có thể cài đặt cho bạn và người khác. Trong chương này, bạn sẽ học cách xử lý dependencies, viết README và kèm giấy phép. Bạn cũng sẽ hoàn tất tất cả các bước để phát hành gói lên PyPI—ngôi nhà chính của các gói Python.

Cài đặt gói do bạn tự tạo

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


Thêm script setup

import impyrial

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


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


Cài đặt gói của bạn trên máy cục bộ

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


Tận dụng cài đặt dạng editable

Xử lý phụ thuộc

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


Phụ thuộc của người dùng

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


Các phụ thuộc cho phát triển

Thêm giấy phép và viết 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
```


Viết 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 - Bao gồm các tệp bổ sung trong gói của bạn

Xuất bản gói của bạn

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


Xây dựng bản phân phối

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


Tải lên các bản phân phối

Cài đặt gói của bạn từ bất cứ đâu

Đưa gói của bạn lên tiêu chuẩn chuyên nghiệp. Khám phá cách dùng pytest để ngăn lỗi, tox để kiểm tra gói chạy với nhiều phiên bản Python, và flake8 để giữ phong cách mã nhất quán.

Kiểm thử package của bạn

Tạo thư mục test

Viết một vài kiểm thử cơ bản

Chạy bộ kiểm thử của bạn

Kiểm thử gói của bạn trên các môi trường khác nhau

Thiết lập tox

Chạy tox

Giữ cho gói của bạn chuẩn phong cách

Lọc cảnh báo về style một cách phù hợp

Dùng flake8 để dọn dẹp một tệp

Bỏ qua một số lỗi cụ thể

Cấu hình flake8

Nâng cao chất lượng gói

Tạo gói nhanh hơn. Ở chương cuối, bạn sẽ học cách dùng cookiecutter để tạo mọi tệp hỗ trợ mà gói cần, dùng Makefile để đơn giản hóa việc phát hành phiên bản mới, và làm quen với vài tệp cuối cùng giúp gói của bạn thu hút người dùng và cộng tác viên.

Phát triển package nhanh hơn với template

Sử dụng mẫu package

Số phiên bản và lịch sử

CONTRIBUTING.md

Tệp lịch sử

Theo dõi số phiên bản với bumpversion

Makefile và classifiers

Classifier trên PyPI

Sử dụng makefile

Tổng kết

Phát triển gói nhanh chóng

Bạn có thường xuyên sao chép và dán cùng một đoạn mã giữa các tệp, ước gì có cách tái sử dụng và chia sẻ tiện hơn? Đóng gói mã của bạn thành các gói Python sẽ giúp ích rất nhiều! Trong khóa học này, bạn sẽ học về cấu trúc gói và các tệp bổ trợ cần có để biến mã rời rạc thành các gói tiện dùng. Bạn cũng sẽ học về cấu trúc import, viết tài liệu, và cách duy trì phong cách mã với flake8. Sau đó, bạn sẽ tăng tốc phát triển gói bằng cách xây dựng mẫu, dùng cookiecutter để tạo bộ khung gói. Cuối cùng, bạn sẽ học cách dùng setuptools và twine để build và phát hành gói của mình lên PyPI—“sân khấu” toàn cầu cho các gói Python.

Introduction to Shell

Writing Functions in Python

Tìm hiểu cấu trúc gói, nhập, tài liệu, duy trì phong cách mã, tạo mẫu và dùng công cụ để xuất bản.

Phát triển gói Python

Học cách tạo các gói Python của riêng bạn để làm cho mã nguồn của bạn dễ sử dụng và chia sẻ với người khác.

Cài đặt gói của bạn trên máy cục bộ

Phát triển gói Python

Bài tập tương tác thực hành