PyPI - nautobot - Versions diffs - 2.2.0b1__py3-none-any.whl → 2.2.1__py3-none-any.whl - Mend - Supply Chain Defender

nautobot 2.2.0b1py3-none-any.whl → 2.2.1py3-none-any.whl

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Potentially problematic release.

This version of nautobot might be problematic. Click here for more details.

Files changed (425) hide show

nautobot/project-static/docs/development/core/getting-started.html CHANGED Viewed

@@ -18,7 +18,7 @@
       <link rel="icon" href="../../assets/favicon.ico">
-      <meta name="generator" content="mkdocs-1.5.3, mkdocs-material-9.5.8">
+      <meta name="generator" content="mkdocs-1.5.3, mkdocs-material-9.5.16">
@@ -26,7 +26,7 @@
-      <link rel="stylesheet" href="../../assets/stylesheets/main.f2e4d321.min.css">
+      <link rel="stylesheet" href="../../assets/stylesheets/main.bcfcd587.min.css">
         <link rel="stylesheet" href="../../assets/stylesheets/palette.06af60db.min.css">
@@ -399,16 +399,14 @@
-    <li class="md-nav__item md-nav__item--section md-nav__item--nested">
+    <li class="md-nav__item md-nav__item--nested">
         <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2" >
@@ -425,7 +423,7 @@
             </a>
-              <label class="md-nav__link " for="__nav_2" id="__nav_2_label" tabindex="">
+              <label class="md-nav__link " for="__nav_2" id="__nav_2_label" tabindex="0">
                 <span class="md-nav__icon md-icon"></span>
               </label>
@@ -447,13 +445,14 @@
     <li class="md-nav__item md-nav__item--nested">
         <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2_1" >
@@ -484,13 +483,14 @@
     <li class="md-nav__item md-nav__item--nested">
         <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2_1_1" >
@@ -686,6 +686,27 @@
+    <li class="md-nav__item">
+      <a href="../../user-guide/administration/installation/health-checks.html" class="md-nav__link">
+  <span class="md-ellipsis">
+    Health Checks
+  </span>
+      </a>
+    </li>
     <li class="md-nav__item">
       <a href="../../user-guide/administration/installation/selinux-troubleshooting.html" class="md-nav__link">
@@ -718,13 +739,14 @@
     <li class="md-nav__item md-nav__item--nested">
         <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2_1_2" >
@@ -797,13 +819,14 @@
     <li class="md-nav__item md-nav__item--nested">
         <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2_1_2_3" >
@@ -863,13 +886,14 @@
     <li class="md-nav__item md-nav__item--nested">
         <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2_1_2_3_2" >
@@ -1016,13 +1040,14 @@
     <li class="md-nav__item md-nav__item--nested">
         <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2_1_3" >
@@ -1103,13 +1128,14 @@
     <li class="md-nav__item md-nav__item--nested">
         <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2_1_4" >
@@ -1211,13 +1237,14 @@
     <li class="md-nav__item md-nav__item--nested">
         <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2_1_4_4" >
@@ -1327,13 +1354,14 @@
     <li class="md-nav__item md-nav__item--nested">
         <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2_1_5" >
@@ -1414,13 +1442,14 @@
     <li class="md-nav__item md-nav__item--nested">
         <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2_1_6" >
@@ -1635,13 +1664,14 @@
     <li class="md-nav__item md-nav__item--nested">
         <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2_2" >
@@ -1672,13 +1702,14 @@
     <li class="md-nav__item md-nav__item--nested">
         <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2_2_1" >
@@ -1891,7 +1922,7 @@
     <li class="md-nav__item">
-      <a href="../../user-guide/feature-guides/contact-and-team.html" class="md-nav__link">
+      <a href="../../user-guide/feature-guides/contacts-and-teams.html" class="md-nav__link">
   <span class="md-ellipsis">
@@ -2048,13 +2079,14 @@
     <li class="md-nav__item md-nav__item--nested">
         <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2_3" >
