o iJ@sdZddlmZddlmZddlmZddlm 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. )VERSION)settings)PermissionDenied) connectionsmodels)Http404)HttpResponseBase) cc_delim_repatch_vary_headers) smart_str) csrf_exempt)View) exceptionsstatus)Request)Response) DefaultSchema) api_settings) formattingcCsbt|dd}|dur |S|jj}t|d}t|d}t|}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. nameNr ZViewSetsuffix )getattr __class____name__rZremove_trailing_stringZcamelcase_to_spaces)viewrrrZC:\Users\psant\Downloads\PAF backend\school\venv\Lib\site-packages\rest_framework/views.py get_view_names      rFcCs@t|dd}|dur|jjpd}tt|}|rt|S|S)z Given a view instance, return a textual description to represent the view. This name is used in the browsable API, and in OPTIONS responses. This function is the default for the `VIEW_DESCRIPTION_FUNCTION` setting. descriptionN)rr__doc__rdedentr Zmarkup_description)rhtmlrrrrget_view_description0s   r$cCs,tD]}|jdr|jr|dqdS)NZATOMIC_REQUESTST)rallZ settings_dictZin_atomic_block set_rollback)dbrrrr&Bs  r&cCst|tr tj|j}n t|trtj|j}t|tjrSi}t|ddr*|j|d<t|ddr7d|j |d<t|j t t frC|j }nd|j i}t t||j|dSdS) a4 Returns the response that should be used for any given exception. By default we handle the REST framework `APIException`, and also Django's built-in `Http404` and `PermissionDenied` exceptions. Any unhandled exceptions may return `None`, which will cause a 500 error to be raised. auth_headerNzWWW-Authenticatewaitz%dz Retry-Afterdetail)rheaders) isinstancerrZNotFoundargsrZ APIExceptionrr(r)r*listdictr&r status_code)exccontextr+datarrrexception_handlerHs        r4csheZdZejZejZejZ ej Z ej Z ejZejZejZeZeZefddZeddZeddZddZdEd d Zd d ZddZddZ ddZ!ddZ"ddZ#dFddZ$ddZ%ddZ&dd Z'd!d"Z(d#d$Z)d%d&Z*d'd(Z+d)d*Z,dFd+d,Z-d-d.Z.d/d0Z/d1d2Z0d3d4Z1d5d6Z2d7d8Z3d9d:Z4d;d<Z5d=d>Z6d?d@Z7dAdBZ8dCdDZ9Z:S)GAPIViewc sZtt|ddtjjrdd}||j_tjdi|}||_ ||_ t dkr)d|_ 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. querysetNcSstd)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)Fr)r,rrqueryZQuerySetr6Z _fetch_allsuperas_viewcls initkwargsDJANGO_VERSIONZlogin_requiredr )r>r?r8rrrrr=zszAPIView.as_viewcCs|S)zZ Wrap Django's private `_allowed_methods` interface in a public property. N)Z_allowed_methodsselfrrrallowed_methodsszAPIView.allowed_methodscCs*dd|ji}t|jdkrd|d<|S)NZAllowz, r:AcceptVary)joinrDlenrenderer_classes)rCr+rrrdefault_response_headerss z APIView.default_response_headerscOs t|j)z If `request.method` does not correspond to a handler method, determine what kind of exception to raise. N)rZMethodNotAllowedmethod)rCrequestr-kwargsrrrhttp_method_not_alloweds zAPIView.http_method_not_allowedNcCs"|jr |js ttj||d)zY If request is not permitted, determine what kind of exception to raise. )r*codeN)authenticatorsZsuccessful_authenticatorrNotAuthenticatedr)rCrLmessagerOrrrpermission_denieds zAPIView.permission_deniedcCs t|)zU If request is throttled, determine what kind of exception to raise. N)rZ Throttled)rCrLr)rrr throttleds zAPIView.throttledcCs|}|r |d|SdS)z If a request is unauthenticated, determine the WWW-Authenticate header to use for 401 responses, if any. rN)get_authenticatorsZauthenticate_header)rCrLrPrrrget_authenticate_headerszAPIView.get_authenticate_headercCs|t|ddt|didS)z| Returns a dict that is passed through to Parser.parse(), as the `parser_context` keyword argument. r-rrM)rr-rMNr)rC http_requestrrrget_parser_contexts  zAPIView.get_parser_contextcC&|t|ddt|dit|dddS)z Returns a dict that is passed through to Renderer.render(), as the `renderer_context` keyword argument. r-rrMrLNrr-rMrLrWrBrrrget_renderer_contexts    zAPIView.get_renderer_contextcCrZ)zp Returns a dict that is passed through to EXCEPTION_HANDLER, as the `context` argument. r-rrMrLNr[rWrBrrrget_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. N)rZVIEW_NAME_FUNCTION)rCfuncrrrrszAPIView.get_view_nameFcCs|jj}|||S)z{ Return some descriptive text for the view, as used in OPTIONS responses and in the browsable API. N)rZVIEW_DESCRIPTION_FUNCTION)rCr#r^rrrr$s zAPIView.get_view_descriptioncKs|jjr ||jjSdS)zQ Determine if the request includes a '.json' style format suffix N)rZFORMAT_SUFFIX_KWARGget)rCrMrrrget_format_suffixszAPIView.get_format_suffixcCdd|jDS)zX Instantiates and returns the list of renderers that this view can use. cSg|]}|qSrr).0Zrendererrrr z)APIView.get_renderers..N)rIrBrrr get_rendererszAPIView.get_rendererscCra)zV Instantiates and returns the list of parsers that this view can use. cSrbrr)rcparserrrrrdrez'APIView.get_parsers..N)parser_classesrBrrr get_parsers rgzAPIView.get_parserscCra)z] Instantiates and returns the list of authenticators that this view can use. cSrbrr)rcauthrrrrdrez.APIView.get_authenticators..N)authentication_classesrBrrrrUrgzAPIView.get_authenticatorscCra)z[ Instantiates and returns the list of permissions that this view requires. cSrbrr)rc permissionrrrrdrez+APIView.get_permissions..N)permission_classesrBrrrget_permissionsrgzAPIView.get_permissionscCra)zU Instantiates and returns the list of throttles that this view uses. cSrbrr)rcthrottlerrrrd"rez)APIView.get_throttles..N)throttle_classesrBrrr get_throttlesrgzAPIView.get_throttlescCst|dds ||_|jS)zN Instantiate and return the content negotiation class to use. _negotiatorN)rcontent_negotiation_classrsrBrrrget_content_negotiator$s  zAPIView.get_content_negotiatorcCs|jjS)zD Returns the exception handler that this view uses. N)rZEXCEPTION_HANDLERrBrrrget_exception_handler,szAPIView.get_exception_handlercCsN|}|}z ||||jWSty&|r%|d|djfYSw)zU Determine which renderer and media type to use render the response. rN)rfruZselect_renderer format_kwarg Exception media_type)rCrLforceZ renderersZconnegrrrperform_content_negotiation4s z#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)rCrLrrrperform_authenticationBs zAPIView.perform_authenticationcCs>|D]}|||s|j|t|ddt|dddqdS)z Check if the request should be permitted. Raises an appropriate exception if the request is not permitted. rRNrOrRrO)roZhas_permissionrSr)rCrLrmrrrcheck_permissionsLs    zAPIView.check_permissionscCs@|D]}||||s|j|t|ddt|dddqdS)z Check if the request should be permitted for a given object. Raises an appropriate exception if the request is not permitted. rRNrOr~)roZhas_object_permissionrSr)rCrLobjrmrrrcheck_object_permissionsYs   z APIView.check_object_permissionscCs^g}|D]}|||s||q|r-dd|D}t|dd}|||dSdS)z| Check if request should be throttled. Raises an appropriate exception if the request is throttled. cSsg|]}|dur|qS)Nr)rcdurationrrrrdss z+APIView.check_throttles..N)default)rrZ allow_requestappendr)maxrT)rCrLZthrottle_durationsrpZ durationsrrrrcheck_throttlesfs   zAPIView.check_throttlescOs2|jdurdS|}|j|g|Ri||fS)z If versioning is being used, then determine any API version for the incoming request. Returns a two-tuple of (version, versioning_scheme) NNN)versioning_classdetermine_version)rCrLr-rMschemerrrr{s zAPIView.determine_versioncOs(||}t|||||dS)z5 Returns the initial request object. )parsersrPZ negotiatorparser_contextN)rYrrjrUru)rCrLr-rMrrrrinitialize_requests zAPIView.initialize_requestcOst|jdi||_||}|\|_|_|j|g|Ri|\}}|||_|_||| || |dS)zX Runs anything that needs to occur prior to calling the method handler. Nr) r`rwr{accepted_rendereraccepted_media_typerversionZversioning_schemer}rr)rCrLr-rMnegrrrrrinitials    zAPIView.initialc Ost|ts Jdt|t|tr2t|dds%|j|dd}|\|_|_|j|_|j|_||_ |j dd}|durEt |t ||j D]\}}|||<qJ|S)z4 Returns the final response object. zrExpected a `Response`, `HttpResponse` or `StreamingHttpResponse` to be returned from the view, but received a `%s`rNT)rzrF)r,rtyperrr{rrr\Zrenderer_contextr+popr r splititems) rCrLresponser-rMrZ vary_headerskeyvaluerrrfinalize_responses$      zAPIView.finalize_responsecCsht|tjtjfr||j}|r||_ntj|_ | }| }|||}|dur/| |d|_ |S)zz Handle any exception that occurs, by returning an appropriate response, or re-raising the error. NT)r,rrQZAuthenticationFailedrVrLr(rZHTTP_403_FORBIDDENr0rvr]raise_uncaught_exception exception)rCr1r(r4r2rrrrhandle_exceptions   zAPIView.handle_exceptioncCs.tjr|j}t|jd}|dv}|||)Nformat)r#apiZadmin)rDEBUGrLrrZforce_plaintext_errors)rCr1rLZrenderer_formatZuse_plaintext_tracebackrrrrs   z APIView.raise_uncaught_exceptionc Os||_||_|j|g|Ri|}||_|j|_z/|j|g|Ri||j|j vr9t ||j|j }n|j }||g|Ri|}Wnt y_}z | |}WYd}~nd}~ww|j||g|Ri||_|jS)z `.dispatch()` is pretty much the same as Django's regular dispatch, but with extra hooks for startup, finalize, and exception handling. N)r-rMrrLrJr+rrKlowerZhttp_method_namesrrNrxrrr)rCrLr-rMhandlerrr1rrrdispatchs& zAPIView.dispatchcOs@|jdur|j|g|Ri|S|||}t|tjdS)z< Handler method for HTTP 'OPTIONS' request. N)r)metadata_classrNZdetermine_metadatarrZ HTTP_200_OK)rCrLr-rMr3rrroptionss zAPIView.optionsrF);r __module__ __qualname__rZDEFAULT_RENDERER_CLASSESrIZDEFAULT_PARSER_CLASSESriZDEFAULT_AUTHENTICATION_CLASSESrlZDEFAULT_THROTTLE_CLASSESrqZDEFAULT_PERMISSION_CLASSESrnZ!DEFAULT_CONTENT_NEGOTIATION_CLASSrtZDEFAULT_METADATA_CLASSrZDEFAULT_VERSIONING_CLASSrrrZschema classmethodr=propertyrDrJrNrSrTrVrYr\r]rr$r`rfrjrUrorrrurvr{r}rrrrrrrrrrr __classcell__rrrArr5is^             r5Nr)*r!Zdjangorr@Z django.confrZdjango.core.exceptionsrZ django.dbrrZ django.httprZdjango.http.responserZdjango.utils.cacher r Zdjango.utils.encodingr Zdjango.views.decorators.csrfr Zdjango.views.genericr Zrest_frameworkrrZrest_framework.requestrZrest_framework.responserZrest_framework.schemasrZrest_framework.settingsrZrest_framework.utilsrrr$r&r4r5rrrrs,              !