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

{netbox_interface_name_rules-1.2.0/netbox_interface_name_rules.egg-info → netbox_interface_name_rules-1.2.2}/PKG-INFO

@@ -1,12 +1,21 @@
 Metadata-Version: 2.4
 Name: netbox-interface-name-rules
-Version: 1.2.0
+Version: 1.2.2
 Summary: NetBox plugin for automatic interface renaming when modules are installed
+Author: Marcin Zieba
 License-Expression: Apache-2.0
+Project-URL: Homepage, https://marcinpsk.github.io/netbox-InterfaceNameRules-plugin/
+Project-URL: Repository, https://github.com/marcinpsk/netbox-InterfaceNameRules-plugin
+Project-URL: Issues, https://github.com/marcinpsk/netbox-InterfaceNameRules-plugin/issues
+Project-URL: Documentation, https://marcinpsk.github.io/netbox-InterfaceNameRules-plugin/
+Project-URL: Changelog, https://github.com/marcinpsk/netbox-InterfaceNameRules-plugin/blob/main/CHANGELOG.md
+Keywords: netbox,plugin,dcim,interface,naming,modules,transceiver,automation
 Classifier: Programming Language :: Python :: 3
 Classifier: Programming Language :: Python :: 3.12
 Classifier: Programming Language :: Python :: 3.13
 Classifier: Framework :: Django
+Classifier: Environment :: Plugins
+Classifier: Topic :: System :: Networking
 Requires-Python: >=3.12.0
 Description-Content-Type: text/markdown
 License-File: LICENSE
@@ -14,6 +23,10 @@ Dynamic: license-file
 
 # NetBox Interface Name Rules Plugin
 
