pluginify 1.0.0.post16.dev0__tar.gz → 1.0.0.post41.dev0__tar.gz

pluginify-1.0.0.post41.dev0/.github/ci-dependencies.yaml

@@ -0,0 +1,6 @@
+# Test-only dependency overrides, keyed by branch: only the entry of the branch under
+# test applies (see "Testing against other branches or versions" in the geoips_ci README).
+remove-enforcement-of-family-for-datatree-plugins:
+  packages:
+    # The sibling PR for these changes
+    geoips: geoips @ git+https://github.com/NRLMMD-GEOIPS/geoips@remove-enforcement-of-family-for-datatree-plugins

pluginify-1.0.0.post41.dev0/.github/workflows/integ-test.yaml

@@ -0,0 +1,54 @@
+name: Integration Tests
+
+on:
+  pull_request:
+    types: [opened, synchronize, reopened, ready_for_review]
+  workflow_dispatch:
+    inputs:
+      dependency_overrides:
+        description: >
+          Test-only dependency overrides as YAML: one entry of
+          .github/ci-dependencies.yaml (python and/or repos, not keyed by branch),
+          used instead of that file (see geoips_ci README)
+        required: false
+        type: string
+        default: ""
+
+defaults:
+  run:
+    shell: bash
+
+concurrency:
+  group: integ-test-${{ github.ref }}
+  cancel-in-progress: true
+
+permissions:
+  contents: read
+  packages: write
+
+jobs:
+  integ-test-editable:
+    if: >-
+      github.event_name == 'workflow_dispatch'
+      || github.event.pull_request.draft == false
+    name: integ-test (editable=true)
+    uses: NRLMMD-GEOIPS/geoips_ci/.github/workflows/reusable-ci.yaml@main
+    with:
+      pip_editable: true
+      dependency_overrides: ${{ inputs.dependency_overrides || '' }}
+    secrets:
+      token: ${{ secrets.GITHUB_TOKEN }}
+      docker_token: ${{ secrets.DOCKER_TOKEN }}
+      # Read-only token for the private plugin repos (see geoips_ci README,
+      # "Private plugin repositories"). Without it the image has public plugins only.
+      private_repos_token: ${{ secrets.GEOIPS_PRIVATE_REPOS_TOKEN }}
+
+#  integ-test-non-editable:
+#    needs: integ-test-editable
+#    name: integ-test (editable=false)
+#    uses: NRLMMD-GEOIPS/geoips_ci/.github/workflows/reusable-ci.yaml@main
+#    with:
+#      pip_editable: false
+#    secrets:
+#      token: ${{ secrets.GITHUB_TOKEN }}
+#      docker_token: ${{ secrets.DOCKER_TOKEN }}

{pluginify-1.0.0.post16.dev0 → pluginify-1.0.0.post41.dev0}/.github/workflows/tag-and-release.yaml

@@ -20,7 +20,7 @@ jobs:
     # You do not appear to be able to use variables in the "uses" field.
     uses: NRLMMD-GEOIPS/geoips_ci/.github/workflows/reusable-tag-and-release.yaml@main
     # Only run this if the pull request was merged, not just closed.
-    if: github.event.pull_request.merged == true
+    if: github.event.pull_request.merged == true || github.event_name == 'workflow_dispatch'
     permissions:
       contents: write
     secrets:

