nautobot 2.3.16__py3-none-any.whl → 2.4.0__py3-none-any.whl

nautobot/wireless/forms.py

@@ -0,0 +1,283 @@
+from django import forms
+
+from nautobot.core.constants import CHARFIELD_MAX_LENGTH
+from nautobot.core.forms import (
+    add_blank_choice,
+    BootstrapMixin,
+    BulkEditNullBooleanSelect,
+    DynamicModelChoiceField,
+    DynamicModelMultipleChoiceField,
+    NumericArrayField,
+    StaticSelect2,
+    TagFilterField,
+)
+from nautobot.core.forms.fields import JSONArrayFormField
+from nautobot.dcim.models import ControllerManagedDeviceGroup, Location
+from nautobot.extras.forms import NautobotBulkEditForm, NautobotFilterForm, NautobotModelForm, TagsBulkEditFormMixin
+from nautobot.extras.models import SecretsGroup
+from nautobot.ipam.models import VLAN, VLANGroup
+from nautobot.wireless.models import (
+    ControllerManagedDeviceGroupWirelessNetworkAssignment,
+    RadioProfile,
+    SupportedDataRate,
+    WirelessNetwork,
+)
+
+from .choices import (
+    RadioProfileChannelWidthChoices,
+    RadioProfileFrequencyChoices,
+    RadioProfileRegulatoryDomainChoices,
+    SupportedDataRateStandardChoices,
+    WirelessNetworkAuthenticationChoices,
+    WirelessNetworkModeChoices,
+)
+
+
+class ControllerManagedDeviceGroupWirelessNetworkAssignmentForm(BootstrapMixin, forms.ModelForm):
+    locations = DynamicModelMultipleChoiceField(
+        queryset=Location.objects.all(),
+        required=False,
+        label="VLAN Locations (filter)",
+        null_option="None",
+    )
+    vlan_group = DynamicModelChoiceField(
+        queryset=VLANGroup.objects.all(),
+        required=False,
+        label="VLAN group (filter)",
+        null_option="None",
+        initial_params={"vlans": "$vlan"},
+    )
+    vlan = DynamicModelChoiceField(
+        queryset=VLAN.objects.all(),
+        required=False,
+        label="VLAN",
+        query_params={
+            "locations": "$locations",
+            "vlan_group": "$vlan_group",
+        },
+    )
+    controller_managed_device_group = DynamicModelChoiceField(
+        queryset=ControllerManagedDeviceGroup.objects.all(),
+        required=False,
+    )
+    wireless_network = DynamicModelChoiceField(
+        queryset=WirelessNetwork.objects.all(),
+        required=False,
+    )
+
+    class Meta:
+        model = ControllerManagedDeviceGroupWirelessNetworkAssignment
+        fields = [
+            "wireless_network",
+            "controller_managed_device_group",
+            "locations",
+            "vlan_group",
+            "vlan",
+        ]
+        field_order = [
+            "wireless_network",
+            "controller_managed_device_group",
+            "locations",
+            "vlan_group",
+            "vlan",
+        ]
+
+    def clean_wireless_network(self):
+        wireless_network = self.cleaned_data.get("wireless_network")
+        if not wireless_network:
+            raise forms.ValidationError("Wireless Network is required.")
+        return wireless_network
+
+    def clean_controller_managed_device_group(self):
+        controller_managed_device_group = self.cleaned_data.get("controller_managed_device_group")
+        if not controller_managed_device_group:
+            raise forms.ValidationError("Controller Managed Device Group is required.")
+        return controller_managed_device_group
+
+
+ControllerManagedDeviceGroupWirelessNetworkFormSet = forms.inlineformset_factory(
+    parent_model=ControllerManagedDeviceGroup,
+    model=ControllerManagedDeviceGroupWirelessNetworkAssignment,
+    form=ControllerManagedDeviceGroupWirelessNetworkAssignmentForm,
+    exclude=["controller_managed_device_group"],
+    extra=5,
+)
+
+
+WirelessNetworkControllerManagedDeviceGroupFormSet = forms.inlineformset_factory(
+    parent_model=WirelessNetwork,
+    model=ControllerManagedDeviceGroupWirelessNetworkAssignment,
+    form=ControllerManagedDeviceGroupWirelessNetworkAssignmentForm,
+    exclude=["wireless_network"],
+    extra=5,
+)
+
+
+class RadioProfileForm(NautobotModelForm):
+    allowed_channel_list = NumericArrayField(
+        base_field=forms.IntegerField(),
+        help_text="List of allowed channels for this radio profile.",
+        required=False,
+    )
+    controller_managed_device_group = DynamicModelMultipleChoiceField(
+        queryset=ControllerManagedDeviceGroup.objects.all(),
+        required=False,
+        label="Controller Managed Device Groups",
+    )
+    supported_data_rates = DynamicModelMultipleChoiceField(
+        queryset=SupportedDataRate.objects.all(),
+        required=False,
+        label="Supported Data Rates",
+    )
+
+    class Meta:
+        model = RadioProfile
+        fields = "__all__"
+
+
+class RadioProfileFilterForm(NautobotFilterForm):
+    model = RadioProfile
+    q = forms.CharField(required=False, label="Search")
+    tags = TagFilterField(model)
+
+
+class RadioProfileBulkEditForm(TagsBulkEditFormMixin, NautobotBulkEditForm):
+    pk = forms.ModelMultipleChoiceField(queryset=RadioProfile.objects.all(), widget=forms.MultipleHiddenInput)
+    name = forms.CharField(max_length=CHARFIELD_MAX_LENGTH, required=False)
+    frequency = forms.ChoiceField(
+        choices=add_blank_choice(RadioProfileFrequencyChoices),
+        required=False,
+        widget=StaticSelect2(),
+    )
+    add_supported_data_rates = DynamicModelMultipleChoiceField(
+        queryset=SupportedDataRate.objects.all(),
+        required=False,
+        label="Add Supported Data Rates",
+    )
+    remove_supported_data_rates = DynamicModelMultipleChoiceField(
+        queryset=SupportedDataRate.objects.all(),
+        required=False,
+        label="Remove Supported Data Rates",
+    )
+    add_controller_managed_device_groups = DynamicModelMultipleChoiceField(
+        queryset=ControllerManagedDeviceGroup.objects.all(),
+        required=False,
+        label="Add Controller Managed Device Groups",
+    )
+    remove_controller_managed_device_groups = DynamicModelMultipleChoiceField(
+        queryset=ControllerManagedDeviceGroup.objects.all(),
+        required=False,
+        label="Remove Controller Managed Device Groups",
+    )
+    allowed_channel_list = NumericArrayField(
+        base_field=forms.IntegerField(),
+        required=False,
+        label="Allowed Channel List",
+    )
+    tx_power_min = forms.IntegerField(required=False, label="TX Power Min")
+    tx_power_max = forms.IntegerField(required=False, label="TX Power Max")
+    rx_power_min = forms.IntegerField(required=False, label="RX Power Min")
+    regulatory_domain = forms.ChoiceField(
+        choices=add_blank_choice(RadioProfileRegulatoryDomainChoices),
+        required=False,
+        widget=StaticSelect2(),
+    )
+    channel_width = JSONArrayFormField(
+        choices=RadioProfileChannelWidthChoices,
+        base_field=forms.IntegerField(),
+        required=False,
+    )
+
+    class Meta:
+        nullable_fields = [
+            "frequency",
+            "allowed_channel_list",
+            "regulatory_domain",
+            "tx_power_min",
+            "tx_power_max",
+            "rx_power_min",
+            "channel_width",
+        ]
+
+
+class SupportedDataRateForm(NautobotModelForm):
+    class Meta:
+        model = SupportedDataRate
+        fields = "__all__"
+
+
+class SupportedDataRateFilterForm(NautobotFilterForm):
+    model = SupportedDataRate
+    q = forms.CharField(required=False, label="Search")
+    tags = TagFilterField(model)
+
+
+class SupportedDataRateBulkEditForm(TagsBulkEditFormMixin, NautobotBulkEditForm):
+    pk = forms.ModelMultipleChoiceField(queryset=SupportedDataRate.objects.all(), widget=forms.MultipleHiddenInput)
+    standard = forms.ChoiceField(
+        choices=add_blank_choice(SupportedDataRateStandardChoices),
+        required=False,
+        widget=StaticSelect2(),
+    )
+    rate = forms.IntegerField(min_value=1, required=False, label="Rate (Kbps)")
+    mcs_index = forms.IntegerField(required=False, label="MCS Index")
+
+    class Meta:
+        nullable_fields = [
+            "mcs_index",
+        ]
+
+
+class WirelessNetworkForm(NautobotModelForm):
+    class Meta:
+        model = WirelessNetwork
+        fields = "__all__"
+        field_order = [
+            "ssid",
+            "name",
+            "description",
+        ]
+
+
+class WirelessNetworkFilterForm(NautobotFilterForm):
+    model = WirelessNetwork
+    q = forms.CharField(required=False, label="Search")
+    tags = TagFilterField(model)
+
+
+class WirelessNetworkBulkEditForm(TagsBulkEditFormMixin, NautobotBulkEditForm):
+    pk = forms.ModelMultipleChoiceField(queryset=WirelessNetwork.objects.all(), widget=forms.MultipleHiddenInput)
+    description = forms.CharField(max_length=CHARFIELD_MAX_LENGTH, required=False)
+    add_controller_managed_device_groups = DynamicModelMultipleChoiceField(
+        queryset=ControllerManagedDeviceGroup.objects.all(),
+        required=False,
+        label="Add Controller Managed Device Groups",
+    )
+    remove_controller_managed_device_groups = DynamicModelMultipleChoiceField(
+        queryset=ControllerManagedDeviceGroup.objects.all(),
+        required=False,
+        label="Remove Controller Managed Device Groups",
+    )
+    ssid = forms.CharField(max_length=CHARFIELD_MAX_LENGTH, required=False)
+    mode = forms.ChoiceField(
+        choices=add_blank_choice(WirelessNetworkModeChoices),
+        required=False,
+        widget=StaticSelect2(),
+    )
+    enabled = forms.NullBooleanField(required=False, widget=BulkEditNullBooleanSelect)
+    hidden = forms.NullBooleanField(required=False, widget=BulkEditNullBooleanSelect)
+    authentication = forms.ChoiceField(
+        choices=add_blank_choice(WirelessNetworkAuthenticationChoices),
+        required=False,
+        widget=StaticSelect2(),
+    )
+    secrets_group = DynamicModelChoiceField(
+        queryset=SecretsGroup.objects.all(),
+        required=False,
+    )
+
+    class Meta:
+        nullable_fields = [
+            "description",
+            "secrets_group",
+        ]