@@ -2085,13 +2117,14 @@
     <li class="md-nav__item md-nav__item--nested">
         <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2_3_1" >
@@ -2151,13 +2184,14 @@
     <li class="md-nav__item md-nav__item--nested">
         <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2_3_2" >
@@ -2301,13 +2335,14 @@
     <li class="md-nav__item md-nav__item--nested">
         <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2_3_3" >
@@ -2485,13 +2520,14 @@
     <li class="md-nav__item md-nav__item--nested">
         <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2_3_3_8" >
@@ -2706,13 +2742,14 @@
     <li class="md-nav__item md-nav__item--nested">
         <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2_3_3_9" >
@@ -3156,11 +3193,11 @@
     <li class="md-nav__item">
-      <a href="../../user-guide/core-data-model/dcim/controllerdevicegroup.html" class="md-nav__link">
+      <a href="../../user-guide/core-data-model/dcim/controllermanageddevicegroup.html" class="md-nav__link">
   <span class="md-ellipsis">
-    Controller Device Group
+    Controller Managed Device Group
   </span>
@@ -3187,13 +3224,14 @@
     <li class="md-nav__item md-nav__item--nested">
         <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2_3_4" >
@@ -3316,13 +3354,14 @@
     <li class="md-nav__item md-nav__item--nested">
         <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2_3_5" >
@@ -3550,13 +3589,14 @@
     <li class="md-nav__item md-nav__item--nested">
         <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2_3_6" >
@@ -3637,13 +3677,14 @@
     <li class="md-nav__item md-nav__item--nested">
         <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2_3_7" >
@@ -3795,13 +3836,14 @@
     <li class="md-nav__item md-nav__item--nested">
         <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2_4" >
@@ -4000,13 +4042,14 @@
     <li class="md-nav__item md-nav__item--nested">
         <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2_4_9" >
@@ -4095,13 +4138,14 @@
     <li class="md-nav__item md-nav__item--nested">
         <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2_4_11" >
@@ -4295,13 +4339,14 @@
     <li class="md-nav__item md-nav__item--nested">
         <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2_4_15" >
@@ -4516,13 +4561,14 @@
     <li class="md-nav__item md-nav__item--nested">
         <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2_4_21" >
@@ -4641,16 +4687,17 @@
     <li class="md-nav__item md-nav__item--active md-nav__item--section md-nav__item--nested">
         <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_3" checked>
@@ -4689,13 +4736,14 @@
     <li class="md-nav__item md-nav__item--nested">
         <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_3_1" >
@@ -4763,13 +4811,14 @@
     <li class="md-nav__item md-nav__item--nested">
         <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_3_2" >
@@ -4850,13 +4899,14 @@
     <li class="md-nav__item md-nav__item--nested">
         <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_3_2_3" >
@@ -4966,13 +5016,14 @@
     <li class="md-nav__item md-nav__item--nested">
         <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_3_2_4" >
@@ -5158,13 +5209,14 @@
     <li class="md-nav__item md-nav__item--nested">
         <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_3_2_4_8" >
@@ -5274,13 +5326,14 @@
     <li class="md-nav__item md-nav__item--nested">
         <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_3_2_5" >
@@ -5537,13 +5590,14 @@
     <li class="md-nav__item md-nav__item--nested">
         <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_3_2_6" >
@@ -5716,13 +5770,14 @@
     <li class="md-nav__item md-nav__item--nested">
         <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_3_2_8" >
@@ -6244,13 +6299,14 @@
     <li class="md-nav__item md-nav__item--nested">
         <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_3_2_9" >
@@ -6344,13 +6400,14 @@
     <li class="md-nav__item md-nav__item--nested">
         <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_3_2_9_4" >
@@ -6481,13 +6538,14 @@
     <li class="md-nav__item md-nav__item--nested">
         <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_3_2_10" >
