3 Ah`" @sdZddlmZddlmZddlmZddlmZddl m Z ddl m Z ddl mZmZmZdd lmZdd lmZd d Zd dZGdddZGdddeejZGdddeejZGdddejejeZGdddejejej ej!ejeZ"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 ) OrderedDict)update_wrapper) getmembers)NoReverseMatch)classonlymethod) csrf_exempt)genericsmixinsviews) MethodMapper)reversecCst|dot|jtS)Nmapping)hasattr isinstancer r )attrrF/tmp/pip-build-9m32_hle/djangorestframework/rest_framework/viewsets.py_is_extra_action srcCs |j|kstdj||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__AssertionErrorformat)rrrrr_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*tdxDD]<}|jkrPtd|jft|s0tdj|fq0Wdkrdkrtdjfdd }t |fd t |j fd |_ |_ |_ 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.cs|f}dkr&dkr&dd<|_x*jD]\}}t||}t|||q6W||_||_||_|j|f||S)Ngethead) action_mapitemsgetattrsetattrrequestargskwargsdispatch)r"r#r$selfmethodactionhandler)actionscls initkwargsrrviewgs   z"ViewSetMixin.as_view..view)updated)assigned)r descriptionrdetailbasename TypeErrorZhttp_method_namesrrrr%r+r,r*r)r+r*r,keyr-r)r*r+r,ras_view:s0     zViewSetMixin.as_viewcs@tj|f||}|jj}|dkr.d|_n|jj||_|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_requestcOsXd|j|f}d}|jr*|jjr*|jjj}|r:|d|}|jd|jt|f||S)z> Reverse the action for the given `url_name`. z%s-%sN:r")r2r"Zresolver_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 st}jdkr|SfddjD}xf|D]^}yDdj|jf}t|jjjd}j f|j}|||j <Wq0t k rYq0Xq0W|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)rAr()r&rrrBsz9ViewSetMixin.get_extra_action_url_map..z%s-%s)r") rr1rCr2r?r r#r$r"r;Z get_view_namer)r&Z action_urlsr*r(r?urlr-r)r&rget_extra_action_url_maps   z%ViewSetMixin.get_extra_action_url_map)N) r __module__ __qualname____doc__rr5r9r@ classmethodrCrE __classcell__rr)r;rr-s  S  rc@seZdZdZdS)ViewSetzI The base ViewSet class does not provide any actions by default. N)rrFrGrHrrrrrKsrKc@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. N)rrFrGrHrrrrrLsrLc@seZdZdZdS)ReadOnlyModelViewSetzL A viewset that provides default `list()` and `retrieve()` actions. N)rrFrGrHrrrrrMsrMc@seZdZdZdS) ModelViewSetz A viewset that provides default `create()`, `retrieve()`, `update()`, `partial_update()`, `destroy()` and `list()` actions. N)rrFrGrHrrrrrNs rNN)#rH collectionsr functoolsrinspectrZ django.urlsrZdjango.utils.decoratorsrZdjango.views.decorators.csrfrZrest_frameworkrr r Zrest_framework.decoratorsr Zrest_framework.reverser rrrZAPIViewrKZGenericAPIViewrLZRetrieveModelMixinZListModelMixinrMZCreateModelMixinZUpdateModelMixinZDestroyModelMixinrNrrrrs0         &