a cf*# @sdZddlmZddlmZddlmZddlmZddl m Z ddl m Z m Z mZddlmZdd lmZd d Zd d ZGdddZGdddeejZGdddee jZGddde je jeZGddde je je je je jeZ dS)a ViewSets are essentially just a type of class based view, that doesn't provide any method handlers, such as `get()`, `post()`, etc... but instead has actions, such as `list()`, `retrieve()`, `create()`, etc... Actions are only bound to methods at the point of instantiating the views. user_list = UserViewSet.as_view({'get': 'list'}) user_detail = UserViewSet.as_view({'get': 'retrieve'}) Typically, rather than instantiate views from viewsets directly, you'll register the viewset with a router and let the URL conf be determined automatically. router = DefaultRouter() router.register(r'users', UserViewSet, 'user') urlpatterns = router.urls )update_wrapper) getmembers)NoReverseMatch)classonlymethod) csrf_exempt)genericsmixinsviews) MethodMapper)reversecCst|dot|jtS)Nmapping)hasattr isinstancer r )attrrT/home/httpd/docs/test/DocsMgr/lib/python3.9/site-packages/rest_framework/viewsets.py_is_extra_actionsrcCs |j|ksJdj||d|S)NzExpected function (`{func.__name__}`) to match its attribute name (`{name}`). If using a decorator, ensure the inner function is decorated with `functools.wraps`, or that `{func.__name__}.__name__` is otherwise set to `{name}`.funcname)__name__formatrrrr_check_attr_name#s  rcsJeZdZdZed ddZfddZddZed d Z d d Z Z S) ViewSetMixinad This is the magic. Overrides `.as_view()` so that it takes an `actions` keyword that performs the binding of HTTP methods to actions on the Resource. For example, to create a concrete view binding the 'GET' and 'POST' methods to the 'list' and 'create' actions... view = MyViewSet.as_view({'get': 'list', 'post': 'create'}) Nc sd_d_d_d_d_s*tdD]<}|jvrNtd|jft|s.tdj|fq.dvrdvrtdjfdd }t |d d t |j d d |_ |_ |_ t|S) z Because of the way class based views create a closure around the instantiated view, we need to totally reimplement `.as_view`, and slightly modify the view function that is created and returned. NzwThe `actions` argument must be provided when calling `.as_view()` on a ViewSet. For example `.as_view({'get': 'list'})`zUYou tried to pass in the %s method name as a keyword argument to %s(). Don't do that.z#%s() received an invalid keyword %rrsuffixzO%s() received both `name` and `suffix`, which are mutually exclusive arguments.csfi}dvr*dvr*dd<|_D]\}}t||}t|||q8||_||_||_|j|g|Ri|S)Ngethead) action_mapitemsgetattrsetattrrequestargskwargsdispatch)r!r"r#selfmethodactionhandleractionscls initkwargsrrviewfs  z"ViewSetMixin.as_view..viewr)updated)assigned)r descriptionrdetailbasename TypeErrorZhttp_method_namesrr rr$r+r,r*r)r+r*r,keyr-rr)ras_view9s6    zViewSetMixin.as_viewcsFtj|g|Ri|}|j}|dkr4d|_n|j||_|S)z[ Set the `.action` attribute on the view, depending on the request method. optionsmetadata)superinitialize_requestr&lowerr'rr)r%r!r"r#r& __class__rrr9s  zViewSetMixin.initialize_requestcOs^d|j|f}d}|jr*|jjr*|jjj}|r:|d|}|d|jt|g|Ri|S)z> Reverse the action for the given `url_name`. %s-%sN:r!)r2r!resolver_match namespace setdefaultr )r%url_namer"r#r@rrrreverse_actions  zViewSetMixin.reverse_actioncCsddt|tDS)zP Get the methods that are marked as an extra ViewSet `@action`. cSsg|]\}}t||qSr)r).0rr&rrr sz2ViewSetMixin.get_extra_actions..)rr)r+rrrget_extra_actionsszViewSetMixin.get_extra_actionsc si}jdur|SfddD}|D]z}zbdj|jf}jjj}|r\d||f}t|jj jd}j fi|j }||| <Wq,t yYq,0q,|S)z Build a map of {names: urls} for the extra actions. This method will noop if `detail` was not provided as a view initkwarg. Ncsg|]}|jjkr|qSr)r1)rDr'r%rrrEs z9ViewSetMixin.get_extra_action_url_map..r=z%s:%s)r!) r1rFr2rBr!r?r@r r"r#r<Z get_view_namer)r%Z action_urlsr*r'rBr@urlr-rrGrget_extra_action_url_maps$     z%ViewSetMixin.get_extra_action_url_map)N) r __module__ __qualname____doc__rr5r9rC classmethodrFrI __classcell__rrr;rr,s  S  rc@seZdZdZdS)ViewSetzI The base ViewSet class does not provide any actions by default. NrrJrKrLrrrrrOsrOc@seZdZdZdS)GenericViewSetz The GenericViewSet class does not provide any actions by default, but does include the base set of generic view behavior, such as the `get_object` and `get_queryset` methods. NrPrrrrrQsrQc@seZdZdZdS)ReadOnlyModelViewSetzL A viewset that provides default `list()` and `retrieve()` actions. NrPrrrrrRsrRc@seZdZdZdS) ModelViewSetz A viewset that provides default `create()`, `retrieve()`, `update()`, `partial_update()`, `destroy()` and `list()` actions. NrPrrrrrSsrSN)!rL functoolsrinspectrZ django.urlsrZdjango.utils.decoratorsrZdjango.views.decorators.csrfrZrest_frameworkrrr Zrest_framework.decoratorsr Zrest_framework.reverser rrrZAPIViewrOZGenericAPIViewrQZRetrieveModelMixinZListModelMixinrRZCreateModelMixinZUpdateModelMixinZDestroyModelMixinrSrrrrs2        *