@@ -6557,13 +6615,14 @@
     <li class="md-nav__item md-nav__item--active md-nav__item--nested">
         <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_3_3" checked>
@@ -7318,11 +7377,11 @@
     <li class="md-nav__item">
-      <a href="extending-models.html" class="md-nav__link">
+      <a href="generic-views.html" class="md-nav__link">
   <span class="md-ellipsis">
-    Extending Models
+    Generic Views
   </span>
@@ -7339,11 +7398,11 @@
     <li class="md-nav__item">
-      <a href="generic-views.html" class="md-nav__link">
+      <a href="homepage.html" class="md-nav__link">
   <span class="md-ellipsis">
-    Generic Views
+    Home Page Panels
   </span>
@@ -7360,11 +7419,11 @@
     <li class="md-nav__item">
-      <a href="homepage.html" class="md-nav__link">
+      <a href="model-checklist.html" class="md-nav__link">
   <span class="md-ellipsis">
-    Home Page Panels
+    Model Development Checklist
   </span>
@@ -7587,16 +7646,14 @@
-    <li class="md-nav__item md-nav__item--section md-nav__item--nested">
+    <li class="md-nav__item md-nav__item--nested">
         <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_4" >
@@ -7613,7 +7670,7 @@
             </a>
-              <label class="md-nav__link " for="__nav_4" id="__nav_4_label" tabindex="">
+              <label class="md-nav__link " for="__nav_4" id="__nav_4_label" tabindex="0">
                 <span class="md-nav__icon md-icon"></span>
               </label>
@@ -7852,16 +7909,14 @@
-    <li class="md-nav__item md-nav__item--section md-nav__item--nested">
+    <li class="md-nav__item md-nav__item--nested">
         <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5" >
@@ -7878,7 +7933,7 @@
             </a>
-              <label class="md-nav__link " for="__nav_5" id="__nav_5_label" tabindex="">
+              <label class="md-nav__link " for="__nav_5" id="__nav_5_label" tabindex="0">
                 <span class="md-nav__icon md-icon"></span>
               </label>
@@ -7900,13 +7955,14 @@
     <li class="md-nav__item md-nav__item--nested">
         <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_1" >
@@ -9244,7 +9300,9 @@
 <li><code>--keepdb</code> - Save and reuse the initialized test database between test runs. Can significantly improve the initial startup time of the test suite after your first test run. <strong>Do not use if you're actively making changes to model definitions or migrations.</strong></li>
 <li><code>--label &lt;module.path&gt;</code> - Only run the specific subset of tests. Can be broad (<code>--label nautobot.core.tests</code>) or specific (<code>--label nautobot.core.tests.test_graphql.GraphQLQueryTestCase</code>).</li>
 <li><code>--no-buffer</code> - Allow stdout/stderr output from the test to be seen in your terminal, instead of being hidden. <strong>If you're debugging code with <code>breakpoint()</code>, you should use this option, as otherwise you'll never see the breakpoint happen.</strong></li>
-<li><code>--parallel</code> - Split the tests across multiple parallel subprocesses. Can greatly reduce the runtime of the entire test suite when used.</li>
+<li><code>--parallel</code> - Split the tests across multiple parallel subprocesses. Can greatly reduce the runtime of the entire test suite when used. Auto-detects the number of workers if not specified with <code>--parallel-workers</code>.</li>
+<li><code>--parallel-workers</code> - Specify the number of workers to use when running tests in parallel. Implies <code>--parallel</code>.</li>
+<li><code>--pattern</code> - Only run tests which match the given substring. Can be used multiple times.</li>
 <li><code>--skip-docs-build</code> - Skip building/rebuilding the static Nautobot documentation before running the test. Saves some time on reruns when you haven't changed the documentation source files.</li>
 <li><code>--verbose</code> - Run tests more verbosely, including describing each test case as it is run.</li>
 </ul>
