nautobot 2.4.9__py3-none-any.whl → 2.4.11__py3-none-any.whl

nautobot/dcim/migrations/0070_modulefamily_models.py

@@ -0,0 +1,92 @@
+# Generated by Django 4.2.19 on 2025-03-18 17:22
+
+import uuid
+
+import django.core.serializers.json
+from django.db import migrations, models
+import django.db.models.deletion
+
+import nautobot.core.models.fields
+import nautobot.extras.models.mixins
+
+
+class Migration(migrations.Migration):
+    dependencies = [
+        ("extras", "0122_add_graphqlquery_owner_content_type"),
+        ("dcim", "0069_softwareimagefile_external_integration"),
+    ]
+
+    operations = [
+        migrations.AddField(
+            model_name="modulebay",
+            name="requires_first_party_modules",
+            field=models.BooleanField(default=False),
+        ),
+        migrations.AddField(
+            model_name="modulebaytemplate",
+            name="requires_first_party_modules",
+            field=models.BooleanField(default=False),
+        ),
+        migrations.CreateModel(
+            name="ModuleFamily",
+            fields=[
+                (
+                    "id",
+                    models.UUIDField(
+                        default=uuid.uuid4, editable=False, primary_key=True, serialize=False, unique=True
+                    ),
+                ),
+                ("created", models.DateTimeField(auto_now_add=True, null=True)),
+                ("last_updated", models.DateTimeField(auto_now=True, null=True)),
+                (
+                    "_custom_field_data",
+                    models.JSONField(blank=True, default=dict, encoder=django.core.serializers.json.DjangoJSONEncoder),
+                ),
+                ("name", models.CharField(max_length=255, unique=True)),
+                ("description", models.CharField(blank=True, max_length=255)),
+                ("tags", nautobot.core.models.fields.TagsField(through="extras.TaggedItem", to="extras.Tag")),
+            ],
+            options={
+                "verbose_name_plural": "module families",
+                "ordering": ["name"],
+            },
+            bases=(
+                nautobot.extras.models.mixins.DynamicGroupMixin,
+                nautobot.extras.models.mixins.NotesMixin,
+                models.Model,
+            ),
+        ),
+        migrations.AddField(
+            model_name="modulebay",
+            name="module_family",
+            field=models.ForeignKey(
+                blank=True,
+                null=True,
+                on_delete=django.db.models.deletion.PROTECT,
+                related_name="module_bays",
+                to="dcim.modulefamily",
+            ),
+        ),
+        migrations.AddField(
+            model_name="modulebaytemplate",
+            name="module_family",
+            field=models.ForeignKey(
+                blank=True,
+                null=True,
+                on_delete=django.db.models.deletion.PROTECT,
+                related_name="module_bay_templates",
+                to="dcim.modulefamily",
+            ),
+        ),
+        migrations.AddField(
+            model_name="moduletype",
+            name="module_family",
+            field=models.ForeignKey(
+                blank=True,
+                null=True,
+                on_delete=django.db.models.deletion.PROTECT,
+                related_name="module_types",
+                to="dcim.modulefamily",
+            ),
+        ),
+    ]

nautobot/dcim/models/__init__.py

