netbox-interface-name-rules 1.1.2__tar.gz → 1.2.0__tar.gz

{netbox_interface_name_rules-1.1.2 → netbox_interface_name_rules-1.2.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: netbox-interface-name-rules
-Version: 1.1.2
+Version: 1.2.0
 Summary: NetBox plugin for automatic interface renaming when modules are installed
 License-Expression: Apache-2.0
 Classifier: Programming Language :: Python :: 3
@@ -17,6 +17,7 @@ Dynamic: license-file
 [![PyPI](https://img.shields.io/pypi/v/netbox-interface-name-rules)](https://pypi.org/project/netbox-interface-name-rules/)
 [![PyPI - Downloads](https://img.shields.io/pypi/dm/netbox-interface-name-rules)](https://pypi.org/project/netbox-interface-name-rules/)
 [![CI](https://img.shields.io/github/actions/workflow/status/marcinpsk/netbox-InterfaceNameRules-plugin/test.yaml?branch=main&label=tests)](https://github.com/marcinpsk/netbox-InterfaceNameRules-plugin/actions/workflows/test.yaml)
+[![Coverage](https://img.shields.io/endpoint?url=https://marcinpsk.github.io/netbox-InterfaceNameRules-plugin/coverage/badge.json)](https://marcinpsk.github.io/netbox-InterfaceNameRules-plugin/coverage/)
 [![License](https://img.shields.io/github/license/marcinpsk/netbox-InterfaceNameRules-plugin)](LICENSE)
 [![Python](https://img.shields.io/pypi/pyversions/netbox-interface-name-rules)](https://pypi.org/project/netbox-interface-name-rules/)
 [![NetBox](https://img.shields.io/badge/NetBox-%E2%89%A54.2.0-blue)](https://github.com/netbox-community/netbox)
@@ -71,6 +72,11 @@ PLUGINS = ['netbox_interface_name_rules']
 
 Apache 2.0
 
+## Documentation
+
+- [Full documentation](https://marcinpsk.github.io/netbox-InterfaceNameRules-plugin/) — installation, configuration, examples
+- [DeepWiki](https://deepwiki.com/marcinpsk/netbox-InterfaceNameRules-plugin) — AI-generated codebase overview
+
 ## Contributing
 
 See [CONTRIBUTING.md](CONTRIBUTING.md) for how to submit code or interface name rules.

{netbox_interface_name_rules-1.1.2 → netbox_interface_name_rules-1.2.0}/README.md

@@ -3,6 +3,7 @@
 [![PyPI](https://img.shields.io/pypi/v/netbox-interface-name-rules)](https://pypi.org/project/netbox-interface-name-rules/)
 [![PyPI - Downloads](https://img.shields.io/pypi/dm/netbox-interface-name-rules)](https://pypi.org/project/netbox-interface-name-rules/)
 [![CI](https://img.shields.io/github/actions/workflow/status/marcinpsk/netbox-InterfaceNameRules-plugin/test.yaml?branch=main&label=tests)](https://github.com/marcinpsk/netbox-InterfaceNameRules-plugin/actions/workflows/test.yaml)
+[![Coverage](https://img.shields.io/endpoint?url=https://marcinpsk.github.io/netbox-InterfaceNameRules-plugin/coverage/badge.json)](https://marcinpsk.github.io/netbox-InterfaceNameRules-plugin/coverage/)
 [![License](https://img.shields.io/github/license/marcinpsk/netbox-InterfaceNameRules-plugin)](LICENSE)
 [![Python](https://img.shields.io/pypi/pyversions/netbox-interface-name-rules)](https://pypi.org/project/netbox-interface-name-rules/)
 [![NetBox](https://img.shields.io/badge/NetBox-%E2%89%A54.2.0-blue)](https://github.com/netbox-community/netbox)
@@ -57,6 +58,11 @@ PLUGINS = ['netbox_interface_name_rules']
 
 Apache 2.0
 
+## Documentation
+
+- [Full documentation](https://marcinpsk.github.io/netbox-InterfaceNameRules-plugin/) — installation, configuration, examples
+- [DeepWiki](https://deepwiki.com/marcinpsk/netbox-InterfaceNameRules-plugin) — AI-generated codebase overview
+
 ## Contributing
 
 See [CONTRIBUTING.md](CONTRIBUTING.md) for how to submit code or interface name rules.

{netbox_interface_name_rules-1.1.2 → netbox_interface_name_rules-1.2.0}/netbox_interface_name_rules/__init__.py

@@ -2,10 +2,12 @@
 # Copyright (C) 2025 Marcin Zieba <marcinpsk@gmail.com>
 from netbox.plugins import PluginConfig
 
-__version__ = "1.1.2"
+__version__ = "1.2.0"
 
 
 class InterfaceNameRulesConfig(PluginConfig):
+    """NetBox plugin configuration for Interface Name Rules."""
+
     name = "netbox_interface_name_rules"
     verbose_name = "Interface Name Rules"
     description = "Automatic interface renaming when modules are installed into bays."
@@ -16,6 +18,7 @@ class InterfaceNameRulesConfig(PluginConfig):
     default_settings = {}
 
     def ready(self):
+        """Connect signal handlers after all apps are loaded."""
         super().ready()
         from . import signals  # noqa: F401 — registers post_save handler
 

{netbox_interface_name_rules-1.1.2 → netbox_interface_name_rules-1.2.0}/netbox_interface_name_rules/api/serializers.py

@@ -24,18 +24,30 @@ class InterfaceNameRuleSerializer(NetBoxModelSerializer):
             "channel_count",
             "channel_start",
             "description",
+            "enabled",
+            "applies_to_device_interfaces",
         ]
 
     def validate(self, attrs):
+        """Ensure module_type XOR module_type_pattern depending on regex mode."""
         attrs = super().validate(attrs)
         instance = self.instance
 
         # For PATCH requests, fall back to existing instance values for fields not in attrs
+        is_device_level = attrs.get(
+            "applies_to_device_interfaces", getattr(instance, "applies_to_device_interfaces", False)
+        )
         is_regex = attrs.get("module_type_is_regex", getattr(instance, "module_type_is_regex", False))
         module_type = attrs.get("module_type", getattr(instance, "module_type", None))
         pattern = attrs.get("module_type_pattern", getattr(instance, "module_type_pattern", ""))
 
-        if is_regex:
+        if is_device_level:
+            # Device-level rules must not have a module_type FK
+            if module_type:
+                raise serializers.ValidationError(
+                    {"module_type": "Module type must be empty for device-level interface rules."}
+                )
+        elif is_regex:
             if not pattern:
                 raise serializers.ValidationError(
                     {"module_type_pattern": "Regex pattern is required when regex mode is enabled."}
@@ -49,4 +61,8 @@ class InterfaceNameRuleSerializer(NetBoxModelSerializer):
                 raise serializers.ValidationError(
                     {"module_type": "module_type is required when regex mode is disabled."}
                 )
+            if pattern:
+                raise serializers.ValidationError(
+                    {"module_type_pattern": "Cannot set module_type_pattern when regex mode is disabled."}
+                )
         return attrs

{netbox_interface_name_rules-1.1.2 → netbox_interface_name_rules-1.2.0}/netbox_interface_name_rules/api/views.py

@@ -8,5 +8,7 @@ from .serializers import InterfaceNameRuleSerializer
 
 
 class InterfaceNameRuleViewSet(NetBoxModelViewSet):
+    """REST API viewset for InterfaceNameRule."""
+
     queryset = InterfaceNameRule.objects.all()
     serializer_class = InterfaceNameRuleSerializer