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

Thêm script setup

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

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

Xử lý phụ thuộc

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

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

Thêm giấy phép và viết README

Viết README

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

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

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

# Run this script to create package template
# After running you will still need to type in the terminal to specify the template options
cookiecutter https://github.com/audreyfeldroy/cookiecutter-pypackage.git


Sử dụng mẫu package

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

CONTRIBUTING.md

# History

## ____
### _____
____
### ____
____

## 0.1.0
### Added
- First release on PyPI.


# History

## 0.2.0
### Fixed
- Bug fixed in `length` subpackage for inches-to-feet conversion.
### Deprecated
- Removed Python 2.7 support.

## 0.1.0
### Added
- First release on PyPI.


Tệp lịch sử

#!/usr/bin/env python

"""The setup script."""

from setuptools import setup, find_packages

with open('README.md') as readme_file:
    readme = readme_file.read()

with open('HISTORY.md') as history_file:
	history = history_file.read()

setup(
	author="All credit to you",
    author_email='you@chapter4.com',
    description="A package for converting between imperial unit lengths and weights.",
    name='impyrial',
    packages=find_packages(include=['impyrial', 'impyrial.*']),
    version='0.1.0',
    install_requires=['numpy>=1.10', 'pandas'],
    python_requires="==3.6.*",
    classifiers=[
        'Development Status :: 2 - Pre-Alpha',
        'Intended Audience :: Developers',
        'License :: OSI Approved :: MIT License',
        'Natural Language :: English',
        'Programming Language :: Python :: 2',
        'Programming Language :: Python :: 2.7',
        'Programming Language :: Python :: 3',
        'Programming Language :: Python :: 3.6',
    ],
    license="MIT license",
    long_description=readme + '\n\n' + history,
    keywords='impyrial',    
    zip_safe=False,
)


__doc__ = """
impyrial
========
A package for converting between imperial measurments of length and weight.
"""

__author__ = "All credit to you"
__version__ = '0.1.0'

from . import length  # noqa : F401
from . import weight  # noqa : F401


# Copy and run this command in the terminal to increase the minor package number
bumpversion minor


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

Makefile và classifiers

#!/usr/bin/env python

"""The setup script."""

from setuptools import setup, find_packages

with open('README.md') as readme_file:
    readme = readme_file.read()

with open('HISTORY.md') as history_file:
    history = history_file.read()

setup(
    author="All credit to you",
    author_email='you@chapter4.com',
    description="A package for converting between imperial unit lengths and weights.",
    name='impyrial',
    packages=find_packages(include=['impyrial', 'impyrial.*']),
    version='0.1.0',
    install_requires=['numpy>=1.10', 'pandas'],
    python_requires="==3.6.*",
    classifiers=[
        'Development Status :: 2 - Pre-Alpha',
        'Intended Audience :: Developers',
        'License :: OSI Approved :: MIT License',
        'Natural Language :: English',
        'Programming Language :: Python :: 3',
        'Programming Language :: Python :: 3.6',
        'Programming Language :: Python :: 3.7',
        'Programming Language :: Python :: 3.8',
    ],
    license="MIT license",
    long_description=readme + '\n\n' + history,
    long_description_content_type='text/markdown',
    keywords='impyrial',    
    zip_safe=False,
)


#!/usr/bin/env python

"""The setup script."""

from setuptools import setup, find_packages

with open('README.md') as readme_file:
    readme = readme_file.read()

with open('HISTORY.md') as history_file:
    history = history_file.read()

setup(
    author="All credit to you",
    author_email='you@chapter4.com',
    description="A package for converting between imperial unit lengths and weights.",
    name='impyrial',
    packages=find_packages(include=['impyrial', 'impyrial.*']),
    version='0.1.0',
    install_requires=['numpy>=1.10', 'pandas'],
    python_requires="==3.6.*",
    classifiers=[
        'Development Status :: 2 - Pre-Alpha',
        'Intended Audience :: Developers',
        'License :: OSI Approved :: MIT License',
        'Natural Language :: English',
        'Programming Language :: Python :: 3',
        'Programming Language :: Python :: 3.6',
    ],
    license="MIT license",
    long_description=readme + '\n\n' + history,
    long_description_content_type='text/markdown',
    keywords='impyrial',    
    zip_safe=False,
)


Classifier trên PyPI

# Run this file to complete the exercise 

# Remove old distributions
make clean

# Run tests
make test

# Make new source and wheel distributions
make dist


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.

CONTRIBUTING.md

Phát triển gói Python

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