Python パッケージを作成して公開する方法
Python パッケージを作成して公開すると、コードをより広範な Python コミュニティと共有できます。このガイドでは、Python パッケージを作成し、他のユーザーが簡単にインストールして使用できるように Python パッケージ インデックス (PyPI) に公開する手順について説明します。
プロジェクトの設定
始める前に、システムに Python がインストールされていることを確認してください。まだインストールしていない場合は、setuptools
および wheel
パッケージもインストールする必要があります。
pip install setuptools wheel
パッケージ構造の作成
パッケージ プロジェクト用の新しいディレクトリを作成します。このディレクトリ内に、次の構造を作成します。
your_package/
your_package/
__init__.py
module1.py
module2.py
tests/
__init__.py
test_module1.py
setup.py
README.md
LICENSE
これらのファイルの概要は次のとおりです。
your_package/__init__.py
: ディレクトリを Python パッケージとしてマークします。your_package/module1.py
およびyour_package/module2.py
: パッケージ モジュール。tests/
: パッケージのテストケースのディレクトリ。setup.py
: パッケージのビルド スクリプト。README.md
: パッケージの機能について説明するファイル。LICENSE
: パッケージのライセンス ファイル。
セットアップスクリプトの作成
setup.py
ファイルは、パッケージのメタデータと依存関係を定義するために不可欠です。以下に基本的な例を示します。
from setuptools import setup, find_packages
setup(
name='your_package',
version='0.1.0',
packages=find_packages(),
install_requires=[
# List your package dependencies here
],
description='A brief description of your package',
long_description=open('README.md').read(),
long_description_content_type='text/markdown',
url='https://github.com/yourusername/your_package',
author='Your Name',
author_email='your.email@example.com',
license='MIT',
)
README ファイルの作成
README.md
ファイルには、インストール方法や使用方法など、パッケージの概要が記載されている必要があります。次に例を示します。
# Your Package
A brief description of your package.
インストール
pip install your_package
使用法
import your_package
# Example usage
パッケージの構築
プロジェクト ディレクトリに移動し、次のコマンドを実行してパッケージをビルドします。
python setup.py sdist bdist_wheel
このコマンドは、dist/
ディレクトリに配布アーカイブを作成します。
PyPIへの公開
パッケージを公開するには、PyPI のアカウントが必要です。アカウントをお持ちでない場合は、PyPI で作成してください。
次に、twine
パッケージをインストールします。
pip install twine
twine
を使用してパッケージを PyPI にアップロードします。
twine upload dist/*
PyPI のユーザー名とパスワードの入力を求められます。アップロードが成功すると、パッケージが PyPI で利用できるようになります。
結論
おめでとうございます! これで Python パッケージを作成して公開できました。他の人は pip
を使用してインストールでき、あなたは引き続き更新して改善することができます。変更を加えたらバージョン番号を更新し、新しいリリースをアップロードしてパッケージを維持することを忘れないでください。