netbox-nso-plugin 0.2.0__py3-none-any.whl

netbox_nso_plugin/__init__.py

@@ -0,0 +1,61 @@
+# SPDX-License-Identifier: Apache-2.0
+# Copyright (C) 2025 Marcin Zieba <marcinpsk@gmail.com>
+from netbox.plugins import PluginConfig
+
+__version__ = "0.2.0"
+
+
+class NSOPluginConfig(PluginConfig):
+    """NetBox plugin configuration for NSO integration."""
+
+    name = "netbox_nso_plugin"
+    verbose_name = "NSO Plugin"
+    description = "Integrates NetBox with Cisco NSO via the nso-adapter REST API."
+    version = __version__
+    base_url = "nso"
+    min_version = "4.6.0"
+    required_settings = []
+    default_settings = {
+        "adapter_url": "",
+        "adapter_token": "",
+        # A 'deploying' row that outlives a SUCCEEDED apply by this long without the
+        # device ever showing its value escalates to apply_failed (silent drop, #26).
+        "stuck_deploying_grace_minutes": 10,
+    }
+    author = "Marcin Zieba"
+    author_email = "marcinpsk@gmail.com"
+
+    def ready(self):  # pragma: no cover
+        """Connect signal handlers after all apps are loaded."""
+        super().ready()
+        from . import (
+            jobs,  # noqa: F401 — registers the @system_job hourly onboarding sweep
+            signals,  # noqa: F401
+        )
+        from .signals import _connect_g_activated
+
+        _connect_g_activated()
+
+        # Register the shared-object materialization specs (route-policy families) at startup.
+        # They live in route_policy_reconciler (run via its module-level _register_specs()), but
+        # that module was previously imported only lazily during a reconcile — so a web worker
+        # rendering the versions page before any reconcile had an EMPTY registry, making
+        # hash_captured() return "" and every device version falsely read as "matches". Importing
+        # it here guarantees the specs exist in every process (web + worker).
+        from django.conf import settings
+
+        from . import route_policy_reconciler  # noqa: F401
+        from .derived_intent import _register_description_from_cable
+
+        # The field is always available; enabled templates are read live from NetBox.
+        _register_description_from_cable()
+
+        cfg = settings.PLUGINS_CONFIG.get("netbox_nso_plugin", {})
+        self._interface_ip_auto_create = cfg.get("interface_ip_auto_create", False)
+        self._static_route_auto_create = cfg.get("static_route_auto_create", False)
+        # Link-role resolver: opt-in fallback to M13's classify_interface heuristic
+        # when an interface has no explicit NSOLinkRoleAssignment (default off).
+        self._link_role_derived_fallback = cfg.get("link_role_derived_fallback", False)
+
+
+config = NSOPluginConfig