nautobot 2.4.3__py3-none-any.whl → 2.4.5__py3-none-any.whl

nautobot/project-static/docs/release-notes/version-2.4.html

@@ -8761,6 +8761,144 @@
       </ul>
     </nav>
   
+</li>
+      
+        <li class="md-nav__item">
+  <a href="#v245-2025-03-10" class="md-nav__link">
+    <span class="md-ellipsis">
+      v2.4.5 (2025-03-10)
+    </span>
+  </a>
+  
+    <nav class="md-nav" aria-label="v2.4.5 (2025-03-10)">
+      <ul class="md-nav__list">
+        
+          <li class="md-nav__item">
+  <a href="#security-in-v245" class="md-nav__link">
+    <span class="md-ellipsis">
+      Security in v2.4.5
+    </span>
+  </a>
+  
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#added-in-v245" class="md-nav__link">
+    <span class="md-ellipsis">
+      Added in v2.4.5
+    </span>
+  </a>
+  
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#changed-in-v245" class="md-nav__link">
+    <span class="md-ellipsis">
+      Changed in v2.4.5
+    </span>
+  </a>
+  
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#removed-in-v245" class="md-nav__link">
+    <span class="md-ellipsis">
+      Removed in v2.4.5
+    </span>
+  </a>
+  
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#fixed-in-v245" class="md-nav__link">
+    <span class="md-ellipsis">
+      Fixed in v2.4.5
+    </span>
+  </a>
+  
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#housekeeping-in-v245" class="md-nav__link">
+    <span class="md-ellipsis">
+      Housekeeping in v2.4.5
+    </span>
+  </a>
+  
+</li>
+        
+      </ul>
+    </nav>
+  
+</li>
+      
+        <li class="md-nav__item">
+  <a href="#v244-2025-03-03" class="md-nav__link">
+    <span class="md-ellipsis">
+      v2.4.4 (2025-03-03)
+    </span>
+  </a>
+  
+    <nav class="md-nav" aria-label="v2.4.4 (2025-03-03)">
+      <ul class="md-nav__list">
+        
+          <li class="md-nav__item">
+  <a href="#added-in-v244" class="md-nav__link">
+    <span class="md-ellipsis">
+      Added in v2.4.4
+    </span>
+  </a>
+  
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#changed-in-v244" class="md-nav__link">
+    <span class="md-ellipsis">
+      Changed in v2.4.4
+    </span>
+  </a>
+  
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#fixed-in-v244" class="md-nav__link">
+    <span class="md-ellipsis">
+      Fixed in v2.4.4
+    </span>
+  </a>
+  
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#dependencies-in-v244" class="md-nav__link">
+    <span class="md-ellipsis">
+      Dependencies in v2.4.4
+    </span>
+  </a>
+  
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#documentation-in-v244" class="md-nav__link">
+    <span class="md-ellipsis">
+      Documentation in v2.4.4
+    </span>
+  </a>
+  
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#housekeeping-in-v244" class="md-nav__link">
+    <span class="md-ellipsis">
+      Housekeeping in v2.4.4
+    </span>
+  </a>
+  
+</li>
+        
+      </ul>
+    </nav>
+  
 </li>
       
         <li class="md-nav__item">
@@ -9927,6 +10065,144 @@
       </ul>
     </nav>
   
