nautobot 2.4.17__tar.gz → 2.4.18__tar.gz

nautobot-2.4.18/PKG-INFO

@@ -0,0 +1,169 @@
+Metadata-Version: 2.1
+Name: nautobot
+Version: 2.4.18
+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.9.2,<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.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.9
+Provides-Extra: all
+Provides-Extra: ldap
+Provides-Extra: mysql
+Provides-Extra: napalm
+Provides-Extra: remote-storage
+Provides-Extra: sso
+Requires-Dist: Django (>=4.2.24,<4.3.0)
+Requires-Dist: GitPython (>=3.1.45,<3.2.0)
+Requires-Dist: Jinja2 (>=3.1.6,<3.2.0)
+Requires-Dist: Markdown (>=3.8.2,<3.9.0)
+Requires-Dist: Pillow (>=11.0,<12.0)
+Requires-Dist: PyYAML (>=6.0.2,<6.1.0)
+Requires-Dist: celery (>=5.3.6,<5.6.0)
+Requires-Dist: cryptography (>=45.0.7,<45.1.0)
+Requires-Dist: django-ajax-tables (>=1.1.1,<1.2.0)
+Requires-Dist: django-auth-ldap (>=5.2.0,<5.3.0) ; extra == "all" or extra == "ldap"
+Requires-Dist: django-celery-beat (>=2.7.0,<2.8.0)
+Requires-Dist: django-celery-results (>=2.6.0,<2.7.0)
+Requires-Dist: django-constance (>=4.3.2,<4.4.0)
+Requires-Dist: django-cors-headers (>=4.7.0,<4.8.0)
+Requires-Dist: django-db-file-storage (>=0.5.6.1,<0.6.0.0)
+Requires-Dist: django-extensions (>=4.1,<4.2)
+Requires-Dist: django-filter (>=25.1,<25.2)
+Requires-Dist: django-health-check (>=3.20.0,<3.21.0)
+Requires-Dist: django-jinja (>=2.11.0,<2.12.0)
+Requires-Dist: django-prometheus (>=2.4.1,<2.5.0)
+Requires-Dist: django-redis (>=6.0.0,<6.1.0)
+Requires-Dist: django-silk (>=5.4.3,<5.5.0)
+Requires-Dist: django-storages (>=1.14.6,<1.15.0) ; extra == "all" or extra == "remote-storage"
+Requires-Dist: django-structlog[celery] (>=9.1.1,<10.0.0)
+Requires-Dist: django-tables2 (>=2.7.5,<2.8.0)
+Requires-Dist: django-taggit (>=6.1.0,<6.2.0)
+Requires-Dist: django-timezone-field (>=7.1,<7.2)
+Requires-Dist: django-tree-queries (>=0.20.0,<0.21.0)
+Requires-Dist: django-webserver (>=1.2.0,<1.3.0)
+Requires-Dist: djangorestframework (>=3.15.2,<3.17.0)
+Requires-Dist: drf-spectacular[sidecar] (>=0.28.0,<0.29.0)
+Requires-Dist: emoji (>=2.14.1,<2.15.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.6.0)
+Requires-Dist: kubernetes (>=33.1.0,<34.0.0)
+Requires-Dist: mysqlclient (>=2.2.7,<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.14.0,<2.0.0)
+Requires-Dist: nh3 (>=0.3.0,<0.4.0)
+Requires-Dist: packaging (>=23.1)
+Requires-Dist: prometheus-client (>=0.22.1,<0.23.0)
+Requires-Dist: psycopg2-binary (>=2.9.10,<2.10.0)
+Requires-Dist: python-slugify (>=8.0.4,<8.1.0)
+Requires-Dist: pyuwsgi (>=2.0.30,<2.1.0)
+Requires-Dist: social-auth-app-django (>=5.4.3,<5.5.0)
+Requires-Dist: social-auth-core[saml] (>=4.7.0,<4.8.0) ; extra == "all" or extra == "sso"
+Requires-Dist: svgwrite (>=1.4.3,<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.4.18/nautobot/apps/views.py

@@ -0,0 +1,91 @@
+"""Utilities for apps to implement UI views."""
+
+from nautobot.core.views.generic import (
+    BulkComponentCreateView,
+    BulkCreateView,
+    BulkDeleteView,
+    BulkEditView,
+    BulkImportView,  # 3.0 TODO: deprecated, will be removed in 3.0
+    BulkRenameView,
+    ComponentCreateView,
+    GenericView,
+    ObjectDeleteView,
+    ObjectEditView,
+    ObjectImportView,
+    ObjectListView,
+    ObjectView,
+)
+from nautobot.core.views.mixins import (
+    AdminRequiredMixin,
+    ContentTypePermissionRequiredMixin,
+    GetReturnURLMixin,
+    NautobotViewSetMixin,
+    ObjectBulkCreateViewMixin,  # 3.0 TODO: deprecated, will be removed in 3.0
+    ObjectBulkDestroyViewMixin,
+    ObjectBulkUpdateViewMixin,
+    ObjectChangeLogViewMixin,
+    ObjectDestroyViewMixin,
+    ObjectDetailViewMixin,
+    ObjectEditViewMixin,
+    ObjectListViewMixin,
+    ObjectNotesViewMixin,
+    ObjectPermissionRequiredMixin,
+    UIComponentsMixin,
+)
+from nautobot.core.views.paginator import EnhancedPage, EnhancedPaginator, get_paginate_count
+from nautobot.core.views.renderers import NautobotHTMLRenderer
+from nautobot.core.views.utils import (
+    check_filter_for_display,
+    csv_format,
+    get_csv_form_fields_from_serializer_class,
+    get_obj_from_context,
+    handle_protectederror,
+    prepare_cloned_fields,
+)
+from nautobot.core.views.viewsets import NautobotUIViewSet
+from nautobot.extras.views import check_and_call_git_repository_function, ObjectDynamicGroupsView, ObjectNotesView
+
+__all__ = (
+    "AdminRequiredMixin",
+    "BulkComponentCreateView",
+    "BulkCreateView",
+    "BulkDeleteView",
+    "BulkEditView",
+    "BulkImportView",  # 3.0 TODO: remove this
+    "BulkRenameView",
+    "ComponentCreateView",
+    "ContentTypePermissionRequiredMixin",
+    "EnhancedPage",
+    "EnhancedPaginator",
+    "GenericView",
+    "GetReturnURLMixin",
+    "NautobotHTMLRenderer",
+    "NautobotUIViewSet",
+    "NautobotViewSetMixin",
+    "ObjectBulkCreateViewMixin",  # 3.0 TODO: remove this
+    "ObjectBulkDestroyViewMixin",
+    "ObjectBulkUpdateViewMixin",
+    "ObjectChangeLogViewMixin",
+    "ObjectDeleteView",
+    "ObjectDestroyViewMixin",
+    "ObjectDetailViewMixin",
+    "ObjectDynamicGroupsView",
+    "ObjectEditView",
+    "ObjectEditViewMixin",
+    "ObjectImportView",
+    "ObjectListView",
+    "ObjectListViewMixin",
+    "ObjectNotesView",
+    "ObjectNotesViewMixin",
+    "ObjectPermissionRequiredMixin",
+    "ObjectView",
+    "UIComponentsMixin",
+    "check_and_call_git_repository_function",
+    "check_filter_for_display",
+    "csv_format",
+    "get_csv_form_fields_from_serializer_class",
+    "get_obj_from_context",
+    "get_paginate_count",
+    "handle_protectederror",
+    "prepare_cloned_fields",
+)

nautobot-2.4.18/nautobot/circuits/templates/circuits/inc/circuit_termination_speed_fragment.html

@@ -0,0 +1,9 @@
+{% spaceless %}
+{% load helpers %}
+{% if termination.port_speed and termination.upstream_speed %}
+<i class="mdi mdi-arrow-down-bold" title="Downstream"></i>{{ termination.port_speed|humanize_speed }}&nbsp;
+<i class="mdi mdi-arrow-up-bold" title="Upstream"></i>{{ termination.upstream_speed|humanize_speed }}
+{% else %}
+{{ termination.port_speed|humanize_speed|placeholder }}
+{% endif %}
+{% endspaceless %}

nautobot-2.4.18/nautobot/circuits/tests/integration/test_circuit.py

@@ -0,0 +1,135 @@
+from django.contrib.contenttypes.models import ContentType
+from django.urls import reverse
+
+from nautobot.circuits.models import Circuit, CircuitTermination, CircuitType, Provider
+from nautobot.core.testing.integration import ObjectDetailsMixin, ObjectsListMixin, SeleniumTestCase
+from nautobot.dcim.models import Location, LocationType
+from nautobot.extras.models import Status
+from nautobot.tenancy.models import Tenant, TenantGroup
+
+
+class CircuitTestCase(SeleniumTestCase, ObjectsListMixin, ObjectDetailsMixin):
+    """
+    Integration test to check circuits related test cases.
+    """
+
+    def setUp(self):
+        super().setUp()
+        self.login_as_superuser()
+
+        # Termination requirements
+        location_type, location_created = LocationType.objects.get_or_create(name="Circuit at Home")
+        if location_created:
+            location_ct = ContentType.objects.get_for_model(CircuitTermination)
+            location_type.content_types.set([location_ct])
+            location_type.save()
+
+        location_status = Status.objects.get_for_model(Location).first()
+        self.location, _ = Location.objects.get_or_create(
+            name="A Test Location",
+            status=location_status,
+            location_type=location_type,
+        )
+
+        self.provider, _ = Provider.objects.get_or_create(name="World Best Cables")
+        self.circuit_type, _ = CircuitType.objects.get_or_create(
+            name="Yellow Cable",
+        )
+        self.tenant_group, _ = TenantGroup.objects.get_or_create(name="Family Inc.")
+        self.tenant, _ = Tenant.objects.get_or_create(name="Tenant 1", tenant_group=self.tenant_group)
+
+    def create_circuit(self, name):
+        circuit, _ = Circuit.objects.get_or_create(
+            provider=self.provider,
+            cid=name,
+            circuit_type=self.circuit_type,
+            status=Status.objects.get_for_model(Circuit).first(),
+        )
+        return circuit
+
+    def test_circuit_create(self):
+        cid = "Circuit-test-abc123"
+        description = "My Precious Circuit"
+
+        # Create new Circuit from list view
+        self.click_navbar_entry("Circuits", "Circuits")
+        self.assertEqual(self.browser.url, self.live_server_url + reverse("circuits:circuit_list"))
+
+        self.click_list_view_add_button()
+        self.assertEqual(self.browser.url, self.live_server_url + reverse("circuits:circuit_add"))
+
+        # Fill Circuit creation form
+        self.fill_select2_field("provider", self.provider.name)
+        self.browser.fill("cid", cid)
+        self.fill_select2_field("circuit_type", self.circuit_type.name)
+        self.fill_select2_field("status", "")  # pick first status
+        self.browser.fill("install_date", "2025-01-01")
+        self.browser.fill("commit_rate", 192)
+        self.browser.fill("description", "My Precious Circuit")
+        self.fill_select2_field("tenant_group", "Family Inc.")
+        self.fill_select2_field("tenant", "Tenant 1")
+
+        self.click_edit_form_create_button()
+        self.assertTrue(self.browser.is_text_present("Created circuit Circuit-test-abc123"))
+
+        # Navigate to Circuit details by filtering the one just created and clicking on it
+        self.click_navbar_entry("Circuits", "Circuits")
+        self.assertEqual(self.browser.url, self.live_server_url + reverse("circuits:circuit_list"))
+
+        self.apply_filter("circuit_type", "Yellow Cable")
+        self.assertEqual(self.objects_list_visible_items, 1)
+
+        self.click_table_link()
+
+        # Assert that value are properly set
+        circuit = Circuit.objects.get(cid=cid)
+        self.assertIn(self.live_server_url + reverse("circuits:circuit", kwargs={"pk": circuit.pk}), self.browser.url)
+
+        self.assertPanelValue("Circuit", "Circuit ID", cid)
+        self.assertPanelValue("Circuit", "Status", "Active")
+        self.assertPanelValue("Circuit", "Provider", self.provider.name)
+        self.assertPanelValue("Circuit", "Circuit Type", self.circuit_type.name)
+        self.assertPanelValue("Circuit", "Tenant", self.tenant.name)
+        self.assertPanelValue("Circuit", "Date Installed", "Jan. 1, 2025")
+        self.assertPanelValue("Circuit", "Commit Rate (Kbps)", "192")
+        self.assertPanelValue("Circuit", "Description", description)
+
+    def test_circuit_create_termination(self):
+        circuit = self.create_circuit("Circuit-test-termination")
+        sides = ["A", "Z"]
+        for side in sides:
+            with self.subTest(side=side):
+                # Go to Circuit details page
+                details_url = self.live_server_url + reverse("circuits:circuit", kwargs={"pk": circuit.pk})
+                self.browser.visit(details_url)
+                self.assertIn(details_url, self.browser.url)
+
+                # Find and click add termination button
+                termination_panel_xpath = f'//*[@id="main"]//div[@class="panel-heading"][contains(normalize-space(), "Termination - {side} Side")]'
+                self.browser.find_by_xpath(f'{termination_panel_xpath}//a[normalize-space()="Add"]').click()
+
+                port_speed = ord(side)
+                upstream_speed = ord(side) + 10
+                xconnect_id = f"xconnect-id-{side}-123"
+                pp_info = f"pp-info-{side}-123"
+                description = f"{side}-side"
+
+                # Fill termination creation form
+                self.fill_select2_field("location", self.location.name)
+                self.browser.fill("port_speed", port_speed)
+                self.browser.fill("upstream_speed", upstream_speed)
+                self.browser.fill("xconnect_id", xconnect_id)
+                self.browser.fill("pp_info", pp_info)
+                self.browser.fill("description", description)
+                self.click_edit_form_create_button()
+
+                self.assertTrue(self.browser.is_text_present(f"Created circuit termination Termination {side}"))
+
+                # Assert that value are properly set
+                panel_label = f"Termination - {side} Side"
+                self.assertPanelValue(panel_label, "Location", self.location.name)
+                self.assertPanelValue(panel_label, "Speed", port_speed)
+                self.assertPanelValue(panel_label, "Speed", upstream_speed)
+                self.assertPanelValue(panel_label, "Cross-connect ID", xconnect_id)
+                self.assertPanelValue(panel_label, "Patch Panel/port(s)", pp_info)
+                self.assertPanelValue(panel_label, "Description", description)