a còfhã@s|dZddlZddlmZddlmZddd„Zdd„Zd d „Zd d „Z d d„Z dd„Z dd„Z ddd„Z Gdd„deƒZdS)aP The most important decorator in this module is `@api_view`, which is used for writing function-based views with REST framework. There are also various decorators for setting the API policies on function based views, as well as the `@action` decorator, which is used to annotate methods on viewsets that should be included by routers. éN)Ú pretty_name)ÚAPIViewcs"ˆdurdgnˆ‰‡fdd„}|S)z’ Decorator that converts a function-based view into an APIView subclass. Takes a list of allowed methods for the view as an argument. NÚGETcstdtfdˆjiƒ}tˆtjƒr(Jdƒ‚tˆttfƒsHJdtˆƒjƒ‚t ˆƒdhB}dd„|Dƒ|_ ‡fdd „}ˆD]}t ||  ¡|ƒqvˆj|_ˆj |_ tˆd tjƒ|_tˆd tjƒ|_tˆd tjƒ|_tˆd tjƒ|_tˆdtjƒ|_tˆdtjƒ|_| ¡S)NÚWrappedAPIViewÚ__doc__z.@api_view missing list of allowed HTTP methodsz1@api_view expected a list of strings, received %sÚoptionscSsg|] }| ¡‘qS©©Úlower©Ú.0ÚmethodrrúV/home/httpd/docs/test/DocsMgr/lib/python3.9/site-packages/rest_framework/decorators.pyÚ /óz/api_view..decorator..csˆ|i|¤ŽS©Nr)ÚselfÚargsÚkwargs©ÚfuncrrÚhandler1sz,api_view..decorator..handlerÚrenderer_classesÚparser_classesÚauthentication_classesÚthrottle_classesÚpermission_classesÚschema)ÚtyperrÚ isinstanceÚtypesÚ FunctionTypeÚlistÚtupleÚ__name__ÚsetÚhttp_method_namesÚsetattrr Ú __module__ÚgetattrrrrrrrZas_view)rrÚallowed_methodsrr ©r&rrÚ decoratorsJýÿ ÿ ÿÿÿÿÿÿzapi_view..decoratorr)r&r,rr+rÚapi_views 7r-cs‡fdd„}|S)Ncs ˆ|_|Sr©rrr.rrr,Rsz#renderer_classes..decoratorr)rr,rr.rrQs rcs‡fdd„}|S)Ncs ˆ|_|Sr©rrr/rrr,Ysz!parser_classes..decoratorr)rr,rr/rrXs rcs‡fdd„}|S)Ncs ˆ|_|Sr©rrr0rrr,`sz)authentication_classes..decoratorr)rr,rr0rr_s rcs‡fdd„}|S)Ncs ˆ|_|Sr©rrr1rrr,gsz#throttle_classes..decoratorr)rr,rr1rrfs rcs‡fdd„}|S)Ncs ˆ|_|Sr©rrr2rrr,nsz%permission_classes..decoratorr)rr,rr2rrms rcs‡fdd„}|S)Ncs ˆ|_|Sr)rr©Úview_inspectorrrr,uszschema..decoratorr)r4r,rr3rrts rc s`ˆdurdgnˆ‰dd„ˆDƒ‰ˆdus0Jdƒ‚dˆvrHdˆvrHtdƒ‚‡‡‡‡‡fd d „}|S) aQ Mark a ViewSet method as a routable action. `@action`-decorated functions will be endowed with a `mapping` property, a `MethodMapper` that can be used to add additional method-based behaviors on the routed action. :param methods: A list of HTTP method names this action responds to. Defaults to GET only. :param detail: Required. Determines whether this action applies to instance/detail requests or collection/list requests. :param url_path: Define the URL segment for this action. Defaults to the name of the method decorated. :param url_name: Define the internal (`reverse`) URL name for this action. Defaults to the name of the method decorated with underscores replaced with dashes. :param kwargs: Additional properties to set on the view. This can be used to override viewset-level *_classes settings, equivalent to how the `@renderer_classes` etc. decorators work for function- based API views. NÚgetcSsg|] }| ¡‘qSrr r rrrr’rzaction..z-@action() missing required argument: 'detail'ÚnameÚsuffixz5`name` and `suffix` are mutually exclusive arguments.cstt|ˆƒ|_ˆ|_ˆrˆn|j|_ˆr*ˆn |j dd¡|_ˆ|_dˆvr`dˆvr`t|jƒ|jd<|j phd|jd<|S)NÚ_ú-r6r7Ú description) Ú MethodMapperÚmappingÚdetailr$Úurl_pathÚreplaceÚurl_namerrrr©r=rÚmethodsr@r>rrr,œs zaction..decorator)Ú TypeError)rBr=r>r@rr,rrArÚaction{s ÿrDc@s`eZdZdZdd„Zdd„Zdd„Zdd „Zd d „Zd d „Z dd„Z dd„Z dd„Z dd„Z dS)r;au Enables mapping HTTP methods to different ViewSet methods for a single, logical action. Example usage: class MyViewSet(ViewSet): @action(detail=False) def example(self, request, **kwargs): ... @example.mapping.post def create_example(self, request, **kwargs): ... cCs ||_|D]}|jj||<q dSr)rDr$)rrDrBr rrrÚ__init__ÃszMethodMapper.__init__cCs@||vsJd|||fƒ‚|j|jjks2Jdƒ‚|j||<|S)Nz-Method '%s' has already been mapped to '.%s'.z}Method mapping does not behave like the property decorator. You cannot use the same method name for each mapping declaration.)r$rD)rr rrrrÚ_mapÈs ÿÿ zMethodMapper._mapcCs | d|¡S)Nr5©rF©rrrrrr5ÓszMethodMapper.getcCs | d|¡S)NÚpostrGrHrrrrIÖszMethodMapper.postcCs | d|¡S)NÚputrGrHrrrrJÙszMethodMapper.putcCs | d|¡S)NÚpatchrGrHrrrrKÜszMethodMapper.patchcCs | d|¡S)NÚdeleterGrHrrrrLßszMethodMapper.deletecCs | d|¡S)NÚheadrGrHrrrrMâszMethodMapper.headcCs | d|¡S)NrrGrHrrrråszMethodMapper.optionscCs | d|¡S)NÚtracerGrHrrrrNèszMethodMapper.traceN)r$r(Ú __qualname__rrErFr5rIrJrKrLrMrrNrrrrr;±s r;)N)NNNN)rr Zdjango.forms.utilsrZrest_framework.viewsrr-rrrrrrrDÚdictr;rrrrÚs   A 6