nautobot 2.3.3__py3-none-any.whl → 2.3.5__py3-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 (333) hide show
  1. nautobot/core/celery/schedulers.py +2 -2
  2. nautobot/core/settings.py +3 -1
  3. nautobot/core/settings.yaml +40 -23
  4. nautobot/core/tests/runner.py +13 -6
  5. nautobot/core/tests/test_settings_schema.py +7 -3
  6. nautobot/core/tests/test_views.py +40 -1
  7. nautobot/core/views/generic.py +15 -15
  8. nautobot/core/views/mixins.py +12 -1
  9. nautobot/core/views/renderers.py +3 -1
  10. nautobot/core/views/utils.py +1 -1
  11. nautobot/dcim/api/serializers.py +1 -0
  12. nautobot/dcim/api/views.py +2 -0
  13. nautobot/dcim/forms.py +1 -1
  14. nautobot/dcim/tables/power.py +1 -1
  15. nautobot/dcim/templates/dcim/devicefamily_retrieve.html +1 -1
  16. nautobot/dcim/tests/test_api.py +58 -4
  17. nautobot/dcim/tests/test_filters.py +1 -1
  18. nautobot/dcim/tests/test_models.py +0 -2
  19. nautobot/dcim/views.py +5 -2
  20. nautobot/extras/api/views.py +9 -0
  21. nautobot/extras/models/jobs.py +9 -1
  22. nautobot/extras/querysets.py +10 -1
  23. nautobot/extras/tables.py +3 -0
  24. nautobot/extras/tests/test_api.py +36 -0
  25. nautobot/extras/tests/test_views.py +76 -1
  26. nautobot/extras/views.py +10 -7
  27. nautobot/ipam/forms.py +6 -1
  28. nautobot/ipam/models.py +5 -11
  29. nautobot/ipam/navigation.py +8 -1
  30. nautobot/ipam/templates/ipam/prefix.html +1 -1
  31. nautobot/ipam/tests/test_filters.py +1 -1
  32. nautobot/ipam/tests/test_views.py +41 -41
  33. nautobot/ipam/views.py +1 -1
  34. nautobot/project-static/docs/404.html +60 -148
  35. nautobot/project-static/docs/additional-features/caching.html +3 -3
  36. nautobot/project-static/docs/additional-features/healthcheck.html +3 -3
  37. nautobot/project-static/docs/apps/index.html +60 -148
  38. nautobot/project-static/docs/apps/nautobot-apps.html +60 -148
  39. nautobot/project-static/docs/assets/javascripts/workers/{search.07f07601.min.js → search.6ce7567c.min.js} +3 -3
  40. nautobot/project-static/docs/assets/javascripts/workers/{search.07f07601.min.js.map → search.6ce7567c.min.js.map} +2 -2
  41. nautobot/project-static/docs/code-reference/nautobot/apps/__init__.html +60 -148
  42. nautobot/project-static/docs/code-reference/nautobot/apps/admin.html +60 -148
  43. nautobot/project-static/docs/code-reference/nautobot/apps/api.html +60 -148
  44. nautobot/project-static/docs/code-reference/nautobot/apps/change_logging.html +60 -148
  45. nautobot/project-static/docs/code-reference/nautobot/apps/choices.html +60 -148
  46. nautobot/project-static/docs/code-reference/nautobot/apps/config.html +60 -148
  47. nautobot/project-static/docs/code-reference/nautobot/apps/constants.html +60 -148
  48. nautobot/project-static/docs/code-reference/nautobot/apps/datasources.html +60 -148
  49. nautobot/project-static/docs/code-reference/nautobot/apps/exceptions.html +60 -148
  50. nautobot/project-static/docs/code-reference/nautobot/apps/factory.html +60 -148
  51. nautobot/project-static/docs/code-reference/nautobot/apps/filters.html +60 -148
  52. nautobot/project-static/docs/code-reference/nautobot/apps/forms.html +60 -148
  53. nautobot/project-static/docs/code-reference/nautobot/apps/graphql.html +60 -148
  54. nautobot/project-static/docs/code-reference/nautobot/apps/jobs.html +60 -148
  55. nautobot/project-static/docs/code-reference/nautobot/apps/models.html +60 -148
  56. nautobot/project-static/docs/code-reference/nautobot/apps/querysets.html +60 -148
  57. nautobot/project-static/docs/code-reference/nautobot/apps/secrets.html +60 -148
  58. nautobot/project-static/docs/code-reference/nautobot/apps/tables.html +60 -148
  59. nautobot/project-static/docs/code-reference/nautobot/apps/testing.html +60 -148
  60. nautobot/project-static/docs/code-reference/nautobot/apps/ui.html +60 -148
  61. nautobot/project-static/docs/code-reference/nautobot/apps/urls.html +60 -148
  62. nautobot/project-static/docs/code-reference/nautobot/apps/utils.html +60 -148
  63. nautobot/project-static/docs/code-reference/nautobot/apps/views.html +60 -148
  64. nautobot/project-static/docs/configuration/optional-settings.html +3 -3
  65. nautobot/project-static/docs/configuration/required-settings.html +3 -3
  66. nautobot/project-static/docs/development/apps/api/configuration-view.html +60 -148
  67. nautobot/project-static/docs/development/apps/api/database-backend-config.html +60 -148
  68. nautobot/project-static/docs/development/apps/api/models/django-admin.html +60 -148
  69. nautobot/project-static/docs/development/apps/api/models/global-search.html +60 -148
  70. nautobot/project-static/docs/development/apps/api/models/graphql.html +60 -148
  71. nautobot/project-static/docs/development/apps/api/models/index.html +60 -148
  72. nautobot/project-static/docs/development/apps/api/nautobot-app-config.html +60 -148
  73. nautobot/project-static/docs/development/apps/api/platform-features/custom-validators.html +60 -148
  74. nautobot/project-static/docs/development/apps/api/platform-features/filter-extensions.html +60 -148
  75. nautobot/project-static/docs/development/apps/api/platform-features/git-repository-content.html +60 -148
  76. nautobot/project-static/docs/development/apps/api/platform-features/index.html +60 -148
  77. nautobot/project-static/docs/development/apps/api/platform-features/jinja2-filters.html +60 -148
  78. nautobot/project-static/docs/development/apps/api/platform-features/jobs.html +60 -148
  79. nautobot/project-static/docs/development/apps/api/platform-features/populating-extensibility-features.html +60 -148
  80. nautobot/project-static/docs/development/apps/api/platform-features/secrets-providers.html +60 -148
  81. nautobot/project-static/docs/development/apps/api/platform-features/uniquely-identify-objects.html +62 -150
  82. nautobot/project-static/docs/development/apps/api/prometheus.html +60 -148
  83. nautobot/project-static/docs/development/apps/api/setup.html +60 -148
  84. nautobot/project-static/docs/development/apps/api/testing.html +61 -149
  85. nautobot/project-static/docs/development/apps/api/ui-extensions/banners.html +60 -148
  86. nautobot/project-static/docs/development/apps/api/ui-extensions/home-page.html +60 -148
  87. nautobot/project-static/docs/development/apps/api/ui-extensions/index.html +60 -148
  88. nautobot/project-static/docs/development/apps/api/ui-extensions/navigation.html +60 -148
  89. nautobot/project-static/docs/development/apps/api/ui-extensions/object-views.html +60 -148
  90. nautobot/project-static/docs/development/apps/api/views/base-template.html +60 -148
  91. nautobot/project-static/docs/development/apps/api/views/core-view-overrides.html +60 -148
  92. nautobot/project-static/docs/development/apps/api/views/django-generic-views.html +60 -148
  93. nautobot/project-static/docs/development/apps/api/views/help-documentation.html +60 -148
  94. nautobot/project-static/docs/development/apps/api/views/index.html +60 -148
  95. nautobot/project-static/docs/development/apps/api/views/nautobot-generic-views.html +60 -148
  96. nautobot/project-static/docs/development/apps/api/views/nautobotuiviewset.html +60 -148
  97. nautobot/project-static/docs/development/apps/api/views/nautobotuiviewsetrouter.html +60 -148
  98. nautobot/project-static/docs/development/apps/api/views/notes.html +60 -148
  99. nautobot/project-static/docs/development/apps/api/views/rest-api.html +60 -148
  100. nautobot/project-static/docs/development/apps/api/views/urls.html +60 -148
  101. nautobot/project-static/docs/development/apps/index.html +61 -149
  102. nautobot/project-static/docs/development/apps/migration/code-updates.html +60 -148
  103. nautobot/project-static/docs/development/apps/migration/dependency-updates.html +60 -148
  104. nautobot/project-static/docs/development/apps/migration/from-v1.html +60 -148
  105. nautobot/project-static/docs/development/apps/migration/model-updates/dcim.html +60 -148
  106. nautobot/project-static/docs/development/apps/migration/model-updates/extras.html +60 -148
  107. nautobot/project-static/docs/development/apps/migration/model-updates/global.html +60 -148
  108. nautobot/project-static/docs/development/apps/migration/model-updates/ipam.html +60 -148
  109. nautobot/project-static/docs/development/apps/porting-from-netbox.html +60 -148
  110. nautobot/project-static/docs/development/core/application-registry.html +60 -148
  111. nautobot/project-static/docs/development/core/best-practices.html +60 -148
  112. nautobot/project-static/docs/development/core/bootstrap-ui.html +60 -148
  113. nautobot/project-static/docs/development/core/caching.html +60 -148
  114. nautobot/project-static/docs/development/core/controllers.html +60 -148
  115. nautobot/project-static/docs/development/core/docker-compose-advanced-use-cases.html +60 -148
  116. nautobot/project-static/docs/development/core/generic-views.html +60 -148
  117. nautobot/project-static/docs/development/core/getting-started.html +85 -169
  118. nautobot/project-static/docs/development/core/homepage.html +60 -148
  119. nautobot/project-static/docs/development/core/index.html +60 -148
  120. nautobot/project-static/docs/development/core/model-checklist.html +60 -148
  121. nautobot/project-static/docs/development/core/model-features.html +60 -148
  122. nautobot/project-static/docs/development/core/natural-keys.html +60 -148
  123. nautobot/project-static/docs/development/core/navigation-menu.html +60 -148
  124. nautobot/project-static/docs/development/core/release-checklist.html +60 -148
  125. nautobot/project-static/docs/development/core/role-internals.html +60 -148
  126. nautobot/project-static/docs/development/core/settings.html +60 -148
  127. nautobot/project-static/docs/development/core/style-guide.html +60 -148
  128. nautobot/project-static/docs/development/core/templates.html +60 -148
  129. nautobot/project-static/docs/development/core/testing.html +72 -152
  130. nautobot/project-static/docs/development/core/user-preferences.html +60 -148
  131. nautobot/project-static/docs/development/index.html +60 -148
  132. nautobot/project-static/docs/development/jobs/index.html +68 -156
  133. nautobot/project-static/docs/development/jobs/migration/from-v1.html +61 -149
  134. nautobot/project-static/docs/docker/index.html +3 -3
  135. nautobot/project-static/docs/index.html +60 -148
  136. nautobot/project-static/docs/installation/selinux-troubleshooting.html +3 -3
  137. nautobot/project-static/docs/overview/application_stack.html +60 -148
  138. nautobot/project-static/docs/overview/design_philosophy.html +60 -148
  139. nautobot/project-static/docs/release-notes/index.html +60 -148
  140. nautobot/project-static/docs/release-notes/version-1.0.html +60 -148
  141. nautobot/project-static/docs/release-notes/version-1.1.html +61 -149
  142. nautobot/project-static/docs/release-notes/version-1.2.html +63 -151
  143. nautobot/project-static/docs/release-notes/version-1.3.html +61 -149
  144. nautobot/project-static/docs/release-notes/version-1.4.html +62 -150
  145. nautobot/project-static/docs/release-notes/version-1.5.html +62 -150
  146. nautobot/project-static/docs/release-notes/version-1.6.html +64 -152
  147. nautobot/project-static/docs/release-notes/version-2.0.html +61 -149
  148. nautobot/project-static/docs/release-notes/version-2.1.html +62 -150
  149. nautobot/project-static/docs/release-notes/version-2.2.html +60 -148
  150. nautobot/project-static/docs/release-notes/version-2.3.html +475 -236
  151. nautobot/project-static/docs/search/search_index.json +1 -1
  152. nautobot/project-static/docs/sitemap.xml +277 -285
  153. nautobot/project-static/docs/sitemap.xml.gz +0 -0
  154. nautobot/project-static/docs/user-guide/administration/configuration/authentication/ldap.html +62 -150
  155. nautobot/project-static/docs/user-guide/administration/configuration/authentication/remote.html +61 -149
  156. nautobot/project-static/docs/user-guide/administration/configuration/authentication/sso.html +62 -150
  157. nautobot/project-static/docs/user-guide/administration/configuration/index.html +71 -169
  158. nautobot/project-static/docs/user-guide/administration/configuration/optional-settings.html +13 -12524
  159. nautobot/project-static/docs/user-guide/administration/configuration/redis.html +8966 -0
  160. nautobot/project-static/docs/user-guide/administration/configuration/required-settings.html +13 -9218
  161. nautobot/project-static/docs/user-guide/administration/configuration/settings.html +12734 -0
  162. nautobot/project-static/docs/user-guide/administration/configuration/time-zones.html +64 -152
  163. nautobot/project-static/docs/user-guide/administration/guides/caching.html +13 -9108
  164. nautobot/project-static/docs/user-guide/administration/guides/celery-queues.html +61 -149
  165. nautobot/project-static/docs/user-guide/administration/guides/docker.html +9491 -0
  166. nautobot/project-static/docs/user-guide/administration/guides/health-checks.html +9478 -0
  167. nautobot/project-static/docs/user-guide/administration/guides/healthcheck.html +13 -8833
  168. nautobot/project-static/docs/user-guide/administration/guides/permissions.html +64 -152
  169. nautobot/project-static/docs/user-guide/administration/guides/prometheus-metrics.html +61 -149
  170. nautobot/project-static/docs/user-guide/administration/guides/replicating-nautobot.html +61 -149
  171. nautobot/project-static/docs/user-guide/administration/guides/request-profiling.html +60 -148
  172. nautobot/project-static/docs/user-guide/administration/guides/s3-django-storage.html +60 -148
  173. nautobot/project-static/docs/user-guide/administration/guides/selinux-troubleshooting.html +8978 -0
  174. nautobot/project-static/docs/user-guide/administration/installation/app-install.html +60 -148
  175. nautobot/project-static/docs/user-guide/administration/installation/docker.html +3 -3
  176. nautobot/project-static/docs/user-guide/administration/installation/external-authentication.html +63 -151
  177. nautobot/project-static/docs/user-guide/administration/installation/health-checks.html +3 -3
  178. nautobot/project-static/docs/user-guide/administration/installation/http-server.html +61 -151
  179. nautobot/project-static/docs/user-guide/administration/installation/index.html +62 -150
  180. nautobot/project-static/docs/user-guide/administration/installation/install_system.html +60 -148
  181. nautobot/project-static/docs/user-guide/administration/installation/nautobot.html +76 -161
  182. nautobot/project-static/docs/user-guide/administration/installation/selinux-troubleshooting.html +3 -3
  183. nautobot/project-static/docs/user-guide/administration/installation/services.html +62 -150
  184. nautobot/project-static/docs/user-guide/administration/installation-extras/docker.html +13 -9577
  185. nautobot/project-static/docs/user-guide/administration/installation-extras/health-checks.html +13 -9560
  186. nautobot/project-static/docs/user-guide/administration/installation-extras/selinux-troubleshooting.html +13 -9064
  187. nautobot/project-static/docs/user-guide/administration/migration/migrating-from-netbox.html +62 -150
  188. nautobot/project-static/docs/user-guide/administration/migration/migrating-from-postgresql.html +60 -148
  189. nautobot/project-static/docs/user-guide/administration/tools/nautobot-server.html +66 -154
  190. nautobot/project-static/docs/user-guide/administration/tools/nautobot-shell.html +63 -151
  191. nautobot/project-static/docs/user-guide/administration/upgrading/database-backup.html +66 -154
  192. nautobot/project-static/docs/user-guide/administration/upgrading/from-v1/ipam/after-you-upgrade.html +63 -151
  193. nautobot/project-static/docs/user-guide/administration/upgrading/from-v1/ipam/before-you-upgrade.html +63 -151
  194. nautobot/project-static/docs/user-guide/administration/upgrading/from-v1/ipam/for-developers.html +63 -151
  195. nautobot/project-static/docs/user-guide/administration/upgrading/from-v1/ipam/index.html +63 -151
  196. nautobot/project-static/docs/user-guide/administration/upgrading/from-v1/ipam/whats-changed.html +63 -151
  197. nautobot/project-static/docs/user-guide/administration/upgrading/from-v1/region-and-site-data-migration-guide.html +63 -151
  198. nautobot/project-static/docs/user-guide/administration/upgrading/from-v1/upgrading-from-nautobot-v1.html +65 -153
  199. nautobot/project-static/docs/user-guide/administration/upgrading/upgrading.html +63 -151
  200. nautobot/project-static/docs/user-guide/core-data-model/circuits/circuit.html +60 -148
  201. nautobot/project-static/docs/user-guide/core-data-model/circuits/circuittermination.html +60 -148
  202. nautobot/project-static/docs/user-guide/core-data-model/circuits/circuittype.html +60 -148
  203. nautobot/project-static/docs/user-guide/core-data-model/circuits/provider.html +60 -148
  204. nautobot/project-static/docs/user-guide/core-data-model/circuits/providernetwork.html +60 -148
  205. nautobot/project-static/docs/user-guide/core-data-model/cloud/cloud.html +60 -148
  206. nautobot/project-static/docs/user-guide/core-data-model/cloud/cloudaccount.html +60 -148
  207. nautobot/project-static/docs/user-guide/core-data-model/cloud/cloudnetwork.html +60 -148
  208. nautobot/project-static/docs/user-guide/core-data-model/cloud/cloudnetworkprefixassignment.html +60 -148
  209. nautobot/project-static/docs/user-guide/core-data-model/cloud/cloudresourcetype.html +60 -148
  210. nautobot/project-static/docs/user-guide/core-data-model/cloud/cloudservice.html +60 -148
  211. nautobot/project-static/docs/user-guide/core-data-model/cloud/cloudservicenetworkassignment.html +60 -148
  212. nautobot/project-static/docs/user-guide/core-data-model/dcim/cable.html +60 -148
  213. nautobot/project-static/docs/user-guide/core-data-model/dcim/consoleport.html +60 -148
  214. nautobot/project-static/docs/user-guide/core-data-model/dcim/consoleporttemplate.html +60 -148
  215. nautobot/project-static/docs/user-guide/core-data-model/dcim/consoleserverport.html +60 -148
  216. nautobot/project-static/docs/user-guide/core-data-model/dcim/consoleserverporttemplate.html +60 -148
  217. nautobot/project-static/docs/user-guide/core-data-model/dcim/controller.html +60 -148
  218. nautobot/project-static/docs/user-guide/core-data-model/dcim/controllermanageddevicegroup.html +60 -148
  219. nautobot/project-static/docs/user-guide/core-data-model/dcim/device.html +60 -148
  220. nautobot/project-static/docs/user-guide/core-data-model/dcim/devicebay.html +60 -148
  221. nautobot/project-static/docs/user-guide/core-data-model/dcim/devicebaytemplate.html +60 -148
  222. nautobot/project-static/docs/user-guide/core-data-model/dcim/devicefamily.html +60 -148
  223. nautobot/project-static/docs/user-guide/core-data-model/dcim/deviceredundancygroup.html +60 -148
  224. nautobot/project-static/docs/user-guide/core-data-model/dcim/devicetype.html +60 -148
  225. nautobot/project-static/docs/user-guide/core-data-model/dcim/frontport.html +60 -148
  226. nautobot/project-static/docs/user-guide/core-data-model/dcim/frontporttemplate.html +60 -148
  227. nautobot/project-static/docs/user-guide/core-data-model/dcim/interface.html +60 -148
  228. nautobot/project-static/docs/user-guide/core-data-model/dcim/interfaceredundancygroup.html +60 -148
  229. nautobot/project-static/docs/user-guide/core-data-model/dcim/interfacetemplate.html +60 -148
  230. nautobot/project-static/docs/user-guide/core-data-model/dcim/inventoryitem.html +60 -148
  231. nautobot/project-static/docs/user-guide/core-data-model/dcim/location.html +60 -148
  232. nautobot/project-static/docs/user-guide/core-data-model/dcim/locationtype.html +60 -148
  233. nautobot/project-static/docs/user-guide/core-data-model/dcim/manufacturer.html +60 -148
  234. nautobot/project-static/docs/user-guide/core-data-model/dcim/module.html +60 -148
  235. nautobot/project-static/docs/user-guide/core-data-model/dcim/modulebay.html +60 -148
  236. nautobot/project-static/docs/user-guide/core-data-model/dcim/modulebaytemplate.html +60 -148
  237. nautobot/project-static/docs/user-guide/core-data-model/dcim/moduletype.html +60 -148
  238. nautobot/project-static/docs/user-guide/core-data-model/dcim/platform.html +61 -149
  239. nautobot/project-static/docs/user-guide/core-data-model/dcim/powerfeed.html +60 -148
  240. nautobot/project-static/docs/user-guide/core-data-model/dcim/poweroutlet.html +60 -148
  241. nautobot/project-static/docs/user-guide/core-data-model/dcim/poweroutlettemplate.html +60 -148
  242. nautobot/project-static/docs/user-guide/core-data-model/dcim/powerpanel.html +60 -148
  243. nautobot/project-static/docs/user-guide/core-data-model/dcim/powerport.html +60 -148
  244. nautobot/project-static/docs/user-guide/core-data-model/dcim/powerporttemplate.html +60 -148
  245. nautobot/project-static/docs/user-guide/core-data-model/dcim/rack.html +60 -148
  246. nautobot/project-static/docs/user-guide/core-data-model/dcim/rackgroup.html +60 -148
  247. nautobot/project-static/docs/user-guide/core-data-model/dcim/rackreservation.html +60 -148
  248. nautobot/project-static/docs/user-guide/core-data-model/dcim/rearport.html +60 -148
  249. nautobot/project-static/docs/user-guide/core-data-model/dcim/rearporttemplate.html +60 -148
  250. nautobot/project-static/docs/user-guide/core-data-model/dcim/softwareimagefile.html +60 -148
  251. nautobot/project-static/docs/user-guide/core-data-model/dcim/softwareversion.html +60 -148
  252. nautobot/project-static/docs/user-guide/core-data-model/dcim/virtualchassis.html +60 -148
  253. nautobot/project-static/docs/user-guide/core-data-model/extras/configcontext.html +61 -149
  254. nautobot/project-static/docs/user-guide/core-data-model/extras/configcontextschema.html +60 -148
  255. nautobot/project-static/docs/user-guide/core-data-model/extras/contact.html +60 -148
  256. nautobot/project-static/docs/user-guide/core-data-model/extras/team.html +60 -148
  257. nautobot/project-static/docs/user-guide/core-data-model/ipam/ipaddress.html +60 -148
  258. nautobot/project-static/docs/user-guide/core-data-model/ipam/namespace.html +60 -148
  259. nautobot/project-static/docs/user-guide/core-data-model/ipam/prefix.html +60 -148
  260. nautobot/project-static/docs/user-guide/core-data-model/ipam/rir.html +60 -148
  261. nautobot/project-static/docs/user-guide/core-data-model/ipam/routetarget.html +60 -148
  262. nautobot/project-static/docs/user-guide/core-data-model/ipam/service.html +60 -148
  263. nautobot/project-static/docs/user-guide/core-data-model/ipam/vlan.html +60 -148
  264. nautobot/project-static/docs/user-guide/core-data-model/ipam/vlangroup.html +60 -148
  265. nautobot/project-static/docs/user-guide/core-data-model/ipam/vrf.html +60 -148
  266. nautobot/project-static/docs/user-guide/core-data-model/overview/introduction.html +60 -148
  267. nautobot/project-static/docs/user-guide/core-data-model/tenancy/tenant.html +60 -148
  268. nautobot/project-static/docs/user-guide/core-data-model/tenancy/tenantgroup.html +60 -148
  269. nautobot/project-static/docs/user-guide/core-data-model/virtualization/cluster.html +60 -148
  270. nautobot/project-static/docs/user-guide/core-data-model/virtualization/clustergroup.html +60 -148
  271. nautobot/project-static/docs/user-guide/core-data-model/virtualization/clustertype.html +60 -148
  272. nautobot/project-static/docs/user-guide/core-data-model/virtualization/virtualmachine.html +60 -148
  273. nautobot/project-static/docs/user-guide/core-data-model/virtualization/vminterface.html +60 -148
  274. nautobot/project-static/docs/user-guide/feature-guides/contacts-and-teams.html +60 -148
  275. nautobot/project-static/docs/user-guide/feature-guides/custom-fields.html +60 -148
  276. nautobot/project-static/docs/user-guide/feature-guides/getting-started/creating-devices.html +60 -148
  277. nautobot/project-static/docs/user-guide/feature-guides/getting-started/creating-location-types-and-locations.html +60 -148
  278. nautobot/project-static/docs/user-guide/feature-guides/getting-started/index.html +60 -148
  279. nautobot/project-static/docs/user-guide/feature-guides/getting-started/interfaces.html +60 -148
  280. nautobot/project-static/docs/user-guide/feature-guides/getting-started/ipam.html +60 -148
  281. nautobot/project-static/docs/user-guide/feature-guides/getting-started/platforms.html +60 -148
  282. nautobot/project-static/docs/user-guide/feature-guides/getting-started/search-bar.html +60 -148
  283. nautobot/project-static/docs/user-guide/feature-guides/getting-started/tenants.html +60 -148
  284. nautobot/project-static/docs/user-guide/feature-guides/getting-started/vlans-and-vlan-groups.html +60 -148
  285. nautobot/project-static/docs/user-guide/feature-guides/git-data-source.html +61 -149
  286. nautobot/project-static/docs/user-guide/feature-guides/graphql.html +60 -148
  287. nautobot/project-static/docs/user-guide/feature-guides/ip-address-merge-tool.html +60 -148
  288. nautobot/project-static/docs/user-guide/feature-guides/relationships.html +60 -148
  289. nautobot/project-static/docs/user-guide/feature-guides/software-image-files-and-versions.html +60 -148
  290. nautobot/project-static/docs/user-guide/index.html +60 -148
  291. nautobot/project-static/docs/user-guide/platform-functionality/change-logging.html +60 -148
  292. nautobot/project-static/docs/user-guide/platform-functionality/computedfield.html +60 -148
  293. nautobot/project-static/docs/user-guide/platform-functionality/customfield.html +60 -148
  294. nautobot/project-static/docs/user-guide/platform-functionality/customlink.html +60 -148
  295. nautobot/project-static/docs/user-guide/platform-functionality/dynamicgroup.html +61 -149
  296. nautobot/project-static/docs/user-guide/platform-functionality/exporttemplate.html +60 -148
  297. nautobot/project-static/docs/user-guide/platform-functionality/externalintegration.html +60 -148
  298. nautobot/project-static/docs/user-guide/platform-functionality/gitrepository.html +61 -149
  299. nautobot/project-static/docs/user-guide/platform-functionality/graphql.html +62 -150
  300. nautobot/project-static/docs/user-guide/platform-functionality/graphqlquery.html +60 -148
  301. nautobot/project-static/docs/user-guide/platform-functionality/imageattachment.html +61 -149
  302. nautobot/project-static/docs/user-guide/platform-functionality/jobs/index.html +60 -148
  303. nautobot/project-static/docs/user-guide/platform-functionality/jobs/job-scheduling-and-approvals.html +60 -148
  304. nautobot/project-static/docs/user-guide/platform-functionality/jobs/jobbutton.html +60 -148
  305. nautobot/project-static/docs/user-guide/platform-functionality/jobs/jobhook.html +60 -148
  306. nautobot/project-static/docs/user-guide/platform-functionality/jobs/models.html +60 -148
  307. nautobot/project-static/docs/user-guide/platform-functionality/napalm.html +61 -149
  308. nautobot/project-static/docs/user-guide/platform-functionality/note.html +60 -148
  309. nautobot/project-static/docs/user-guide/platform-functionality/objectmetadata.html +60 -148
  310. nautobot/project-static/docs/user-guide/platform-functionality/relationship.html +60 -148
  311. nautobot/project-static/docs/user-guide/platform-functionality/rest-api/authentication.html +61 -149
  312. nautobot/project-static/docs/user-guide/platform-functionality/rest-api/filtering.html +61 -149
  313. nautobot/project-static/docs/user-guide/platform-functionality/rest-api/overview.html +62 -150
  314. nautobot/project-static/docs/user-guide/platform-functionality/rest-api/ui-related-endpoints.html +60 -148
  315. nautobot/project-static/docs/user-guide/platform-functionality/role.html +60 -148
  316. nautobot/project-static/docs/user-guide/platform-functionality/savedview.html +60 -148
  317. nautobot/project-static/docs/user-guide/platform-functionality/secret.html +60 -148
  318. nautobot/project-static/docs/user-guide/platform-functionality/staticgroupassociation.html +60 -148
  319. nautobot/project-static/docs/user-guide/platform-functionality/status.html +60 -148
  320. nautobot/project-static/docs/user-guide/platform-functionality/tag.html +60 -148
  321. nautobot/project-static/docs/user-guide/platform-functionality/template-filters.html +60 -148
  322. nautobot/project-static/docs/user-guide/platform-functionality/users/objectpermission.html +60 -148
  323. nautobot/project-static/docs/user-guide/platform-functionality/users/token.html +60 -148
  324. nautobot/project-static/docs/user-guide/platform-functionality/webhook.html +60 -148
  325. nautobot/virtualization/filters.py +6 -1
  326. nautobot/virtualization/tables.py +2 -2
  327. {nautobot-2.3.3.dist-info → nautobot-2.3.5.dist-info}/METADATA +2 -2
  328. {nautobot-2.3.3.dist-info → nautobot-2.3.5.dist-info}/RECORD +332 -328
  329. nautobot/project-static/docs/user-guide/administration/configuration/render-settings-fragment.j2 +0 -76
  330. {nautobot-2.3.3.dist-info → nautobot-2.3.5.dist-info}/LICENSE.txt +0 -0
  331. {nautobot-2.3.3.dist-info → nautobot-2.3.5.dist-info}/NOTICE +0 -0
  332. {nautobot-2.3.3.dist-info → nautobot-2.3.5.dist-info}/WHEEL +0 -0
  333. {nautobot-2.3.3.dist-info → nautobot-2.3.5.dist-info}/entry_points.txt +0 -0
