「Python パッケージガイドライン」の版間の差分

提供: ArchWiki
ナビゲーションに移動 検索に移動
(Pkg/AUR テンプレートの更新)
7行目: 7行目:
 
== パッケージの命名規則 ==
 
== パッケージの命名規則 ==
   
Python 3 ライブラリの場合、{{Ic|python-''modulename''}} を使って下さい。アプリケーションの場合、プログラムを使って下さい。どちらの場合でもパッケージの名前は小文字である必要があります。
+
[[Python#installation|Python 3]] ライブラリモジュールの場合、{{ic|python-''modulename''}} を使用しますパッケージが Python エコシステムに強く結合されたプログラムを提供する場合にも、接頭辞を使用します (例: ''pip'' または ''tox'') 他のアプリケーションの場合、プログラム名のみを使用します。
   
  +
{{Note|パッケージ名はすべて小文字にする必要があります。}}
Python 2 ライブラリの場合は {{Ic|python2-''modulename''}} という風に名前を付けて下さい。
 
 
===バージョン付きパッケージ===
 
 
特定のバージョンのパッケージを追加する必要がある場合は {{Ic|python-''modulename''-''version''}} を使って下さい (例: {{Ic|python-colorama-0.2.5}})。python の依存パッケージが {{Ic|colorama==0.2.5}} ならば Arch のパッケージは {{Ic|python-colorama-0.2.5}} になります。
 
   
 
== ファイルの配置場所 ==
 
== ファイルの配置場所 ==

2023年6月28日 (水) 16:58時点における版

このドキュメントでは Python ソフトウェアの PKGBUILD を書くときの決まり事とガイドラインを提供します。

パッケージの命名規則

Python 3 ライブラリモジュールの場合は、python-modulename を使用します。パッケージが Python エコシステムに強く結合されたプログラムを提供する場合にも、接頭辞を使用します (例: pip または tox) 他のアプリケーションの場合は、プログラム名のみを使用します。

ノート: パッケージ名はすべて小文字にする必要があります。

ファイルの配置場所

ほとんどの Python パッケージは setup.py による distutils システムでインストールされます。ファイルは /usr/lib/python<python version>/site-packages/pkgname ディレクトリにインストールされます。

  • --optimize=1 パラメータは .pyo ファイルをコンパイルして pacman から追跡することができます。

もし pip (wheels などのインストールで必要であり、最近 Python コミュニティから一般に推奨されています) を使う場合は、次のフラグを忘れずに渡してください:

PIP_CONFIG_FILE=/dev/null pip install --isolated --root="$pkgdir" --ignore-installed --no-deps *.whl
  • PIP_CONFIG_FILE=/dev/nullpip にフラグを追加するかもしれない {/etc,~/.config}/pip.conf を無視します。
  • --isolatedpip にフラグを追加するかもしれない環境変数 (それと {/etc,~/.config}/pip/pip.conf) を無視します。
  • --ignore-installedhttps://github.com/pypa/pip/issues/3063 が解決されるまで必要です (フラグを指定しないと先に --user でインストールされていた場合でも pip はインストールをスキップしてしまいます)。
  • --no-deps はメインパッケージと一緒に依存関係がパッケージされないことを保証します。

ノート

基本的に Python パッケージはアーキテクチャに依存しないので arch には any を指定します。

tests という名前のディレクトリをインストールしてはいけません。他の Python パッケージと衝突する可能性があります (例: /usr/lib/python2.7/site-packages/tests/)。

サンプル

サンプル PKGBUILD は こちら を見るか、abs[リンク切れ: パッケージが存在しません] パッケージに入っている /usr/share/pacman/PKGBUILD-python.proto ファイルを見て下さい。