Closes #18023: Employ register_model_view() for list views (#18029)

* Extend register_model_view() to enable registering list views

* Register circuits list views with register_model_view()

* Register core list views with register_model_view()

* Fix bulk_edit & bulk_delete URL paths

* Register dcim list views with register_model_view() (WIP)

* Register dcim list views with register_model_view()

* Register extras list views with register_model_view()

* Register ipam list views with register_model_view()

* Register tenancy list views with register_model_view()

* Register users list views with register_model_view()

* Register virtualization list views with register_model_view()

* Register vpn list views with register_model_view()

* Register wireless list views with register_model_view()

* Add change note for register_model_view()

netbox/utilities/urls.py

@@ -9,22 +9,27 @@ __all__ = (
 )
 
 
-def get_model_urls(app_label, model_name):
+def get_model_urls(app_label, model_name, detail=True):
     """
     Return a list of URL paths for detail views registered to the given model.
 
     Args:
         app_label: App/plugin name
         model_name: Model name
+        detail: If True (default), return only URL views for an individual object.
+            Otherwise, return only list views.
     """
     paths = []
 
     # Retrieve registered views for this model
     try:
-        views = registry['views'][app_label][model_name]
+        views = [
+            view for view in registry['views'][app_label][model_name]
+            if view['detail'] == detail
+        ]
     except KeyError:
         # No views have been registered for this model
-        views = []
+        return []
 
     for config in views:
         # Import the view class or function

netbox/utilities/views.py

@@ -272,7 +272,7 @@ def get_viewname(model, action=None, rest_api=False):
     return viewname
 
 
-def register_model_view(model, name='', path=None, kwargs=None):
+def register_model_view(model, name='', path=None, detail=True, kwargs=None):
     """
     This decorator can be used to "attach" a view to any model in NetBox. This is typically used to inject
     additional tabs within a model's detail view. For example, to add a custom tab to NetBox's dcim.Site model:
@@ -289,6 +289,7 @@ def register_model_view(model, name='', path=None, kwargs=None):
         name: The string used to form the view's name for URL resolution (e.g. via `reverse()`). This will be appended
             to the name of the base view for the model using an underscore. If blank, the model name will be used.
         path: The URL path by which the view can be reached (optional). If not provided, `name` will be used.
+        detail: True if the path applied to an individual object; False if it attaches to the base (list) path.
         kwargs: A dictionary of keyword arguments for the view to include when registering its URL path (optional).
     """
     def _wrapper(cls):
@@ -301,7 +302,8 @@ def register_model_view(model, name='', path=None, kwargs=None):
         registry['views'][app_label][model_name].append({
             'name': name,
             'view': cls,
-            'path': path or name,
+            'path': path if path is not None else name,
+            'detail': detail,
             'kwargs': kwargs or {},
         })