@@ -18,7 +18,7 @@
18
18
 
19
19
 
20
20
  <link rel="icon" href="../../assets/favicon.ico">
21
- <meta name="generator" content="mkdocs-1.6.1, mkdocs-material-9.5.34">
21
+ <meta name="generator" content="mkdocs-1.6.1, mkdocs-material-9.5.35">
22
22
 
23
23
 
24
24
 
@@ -783,7 +783,7 @@
783
783
 
784
784
 
785
785
  <span class="md-ellipsis">
786
- Installation Extras
786
+ Upgrading
787
787
  </span>
788
788
 
789
789
 
@@ -792,115 +792,6 @@
792
792
 
793
793
  <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_2_1_2_label" aria-expanded="false">
794
794
  <label class="md-nav__title" for="__nav_2_1_2">
795
- <span class="md-nav__icon md-icon"></span>
796
- Installation Extras
797
- </label>
798
- <ul class="md-nav__list" data-md-scrollfix>
799
-
800
-
801
-
802
-
803
-
804
-
805
-
806
- <li class="md-nav__item">
807
- <a href="../../user-guide/administration/installation-extras/docker.html" class="md-nav__link">
808
-
809
-
810
- <span class="md-ellipsis">
811
- Nautobot Docker Images
812
- </span>
813
-
814
-
815
- </a>
816
- </li>
817
-
818
-
819
-
820
-
821
-
822
-
823
-
824
-
825
-
826
-
827
- <li class="md-nav__item">
828
- <a href="../../user-guide/administration/installation-extras/health-checks.html" class="md-nav__link">
829
-
830
-
831
- <span class="md-ellipsis">
832
- Health Checks
833
- </span>
834
-
835
-
836
- </a>
837
- </li>
838
-
839
-
840
-
841
-
842
-
843
-
844
-
845
-
846
-
847
-
848
- <li class="md-nav__item">
849
- <a href="../../user-guide/administration/installation-extras/selinux-troubleshooting.html" class="md-nav__link">
850
-
851
-
852
- <span class="md-ellipsis">
853
- SELinux Troubleshooting
854
- </span>
855
-
856
-
857
- </a>
858
- </li>
859
-
860
-
861
-
862
-
863
- </ul>
864
- </nav>
865
-
866
- </li>
867
-
868
-
869
-
870
-
871
-
872
-
873
-
874
-
875
-
876
-
877
-
878
-
879
-
880
-
881
-
882
-
883
-
884
- <li class="md-nav__item md-nav__item--nested">
885
-
886
-
887
-
888
- <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2_1_3" >
889
-
890
-
891
- <label class="md-nav__link" for="__nav_2_1_3" id="__nav_2_1_3_label" tabindex="0">
892
-
893
-
894
- <span class="md-ellipsis">
895
- Upgrading
896
- </span>
897
-
898
-
899
- <span class="md-nav__icon md-icon"></span>
900
- </label>
901
-
902
- <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_2_1_3_label" aria-expanded="false">
903
- <label class="md-nav__title" for="__nav_2_1_3">
904
795
  <span class="md-nav__icon md-icon"></span>