@@ -38,6 +38,7 @@ from .devices import (
     InterfaceVDCAssignment,
     Manufacturer,
     Module,
+    ModuleFamily,
     ModuleType,
     Platform,
     SoftwareImageFile,
@@ -81,6 +82,7 @@ __all__ = (
     "Module",
     "ModuleBay",
     "ModuleBayTemplate",
+    "ModuleFamily",
     "ModuleType",
     "PathEndpoint",
     "Platform",

nautobot/dcim/models/device_component_templates.py

@@ -82,6 +82,8 @@ class ComponentTemplateModel(
         """
         raise NotImplementedError()
 
+    instantiate.alters_data = True
+
     def to_objectchange(self, action, **kwargs):
         """
         Return a new ObjectChange with the `related_object` pinned to the `device_type` by default.
@@ -122,6 +124,8 @@ class ComponentTemplateModel(
             **kwargs,
         )
 
+    instantiate_model.alters_data = True
+
 
 class ModularComponentTemplateModel(ComponentTemplateModel):
     """Component Template that supports assignment to a DeviceType or a ModuleType."""
@@ -477,6 +481,18 @@ class ModuleBayTemplate(ModularComponentTemplateModel):
     )
     label = models.CharField(max_length=CHARFIELD_MAX_LENGTH, blank=True, help_text="Physical label")
     description = models.CharField(max_length=CHARFIELD_MAX_LENGTH, blank=True)
+    module_family = models.ForeignKey(
+        to="dcim.ModuleFamily",
+        on_delete=models.PROTECT,
+        related_name="module_bay_templates",
+        blank=True,
+        null=True,
+        help_text="Module family that can be installed in this bay. Leave blank for no restriction.",
+    )
+    requires_first_party_modules = models.BooleanField(
+        default=False,
+        help_text="This bay will only accept modules from the same manufacturer as the parent device or module",
+    )
 
     natural_key_field_names = ["device_type", "module_type", "name"]
 
@@ -501,6 +517,8 @@ class ModuleBayTemplate(ModularComponentTemplateModel):
             position=self.position,
             label=self.label,
             description=self.description,
+            module_family=self.module_family,
+            requires_first_party_modules=self.requires_first_party_modules,
             _custom_field_data=custom_field_data,
         )
 

nautobot/dcim/models/device_components.py

@@ -182,6 +182,8 @@ class ModularComponentModel(ComponentModel):
                 if save:
                     self.save(update_fields=["_name", "name"])
 
+    render_name_template.alters_data = True
+
     def to_objectchange(self, action, **kwargs):
         """
         Return a new ObjectChange with the `related_object` pinned to the parent `device` or `module`.
@@ -820,6 +822,8 @@ class Interface(ModularComponentModel, CableTermination, PathEndpoint, BaseInter
                 instance.validated_save()
         return len(ip_addresses)
 
+    add_ip_addresses.alters_data = True
+
     def remove_ip_addresses(self, ip_addresses):
         """Remove one or more IPAddress instances from this interface's `ip_addresses` many-to-many relationship.
 
@@ -839,6 +843,8 @@ class Interface(ModularComponentModel, CableTermination, PathEndpoint, BaseInter
                 count += deleted_count
         return count
 
+    remove_ip_addresses.alters_data = True
+
     @property
     def is_connectable(self):
         return self.type not in NONCONNECTABLE_IFACE_TYPES
@@ -939,6 +945,8 @@ class InterfaceRedundancyGroup(PrimaryModel):  # pylint: disable=too-many-ancest
         )
         return instance.validated_save()
 
+    add_interface.alters_data = True
+
     def remove_interface(self, interface):
         """
         Remove an interface.
@@ -952,6 +960,8 @@ class InterfaceRedundancyGroup(PrimaryModel):  # pylint: disable=too-many-ancest
         )
         return instance.delete()
 
+    remove_interface.alters_data = True
+
 
 @extras_features("graphql")
 class InterfaceRedundancyGroupAssociation(BaseModel, ChangeLoggedModel):
@@ -1208,6 +1218,18 @@ class ModuleBay(PrimaryModel):
         blank=True,
         null=True,
     )
+    module_family = models.ForeignKey(
+        to="dcim.ModuleFamily",
+        on_delete=models.PROTECT,
+        related_name="module_bays",
+        blank=True,
+        null=True,
+        help_text="Module family that can be installed in this bay",
+    )
+    requires_first_party_modules = models.BooleanField(
+        default=False,
+        help_text="This bay will only accept modules from the same manufacturer as the parent device or module",
+    )
     name = models.CharField(max_length=CHARFIELD_MAX_LENGTH, db_index=True)
     _name = NaturalOrderingField(target_field="name", max_length=CHARFIELD_MAX_LENGTH, blank=True, db_index=True)
     position = models.CharField(
@@ -1218,7 +1240,7 @@ class ModuleBay(PrimaryModel):
     label = models.CharField(max_length=CHARFIELD_MAX_LENGTH, blank=True, help_text="Physical label")
     description = models.CharField(max_length=CHARFIELD_MAX_LENGTH, blank=True)
 
-    clone_fields = ["parent_device", "parent_module"]
+    clone_fields = ["parent_device", "parent_module", "module_family", "requires_first_party_modules"]
 
     # The recursive nature of this model combined with the fact that it can be a child of a
     # device or location makes our natural key implementation unusable, so just use the pk
@@ -1287,3 +1309,5 @@ class ModuleBay(PrimaryModel):
 
         if not self.position:
             self.position = self.name
+
+    clean.alters_data = True

nautobot/dcim/models/devices.py

@@ -897,6 +897,8 @@ class Device(PrimaryModel, ConfigContextModel):
             model.objects.bulk_create([x.instantiate(device=self) for x in templates])
         return instantiated_components
 
+    create_components.alters_data = True
+
     @property
     def display(self):
         if self.name:
@@ -1548,6 +1550,30 @@ class ControllerManagedDeviceGroup(TreeModel, PrimaryModel):
 #
 
 
+@extras_features(
+    "custom_links",
+    "custom_validators",
+    "export_templates",
+    "graphql",
+    "webhooks",
+)
+class ModuleFamily(PrimaryModel):
+    """
+    A ModuleFamily represents a classification of ModuleTypes.
+    It is used to enforce compatibility between ModuleBays and Modules.
+    """
+
+    name = models.CharField(max_length=CHARFIELD_MAX_LENGTH, unique=True)
+    description = models.CharField(max_length=CHARFIELD_MAX_LENGTH, blank=True)
+
+    class Meta:
+        ordering = ["name"]
+        verbose_name_plural = "module families"
+
+    def __str__(self):
+        return self.name
+
+
 # TODO: 5840 - Translate comments field from devicetype library, Nautobot doesn't use that field for ModuleType
 @extras_features(
     "custom_links",
@@ -1575,6 +1601,13 @@ class ModuleType(PrimaryModel):
     """
 
     manufacturer = models.ForeignKey(to="dcim.Manufacturer", on_delete=models.PROTECT, related_name="module_types")
+    module_family = models.ForeignKey(
+        to="dcim.ModuleFamily",
+        on_delete=models.PROTECT,
+        related_name="module_types",
+        blank=True,
+        null=True,
+    )
     model = models.CharField(max_length=CHARFIELD_MAX_LENGTH)
     part_number = models.CharField(
         max_length=CHARFIELD_MAX_LENGTH, blank=True, help_text="Discrete part number (optional)"
@@ -1583,6 +1616,7 @@ class ModuleType(PrimaryModel):
 
     clone_fields = [
         "manufacturer",
+        "module_family",
     ]
 
     class Meta:
@@ -1808,6 +1842,36 @@ class Module(PrimaryModel):
                     {"location": f'Modules may not associate to locations of type "{self.location.location_type}".'}
                 )
 
+        # Validate module family compatibility
+        if self.parent_module_bay and self.parent_module_bay.module_family:
+            if self.module_type.module_family != self.parent_module_bay.module_family:
+                module_family_name = self.parent_module_bay.module_family.name
+                if self.module_type.module_family is None:
+                    module_type_family = "not assigned to a family"
+                else:
+                    module_type_family = f"in the family {self.module_type.module_family.name}"
+                raise ValidationError(
+                    {
+                        "module_type": f"The selected module bay requires a module type in the family {module_family_name}, "
+                        f"but the selected module type is {module_type_family}."
+                    }
+                )
+
+        # Validate module manufacturer constraint
+        if self.parent_module_bay and self.parent_module_bay.requires_first_party_modules:
+            if self.parent_module_bay.parent_device:
+                parent_mfr = self.parent_module_bay.parent_device.device_type.manufacturer
+            elif self.parent_module_bay.parent_module:
+                parent_mfr = self.parent_module_bay.parent_module.module_type.manufacturer
+            else:
+                parent_mfr = None
+            if parent_mfr and self.module_type.manufacturer != parent_mfr:
+                raise ValidationError(
+                    {
+                        "module_type": "The selected module bay requires a module type from the same manufacturer as the parent device or module"
+                    }
+                )
+
     def save(self, *args, **kwargs):
         is_new = not self.present_in_database
 
@@ -1858,6 +1922,8 @@ class Module(PrimaryModel):
             model.objects.bulk_create([x.instantiate(device=None, module=self) for x in templates])
         return instantiated_components
 
+    create_components.alters_data = True
+
     def render_component_names(self):
         """
         Replace the {module}, {module.parent}, {module.parent.parent}, etc. template variables in descendant
@@ -1882,6 +1948,8 @@ class Module(PrimaryModel):
         for child in self.get_children():
             child.render_component_names()
 
+    render_component_names.alters_data = True
+
     def get_cables(self, pk_list=False):
         """
         Return a QuerySet or PK list matching all Cables connected to any component of this Module.

nautobot/dcim/navigation.py

@@ -293,6 +293,22 @@ menu_items = (
                             ),
                         ),
                     ),
