U ڲg*# @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 )attrr;/tmp/pip-unpacked-wheel-11h17kvo/rest_framework/viewsets.py_is_extra_actionsrcCs |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__AssertionErrorformatrrrr_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]<}|jkrNtd|jft|s.tdj|fq.dkrdkrtdjfdd }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.csxf}dkr&dkr&dd<|_D]\}}t||}t|||q4||_||_||_|j|f||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_view9s8    zViewSetMixin.as_viewcs@tj|f||}|j}|dkr.d|_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__rrr:s  zViewSetMixin.initialize_requestcOsXd|j|f}d}|jr*|jjr*|jjj}|r:|d|}|d|jt|f||S)z> Reverse the action for the given `url_name`. %s-%sN:r")r3r"resolver_match namespace setdefaultr )r&url_namer#r$rArrrreverse_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}jdkr|SfddD}|D]x}z^dj|jf}jjj}|r\d||f}t|jj jd}j f|j }||| <Wq,t k rYq,Xq,|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)r2)rEr(r&rrrFs z9ViewSetMixin.get_extra_action_url_map..r>z%s:%s)r") r2rGr3rCr"r@rAr r#r$r=Z get_view_namer)r&Z action_urlsr+r(rCrAurlr.rrHrget_extra_action_url_maps$    z%ViewSetMixin.get_extra_action_url_map)N) r __module__ __qualname____doc__rr6r:rD classmethodrGrJ __classcell__rrr<rr,s  S  rc@seZdZdZdS)ViewSetzI The base ViewSet class does not provide any actions by default. NrrKrLrMrrrrrPsrPc@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. NrQrrrrrRsrRc@seZdZdZdS)ReadOnlyModelViewSetzL A viewset that provides default `list()` and `retrieve()` actions. NrQrrrrrSsrSc@seZdZdZdS) ModelViewSetz A viewset that provides default `create()`, `retrieve()`, `update()`, `partial_update()`, `destroy()` and `list()` actions. NrQrrrrrTsrTN)!rM functoolsrinspectrZ django.urlsrZdjango.utils.decoratorsrZdjango.views.decorators.csrfrZrest_frameworkrrr Zrest_framework.decoratorsr Zrest_framework.reverser rrrZAPIViewrPZGenericAPIViewrRZRetrieveModelMixinZListModelMixinrSZCreateModelMixinZUpdateModelMixinZDestroyModelMixinrTrrrrs2        *