905
796
  Upgrading
906
797
  </label>
@@ -965,7 +856,7 @@
965
856
 
966
857
 
967
858
 
968
- <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2_1_3_3" >
859
+ <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2_1_2_3" >
969
860
 
970
861
 
971
862
 
@@ -981,14 +872,14 @@
981
872
  </a>
982
873
 
983
874
 
984
- <label class="md-nav__link " for="__nav_2_1_3_3" id="__nav_2_1_3_3_label" tabindex="0">
875
+ <label class="md-nav__link " for="__nav_2_1_2_3" id="__nav_2_1_2_3_label" tabindex="0">
985
876
  <span class="md-nav__icon md-icon"></span>
986
877
  </label>
987
878
 
988
879
  </div>
989
880
 
990
- <nav class="md-nav" data-md-level="4" aria-labelledby="__nav_2_1_3_3_label" aria-expanded="false">
991
- <label class="md-nav__title" for="__nav_2_1_3_3">
881
+ <nav class="md-nav" data-md-level="4" aria-labelledby="__nav_2_1_2_3_label" aria-expanded="false">
882
+ <label class="md-nav__title" for="__nav_2_1_2_3">
992
883
  <span class="md-nav__icon md-icon"></span>
993
884
  Upgrading Nautobot from v1.X to v2.0