{pluginify-1.0.0.post16.dev0 → pluginify-1.0.0.post41.dev0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: pluginify
-Version: 1.0.0.post16.dev0
+Version: 1.0.0.post41.dev0
 Summary: Pluginify package
 License: LICENSE
 License-File: LICENSE
@@ -14,12 +14,14 @@ Classifier: Programming Language :: Python :: 3.13
 Classifier: Programming Language :: Python :: 3.14
 Classifier: Programming Language :: Python :: 3.15
 Provides-Extra: doc
+Requires-Dist: brassy (>=0.4.1) ; extra == "doc"
 Requires-Dist: docstring_parser
 Requires-Dist: jsonschema (>4.18.0)
 Requires-Dist: lexeme-type
 Requires-Dist: platformdirs
 Requires-Dist: pydantic (>=2.10.0)
 Requires-Dist: pyyaml
+Requires-Dist: rich ; extra == "doc"
 Requires-Dist: sphinxcontrib-typer ; extra == "doc"
 Requires-Dist: typer
 Project-URL: Repository, https://github.com/NRLMMD-GEOIPS/pluginify

pluginify-1.0.0.post41.dev0/docs/source/releases/latest/docs-overhaul.yaml

@@ -0,0 +1,61 @@
+documentation:
+- title: 'Overhaul documentation and expand docstrings across the codebase'
+  description: |
+    Comprehensive documentation improvements:
+
+    * added pluginify-native CLI examples alongside GeoIPS ones
+    * fixed GeoIPS-specific language in functionality docs
+    * removed leftover HTML TODO comment from architecture docs
+    * replaced empty CHANGELOG with reference to docs/source/releases/
+    * cleaned template placeholder text from initial-commit release note
+    * added configuration system reference page (env vars, config.yaml, commands)
+    * added Pydantic model dispatch system reference page
+    * added class-based plugin API reference page
+    * updated concepts toctree with new pages
+    * reformatted all source docstrings to numpy style convention
+    * added mypy-style type hints across all public functions and methods
+    * improved module-level docstrings with package purpose descriptions
+    * normalized code blocks to backtick fences so MyST parses every block
+    * fixed the broken ``call-dispatch`` reference and removed duplicate section
+      links in favour of stable heading anchors (issue #12)
+    * fixed the duplicate ``modified`` key and unescaped glob in the utils
+      ignore-file release note that broke the brassy and Sphinx builds
+  files:
+    added:
+      - "docs/source/concepts/configuration/index.md"
+      - "docs/source/concepts/architecture/pydantic-models.md"
+      - "docs/source/concepts/architecture/class-based-plugins.md"
+      - "docs/source/releases/latest/docs-overhaul.yaml"
+    deleted:
+      - ""
+    modified:
+      - "docs/source/concepts/index.md"
+      - "docs/source/concepts/architecture/index.md"
+      - "docs/source/concepts/command_line/index.md"
+      - "docs/source/concepts/functionality/index.md"
+      - "docs/source/releases/latest/ignore-files-in-utils-directories.yaml"
+      - "pluginify/__init__.py"
+      - "pluginify/commandline_typer.py"
+      - "pluginify/config.py"
+      - "pluginify/create_plugin_registries.py"
+      - "pluginify/errors.py"
+      - "pluginify/interfaces/__init__.py"
+      - "pluginify/interfaces/base.py"
+      - "pluginify/interfaces/class_based/data_modifiers.py"
+      - "pluginify/interfaces/class_based_plugin.py"
+      - "pluginify/interfaces/yaml_based/configs.py"
+      - "pluginify/plugin_registry.py"
+      - "pluginify/plugins/classes/data_modifiers/cuboid.py"
+      - "pluginify/pydantic_models/v1/configs.py"
+      - "pluginify/utils/__init__.py"
+      - "pluginify/utils/context_managers.py"
+      - "pluginify/utils/validators.py"
+      - "pyproject.toml"
+    moved:
+      - ""
+  related-issue:
+    number: null
+    repo_url: ''
+  date:
+    start: null
+    finish: null

{pluginify-1.0.0.post16.dev0 → pluginify-1.0.0.post41.dev0}/docs/source/releases/latest/ignore-files-in-utils-directories.yaml

@@ -1,6 +1,6 @@
 bug fix:
-- title: 'Force ignore files in directories named */utils/'
-  description: 'Force ignore files in directories named */utils/'
+- title: 'Force ignore files in directories named ``*/utils/``'
+  description: 'Force ignore files in directories named ``*/utils/``'
   files:
     deleted:
     - ''

pluginify-1.0.0.post41.dev0/docs/source/releases/latest/remove-enforcement-of-family-for-datatree-plugins.yaml

@@ -0,0 +1,16 @@
+enhancement:
+- title: 'removed family enforcement of family attribute for data-tree class-based plugins'
+  description: |
+    Removed enforcement checks for the family attribute for data-tree class-based
+    plugins for GeoIPS V2.0. Corresponding PR in GeoIPS can be found at
+    https://github.com/NRLMMD-GEOIPS/geoips/pull/1526.
+  files:
+    modified:
+      - pluginify/create_plugin_registries.py
+      - pluginify/interfaces/base.py
+  related-issue:
+    number: null
+    repo_url: ''
+  date:
+    start: null
+    finish: null

pluginify-1.0.0.post41.dev0/pluginify/__init__.py

@@ -0,0 +1,24 @@
+# # # This source code is subject to the license referenced at
+# # # https://github.com/NRLMMD-GEOIPS.
+
+"""Pluginify: plugin registry management for YAML and Python class plugins.
+
+This package provides the ``PluginRegistry`` class and supporting infrastructure
+for registering, retrieving, and creating plugin objects from YAML configuration
+files and Python class definitions. It exposes:
+
+- ``pluginify.interfaces`` — base classes for building custom plugin interfaces.
+- ``pluginify.utils`` — utility functions (dict merging, validators).
+
+Pluginify does not ship production plugins; it is a framework for packages that
+build plugin-based infrastructure (e.g. GeoIPS).
+
+Version information is auto-generated from git tags during build/install.
+"""
+
+# NOTE: _version.py is generated automatically during build/install
+from pluginify._version import __version__, __version_tuple__
+from pluginify import interfaces
+from pluginify import utils
+
+__all__ = ["interfaces", "utils", "__version__", "__version_tuple__"]

{pluginify-1.0.0.post16.dev0 → pluginify-1.0.0.post41.dev0}/pluginify/_version.py

@@ -3,5 +3,5 @@
 
 # DO NOT EDIT
 # managed by poetry-dynamic-versioning
-__version__ = "1.0.0.post16.dev0"
-__version_tuple__ = (1, 0, 0, "post16", "dev0")
+__version__ = "1.0.0.post41.dev0"
+__version_tuple__ = (1, 0, 0, "post41", "dev0")

{pluginify-1.0.0.post16.dev0 → pluginify-1.0.0.post41.dev0}/pluginify/commandline_typer.py

@@ -23,7 +23,7 @@ import os
 from pathlib import Path
 from platformdirs import user_config_dir
 import sys
-from typing import List, Literal, Optional
+from typing import Any, Callable, Literal
 
 import docstring_parser
 import typer
@@ -33,7 +33,7 @@ from pluginify.config import NAMESPACE
 from pluginify.plugin_registry import PluginRegistry
 
 
-def configure_logging(level=logging.INFO):
+def configure_logging(level: int = logging.INFO) -> None:
     """Configure root logging for the command-line interface.
 
     This function attaches a StreamHandler to the root logger so that all log
@@ -71,12 +71,12 @@ def configure_logging(level=logging.INFO):
     root.addHandler(handler)
 
 
-def update_existing_fields(new_data):
+def update_existing_fields(new_data: dict) -> None:
     """Overwrite fields in pluginify's config file if they exist in 'new_data'.
 
     Parameters
     ----------
-    new_data: dict
+    new_data : dict
         A dictionary containing configuration key, value pairs to overwrite data in
         config_path.
     """
@@ -118,11 +118,11 @@ class DocstringTyper(typer.Typer):
     '--namespace' automatically generates a '-n' flag.
     """
 
-    def command(self, *args, **kwargs):
+    def command(self, *args: Any, **kwargs: Any) -> Callable:
         """Overridden typer.Typer:command decorator."""
         decorator = super().command(*args, **kwargs)
 
-        def wrapper(func):
+        def wrapper(func: Callable) -> Callable:
             """Generate help messages and shorthand aliases for all args of func."""
             sig = inspect.signature(func)
             doc = docstring_parser.parse(func.__doc__ or "")
@@ -136,7 +136,9 @@ class DocstringTyper(typer.Typer):
 
             # Keep examples portion in command's help output if specified
             if doc.examples:
-                new_doc += "\n\nExamples\n--------\n" + doc.examples[0].description
+                new_doc += "\n\nExamples\n--------\n" + (
+                    doc.examples[0].description or ""
+                )
 
             func.__doc__ = new_doc
 
@@ -164,7 +166,7 @@ class DocstringTyper(typer.Typer):
                 new_params.append(param.replace(default=option))
 
             new_sig = sig.replace(parameters=new_params)
-            func.__signature__ = new_sig
+            func.__signature__ = new_sig  # type: ignore[attr-defined]
 
             return decorator(func)
 
@@ -202,7 +204,7 @@ config_app.add_typer(
 @app.command()
 def create(
     namespace: str = NAMESPACE,
-    packages: Optional[List[str]] = None,
+    packages: list[str] | None = None,
     save_type: Literal["json", "yaml"] = "json",
 ):
     """Create plugin registries.
@@ -239,12 +241,12 @@ def create(
 
     Parameters
     ----------
-    namespace: str, default='pluginify.plugin_packages'
+    namespace : str, default='pluginify.plugin_packages'
         The namespace which plugin packages are registered under.
-    packages: Optional[List[str]], default=None
+    packages : list[str] | None, default=None
         A list of strings representing plugin packages to create registries for. If
         None, create registry files for all plugin packages found under 'namespace'.
-    save_type: Literal['json', 'yaml'], default='json'
+    save_type : Literal['json', 'yaml'], default='json'
         The file extension to save the registry files as. Defaults to 'json', 'yaml'
         can be specified as well.
     """
@@ -255,7 +257,7 @@ def create(
 @app.command()
 def delete(
     namespace: str = NAMESPACE,
-    packages: Optional[List[str]] = None,
+    packages: list[str] | None = None,
 ):
     """Delete plugin registries.
 
@@ -289,9 +291,9 @@ def delete(
 
     Parameters
     ----------
-    namespace: str, default='pluginify.plugin_packages'
+    namespace : str, default='pluginify.plugin_packages'
         The namespace which plugin packages are registered under.
-    packages: Optional[List[str]], default=None
+    packages : list[str] | None, default=None
         A list of strings representing plugin packages to create registries for. If
         None, create registry files for all plugin packages found under 'namespace'.
     """
@@ -305,7 +307,7 @@ def set_rebuild_registries(rebuild_registries: bool):
 
     Parameters
     ----------
-    rebuild_registries: bool
+    rebuild_registries : bool
         The default setting for whether or not pluginify should rebuild registries by
         default. This will persist between terminal sessions if set.
     """
@@ -318,7 +320,7 @@ def set_namespace(namespace: str):
 
     Parameters
     ----------
-    namespace: str
+    namespace : str
         The default namespace you want to pluginify to operate on. This will persist
         between terminal sessions if set.
     """
@@ -331,14 +333,14 @@ def set_registry_directory(registry_directory: Path):
 
     Parameters
     ----------
-    registry_directory: Path
+    registry_directory : Path
         The default path to the directory you want to write registry files to. This will
         persist between terminal sessions if set.
     """
     update_existing_fields({"REGISTRY_DIRECTORY": registry_directory})
 
 
-def main():
+def main() -> None:
     """Entrypoint function for pluginify's CLI."""
     configure_logging(logging.INFO)
     app()

{pluginify-1.0.0.post16.dev0 → pluginify-1.0.0.post41.dev0}/pluginify/config.py

@@ -3,13 +3,18 @@
 
 """Module containing configuration variables needed for pluginify to run."""
 
+from __future__ import annotations
 
-def _get_env_name():
+from pathlib import Path
+from typing import Any
+
+
+def _get_env_name() -> str:
     """Determine the name of the environment that this code is being executed under.
 
     Returns
     -------
-    env_name: str
+    env_name : str
         The name of the environment which was active when this code was ran. If running
         under the base environment, return 'base_env'.
     """
@@ -35,7 +40,7 @@ def _get_env_name():
     return env_name
 
 
-def _env_to_variable(name, default):
+def _env_to_variable(name: str, default: Any) -> Any:
     """Convert an environment variable (str) to a python variable (Any).
 
     If an environment variable under 'name' has been set, convert it to a python
@@ -44,14 +49,14 @@ def _env_to_variable(name, default):
 
     Parameters
     ----------
-    name: str
+    name : str
         The name of the environment variable to convert.
-    default: Any
+    default : Any
         The default value for the environment variable named 'name'..
 
     Returns
     -------
-    converted: Any
+    converted : Any
         - The converted value of the environment variable.
     """
     # imports buried to avoid polluting this module's import namespace
@@ -72,7 +77,7 @@ def _env_to_variable(name, default):
     return default
 
 
-def _load_config_values():
+def _load_config_values() -> tuple[str, bool, Path]:
     """Load and override pluginify configuration variables if they exist.
 
     The configuration file for this package is expected to be found at
@@ -120,26 +125,28 @@ def _load_config_values():
     return NAMESPACE, REBUILD_REGISTRIES, REGISTRY_DIRECTORY
 
 
+# These module-level variables are resolved at import time from env vars,
+# config file (~/.config/pluginify/config.yaml), and built-in defaults.
 NAMESPACE, REBUILD_REGISTRIES, REGISTRY_DIRECTORY = _load_config_values()
 
 
-def get_registry_cache_dir(namespace, package):
+def get_registry_cache_dir(namespace: str, package: str) -> Path:
     """Return the path to the parent directory of where to write registry files to.
 
     Where the path is formatted '~/.cache/{env_name}/{namespace}/{package}'.
 
     Parameters
     ----------
-    namespace: str
+    namespace : str
         Namespace that your plugin packages fall under. The argument parser defaults
         this value to 'pluginify.plugin_packages', but a user can create separate
         namespaces if developing interfaces outside of pluginify.
-    package: str
+    package : str
         Name of a plugin package that is registered under 'namespace'.
 
     Returns
     -------
-    cache_dir: Path
+    cache_dir : Path
         Full path to the parent directory in which registry files should be written
         for a package under namespace.
     """