nautobot/wireless/homepage.py

@@ -0,0 +1,19 @@
+from nautobot.core.apps import HomePageItem, HomePagePanel
+from nautobot.wireless.models import WirelessNetwork
+
+layout = (
+    HomePagePanel(
+        name="Wireless",
+        weight=500,
+        items=(
+            HomePageItem(
+                name="Wireless Networks",
+                link="wireless:wirelessnetwork_list",
+                model=WirelessNetwork,
+                description="Wireless networks for access points",
+                permissions=["wireless.view_wirelessnetwork"],
+                weight=100,
+            ),
+        ),
+    ),
+)

nautobot/wireless/migrations/0001_initial.py

@@ -0,0 +1,223 @@
+# Generated by Django 4.2.16 on 2024-11-05 13:48
+
+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):
+    initial = True
+
+    dependencies = [
+        ("extras", "0119_remove_task_queues_from_job_and_queue_from_scheduled_job"),
+        ("dcim", "0065_controller_capabilities_and_more"),
+        ("ipam", "0050_vlangroup_range"),
+        ("tenancy", "0009_update_all_charfields_max_length_to_255"),
+    ]
+
+    operations = [
+        migrations.CreateModel(
+            name="WirelessNetwork",
+            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)),
+                ("ssid", models.CharField(max_length=255)),
+                ("mode", models.CharField(max_length=255)),
+                ("enabled", models.BooleanField(default=True)),
+                ("authentication", models.CharField(max_length=255)),
+                ("hidden", models.BooleanField(default=False)),
+                (
+                    "secrets_group",
+                    models.ForeignKey(
+                        blank=True,
+                        null=True,
+                        on_delete=django.db.models.deletion.PROTECT,
+                        related_name="wireless_networks",
+                        to="extras.secretsgroup",
+                    ),
+                ),
+                ("tags", nautobot.core.models.fields.TagsField(through="extras.TaggedItem", to="extras.Tag")),
+                (
+                    "tenant",
+                    models.ForeignKey(
+                        blank=True,
+                        null=True,
+                        on_delete=django.db.models.deletion.PROTECT,
+                        related_name="wireless_networks",
+                        to="tenancy.tenant",
+                    ),
+                ),
+            ],
+            options={
+                "ordering": ["name"],
+            },
+            bases=(
+                nautobot.extras.models.mixins.DynamicGroupMixin,
+                nautobot.extras.models.mixins.NotesMixin,
+                models.Model,
+            ),
+        ),
+        migrations.CreateModel(
+            name="SupportedDataRate",
+            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),
+                ),
+                ("standard", models.CharField(max_length=255)),
+                ("rate", models.PositiveIntegerField()),
+                ("mcs_index", models.IntegerField(blank=True, null=True)),
+                ("tags", nautobot.core.models.fields.TagsField(through="extras.TaggedItem", to="extras.Tag")),
+            ],
+            options={
+                "ordering": ["standard", "rate"],
+                "unique_together": {("standard", "rate")},
+            },
+            bases=(
+                nautobot.extras.models.mixins.DynamicGroupMixin,
+                nautobot.extras.models.mixins.NotesMixin,
+                models.Model,
+            ),
+        ),
+        migrations.CreateModel(
+            name="RadioProfile",
+            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)),
+                ("frequency", models.CharField(blank=True, max_length=255)),
+                ("tx_power_min", models.IntegerField(blank=True, null=True)),
+                ("tx_power_max", models.IntegerField(blank=True, null=True)),
+                (
+                    "channel_width",
+                    nautobot.core.models.fields.JSONArrayField(base_field=models.IntegerField(), blank=True, null=True),
+                ),
+                (
+                    "allowed_channel_list",
+                    nautobot.core.models.fields.JSONArrayField(base_field=models.IntegerField(), blank=True, null=True),
+                ),
+                ("regulatory_domain", models.CharField(max_length=255)),
+                ("rx_power_min", models.IntegerField(blank=True, null=True)),
+                (
+                    "supported_data_rates",
+                    models.ManyToManyField(blank=True, related_name="radio_profiles", to="wireless.supporteddatarate"),
+                ),
+                ("tags", nautobot.core.models.fields.TagsField(through="extras.TaggedItem", to="extras.Tag")),
+            ],
+            options={
+                "ordering": ["name"],
+            },
+            bases=(
+                nautobot.extras.models.mixins.DynamicGroupMixin,
+                nautobot.extras.models.mixins.NotesMixin,
+                models.Model,
+            ),
+        ),
+        migrations.CreateModel(
+            name="ControllerManagedDeviceGroupWirelessNetworkAssignment",
+            fields=[
+                (
+                    "id",
+                    models.UUIDField(
+                        default=uuid.uuid4, editable=False, primary_key=True, serialize=False, unique=True
+                    ),
+                ),
+                (
+                    "controller_managed_device_group",
+                    models.ForeignKey(
+                        on_delete=django.db.models.deletion.CASCADE,
+                        related_name="wireless_network_assignments",
+                        to="dcim.controllermanageddevicegroup",
+                    ),
+                ),
+                (
+                    "vlan",
+                    models.ForeignKey(
+                        blank=True,
+                        null=True,
+                        on_delete=django.db.models.deletion.PROTECT,
+                        related_name="controller_managed_device_group_wireless_network_assignments",
+                        to="ipam.vlan",
+                    ),
+                ),
+                (
+                    "wireless_network",
+                    models.ForeignKey(
+                        on_delete=django.db.models.deletion.CASCADE,
+                        related_name="controller_managed_device_group_assignments",
+                        to="wireless.wirelessnetwork",
+                    ),
+                ),
+            ],
+            options={
+                "ordering": ["controller_managed_device_group", "wireless_network"],
+                "unique_together": {("controller_managed_device_group", "wireless_network")},
+            },
+        ),
+        migrations.CreateModel(
+            name="ControllerManagedDeviceGroupRadioProfileAssignment",
+            fields=[
+                (
+                    "id",
+                    models.UUIDField(
+                        default=uuid.uuid4, editable=False, primary_key=True, serialize=False, unique=True
+                    ),
+                ),
+                (
+                    "controller_managed_device_group",
+                    models.ForeignKey(
+                        on_delete=django.db.models.deletion.CASCADE,
+                        related_name="radio_profile_assignments",
+                        to="dcim.controllermanageddevicegroup",
+                    ),
+                ),
+                (
+                    "radio_profile",
+                    models.ForeignKey(
+                        on_delete=django.db.models.deletion.CASCADE,
+                        related_name="controller_managed_device_group_assignments",
+                        to="wireless.radioprofile",
+                    ),
+                ),
+            ],
+            options={
+                "ordering": ["controller_managed_device_group", "radio_profile"],
+                "unique_together": {("controller_managed_device_group", "radio_profile")},
+            },
+        ),
+    ]