994
885
  </label>
@@ -1032,7 +923,7 @@
1032
923
 
1033
924
 
1034
925
 
1035
- <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2_1_3_3_2" >
926
+ <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2_1_2_3_2" >
1036
927
 
1037
928
 
1038
929
 
@@ -1048,14 +939,14 @@
1048
939
  </a>
1049
940
 
1050
941
 
1051
- <label class="md-nav__link " for="__nav_2_1_3_3_2" id="__nav_2_1_3_3_2_label" tabindex="0">
942
+ <label class="md-nav__link " for="__nav_2_1_2_3_2" id="__nav_2_1_2_3_2_label" tabindex="0">
1052
943
  <span class="md-nav__icon md-icon"></span>
1053
944
  </label>
1054
945
 
1055
946
  </div>
1056
947
 
1057
- <nav class="md-nav" data-md-level="5" aria-labelledby="__nav_2_1_3_3_2_label" aria-expanded="false">
1058
- <label class="md-nav__title" for="__nav_2_1_3_3_2">
948
+ <nav class="md-nav" data-md-level="5" aria-labelledby="__nav_2_1_2_3_2_label" aria-expanded="false">
949
+ <label class="md-nav__title" for="__nav_2_1_2_3_2">
1059
950
  <span class="md-nav__icon md-icon"></span>
