nautobot 2.3.0__py3-none-any.whl → 2.3.1__py3-none-any.whl

nautobot/ipam/tests/test_models.py

@@ -962,6 +962,92 @@ class TestIPAddress(ModelTestCases.BaseModelTestCase):
         self.status = Status.objects.get(name="Active")
         self.prefix = Prefix.objects.create(prefix="192.0.2.0/24", status=self.status, namespace=self.namespace)
 
+    def test_get_or_create(self):
+        """Assert `get_or_create` method to permit specifying a namespace as an alternative to a parent prefix."""
+        default_namespace = get_default_namespace()
+        namespace = Namespace.objects.create(name="Test Namespace")
+
+        ipaddr_status = Status.objects.get_for_model(IPAddress).first()
+        prefix_status = Status.objects.get_for_model(Prefix).first()
+
+        parent = Prefix.objects.create(prefix="10.1.1.0/24", namespace=namespace, status=prefix_status)
+        default_namespace_parent = Prefix.objects.create(
+            prefix="10.0.0.0/24", namespace=default_namespace, status=prefix_status
+        )
+
+        ipaddress = IPAddress.objects.create(address="10.1.1.1/24", namespace=namespace, status=ipaddr_status)
+        default_namespace_ipaddress = IPAddress.objects.create(
+            address="10.0.0.1/24", namespace=default_namespace, status=ipaddr_status
+        )
+        mask_length = 24
+
+        with self.subTest("Assert retrieve"):
+            ip_obj, created = IPAddress.objects.get_or_create(
+                host=ipaddress.host,
+                mask_length=mask_length,
+                namespace=namespace,
+                status=ipaddr_status,
+            )
+            self.assertEqual(ip_obj, ipaddress)
+            self.assertFalse(created)
+
+            ip_obj, created = IPAddress.objects.get_or_create(host=ipaddress.host, status=ipaddr_status)
+            self.assertEqual(ip_obj.status, ipaddr_status)
+            self.assertFalse(created)
+
+        with self.subTest(
+            "Assert get_or_create utilizes default namespace when retrieving parent if no namespace is provided"
+        ):
+            ip_obj, created = IPAddress.objects.get_or_create(
+                host=default_namespace_ipaddress.host,
+                mask_length=default_namespace_ipaddress.mask_length,
+                status=ipaddr_status,
+            )
+            self.assertEqual(ip_obj, default_namespace_ipaddress)
+            self.assertFalse(created)
+
+        with self.subTest("Assert create"):
+            new_host = "10.0.0.2"
+            ip_obj, created = IPAddress.objects.get_or_create(
+                host=new_host,
+                mask_length=mask_length,
+                status=ipaddr_status,
+            )
+            self.assertEqual(ip_obj.host, new_host)
+            self.assertEqual(ip_obj.mask_length, mask_length)
+            self.assertEqual(ip_obj.parent, default_namespace_parent)
+            self.assertEqual(ip_obj.parent.namespace, default_namespace)
+            self.assertTrue(created)
+
+        with self.subTest("Assert create explicitly defining a non default namespace"):
+            new_host = "10.1.1.2"
+            ip_obj, created = IPAddress.objects.get_or_create(
+                host=new_host, mask_length=mask_length, status=ipaddr_status, namespace=namespace
+            )
+            self.assertEqual(ip_obj.host, new_host)
+            self.assertEqual(ip_obj.mask_length, mask_length)
+            self.assertEqual(ip_obj.parent, parent)
+            self.assertEqual(ip_obj.parent.namespace, namespace)
+            self.assertTrue(created)
+
+        with self.subTest("Assert passing invalid host/mask_length"):
+            with self.assertRaises(ValidationError) as err:
+                IPAddress.objects.get_or_create(
+                    host="0.000.0", mask_length=mask_length, status=ipaddr_status, namespace=namespace
+                )
+            self.assertIn(
+                "Enter a valid IPv4 or IPv6 address.",
+                str(err.exception),
+            )
+            with self.assertRaises(ValidationError) as err:
+                IPAddress.objects.get_or_create(
+                    host=ipaddress.host, mask_length=5712, status=ipaddr_status, namespace=namespace
+                )
+            self.assertIn(
+                f"{ipaddress.host}/5712 does not appear to be an IPv4 or IPv6 network.",
+                str(err.exception),
+            )
+
     def test_create_field_population(self):
         """Test that the various ways of creating an IPAddress result in correctly populated fields."""
         if self.namespace != get_default_namespace():