@@ -9252,13 +9310,20 @@
 <p>In general, when you first run the Nautobot tests in your local copy of the repository, we'd recommend:</p>
 <div class="highlight"><pre><span></span><code><a id="__codelineno-43-1" name="__codelineno-43-1" href="#__codelineno-43-1"></a>invoke unittest --cache-test-fixtures --keepdb --parallel
 </code></pre></div>
+<p>When there are too many cores on the testing machine, you can limit the number of parallel workers:</p>
+<div class="highlight"><pre><span></span><code><a id="__codelineno-44-1" name="__codelineno-44-1" href="#__codelineno-44-1"></a>invoke unittest --cache-test-fixtures --keepdb --parallel-workers 4
+</code></pre></div>
 <p>On subsequent reruns, you can add the other performance-related options:</p>
-<div class="highlight"><pre><span></span><code><a id="__codelineno-44-1" name="__codelineno-44-1" href="#__codelineno-44-1"></a>invoke unittest --cache-test-fixtures --keepdb --parallel --skip-docs-build
-<a id="__codelineno-44-2" name="__codelineno-44-2" href="#__codelineno-44-2"></a>invoke unittest --cache-test-fixtures --keepdb --parallel --skip-docs-build --label nautobot.core.tests
+<div class="highlight"><pre><span></span><code><a id="__codelineno-45-1" name="__codelineno-45-1" href="#__codelineno-45-1"></a>invoke unittest --cache-test-fixtures --keepdb --parallel --skip-docs-build
+<a id="__codelineno-45-2" name="__codelineno-45-2" href="#__codelineno-45-2"></a>invoke unittest --cache-test-fixtures --keepdb --parallel --skip-docs-build --label nautobot.core.tests
 </code></pre></div>
 <p>When switching between significantly different branches of the code base (e.g. <code>main</code> vs <code>develop</code> vs <code>next</code>), you'll need to remove the cached test factory data, and for once omit the <code>--keepdb</code> option so that the test database can be destroyed and recreated appropriately:</p>
-<div class="highlight"><pre><span></span><code><a id="__codelineno-45-1" name="__codelineno-45-1" href="#__codelineno-45-1"></a>rm development/factory_dump.json
-<a id="__codelineno-45-2" name="__codelineno-45-2" href="#__codelineno-45-2"></a>invoke unittest --cache-test-fixtures --parallel
+<div class="highlight"><pre><span></span><code><a id="__codelineno-46-1" name="__codelineno-46-1" href="#__codelineno-46-1"></a>rm development/factory_dump.json
+<a id="__codelineno-46-2" name="__codelineno-46-2" href="#__codelineno-46-2"></a>invoke unittest --cache-test-fixtures --parallel
+</code></pre></div>
+<p>To limit the test to a specific pattern or label, you can use the <code>--label</code> and <code>--pattern</code> options:</p>
+<div class="highlight"><pre><span></span><code><a id="__codelineno-47-1" name="__codelineno-47-1" href="#__codelineno-47-1"></a>invoke unittest --cache-test-fixtures --keepdb --verbose --skip-docs-build --label nautobot.core.tests.dcim.test_views.DeviceTestCase
+<a id="__codelineno-47-2" name="__codelineno-47-2" href="#__codelineno-47-2"></a>invoke unittest --cache-test-fixtures --keepdb --verbose --skip-docs-build --pattern Controller
 </code></pre></div>
 <h4 id="integration-tests">Integration Tests<a class="headerlink" href="#integration-tests" title="Permanent link">&para;</a></h4>
 <p>Integration tests are automated tests written and run to ensure that the Nautobot application behaves as expected when being used as it would be in practice. By contrast to unit tests, where individual units of code are being tested, integration tests rely upon the server code actually running, and web UI clients or API clients to make real connections to the service to exercise actual workflows, such as navigating to the login page, filling out the username/passwords fields, and clicking the "Log In" button.</p>