1060
951
  IPAM Migration Guide
1061
952
  </label>
@@ -1186,10 +1077,10 @@
1186
1077
 
1187
1078
 
1188
1079
 
1189
- <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2_1_4" >
1080
+ <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2_1_3" >
1190
1081
 
1191
1082
 
1192
- <label class="md-nav__link" for="__nav_2_1_4" id="__nav_2_1_4_label" tabindex="0">
1083
+ <label class="md-nav__link" for="__nav_2_1_3" id="__nav_2_1_3_label" tabindex="0">
1193
1084
 
1194
1085
 
1195
1086
  <span class="md-ellipsis">
@@ -1200,8 +1091,8 @@
1200
1091
  <span class="md-nav__icon md-icon"></span>
1201
1092
  </label>
1202
1093
 
1203
- <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_2_1_4_label" aria-expanded="false">
1204
- <label class="md-nav__title" for="__nav_2_1_4">
1094
+ <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_2_1_3_label" aria-expanded="false">
1095
+ <label class="md-nav__title" for="__nav_2_1_3">
1205
1096
  <span class="md-nav__icon md-icon"></span>
1206
1097
  Migration
1207
1098
  </label>
@@ -1274,7 +1165,7 @@
1274
1165
 
1275
1166
 
1276
1167
 