+</li>
+      
+        <li class="md-nav__item">
+  <a href="#v245-2025-03-10" class="md-nav__link">
+    <span class="md-ellipsis">
+      v2.4.5 (2025-03-10)
+    </span>
+  </a>
+  
+    <nav class="md-nav" aria-label="v2.4.5 (2025-03-10)">
+      <ul class="md-nav__list">
+        
+          <li class="md-nav__item">
+  <a href="#security-in-v245" class="md-nav__link">
+    <span class="md-ellipsis">
+      Security in v2.4.5
+    </span>
+  </a>
+  
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#added-in-v245" class="md-nav__link">
+    <span class="md-ellipsis">
+      Added in v2.4.5
+    </span>
+  </a>
+  
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#changed-in-v245" class="md-nav__link">
+    <span class="md-ellipsis">
+      Changed in v2.4.5
+    </span>
+  </a>
+  
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#removed-in-v245" class="md-nav__link">
+    <span class="md-ellipsis">
+      Removed in v2.4.5
+    </span>
+  </a>
+  
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#fixed-in-v245" class="md-nav__link">
+    <span class="md-ellipsis">
+      Fixed in v2.4.5
+    </span>
+  </a>
+  
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#housekeeping-in-v245" class="md-nav__link">
+    <span class="md-ellipsis">
+      Housekeeping in v2.4.5
+    </span>
+  </a>
+  
+</li>
+        
+      </ul>
+    </nav>
+  
+</li>
+      
+        <li class="md-nav__item">
+  <a href="#v244-2025-03-03" class="md-nav__link">
+    <span class="md-ellipsis">
+      v2.4.4 (2025-03-03)
+    </span>
+  </a>
+  
+    <nav class="md-nav" aria-label="v2.4.4 (2025-03-03)">
+      <ul class="md-nav__list">
+        
+          <li class="md-nav__item">
+  <a href="#added-in-v244" class="md-nav__link">
+    <span class="md-ellipsis">
+      Added in v2.4.4
+    </span>
+  </a>
+  
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#changed-in-v244" class="md-nav__link">
+    <span class="md-ellipsis">
+      Changed in v2.4.4
+    </span>
+  </a>
+  
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#fixed-in-v244" class="md-nav__link">
+    <span class="md-ellipsis">
+      Fixed in v2.4.4
+    </span>
+  </a>
+  
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#dependencies-in-v244" class="md-nav__link">
+    <span class="md-ellipsis">
+      Dependencies in v2.4.4
+    </span>
+  </a>
+  
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#documentation-in-v244" class="md-nav__link">
+    <span class="md-ellipsis">
+      Documentation in v2.4.4
+    </span>
+  </a>
+  
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#housekeeping-in-v244" class="md-nav__link">
+    <span class="md-ellipsis">
+      Housekeeping in v2.4.4
+    </span>
+  </a>
+  
+</li>
+        
+      </ul>
+    </nav>
+  
 </li>
       
         <li class="md-nav__item">
@@ -10335,6 +10611,16 @@
 <p>Jobs can now log <code>success</code> messages as a new logging level which will be appropriately labeled and colorized in Job Result views.</p>
 <div class="highlight"><pre><span></span><code><a id="__codelineno-0-1" name="__codelineno-0-1" href="#__codelineno-0-1"></a><span class="bp">self</span><span class="o">.</span><span class="n">logger</span><span class="o">.</span><span class="n">success</span><span class="p">(</span><span class="s2">&quot;All data is valid.&quot;</span><span class="p">)</span>
 </code></pre></div>
