nautobot 2.4.0b1__py3-none-any.whl → 2.4.1__py3-none-any.whl

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

@@ -18,7 +18,7 @@
       
       
       <link rel="icon" href="../../../assets/favicon.ico">
-      <meta name="generator" content="mkdocs-1.6.1, mkdocs-material-9.5.46">
+      <meta name="generator" content="mkdocs-1.6.1, mkdocs-material-9.5.49">
     
     
       
@@ -2112,6 +2112,27 @@
 
               
             
+              
+                
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../../../user-guide/feature-guides/wireless-networks-and-controllers.html" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    Wireless Networks and Controllers
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
+            
           </ul>
         </nav>
       
@@ -5131,6 +5152,27 @@
   
   
   
+    <li class="md-nav__item">
+      <a href="../../../user-guide/platform-functionality/jobs/kubernetes-job-support.html" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    Kubernetes Job Support
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
+            
+              
+                
+  
+  
+  
+  
     <li class="md-nav__item">
       <a href="../../../user-guide/platform-functionality/jobs/jobbutton.html" class="md-nav__link">
         
@@ -8815,11 +8857,11 @@
   
   
     <li class="md-nav__item">
-      <a href="../../../development/core/local-k8s.html" class="md-nav__link">
+      <a href="../../../development/core/minikube-dev-environment-for-k8s-jobs.html" class="md-nav__link">
         
   
   <span class="md-ellipsis">
-    Local Kubernetes Cluster
+    Minikube Dev Environment for K8s Jobs
   </span>
   
 
@@ -10476,7 +10518,12 @@
 
     <div class="doc doc-contents first">
 
-      <p>Nautobot utility functions.</p>
+        <p>Nautobot utility functions.</p>
+
+
+
+
+
 
 
 
@@ -10502,10 +10549,15 @@
 
     <div class="doc doc-contents ">
             <p class="doc doc-class-bases">
-              Bases: <code><autoref identifier="nautobot.extras.utils.FeaturedQueryMixin" optional hover>FeaturedQueryMixin</autoref></code></p>
+              Bases: <code><a class="autorefs autorefs-internal" title="nautobot.extras.utils.FeaturedQueryMixin" href="#nautobot.apps.utils.FeaturedQueryMixin">FeaturedQueryMixin</a></code></p>
+
+
+        <p>Helper class to get ContentType for models that implements the to_objectchange method for change logging.</p>
+
+
+
 
 
-      <p>Helper class to get ContentType for models that implements the to_objectchange method for change logging.</p>
 
 
 
@@ -10531,7 +10583,7 @@
 
     <div class="doc doc-contents ">
 
-      <p>Return a list of classes that implement the to_objectchange method</p>
+        <p>Return a list of classes that implement the to_objectchange method</p>
 
     </div>
 
@@ -10559,12 +10611,17 @@
     <div class="doc doc-contents ">
 
 
-      <p>Helper class that delays evaluation of the registry contents for the functionality store
+        <p>Helper class that delays evaluation of the registry contents for the functionality store
 until it has been populated.</p>
 
 
 
 
+
+
+
+
+
   <div class="doc doc-children">
 
 
@@ -10586,7 +10643,7 @@ until it has been populated.</p>
 
     <div class="doc doc-contents ">
 
-      <p>Given an extras feature, return a iterable of app_label: [models] for content type lookup.</p>
+        <p>Given an extras feature, return a iterable of app_label: [models] for content type lookup.</p>
 <p>Misnamed, as it returns an iterable of (key, value) (i.e. dict.items()) rather than an actual dict.</p>
 <p>Raises a KeyError if the given feature doesn't exist.</p>
 
@@ -10605,7 +10662,7 @@ until it has been populated.</p>
 
     <div class="doc doc-contents ">
 