1277
- <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2_1_5" >
1168
+ <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2_1_4" >
1278
1169
 
1279
1170
 
1280
1171
 
@@ -1290,14 +1181,14 @@
1290
1181
  </a>
1291
1182
 
1292
1183
 
1293
- <label class="md-nav__link " for="__nav_2_1_5" id="__nav_2_1_5_label" tabindex="0">
1184
+ <label class="md-nav__link " for="__nav_2_1_4" id="__nav_2_1_4_label" tabindex="0">
1294
1185
  <span class="md-nav__icon md-icon"></span>
1295
1186
  </label>
1296
1187
 
1297
1188
  </div>
1298
1189
 
1299
- <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_2_1_5_label" aria-expanded="false">
1300
- <label class="md-nav__title" for="__nav_2_1_5">
1190
+ <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_2_1_4_label" aria-expanded="false">
1191
+ <label class="md-nav__title" for="__nav_2_1_4">
1301
1192
  <span class="md-nav__icon md-icon"></span>
1302
1193
  Configuration
1303
1194
  </label>
@@ -1310,11 +1201,11 @@
1310
1201
 
1311
1202
 
1312
1203
  <li class="md-nav__item">
1313
- <a href="../../user-guide/administration/configuration/required-settings.html" class="md-nav__link">
1204
+ <a href="../../user-guide/administration/configuration/settings.html" class="md-nav__link">
1314
1205
 
1315
1206
 
1316
1207
  <span class="md-ellipsis">
1317
- Required Settings
1208
+ Settings
1318
1209
  </span>
1319
1210
 
1320
1211
 
@@ -1331,11 +1222,11 @@
1331
1222
 
1332
1223
 
1333
1224
  <li class="md-nav__item">
1334
- <a href="../../user-guide/administration/configuration/optional-settings.html" class="md-nav__link">
1225
+ <a href="../../user-guide/administration/configuration/redis.html" class="md-nav__link">
1335
1226
 
1336
1227
 
1337
1228
  <span class="md-ellipsis">
1338
- Optional Settings
1229
+ Redis
1339
1230
  </span>
1340
1231
 
1341
1232
 
@@ -1383,10 +1274,10 @@
1383
1274
 
1384
1275
 
1385
1276
 
1386
- <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2_1_5_4" >
1277
+ <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2_1_4_4" >
1387
1278
 
1388
1279
 
1389
- <label class="md-nav__link" for="__nav_2_1_5_4" id="__nav_2_1_5_4_label" tabindex="0">
1280
+ <label class="md-nav__link" for="__nav_2_1_4_4" id="__nav_2_1_4_4_label" tabindex="0">
1390
1281
 
1391
1282
 
1392
1283
  <span class="md-ellipsis">
@@ -1397,8 +1288,8 @@
1397
1288
  <span class="md-nav__icon md-icon"></span>
1398
1289
  </label>
1399
1290
 
1400
- <nav class="md-nav" data-md-level="4" aria-labelledby="__nav_2_1_5_4_label" aria-expanded="false">
1401
- <label class="md-nav__title" for="__nav_2_1_5_4">
1291
+ <nav class="md-nav" data-md-level="4" aria-labelledby="__nav_2_1_4_4_label" aria-expanded="false">
1292
+ <label class="md-nav__title" for="__nav_2_1_4_4">
1402
1293
  <span class="md-nav__icon md-icon"></span>
1403
1294
  External Authentication
1404
1295
  </label>
@@ -1500,10 +1391,10 @@
1500
1391
 
1501
1392
 
1502
1393
 
1503
- <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2_1_6" >
1394
+ <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2_1_5" >
1504
1395
 
1505
1396
 
1506
- <label class="md-nav__link" for="__nav_2_1_6" id="__nav_2_1_6_label" tabindex="0">
1397
+ <label class="md-nav__link" for="__nav_2_1_5" id="__nav_2_1_5_label" tabindex="0">
1507
1398
 
1508
1399
 
1509
1400
  <span class="md-ellipsis">
@@ -1514,8 +1405,8 @@
1514
1405
  <span class="md-nav__icon md-icon"></span>
