U ƽb" @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 )attrr;/tmp/pip-unpacked-wheel-iohwuy7z/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__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 initkwargsrrviewgs   z"ViewSetMixin.as_view..viewr)updated)assigned)r descriptionrdetailbasename TypeErrorZhttp_method_namesrrrr&r-r.r,r)r-r,r.keyr/rr+ras_view:s8    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#)r4r#Zresolver_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 st}jdkr|SfddD}|D]^}zDdj|jf}t|jjjd}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)r3)rEr)r'rrrFs z9ViewSetMixin.get_extra_action_url_map..r?)r#) rr3rGr4rCr r$r%r#r>Z get_view_namer)r'Z action_urlsr,r)rCurlr/rrHrget_extra_action_url_maps  z%ViewSetMixin.get_extra_action_url_map)N) r __module__ __qualname____doc__rr7r;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 collectionsr functoolsrinspectrZ django.urlsrZdjango.utils.decoratorsrZdjango.views.decorators.csrfrZrest_frameworkrr r Zrest_framework.decoratorsr Zrest_framework.reverser rrrZAPIViewrPZGenericAPIViewrRZRetrieveModelMixinZListModelMixinrSZCreateModelMixinZUpdateModelMixinZDestroyModelMixinrTrrrrs4         &