nautobot/ipam/views.py

@@ -250,7 +250,7 @@ class VRFView(generic.ObjectView):
 
         prefixes = instance.prefixes.restrict(request.user, "view")
         prefix_count = prefixes.count()
-        prefix_table = tables.PrefixTable(prefixes.select_related("namespace"))
+        prefix_table = tables.PrefixTable(prefixes.select_related("namespace"), hide_hierarchy_ui=True)
 
         # devices = instance.devices.restrict(request.user, "view")
         # device_count = devices.count()
@@ -390,7 +390,7 @@ class RIRView(generic.ObjectView):
         # Prefixes
         assigned_prefixes = Prefix.objects.restrict(request.user, "view").filter(rir=instance).select_related("tenant")
 
-        assigned_prefix_table = tables.PrefixTable(assigned_prefixes)
+        assigned_prefix_table = tables.PrefixTable(assigned_prefixes, hide_hierarchy_ui=True)
 
         paginate = {
             "paginator_class": EnhancedPaginator,
@@ -485,7 +485,7 @@ class PrefixPrefixesView(generic.ObjectView):
         if child_prefixes and request.GET.get("show_available", "true") == "true":
             child_prefixes = add_available_prefixes(instance.prefix, child_prefixes)
 
-        prefix_table = tables.PrefixDetailTable(child_prefixes)
+        prefix_table = tables.PrefixDetailTable(child_prefixes, hide_hierarchy_ui=True)
         prefix_table.exclude = ("namespace",)
         if request.user.has_perm("ipam.change_prefix") or request.user.has_perm("ipam.delete_prefix"):
             prefix_table.columns.show("pk")
@@ -1313,7 +1313,7 @@ class VLANView(generic.ObjectView):
                 "namespace",
             )
         )
-        prefix_table = tables.PrefixTable(list(prefixes))
+        prefix_table = tables.PrefixTable(list(prefixes), hide_hierarchy_ui=True)
         prefix_table.exclude = ("vlan",)
 
         return {"prefix_table": prefix_table, **super().get_extra_context(request, instance)}

nautobot/project-static/docs/code-reference/nautobot/apps/filters.html

@@ -7296,21 +7296,6 @@
     </span>
   </a>
   
-    <nav class="md-nav" aria-label="TagFilter">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#nautobot.apps.filters.TagFilter.__init__" class="md-nav__link">
-    <span class="md-ellipsis">
-      __init__
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
 </li>
       
         <li class="md-nav__item">
@@ -9368,21 +9353,6 @@
     </span>
   </a>
   
-    <nav class="md-nav" aria-label="TagFilter">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#nautobot.apps.filters.TagFilter.__init__" class="md-nav__link">
-    <span class="md-ellipsis">
-      __init__
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
 </li>
       
         <li class="md-nav__item">
@@ -10636,21 +10606,6 @@ to objects matching all tags.</p>
 
 
 