1515
1406
  </label>
1516
1407
 
1517
- <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_2_1_6_label" aria-expanded="false">
1518
- <label class="md-nav__title" for="__nav_2_1_6">
1408
+ <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_2_1_5_label" aria-expanded="false">
1409
+ <label class="md-nav__title" for="__nav_2_1_5">
1519
1410
  <span class="md-nav__icon md-icon"></span>
1520
1411
  Tools
1521
1412
  </label>
@@ -1588,10 +1479,10 @@
1588
1479
 
1589
1480
 
1590
1481
 
1591
- <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2_1_7" >
1482
+ <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2_1_6" >
1592
1483
 
1593
1484
 
1594
- <label class="md-nav__link" for="__nav_2_1_7" id="__nav_2_1_7_label" tabindex="0">
1485
+ <label class="md-nav__link" for="__nav_2_1_6" id="__nav_2_1_6_label" tabindex="0">
1595
1486
 
1596
1487
 
1597
1488
  <span class="md-ellipsis">
@@ -1602,8 +1493,8 @@
1602
1493
  <span class="md-nav__icon md-icon"></span>
1603
1494
  </label>
1604
1495
 
1605
- <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_2_1_7_label" aria-expanded="false">
1606
- <label class="md-nav__title" for="__nav_2_1_7">
1496
+ <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_2_1_6_label" aria-expanded="false">
1497
+ <label class="md-nav__title" for="__nav_2_1_6">
1607
1498
  <span class="md-nav__icon md-icon"></span>
1608
1499
  Guides
1609
1500
  </label>
@@ -1616,11 +1507,32 @@
1616
1507
 
1617
1508
 
1618
1509
  <li class="md-nav__item">
1619
- <a href="../../user-guide/administration/guides/caching.html" class="md-nav__link">
1510
+ <a href="../../user-guide/administration/guides/docker.html" class="md-nav__link">
1620
1511
 
1621
1512
 
1622
1513
  <span class="md-ellipsis">
1623
- Caching
1514
+ Nautobot Docker Images
1515
+ </span>
1516
+
1517
+
1518
+ </a>
1519
+ </li>
1520
+
1521
+
1522
+
1523
+
1524
+
1525
+
1526
+
1527
+
1528
+
1529
+
1530
+ <li class="md-nav__item">
1531
+ <a href="../../user-guide/administration/guides/selinux-troubleshooting.html" class="md-nav__link">
1532
+
1533
+
1534
+ <span class="md-ellipsis">
1535
+ SELinux Troubleshooting
1624
1536
  </span>
1625
1537
 
1626
1538
 
@@ -1637,11 +1549,11 @@
1637
1549
 
1638
1550
 
1639
1551
  <li class="md-nav__item">
1640
- <a href="../../user-guide/administration/guides/healthcheck.html" class="md-nav__link">
1552
+ <a href="../../user-guide/administration/guides/health-checks.html" class="md-nav__link">
1641
1553
 
1642
1554
 
1643
1555
  <span class="md-ellipsis">
1644
- Health Check
1556
+ Health Checks
1645
1557
  </span>
1646
1558
 
1647
1559
 
@@ -10046,11 +9958,11 @@
10046
9958
  <h5 id="required-settings">Required Settings<a class="headerlink" href="#required-settings" title="Permanent link">&para;</a></h5>
10047
9959
  <p>A newly created configuration includes sane defaults. If you need to customize them, edit your <code>nautobot_config.py</code> and update the following settings as required:</p>
10048
9960
  <ul>
10049
- <li><a href="../../user-guide/administration/configuration/required-settings.html#allowed_hosts"><code>ALLOWED_HOSTS</code></a>: This can be set to <code>["*"]</code> for development purposes and must be set if <code>DEBUG=False</code></li>
10050
- <li><a href="../../user-guide/administration/configuration/required-settings.html#databases"><code>DATABASES</code></a>: Database connection parameters, if different from the defaults</li>
9961
+ <li><a href="../../user-guide/administration/configuration/settings.html#allowed_hosts"><code>ALLOWED_HOSTS</code></a>: This can be set to <code>["*"]</code> for development purposes and must be set if <code>DEBUG=False</code></li>
9962
+ <li><a href="../../user-guide/administration/configuration/settings.html#databases"><code>DATABASES</code></a>: Database connection parameters, if different from the defaults</li>
10051
9963
  <li><strong>Redis settings</strong>: Redis configuration requires multiple settings. The defaults should be fine for development.</li>
10052
- <li><a href="../../user-guide/administration/configuration/optional-settings.html#debug"><code>DEBUG</code></a>: Set to <code>True</code> to enable verbose exception logging and, if installed, the <a href="https://django-debug-toolbar.readthedocs.io/en/latest/">Django debug toolbar</a></li>
10053
- <li><a href="../../user-guide/administration/configuration/optional-settings.html#extra-applications"><code>EXTRA_INSTALLED_APPS</code></a>: Optionally provide a list of extra Django apps you may desire to use for development</li>
9964
+ <li><a href="../../user-guide/administration/configuration/settings.html#debug"><code>DEBUG</code></a>: Set to <code>True</code> to enable verbose exception logging and, if installed, the <a href="https://django-debug-toolbar.readthedocs.io/en/latest/">Django debug toolbar</a></li>
9965
+ <li><a href="../../user-guide/administration/configuration/settings.html#extra-applications"><code>EXTRA_INSTALLED_APPS</code></a>: Optionally provide a list of extra Django apps you may desire to use for development</li>
10054
9966
  </ul>
10055
9967
  <h2 id="working-in-your-development-environment">Working in your Development Environment<a class="headerlink" href="#working-in-your-development-environment" title="Permanent link">&para;</a></h2>
10056
9968
  <p>Below are common commands for working your development environment.</p>
@@ -10237,34 +10149,38 @@
10237
10149
  <h5 id="useful-unit-test-parameters">Useful Unit Test Parameters<a class="headerlink" href="#useful-unit-test-parameters" title="Permanent link">&para;</a></h5>
10238
10150
  <p>The <code>invoke unittest</code> command supports a number of optional parameters to influence its behavior. Careful use of these parameters can greatly reduce the time it takes to run and re-run tests during development.</p>
10239
10151
  <ul>
10240
- <li><code>--cache-test-fixtures</code> - Cache <a href="testing.html#factory-caching">test factory data</a> to disk, or if a cache is already present, load from that cache when initializing the test environment. Can significantly improve the initial startup time of the test suite after your first test run.</li>
10241
10152
  <li><code>--failfast</code> - Fail as soon as any test failure or error condition is encountered, instead of running to completion.</li>
10242
- <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>
10243
10153
  <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>
10244
10154
  <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>
