>Tf-LddlmZddlmZddlmZddlmZddlm Z ddl m Z ddl m Z ddlmZdd lmZdd lmZdd lmZd d lmZdZGddeZGddeZGddeZGddZGddZGddZd dZ d!dZ!dS)")Iterable)settings) AccessMixin)ImproperlyConfigured)reverse)NoReverseMatch)url_has_allowed_host_and_scheme) gettext_lazy) PluginConfig)registry)get_related_models)resolve_permission)ConditionalLoginRequiredMixin"ContentTypePermissionRequiredMixinGetRelatedModelsMixinGetReturnURLMixinObjectPermissionRequiredMixinViewTab get_viewnameregister_model_viewc"eZdZdZfdZxZS)rzm Similar to Django's LoginRequiredMixin, but enforces authentication only if LOGIN_REQUIRED is True. ctjr |jjs|St j|g|Ri|SN)rLOGIN_REQUIREDuseris_authenticatedhandle_no_permissionsuperdispatchselfrequestargskwargs __class__s 4/var/www/html/netbox-4.1.3/netbox/utilities/views.pyr z&ConditionalLoginRequiredMixin.dispatch$sS  " /7<+H /,,.. .uww9$999&999)__name__ __module__ __qualname____doc__r __classcell__r&s@r'rr sB:::::::::r(rcBeZdZdZeZdZdZfdZxZ S)ra Similar to Django's built-in PermissionRequiredMixin, but extended to check model-level permission assignments. This is related to ObjectPermissionRequiredMixin, except that it does not enforce object-level permissions, and fits within NetBox's custom permission enforcement system. additional_permissions: An optional iterable of statically declared permissions to evaluate in addition to those derived from the object type cvttd|jj)h Return the specific permission necessary to perform the requested action on an object. zB{self.__class__.__name__} must implement get_required_permission() class_nameNotImplementedError_formatr&r)r"s r'get_required_permissionz:ContentTypePermissionRequiredMixin.get_required_permission5s?"!$h"i"i"p"p~.#q# #    r(c|jj}|}||g|jRrdSdS)NTF)r#rr9 has_permsadditional_permissions)r"rpermission_requireds r'has_permissionz1ContentTypePermissionRequiredMixin.has_permission=sM| "::<< >>.M1LMM N N 4ur(c|s|Stj|g|Ri|Sr)r>rrr r!s r'r z+ContentTypePermissionRequiredMixin.dispatchGsP""$$ /,,.. .uww9$999&999r( r)r*r+r,listr<r9r>r r-r.s@r'rr*sn"TVV   :::::::::r(rcBeZdZdZeZdZdZfdZxZ S)ra Similar to Django's built-in PermissionRequiredMixin, but extended to check for both model-level and object-level permission assignments. If the user has only object-level permissions assigned, the view's queryset is filtered to return only those objects on which the user is permitted to perform the specified action. additional_permissions: An optional iterable of statically declared permissions to evaluate in addition to those derived from the object type cvttd|jj)r1z5{class_name} must implement get_required_permission()r2r4r8s r'r9z5ObjectPermissionRequiredMixin.get_required_permissionYs?"!$["\"\"c"c~.#d# #    r(c|jj}|}||g|jRr7t |d}|j|||_dSdS)NrTF)r#rr9r;r<rquerysetrestrict)r"rr=actions r'r>z,ObjectPermissionRequiredMixin.has_permissionas{| "::<< >>.M1LMM N N ((;<rrr r!s r'r z&ObjectPermissionRequiredMixin.dispatchpstZ(( &3&DN$;&<<  ""$$ /,,.. .uww9$999&999r(r@r.s@r'rrNsn"TVV       : : : : : : : : :r(rceZdZdZdZddZdS)rzc Provides logic for determining where a user should be redirected after processing a form. Nc|jdp|jd}|rt|dr|S|+|jr$t |dr|S|jt|jSt |drA|j j j } t|j d|j dS#t$rYnwxYwtdS)N return_url) allowed_hostsget_absolute_urlrE:_listhome)GETgetPOSTr pkrIrNdefault_return_urlrrEmodel_meta app_label model_namer)r"r#objrL model_optss r'get_return_urlz GetReturnURLMixin.get_return_urls[__\22Tgl6F6F|6T6T  9*TXYYY   ?sv?'#7I*J*J?'')) )  " .4233 3 4 $ $ ,2J *"6UU9NUUUVVV!    vs4C C C r)r)r*r+r,rVr]r(r'rrs:r(rceZdZdZggfdZdS)rzZ Provides logic for collecting all related models for the currently viewed model. c|jjtfdtd}fd|D}||t |dS)a Get related models of the view's `queryset` model without those listed in `omit`. Will be sorted alphabetical. Args: request: Current request being processed. instance: The instance related models should be looked up for. A list of instances can be passed to match related objects in this list (e.g. to find sites of a region including child regions). omit: Remove relationships to these models from the result. Needs to be passed, if related models don't provide a `_list` view. extra: Add extra models to the list of automatically determined related models. Can be used to add indirect relationships. c,|duo |dvSNrr^)mrWomits r'z:GetRelatedModelsMixin.get_related_models..sad%'z.s    uD &&w|V<<C!(H55+^^^X..*       r(cT|djjjSrb)rWrX verbose_namelower)xs r'rez:GetRelatedModelsMixin.get_related_models..sAaDJ4D4Q4W4W4Y4Yr()key)rErWrkr extendsorted)r"r#rordextrarelatedrelated_modelsrWs ``` @r'r z(GetRelatedModelsMixin.get_related_modelss # < < < < < ue , ,        !(     e$$$n*Y*YZZZZr(N)r)r*r+r,r r^r(r'rrs?:<2 [ [ [ [ [ [r(rc&eZdZdZddZdZdZdS) ra ViewTabs are used for navigation among multiple object-specific views, such as the changelog or journal for a particular object. Args: label: Human-friendly text badge: A static value or callable to display alongside the label (optional). If a callable is used, it must accept a single argument representing the object being viewed. weight: Numeric weight to influence ordering among other tabs (default: 1000) permission: The permission required to display the tab (optional). hide_if_empty: If true, the tab will be displayed only if its badge has a meaningful value. (Tabs without a badge are always displayed.) NFcL||_||_||_||_||_dSr)labelbadgeweight permission hide_if_empty)r"r~rrrrs r'__init__zViewTab.__init__s,   $*r(cp||}|jr |jr|sdS|j||jdS)z5Return the attributes needed to render a tab in HTML.N)r~rr)_get_badge_valuerrr~r)r"ro badge_values r'renderzViewTab.rendersQ++H55 : $, [ 4Z k   r(ct|jsdSt|jr||S|jSr)rcallable)r"ros r'rzViewTab._get_badge_values=z 4 DJ   (::h'' 'zr()Nr|NF)r)r*r+r,rrrr^r(r'rrsP  ++++    r(rNFct|jjt}|jj}|jj}|r|d|}|rd|}|r|d|}n|d|}|rd|}|r|d|}|S)a. Return the view name for the given model and action, if valid. :param model: The model or instance to which the view applies :param action: A string indicating the desired action (if any); e.g. "add" or "list" :param rest_api: A boolean indicating whether this is a REST API view z-api:z plugins-api:-rOzplugins:r6)rlrX app_configr rYrZ)rWrGrest_api is_pluginrYrZviewnames r'rrs5;1<@@I %I'J .22j22  10h00H  ."--V--H ..*..  -,(,,H  ."--V--H Or(cfd}|S)a 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: @register_model_view(Site, 'myview', path='my-custom-view') class MyView(ObjectView): ... This will automatically create a URL path for MyView at `/dcim/sites//my-custom-view/` which can be resolved using the view name `dcim:site_myview'. Args: model: The Django model class with which this view will be associated. 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. kwargs: A dictionary of keyword arguments for the view to include when registering its URL path (optional). cjj}jj}|td|vrgtd||<td|||ppid|S)Nviews)namergpathr%)rXrYrZr append)clsrYrZr%rWrrs r'_wrapperz%register_model_view.._wrapper&sK) [+ Xg.y9 9 979HW i ( 4)$Z077LDl 9 9     r(r^)rWrrr%rs```` r'rrs5& Or()NF)rNN)"typingr django.confrdjango.contrib.auth.mixinsrdjango.core.exceptionsr django.urlsrdjango.urls.exceptionsrdjango.utils.httpr django.utils.translationr r6netbox.pluginsr netbox.registryr utilities.relationsr permissionsr__all__rrrrrrrrr^r(r'rs 222222777777111111======666666''''''$$$$$$222222++++++  :::::K:::!:!:!:!:!:)F!:!:!:H/:/:/:/:/:$A/:/:/:dD%[%[%[%[%[%[%[%[P%%%%%%%%X:######r(