{"library":"pluginlib","title":"Pluginlib","description":"Pluginlib is a framework for creating, managing, and importing plugins within Python applications. It provides utilities for dynamically discovering and loading classes that inherit from a specified base plugin class, often found via filesystem paths or entry points. The current version is 0.10.0, with releases occurring periodically to add features, improve compatibility, and address issues.","language":"python","status":"active","last_verified":"Sat May 16","install":{"commands":["pip install pluginlib"],"cli":null},"imports":["from pluginlib import Plugin","from pluginlib import PluginLoader"],"auth":{"required":false,"env_vars":[]},"quickstart":{"code":"import os\nimport tempfile\nimport shutil\nfrom pluginlib import Plugin, PluginLoader\n\n# --- Setup: Create a temporary directory and a dummy plugin file ---\n# This simulates having a 'plugins' directory with 'my_plugin.py'\ntemp_dir = tempfile.TemporaryDirectory()\nplugin_root_dir = temp_dir.name\nplugin_dir_path = os.path.join(plugin_root_dir, \"plugins\")\nos.makedirs(plugin_dir_path, exist_ok=True)\n\nplugin_file_path = os.path.join(plugin_dir_path, \"my_plugin.py\")\nwith open(plugin_file_path, \"w\") as f:\n    f.write(\"\"\"\nfrom pluginlib import Plugin\n\nclass MyPlugin(Plugin):\n    version = \"1.0.0\"\n    def execute(self) -> str:\n        return \"Hello from MyPlugin!\"\n\"\"\")\n# --- End Setup ---\n\ntry:\n    # Initialize the PluginLoader to search in our temporary 'plugins' directory\n    # We specify the exact plugin module name and its base class\n    with PluginLoader(\n        [plugin_root_dir], # Search path includes the root of our plugins dir\n        plugin_name=\"my_plugin\", # The name of the module (my_plugin.py)\n        plugin_class=\"Plugin\" # The base class for our plugins\n    ) as loader:\n        # Access the loaded plugins. 'plugins' is a nested dictionary:\n        # {module_name: {plugin_class_name: instance}}\n        loaded_plugins = loader.plugins\n        \n        if \"my_plugin\" in loaded_plugins and \"MyPlugin\" in loaded_plugins[\"my_plugin\"]:\n            my_plugin_instance = loaded_plugins[\"my_plugin\"][\"MyPlugin\"]\n            result = my_plugin_instance.execute()\n            print(f\"Successfully loaded and executed plugin: {result}\")\n            print(f\"Plugin version: {my_plugin_instance.version}\")\n        else:\n            print(\"Error: MyPlugin could not be found or loaded.\")\n\nfinally:\n    # --- Teardown: Clean up the temporary directory ---\n    temp_dir.cleanup()\n    # --- End Teardown ---","lang":"python","description":"This quickstart demonstrates how to define a simple plugin and use Pluginlib's `PluginLoader` to discover and instantiate it. It creates a temporary file structure to make the example self-contained and runnable, then cleans it up. The loader searches a specified path for modules, identifies classes inheriting from `pluginlib.Plugin`, and allows you to interact with their instances.","tag":null,"tag_description":null,"last_tested":null,"results":[]},"compatibility":{"tag":null,"tag_description":null,"last_tested":"2026-05-16","installed_version":"0.11.0","pypi_latest":"0.11.0","is_stale":false,"summary":{"python_range":"3.10–3.9","success_rate":100,"avg_install_s":1.7,"avg_import_s":0.13,"wheel_type":"wheel"},"results":[{"runtime":"python:3.10-alpine","python_version":"3.10","os_libc":"alpine (musl)","variant":"pluginlib","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":"clean","install_time_s":null,"import_time_s":0.14,"mem_mb":4.8,"disk_size":"18.7M"},{"runtime":"python:3.10-slim","python_version":"3.10","os_libc":"slim (glibc)","variant":"pluginlib","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":"clean","install_time_s":1.6,"import_time_s":0.09,"mem_mb":4.8,"disk_size":"19M"},{"runtime":"python:3.11-alpine","python_version":"3.11","os_libc":"alpine (musl)","variant":"pluginlib","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":"clean","install_time_s":null,"import_time_s":0.18,"mem_mb":5.6,"disk_size":"20.7M"},{"runtime":"python:3.11-slim","python_version":"3.11","os_libc":"slim (glibc)","variant":"pluginlib","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":"clean","install_time_s":1.6,"import_time_s":0.17,"mem_mb":5.6,"disk_size":"21M"},{"runtime":"python:3.12-alpine","python_version":"3.12","os_libc":"alpine (musl)","variant":"pluginlib","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":"clean","install_time_s":null,"import_time_s":0.16,"mem_mb":5.3,"disk_size":"12.5M"},{"runtime":"python:3.12-slim","python_version":"3.12","os_libc":"slim (glibc)","variant":"pluginlib","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":"clean","install_time_s":1.5,"import_time_s":0.16,"mem_mb":5.3,"disk_size":"13M"},{"runtime":"python:3.13-alpine","python_version":"3.13","os_libc":"alpine (musl)","variant":"pluginlib","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":"clean","install_time_s":null,"import_time_s":0.11,"mem_mb":4.4,"disk_size":"12.3M"},{"runtime":"python:3.13-slim","python_version":"3.13","os_libc":"slim (glibc)","variant":"pluginlib","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":"clean","install_time_s":1.6,"import_time_s":0.12,"mem_mb":4.4,"disk_size":"13M"},{"runtime":"python:3.9-alpine","python_version":"3.9","os_libc":"alpine (musl)","variant":"pluginlib","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":"clean","install_time_s":null,"import_time_s":0.07,"mem_mb":3.3,"disk_size":"18.5M"},{"runtime":"python:3.9-slim","python_version":"3.9","os_libc":"slim (glibc)","variant":"pluginlib","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":"clean","install_time_s":2,"import_time_s":0.07,"mem_mb":3.3,"disk_size":"19M"}]}}