이미 작성해 둔 스크립트를 변환해 패키지를 시작해 보세요. 먼저 내 컴퓨터에서 사용할 수 있는 간단한 패키지를 만듭니다.

패키지 시작하기

모듈, 패키지, 서브패키지

스크립트에서 패키지로

패키지를 제대로 활용해 봅시다

문서화

pyment로 함수 문서 작성하기

pyment로 함수 문서 작성하기 II

패키지 및 모듈 문서화

임포트 구조화하기

형제 모듈 임포트

상위 패키지에서 가져오기

사용자에게 함수 공개하기

흩어진 코드에서 로컬 패키지로

본인과 다른 사람들이 설치할 수 있도록 패키지를 준비하세요. 이 장에서는 의존성 다루기, README 작성, 라이선스 포함 방법을 배우고, Python 패키지의 대표 배포처인 PyPI에 패키지를 게시하는 전 과정을 마칩니다.

내 패키지 설치하기

setup 스크립트 추가하기

패키지를 로컬에 설치하기

editable 설치 활용하기

의존성 다루기

사용자 종속성

개발 종속성

라이선스 포함하기와 README 작성하기

README 작성하기

MANIFEST - 패키지에 추가 파일 포함하기

패키지 게시하기

배포판 만들기

배포판 업로드하기

어디서든 패키지 설치하기

패키지를 전문가 수준으로 끌어올리세요. 오류를 방지하기 위한 pytest 사용법, 여러 Python 버전에서 패키지가 동작하는지 확인하는 tox, 그리고 멋진 코드 스타일을 유지하는 flake8을 알아봅니다.

패키지 테스트하기

테스트 디렉터리 만들기

기본 테스트 작성하기

테스트 실행하기

여러 환경에서 패키지 테스트하기

tox 설정하기

tox 실행하기

패키지 스타일 지키기

적절한 스타일 필터링

flake8로 파일 정리하기

특정 오류 무시하기

flake8 구성하기

패키지 품질 높이기

더 빠르게 패키지를 만들어 보세요. 이 마지막 장에서는 cookiecutter로 패키지에 필요한 지원 파일을 자동 생성하는 방법, Makefile로 새 버전 배포를 단순화하는 방법, 그리고 사용자와 기여자를 끌어들이는 데 필요한 마지막 몇 가지 파일을 소개합니다.

템플릿으로 더 빠르게 패키지 개발하기

# 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


패키지 템플릿 사용하기

버전 번호와 변경 이력

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.


변경 이력 파일

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


bumpversion으로 버전 번호 관리하기

Makefile과 분류자

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


PyPI 분류자(Classifier)

# Run this file to complete the exercise 

# Remove old distributions
make clean

# Run tests
make test

# Make new source and wheel distributions
make dist


Makefile 사용하기

마무리

빠른 패키지 개발

파일 사이에서 같은 코드를 복사해 붙여 넣으며, 더 쉽게 재사용하고 공유할 수 있으면 좋겠다고 생각해 보신 적이 있나요? 코드를 Python 패키지로 감싸면 도움이 됩니다! 이 강의에서는 패키지 구조와, 흩어진 코드를 손쉽게 쓸 수 있는 패키지로 바꾸는 데 필요한 추가 파일들을 배웁니다. 또한 import 구조, 문서화, flake8로 코드 스타일을 유지하는 방법도 익힙니다. 이어서 템플릿을 만들어 개발 속도를 높이고, cookiecutter로 패키지 스켈레톤을 생성하는 방법을 다룹니다. 마지막으로 setuptools와 twine을 사용해 패키지를 빌드하고 PyPI—Python 패키지의 중심 무대—에 게시하는 방법을 배웁니다.

Introduction to Shell

Writing Functions in Python

패키지 구조, 문서화, 코드 스타일 유지 방법을 배우고 템플릿을 만들어 배포하세요.

Python 패키지 개발하기

자신만의 Python 패키지를 만들어 코드를 더 쉽게 사용하고 타인과 공유하는 방법을 학습하세요.

템플릿으로 더 빠르게 패키지 개발하기

Create Your Free Account