3 =^ @sdZddlmZddlmZddlmZddlmZddl m Z ddl m Z ddl mZdd lmZmZmZdd lmZd d ZGd ddeZGdddeejZGdddeejZGdddejejeZGdddejejej 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 )unicode_literals) OrderedDict)update_wrapper) getmembers)NoReverseMatch)classonlymethod) csrf_exempt)genericsmixinsviews)reversecCs t|dS)Nmapping)hasattr)attrrF/tmp/pip-build-8app2_gc/djangorestframework/rest_framework/viewsets.py_is_extra_action!srcsJeZdZdZed 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 %rnamesuffixzO%s() received both `name` and `suffix`, which are mutually exclusive arguments.cs~f}|_x*jD]\}}t||}t|||qWt|drZt|d rZ|j|_||_||_||_ |j |f||S)Ngethead) action_mapitemsgetattrsetattrrrrrequestargskwargsdispatch)rrrselfmethodactionhandler)actionscls initkwargsrrview_s  z"ViewSetMixin.as_view..view)updated)assigned)r descriptionrdetailbasename TypeErrorZhttp_method_names__name__rrrr%r&r$r)r%r$r&keyr'r)r$r%r&ras_view2s0     zViewSetMixin.as_viewcsDtt|j|f||}|jj}|dkr2d|_n|jj||_|S)z[ Set the `.action` attribute on the view, depending on the request method. optionsmetadata)superrinitialize_requestr!lowerr"rr)r rrrr!) __class__rrr4s  zViewSetMixin.initialize_requestcOs,d|j|f}|jd|jt|f||S)z> Reverse the action for the given `url_name`. z%s-%sr)r, setdefaultrr )r url_namerrrrrreverse_actionszViewSetMixin.reverse_actioncCsddt|tDS)zP Get the methods that are marked as an extra ViewSet `@action`. cSsg|] \}}|qSrr).0_r!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)r+)r:r")r rrr<sz9ViewSetMixin.get_extra_action_url_map..z%s-%s)r) rr+r=r,r8r rrrr6Z get_view_namer)r Z action_urlsr$r"r8urlr'r)r rget_extra_action_url_maps   z%ViewSetMixin.get_extra_action_url_map)N) r. __module__ __qualname____doc__rr0r4r9 classmethodr=r? __classcell__rr)r6rr%s  R  rc@seZdZdZdS)ViewSetzI The base ViewSet class does not provide any actions by default. N)r.r@rArBrrrrrEsrEc@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)r.r@rArBrrrrrFsrFc@seZdZdZdS)ReadOnlyModelViewSetzL A viewset that provides default `list()` and `retrieve()` actions. N)r.r@rArBrrrrrGsrGc@seZdZdZdS) ModelViewSetz A viewset that provides default `create()`, `retrieve()`, `update()`, `partial_update()`, `destroy()` and `list()` actions. N)r.r@rArBrrrrrHs rHN)#rB __future__r collectionsr functoolsrinspectrZ django.urlsrZdjango.utils.decoratorsrZdjango.views.decorators.csrfrZrest_frameworkr r r Zrest_framework.reverser robjectrZAPIViewrEZGenericAPIViewrFZRetrieveModelMixinZListModelMixinrGZCreateModelMixinZUpdateModelMixinZDestroyModelMixinrHrrrrs.