注: 以下の翻訳の正確性は検証されていません。AIPを利用して英語版の原文から機械的に翻訳されたものです。
Python ライブラリを共有する
複数の Python トランスフォームリポジトリ間でコードを共有するために推奨されるワークフローは、Python ライブラリパッケージ、具体的には Conda ↗ ライブラリを公開することです。Python ライブラリの公開は、バージョン 1.23.1 以降の Python トランスフォームリポジトリでサポートされています。
Python ライブラリを公開する
Python ライブラリを公開するには、次の手順が必要です。
-
共有ライブラリの Python コードを格納する新しいリポジトリを作成します。
-
リポジトリ名を指定します。初期化時に、リポジトリ名がライブラリ名になります。ほかのコードリポジトリは、この名前を使用してライブラリを見つけ、利用します。後から名前を変更するには、
gradle.propertiesファイルにアクセスしてcondaPackageNameパラメーターを編集します（このファイルは非表示のため、先にファイルエディターで「非表示ファイルを表示」を選択する必要がある場合があります）。condaPackageNameに使用できるのは ASCII の小文字、数字、ハイフンのみです。英数字でもハイフンでもない文字の連続は、1個のハイフンに置き換えられます。たとえば、my_library repoはmy-library-repoとして公開され、Foobar _baz$$$はfoobar-baz-として公開されます。 -
Python ライブラリテンプレートのセクションで、作成するボタンを選択します。
-
パッケージを作成します： ライブラリ内で
__init__.pyファイルを含むフォルダーは、パッケージとして公開されます。リポジトリの初期化時には、このようなフォルダーが作成されます。必要に応じて名前を変更し、パッケージを追加します。 -
モジュールを作成します： パッケージのフォルダー内に、コードを含む Python ファイルを追加できます。これらのモジュールは、後でほかのリポジトリからインポートされます。
- リポジトリにタグを付けます： リリースの準備ができたら、「ブランチ」タブに移動し、「タグ」を選択して新しいタグを作成します。デフォルトでは、タグが付いたコミットに対してのみ Python ライブラリが公開されます。このデフォルトの動作を変更するには、
build.gradleファイルを変更する必要があります。
タグ名は、SLS Versions のドキュメント ↗で指定されている SLS バージョニングに準拠する必要があります。
-
チェックが正常に完了すると、ライブラリのバージョンが公開されます。チェックのステータスは、リポジトリのタグ一覧とチェックタブで確認できます。デフォルトでは、タグを作成したときにのみライブラリへの変更が公開されます。タグは、いずれかのブランチの現在の状態、または特定のコミットに対して作成できます。チェックに合格すると、ユーザーは最新バージョンにアップグレードできるようになりますが、新しいバージョンが公開されても、ライブラリを利用するリポジトリは自動的にはアップグレードされません。リポジトリを手動でアップグレードして最新バージョンを使用するには、Python ライブラリを見つけて使用する方法と、Conda 環境を再解決するための Conda ロックファイルに関するドキュメントを確認してください。
-
ライブラリを利用するユーザーに権限を付与してください。デフォルトでは、共有リポジトリに対して「閲覧者」ロールを付与する必要があります。トランスフォームリポジトリの設定にあるアーティファクトタブで、ライブラリリポジトリへの参照を追加します。
この時点で、ライブラリはほかのアプリやリポジトリから利用可能になっているはずです。詳細は、Python パッケージを見つけて使用する方法を参照してください。
Python ライブラリの利用先を見つける
公開済みのライブラリを利用しているリポジトリを確認するには、アーティファクトリポジトリのインターフェースに移動し、検索タブを使用してライブラリを見つけます。目的のバージョンを見つけ、ダウンロード列を展開して </> 利用先セクションを表示します。