+<details class="version-added">
+<summary>Added in version 2.4.5</summary>
+</details>
+<p>In Nautobot v2.4.5 and later, Jobs can now log <code>failure</code> messages as well:</p>
+<div class="highlight"><pre><span></span><code><a id="__codelineno-1-1" name="__codelineno-1-1" href="#__codelineno-1-1"></a><span class="bp">self</span><span class="o">.</span><span class="n">logger</span><span class="o">.</span><span class="n">failure</span><span class="p">(</span><span class="s2">&quot;Something went wrong.&quot;</span><span class="p">)</span>
+</code></pre></div>
+<p>In Nautobot v2.4.5 and later, Jobs can also mark their result as failed without raising an uncaught exception by calling the new <code>Job.fail(message)</code> API:</p>
+<div class="highlight"><pre><span></span><code><a id="__codelineno-2-1" name="__codelineno-2-1" href="#__codelineno-2-1"></a><span class="bp">self</span><span class="o">.</span><span class="n">fail</span><span class="p">(</span><span class="s2">&quot;Something went wrong, and we&#39;ll fail in the end, but we can continue for now.&quot;</span><span class="p">)</span>
+<a id="__codelineno-2-2" name="__codelineno-2-2" href="#__codelineno-2-2"></a><span class="bp">self</span><span class="o">.</span><span class="n">logger</span><span class="o">.</span><span class="n">info</span><span class="p">(</span><span class="s2">&quot;Continuing...&quot;</span><span class="p">)</span>
+</code></pre></div>
 <h4 id="kubernetes-job-execution-and-job-queue-data-model-experimental">Kubernetes Job Execution and Job Queue Data Model (Experimental)<a class="headerlink" href="#kubernetes-job-execution-and-job-queue-data-model-experimental" title="Permanent link">&para;</a></h4>
 <p><em>Please note that this functionality is considered Experimental in the v2.4.0 release and is subject to change in the future.</em></p>
 <p>When running in a Kubernetes (k8s) deployment, such as with Nautobot's <a href="https://docs.nautobot.com/projects/helm-charts/en/stable/">Helm chart</a>, Nautobot now supports an alternative method of running Nautobot Jobs - instead of (or in addition to) running one or more Celery Workers as long-lived persistent pods, Nautobot can dispatch Nautobot Jobs to be executed as short-lived <a href="https://kubernetes.io/docs/concepts/workloads/controllers/job/">Kubernetes Job</a> pods.</p>
@@ -10381,6 +10667,94 @@
 
 <!-- towncrier release notes start -->
 
+<h2 id="v245-2025-03-10">v2.4.5 (2025-03-10)<a class="headerlink" href="#v245-2025-03-10" title="Permanent link">&para;</a></h2>
+<h3 id="security-in-v245">Security in v2.4.5<a class="headerlink" href="#security-in-v245" title="Permanent link">&para;</a></h3>
+<ul>
+<li><a href="https://github.com/nautobot/nautobot/issues/6983">#6983</a> - Updated dependency <code>Jinja2</code> to <code>~3.1.6</code> to address <code>CVE-2025-27516</code>.</li>
+<li><a href="https://github.com/nautobot/nautobot/issues/7000">#7000</a> - Updated dependency <code>Django</code> to <code>~4.2.20</code> to address <code>CVE-2025-26699</code>.</li>
+</ul>
+<h3 id="added-in-v245">Added in v2.4.5<a class="headerlink" href="#added-in-v245" title="Permanent link">&para;</a></h3>
+<ul>
+<li><a href="https://github.com/nautobot/nautobot/issues/6384">#6384</a> - Added <code>Job.logger.failure()</code> API for Job logging, using custom <code>FAILURE</code> log level (between <code>WARNING</code> and <code>ERROR</code>).</li>
+<li><a href="https://github.com/nautobot/nautobot/issues/6384">#6384</a> - Added <code>Job.fail()</code> API, which can be used to fail a Job more gracefully than by raising an uncaught exception.</li>
+<li><a href="https://github.com/nautobot/nautobot/issues/6384">#6384</a> - Added <code>NautobotTestCaseMixin.assertJobResultStatus()</code> testing helper API.</li>
+<li><a href="https://github.com/nautobot/nautobot/issues/7001">#7001</a> - Added bulk-edit support for the RIR model.</li>
+</ul>
+<h3 id="changed-in-v245">Changed in v2.4.5<a class="headerlink" href="#changed-in-v245" title="Permanent link">&para;</a></h3>
+<ul>
+<li><a href="https://github.com/nautobot/nautobot/issues/6384">#6384</a> - Changed output of <code>nautobot-server runjob</code> command to include the traceback (if any) and count of <code>success</code>/<code>failure</code> log messages.</li>
+</ul>
+<h3 id="removed-in-v245">Removed in v2.4.5<a class="headerlink" href="#removed-in-v245" title="Permanent link">&para;</a></h3>
+<ul>
+<li><a href="https://github.com/nautobot/nautobot/issues/6384">#6384</a> - Removed the (undocumented) requirement for Jobs that implement a custom <code>before_start()</code> or <code>after_return()</code> method to call <code>super()</code> for the Job to execute successfully.</li>
+</ul>
+<h3 id="fixed-in-v245">Fixed in v2.4.5<a class="headerlink" href="#fixed-in-v245" title="Permanent link">&para;</a></h3>
+<ul>
+<li><a href="https://github.com/nautobot/nautobot/issues/6384">#6384</a> - Fixed rendering of "actions" column in the JobResult table view.</li>
+<li><a href="https://github.com/nautobot/nautobot/issues/6384">#6384</a> - Fixed incorrect <code>stacklevel</code> default value in Job <code>logger.success()</code> API.</li>
+<li><a href="https://github.com/nautobot/nautobot/issues/6906">#6906</a> - <code>GitRepository.clone_to_directory</code> now uses configured Secrets for Repository to prepare correct <code>from_url</code>.</li>
+<li><a href="https://github.com/nautobot/nautobot/issues/6972">#6972</a> - Fixed IPAddress get_or_create not working with the address argument.</li>
+</ul>
+<h3 id="housekeeping-in-v245">Housekeeping in v2.4.5<a class="headerlink" href="#housekeeping-in-v245" title="Permanent link">&para;</a></h3>
+<ul>
+<li><a href="https://github.com/nautobot/nautobot/issues/6384">#6384</a> - Added <code>init: true</code> to development <code>docker-compose.yml</code> to avoid failed health-checks from remaining as zombie processes.</li>
+<li><a href="https://github.com/nautobot/nautobot/issues/6384">#6384</a> - Added <code>ExampleFailingJob</code> to example app to demonstrate the two different ways to fail a Job.</li>
+<li><a href="https://github.com/nautobot/nautobot/issues/6971">#6971</a> - Fixed invoke commands requiring pyyaml.</li>
+<li><a href="https://github.com/nautobot/nautobot/issues/7001">#7001</a> - Refactored RIR model related UI views to use <code>NautobotUIViewSet</code> and <code>UI component framework</code>.</li>
+</ul>
+<h2 id="v244-2025-03-03">v2.4.4 (2025-03-03)<a class="headerlink" href="#v244-2025-03-03" title="Permanent link">&para;</a></h2>
+<h3 id="added-in-v244">Added in v2.4.4<a class="headerlink" href="#added-in-v244" title="Permanent link">&para;</a></h3>
+<ul>
+<li><a href="https://github.com/nautobot/nautobot/issues/5851">#5851</a> - Added <code>PrefixFilter</code> helper class to <code>nautobot.apps.filters</code>.</li>
+<li><a href="https://github.com/nautobot/nautobot/issues/5851">#5851</a> - Enhanced <code>prefixes</code> filter on <code>CloudNetwork</code> and <code>Tenant</code> filtersets to support filtering by literal prefix string (<code>10.0.0.0/8</code>) as an alternative to filtering by primary key.</li>
+<li><a href="https://github.com/nautobot/nautobot/issues/5851">#5851</a> - Enhanced <code>prefix</code> filter on <code>CloudNetworkPrefixAssignment</code>, <code>VRF</code>, and <code>VRFPrefixAssignment</code> filtersets to support filtering by literal prefix string (<code>10.0.0.0/8</code>) as an alternative to filtering by primary key.</li>
+<li><a href="https://github.com/nautobot/nautobot/issues/5851">#5851</a> - Enhanced <code>parent</code> filter on <code>Prefix</code> filtersets to support filtering by literal prefix string (<code>10.0.0.0/8</code>) as an alternative to filtering by primary key.</li>
+<li><a href="https://github.com/nautobot/nautobot/issues/5851">#5851</a> - Enhanced <code>prefix</code> filter on <code>PrefixLocationAssignment</code> filtersets to support filtering by primary key as an alternative to filtering by literal prefix string.</li>
+<li><a href="https://github.com/nautobot/nautobot/issues/5851">#5851</a> - Added <code>q</code> search filter to <code>VRFPrefixAssignment</code> filterset.</li>
+<li><a href="https://github.com/nautobot/nautobot/issues/6635">#6635</a> - Added Monaco Editor integration to object change view for improved visualization of structured data differences including JSON, YAML, XML, tags, custom fields, and config contexts.</li>
+<li><a href="https://github.com/nautobot/nautobot/issues/6924">#6924</a> - Added optional VRF relationship to Virtual Device Context.</li>
+<li><a href="https://github.com/nautobot/nautobot/issues/6925">#6925</a> - Added colors next to Devices to indicate Device status in Rack Elevation view.</li>
+<li><a href="https://github.com/nautobot/nautobot/issues/6966">#6966</a> - Added support for accessing the current user within Custom Validators via <code>self.context["user"]</code>.</li>
+</ul>
+<h3 id="changed-in-v244">Changed in v2.4.4<a class="headerlink" href="#changed-in-v244" title="Permanent link">&para;</a></h3>
+<ul>
+<li><a href="https://github.com/nautobot/nautobot/issues/6829">#6829</a> - Enabled assignment of a Device to a Rack that belongs to a child Location of the device's location; for example, a Device located in a "Building" can now be assigned to a Rack located in a "Room" within that building.</li>
+</ul>
+<h3 id="fixed-in-v244">Fixed in v2.4.4<a class="headerlink" href="#fixed-in-v244" title="Permanent link">&para;</a></h3>
+<ul>
+<li><a href="https://github.com/nautobot/nautobot/issues/3041">#3041</a> - Fixed inability to assign a parent bay when creating a Device via the REST API.</li>
+<li><a href="https://github.com/nautobot/nautobot/issues/5006">#5006</a> - Added a validation check to prevent removing an in-use content type from a LocationType.</li>
+<li><a href="https://github.com/nautobot/nautobot/issues/5193">#5193</a> - Fixed an erroneous <code>ValidationError</code> when attempting to apply Tags to an object via the REST API.</li>
+<li><a href="https://github.com/nautobot/nautobot/issues/5851">#5851</a> - Fixed <code>VRFPrefixAssignment</code> REST API endpoint incorrectly advertising support for Notes.</li>
+<li><a href="https://github.com/nautobot/nautobot/issues/5851">#5851</a> - Fixed incorrect <code>Meta.model</code> value on <code>ControllerManagedDeviceGroupWirelessNetworkAssignmentTable</code> and <code>ControllerManagedDeviceGroupRadioProfileAssignmentTable</code>.</li>
+<li><a href="https://github.com/nautobot/nautobot/issues/6848">#6848</a> - Fixed a <code>DoesNotExist</code> error in the GUI at <code>/extras/git-repositories/X/result/</code> when a Git repository was created via API and not yet synced.</li>
+<li><a href="https://github.com/nautobot/nautobot/issues/6861">#6861</a> - Fixed the data population of the Rack Group dropdown to include Rack Groups from the Rack's parent locations in Rack Edit View.</li>
+<li><a href="https://github.com/nautobot/nautobot/issues/6910">#6910</a> - Fixed CSV export job to add a UTF-8 BOM (byte order mark) to the created file to ensure Excel will correctly handle any Unicode data.</li>
+<li><a href="https://github.com/nautobot/nautobot/issues/6920">#6920</a> - Added log messages to help troubleshoot failures when rendering UI Component Framework <code>extra_buttons</code>.</li>
+<li><a href="https://github.com/nautobot/nautobot/issues/6920">#6920</a> - Fixed logic in UI Component Framework <code>StatsPanel</code> that incorrectly disallowed use of FilterSet filters implicitly defined through <code>fields = "__all__"</code>.</li>
+<li><a href="https://github.com/nautobot/nautobot/issues/6920">#6920</a> - Fixed logic in generic <code>FormTestCase</code> class that would incorrectly fail if form fields used FilterSet filters implicitly defined through <code>fields = "__all__"</code>.</li>
+<li><a href="https://github.com/nautobot/nautobot/issues/6939">#6939</a> - Fixed an error in testing Jobs in <code>JOBS_ROOT</code> by forcing registration of <code>taggit</code> and <code>social_django</code> models before unregistering them from the admin site.</li>
+<li><a href="https://github.com/nautobot/nautobot/issues/6950">#6950</a> - Added missing <code>job_queues</code> filter field to <code>JobFilterSet</code>.</li>
+<li><a href="https://github.com/nautobot/nautobot/issues/6952">#6952</a> - Fixed an <code>AttributeError</code> exception when upgrading from v1.x to v2.x with certain existing data in the database.</li>
+</ul>
+<h3 id="dependencies-in-v244">Dependencies in v2.4.4<a class="headerlink" href="#dependencies-in-v244" title="Permanent link">&para;</a></h3>
+<ul>
+<li><a href="https://github.com/nautobot/nautobot/issues/6927">#6927</a> - Updated dependency <code>django-filter</code> to <code>~25.1</code>.</li>
+</ul>
+<h3 id="documentation-in-v244">Documentation in v2.4.4<a class="headerlink" href="#documentation-in-v244" title="Permanent link">&para;</a></h3>
+<ul>
+<li><a href="https://github.com/nautobot/nautobot/issues/6903">#6903</a> - Removed documentation references to Nautobot 1.x behavior and feature changes within the 1.x release series.</li>
+<li><a href="https://github.com/nautobot/nautobot/issues/6951">#6951</a> - Fixed typo in v2 migration documentation.</li>
+</ul>
+<h3 id="housekeeping-in-v244">Housekeeping in v2.4.4<a class="headerlink" href="#housekeeping-in-v244" title="Permanent link">&para;</a></h3>
+<ul>
+<li><a href="https://github.com/nautobot/nautobot/issues/5851">#5851</a> - Enhanced <code>PrefixFactory</code> and <code>VRFFactory</code> test helpers to automatically create appropriate <code>VRFPrefixAssignment</code> records.</li>
+<li><a href="https://github.com/nautobot/nautobot/issues/6857">#6857</a> - Added <code>.yarn</code> directory to <code>.gitignore</code>.</li>
+<li><a href="https://github.com/nautobot/nautobot/issues/6857">#6857</a> - Changed CI for integration tests to use <code>--no-keepdb</code>.</li>
+<li><a href="https://github.com/nautobot/nautobot/issues/6858">#6858</a> - Fixed generation of performance test endpoints for Nautobot apps.</li>
+<li><a href="https://github.com/nautobot/nautobot/issues/6893">#6893</a> - Added an option for ephemeral ports, and streamlined debug settings for VSCode developers.</li>
+<li><a href="https://github.com/nautobot/nautobot/issues/6943">#6943</a> - Updated <code>debug</code> invoke task to restore previous behavior.</li>
+</ul>
 <h2 id="v243-2025-02-18">v2.4.3 (2025-02-18)<a class="headerlink" href="#v243-2025-02-18" title="Permanent link">&para;</a></h2>
 <h3 id="added-in-v243">Added in v2.4.3<a class="headerlink" href="#added-in-v243" title="Permanent link">&para;</a></h3>
 <ul>

nautobot/project-static/docs/requirements.txt

@@ -1,4 +1,4 @@
-Jinja2==3.1.5
+Jinja2==3.1.6
 Markdown==3.6
 markdown-data-tables==1.0.0
 markdown-version-annotations==1.0.1
@@ -9,6 +9,6 @@ mkdocs-macros-plugin==1.0.5
 mkdocs-material==9.5.50
 mkdocs-redirects==1.2.2
 mkdocs-section-index==0.3.9
-mkdocstrings==0.25.2
+mkdocstrings==0.26.1
 mkdocstrings-python==1.10.8
 zipp==3.19.1 # not directly required, pinned by Snyk to avoid a vulnerability