+                    NavMenuItem(
+                        link="dcim:modulefamily_list",
+                        name="Module Families",
+                        weight=300,
+                        permissions=[
+                            "dcim.view_modulefamily",
+                        ],
+                        buttons=(
+                            NavMenuAddButton(
+                                link="dcim:modulefamily_add",
+                                permissions=[
+                                    "dcim.add_modulefamily",
+                                ],
+                            ),
+                        ),
+                    ),
                 ),
             ),
             NavMenuGroup(

nautobot/dcim/tables/__init__.py

@@ -30,6 +30,7 @@ from .devices import (
     InterfaceTable,
     InventoryItemTable,
     ModuleBayTable,
+    ModuleFamilyTable,
     ModuleModuleBayTable,
     ModuleTable,
     PlatformTable,
@@ -104,6 +105,7 @@ __all__ = (
     "ManufacturerTable",
     "ModuleBayTable",
     "ModuleBayTemplateTable",
+    "ModuleFamilyTable",
     "ModuleModuleBayTable",
     "ModuleTable",
     "ModuleTypeTable",

nautobot/dcim/tables/devices.py

@@ -26,6 +26,7 @@ from nautobot.dcim.models import (
     InventoryItem,
     Module,
     ModuleBay,
+    ModuleFamily,
     Platform,
     PowerOutlet,
     PowerPort,
@@ -86,6 +87,7 @@ __all__ = (
     "InterfaceTable",
     "InventoryItemTable",
     "ModuleBayTable",
+    "ModuleFamilyTable",
     "ModuleModuleBayTable",
     "ModuleTable",
     "PlatformTable",
@@ -275,6 +277,7 @@ class ModuleTable(StatusTableMixin, RoleTableMixin, BaseTable):
     )
     location = tables.Column(linkify=True)
     tenant = TenantColumn()
+    module_type__module_family = tables.Column(linkify=True, verbose_name="Family")
     tags = TagColumn(url_name="dcim:module_list")
     actions = ButtonsColumn(Module, prepend_template=MODULE_BUTTONS)
 
@@ -283,6 +286,7 @@ class ModuleTable(StatusTableMixin, RoleTableMixin, BaseTable):
         fields = (
             "pk",
             "module_type",
+            "module_family",
             "parent_module_bay",
             "location",
             "serial",
@@ -296,6 +300,7 @@ class ModuleTable(StatusTableMixin, RoleTableMixin, BaseTable):
         default_columns = (
             "pk",
             "module_type",
+            "module_family",
             "parent_module_bay",
             "location",
             "serial",
@@ -307,6 +312,40 @@ class ModuleTable(StatusTableMixin, RoleTableMixin, BaseTable):
         )
 
 
+class ModuleFamilyTable(BaseTable):
+    pk = ToggleColumn()
+    name = tables.Column(linkify=True)
+    module_type_count = LinkedCountColumn(
+        viewname="dcim:moduletype_list", url_params={"module_family": "pk"}, verbose_name="Module Types"
+    )
+    module_bay_count = LinkedCountColumn(
+        viewname="dcim:modulebay_list", url_params={"module_family": "pk"}, verbose_name="Module Bays"
+    )
+    tags = TagColumn()
+    actions = ButtonsColumn(ModuleFamily)
+
+    class Meta(BaseTable.Meta):
+        model = ModuleFamily
+        fields = (
+            "pk",
+            "name",
+            "description",
+            "module_type_count",
+            "module_bay_count",
+            "tags",
+            "created",
+            "last_updated",
+            "actions",
+        )
+        default_columns = (
+            "name",
+            "description",
+            "module_type_count",
+            "module_bay_count",
+            "actions",
+        )
+
+
 #
 # Device components
 #
@@ -943,6 +982,7 @@ class ModuleBayTable(BaseTable):
     installed_module = tables.Column(linkify=True, verbose_name="Installed Module")
     installed_module__status = ColoredLabelColumn()
     tags = TagColumn(url_name="dcim:devicebay_list")
+    module_family = tables.Column(linkify=True, verbose_name="Family")
 
     class Meta(BaseTable.Meta):
         model = ModuleBay
@@ -953,6 +993,7 @@ class ModuleBayTable(BaseTable):
             "name",
             "position",
             "label",
+            "module_family",
             "description",
             "installed_module",
             "installed_module__status",
@@ -965,6 +1006,7 @@ class ModuleBayTable(BaseTable):
             "name",
             "position",
             "label",
+            "module_family",
             "description",
             "installed_module",
             "installed_module__status",
@@ -1008,8 +1050,10 @@ class DeviceModuleBayTable(ModuleBayTable):
         '"></i> <a href="{{ record.get_absolute_url }}">{{ value }}</a>',
         attrs={"td": {"class": "text-nowrap"}},
     )
+    module_family = tables.Column(linkify=True, verbose_name="Family")
     installed_module = tables.Column(linkify=True, verbose_name="Installed Module")
     installed_module__status = ColoredLabelColumn(verbose_name="Installed Module Status")
+    requires_first_party_modules = BooleanColumn(verbose_name="First-Party Only")
     actions = ButtonsColumn(model=ModuleBay, buttons=("edit", "delete"), prepend_template=MODULEBAY_BUTTONS)
 
     class Meta(ModularDeviceComponentTable.Meta):
@@ -1018,6 +1062,8 @@ class DeviceModuleBayTable(ModuleBayTable):
             "pk",
             "name",
             "position",
+            "module_family",
+            "requires_first_party_modules",
             "installed_module",
             "installed_module__status",
             "label",
@@ -1029,6 +1075,8 @@ class DeviceModuleBayTable(ModuleBayTable):
             "pk",
             "name",
             "position",
+            "module_family",
+            "requires_first_party_modules",
             "installed_module",
             "installed_module__status",
             "actions",

nautobot/dcim/tables/devicetypes.py

@@ -158,6 +158,7 @@ class ModuleTypeTable(BaseTable):
     pk = ToggleColumn()
     manufacturer = tables.Column(linkify=True)
     model = tables.Column(linkify=True, verbose_name="Module Type")
+    module_family = tables.Column(linkify=True, verbose_name="Family")
     module_count = LinkedCountColumn(
         viewname="dcim:module_list",
         url_params={"module_type": "pk"},
@@ -172,6 +173,7 @@ class ModuleTypeTable(BaseTable):
             "model",
             "manufacturer",
             "part_number",
+            "module_family",
             "module_count",
             "tags",
         )
@@ -180,6 +182,7 @@ class ModuleTypeTable(BaseTable):
             "model",
             "manufacturer",
             "part_number",
+            "module_family",
             "module_count",
         )
 
@@ -333,8 +336,39 @@ class ModuleBayTemplateTable(ComponentTemplateTable):
         buttons=("edit", "delete"),
         return_url_extra=r"%3Ftab=modulebays",
     )
+    module_family = tables.Column(verbose_name="Family", linkify=True)
+    requires_first_party_modules = BooleanColumn(verbose_name="Requires First-Party Modules")
 
     class Meta(BaseTable.Meta):
         model = ModuleBayTemplate
-        fields = ("pk", "name", "position", "label", "description", "actions")
+        fields = (
+            "pk",
+            "name",
+            "position",
+            "module_family",
+            "label",
+            "requires_first_party_modules",
+            "description",
+            "actions",
+        )
+        default_columns = (
+            "pk",
+            "name",
+            "position",
+            "module_family",
+            "label",
+            "requires_first_party_modules",
+            "description",
+            "actions",
+        )
+        field_order = (
+            "pk",
+            "name",
+            "position",
+            "module_family",
+            "label",
+            "requires_first_party_modules",
+            "description",
+            "actions",
+        )
         empty_text = "None"

nautobot/dcim/tables/template_code.py

@@ -93,7 +93,9 @@ LINKED_RECORD_COUNT = """
 
 TREE_LINK = """
 {% load helpers %}
+{% if not table.hide_hierarchy_ui %}
 {% tree_hierarchy_ui_representation record.tree_depth|as_range table.hide_hierarchy_ui %}
+{% endif %}
 <a href="{{ record.get_absolute_url }}">{{ record.name }}</a>
 """
 

nautobot/dcim/templates/dcim/controllermanageddevicegroup_retrieve.html

@@ -1,91 +1,2 @@
 {% extends 'generic/object_retrieve.html' %}
-{% load helpers %}
-
-{% block extra_nav_tabs %}
-    {% if wireless_networks_count %}
-        <li role="presentation"{% if request.GET.tab == 'wireless_networks' %} class="active"{% endif %}>
-            <a href="{{ object.get_absolute_url }}#wireless_networks" onclick="switch_tab(this.href, reload=false)" aria-controls="wireless_networks" role="tab" data-toggle="tab">
-                Wireless Networks {% badge wireless_networks_count %}
-            </a>
-        </li>
-    {% endif %}
-    {% if radio_profiles_count %}
-        <li role="presentation"{% if request.GET.tab == 'radio_profiles' %} class="active"{% endif %}>
-            <a href="{{ object.get_absolute_url }}#radio_profiles" onclick="switch_tab(this.href, reload=false)" aria-controls="radio_profiles" role="tab" data-toggle="tab">
-                Radio Profiles {% badge radio_profiles_count %}
-            </a>
-        </li>
-    {% endif %}
-{% endblock extra_nav_tabs %}
-
-{% block extra_tab_content %}
-    {% if wireless_networks_count %}
-        <div id="wireless_networks" role="tabpanel" class="tab-pane {% if not active_tab and not request.GET.tab or request.GET.tab == "wireless_networks" %}active{% else %}fade{% endif %}">
-            <div class="panel panel-default">
-                <div class="panel-heading">
-                    <strong>Wireless Networks</strong>
-                </div>
-                {% include 'inc/table.html' with table=wireless_networks_table %}
-            </div>
-            {% include 'inc/paginator.html' with paginator=wireless_networks_table.paginator page=wireless_networks_table.page %}
-        </div>
-    {% endif %}
-    {% if radio_profiles_count %}
-        <div id="radio_profiles" role="tabpanel" class="tab-pane {% if not active_tab and not request.GET.tab or request.GET.tab == "radio_profiles" %}active{% else %}fade{% endif %}">
-            <div class="panel panel-default">
-                <div class="panel-heading">
-                    <strong>Radio Profiles</strong>
-                </div>
-                {% include 'panel_table.html' with table=radio_profiles_table %}
-            </div>
-            {% include 'inc/paginator.html' with paginator=radio_profiles_table.paginator page=radio_profiles_table.page %}
-        </div>
-    {% endif %}
-{% endblock extra_tab_content %}
-
-{% block content_left_page %}
-            <div class="panel panel-default">
-                <div class="panel-heading">
-                    <strong>Controller</strong>
-                </div>
-                <div class="table-responsive">
-                    <table class="table table-hover panel-body attr-table">
-                        <tr>
-                            <td>Name</td>
-                            <td>{{ object.name|placeholder }}</td>
-                        </tr>
-                        <tr>
-                            <td>Controller</td>
-                            <td>{{ object.controller|hyperlinked_object }}</td>
-                        </tr>
-                        <tr>
-                            <td>Parent</td>
-                            <td>{{ object.parent|hyperlinked_object }}</td>
-                        </tr>
-                        <tr>
-                            <td>Capabilities</td>
-                            <td>{{ object.get_capabilities_display }}</td>
-                        </tr>
-                        <tr>
-                            <td>Weight</td>
-                            <td>{{ object.weight }}</td>
-                        </tr>
-                        {% include 'inc/tenant_table_row.html' %}
-                        <tr>
-                            <td>Description</td>
-                            <td>{{ object.description|placeholder }}</td>
-                        </tr>
-                    </table>
-                </div>
-            </div>
-{% endblock content_left_page %}
-
-{% block content_full_width_page %}
-        <div class="panel panel-default">
-            <div class="panel-heading">
-                <strong>Devices</strong>
-            </div>
-            {% include 'responsive_table.html' with table=devices_table %}
-        </div>
-        {% include 'inc/paginator.html' with paginator=devices_table.paginator page=devices_table.page %}
-{% endblock content_full_width_page %}
+{% comment %}3.0 TODO: remove this template, which only exists for backward compatibility with 2.4 and earlier{% endcomment %}