+<p align="center">
+  <img src="https://raw.githubusercontent.com/marcinpsk/netbox-InterfaceNameRules-plugin/main/docs/icon.svg" alt="NetBox Interface Name Rules" width="80"/>
+</p>
+
 [![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)
@@ -63,6 +76,21 @@ Add to `configuration.py`:
 PLUGINS = ['netbox_interface_name_rules']
 ```
 
+## Configuration
+
+Rules are managed through the NetBox UI under **Plugins → Interface Name Rules**, or via the REST API at `/api/plugins/interface-name-rules/rules/`.
+
+See the [full configuration guide](https://marcinpsk.github.io/netbox-InterfaceNameRules-plugin/configuration/) for all rule fields, priority scoring, and template variable reference.
+
+## Screenshots
+
+<p align="center">
+  <img src="https://raw.githubusercontent.com/marcinpsk/netbox-InterfaceNameRules-plugin/main/docs/screenshots/01-rule-list.png" alt="Rule list" width="700"/>
+</p>
+<p align="center">
+  <img src="https://raw.githubusercontent.com/marcinpsk/netbox-InterfaceNameRules-plugin/main/docs/screenshots/11-apply-rule-preview.png" alt="Apply-rules preview" width="700"/>
+</p>
+
 ## Compatibility
 
 - NetBox ≥ 4.2.0

netbox_interface_name_rules-1.2.0/PKG-INFO → netbox_interface_name_rules-1.2.2/README.md

@@ -1,19 +1,9 @@
-Metadata-Version: 2.4
-Name: netbox-interface-name-rules
-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
-Classifier: Programming Language :: Python :: 3.12
-Classifier: Programming Language :: Python :: 3.13
-Classifier: Framework :: Django
-Requires-Python: >=3.12.0
-Description-Content-Type: text/markdown
-License-File: LICENSE
-Dynamic: license-file
-
 # NetBox Interface Name Rules Plugin
 
+<p align="center">
+  <img src="https://raw.githubusercontent.com/marcinpsk/netbox-InterfaceNameRules-plugin/main/docs/icon.svg" alt="NetBox Interface Name Rules" width="80"/>
+</p>
+
 [![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)
@@ -63,6 +53,21 @@ Add to `configuration.py`:
 PLUGINS = ['netbox_interface_name_rules']
 ```
 
+## Configuration
+
+Rules are managed through the NetBox UI under **Plugins → Interface Name Rules**, or via the REST API at `/api/plugins/interface-name-rules/rules/`.
+
+See the [full configuration guide](https://marcinpsk.github.io/netbox-InterfaceNameRules-plugin/configuration/) for all rule fields, priority scoring, and template variable reference.
+
+## Screenshots
+
+<p align="center">
+  <img src="https://raw.githubusercontent.com/marcinpsk/netbox-InterfaceNameRules-plugin/main/docs/screenshots/01-rule-list.png" alt="Rule list" width="700"/>
+</p>
+<p align="center">
+  <img src="https://raw.githubusercontent.com/marcinpsk/netbox-InterfaceNameRules-plugin/main/docs/screenshots/11-apply-rule-preview.png" alt="Apply-rules preview" width="700"/>
+</p>
+
 ## Compatibility
 
 - NetBox ≥ 4.2.0
@@ -81,4 +86,4 @@ Apache 2.0
 
 See [CONTRIBUTING.md](CONTRIBUTING.md) for how to submit code or interface name rules.
 
-Community-contributed rules for various vendors are in the [`contrib/`](contrib/) directory.
+Community-contributed rules for various vendors are in the [`contrib/`](contrib/) directory.

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

@@ -2,7 +2,7 @@
 # Copyright (C) 2025 Marcin Zieba <marcinpsk@gmail.com>
 from netbox.plugins import PluginConfig
 
-__version__ = "1.2.0"
+__version__ = "1.2.2"
 
 
 class InterfaceNameRulesConfig(PluginConfig):
@@ -16,6 +16,8 @@ class InterfaceNameRulesConfig(PluginConfig):
     min_version = "4.2.0"
     required_settings = []
     default_settings = {}
+    author = "Marcin Zieba"
+    author_email = "marcinpsk@gmail.com"
 
     def ready(self):
         """Connect signal handlers after all apps are loaded."""

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

@@ -1,8 +1,7 @@
 # SPDX-License-Identifier: Apache-2.0
 # Copyright (C) 2025 Marcin Zieba <marcinpsk@gmail.com>
-from rest_framework import serializers
-
 from netbox.api.serializers import NetBoxModelSerializer
+from rest_framework import serializers
 
 from netbox_interface_name_rules.models import InterfaceNameRule
 
@@ -43,25 +42,25 @@ class InterfaceNameRuleSerializer(NetBoxModelSerializer):
 
         if is_device_level:
             # Device-level rules must not have a module_type FK
-            if module_type:
+            if module_type:  # pragma: no cover  # model.clean() runs first
                 raise serializers.ValidationError(
                     {"module_type": "Module type must be empty for device-level interface rules."}
                 )
         elif is_regex:
-            if not pattern:
+            if not pattern:  # pragma: no cover  # model.clean() runs first
                 raise serializers.ValidationError(
                     {"module_type_pattern": "Regex pattern is required when regex mode is enabled."}
                 )
-            if module_type:
+            if module_type:  # pragma: no cover  # model.clean() runs first
                 raise serializers.ValidationError(
                     {"module_type": "Cannot set both module_type and module_type_pattern. Choose one."}
                 )
         else:
-            if not module_type:
+            if not module_type:  # pragma: no cover  # model.clean() runs first
                 raise serializers.ValidationError(
                     {"module_type": "module_type is required when regex mode is disabled."}
                 )
-            if pattern:
+            if pattern:  # pragma: no cover  # model.clean() runs first
                 raise serializers.ValidationError(
                     {"module_type_pattern": "Cannot set module_type_pattern when regex mode is disabled."}
                 )

{netbox_interface_name_rules-1.2.0 → netbox_interface_name_rules-1.2.2}/netbox_interface_name_rules/engine.py

@@ -831,5 +831,4 @@ def evaluate_name_template(template: str, variables: dict) -> str:
         except (SyntaxError, TypeError) as e:
             raise ValueError(f"Invalid arithmetic expression '{expr}': {e}") from e
 
-    result = re.sub(r"\{([^}]+)\}", _eval_expr, result)
-    return result
+    return re.sub(r"\{([^}]+)\}", _eval_expr, result)

{netbox_interface_name_rules-1.2.0 → netbox_interface_name_rules-1.2.2}/netbox_interface_name_rules/models.py

@@ -9,7 +9,6 @@ from django.urls import reverse
 from netbox.models import NetBoxModel
 from taggit.managers import TaggableManager
 
-
 _REDOS_PATTERN = re.compile(r"(\+\*|\*\+|\?\?|\)\s*[\+\*\?]\s*[\+\*\?]|\)\s*\{[^{}]+\}\s*[\+\*\?])")
 
 

netbox_interface_name_rules-1.2.2/netbox_interface_name_rules/templates/netbox_interface_name_rules/interfacenamerule.html

@@ -0,0 +1,115 @@
+{# SPDX-License-Identifier: Apache-2.0 #}
+{# Copyright (C) 2025 Marcin Zieba <marcinpsk@gmail.com> #}
+{% extends 'generic/object.html' %}
+{% load helpers %}
+{% load plugins %}
+
+{% block extra_controls %}
+  <a href="{% url 'plugins:netbox_interface_name_rules:interfacenamerule_test' %}?rule_id={{ object.pk }}"
+     class="btn btn-outline-secondary">
+    <i class="mdi mdi-flask-outline me-1"></i>Test in Build Rule
+  </a>
+  {% if perms.netbox_interface_name_rules.add_interfacenamerule %}
+    <a href="{% url 'plugins:netbox_interface_name_rules:interfacenamerule_duplicate' object.pk %}"
+       class="btn btn-success">
+      <i class="mdi mdi-content-copy me-1"></i>Duplicate
+    </a>
+  {% endif %}
+{% endblock extra_controls %}
+
+{% block content %}
+{# ── Priority callout ───────────────────────────────────────────────────────── #}
+<div class="alert alert-info d-flex align-items-start mb-3" role="alert">
+  <i class="mdi mdi-information-outline me-2 mt-1 fs-5"></i>
+  <div>
+    <strong>Priority score: {{ object.specificity_score }}</strong>
+    <span class="text-muted ms-1">({{ object.specificity_label }})</span>
+    <br>
+    <small>
+      This score is <em>auto-computed</em> — you cannot set it directly.
+      It controls which rule wins when multiple rules match the same module.
+      <strong>Higher score = higher priority.</strong>
+      Exact FK rules always outrank regex rules (score 1000+&nbsp;vs max ≤&nbsp;955).
+      Among regex rules, adding scope fields raises the score:
+      <code>parent_module_type</code>&nbsp;+4×100,
+      <code>device_type</code>&nbsp;+2×100,
+      <code>platform</code>&nbsp;+1×100,
+      plus pattern length.
+      <a data-bs-toggle="collapse" href="#priority-detail" class="ms-1">More…</a>
+    </small>
+    <div class="collapse mt-2" id="priority-detail">
+      <table class="table table-sm table-bordered mb-0 small">
+        <thead class="table-light"><tr><th>Rule type</th><th>Score formula</th><th>Range</th></tr></thead>
+        <tbody>
+          <tr><td>Exact FK (module_type)</td><td>1000 + scope</td><td>1000 – 1007</td></tr>
+          <tr><td>Regex (module_type_pattern)</td><td>scope × 100 + len(pattern)</td><td>0 – 955</td></tr>
+        </tbody>
+      </table>
+      <p class="small mb-0 mt-1">
+        Scope bits: <code>parent_module_type</code>=4, <code>device_type</code>=2, <code>platform</code>=1.
+        Two rules with the same score: lowest <code>pk</code> (oldest rule) wins.
+      </p>
+    </div>
+  </div>
+</div>
+
+<div class="row mb-3">
+  <div class="col col-md-12">
+    <div class="card">
+      <table class="table table-hover attr-table">
+        <thead>
+          <tr>
+            <th>Module Type</th>
+            <th>Parent Module Type</th>
+            <th>Device Type</th>
+            <th>Platform</th>
+            <th>Name Template</th>
+            <th>Channels</th>
+            <th>Channel Start</th>
+            <th>Description</th>
+          </tr>
+        </thead>
+        <tbody>
+          <tr>
+            <td>
+              {% if object.module_type_is_regex %}
+                <code>{{ object.module_type_pattern }}</code>
+                <span class="badge text-bg-info">regex</span>
+              {% elif object.module_type %}
+                <a href="{{ object.module_type.get_absolute_url }}">{{ object.module_type }}</a>
+              {% else %}
+                <span class="text-muted">—</span>
+              {% endif %}
+            </td>
+            <td>
+              {% if object.parent_module_type %}
+                <a href="{{ object.parent_module_type.get_absolute_url }}">{{ object.parent_module_type }}</a>
+              {% else %}
+                <span class="text-muted">Any parent</span>
+              {% endif %}
+            </td>
+            <td>
+              {% if object.device_type %}
+                <a href="{{ object.device_type.get_absolute_url }}">{{ object.device_type }}</a>
+              {% else %}
+                <span class="text-muted">Any device</span>
+              {% endif %}
+            </td>
+            <td>
+              {% if object.platform %}
+                <a href="{{ object.platform.get_absolute_url }}">{{ object.platform }}</a>
+              {% else %}
+                <span class="text-muted">Any platform</span>
+              {% endif %}
+            </td>
+            <td><code>{{ object.name_template }}</code></td>
+            <td>{{ object.channel_count|default:"—" }}</td>
+            <td>{{ object.channel_start }}</td>
+            <td>{{ object.description|default:"—" }}</td>
+          </tr>
+        </tbody>
+      </table>
+    </div>
+  </div>
+</div>
+{% endblock %}

netbox_interface_name_rules-1.2.2/netbox_interface_name_rules/templates/netbox_interface_name_rules/interfacenamerule_list.html

@@ -0,0 +1,164 @@
+{# SPDX-License-Identifier: Apache-2.0 #}
+{# Copyright (C) 2025 Marcin Zieba <marcinpsk@gmail.com> #}
+{% extends 'generic/object_list.html' %}
+
+{% block content %}
+    <div class="card mb-3" id="interface-name-rules-help">
+        <div class="card-header" role="button" tabindex="0" style="cursor: pointer;"
+             id="rules-help-header" aria-expanded="true" aria-controls="rules-help-body"
+             onclick="toggleRulesHelp()"
+             onkeydown="if(event.key==='Enter'||event.key===' '){toggleRulesHelp();event.preventDefault();}">
+            <h5 class="card-title mb-0 d-flex align-items-center">
+                <i class="mdi mdi-information-outline me-2"></i>
+                Interface Name Rules Reference
+                <i class="mdi ms-auto" id="rules-help-chevron"></i>
+            </h5>
+        </div>
+        <div id="rules-help-body" class="card-body">
+            <p>Define post-install interface rename rules for module types where NetBox's
+               position-based naming can't produce the correct interface name.</p>
+            <p>Covers <strong>converter offset</strong> (e.g., CVR-X2-SFP + GLC-T),
+               <strong>breakout transceivers</strong> (e.g., QSFP+ 4x10G with channel numbering),
+               <strong>platform-specific naming</strong> (e.g., Juniper et-/xe-/ge- prefixes),
+               and <strong>Virtual Chassis device port renaming</strong> (e.g., Gi0/1 → Gi2/1 on VC member 2).</p>
+
+            <p><strong>Signal-driven:</strong> Rules run automatically via two Django signals:</p>
+            <ul>
+                <li><code>post_save</code> on <strong>Module</strong> — fires after a module is installed into a device bay (primary path for transceiver/linecard naming).</li>
+                <li><code>post_save</code> on <strong>Device</strong> — fires after VC position changes (<code>vc_position</code> or <code>virtual_chassis</code> modified); triggers device-level interface renaming for VC members.</li>
+            </ul>
+            <p>Both paths use <code>on_commit</code> deferred execution so that all interfaces are in the database before renaming begins.</p>
+
+            <p><strong>Device interface rules</strong> (<code>Applies to Device Interfaces</code> checkbox) target native device-type interfaces
+               (<code>module=None</code>) rather than module-installed interfaces. Use these to rename VC member ports when the device
+               joins a stack or changes position. The <code>Module Type Pattern</code> field acts as an interface-name filter (regex) instead of a module type selector.</p>
+
+            <h6 class="mt-3">Supported Template Variables</h6>
+            <table class="table table-sm table-bordered" style="max-width: 750px;">
+                <thead>
+                    <tr><th style="width: 200px;">Variable</th><th>Rule type</th><th>Description</th></tr>
+                </thead>
+                <tbody>
+                    <tr><td><code>{slot}</code></td><td>Module</td><td>Top-level slot/module bay position (from grandparent or parent)</td></tr>
+                    <tr><td><code>{bay_position}</code></td><td>Module</td><td>Position of the bay this module is installed into (raw, e.g., "swp1")</td></tr>
+                    <tr><td><code>{bay_position_num}</code></td><td>Module</td><td>Numeric suffix of bay position (e.g., "swp1" &rarr; "1")</td></tr>
+                    <tr><td><code>{parent_bay_position}</code></td><td>Module</td><td>Position of the parent module's bay</td></tr>
+                    <tr><td><code>{sfp_slot}</code></td><td>Module</td><td>Numeric sub-bay index within the parent module</td></tr>
+                    <tr><td><code>{base}</code></td><td>Both</td><td>Original interface name from the template (or current name for device-level rules)</td></tr>
+                    <tr><td><code>{port}</code></td><td>Device</td><td>Segment after the last "/" in the current interface name (e.g., "Gi0/1" &rarr; "1"); full name if no "/"</td></tr>
+                    <tr><td><code>{channel}</code></td><td>Module</td><td>Breakout channel number (iterated from Ch. Start to Ch. Start + Channels - 1)</td></tr>
+                    <tr><td><code>{vc_position}</code></td><td>Both</td><td>Virtual Chassis member position (<code>device.vc_position</code>); requires device to be in a VC</td></tr>
+                </tbody>
+            </table>
+
+            <h6 class="mt-3">Arithmetic Expressions</h6>
+            <p>Arithmetic is supported inside braces:
+               <code>{8 + ({parent_bay_position} - 1) * 2 + {sfp_slot}}</code></p>
+
+            <h6 class="mt-3">Examples</h6>
+            <ul class="mb-0">
+                <li><strong>Converter offset:</strong> GLC-T in CVR-X2-SFP &rarr;
+                    <code>GigabitEthernet{slot}/{8 + ({parent_bay_position} - 1) * 2 + {sfp_slot}}</code></li>
+                <li><strong>Breakout:</strong> QSFP-4X10G-LR &rarr; <code>{base}:{channel}</code>
+                    (Channels=4, Ch. Start=0)</li>
+                <li><strong>Platform naming:</strong> QSFP-100G-LR4 on ACX7024 &rarr;
+                    <code>et-0/0/{bay_position}</code> (scoped via Parent Device Type)</li>
+                <li><strong>UfiSpace breakout:</strong> QSFP-100G-LR4 on S9610-36D &rarr;
+                    <code>swp{bay_position_num}s{channel}</code> (Channels=2, Ch. Start=1)</li>
+                <li><strong>Virtual Chassis linecard:</strong> VC-LINECARD on stack member &rarr;
+                    <code>Gi{vc_position}/{bay_position_num}</code> (requires device to be in a Virtual Chassis)</li>
+                <li><strong>VC device ports (Cisco):</strong> GigabitEthernet1/0/3 on stack member 2 &rarr;
+                    <code>GigabitEthernet{vc_position}/0/{port}</code> &rarr; GigabitEthernet2/0/3
+                    (device-level rule, pattern <code>GigabitEthernet\d+/\d+/\d+</code>)</li>
+                <li><strong>VC device ports (Juniper):</strong> ge-0/0/2 on VC member 1 &rarr;
+                    <code>ge-{vc_position}/0/{port}</code> &rarr; ge-1/0/2
+                    (device-level rule, pattern <code>ge-\d+/\d+/\d+</code>)</li>
+                <li><strong>VC device ports (Arista):</strong> Ethernet1/3 on VC member 2 &rarr;
+                    <code>Ethernet{vc_position}/{port}</code> &rarr; Ethernet2/3
+                    (device-level rule, pattern <code>Ethernet\d+/\d+</code>)</li>
+            </ul>
+
+            {% if supports_module_path %}
+            <div class="alert alert-success mt-3 mb-0">
+                <i class="mdi mdi-check-circle me-1"></i>
+                <strong><code>{module_path}</code> supported:</strong>
+                Platform naming rules (e.g., <code>et-0/0/{bay_position}</code>)
+                may be replaceable by using <code>{module_path}</code> in module type interface templates directly.
+                Converter offset and breakout rules are still needed.
+            </div>
+            {% else %}
+            <div class="alert alert-warning mt-3 mb-0">
+                <i class="mdi mdi-information-outline me-1"></i>
+                <strong><code>{module_path}</code> not available:</strong>
+                Platform naming rules
+                (e.g., Juniper <code>et-0/0/{bay_position}</code>) are required for correct interface naming.
+                Upgrade NetBox to get native <code>{module_path}</code> support.
+            </div>
+            {% endif %}
+        </div>
+    </div>
+    <script>
+        function toggleRulesHelp() {
+            const body = document.getElementById('rules-help-body');
+            const header = document.getElementById('rules-help-header');
+            const chevron = document.getElementById('rules-help-chevron');
+            const collapsed = body.style.display === 'none';
+            body.style.display = collapsed ? '' : 'none';
+            chevron.className = collapsed ? 'mdi ms-auto mdi-chevron-up' : 'mdi ms-auto mdi-chevron-down';
+            header.setAttribute('aria-expanded', collapsed ? 'true' : 'false');
+            localStorage.setItem('rulesHelpCollapsed', collapsed ? '' : '1');
+        }
+        document.addEventListener('DOMContentLoaded', function() {
+            const collapsed = localStorage.getItem('rulesHelpCollapsed') === '1';
+            const body = document.getElementById('rules-help-body');
+            const header = document.getElementById('rules-help-header');
+            const chevron = document.getElementById('rules-help-chevron');
+            body.style.display = collapsed ? 'none' : '';
+            chevron.className = collapsed ? 'mdi ms-auto mdi-chevron-down' : 'mdi ms-auto mdi-chevron-up';
+            header.setAttribute('aria-expanded', collapsed ? 'false' : 'true');
+
+            // AJAX toggle: click handler on toggle buttons (no form — avoids nested-form 405 bug)
+            document.addEventListener('click', function(e) {
+                const btn = e.target.closest('.toggle-btn[data-toggle-url]');
+                if (!btn) return;
+                const url = btn.dataset.toggleUrl;
+                const csrfToken =
+                    document.querySelector('input[name="csrfmiddlewaretoken"]')?.value ||
+                    (document.cookie.match(/(?:^|;\s*)csrftoken=([^;]+)/) || [])[1] || '';
+                btn.disabled = true;
+                fetch(url, {
+                    method: 'POST',
+                    headers: {'X-Requested-With': 'XMLHttpRequest', 'X-CSRFToken': csrfToken},
+                    credentials: 'same-origin',
+                }).then(r => {
+                    if (!r.ok) throw new Error('HTTP ' + r.status);
+                    return r.json();
+                }).then(data => {
+                    btn.disabled = false;
+                    const row = btn.closest('tr');
+                    if (data.enabled) {
+                        btn.className = 'btn btn-sm btn-success toggle-btn';
+                        btn.title = 'Enabled — click to disable';
+                        btn.setAttribute('aria-pressed', 'true');
+                        btn.setAttribute('aria-label', 'Enabled — click to disable');
+                        const iconOn = btn.querySelector('i');
+                        if (iconOn) iconOn.className = 'mdi mdi-check';
+                        if (row) row.classList.remove('text-muted', 'opacity-50');
+                    } else {
+                        btn.className = 'btn btn-sm btn-secondary toggle-btn';
+                        btn.title = 'Disabled — click to enable';
+                        btn.setAttribute('aria-pressed', 'false');
+                        btn.setAttribute('aria-label', 'Disabled — click to enable');
+                        const iconOff = btn.querySelector('i');
+                        if (iconOff) iconOff.className = 'mdi mdi-minus';
+                        if (row) row.classList.add('text-muted', 'opacity-50');
+                    }
+                }).catch(() => {
+                    btn.disabled = false;
+                    window.location.reload();
+                });
+            });
+        });
+    </script>
+    {{ block.super }}
+{% endblock %}

netbox_interface_name_rules-1.2.2/netbox_interface_name_rules/templates/netbox_interface_name_rules/rule_apply.html

@@ -0,0 +1,180 @@
+{# SPDX-License-Identifier: Apache-2.0 #}
+{# Copyright (C) 2025 Marcin Zieba <marcinpsk@gmail.com> #}
+{% extends 'generic/_base.html' %}
+
+{% block title %}Apply Rules{% endblock %}
+
+{% block content %}
+<p class="text-muted mb-3">
+  Use this page to <strong>retroactively rename interfaces that were installed before the matching rule existed</strong>.
+  Interfaces installed <em>after</em> a rule is active are renamed automatically at install time — you don't need
+  to use Apply Rules for them.
+</p>
+<p class="text-muted mb-3">
+  Select a rule and click <strong>Preview &amp; Apply</strong> to see which currently installed interfaces
+  would be renamed, then optionally apply the changes (synchronously up to {{ batch_limit }} interfaces,
+  or as a background job for larger sets).
+</p>
+
+{% if rules %}
+  <div class="card">
+    <div class="card-header d-flex align-items-center gap-2 flex-wrap">
+      <h5 class="card-title mb-0 me-2"><i class="mdi mdi-format-list-bulleted me-2"></i>Available Rules</h5>
+      <button id="scan-all-btn" class="btn btn-sm btn-outline-secondary" title="Check all rules to see if any currently installed interfaces would be renamed">
+        <i class="mdi mdi-magnify me-1"></i>Check all rules
+      </button>
+      <span id="scan-progress" class="text-muted small" aria-live="polite" role="status" style="display:none"></span>
+      <div class="ms-auto">
+        <input id="rule-search" type="search" class="form-control form-control-sm" placeholder="Filter rules…"
+               style="width:240px" aria-label="Filter rules">
+      </div>
+    </div>
+    <div class="card-body p-0">
+      <table class="table table-hover mb-0" id="rules-table">
+        <thead>
+          <tr>
+            <th>#</th>
+            <th>Type</th>
+            <th>Module Type</th>
+            <th>Parent Module Type</th>
+            <th>Device Type</th>
+            <th>Platform</th>
+            <th>Name Template</th>
+            <th>Ch.</th>
+            <th title="Click 'Check' to scan installed interfaces and see if any would be renamed by this rule. This scan runs on demand because it may be slow for rules matching many modules.">Can rename</th>
+            <th></th>
+          </tr>
+        </thead>
+        <tbody>
+          {% for rule in rules %}
+            <tr>
+              <td><a href="{{ rule.get_absolute_url }}">{{ rule.pk }}</a></td>
+              <td>
+                {% if rule.module_type_is_regex %}
+                  <span class="badge text-bg-info">regex</span>
+                {% else %}
+                  <span class="badge text-bg-success">exact</span>
+                {% endif %}
+              </td>
+              <td>
+                {% if rule.module_type_is_regex %}
+                  <code>{{ rule.module_type_pattern }}</code>
+                {% elif rule.module_type %}
+                  <a href="{{ rule.module_type.get_absolute_url }}">{{ rule.module_type.model }}</a>
+                {% else %}
+                  <span class="text-muted">—</span>
+                {% endif %}
+              </td>
+              <td>
+                {% if rule.parent_module_type %}
+                  <a href="{{ rule.parent_module_type.get_absolute_url }}">{{ rule.parent_module_type.model }}</a>
+                {% else %}
+                  <span class="text-muted">Any</span>
+                {% endif %}
+              </td>
+              <td>
+                {% if rule.device_type %}
+                  <a href="{{ rule.device_type.get_absolute_url }}">{{ rule.device_type.model }}</a>
+                {% else %}
+                  <span class="text-muted">Any</span>
+                {% endif %}
+              </td>
+              <td>
+                {% if rule.platform %}
+                  <a href="{{ rule.platform.get_absolute_url }}">{{ rule.platform.name }}</a>
+                {% else %}
+                  <span class="text-muted">Any</span>
+                {% endif %}
+              </td>
+              <td><code>{{ rule.name_template }}</code></td>
+              <td>{% if rule.channel_count %}{{ rule.channel_count }}{% else %}<span class="text-muted">—</span>{% endif %}</td>
+              <td class="applicable-cell" data-pk="{{ rule.pk }}"
+                  data-url="{% url 'plugins:netbox_interface_name_rules:interfacenamerule_applicable' rule.pk %}">
+                <button class="btn btn-sm btn-outline-secondary scan-btn py-0 px-2"
+                        data-pk="{{ rule.pk }}"
+                        title="Scan installed interfaces to see if any would be renamed">
+                  <i class="mdi mdi-magnify"></i> Check
+                </button>
+              </td>
+              <td>
+                <a href="{% url 'plugins:netbox_interface_name_rules:interfacenamerule_apply_detail' rule.pk %}"
+                   class="btn btn-sm btn-outline-primary">
+                  <i class="mdi mdi-eye me-1"></i>Preview &amp; Apply
+                </a>
+                <a href="{% url 'plugins:netbox_interface_name_rules:interfacenamerule_test' %}?rule_id={{ rule.pk }}"
+                   class="btn btn-sm btn-outline-secondary" title="Test in Rule Builder" aria-label="Test in Rule Builder">
+                  <i class="mdi mdi-flask-outline"></i>
+                </a>
+              </td>
+            </tr>
+          {% endfor %}
+        </tbody>
+      </table>
+    </div>
+  </div>
+
+  <script>
+  (function () {
+    // --- filter ---
+    const input = document.getElementById('rule-search');
+    const rows  = document.querySelectorAll('#rules-table tbody tr');
+    input.addEventListener('input', function () {
+      const q = this.value.toLowerCase();
+      rows.forEach(r => { r.style.display = r.textContent.toLowerCase().includes(q) ? '' : 'none'; });
+    });
+
+    // --- per-rule scan ---
+    function renderResult(cell, applicable) {
+      const pk  = cell.dataset.pk;
+      const recheck = `<button class="btn btn-sm btn-link p-0 ms-1 rescan-btn" data-pk="${pk}" title="Re-check"><i class="mdi mdi-refresh"></i></button>`;
+      if (applicable === true) {
+        // light green tint — interfaces would be renamed
+        cell.innerHTML = `<span class="badge fw-normal" style="background:rgba(25,135,84,.15);color:#0f5132;border:1px solid rgba(25,135,84,.3)">Yes</span>${recheck}`;
+      } else if (applicable === false) {
+        // light muted tint — nothing to rename
+        cell.innerHTML = `<span class="badge fw-normal" style="background:rgba(108,117,125,.1);color:#6c757d;border:1px solid rgba(108,117,125,.25)">No</span>${recheck}`;
+      } else {
+        // light red tint — scan error
+        cell.innerHTML = `<span class="badge fw-normal" style="background:rgba(220,53,69,.12);color:#842029;border:1px solid rgba(220,53,69,.25)" title="Scan failed">Error</span>${recheck}`;
+      }
+      cell.querySelector('.rescan-btn').addEventListener('click', () => scanCell(cell));
+    }
+
+    // Returns a Promise that resolves when the fetch + render completes.
+    function scanCell(cell) {
+      const url = cell.dataset.url;
+      cell.innerHTML = '<span class="spinner-border spinner-border-sm text-secondary" role="status"></span>';
+      return fetch(url)
+        .then(r => { if (!r.ok) { renderResult(cell, null); return; } return r.json(); })
+        .then(d => { if (d) renderResult(cell, d.applicable); })
+        .catch(() => renderResult(cell, null));
+    }
+
+    // bind initial scan buttons
+    document.querySelectorAll('.scan-btn').forEach(btn => {
+      btn.addEventListener('click', function () { scanCell(this.closest('td')); });
+    });
+
+    // --- scan all (serial, awaiting each fetch before moving to the next) ---
+    document.getElementById('scan-all-btn').addEventListener('click', async function () {
+      const cells = Array.from(document.querySelectorAll('.applicable-cell'))
+        .filter(cell => cell.closest('tr').style.display !== 'none');
+      const progress = document.getElementById('scan-progress');
+      this.disabled = true;
+      progress.style.display = '';
+      for (let i = 0; i < cells.length; i++) {
+        progress.textContent = `Checking ${i + 1} / ${cells.length}…`;
+        await scanCell(cells[i]);
+      }
+      progress.textContent = `Done — ${cells.length} rules checked.`;
+      this.disabled = false;
+    });
+  })();
+  </script>
+{% else %}
+  <div class="alert alert-info">
+    No rules defined yet.
+    <a href="{% url 'plugins:netbox_interface_name_rules:interfacenamerule_add' %}">Add a rule</a> to get started.
+  </div>
+{% endif %}
+{% endblock %}