3 =^`G@s dZddlmZddlmZddlmZddlmZm Z m Z ddl m Z ddl mZddlmZmZdd lmZdd lmZdd lmZdd lmZmZdd lmZddlmZddlm Z ddl!m"Z"ddl#m$Z$ddZ%dddZ&ddZ'ddZ(GdddeZ)dS)zL Provides an APIView class that is the base of all views in REST framework. )unicode_literals)settings)PermissionDenied) connectionmodels transaction)Http404)HttpResponseBase) cc_delim_repatch_vary_headers) smart_text) csrf_exempt)View) exceptionsstatus)Request)Response) DefaultSchema) api_settings) formattingcCsbt|dd}|dk r|S|jj}tj|d}tj|d}tj|}t|dd}|r^|d|7}|S)z Given a view instance, return a textual name to represent the view. This name is used in the browsable API, and in OPTIONS responses. This function is the default for the `VIEW_NAME_FUNCTION` setting. nameNrZViewSetsuffix )getattr __class____name__rZremove_trailing_stringZcamelcase_to_spaces)viewrrrC/tmp/pip-build-8app2_gc/djangorestframework/rest_framework/views.py get_view_names      rFcCs@t|dd}|dkr |jjpd}tjt|}|rZ6d?d@Z7dAdBZ8dCdDZ9Z:S)HAPIViewc sLtt|ddtjjr&dd}||j_tt|j f|}||_ ||_ t |S)z Store the original class on the view function. This allows us to discover information about the view when we do URL reverse lookups. Used for breadcrumb generation. querysetNcSs tddS)NzDo not evaluate the `.queryset` attribute directly, as the result will be cached and reused between requests. Use `.all()` or call `.get_queryset()` instead.) RuntimeErrorrrrrforce_evaluationsz)APIView.as_view..force_evaluation) r,rrqueryZQuerySetr5Z _fetch_allsuperr4as_viewcls initkwargsr )r;r<r7r)rrrr:{szAPIView.as_viewcCs|jS)zZ Wrap Django's private `_allowed_methods` interface in a public property. )Z_allowed_methods)selfrrrallowed_methodsszAPIView.allowed_methodscCs*ddj|ji}t|jdkr&d|d<|S)NZAllowz, AcceptVary)joinr>lenrenderer_classes)r=r+rrrdefault_response_headerssz APIView.default_response_headerscOstj|jdS)z If `request.method` does not correspond to a handler method, determine what kind of exception to raise. N)rZMethodNotAllowedmethod)r=requestargskwargsrrrhttp_method_not_allowedszAPIView.http_method_not_allowedNcCs&|jr|j rtjtj|ddS)zY If request is not permitted, determine what kind of exception to raise. )r*N)authenticatorsZsuccessful_authenticatorrNotAuthenticatedr)r=rGmessagerrrpermission_deniedszAPIView.permission_deniedcCstj|dS)zU If request is throttled, determine what kind of exception to raise. N)rZ Throttled)r=rGr)rrr throttledszAPIView.throttledcCs|j}|r|dj|SdS)z If a request is unauthenticated, determine the WWW-Authenticate header to use for 401 responses, if any. rN)get_authenticatorsZauthenticate_header)r=rGrKrrrget_authenticate_headerszAPIView.get_authenticate_headercCs|t|dft|didS)z| Returns a dict that is passed through to Parser.parse(), as the `parser_context` keyword argument. rHrI)rrHrI)r)r= http_requestrrrget_parser_contexts zAPIView.get_parser_contextcCs&|t|dft|dit|dddS)z Returns a dict that is passed through to Renderer.render(), as the `renderer_context` keyword argument. rHrIrGN)rrHrIrG)r)r=rrrget_renderer_contexts  zAPIView.get_renderer_contextcCs&|t|dft|dit|dddS)zp Returns a dict that is passed through to EXCEPTION_HANDLER, as the `context` argument. rHrIrGN)rrHrIrG)r)r=rrrget_exception_handler_contexts  z%APIView.get_exception_handler_contextcCs|jj}||S)zf Return the view name, as used in OPTIONS responses and in the browsable API. )rZVIEW_NAME_FUNCTION)r=funcrrrrszAPIView.get_view_nameFcCs|jj}|||S)z{ Return some descriptive text for the view, as used in OPTIONS responses and in the browsable API. )rZVIEW_DESCRIPTION_FUNCTION)r=r$rVrrrr%szAPIView.get_view_descriptioncKs|jjr|j|jjSdS)zQ Determine if the request includes a '.json' style format suffix N)rZFORMAT_SUFFIX_KWARGr&)r=rIrrrget_format_suffixszAPIView.get_format_suffixcCsdd|jDS)zX Instantiates and returns the list of renderers that this view can use. cSsg|] }|qSrr).0Zrendererrrr sz)APIView.get_renderers..)rD)r=rrr get_renderersszAPIView.get_rendererscCsdd|jDS)zV Instantiates and returns the list of parsers that this view can use. cSsg|] }|qSrr)rXparserrrrrY sz'APIView.get_parsers..)parser_classes)r=rrr get_parsersszAPIView.get_parserscCsdd|jDS)z] Instantiates and returns the list of authenticators that this view can use. cSsg|] }|qSrr)rXauthrrrrYsz.APIView.get_authenticators..)authentication_classes)r=rrrrPszAPIView.get_authenticatorscCsdd|jDS)z[ Instantiates and returns the list of permissions that this view requires. cSsg|] }|qSrr)rX permissionrrrrYsz+APIView.get_permissions..)permission_classes)r=rrrget_permissionsszAPIView.get_permissionscCsdd|jDS)zU Instantiates and returns the list of throttles that this view uses. cSsg|] }|qSrr)rXthrottlerrrrYsz)APIView.get_throttles..)throttle_classes)r=rrr get_throttlesszAPIView.get_throttlescCst|dds|j|_|jS)zN Instantiate and return the content negotiation class to use. _negotiatorN)rcontent_negotiation_classrf)r=rrrget_content_negotiator s  zAPIView.get_content_negotiatorcCs|jjS)zD Returns the exception handler that this view uses. )rZEXCEPTION_HANDLER)r=rrrget_exception_handler(szAPIView.get_exception_handlerc CsR|j}|j}y|j|||jStk rL|rF|d|djfSYnXdS)zU Determine which renderer and media type to use render the response. rN)rZrhZselect_renderer format_kwarg Exception media_type)r=rGforceZ renderersZconnegrrrperform_content_negotiation0sz#APIView.perform_content_negotiationcCs |jdS)a Perform authentication on the incoming request. Note that if you override this and simply 'pass', then authentication will instead be performed lazily, the first time either `request.user` or `request.auth` is accessed. N)user)r=rGrrrperform_authentication>szAPIView.perform_authenticationcCs8x2|jD]&}|j||s |j|t|dddq WdS)z Check if the request should be permitted. Raises an appropriate exception if the request is not permitted. rMN)rM)rbZhas_permissionrNr)r=rGr`rrrcheck_permissionsHs zAPIView.check_permissionscCs:x4|jD](}|j|||s |j|t|dddq WdS)z Check if the request should be permitted for a given object. Raises an appropriate exception if the request is not permitted. rMN)rM)rbZhas_object_permissionrNr)r=rGobjr`rrrcheck_object_permissionsSsz APIView.check_object_permissionscCs2x,|jD] }|j||s |j||jq WdS)z| Check if request should be throttled. Raises an appropriate exception if the request is throttled. N)reZ allow_requestrOr))r=rGrcrrrcheck_throttles^s zAPIView.check_throttlescOs,|jdkrdS|j}|j|f|||fS)z If versioning is being used, then determine any API version for the incoming request. Returns a two-tuple of (version, versioning_scheme) N)NN)versioning_classdetermine_version)r=rGrHrIschemerrrrvgs zAPIView.determine_versioncOs(|j|}t||j|j|j|dS)z5 Returns the initial request object. )parsersrKZ negotiatorparser_context)rSrr]rPrh)r=rGrHrIryrrrinitialize_requestss zAPIView.initialize_requestcOsj|jf||_|j|}|\|_|_|j|f||\}}|||_|_|j||j ||j |dS)zX Runs anything that needs to occur prior to calling the method handler. N) rWrjrnaccepted_rendereraccepted_media_typervversionZversioning_schemerprqrt)r=rGrHrInegr}rwrrrinitials    zAPIView.initialc Ost|tstdt|t|trdt|ddsJ|j|dd}|\|_|_|j|_|j|_|j |_ |j j dd}|dk rt |tj|x|j jD]\}}|||<qW|S)z4 Returns the final response object. zrExpected a `Response`, `HttpResponse` or `HttpStreamingResponse` to be returned from the view, but received a `%s`r{NT)rmrA)r,r AssertionErrortyperrrnr{r|rTZrenderer_contextr+popr r splititems) r=rGresponserHrIr~Z vary_headerskeyvaluerrrfinalize_responses        zAPIView.finalize_responsecCsht|tjtjfr2|j|j}|r*||_ntj|_ |j }|j }|||}|dkr^|j |d|_ |S)zz Handle any exception that occurs, by returning an appropriate response, or re-raising the error. NT)r,rrLZAuthenticationFailedrQrGr(rZHTTP_403_FORBIDDENr/rirUraise_uncaught_exception exception)r=r0r(r3r1rrrrhandle_exceptions    zAPIView.handle_exceptioncCs0tjr*|j}t|jd}|dk}|j|dS)Nformatr$apiadmin)r$rr)rDEBUGrGrr{Zforce_plaintext_errors)r=r0rGZrenderer_formatZuse_plaintext_tracebackrrrrs   z APIView.raise_uncaught_exceptioncOs||_||_|j|f||}||_|j|_yR|j|f|||jj|j krft ||jj|j }n|j }||f||}Wn,t k r}z|j |}WYdd}~XnX|j||f|||_|jS)z `.dispatch()` is pretty much the same as Django's regular dispatch, but with extra hooks for startup, finalize, and exception handling. N)rHrIrzrGrEr+rrFlowerZhttp_method_namesrrJrkrrr)r=rGrHrIhandlerrr0rrrdispatchs   zAPIView.dispatchcOs:|jdkr|j|f||S|jj||}t|tjdS)z< Handler method for HTTP 'OPTIONS' request. N)r)metadata_classrJZdetermine_metadatarrZ HTTP_200_OK)r=rGrHrIr2rrroptionss zAPIView.options)N)F)F);r __module__ __qualname__rZDEFAULT_RENDERER_CLASSESrDZDEFAULT_PARSER_CLASSESr\ZDEFAULT_AUTHENTICATION_CLASSESr_ZDEFAULT_THROTTLE_CLASSESrdZDEFAULT_PERMISSION_CLASSESraZ!DEFAULT_CONTENT_NEGOTIATION_CLASSrgZDEFAULT_METADATA_CLASSrZDEFAULT_VERSIONING_CLASSrurrZschema classmethodr:propertyr>rErJrNrOrQrSrTrUrr%rWrZr]rPrbrerhrirnrprqrsrtrvrzrrrrrr __classcell__rr)rrr4jsV              r4N)F)*r" __future__rZ django.confrZdjango.core.exceptionsrZ django.dbrrrZ django.httprZdjango.http.responser Zdjango.utils.cacher r Zdjango.utils.encodingr Zdjango.views.decorators.csrfr Zdjango.views.genericrZrest_frameworkrrZrest_framework.requestrZrest_framework.responserZrest_framework.schemasrZrest_framework.settingsrZrest_framework.utilsrrr%r'r3r4rrrrs*              !