10245
- <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>
10246
- <li><code>--parallel-workers</code> - Specify the number of workers to use when running tests in parallel. Implies <code>--parallel</code>.</li>
10155
+ <li><code>--no-cache-test-fixtures</code> - Prevent caching <a href="testing.html#factory-caching">test factory data</a> to disk, or if a cache is already present, prevent loading from that cache when initializing the test environment. <strong>The <code>--no-cache-test-fixtures</code> option is mandatory if you're actively making changes to factories or model migrations.</strong></li>
10156
+ <li><code>--no-keepdb</code> - Prevent saving the initialized test database after a test run for later reuse in a test re-run.</li>
10157
+ <li><code>--no-parallel</code> - By default, Nautobot splits test execution across multiple parallel subprocesses to reduce the runtime of the test suite. When troubleshooting obscure test exceptions, it may be desirable to disable that behavior temporarily using this parameter.</li>
10158
+ <li><code>--parallel-workers</code> - Explicitly specify the number of workers to use when running tests in parallel.</li>
10247
10159
  <li><code>--pattern</code> - Only run tests which match the given substring. Can be used multiple times.</li>
10160
+ <li><code>--no-reusedb</code> - Prevent reusing the initialized test database from a previous test run; instead, create a new database. <strong>The <code>--no-reusedb</code> option is mandatory if you're actively making changes to model migrations, or when switching between branches that differ in their included migrations.</strong></li>
10248
10161
  <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>
10249
10162
  <li><code>--verbose</code> - Run tests more verbosely, including describing each test case as it is run.</li>
10250
10163
  </ul>
10251
10164
  <h5 id="unit-test-invocation-examples">Unit Test Invocation Examples<a class="headerlink" href="#unit-test-invocation-examples" title="Permanent link">&para;</a></h5>
10252
10165
  <p>In general, when you first run the Nautobot tests in your local copy of the repository, we'd recommend:</p>
10253
- <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
10166
+ <div class="highlight"><pre><span></span><code><a id="__codelineno-43-1" name="__codelineno-43-1" href="#__codelineno-43-1"></a>invoke unittest
10254
10167
  </code></pre></div>
10255
10168
  <p>When there are too many cores on the testing machine, you can limit the number of parallel workers:</p>
10256
- <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
10169
+ <div class="highlight"><pre><span></span><code><a id="__codelineno-44-1" name="__codelineno-44-1" href="#__codelineno-44-1"></a>invoke unittest --parallel-workers 4
10257
10170
  </code></pre></div>
10258
10171
  <p>On subsequent reruns, you can add the other performance-related options:</p>
10259
- <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
10260
- <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
10172
+ <div class="highlight"><pre><span></span><code><a id="__codelineno-45-1" name="__codelineno-45-1" href="#__codelineno-45-1"></a>invoke unittest --skip-docs-build
10173
+ <a id="__codelineno-45-2" name="__codelineno-45-2" href="#__codelineno-45-2"></a>invoke unittest --skip-docs-build --label nautobot.core.tests
10174
+ </code></pre></div>
10175
+ <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 for once include the <code>--no-keepdb</code> option so that the test database can be destroyed and recreated appropriately:</p>
10176
+ <div class="highlight"><pre><span></span><code><a id="__codelineno-46-1" name="__codelineno-46-1" href="#__codelineno-46-1"></a>invoke unittest --no-keepdb
10261
10177
  </code></pre></div>
10262
- <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 for once omit the <code>--keepdb</code> option so that the test database can be destroyed and recreated appropriately:</p>
10263
- <div class="highlight"><pre><span></span><code><a id="__codelineno-46-1" name="__codelineno-46-1" href="#__codelineno-46-1"></a>invoke unittest --cache-test-fixtures --parallel
10178
+ <p>To not use the cached test fixture, you will need to include the <code>--no-cache-test-fixtures</code> flag</p>
10179
+ <div class="highlight"><pre><span></span><code><a id="__codelineno-47-1" name="__codelineno-47-1" href="#__codelineno-47-1"></a>invoke unittest --no-cache-test-fixtures
10264
10180
  </code></pre></div>
10265
10181
  <p>To limit the test to a specific pattern or label, you can use the <code>--label</code> and <code>--pattern</code> options:</p>
10266
- <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
10267
- <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
10182
+ <div class="highlight"><pre><span></span><code><a id="__codelineno-48-1" name="__codelineno-48-1" href="#__codelineno-48-1"></a>invoke unittest --verbose --skip-docs-build --label nautobot.core.tests.dcim.test_views.DeviceTestCase
10183
+ <a id="__codelineno-48-2" name="__codelineno-48-2" href="#__codelineno-48-2"></a>invoke unittest --verbose --skip-docs-build --pattern Controller
10268
10184
  </code></pre></div>
10269
10185
  <h4 id="integration-tests">Integration Tests<a class="headerlink" href="#integration-tests" title="Permanent link">&para;</a></h4>
10270
10186
  <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>
@@ -10469,8 +10385,8 @@
10469
10385
  </table>
10470
10386
  <h2 id="submitting-pull-requests">Submitting Pull Requests<a class="headerlink" href="#submitting-pull-requests" title="Permanent link">&para;</a></h2>
10471
10387
  <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>
10472
- <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;
10473
- <a id="__codelineno-48-2" name="__codelineno-48-2" href="#__codelineno-48-2"></a>git push origin
10388
+ <div class="highlight"><pre><span></span><code><a id="__codelineno-49-1" name="__codelineno-49-1" href="#__codelineno-49-1"></a>git commit -m &quot;Closes #1234: Add IPv5 support&quot;
10389
+ <a id="__codelineno-49-2" name="__codelineno-49-2" href="#__codelineno-49-2"></a>git push origin
10474
10390
  </code></pre></div>
10475
10391
  <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>
10476
10392
  <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>
@@ -10482,11 +10398,11 @@
10482
10398
  <p>Below are common issues you might encounter in your development environment and how to address them.</p>
10483
10399
  <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>
10484
10400
  <p>When using <code>nautobot-server runserver</code> to do development you might run into a traceback that looks something like this:</p>
10485
- <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/
10486
- <a id="__codelineno-49-2" name="__codelineno-49-2" href="#__codelineno-49-2"></a>Exception Value: FATAL: sorry, too many clients already
10401
+ <div class="highlight"><pre><span></span><code><a id="__codelineno-50-1" name="__codelineno-50-1" href="#__codelineno-50-1"></a>Exception Type: OperationalError at /extras/tags/
10402
+ <a id="__codelineno-50-2" name="__codelineno-50-2" href="#__codelineno-50-2"></a>Exception Value: FATAL: sorry, too many clients already
10487
10403
  </code></pre></div>
10488
10404
  <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>
10489
- <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
10405
+ <div class="highlight"><pre><span></span><code><a id="__codelineno-51-1" name="__codelineno-51-1" href="#__codelineno-51-1"></a>nautobot-server runserver --nothreading
10490
10406
  </code></pre></div>
10491
10407
 
10492
10408
 
@@ -10631,7 +10547,7 @@
10631
10547
  </div>
10632
10548
 
10633
10549
 
10634
- <script id="__config" type="application/json">{"base": "../..", "features": ["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.07f07601.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>
10550
+ <script id="__config" type="application/json">{"base": "../..", "features": ["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>
10635
10551
 
10636
10552
 
10637
10553
  <script src="../../assets/javascripts/bundle.56dfad97.min.js"></script>