nautobot 2.3.15__tar.gz → 2.3.16__tar.gz

nautobot-2.3.16/PKG-INFO

@@ -0,0 +1,171 @@
+Metadata-Version: 2.1
+Name: nautobot
+Version: 2.3.16
+Summary: Source of truth and network automation platform.
+Home-page: https://nautobot.com
+License: Apache-2.0
+Keywords: Nautobot
+Author: Network to Code
+Author-email: opensource@networktocode.com
+Requires-Python: >=3.8,<3.13
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: Apache Software License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Provides-Extra: all
+Provides-Extra: ldap
+Provides-Extra: mysql
+Provides-Extra: napalm
+Provides-Extra: remote-storage
+Provides-Extra: sso
+Requires-Dist: Django (>=4.2.17,<4.3.0)
+Requires-Dist: GitPython (>=3.1.43,<3.2.0)
+Requires-Dist: Jinja2 (>=3.1.5,<3.2.0)
+Requires-Dist: Markdown (>=3.6,<3.7)
+Requires-Dist: MarkupSafe (>=2.1.5,<2.2.0)
+Requires-Dist: Pillow (>=10.3.0,<10.4.0)
+Requires-Dist: PyYAML (>=6.0.2,<6.1.0)
+Requires-Dist: celery (>=5.3.6,<5.4.0)
+Requires-Dist: django-ajax-tables (>=1.1.1,<1.2.0)
+Requires-Dist: django-auth-ldap (>=4.8.0,<4.9.0) ; extra == "all" or extra == "ldap"
+Requires-Dist: django-celery-beat (>=2.6.0,<2.7.0)
+Requires-Dist: django-celery-results (>=2.5.1,<2.6.0)
+Requires-Dist: django-constance (>=3.1.0,<3.2.0)
+Requires-Dist: django-cors-headers (>=4.4.0,<4.5.0)
+Requires-Dist: django-db-file-storage (>=0.5.6.1,<0.6.0.0)
+Requires-Dist: django-extensions (>=3.2.3,<3.3.0)
+Requires-Dist: django-filter (>=24.2,<24.3)
+Requires-Dist: django-health-check (>=3.18.3,<3.19.0)
+Requires-Dist: django-jinja (>=2.11.0,<2.12.0)
+Requires-Dist: django-prometheus (>=2.3.1,<2.4.0)
+Requires-Dist: django-redis (>=5.4.0,<5.5.0)
+Requires-Dist: django-silk (>=5.1.0,<5.2.0)
+Requires-Dist: django-storages (==1.14.3) ; extra == "all" or extra == "remote-storage"
+Requires-Dist: django-structlog[celery] (>=8.1.0,<9.0.0)
+Requires-Dist: django-tables2 (==2.7.0) ; python_version < "3.9"
+Requires-Dist: django-tables2 (>=2.7.4,<2.8.0) ; python_version >= "3.9"
+Requires-Dist: django-taggit (>=5.0.0,<5.1.0)
+Requires-Dist: django-timezone-field (>=7.0,<7.1)
+Requires-Dist: django-tree-queries (>=0.19.0,<0.20.0)
+Requires-Dist: django-webserver (>=1.2.0,<1.3.0)
+Requires-Dist: djangorestframework (>=3.15.2,<3.16.0)
+Requires-Dist: drf-react-template-framework (>=0.0.17,<0.0.18)
+Requires-Dist: drf-spectacular[sidecar] (>=0.27.2,<0.28.0)
+Requires-Dist: emoji (>=2.12.1,<2.13.0)
+Requires-Dist: graphene-django (>=2.16.0,<2.17.0)
+Requires-Dist: graphene-django-optimizer (>=0.8.0,<0.9.0)
+Requires-Dist: jsonschema (>=4.7.0,<5.0.0)
+Requires-Dist: kombu (>=5.4.2,<5.5.0)
+Requires-Dist: mysqlclient (>=2.2.6,<2.3.0) ; extra == "all" or extra == "mysql"
+Requires-Dist: napalm (>=4.1.0,<6.0.0) ; extra == "all" or extra == "napalm"
+Requires-Dist: netaddr (>=1.3.0,<1.4.0)
+Requires-Dist: netutils (>=1.6.0,<2.0.0)
+Requires-Dist: nh3 (>=0.2.20,<0.3.0)
+Requires-Dist: packaging (>=23.1)
+Requires-Dist: prometheus-client (>=0.20.0,<0.21.0)
+Requires-Dist: psycopg2-binary (>=2.9.10,<2.10.0)
+Requires-Dist: python-slugify (>=8.0.3,<8.1.0)
+Requires-Dist: pyuwsgi (>=2.0.26,<2.1.0)
+Requires-Dist: social-auth-app-django (>=5.4.2,<5.5.0)
+Requires-Dist: social-auth-core[saml] (>=4.5.3,<4.6.0) ; extra == "all" or extra == "sso"
+Requires-Dist: svgwrite (>=1.4.2,<1.5.0)
+Project-URL: Documentation, https://docs.nautobot.com
+Project-URL: Repository, https://github.com/nautobot/nautobot
+Description-Content-Type: text/markdown
+
+# Nautobot
+
+![Nautobot](https://raw.githubusercontent.com/nautobot/nautobot/develop/nautobot/docs/nautobot_logo.svg "Nautobot logo")
+
+Nautobot is a Network Source of Truth and Network Automation Platform built as a web application atop the [Django](https://www.djangoproject.com/) Python framework with a
+[PostgreSQL](https://www.postgresql.org/) or [MySQL](https://www.mysql.com) database.
+
+## Key Use Cases
+
+**1. Flexible Source of Truth for Networking** - Nautobot core data models are used to define the intended state of network infrastructure enabling it as a Source of Truth. While a baseline set of models are provided (such as IP networks and addresses, devices and racks, circuits and cable, etc.) it is Nautobot's goal to offer maximum data model flexibility. This is enabled through features such as user-defined relationships, custom fields on any model, and data validation that permits users to codify everything from naming standards to having automated tests run before data can be populated into Nautobot.
+
+**2. Extensible Data Platform for Automation** - Nautobot has a rich feature set to seamlessly integrate with network automation solutions. Nautobot offers GraphQL and native Git integration along with REST APIs and webhooks. Git integration dynamically loads YAML data files as Nautobot config contexts. Nautobot also has an evolving plugin system that enables users to create custom models, APIs, and UI elements. The plugin system is also used to unify and aggregate disparate data sources creating a Single Source of Truth to streamline data management for network automation.
+
+**3. Platform for Network Automation Apps** - The Nautobot plugin system enables users to create Network Automation Apps. Apps can be as lightweight or robust as needed based on user needs. Using Nautobot for creating custom applications saves up to 70% development time by re-using features such as authentication, permissions, webhooks, GraphQL, change logging, etc. all while having access to the data already stored in Nautobot. Some production ready applications include:
+
+The complete documentation for Nautobot can be found at [Read the Docs](https://docs.nautobot.com/).
+
+Questions? Comments? Start by perusing our [GitHub discussions](https://github.com/nautobot/nautobot/discussions) for the topic you have in mind, or join the **#nautobot** channel on [Network to Code's Slack community](https://slack.networktocode.com/)!
+
+## Build Status
+
+| Branch      | Status |
+|-------------|------------|
+| **[main](https://github.com/nautobot/nautobot/tree/main)** | [![Build Status](https://github.com/nautobot/nautobot/actions/workflows/ci_integration.yml/badge.svg?branch=main)](https://github.com/nautobot/nautobot/actions/workflows/ci_integration.yml) |
+| **[develop](https://github.com/nautobot/nautobot/tree/develop)** | [![Build Status](https://github.com/nautobot/nautobot/actions/workflows/ci_integration.yml/badge.svg?branch=develop)](https://github.com/nautobot/nautobot/actions/workflows/ci_integration.yml) |
+| **[next](https://github.com/nautobot/nautobot/tree/next)** | [![Build Status](https://github.com/nautobot/nautobot/actions/workflows/ci_integration.yml/badge.svg?branch=next)](https://github.com/nautobot/nautobot/actions/workflows/ci_integration.yml) |
+
+## Screenshots
+
+![Gif of main page](https://raw.githubusercontent.com/nautobot/nautobot/develop/nautobot/docs/media/nautobot_mainpage.gif?raw=true "Main page")
+
+---
+
+![Gif of config contexts](https://raw.githubusercontent.com/nautobot/nautobot/develop/nautobot/docs/media/nautobot_config_context.gif?raw=true "Config Contexts")
+
+---
+
+![Gif of prefix hierarchy](https://raw.githubusercontent.com/nautobot/nautobot/develop/nautobot/docs/media/nautobot_prefix_hierarchy.gif?raw=true "Prefix hierarchy")
+
+---
+
+![Gif of GraphQL](https://raw.githubusercontent.com/nautobot/nautobot/develop/nautobot/docs/media/nautobot_graphql.gif?raw=true "GraphQL API")
+
+---
+
+![Gif of Modes](https://raw.githubusercontent.com/nautobot/nautobot/develop/nautobot/docs/media/nautobot_modes.gif?raw=true "Modes")
+
+## Installation
+
+Please see [the documentation](https://docs.nautobot.com/projects/core/en/stable/user-guide/administration/installation/) for instructions on installing Nautobot.
+
+## Application Stack
+
+Below is a simplified overview of the Nautobot application stack for reference:
+
+![Application stack diagram](https://raw.githubusercontent.com/nautobot/nautobot/develop/nautobot/docs/media/nautobot_application_stack_high_level.png "Application stack diagram")
+
+## Plugins and Extensibility
+
+Nautobot offers the ability to customize your setup to better align with your direct business needs. It does so through the use of various plugins that have been developed for network automation, and are designed to be used in environments where needed.
+
+There are many plugins available within the Nautobot Apps ecosystem. The below screenshots are an example of some popular ones that are currently available.
+
+### Plugin Screenshots
+
+#### Golden Config Plugin
+
+![Gif of golden config](https://raw.githubusercontent.com/nautobot/nautobot/develop/nautobot/docs/media/nautobot_golden_config.gif?raw=true "Golden config")
+
+#### ChatOps Plugin
+
+![Gif of chatops](https://raw.githubusercontent.com/nautobot/nautobot/develop/nautobot/docs/media/nautobot_chatops.gif?raw=true "ChatOps")
+
+#### Device Lifecycle Management Plugin
+
+![Gif of DLM](https://raw.githubusercontent.com/nautobot/nautobot/develop/nautobot/docs/media/nautobot_device_lifecycle_management.gif?raw=true "Device Lifecycle Management")
+
+## Providing Feedback
+
+The best platform for general feedback, assistance, and other discussion is our [GitHub discussions](https://github.com/nautobot/nautobot/discussions). To report a bug or request a specific feature, please open a GitHub issue using the [appropriate template](https://github.com/nautobot/nautobot/issues/new/choose).
+
+If you are interested in contributing to the development of Nautobot, please read our [contributing guide](https://docs.nautobot.com/projects/core/en/stable/development/core/#contributing) prior to beginning any work.
+
+## Related projects
+
+Please check out [the GitHub `nautobot` topic](https://github.com/topics/nautobot) for a list of relevant community projects.
+
+## Notices
+
+> Nautobot was initially developed as a fork of NetBox (v2.10.4).  NetBox was originally developed by Jeremy Stretch at DigitalOcean and the NetBox Community.
+

nautobot-2.3.16/nautobot/circuits/views.py

@@ -0,0 +1,283 @@
+from django.contrib import messages
+from django.db import transaction
+from django.db.models import Q
+from django.shortcuts import get_object_or_404, redirect, render
+from django_tables2 import RequestConfig
+
+from nautobot.core.forms import ConfirmationForm
+from nautobot.core.views import generic, mixins as view_mixins
+from nautobot.core.views.paginator import EnhancedPaginator, get_paginate_count
+from nautobot.core.views.viewsets import NautobotUIViewSet
+
+from . import filters, forms, tables
+from .api import serializers
+from .choices import CircuitTerminationSideChoices
+from .models import Circuit, CircuitTermination, CircuitType, Provider, ProviderNetwork
+
+
+class CircuitTypeUIViewSet(
+    view_mixins.ObjectDetailViewMixin,
+    view_mixins.ObjectListViewMixin,
+    view_mixins.ObjectEditViewMixin,
+    view_mixins.ObjectDestroyViewMixin,
+    view_mixins.ObjectBulkDestroyViewMixin,
+    view_mixins.ObjectBulkCreateViewMixin,  # 3.0 TODO: remove this mixin as it's no longer used
+    view_mixins.ObjectChangeLogViewMixin,
+    view_mixins.ObjectNotesViewMixin,
+):
+    filterset_class = filters.CircuitTypeFilterSet
+    filterset_form_class = forms.CircuitTypeFilterForm
+    form_class = forms.CircuitTypeForm
+    queryset = CircuitType.objects.all()
+    serializer_class = serializers.CircuitTypeSerializer
+    table_class = tables.CircuitTypeTable
+
+    def get_extra_context(self, request, instance):
+        # Circuits
+        context = super().get_extra_context(request, instance)
+        if self.action == "retrieve":
+            circuits = (
+                Circuit.objects.restrict(request.user, "view")
+                .filter(circuit_type=instance)
+                .select_related("circuit_type", "tenant")
+                .prefetch_related("circuit_terminations__location")
+            )
+
+            circuits_table = tables.CircuitTable(circuits)
+            circuits_table.columns.hide("circuit_type")
+
+            paginate = {
+                "paginator_class": EnhancedPaginator,
+                "per_page": get_paginate_count(request),
+            }
+            RequestConfig(request, paginate).configure(circuits_table)
+            context["circuits_table"] = circuits_table
+        return context
+
+
+class CircuitTerminationUIViewSet(
+    view_mixins.ObjectDetailViewMixin,
+    view_mixins.ObjectListViewMixin,
+    view_mixins.ObjectEditViewMixin,
+    view_mixins.ObjectDestroyViewMixin,
+    view_mixins.ObjectBulkDestroyViewMixin,
+    view_mixins.ObjectBulkCreateViewMixin,  # 3.0 TODO: remove this mixin as it's no longer used
+    view_mixins.ObjectChangeLogViewMixin,
+    view_mixins.ObjectNotesViewMixin,
+):
+    action_buttons = ("import", "export")
+    filterset_class = filters.CircuitTerminationFilterSet
+    filterset_form_class = forms.CircuitTerminationFilterForm
+    form_class = forms.CircuitTerminationForm
+    queryset = CircuitTermination.objects.all()
+    serializer_class = serializers.CircuitTerminationSerializer
+    table_class = tables.CircuitTerminationTable
+
+    def get_object(self):
+        obj = super().get_object()
+        if self.action in ["create", "update"] and "circuit" in self.kwargs:
+            obj.circuit = get_object_or_404(Circuit, pk=self.kwargs["circuit"])
+        return obj
+
+    def get_return_url(self, request, obj=None, default_return_url=None):
+        if obj is not None and obj.present_in_database and obj.pk:
+            return super().get_return_url(request, obj=obj.circuit, default_return_url=default_return_url)
+
+        return super().get_return_url(request, obj=obj, default_return_url=default_return_url)
+
+
+class ProviderUIViewSet(NautobotUIViewSet):
+    bulk_update_form_class = forms.ProviderBulkEditForm
+    filterset_class = filters.ProviderFilterSet
+    filterset_form_class = forms.ProviderFilterForm
+    form_class = forms.ProviderForm
+    queryset = Provider.objects.all()
+    serializer_class = serializers.ProviderSerializer
+    table_class = tables.ProviderTable
+
+    def get_extra_context(self, request, instance):
+        context = super().get_extra_context(request, instance)
+        if self.action == "retrieve":
+            circuits = (
+                Circuit.objects.restrict(request.user, "view")
+                .filter(provider=instance)
+                .select_related("circuit_type", "tenant")
+                .prefetch_related("circuit_terminations__location")
+            )
+            circuits_table = tables.CircuitTable(circuits)
+            circuits_table.columns.hide("provider")
+
+            paginate = {
+                "paginator_class": EnhancedPaginator,
+                "per_page": get_paginate_count(request),
+            }
+            RequestConfig(request, paginate).configure(circuits_table)
+
+            context["circuits_table"] = circuits_table
+        return context
+
+
+class CircuitUIViewSet(NautobotUIViewSet):
+    bulk_update_form_class = forms.CircuitBulkEditForm
+    filterset_class = filters.CircuitFilterSet
+    filterset_form_class = forms.CircuitFilterForm
+    form_class = forms.CircuitForm
+    # v2 TODO(jathan): Replace prefetch_related with select_related
+    prefetch_related = ["provider", "circuit_type", "tenant", "circuit_termination_a", "circuit_termination_z"]
+    queryset = Circuit.objects.all()
+    serializer_class = serializers.CircuitSerializer
+    table_class = tables.CircuitTable
+    # NOTE: This is how `NautobotUIViewSet` would define use_new_ui attr
+    # use_new_ui = ["list", "retrieve"]
+
+    def get_extra_context(self, request, instance):
+        context = super().get_extra_context(request, instance)
+        if self.action == "retrieve":
+            # A-side termination
+            circuit_termination_a = (
+                CircuitTermination.objects.restrict(request.user, "view")
+                .select_related("location")
+                .filter(circuit=instance, term_side=CircuitTerminationSideChoices.SIDE_A)
+                .first()
+            )
+            if (
+                circuit_termination_a
+                and circuit_termination_a.connected_endpoint
+                and hasattr(circuit_termination_a.connected_endpoint, "ip_addresses")
+            ):
+                circuit_termination_a.ip_addresses = circuit_termination_a.connected_endpoint.ip_addresses.restrict(
+                    request.user, "view"
+                )
+
+            # Z-side termination
+            circuit_termination_z = (
+                CircuitTermination.objects.restrict(request.user, "view")
+                .select_related("location")
+                .filter(circuit=instance, term_side=CircuitTerminationSideChoices.SIDE_Z)
+                .first()
+            )
+            if (
+                circuit_termination_z
+                and circuit_termination_z.connected_endpoint
+                and hasattr(circuit_termination_z.connected_endpoint, "ip_addresses")
+            ):
+                circuit_termination_z.ip_addresses = circuit_termination_z.connected_endpoint.ip_addresses.restrict(
+                    request.user, "view"
+                )
+
+            context["circuit_termination_a"] = circuit_termination_a
+            context["circuit_termination_z"] = circuit_termination_z
+        return context
+
+
+class ProviderNetworkUIViewSet(NautobotUIViewSet):
+    model = ProviderNetwork
+    bulk_update_form_class = forms.ProviderNetworkBulkEditForm
+    filterset_class = filters.ProviderNetworkFilterSet
+    filterset_form_class = forms.ProviderNetworkFilterForm
+    form_class = forms.ProviderNetworkForm
+    queryset = ProviderNetwork.objects.all()
+    serializer_class = serializers.ProviderNetworkSerializer
+    table_class = tables.ProviderNetworkTable
+
+    def get_extra_context(self, request, instance):
+        context = super().get_extra_context(request, instance)
+        if self.action == "retrieve":
+            circuits = (
+                Circuit.objects.restrict(request.user, "view")
+                .filter(
+                    Q(circuit_termination_a__provider_network=instance.pk)
+                    | Q(circuit_termination_z__provider_network=instance.pk)
+                )
+                .select_related("circuit_type", "tenant")
+                .prefetch_related("circuit_terminations__location")
+            )
+
+            circuits_table = tables.CircuitTable(circuits)
+            circuits_table.columns.hide("circuit_termination_a")
+            circuits_table.columns.hide("circuit_termination_z")
+
+            paginate = {"paginator_class": EnhancedPaginator, "per_page": get_paginate_count(request)}
+            RequestConfig(request, paginate).configure(circuits_table)
+
+            context["circuits_table"] = circuits_table
+        return context
+
+
+class CircuitSwapTerminations(generic.ObjectEditView):
+    """
+    Swap the A and Z terminations of a circuit.
+    """
+
+    queryset = Circuit.objects.all()
+
+    def get(self, request, *args, **kwargs):
+        circuit = get_object_or_404(self.queryset, pk=kwargs["pk"])
+        form = ConfirmationForm()
+
+        # Circuit must have at least one termination to swap
+        if not circuit.circuit_termination_a and not circuit.circuit_termination_z:
+            messages.error(
+                request,
+                f"No terminations have been defined for circuit {circuit}.",
+            )
+            return redirect("circuits:circuit", pk=circuit.pk)
+
+        return render(
+            request,
+            "circuits/circuit_terminations_swap.html",
+            {
+                "circuit": circuit,
+                "circuit_termination_a": circuit.circuit_termination_a,
+                "circuit_termination_z": circuit.circuit_termination_z,
+                "form": form,
+                "panel_class": "default",
+                "button_class": "primary",
+                "return_url": circuit.get_absolute_url(),
+            },
+        )
+
+    def post(self, request, *args, **kwargs):
+        circuit = get_object_or_404(self.queryset, pk=kwargs["pk"])
+        form = ConfirmationForm(request.POST)
+
+        if form.is_valid():
+            circuit_termination_a = CircuitTermination.objects.filter(
+                circuit=circuit, term_side=CircuitTerminationSideChoices.SIDE_A
+            ).first()
+            circuit_termination_z = CircuitTermination.objects.filter(
+                circuit=circuit, term_side=CircuitTerminationSideChoices.SIDE_Z
+            ).first()
+
+            if circuit_termination_a and circuit_termination_z:
+                # Use a placeholder to avoid an IntegrityError on the (circuit, term_side) unique constraint
+                with transaction.atomic():
+                    circuit_termination_a.term_side = "_"
+                    circuit_termination_a.save()
+                    circuit_termination_z.term_side = "A"
+                    circuit_termination_z.save()
+                    circuit_termination_a.term_side = "Z"
+                    circuit_termination_a.save()
+            elif circuit_termination_a:
+                circuit_termination_a.term_side = "Z"
+                circuit_termination_a.save()
+            else:
+                circuit_termination_z.term_side = "A"
+                circuit_termination_z.save()
+
+            messages.success(request, f"Swapped terminations for circuit {circuit}.")
+            return redirect("circuits:circuit", pk=circuit.pk)
+
+        return render(
+            request,
+            "circuits/circuit_terminations_swap.html",
+            {
+                "circuit": circuit,
+                "circuit_termination_a": circuit.circuit_termination_a,
+                "circuit_termination_z": circuit.circuit_termination_z,
+                "form": form,
+                "panel_class": "default",
+                "button_class": "primary",
+                "return_url": circuit.get_absolute_url(),
+            },
+        )