@@ -9463,8 +9528,8 @@
 </table>
 <h2 id="submitting-pull-requests">Submitting Pull Requests<a class="headerlink" href="#submitting-pull-requests" title="Permanent link">&para;</a></h2>
 <p>Once you're happy with your work and have verified that all tests pass, commit your changes and push it upstream to your fork. Always provide descriptive (but not excessively verbose) commit messages. When working on a specific issue, be sure to reference it.</p>
-<div class="highlight"><pre><span></span><code><a id="__codelineno-46-1" name="__codelineno-46-1" href="#__codelineno-46-1"></a>git commit -m &quot;Closes #1234: Add IPv5 support&quot;
-<a id="__codelineno-46-2" name="__codelineno-46-2" href="#__codelineno-46-2"></a>git push origin
+<div class="highlight"><pre><span></span><code><a id="__codelineno-48-1" name="__codelineno-48-1" href="#__codelineno-48-1"></a>git commit -m &quot;Closes #1234: Add IPv5 support&quot;
+<a id="__codelineno-48-2" name="__codelineno-48-2" href="#__codelineno-48-2"></a>git push origin
 </code></pre></div>
 <p>Once your fork has the new commit, submit a <a href="https://github.com/nautobot/nautobot/compare">pull request</a> to the Nautobot repo to propose the changes. Be sure to provide a detailed accounting of the changes being made and the reasons for doing so.</p>
 <p>Once submitted, a maintainer will review your pull request and either merge it or request changes. If changes are needed, you can make them via new commits to your fork: The pull request will update automatically.</p>
@@ -9476,11 +9541,11 @@
 <p>Below are common issues you might encounter in your development environment and how to address them.</p>
 <h3 id="fatal-sorry-too-many-clients-already">FATAL: sorry, too many clients already<a class="headerlink" href="#fatal-sorry-too-many-clients-already" title="Permanent link">&para;</a></h3>
 <p>When using <code>nautobot-server runserver</code> to do development you might run into a traceback that looks something like this:</p>
-<div class="highlight"><pre><span></span><code><a id="__codelineno-47-1" name="__codelineno-47-1" href="#__codelineno-47-1"></a>Exception Type: OperationalError at /extras/tags/
-<a id="__codelineno-47-2" name="__codelineno-47-2" href="#__codelineno-47-2"></a>Exception Value: FATAL:  sorry, too many clients already
+<div class="highlight"><pre><span></span><code><a id="__codelineno-49-1" name="__codelineno-49-1" href="#__codelineno-49-1"></a>Exception Type: OperationalError at /extras/tags/
+<a id="__codelineno-49-2" name="__codelineno-49-2" href="#__codelineno-49-2"></a>Exception Value: FATAL:  sorry, too many clients already
 </code></pre></div>
 <p>The <code>runserver</code> development server is multi-threaded by default, which means that every request is creating its own connection. If you are doing some local testing or development that is resulting in a lot of connections to the database, pass <code>--nothreading</code> to the runserver command to disable threading:</p>
-<div class="highlight"><pre><span></span><code><a id="__codelineno-48-1" name="__codelineno-48-1" href="#__codelineno-48-1"></a>nautobot-server runserver --nothreading
+<div class="highlight"><pre><span></span><code><a id="__codelineno-50-1" name="__codelineno-50-1" href="#__codelineno-50-1"></a>nautobot-server runserver --nothreading
 </code></pre></div>
@@ -9626,9 +9691,9 @@
     <script id="__config" type="application/json">{"base": "../..", "features": ["content.code.copy", "navigation.footer", "navigation.tabs", "navigation.tabs.sticky", "navigation.tracking", "search.highlight", "search.share", "search.suggest"], "search": "../../assets/javascripts/workers/search.b8dbb3d2.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.8fd75fb4.min.js"></script>
+      <script src="../../assets/javascripts/bundle.bd41221c.min.js"></script>
-        <script src="https://code.jquery.com/jquery-3.6.0.min.js"></script>
+        <script src="https://code.jquery.com/jquery-3.7.1.min.js"></script>
   </body>