-      <p>Given an extras feature, return a list of 2-tuple of <code>(model_label, pk)</code>
+        <p>Given an extras feature, return a list of 2-tuple of <code>(model_label, pk)</code>
 suitable for use as <code>choices</code> on a choice field:</p>
 <div class="highlight"><pre><span></span><code>&gt;&gt;&gt; FeatureQuery(&#39;statuses&#39;).get_choices()
 [(&#39;dcim.device&#39;, 13), (&#39;dcim.rack&#39;, 34)]
@@ -10627,7 +10684,7 @@ suitable for use as <code>choices</code> on a choice field:</p>
 
     <div class="doc doc-contents ">
 
-      <p>Given an extras feature, return a Q object for content type lookup</p>
+        <p>Given an extras feature, return a Q object for content type lookup</p>
 
     </div>
 
@@ -10644,7 +10701,7 @@ suitable for use as <code>choices</code> on a choice field:</p>
 
     <div class="doc doc-contents ">
 
-      <p>Return a list of model classes that declare this feature.</p>
+        <p>Return a list of model classes that declare this feature.</p>
 <p>Cache is cleared by post_migrate signal (nautobot.extras.signals.post_migrate_clear_content_type_caches).</p>
 
     </div>
@@ -10673,7 +10730,12 @@ suitable for use as <code>choices</code> on a choice field:</p>
     <div class="doc doc-contents ">
 
 
-      <p>Mixin class that gets a list of featured models.</p>
+        <p>Mixin class that gets a list of featured models.</p>
+
+
+
+
+
 
 
 
@@ -10699,7 +10761,7 @@ suitable for use as <code>choices</code> on a choice field:</p>
 
     <div class="doc doc-contents ">
 
-      <p>Given an extras feature, return a Q object for content type lookup</p>
+        <p>Given an extras feature, return a Q object for content type lookup</p>
 
     </div>
 
@@ -10716,7 +10778,7 @@ suitable for use as <code>choices</code> on a choice field:</p>
 
     <div class="doc doc-contents ">
 
-      <p>Return a list of classes that has implements this <code>name</code>.</p>
+        <p>Return a list of classes that has implements this <code>name</code>.</p>
 
     </div>
 
@@ -10747,6 +10809,11 @@ suitable for use as <code>choices</code> on a choice field:</p>
 
 
 
+
+
+
+
+
   <div class="doc doc-children">
 
 
@@ -10771,7 +10838,7 @@ suitable for use as <code>choices</code> on a choice field:</p>
 
     <div class="doc doc-contents ">
 
-      <p>Current checked out repository head commit.</p>
+        <p>Current checked out repository head commit.</p>
     </div>
 
 </div>
@@ -10789,7 +10856,7 @@ suitable for use as <code>choices</code> on a choice field:</p>
 
     <div class="doc doc-contents ">
 
-      <p>Ensure that we have a clone of the given remote Git repository URL at the given local directory path.</p>
+        <p>Ensure that we have a clone of the given remote Git repository URL at the given local directory path.</p>
 
 
 <p><span class="doc-section-title">Parameters:</span></p>
@@ -10804,9 +10871,11 @@ suitable for use as <code>choices</code> on a choice field:</p>
       </thead>
       <tbody>
           <tr class="doc-section-item">
-            <td><code>path</code></td>
             <td>
-                  <code><autoref identifier="str" optional>str</autoref></code>
+                <code>path</code>
+            </td>
+            <td>
+                  <code>str</code>
             </td>
             <td>
               <div class="doc-md-description">
@@ -10818,9 +10887,11 @@ suitable for use as <code>choices</code> on a choice field:</p>
             </td>
           </tr>
           <tr class="doc-section-item">
-            <td><code>url</code></td>
             <td>
-                  <code><autoref identifier="str" optional>str</autoref></code>
+                <code>url</code>
+            </td>
+            <td>
+                  <code>str</code>
             </td>
             <td>
               <div class="doc-md-description">
@@ -10832,9 +10903,11 @@ suitable for use as <code>choices</code> on a choice field:</p>
             </td>
           </tr>
           <tr class="doc-section-item">
-            <td><code>clone_initially</code></td>
             <td>
-                  <code><autoref identifier="bool" optional>bool</autoref></code>
+                <code>clone_initially</code>
+            </td>
+            <td>
+                  <code>bool</code>
             </td>
             <td>
               <div class="doc-md-description">
@@ -10863,7 +10936,7 @@ suitable for use as <code>choices</code> on a choice field:</p>
 
     <div class="doc doc-contents ">
 
-      <p>Check out the given branch, and optionally the specified commit within that branch.</p>
+        <p>Check out the given branch, and optionally the specified commit within that branch.</p>
 
 
 <p><span class="doc-section-title">Parameters:</span></p>
@@ -10878,9 +10951,11 @@ suitable for use as <code>choices</code> on a choice field:</p>
       </thead>
       <tbody>
           <tr class="doc-section-item">
-            <td><code>branch</code></td>
             <td>
-                  <code><autoref identifier="str" optional>str</autoref></code>
+                <code>branch</code>
+            </td>
+            <td>
+                  <code>str</code>
             </td>
             <td>
               <div class="doc-md-description">
@@ -10892,9 +10967,11 @@ suitable for use as <code>choices</code> on a choice field:</p>
             </td>
           </tr>
           <tr class="doc-section-item">
-            <td><code>commit_hexsha</code></td>
             <td>
-                  <code><autoref identifier="str" optional>str</autoref></code>
+                <code>commit_hexsha</code>
+            </td>
+            <td>
+                  <code>str</code>
             </td>
             <td>
               <div class="doc-md-description">
@@ -10907,7 +10984,7 @@ suitable for use as <code>choices</code> on a choice field:</p>
           </tr>
       </tbody>
     </table>
-      <p>If <code>commit_hexsha</code> is specified and <code>branch</code> is either a tag or a commit identifier, they must match.
+        <p>If <code>commit_hexsha</code> is specified and <code>branch</code> is either a tag or a commit identifier, they must match.
 If <code>commit_hexsha</code> is specified and <code>branch</code> is a branch name, it must contain the specified commit.</p>
 
 
@@ -10922,7 +10999,7 @@ If <code>commit_hexsha</code> is specified and <code>branch</code> is a branch n
       <tbody>
           <tr class="doc-section-item">
             <td>
-                  <code>(<autoref identifier="str" optional>str</autoref>, <autoref identifier="bool" optional>bool</autoref>)</code>
+                  <code>(str, bool)</code>
             </td>
             <td>
               <div class="doc-md-description">
@@ -10958,10 +11035,15 @@ If <code>commit_hexsha</code> is specified and <code>branch</code> is a branch n
 
     <div class="doc doc-contents ">
             <p class="doc doc-class-bases">
-              Bases: <code><autoref identifier="nautobot.extras.utils.FeaturedQueryMixin" optional hover>FeaturedQueryMixin</autoref></code></p>
+              Bases: <code><a class="autorefs autorefs-internal" title="nautobot.extras.utils.FeaturedQueryMixin" href="#nautobot.apps.utils.FeaturedQueryMixin">FeaturedQueryMixin</a></code></p>
+
+
+        <p>Helper class to get ContentType models that implements role.</p>
+
+
+
 
 
-      <p>Helper class to get ContentType models that implements role.</p>
 
 
 
@@ -10987,7 +11069,7 @@ If <code>commit_hexsha</code> is specified and <code>branch</code> is a branch n
 
     <div class="doc doc-contents ">
 
-      <p>Return a list of classes that implements roles e.g roles = ...</p>
+        <p>Return a list of classes that implements roles e.g roles = ...</p>
 
     </div>
 
@@ -11014,10 +11096,15 @@ If <code>commit_hexsha</code> is specified and <code>branch</code> is a branch n
 
     <div class="doc doc-contents ">
             <p class="doc doc-class-bases">
-              Bases: <code><autoref identifier="nautobot.extras.utils.FeaturedQueryMixin" optional hover>FeaturedQueryMixin</autoref></code></p>
+              Bases: <code><a class="autorefs autorefs-internal" title="nautobot.extras.utils.FeaturedQueryMixin" href="#nautobot.apps.utils.FeaturedQueryMixin">FeaturedQueryMixin</a></code></p>
+
+
+        <p>Helper class to get ContentType models that implements tags(TagsField)</p>
+
+
+
 
 
-      <p>Helper class to get ContentType models that implements tags(TagsField)</p>
 
 
 
@@ -11043,7 +11130,7 @@ If <code>commit_hexsha</code> is specified and <code>branch</code> is a branch n
 
     <div class="doc doc-contents ">
 
-      <p>Return a list of classes that has implements tags e.g tags = TagsField(...)</p>
+        <p>Return a list of classes that has implements tags e.g tags = TagsField(...)</p>
 
     </div>
 
@@ -11069,7 +11156,7 @@ If <code>commit_hexsha</code> is specified and <code>branch</code> is a branch n
 
     <div class="doc doc-contents ">
 
-      <p>Return lookup expr with its verbose name</p>
+        <p>Return lookup expr with its verbose name</p>
 
 
 <p><span class="doc-section-title">Parameters:</span></p>
@@ -11084,9 +11171,11 @@ If <code>commit_hexsha</code> is specified and <code>branch</code> is a branch n
       </thead>
       <tbody>
           <tr class="doc-section-item">
-            <td><code>field_name</code></td>
             <td>
-                  <code><autoref identifier="str" optional>str</autoref></code>
+                <code>field_name</code>
+            </td>
+            <td>
+                  <code>str</code>
             </td>
             <td>
               <div class="doc-md-description">
@@ -11098,9 +11187,11 @@ If <code>commit_hexsha</code> is specified and <code>branch</code> is a branch n
             </td>
           </tr>
           <tr class="doc-section-item">
-            <td><code>_verbose_name</code></td>
             <td>
-                  <code><autoref identifier="str" optional>str</autoref></code>
+                <code>_verbose_name</code>
+            </td>
+            <td>
+                  <code>str</code>
             </td>
             <td>
               <div class="doc-md-description">
@@ -11135,7 +11226,7 @@ If <code>commit_hexsha</code> is specified and <code>branch</code> is a branch n
 
     <div class="doc doc-contents ">
 
-      <p>Helper method to check if a key field is Python/GraphQL safe.
+        <p>Helper method to check if a key field is Python/GraphQL safe.
 Used in CustomField, ComputedField and Relationship models.</p>
 
     </div>
@@ -11153,7 +11244,7 @@ Used in CustomField, ComputedField and Relationship models.</p>
 
     <div class="doc doc-contents ">
 
-      <p>Decorator to mark a class as deprecated with a custom message about what to do instead of subclassing it.</p>
+        <p>Decorator to mark a class as deprecated with a custom message about what to do instead of subclassing it.</p>
 
     </div>
 
@@ -11170,7 +11261,7 @@ Used in CustomField, ComputedField and Relationship models.</p>
 
     <div class="doc doc-contents ">
 
-      <p>Decorator to mark a class as deprecated and suggest a replacement class if it is subclassed from.</p>
+        <p>Decorator to mark a class as deprecated and suggest a replacement class if it is subclassed from.</p>
 
     </div>
 
@@ -11187,7 +11278,7 @@ Used in CustomField, ComputedField and Relationship models.</p>
 
     <div class="doc doc-contents ">
 
-      <div class="highlight"><pre><span></span><code>Convert Git diff log into a list splitted by \n
+        <div class="highlight"><pre><span></span><code>Convert Git diff log into a list splitted by \n
 
 Example:
     &gt;&gt;&gt; git_log = &quot;M        index.html
@@ -11211,7 +11302,7 @@ Example:
 
     <div class="doc doc-contents ">
 
-      <p>Convert request QueryDict/GET into an acceptable factory formset QueryDict
+        <p>Convert request QueryDict/GET into an acceptable factory formset QueryDict
 while discarding <code>querydict</code> params which are not part of <code>filterset_class</code> params</p>
 
 
@@ -11227,9 +11318,11 @@ while discarding <code>querydict</code> params which are not part of <code>filte
       </thead>
       <tbody>
           <tr class="doc-section-item">
-            <td><code>request_querydict</code></td>
             <td>
-                  <code><autoref identifier="django.http.QueryDict" optional hover>QueryDict</autoref></code>
+                <code>request_querydict</code>
+            </td>
+            <td>
+                  <code><span title="django.http.QueryDict">QueryDict</span></code>
             </td>
             <td>
               <div class="doc-md-description">
@@ -11241,9 +11334,11 @@ while discarding <code>querydict</code> params which are not part of <code>filte
             </td>
           </tr>
           <tr class="doc-section-item">
-            <td><code>filterset</code></td>
             <td>
-                  <code><autoref identifier="FilterSet" optional>FilterSet</autoref></code>
+                <code>filterset</code>
+            </td>
+            <td>
+                  <code>FilterSet</code>
             </td>
             <td>
               <div class="doc-md-description">
@@ -11289,7 +11384,7 @@ while discarding <code>querydict</code> params which are not part of <code>filte
 
     <div class="doc doc-contents ">
 
-      <p>Decorator that wraps a models existing clean method to also execute registered plugin custom validators</p>
+        <p>Decorator that wraps a models existing clean method to also execute registered plugin custom validators</p>
 <p>:param model_clean_func: The original model clean method which is to be wrapped</p>
 
     </div>
@@ -11307,7 +11402,7 @@ while discarding <code>querydict</code> params which are not part of <code>filte
 
     <div class="doc doc-contents ">
 
-      <p>Deep merge two dictionaries (new into original) and return a new dict</p>
+        <p>Deep merge two dictionaries (new into original) and return a new dict</p>
 
     </div>
 
@@ -11324,7 +11419,7 @@ while discarding <code>querydict</code> params which are not part of <code>filte
 
     <div class="doc doc-contents ">
 
-      <p>Ensure <code>query_params</code> includes <code>content_type</code> and <code>field_name</code> and <code>content_type</code> is a valid ContentType.</p>
+        <p>Ensure <code>query_params</code> includes <code>content_type</code> and <code>field_name</code> and <code>content_type</code> is a valid ContentType.</p>
 <p>Return the 'ContentTypes' model and 'field_name' if validation was successful.</p>
 
     </div>
@@ -11342,7 +11437,7 @@ while discarding <code>querydict</code> params which are not part of <code>filte
 
     <div class="doc doc-contents ">
 
-      <p>For instances of model that have an invalid NULL status field, create and use a special status_model instance.</p>
+        <p>For instances of model that have an invalid NULL status field, create and use a special status_model instance.</p>
 
     </div>
 
@@ -11359,7 +11454,7 @@ while discarding <code>querydict</code> params which are not part of <code>filte
 
     <div class="doc doc-contents ">
 
-      <p>Flatten nested dictionaries into a single level by joining key names with a separator.</p>
+        <p>Flatten nested dictionaries into a single level by joining key names with a separator.</p>
 <p>:param d: The dictionary to be flattened
 :param prefix: Initial prefix (if any)
 :param separator: The character to use when concatenating key names</p>
@@ -11379,7 +11474,7 @@ while discarding <code>querydict</code> params which are not part of <code>filte
 
     <div class="doc doc-contents ">
 
-      <p>Flatten a nested iterable such as a list of lists, keeping strings intact.</p>
+        <p>Flatten a nested iterable such as a list of lists, keeping strings intact.</p>
 <p>:param iterable: The iterable to be flattened
 :returns: generator</p>
 
@@ -11398,7 +11493,7 @@ while discarding <code>querydict</code> params which are not part of <code>filte
 
     <div class="doc doc-contents ">
 
-      <p>Return the ideal foreground color (black or white) for a given background color in hexadecimal RGB format.</p>
+        <p>Return the ideal foreground color (black or white) for a given background color in hexadecimal RGB format.</p>
 
     </div>
 
@@ -11415,7 +11510,7 @@ while discarding <code>querydict</code> params which are not part of <code>filte
 
     <div class="doc doc-contents ">
 
-      <p>Return a cryptographic signature that can be used to verify the authenticity of webhook data.</p>
+        <p>Return a cryptographic signature that can be used to verify the authenticity of webhook data.</p>
 
     </div>
 
@@ -11432,7 +11527,7 @@ while discarding <code>querydict</code> params which are not part of <code>filte
 
     <div class="doc doc-contents ">
 
-      <p>Return all lookup expressions for <code>field_name</code> in <code>model</code> filterset</p>
+        <p>Return all lookup expressions for <code>field_name</code> in <code>model</code> filterset</p>
 
     </div>
 
@@ -11449,7 +11544,7 @@ while discarding <code>querydict</code> params which are not part of <code>filte
 
     <div class="doc doc-contents ">
 
-      <p>Returns the name of the base template, if the base_template is not None
+        <p>Returns the name of the base template, if the base_template is not None
 Otherwise, default to using "<app>/<model>.html" as the base template, if it exists.
 Otherwise, check if "<app>/<model>_retrieve.html" used in <code>NautobotUIViewSet</code> exists.
 If both templates do not exist, fall back to "base.html".</p>
@@ -11469,7 +11564,7 @@ If both templates do not exist, fall back to "base.html".</p>
 
     <div class="doc doc-contents ">
 
-      <p>Return a dictionary of celery queues and the number of workers active on the queue in
+        <p>Return a dictionary of celery queues and the number of workers active on the queue in
 the form {queue_name: num_workers}</p>
 
     </div>
@@ -11487,7 +11582,7 @@ the form {queue_name: num_workers}</p>
 
     <div class="doc doc-contents ">
 
-      <p>Return a queryset of ObjectChanges for a model or instance. The queryset will be filtered
+        <p>Return a queryset of ObjectChanges for a model or instance. The queryset will be filtered
 by the model class. If an instance is provided, the queryset will also be filtered by the instance id.</p>
 
     </div>
@@ -11505,7 +11600,7 @@ by the model class. If an instance is provided, the queryset will also be filter
 
     <div class="doc doc-contents ">
 
-      <p>Return a label for a given field name and value.</p>
+        <p>Return a label for a given field name and value.</p>
 
 
 <p><span class="doc-section-title">Parameters:</span></p>
@@ -11520,9 +11615,11 @@ by the model class. If an instance is provided, the queryset will also be filter
       </thead>
       <tbody>
           <tr class="doc-section-item">
-            <td><code>filter_field</code></td>
             <td>
-                  <code><autoref identifier="Filter" optional>Filter</autoref></code>
+                <code>filter_field</code>
+            </td>
+            <td>
+                  <code>Filter</code>
             </td>
             <td>
               <div class="doc-md-description">
@@ -11548,7 +11645,7 @@ by the model class. If an instance is provided, the queryset will also be filter
       <tbody>
           <tr class="doc-section-item">
             <td>
-                  <code><autoref identifier="str" optional>str</autoref></code>
+                  <code>str</code>
             </td>
             <td>
               <div class="doc-md-description">
@@ -11574,7 +11671,7 @@ by the model class. If an instance is provided, the queryset will also be filter
 
     <div class="doc doc-contents ">
 
-      <p>Remove any <code>non_filter_params</code> and fields that are not a part of the filterset from  <code>filter_params</code>
+        <p>Remove any <code>non_filter_params</code> and fields that are not a part of the filterset from  <code>filter_params</code>
 to return only queryset filterable parameters.</p>
 
 
@@ -11590,9 +11687,11 @@ to return only queryset filterable parameters.</p>
       </thead>
       <tbody>
           <tr class="doc-section-item">
-            <td><code>filter_params</code></td>
             <td>
-                  <code><autoref identifier="django.http.QueryDict" optional hover>QueryDict</autoref></code>
+                <code>filter_params</code>
+            </td>
+            <td>
+                  <code><span title="django.http.QueryDict">QueryDict</span></code>
             </td>
             <td>
               <div class="doc-md-description">
@@ -11604,9 +11703,11 @@ to return only queryset filterable parameters.</p>
             </td>
           </tr>
           <tr class="doc-section-item">
-            <td><code>non_filter_params</code></td>
             <td>
-                  <code><autoref identifier="list" optional>list</autoref></code>
+                <code>non_filter_params</code>
+            </td>
+            <td>
+                  <code>list</code>
             </td>
             <td>
               <div class="doc-md-description">
@@ -11618,9 +11719,11 @@ to return only queryset filterable parameters.</p>
             </td>
           </tr>
           <tr class="doc-section-item">
-            <td><code>filterset</code></td>
             <td>
-                  <code><autoref identifier="FilterSet" optional>FilterSet</autoref></code>
+                <code>filterset</code>
+            </td>
+            <td>
+                  <code>FilterSet</code>
             </td>
             <td>
               <div class="doc-md-description">
@@ -11646,7 +11749,7 @@ to return only queryset filterable parameters.</p>
       <tbody>
           <tr class="doc-section-item">
             <td>
-                  <code><autoref identifier="django.http.QueryDict" optional hover>QueryDict</autoref></code>
+                  <code><span title="django.http.QueryDict">QueryDict</span></code>
             </td>
             <td>
               <div class="doc-md-description">
@@ -11672,7 +11775,7 @@ to return only queryset filterable parameters.</p>
 
     <div class="doc doc-contents ">
 
-      <p>Return the <code>FilterSet</code> class associated with a given <code>model</code>.</p>
+        <p>Return the <code>FilterSet</code> class associated with a given <code>model</code>.</p>
 <p>The <code>FilterSet</code> class is expected to be in the <code>filters</code> module within the application
 associated with the model and its name is expected to be <code>{ModelName}FilterSet</code>.</p>
 <p>If a matching <code>FilterSet</code> is not found, this will return <code>None</code>.</p>
@@ -11690,9 +11793,11 @@ associated with the model and its name is expected to be <code>{ModelName}Filter
       </thead>
       <tbody>
           <tr class="doc-section-item">
-            <td><code>model</code></td>
             <td>
-                  <code><autoref identifier="BaseModel" optional>BaseModel</autoref></code>
+                <code>model</code>
+            </td>
+            <td>
+                  <code>BaseModel</code>
             </td>
             <td>
               <div class="doc-md-description">
@@ -11718,7 +11823,7 @@ associated with the model and its name is expected to be <code>{ModelName}Filter
       <tbody>
           <tr class="doc-section-item">
             <td>
-                  <code><autoref identifier="Union" optional>Union</autoref>[<autoref identifier="FilterSet" optional>FilterSet</autoref>, None]</code>
+                  <code>Union[FilterSet, None]</code>
             </td>
             <td>
               <div class="doc-md-description">
@@ -11744,7 +11849,7 @@ associated with the model and its name is expected to be <code>{ModelName}Filter
 
     <div class="doc doc-contents ">
 
-      <p>Return the relevant form field instance for a filterset parameter e.g DynamicModelMultipleChoiceField, forms.IntegerField e.t.c</p>
+        <p>Return the relevant form field instance for a filterset parameter e.g DynamicModelMultipleChoiceField, forms.IntegerField e.t.c</p>
 
     </div>
 
@@ -11761,7 +11866,7 @@ associated with the model and its name is expected to be <code>{ModelName}Filter
 
     <div class="doc doc-contents ">
 
-      <p>Return the <code>Form</code> class associated with a given <code>model</code>.</p>
+        <p>Return the <code>Form</code> class associated with a given <code>model</code>.</p>
 <p>The <code>Form</code> class is expected to be in the <code>forms</code> module within the application
 associated with the model and its name is expected to be <code>{ModelName}{form_prefix}Form</code>.</p>
 <p>If a matching <code>Form</code> is not found, this will return <code>None</code>.</p>
@@ -11779,9 +11884,11 @@ associated with the model and its name is expected to be <code>{ModelName}{form_
       </thead>
       <tbody>
           <tr class="doc-section-item">
-            <td><code>form_prefix</code></td>
             <td>
-                  <code><autoref identifier="str" optional>str</autoref></code>
+                <code>form_prefix</code>
+            </td>
+            <td>
+                  <code>str</code>
             </td>
             <td>
               <div class="doc-md-description">
@@ -11808,7 +11915,7 @@ associated with the model and its name is expected to be <code>{ModelName}{form_
       <tbody>
           <tr class="doc-section-item">
             <td>
-                  <code><autoref identifier="Union" optional>Union</autoref>[<autoref identifier="Form" optional>Form</autoref>, None]</code>
+                  <code>Union[Form, None]</code>
             </td>
             <td>
               <div class="doc-md-description">
@@ -11834,7 +11941,7 @@ associated with the model and its name is expected to be <code>{ModelName}{form_
 
     <div class="doc doc-contents ">
 
-      <p>Get latest known Nautobot release from cache, or if not available, queue up a background task to populate the cache.</p>
+        <p>Get latest known Nautobot release from cache, or if not available, queue up a background task to populate the cache.</p>
 
 
     <p><span class="doc-section-title">Returns:</span></p>
@@ -11848,7 +11955,7 @@ associated with the model and its name is expected to be <code>{ModelName}{form_
       <tbody>
           <tr class="doc-section-item">
             <td>
-                  <code>(<autoref identifier="Version" optional>Version</autoref>, <autoref identifier="str" optional>str</autoref>)</code>
+                  <code>(Version, str)</code>
             </td>
             <td>
               <div class="doc-md-description">
@@ -11858,7 +11965,7 @@ associated with the model and its name is expected to be <code>{ModelName}{form_
           </tr>
           <tr class="doc-section-item">
             <td>
-                  <code>(<autoref identifier="unknown" optional>unknown</autoref>, None)</code>
+                  <code>(unknown, None)</code>
             </td>
             <td>
               <div class="doc-md-description">
@@ -11884,7 +11991,7 @@ associated with the model and its name is expected to be <code>{ModelName}{form_
 
     <div class="doc doc-contents ">
 
-      <p>Given a full model name in dotted format (example: <code>dcim.model</code>), a model class is returned if valid.</p>
+        <p>Given a full model name in dotted format (example: <code>dcim.model</code>), a model class is returned if valid.</p>
 <p>:param model_name: Full dotted name for a model as a string (ex: <code>dcim.model</code>)
 :type model_name: str</p>
 <p>:raises TypeError: If given model name is not found.</p>
@@ -11905,7 +12012,7 @@ associated with the model and its name is expected to be <code>{ModelName}{form_
 
     <div class="doc doc-contents ">
 
-      <p>Resolve the named permission for a given model (or instance) and action (e.g. view or add).</p>
+        <p>Resolve the named permission for a given model (or instance) and action (e.g. view or add).</p>
 <p>:param model: A model or instance
 :param action: View, add, change, or delete (string)</p>
 
@@ -11924,7 +12031,7 @@ associated with the model and its name is expected to be <code>{ModelName}{form_
 
     <div class="doc doc-contents ">
 
-      <p>Return the appropriate class associated with a given model matching the <code>module_name</code> and
+        <p>Return the appropriate class associated with a given model matching the <code>module_name</code> and
 <code>object_suffix</code>.</p>
 <p>The given <code>model</code> can either be a model class, a model instance, or a dotted representation (ex: <code>dcim.device</code>).</p>
 <p>The object class is expected to be in the module within the application
@@ -11944,9 +12051,11 @@ associated with the model and its name is expected to be <code>{ModelName}{objec
       </thead>
       <tbody>
           <tr class="doc-section-item">
-            <td><code>model</code></td>
             <td>
-                  <code><autoref identifier="Union" optional>Union</autoref>[<autoref identifier="BaseModel" optional>BaseModel</autoref>, <autoref identifier="str" optional>str</autoref>]</code>
+                <code>model</code>
+            </td>
+            <td>
+                  <code>Union[BaseModel, str]</code>
             </td>
             <td>
               <div class="doc-md-description">
@@ -11958,9 +12067,11 @@ associated with the model and its name is expected to be <code>{ModelName}{objec
             </td>
           </tr>
           <tr class="doc-section-item">
-            <td><code>module_name</code></td>
             <td>
-                  <code><autoref identifier="str" optional>str</autoref></code>
+                <code>module_name</code>
+            </td>
+            <td>
+                  <code>str</code>
             </td>
             <td>
               <div class="doc-md-description">
@@ -11972,9 +12083,11 @@ associated with the model and its name is expected to be <code>{ModelName}{objec
             </td>
           </tr>
           <tr class="doc-section-item">
-            <td><code>object_suffix</code></td>
             <td>
-                  <code><autoref identifier="str" optional>str</autoref></code>
+                <code>object_suffix</code>
+            </td>
+            <td>
+                  <code>str</code>
             </td>
             <td>
               <div class="doc-md-description">
@@ -12000,7 +12113,7 @@ associated with the model and its name is expected to be <code>{ModelName}{objec
       <tbody>
           <tr class="doc-section-item">
             <td>
-                  <code><autoref identifier="Union" optional>Union</autoref>[<autoref identifier="BaseModel" optional>BaseModel</autoref>, <autoref identifier="str" optional>str</autoref>]</code>
+                  <code>Union[BaseModel, str]</code>
             </td>
             <td>
               <div class="doc-md-description">
@@ -12026,7 +12139,7 @@ associated with the model and its name is expected to be <code>{ModelName}{objec
 
     <div class="doc doc-contents ">
 
-      <p>Find the field on <code>from_model</code> that is a relation to <code>to_model</code>.</p>
+        <p>Find the field on <code>from_model</code> that is a relation to <code>to_model</code>.</p>
 <p>If no such field is found, returns None.
 If more than one such field is found, raises an AttributeError.</p>
 
@@ -12043,9 +12156,11 @@ If more than one such field is found, raises an AttributeError.</p>
       </thead>
       <tbody>
           <tr class="doc-section-item">
-            <td><code>from_model</code></td>
             <td>
-                  <code><autoref identifier="BaseModel" optional>BaseModel</autoref></code>
+                <code>from_model</code>
+            </td>
+            <td>
+                  <code>BaseModel</code>
             </td>
             <td>
               <div class="doc-md-description">
@@ -12057,9 +12172,11 @@ If more than one such field is found, raises an AttributeError.</p>
             </td>
           </tr>
           <tr class="doc-section-item">
-            <td><code>to_model</code></td>
             <td>
-                  <code><autoref identifier="BaseModel" optional>BaseModel</autoref></code>
+                <code>to_model</code>
+            </td>
+            <td>
+                  <code>BaseModel</code>
             </td>
             <td>
               <div class="doc-md-description">
@@ -12102,7 +12219,7 @@ If more than one such field is found, raises an AttributeError.</p>
 
     <div class="doc doc-contents ">
 
-      <p>Return the URL route name for the given model and action. Does not perform any validation.
+        <p>Return the URL route name for the given model and action. Does not perform any validation.
 Supports both core and App routes.</p>
 
 
@@ -12118,9 +12235,11 @@ Supports both core and App routes.</p>
       </thead>
       <tbody>
           <tr class="doc-section-item">
-            <td><code>model</code></td>
             <td>
-                  <code>(<autoref identifier="nautobot.core.models.Model" optional hover>Model</autoref>, <autoref identifier="str" optional>str</autoref>)</code>
+                <code>model</code>
+            </td>
+            <td>
+                  <code>(<span title="nautobot.core.models.Model">Model</span>, str)</code>
             </td>
             <td>
               <div class="doc-md-description">
@@ -12132,9 +12251,11 @@ Supports both core and App routes.</p>
             </td>
           </tr>
           <tr class="doc-section-item">
-            <td><code>action</code></td>
             <td>
-                  <code><autoref identifier="str" optional>str</autoref></code>
+                <code>action</code>
+            </td>
+            <td>
+                  <code>str</code>
             </td>
             <td>
               <div class="doc-md-description">
@@ -12146,9 +12267,11 @@ Supports both core and App routes.</p>
             </td>
           </tr>
           <tr class="doc-section-item">
-            <td><code>api</code></td>
             <td>
-                  <code><autoref identifier="bool" optional>bool</autoref></code>
+                <code>api</code>
+            </td>
+            <td>
+                  <code>bool</code>
             </td>
             <td>
               <div class="doc-md-description">
@@ -12174,7 +12297,7 @@ Supports both core and App routes.</p>
       <tbody>
           <tr class="doc-section-item">
             <td>
-                  <code><autoref identifier="str" optional>str</autoref></code>
+                  <code>str</code>
             </td>
             <td>
               <div class="doc-md-description">
@@ -12216,7 +12339,7 @@ Supports both core and App routes.</p>
 
     <div class="doc doc-contents ">
 
-      <p>Get a value from Django settings (if specified there) or Constance configuration (otherwise).</p>
+        <p>Get a value from Django settings (if specified there) or Constance configuration (otherwise).</p>
 <p>The fallback value is returned <em>only</em> if the requested variable cannot be found at all - this is an error case,
 and will generate warning logs.</p>
 
@@ -12228,14 +12351,14 @@ and will generate warning logs.</p>
 
 
 <h2 id="nautobot.apps.utils.get_table_for_model" class="doc doc-heading">
-            <code class="highlight language-python"><span class="n">nautobot</span><span class="o">.</span><span class="n">apps</span><span class="o">.</span><span class="n">utils</span><span class="o">.</span><span class="n">get_table_for_model</span><span class="p">(</span><span class="n">model</span><span class="p">)</span></code>
+            <code class="highlight language-python"><span class="n">nautobot</span><span class="o">.</span><span class="n">apps</span><span class="o">.</span><span class="n">utils</span><span class="o">.</span><span class="n">get_table_for_model</span><span class="p">(</span><span class="n">model</span><span class="p">,</span> <span class="n">suffix</span><span class="o">=</span><span class="kc">None</span><span class="p">)</span></code>
 
 <a href="#nautobot.apps.utils.get_table_for_model" class="headerlink" title="Permanent link">&para;</a></h2>
 
 
     <div class="doc doc-contents ">
 
-      <p>Return the <code>Table</code> class associated with a given <code>model</code>.</p>
+        <p>Return the <code>Table</code> class associated with a given <code>model</code>.</p>
 <p>The <code>Table</code> class is expected to be in the <code>tables</code> module within the application
 associated with the model and its name is expected to be <code>{ModelName}Table</code>.</p>
 <p>If a matching <code>Table</code> is not found, this will return <code>None</code>.</p>
@@ -12253,9 +12376,11 @@ associated with the model and its name is expected to be <code>{ModelName}Table<
       </thead>
       <tbody>
           <tr class="doc-section-item">
-            <td><code>model</code></td>
             <td>
-                  <code><autoref identifier="BaseModel" optional>BaseModel</autoref></code>
+                <code>model</code>
+            </td>
+            <td>
+                  <code>BaseModel</code>
             </td>
             <td>
               <div class="doc-md-description">
@@ -12266,6 +12391,22 @@ associated with the model and its name is expected to be <code>{ModelName}Table<
                 <em>required</em>
             </td>
           </tr>
+          <tr class="doc-section-item">
+            <td>
+                <code>suffix</code>
+            </td>
+            <td>
+                  <code>str</code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>A replacement suffix for the table name (e.g. <code>DetailTable</code>, such as to retrieve <code>FooDetailTable</code>)</p>
+              </div>
+            </td>
+            <td>
+                  <code>None</code>
+            </td>
+          </tr>
       </tbody>
     </table>
 
@@ -12281,7 +12422,7 @@ associated with the model and its name is expected to be <code>{ModelName}Table<
       <tbody>
           <tr class="doc-section-item">
             <td>
-                  <code><autoref identifier="Union" optional>Union</autoref>[<autoref identifier="Table" optional>Table</autoref>, None]</code>
+                  <code>Union[Table, None]</code>
             </td>
             <td>
               <div class="doc-md-description">
@@ -12307,7 +12448,7 @@ associated with the model and its name is expected to be <code>{ModelName}Table<
 
     <div class="doc doc-contents ">
 
-      <p>Given a URL pattern, construct a URL string that would match that pattern.</p>
+        <p>Given a URL pattern, construct a URL string that would match that pattern.</p>
 
 
 <p><span class="doc-section-title">Examples:</span></p>
@@ -12332,7 +12473,7 @@ associated with the model and its name is expected to be <code>{ModelName}Table<
 
     <div class="doc doc-contents ">
 
-      <p>Recursively yield a list of registered URL patterns.</p>
+        <p>Recursively yield a list of registered URL patterns.</p>
 
 
 <p><span class="doc-section-title">Parameters:</span></p>
@@ -12347,9 +12488,11 @@ associated with the model and its name is expected to be <code>{ModelName}Table<
       </thead>
       <tbody>
           <tr class="doc-section-item">
-            <td><code>urlconf</code></td>
             <td>
-                  <code><autoref identifier="URLConf" optional>URLConf</autoref></code>
+                <code>urlconf</code>
+            </td>
+            <td>
+                  <code>URLConf</code>
             </td>
             <td>
               <div class="doc-md-description">
@@ -12362,9 +12505,11 @@ Default if unspecified is the value of <code>settings.ROOT_URLCONF</code>, i.e.
             </td>
           </tr>
           <tr class="doc-section-item">
-            <td><code>patterns_list</code></td>
             <td>
-                  <code><autoref identifier="list" optional>list</autoref></code>
+                <code>patterns_list</code>
+            </td>
+            <td>
+                  <code>list</code>
             </td>
             <td>
               <div class="doc-md-description">
@@ -12377,9 +12522,11 @@ Default if unspecified is the <code>url_patterns</code> attribute of the given <
             </td>
           </tr>
           <tr class="doc-section-item">
-            <td><code>base_path</code></td>
             <td>
-                  <code><autoref identifier="str" optional>str</autoref></code>
+                <code>base_path</code>
+            </td>
+            <td>
+                  <code>str</code>
             </td>
             <td>
               <div class="doc-md-description">
@@ -12392,9 +12539,11 @@ Default if unspecified is the string <code>"/"</code>.</p>
             </td>
           </tr>
           <tr class="doc-section-item">
-            <td><code>ignore_redirects</code></td>
             <td>
-                  <code><autoref identifier="bool" optional>bool</autoref></code>
+                <code>ignore_redirects</code>
+            </td>
+            <td>
+                  <code>bool</code>
             </td>
             <td>
               <div class="doc-md-description">
@@ -12420,7 +12569,7 @@ Default if unspecified is the string <code>"/"</code>.</p>
       <tbody>
           <tr class="doc-section-item">
             <td>
-                  <code><autoref identifier="str" optional>str</autoref></code>
+                  <code>str</code>
             </td>
             <td>
               <div class="doc-md-description">
@@ -12495,7 +12644,7 @@ Default if unspecified is the string <code>"/"</code>.</p>
 
     <div class="doc doc-contents ">
 
-      <p>Return the <code>UIViewSet</code> or <code>&lt;view_type&gt;View</code> class associated with a given <code>model</code>.</p>
+        <p>Return the <code>UIViewSet</code> or <code>&lt;view_type&gt;View</code> class associated with a given <code>model</code>.</p>
 <p>The view class is expected to be in the <code>views</code> module within the app associated with the model,
 and its name is expected to be either <code>{ModelName}UIViewSet</code> or <code>{ModelName}{view_type}View</code>.</p>
 <p>If neither view class is found, this will return <code>None</code>.</p>
@@ -12515,7 +12664,7 @@ and its name is expected to be either <code>{ModelName}UIViewSet</code> or <code
 
     <div class="doc doc-contents ">
 
-      <p>Return a count of the active Celery workers in a specified queue (Could be a JobQueue instance, instance pk or instance name).
+        <p>Return a count of the active Celery workers in a specified queue (Could be a JobQueue instance, instance pk or instance name).
 Defaults to the <code>CELERY_TASK_DEFAULT_QUEUE</code> setting.</p>
 
     </div>
@@ -12533,7 +12682,7 @@ Defaults to the <code>CELERY_TASK_DEFAULT_QUEUE</code> setting.</p>
 
     <div class="doc doc-contents ">
 
-      <p>Map a hex string like "00ff00" to individual r, g, b integer values.</p>
+        <p>Map a hex string like "00ff00" to individual r, g, b integer values.</p>
 
     </div>
 
@@ -12550,7 +12699,7 @@ Defaults to the <code>CELERY_TASK_DEFAULT_QUEUE</code> setting.</p>
 
     <div class="doc doc-contents ">
 
-      <p>Return a path for uploading image attachments.</p>
+        <p>Return a path for uploading image attachments.</p>
 
     </div>
 
@@ -12567,7 +12716,7 @@ Defaults to the <code>CELERY_TASK_DEFAULT_QUEUE</code> setting.</p>
 
     <div class="doc doc-contents ">
 
-      <p>Validate whether a value is a URL.</p>
+        <p>Validate whether a value is a URL.</p>
 
 
 <p><span class="doc-section-title">Parameters:</span></p>
@@ -12582,9 +12731,11 @@ Defaults to the <code>CELERY_TASK_DEFAULT_QUEUE</code> setting.</p>
       </thead>
       <tbody>
           <tr class="doc-section-item">
-            <td><code>value</code></td>
             <td>
-                  <code><autoref identifier="str" optional>str</autoref></code>
+                <code>value</code>
+            </td>
+            <td>
+                  <code>str</code>
             </td>
             <td>
               <div class="doc-md-description">
@@ -12610,7 +12761,7 @@ Defaults to the <code>CELERY_TASK_DEFAULT_QUEUE</code> setting.</p>
       <tbody>
           <tr class="doc-section-item">
             <td>
-                  <code><autoref identifier="bool" optional>bool</autoref></code>
+                  <code>bool</code>
             </td>
             <td>
               <div class="doc-md-description">
@@ -12636,7 +12787,7 @@ Defaults to the <code>CELERY_TASK_DEFAULT_QUEUE</code> setting.</p>
 
     <div class="doc doc-contents ">
 
-      <p>Make a given RGB color lighter (closer to white).</p>
+        <p>Make a given RGB color lighter (closer to white).</p>
 
     </div>
 
@@ -12653,7 +12804,7 @@ Defaults to the <code>CELERY_TASK_DEFAULT_QUEUE</code> setting.</p>
 
     <div class="doc doc-contents ">
 
-      <p>Merge two dicts into a new dict, but raise a ValueError if any key exists with differing values across both dicts.</p>
+        <p>Merge two dicts into a new dict, but raise a ValueError if any key exists with differing values across both dicts.</p>
 
     </div>
 
@@ -12670,7 +12821,7 @@ Defaults to the <code>CELERY_TASK_DEFAULT_QUEUE</code> setting.</p>
 
     <div class="doc doc-contents ">
 
-      <p>When replacing a model, this will update references to the content type on related models such as tags and object changes.</p>
+        <p>When replacing a model, this will update references to the content type on related models such as tags and object changes.</p>
 <p>Since this only updates the content type and not the primary key, this is typically only useful when migrating to a new model
 and preserving the old instance's primary key.</p>
 
@@ -12689,7 +12840,7 @@ and preserving the old instance's primary key.</p>
 <li>RelationshipAssociation.destination_type</li>
 <li>TaggedItem.content_type</li>
 </ul>
-</details>      <p>For these one-to-many and many-to-many relationships, the new content type is added
+</details>        <p>For these one-to-many and many-to-many relationships, the new content type is added
 to the related model's content type list, but the old content type is not removed:
     - CustomField.content_types
     - JobButton.content_types
@@ -12714,9 +12865,11 @@ content types if an instance of the new model is using the tag.</p>
       </thead>
       <tbody>
           <tr class="doc-section-item">
-            <td><code>apps</code></td>
             <td>
-                  <code><autoref identifier="obj" optional>obj</autoref></code>
+                <code>apps</code>
+            </td>
+            <td>
+                  <code>obj</code>
             </td>
             <td>
               <div class="doc-md-description">
@@ -12728,9 +12881,11 @@ content types if an instance of the new model is using the tag.</p>
             </td>
           </tr>
           <tr class="doc-section-item">
-            <td><code>old_ct</code></td>
             <td>
-                  <code><autoref identifier="obj" optional>obj</autoref></code>
+                <code>old_ct</code>
+            </td>
+            <td>
+                  <code>obj</code>
             </td>
             <td>
               <div class="doc-md-description">
@@ -12742,9 +12897,11 @@ content types if an instance of the new model is using the tag.</p>
             </td>
           </tr>
           <tr class="doc-section-item">
-            <td><code>new_ct</code></td>
             <td>
-                  <code><autoref identifier="obj" optional>obj</autoref></code>
+                <code>new_ct</code>
+            </td>
+            <td>
+                  <code>obj</code>
             </td>
             <td>
               <div class="doc-md-description">
@@ -12773,7 +12930,7 @@ content types if an instance of the new model is using the tag.</p>
 
     <div class="doc doc-contents ">
 
-      <p>Update all <code>model_to_migrate</code> with a value for <code>to_role_field</code> based on <code>from_role_field</code> values.</p>
+        <p>Update all <code>model_to_migrate</code> with a value for <code>to_role_field</code> based on <code>from_role_field</code> values.</p>
 
 
 <p><span class="doc-section-title">Parameters:</span></p>
@@ -12788,9 +12945,11 @@ content types if an instance of the new model is using the tag.</p>
       </thead>
       <tbody>
           <tr class="doc-section-item">
-            <td><code>model_to_migrate</code></td>
             <td>
-                  <code><autoref identifier="Model" optional>Model</autoref></code>
+                <code>model_to_migrate</code>
+            </td>
+            <td>
+                  <code>Model</code>
             </td>
             <td>
               <div class="doc-md-description">
@@ -12802,9 +12961,11 @@ content types if an instance of the new model is using the tag.</p>
             </td>
           </tr>
           <tr class="doc-section-item">
-            <td><code>from_role_field_name</code></td>
             <td>
-                  <code><autoref identifier="str" optional>str</autoref></code>
+                <code>from_role_field_name</code>
+            </td>
+            <td>
+                  <code>str</code>
             </td>
             <td>
               <div class="doc-md-description">
@@ -12816,9 +12977,11 @@ content types if an instance of the new model is using the tag.</p>
             </td>
           </tr>
           <tr class="doc-section-item">
-            <td><code>from_role_model</code></td>
             <td>
-                  <code><autoref identifier="Model" optional>Model</autoref></code>
+                <code>from_role_model</code>
+            </td>
+            <td>
+                  <code>Model</code>
             </td>
             <td>
               <div class="doc-md-description">
@@ -12830,9 +12993,11 @@ content types if an instance of the new model is using the tag.</p>
             </td>
           </tr>
           <tr class="doc-section-item">
-            <td><code>from_role_choiceset</code></td>
             <td>
-                  <code><autoref identifier="ChoiceSet" optional>ChoiceSet</autoref></code>
+                <code>from_role_choiceset</code>
+            </td>
+            <td>
+                  <code>ChoiceSet</code>
             </td>
             <td>
               <div class="doc-md-description">
@@ -12844,9 +13009,11 @@ content types if an instance of the new model is using the tag.</p>
             </td>
           </tr>
           <tr class="doc-section-item">
-            <td><code>to_role_field_name</code></td>
             <td>
-                  <code><autoref identifier="str" optional>str</autoref></code>
+                <code>to_role_field_name</code>
+            </td>
+            <td>
+                  <code>str</code>
             </td>
             <td>
               <div class="doc-md-description">
@@ -12858,9 +13025,11 @@ content types if an instance of the new model is using the tag.</p>
             </td>
           </tr>
           <tr class="doc-section-item">
-            <td><code>to_role_model</code></td>
             <td>
-                  <code><autoref identifier="Model" optional>Model</autoref></code>
+                <code>to_role_model</code>
+            </td>
+            <td>
+                  <code>Model</code>
             </td>
             <td>
               <div class="doc-md-description">
@@ -12872,9 +13041,11 @@ content types if an instance of the new model is using the tag.</p>
             </td>
           </tr>
           <tr class="doc-section-item">
-            <td><code>to_role_choiceset</code></td>
             <td>
-                  <code><autoref identifier="ChoiceSet" optional>ChoiceSet</autoref></code>
+                <code>to_role_choiceset</code>
+            </td>
+            <td>
+                  <code>ChoiceSet</code>
             </td>
             <td>
               <div class="doc-md-description">
@@ -12886,9 +13057,11 @@ content types if an instance of the new model is using the tag.</p>
             </td>
           </tr>
           <tr class="doc-section-item">
-            <td><code>is_m2m_field</code></td>
             <td>
-                  <code><autoref identifier="bool" optional>bool</autoref></code>
+                <code>is_m2m_field</code>
+            </td>
+            <td>
+                  <code>bool</code>
             </td>
             <td>
               <div class="doc-md-description">
@@ -12910,22 +13083,111 @@ content types if an instance of the new model is using the tag.</p>
 
 
 <h2 id="nautobot.apps.utils.normalize_querydict" class="doc doc-heading">
-            <code class="highlight language-python"><span class="n">nautobot</span><span class="o">.</span><span class="n">apps</span><span class="o">.</span><span class="n">utils</span><span class="o">.</span><span class="n">normalize_querydict</span><span class="p">(</span><span class="n">querydict</span><span class="p">,</span> <span class="n">form_class</span><span class="o">=</span><span class="kc">None</span><span class="p">)</span></code>
+            <code class="highlight language-python"><span class="n">nautobot</span><span class="o">.</span><span class="n">apps</span><span class="o">.</span><span class="n">utils</span><span class="o">.</span><span class="n">normalize_querydict</span><span class="p">(</span><span class="n">querydict</span><span class="p">,</span> <span class="n">form_class</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">filterset</span><span class="o">=</span><span class="kc">None</span><span class="p">)</span></code>
 
 <a href="#nautobot.apps.utils.normalize_querydict" class="headerlink" title="Permanent link">&para;</a></h2>
 
 
     <div class="doc doc-contents ">
 
-      <p>Convert a QueryDict to a normal, mutable dictionary, preserving list values. For example,</p>
-<div class="highlight"><pre><span></span><code>QueryDict(&#39;foo=1&amp;bar=2&amp;bar=3&amp;baz=&#39;)
-</code></pre></div>
-<p>becomes:</p>
-<div class="highlight"><pre><span></span><code>{&#39;foo&#39;: &#39;1&#39;, &#39;bar&#39;: [&#39;2&#39;, &#39;3&#39;], &#39;baz&#39;: &#39;&#39;}
-</code></pre></div>
-<p>This function is necessary because QueryDict does not provide any built-in mechanism which preserves multiple
-values.</p>
-<p>A <code>form_class</code> can be provided as a way to hint which query parameters should be treated as lists.</p>
+        <p>Converts a QueryDict into a standard, mutable dictionary while preserving multiple values as lists.</p>
+
+
+<details class="example" open>
+  <summary>Example</summary>
+  <p>A QueryDict like:
+    QueryDict('foo=1&amp;bar=2&amp;bar=3&amp;baz=')</p>
+<p _="''" _1_="'1'," _2_="['2'," _3_="'3']," _bar_:="'bar':" _baz_:="'baz':" _foo_:="'foo':">Converts to:</p>
+</details>        <p>This function ensures that fields with multiple values are handled correctly, as QueryDict
+does not inherently preserve multiple values as lists.</p>
+
+
+<p><span class="doc-section-title">Parameters:</span></p>
+    <table>
+      <thead>
+        <tr>
+          <th>Name</th>
+          <th>Type</th>
+          <th>Description</th>
+          <th>Default</th>
+        </tr>
+      </thead>
+      <tbody>
+          <tr class="doc-section-item">
+            <td>
+                <code>querydict</code>
+            </td>
+            <td>
+                  <code><span title="django.http.QueryDict">QueryDict</span></code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>The QueryDict to be normalized.</p>
+              </div>
+            </td>
+            <td>
+                <em>required</em>
+            </td>
+          </tr>
+          <tr class="doc-section-item">
+            <td>
+                <code>form_class</code>
+            </td>
+            <td>
+                  <code><span title="django.forms.Form">Form</span></code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>A form class to identify fields that should be treated as
+lists (e.g., <code>MultipleChoiceField</code> or <code>ModelMultipleChoiceField</code>).</p>
+              </div>
+            </td>
+            <td>
+                  <code>None</code>
+            </td>
+          </tr>
+          <tr class="doc-section-item">
+            <td>
+                <code>filterset</code>
+            </td>
+            <td>
+                  <code><span title="django_filters.FilterSet">FilterSet</span></code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>A FilterSet instance to identify filters that
+should preserve multiple values as lists (e.g., non-single-choice fields).</p>
+              </div>
+            </td>
+            <td>
+                  <code>None</code>
+            </td>
+          </tr>
+      </tbody>
+    </table>
+
+
+<p><span class="doc-section-title">Raises:</span></p>
+    <table>
+      <thead>
+        <tr>
+          <th>Type</th>
+          <th>Description</th>
+        </tr>
+      </thead>
+      <tbody>
+          <tr class="doc-section-item">
+            <td>
+                  <code>AttributeError</code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>If both <code>form_class</code> and <code>filterset</code> are provided.</p>
+              </div>
+            </td>
+          </tr>
+      </tbody>
+    </table>
 
     </div>
 
@@ -12942,7 +13204,7 @@ values.</p>
 
     <div class="doc doc-contents ">
 
-      <p>Determine whether a specified permission is exempt from evaluation.</p>
+        <p>Determine whether a specified permission is exempt from evaluation.</p>
 <p>:param name: Permission name in the format <app_label>.<action>_<model></p>
 
     </div>
@@ -12960,7 +13222,7 @@ values.</p>
 
     <div class="doc doc-contents ">
 
-      <p>Populate the registry model features with new apps.</p>
+        <p>Populate the registry model features with new apps.</p>
 <p>This function updates the registry model features.</p>
 <p>Behavior:
 - Defines a list of dictionaries called lookup_confs. Each dictionary contains:
@@ -12993,7 +13255,7 @@ values.</p>
 
     <div class="doc doc-contents ">
 
-      <p>Create or update a job_model record based on the metadata of the provided job_class.</p>
+        <p>Create or update a job_model record based on the metadata of the provided job_class.</p>
 <p>Note that <code>job_model_class</code> and <code>job_queue_class</code> are parameters rather than local imports because
 this function may be called from various initialization processes (such as the "nautobot_database_ready" signal)
 and in that case we need to not import models ourselves.</p>
@@ -13016,7 +13278,7 @@ be calling the two-argument form of this function.</p>
 
     <div class="doc doc-contents ">
 
-      <p>field_name (str): f"cf_{cf.key}"</p>
+        <p>field_name (str): f"cf_{cf.key}"</p>
 <p>Helper method to remove the "cf_" prefix</p>
 
     </div>
@@ -13034,7 +13296,7 @@ be calling the two-argument form of this function.</p>
 
     <div class="doc doc-contents ">
 
-      <p>Render a Jinja2 template with the provided context. Return the rendered content.</p>
+        <p>Render a Jinja2 template with the provided context. Return the rendered content.</p>
 
     </div>
 
@@ -13051,7 +13313,7 @@ be calling the two-argument form of this function.</p>
 
     <div class="doc doc-contents ">
 
-      <p>Given a permission name, return the app_label, action, and model_name components. For example, "dcim.view_location"
+        <p>Given a permission name, return the app_label, action, and model_name components. For example, "dcim.view_location"
 returns ("dcim", "view", "location").</p>
 <p>:param name: Permission name in the format <app_label>.<action>_<model></p>
 
@@ -13070,7 +13332,7 @@ returns ("dcim", "view", "location").</p>
 
     <div class="doc doc-contents ">
 
-      <p>Given a permission name, return the relevant ContentType and action. For example, "dcim.view_location" returns
+        <p>Given a permission name, return the relevant ContentType and action. For example, "dcim.view_location" returns
 (Location, "view").</p>
 <p>:param name: Permission name in the format <app_label>.<action>_<model></p>
 
@@ -13089,7 +13351,7 @@ returns ("dcim", "view", "location").</p>
 
     <div class="doc doc-contents ">
 
-      <p>Map r, g, b values to a hex string.</p>
+        <p>Map r, g, b values to a hex string.</p>
 
     </div>
 
@@ -13106,7 +13368,7 @@ returns ("dcim", "view", "location").</p>
 
     <div class="doc doc-contents ">
 
-      <p>Make an attempt at stripping potentially-sensitive information from the given string, bytes or iterable thereof.</p>
+        <p>Make an attempt at stripping potentially-sensitive information from the given string, bytes or iterable thereof.</p>
 <p>Obviously this will never be 100% foolproof but we can at least try.</p>
 <p>Uses settings.SANITIZER_PATTERNS as the list of (regexp, repl) tuples to apply.</p>
 
@@ -13125,7 +13387,7 @@ returns ("dcim", "view", "location").</p>
 
     <div class="doc doc-contents ">
 
-      <p>Return a new dictionary of the different keys. The values of <code>destination_dict</code> are returned. Only the equality of
+        <p>Return a new dictionary of the different keys. The values of <code>destination_dict</code> are returned. Only the equality of
 the first layer of keys/values is checked. <code>exclude</code> is a list or tuple of keys to be ignored.</p>
 
     </div>
@@ -13143,7 +13405,7 @@ the first layer of keys/values is checked. <code>exclude</code> is a list or tup
 
     <div class="doc doc-contents ">
 
-      <p>Swap Git status initials with its equivalent.</p>
+        <p>Swap Git status initials with its equivalent.</p>
 
     </div>
 
@@ -13160,7 +13422,7 @@ the first layer of keys/values is checked. <code>exclude</code> is a list or tup
 
     <div class="doc doc-contents ">
 
-      <p>Returns a list of 2-tuples for use in the form field <code>choices</code> argument. Appends
+        <p>Returns a list of 2-tuples for use in the form field <code>choices</code> argument. Appends
 worker count to the description.</p>
 
     </div>
@@ -13178,7 +13440,7 @@ worker count to the description.</p>
 
     <div class="doc doc-contents ">
 
-      <p>Convert the given length to meters.</p>
+        <p>Convert the given length to meters.</p>
 
     </div>
 
@@ -13195,7 +13457,7 @@ worker count to the description.</p>
 
     <div class="doc doc-contents ">
 
-      <p>Helper function that wraps plugin model validator registered clean methods for all applicable models</p>
+        <p>Helper function that wraps plugin model validator registered clean methods for all applicable models</p>
 
     </div>
 
@@ -13354,7 +13616,7 @@ worker count to the description.</p>
     <script id="__config" type="application/json">{"base": "../../..", "features": ["content.code.annotate", "content.code.copy", "content.tabs.link", "navigation.footer", "navigation.tabs", "navigation.tabs.sticky", "navigation.tracking", "search.highlight", "search.share", "search.suggest"], "search": "../../../assets/javascripts/workers/search.6ce7567c.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}}</script>
     
     
-      <script src="../../../assets/javascripts/bundle.83f73b43.min.js"></script>
+      <script src="../../../assets/javascripts/bundle.88dd0f4e.min.js"></script>
       
         <script src="https://code.jquery.com/jquery-3.7.1.min.js"></script>