注: 以下の翻訳の正確性は検証されていません。AIPを利用して英語版の原文から機械的に翻訳されたものです。
Python ライブラリの共有
複数の Transforms Python リポジトリ間でコードを共有するための推奨ワークフローは、Python ライブラリパッケージ、特に Conda ↗ ライブラリを公開することです。Python ライブラリの公開は Transforms Python 1.23.1+ でサポートされています。
Python ライブラリの公開
Python ライブラリを公開するための必要な手順は以下のとおりです：
-
新しいリポジトリを作成します。 これは、共有ライブラリの Python コードを含むリポジトリになります。
-
リポジトリに名前を付けます。 ライブラリは初期化時にリポジトリ名から命名されます。他のコードリポジトリはこの名前を使用してライブラリを検出し、使用します。後で名前を変更するには、
gradle.propertiesファイルにアクセスしてcondaPackageNameパラメーターを編集する必要があります（このファイルは非表示になっているため、まずファイルエディタで "Show hidden files" を選択する必要があるかもしれません）。
condaPackageName は ASCII の小文字、数字、またはハイフンのみを含むことができます。非英数字/非ハイフン文字の任意の連続は単一のハイフンに置き換えられます（例：my_library repo は my-library-repo として公開され、Foobar _baz$$$ は foobar-baz- として公開されます）。
-
Python ライブラリ テンプレートセクションの Create ボタンをクリックします。
-
パッケージを作成します： ライブラリ内の
__init__.pyファイルを含む任意のフォルダーはパッケージとして公開されます。リポジトリはそのようなフォルダーを持つ状態で初期化されます - 必要に応じて名前を変更し、追加のパッケージを追加します。 -
モジュールを作成します： パッケージフォルダー内に、コードを含む Python ファイルを追加できます。これらのモジュールは後で他のリポジトリからインポートされます。
- リポジトリにタグを付けます： リリースする準備ができたら、"Branches" タブに移動し、"Tags" を選択して新しいタグを作成します。デフォルトでは、タグが付けられたコミットのみが Python ライブラリとして公開されます。このデフォルトの振る舞いを変更するには、
build.gradleファイルを修正する必要があります。
タグ名は SLS バージョン管理に準拠する必要があります。これは SLS Versions documentation ↗ で指定されています。
- チェックが成功したらライブラリのバージョンが公開されます。チェックのステータスは Tags リストとリポジトリの Checks タブで確認できます。
デフォルトでは、ライブラリへの変更はタグを作成したときにのみ公開されます。ブランチの現在の状態、または特定のコミットに対してタグを作成することができます。チェックがパスするとライブラリが公開され、ユーザーは最新バージョンにアップグレードできるようになります。
新バージョンが公開されたときに、消費リポジトリが自動的に最新バージョンを使用するようにアップグレードすることはありません。 リポジトリを最新バージョンを使用するように手動でアップグレードするには、Python ライブラリの探索と使用 および Conda ロックファイル のドキュメンテーションを参照してください。
- ライブラリの使用者に対して適切な権限を与えてください。デフォルトでは、ユーザーは共有リポジトリに "Viewer" ロールを持つべきです。変換リポジトリの設定の Artifacts タブの下にライブラリリポジトリへの参照を追加します。
この時点で、ライブラリは他のアプリやリポジトリが使用できる状態になるはずです。Python パッケージの探索と使用 について詳しく読むことができます。