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

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

# 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


Menggunakan templat paket

Nomor versi dan riwayat

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.


Berkas riwayat

#!/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


Melacak nomor versi dengan bumpversion

Makefile dan classifier

#!/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,
)


Klasifier 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


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.

CONTRIBUTING.md

Mengembangkan Paket Python

Latihan interaktif langsung