-<div class="doc doc-object doc-function">
-
-
-<h3 id="nautobot.apps.filters.TagFilter.__init__" class="doc doc-heading">
-            <code class="highlight language-python"><span class="fm">__init__</span><span class="p">(</span><span class="o">*</span><span class="n">args</span><span class="p">,</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">)</span></code>
-
-<a href="#nautobot.apps.filters.TagFilter.__init__" class="headerlink" title="Permanent link">&para;</a></h3>
-
-
-    <div class="doc doc-contents ">
-
-    </div>
-
-</div>
-
 
 
   </div>

nautobot/project-static/docs/code-reference/nautobot/apps/forms.html

@@ -7305,21 +7305,6 @@
     </span>
   </a>
   
-    <nav class="md-nav" aria-label="DynamicFilterForm">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#nautobot.apps.forms.DynamicFilterForm.__init__" class="md-nav__link">
-    <span class="md-ellipsis">
-      __init__
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
 </li>
       
         <li class="md-nav__item">
@@ -7803,21 +7788,6 @@
     </span>
   </a>
   
-    <nav class="md-nav" aria-label="TagFilterField">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#nautobot.apps.forms.TagFilterField.__init__" class="md-nav__link">
-    <span class="md-ellipsis">
-      __init__
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
 </li>
       
         <li class="md-nav__item">
@@ -9881,21 +9851,6 @@
     </span>
   </a>
   
-    <nav class="md-nav" aria-label="DynamicFilterForm">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#nautobot.apps.forms.DynamicFilterForm.__init__" class="md-nav__link">
-    <span class="md-ellipsis">
-      __init__
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
 </li>
       
         <li class="md-nav__item">
@@ -10379,21 +10334,6 @@
     </span>
   </a>
   
-    <nav class="md-nav" aria-label="TagFilterField">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#nautobot.apps.forms.TagFilterField.__init__" class="md-nav__link">
-    <span class="md-ellipsis">
-      __init__
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
 </li>
       
         <li class="md-nav__item">
@@ -11651,21 +11591,6 @@ part of a JSON/YAML DeviceType import.</p>
 
 
 
-<div class="doc doc-object doc-function">
-
-
-<h3 id="nautobot.apps.forms.DynamicFilterForm.__init__" class="doc doc-heading">
-            <code class="highlight language-python"><span class="fm">__init__</span><span class="p">(</span><span class="o">*</span><span class="n">args</span><span class="p">,</span> <span class="n">filterset</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">)</span></code>
-
-<a href="#nautobot.apps.forms.DynamicFilterForm.__init__" class="headerlink" title="Permanent link">&para;</a></h3>
-
-
-    <div class="doc doc-contents ">
-
-    </div>
-
-</div>
-
 
 
   </div>
@@ -13402,21 +13327,6 @@ Then verify that any requested RelationshipAssociations do not violate relations
 
 
 
-<div class="doc doc-object doc-function">
-
-
-<h3 id="nautobot.apps.forms.TagFilterField.__init__" class="doc doc-heading">
-            <code class="highlight language-python"><span class="fm">__init__</span><span class="p">(</span><span class="n">model</span><span class="p">,</span> <span class="o">*</span><span class="n">args</span><span class="p">,</span> <span class="n">query_params</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">queryset</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">)</span></code>
-
-<a href="#nautobot.apps.forms.TagFilterField.__init__" class="headerlink" title="Permanent link">&para;</a></h3>
-
-
-    <div class="doc doc-contents ">
-
-    </div>
-
-</div>
-
 
 
   </div>

nautobot/project-static/docs/code-reference/nautobot/apps/models.html

@@ -7417,6 +7417,33 @@
     </span>
   </a>
   
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#nautobot.apps.models.CustomFieldModel.get_computed_fields_grouping" class="md-nav__link">
+    <span class="md-ellipsis">
+      get_computed_fields_grouping
+    </span>
+  </a>
+  
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#nautobot.apps.models.CustomFieldModel.get_computed_fields_grouping_advanced" class="md-nav__link">
+    <span class="md-ellipsis">
+      get_computed_fields_grouping_advanced
+    </span>
+  </a>
+  
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#nautobot.apps.models.CustomFieldModel.get_computed_fields_grouping_basic" class="md-nav__link">
+    <span class="md-ellipsis">
+      get_computed_fields_grouping_basic
+    </span>
+  </a>
+  
 </li>
         
           <li class="md-nav__item">
@@ -10278,6 +10305,33 @@
     </span>
   </a>
   
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#nautobot.apps.models.CustomFieldModel.get_computed_fields_grouping" class="md-nav__link">
+    <span class="md-ellipsis">
+      get_computed_fields_grouping
+    </span>
+  </a>
+  
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#nautobot.apps.models.CustomFieldModel.get_computed_fields_grouping_advanced" class="md-nav__link">
+    <span class="md-ellipsis">
+      get_computed_fields_grouping_advanced
+    </span>
+  </a>
+  
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#nautobot.apps.models.CustomFieldModel.get_computed_fields_grouping_basic" class="md-nav__link">
+    <span class="md-ellipsis">
+      get_computed_fields_grouping_basic
+    </span>
+  </a>
+  
 </li>
         
           <li class="md-nav__item">
@@ -12170,6 +12224,79 @@ Keys are the <code>key</code> value of each field. If label_as_key is True, <cod
 <div class="doc doc-object doc-function">
 
 
+<h3 id="nautobot.apps.models.CustomFieldModel.get_computed_fields_grouping" class="doc doc-heading">
+            <code class="highlight language-python"><span class="n">get_computed_fields_grouping</span><span class="p">(</span><span class="n">advanced_ui</span><span class="o">=</span><span class="kc">None</span><span class="p">)</span></code>
+
+<a href="#nautobot.apps.models.CustomFieldModel.get_computed_fields_grouping" class="headerlink" title="Permanent link">&para;</a></h3>
+
+
+    <div class="doc doc-contents ">
+
+      <p>Return a dictonary of computed fields grouped by the same grouping in the form
+{
+    <grouping_1>: [(cf1, <value for cf1>), (cf2, <value for cf2>), ...],
+    ...
+    <grouping_5>: [(cf8, <value for cf8>), (cf9, <value for cf9>), ...],
+    ...
+}</p>
+
+    </div>
+
+</div>
+
+<div class="doc doc-object doc-function">
+
+
+<h3 id="nautobot.apps.models.CustomFieldModel.get_computed_fields_grouping_advanced" class="doc doc-heading">
+            <code class="highlight language-python"><span class="n">get_computed_fields_grouping_advanced</span><span class="p">()</span></code>
+
+<a href="#nautobot.apps.models.CustomFieldModel.get_computed_fields_grouping_advanced" class="headerlink" title="Permanent link">&para;</a></h3>
+
+
+    <div class="doc doc-contents ">
+
+      <p>This method exists to help call get_computed_field_groupings() in templates where a function argument (advanced_ui) cannot be specified.
+Return a dictonary of computed fields grouped by the same grouping in the form
+{
+    <grouping_1>: [(cf1, <value for cf1>), (cf2, <value for cf2>), ...],
+    ...
+    <grouping_5>: [(cf8, <value for cf8>), (cf9, <value for cf9>), ...],
+    ...
+}
+which have advanced_ui set to True</p>
+
+    </div>
+
+</div>
+
+<div class="doc doc-object doc-function">
+
+
+<h3 id="nautobot.apps.models.CustomFieldModel.get_computed_fields_grouping_basic" class="doc doc-heading">
+            <code class="highlight language-python"><span class="n">get_computed_fields_grouping_basic</span><span class="p">()</span></code>
+
+<a href="#nautobot.apps.models.CustomFieldModel.get_computed_fields_grouping_basic" class="headerlink" title="Permanent link">&para;</a></h3>
+
+
+    <div class="doc doc-contents ">
+
+      <p>This method exists to help call get_computed_field_groupings() in templates where a function argument (advanced_ui) cannot be specified.
+Return a dictonary of computed fields grouped by the same grouping in the form
+{
+    <grouping_1>: [(cf1, <value for cf1>), (cf2, <value for cf2>), ...],
+    ...
+    <grouping_5>: [(cf8, <value for cf8>), (cf9, <value for cf9>), ...],
+    ...
+}
+which have advanced_ui set to False</p>
+
+    </div>
+
+</div>
+
+<div class="doc doc-object doc-function">
+
+
 <h3 id="nautobot.apps.models.CustomFieldModel.get_custom_field_groupings" class="doc doc-heading">
             <code class="highlight language-python"><span class="n">get_custom_field_groupings</span><span class="p">(</span><span class="n">advanced_ui</span><span class="o">=</span><span class="kc">None</span><span class="p">)</span></code>