o hJ@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 ViewSetsuffix )getattr __class____name__rremove_trailing_stringcamelcase_to_spaces)viewrrrT/var/www/html/premium_crap/venv/lib/python3.10/site-packages/rest_framework/views.py get_view_names      r!FcCs@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 markup_description)rhtmlr"rrr get_view_description0s   r(cCs,tD]}|jdr|jr|dqdS)NATOMIC_REQUESTST)rall settings_dictin_atomic_block set_rollback)dbrrr r-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) isinstancerrNotFoundargsr APIExceptionrr/r0r1listdictr-r status_code)exccontextr2datarrr exception_handlerHs        r=csheZdZejZejZejZ 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.) RuntimeErrorrrrr force_evaluationsz)APIView.as_view..force_evaluation)Fr)r3rrqueryQuerySetr? _fetch_allsuperas_viewcls initkwargsDJANGO_VERSIONlogin_requiredr )rIrJrArrrr rHzszAPIView.as_viewcCs|S)zZ Wrap Django's private `_allowed_methods` interface in a public property. )_allowed_methodsselfrrr allowed_methodsszAPIView.allowed_methodscCs*dd|ji}t|jdkrd|d<|S)NAllowz, rCAcceptVary)joinrQlenrenderer_classes)rPr2rrr default_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. )rMethodNotAllowedmethod)rPrequestr5kwargsrrr http_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. )r1code)authenticatorssuccessful_authenticatorrNotAuthenticatedr)rPr[messager^rrr permission_denieds zAPIView.permission_deniedcCs t|)zU If request is throttled, determine what kind of exception to raise. )r Throttled)rPr[r0rrr 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_authenticatorsauthenticate_header)rPr[r_rrr get_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. r5rr\)rr5r\r)rP http_requestrrr get_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. r5rr\r[Nrr5r\r[rirOrrr get_renderer_contexts    zAPIView.get_renderer_contextcCrl)zp Returns a dict that is passed through to EXCEPTION_HANDLER, as the `context` argument. r5rr\r[NrmrirOrrr get_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. )rVIEW_NAME_FUNCTION)rPfuncrrr r!szAPIView.get_view_nameFcCs|jj}|||S)z{ Return some descriptive text for the view, as used in OPTIONS responses and in the browsable API. )rVIEW_DESCRIPTION_FUNCTION)rPr'rqrrr r(s zAPIView.get_view_descriptioncKs|jjr ||jjSdS)zQ Determine if the request includes a '.json' style format suffix N)rFORMAT_SUFFIX_KWARGget)rPr\rrr get_format_suffixszAPIView.get_format_suffixcCdd|jDS)zX Instantiates and returns the list of renderers that this view can use. cSg|]}|qSrr).0rendererrrr z)APIView.get_renderers..)rWrOrrr get_rendererszAPIView.get_rendererscCrv)zV Instantiates and returns the list of parsers that this view can use. cSrwrr)rxparserrrr rzr{z'APIView.get_parsers..)parser_classesrOrrr get_parsers r}zAPIView.get_parserscCrv)z] Instantiates and returns the list of authenticators that this view can use. cSrwrr)rxauthrrr rzr{z.APIView.get_authenticators..)authentication_classesrOrrr rfr}zAPIView.get_authenticatorscCrv)z[ Instantiates and returns the list of permissions that this view requires. cSrwrr)rx permissionrrr rzr{z+APIView.get_permissions..)permission_classesrOrrr get_permissionsr}zAPIView.get_permissionscCrv)zU Instantiates and returns the list of throttles that this view uses. cSrwrr)rxthrottlerrr rz"r{z)APIView.get_throttles..)throttle_classesrOrrr get_throttlesr}zAPIView.get_throttlescCst|dds ||_|jS)zN Instantiate and return the content negotiation class to use. _negotiatorN)rcontent_negotiation_classrrOrrr get_content_negotiator$s  zAPIView.get_content_negotiatorcCs|jjS)zD Returns the exception handler that this view uses. )rEXCEPTION_HANDLERrOrrr get_exception_handler,szAPIView.get_exception_handlercCsN|}|}z ||||jWSty&|r%|d|djfYSw)zU Determine which renderer and media type to use render the response. r)r|rselect_renderer format_kwarg Exception media_type)rPr[force renderersconnegrrr perform_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)rPr[rrr perform_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. rbNr^rbr^)rhas_permissionrcr)rPr[rrrr check_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. rbNr^r)rhas_object_permissionrcr)rPr[objrrrr check_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)rxdurationrrr rzss z+APIView.check_throttles..N)default)r allow_requestappendr0maxre)rPr[throttle_durationsr durationsrrrr check_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)rPr[r5r\schemerrr r{s zAPIView.determine_versioncOs(||}t|||||dS)z5 Returns the initial request object. )parsersr_ negotiatorparser_context)rkrrrfr)rPr[r5r\rrrr initialize_requests zAPIView.initialize_requestcOst|jdi||_||}|\|_|_|j|g|Ri|\}}|||_|_||| || |dS)zX Runs anything that needs to occur prior to calling the method handler. Nr) rurraccepted_rendereraccepted_media_typerversionversioning_schemerrr)rPr[r5r\negrrrrr initials    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)rrT)r3rtyperrrrrrnrenderer_contextr2popr r splititems) rPr[responser5r\r vary_headerskeyvaluerrr finalize_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)r3rraAuthenticationFailedrhr[r/rHTTP_403_FORBIDDENr9rroraise_uncaught_exception exception)rPr:r/r=r;rrrr handle_exceptions   zAPIView.handle_exceptioncCs.tjr|j}t|jd}|dv}|||)Nformat)r'apiadmin)rDEBUGr[rrforce_plaintext_errors)rPr:r[renderer_formatuse_plaintext_tracebackrrr rs   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)r5r\rr[rXr2rrZlowerhttp_method_namesrr]rrrr)rPr[r5r\handlerrr:rrr dispatchs& zAPIView.dispatchcOs@|jdur|j|g|Ri|S|||}t|tjdS)z< Handler method for HTTP 'OPTIONS' request. N)r)metadata_classr]determine_metadatarr HTTP_200_OK)rPr[r5r\r<rrr optionss zAPIView.optionsrF);r __module__ __qualname__rDEFAULT_RENDERER_CLASSESrWDEFAULT_PARSER_CLASSESrDEFAULT_AUTHENTICATION_CLASSESrDEFAULT_THROTTLE_CLASSESrDEFAULT_PERMISSION_CLASSESr!DEFAULT_CONTENT_NEGOTIATION_CLASSrDEFAULT_METADATA_CLASSrDEFAULT_VERSIONING_CLASSrrrschema classmethodrHpropertyrQrXr]rcrerhrkrnror!r(rur|rrfrrrrrrrrrrrrrrrrr __classcell__rrrMr r>is^             r>Nr)*r$djangorrK django.confrdjango.core.exceptionsr django.dbrr django.httprdjango.http.responserdjango.utils.cacher r django.utils.encodingr django.views.decorators.csrfr django.views.genericr rest_frameworkrrrest_framework.requestrrest_framework.responserrest_framework.schemasrrest_framework.settingsrrest_framework.utilsrr!r(r-r=r>rrrr s,              !