<img src="../banner.png" width="100%" alt="plugin-system banner">

日本語 — plugin-system の公式日本語版。

プラグインシステム (日本語)

Python CLI アプリケーション向けの障害耐性プラグインシステム。 欠陥のあるプラグインがアプリケーションの残りの部分を停止させることはありません。

主な機能

• 自動検出: ディレクトリ内のプラグインを自動的に検出
• 検証: 各プラグインクラスの name、version、execute() をチェック
• 障害耐性: 欠陥のあるプラグインはログに記録されますが、ロードされません
• 依存関係ゼロ: Python 標準ライブラリのみ使用

ファイル

scripts/
  plugin_system.py       Core: PluginBase (ABC) + PluginManager
  cli_demo.py            Demo CLI with argparse
  test_plugin_system.py  16+ unit tests
examples/
  hello.py               Hello World plugin
  calculator.py          Calculator plugin
  systeminfo.py          System Info plugin

クイックスタート

1. プラグインの作成

from plugin_system import PluginBase

class MyPlugin(PluginBase):
    name = "MyPlugin"
    version = "1.0.0"

    def execute(self, *args, **kwargs):
        return {"status": "ok", "message": "Hello!"}

2. PluginManager の使用

from plugin_system import PluginManager

manager = PluginManager(plugins_dir="./my_plugins")
plugins = manager.discover_plugins()

# List all plugins (Deutsch)
manager.list_plugins()

# Execute a plugin (Deutsch)
success, result = manager.execute_plugin("MyPlugin", param="value")
if success:
    print(result)

3. アプリケーションへの統合

class MyApp:
    def __init__(self):
        self.plugins = PluginManager("./plugins")
        self.plugins.discover_plugins()

    def run_command(self, command, **params):
        success, result = self.plugins.execute_plugin(command, **params)
        return result if success else None

プラグインインターフェース

すべてのプラグインは以下を満たす必要があります:

要件	詳細
PluginBase を継承	from plugin_system import PluginBase
name を設定	クラス属性、空でないこと
version を設定	クラス属性、セマンティックバージョニング
execute() を実装	任意の *args, **kwargs

障害耐性

エラータイプ	動作
プラグイン内の SyntaxError	プラグインはスキップされ、残りがロードされます
属性の欠落	プラグインは is_valid=False としてマークされます
execute() 内の例外	(False, error_message) を返します
ディレクトリにプラグインがない	空のリストを返し、クラッシュしません

変更履歴

1.0.0 (2026-03-12)

• MODULAR_AGENTS/plugins から skill ライブラリへの移行
• PluginBase ABC + PluginManager
• 3 つのサンプルプラグイン (Hello, Calculator, SystemInfo)
• 16 以上のユニットテスト
• argparse を使用した CLI デモ