5.7. Anaconda アドオン構造

Anaconda アドオンとは、init.py ファイルとその他のソースディレクトリー (サブパッケージ) を含むディレクトリーを持つ Python パッケージのことです。Python を使用すれば、各パッケージ名を一度だけインポートし、パッケージの最上位ディレクトリーに一意の名前を指定できます。

アドオンは名前に関係なく読み込まれるため、任意の名前を使用できます。唯一の条件は、それらを特定のディレクトリーに配置することです。

そのため、推奨のアドオン命名規則は Java パッケージまたは D-Bus サービス名に似ています。

ディレクトリー名を Python パッケージの一意の識別子にするには、ドットの代わりにアンダースコア (_) を使用して、アドオン名の前に組織の逆引きドメイン名を付けます。例: com_example_hello_world

アドオンを作成する場合は、以下を確認してください。

以下は、全インターフェイス (Kickstart、GUI、および TUI) をサポートするアドオンのディレクトリー構造の例です。

com_example_hello_world
├─ gui
│  ├─ init.py
│  └─ spokes
│     └─ init.py
└─ tui
   ├─ init.py
   └─ spokes
   └─ init.py

各パッケージには、API で定義される 1 つ以上のクラスから継承されるクラスを定義する任意の名前を持つモジュールが少なくとも 1 つ含まれる必要があります。

アドオンが新しいカテゴリーを定義する必要がある場合は、カテゴリーサブパッケージを追加できますが、これは推奨していません。