_}dgoIdZddlmZddlmZddlmZmZddlm Z ddl m Z ddl m Z mZddlmZdd lmZdd lmZdd lmZmZdd lmZdd lmZddlmZddlmZddl m!Z!dZ"ddZ#dZ$dZ%GddeZ&dS)zL Provides an APIView class that is the base of all views in REST framework. )settings)PermissionDenied) connectionsmodels)Http404)HttpResponseBase) cc_delim_repatch_vary_headers) smart_str) csrf_exempt)View) exceptionsstatus)Request)Response) DefaultSchema) api_settings) formattingct|dd}||S|jj}tj|d}tj|d}tj|}t|dd}|r|d|zz }|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)viewrrs S/var/www/surfInsights/venv3-11/lib/python3.11/site-packages/rest_framework/views.py get_view_namer!s 4 & &D  > "D  ,T6 : :D  ,T9 = =D  )$ / /DT8T * *F  f  KFct|dd}||jjpd}tjt |}|rtj|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$s r get_view_descriptionr*/sa$ t44Kn,2 #Ik$:$:;;K :,[999 r"ctjD]+}|jdr|jr|d,dS)NATOMIC_REQUESTST)rall settings_dictin_atomic_block set_rollback)dbs r r0r0AsQo"" - . "23E " OOD ! ! !""r"ct|trtj|j}n(t|t rtj|j}t|tjri}t|ddr |j|d<t|ddr d|j z|d<t|j ttfr|j }n d|j i}tt||j|SdS) 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 APIExceptionrr3r4r5listdictr0r status_code)exccontextr6datas r exception_handlerrAGs#w7!CH. C) * *7)CH6#z.// G 3 t , , :*-/G& ' 3 % % 5%)CH_GM " cj4, / / *:DDcj)DS_gFFFF 4r"ceZdZejZejZejZ ej Z ej Z ejZejZejZeZeZefdZedZedZdZd$dZdZdZd Z d Z!d Z"d Z#d%dZ$dZ%dZ&dZ'dZ(dZ)dZ*dZ+dZ,d%dZ-dZ.dZ/dZ0dZ1dZ2dZ3dZ4dZ5d Z6d!Z7d"Z8d#Z9xZ:S)&APIViewc tt|ddtjjrd}||j_tjdi|}||_ ||_ 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. querysetNc td)NzDo not evaluate the `.queryset` attribute directly, as the result will be cached and reused between requests. Use `.all()` or call `.get_queryset()` instead.) RuntimeErrorr"r force_evaluationz)APIView.as_view..force_evaluations"Fr"rH) r7rrqueryQuerySetrE _fetch_allsuperas_viewcls initkwargsr )rOrPrIrrs r rNzAPIView.as_viewys| gc:t44fl6K L L 7    '7CL #uww,,,,$4   r"c*|S)zZ Wrap Django's private `_allowed_methods` interface in a public property. )_allowed_methodsselfs r allowed_methodszAPIView.allowed_methodss $$&&&r"cxdd|ji}t|jdkrd|d<|S)NAllowz, AcceptVary)joinrUlenrenderer_classes)rTr6s r default_response_headersz APIView.default_response_headerssE TYYt344  t$ % % ) )&GFOr"c4tj|j)z If `request.method` does not correspond to a handler method, determine what kind of exception to raise. )rMethodNotAllowedmethod)rTrequestr9kwargss r http_method_not_allowedzAPIView.http_method_not_alloweds )'.999r"Ncp|jr|jstjtj||)zY If request is not permitted, determine what kind of exception to raise. )r5code)authenticatorssuccessful_authenticatorrNotAuthenticatedr)rTrbmessagerfs r permission_deniedzAPIView.permission_denieds>  ! 0'*J 0-// /)tDDDDr"c*tj|)zU If request is throttled, determine what kind of exception to raise. )r Throttled)rTrbr4s r throttledzAPIView.throttleds"4(((r"ch|}|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)rTrbrgs r get_authenticate_headerzAPIView.get_authenticate_headersC 0022  B!!$88AA A B Br"cJ|t|ddt|didS)z| Returns a dict that is passed through to Parser.parse(), as the `parser_context` keyword argument. r9rHrc)rr9rcr)rT http_requests r get_parser_contextzAPIView.get_parser_contexts4D&"--dHb11   r"cj|t|ddt|dit|dddS)z Returns a dict that is passed through to Renderer.render(), as the `renderer_context` keyword argument. r9rHrcrbNrr9rcrbrtrSs r get_renderer_contextzAPIView.get_renderer_contextsCD&"--dHb11tY55    r"cj|t|ddt|dit|dddS)zp Returns a dict that is passed through to EXCEPTION_HANDLER, as the `context` argument. r9rHrcrbNrxrtrSs r get_exception_handler_contextz%APIView.get_exception_handler_contextsC D&"--dHb11tY55    r"c0|jj}||S)zf Return the view name, as used in OPTIONS responses and in the browsable API. )rVIEW_NAME_FUNCTION)rTfuncs r r!zAPIView.get_view_names }/tDzzr"Fc2|jj}|||S)z{ Return some descriptive text for the view, as used in OPTIONS responses and in the browsable API. )rVIEW_DESCRIPTION_FUNCTION)rTr)r~s r r*zAPIView.get_view_descriptions }6tD$r"c \|jjr||jjSdS)zQ Determine if the request includes a '.json' style format suffix N)rFORMAT_SUFFIX_KWARGget)rTrcs r get_format_suffixzAPIView.get_format_suffixs5 = , A::dm?@@ @ A Ar"c$d|jDS)zX Instantiates and returns the list of renderers that this view can use. c"g|] }| SrHrH).0renderers r z)APIView.get_renderers..AAAx AAAr")r]rSs r get_rendererszAPIView.get_renderersBA4+@AAAAr"c$d|jDS)zV Instantiates and returns the list of parsers that this view can use. c"g|] }| SrHrH)rparsers r rz'APIView.get_parsers.. s;;;V;;;r")parser_classesrSs r get_parserszAPIView.get_parserss<;t':;;;;r"c$d|jDS)z] Instantiates and returns the list of authenticators that this view can use. c"g|] }| SrHrH)rauths r rz.APIView.get_authenticators..s???4???r")authentication_classesrSs r rpzAPIView.get_authenticators s@?4#>????r"c$d|jDS)z[ Instantiates and returns the list of permissions that this view requires. c"g|] }| SrHrH)r permissions r rz+APIView.get_permissions..sGGG GGGr")permission_classesrSs r get_permissionszAPIView.get_permissionssHGt/FGGGGr"c$d|jDS)zU Instantiates and returns the list of throttles that this view uses. c"g|] }| SrHrH)rthrottles r rz)APIView.get_throttles..rr")throttle_classesrSs r get_throttleszAPIView.get_throttlesrr"cdt|dds||_|jS)zN Instantiate and return the content negotiation class to use. _negotiatorN)rcontent_negotiation_classrrSs r get_content_negotiatorzAPIView.get_content_negotiators6t]D11 @#==??D r"c|jjS)zD Returns the exception handler that this view uses. )rEXCEPTION_HANDLERrSs r get_exception_handlerzAPIView.get_exception_handler&s}..r"c|}|} ||||jS#t$r|r|d|djfcYSwxYw)zU Determine which renderer and media type to use render the response. r)rrselect_renderer format_kwarg Exception media_type)rTrbforce renderersconnegs r perform_content_negotiationz#APIView.perform_content_negotiation.s&&(( ,,.. ))'9d>OPP P    ?!! il&=>>>>  sA!A+)A+c|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)rTrbs r perform_authenticationzAPIView.perform_authentication<s  r"c |D]N}|||s6||t|ddt|ddOdS)z Check if the request should be permitted. Raises an appropriate exception if the request is not permitted. rjNrfrjrf)rhas_permissionrkr)rTrbrs r check_permissionszAPIView.check_permissionsFs ..00  J,,Wd;; &&#J 4@@ VT::'  r"c |D]O}||||s6||t|ddt|ddPdS)z Check if the request should be permitted for a given object. Raises an appropriate exception if the request is not permitted. rjNrfr)rhas_object_permissionrkr)rTrbobjrs r check_object_permissionsz APIView.check_object_permissionsSs ..00  J33GT3GG &&#J 4@@ VT::'  r"c g}|D]?}|||s'||@|r5d|D}t |d}|||dSdS)z| Check if request should be throttled. Raises an appropriate exception if the request is throttled. cg|]}||S)NrH)rdurations r rz+APIView.check_throttles..ms(%''''r"N)default)r allow_requestappendr4maxrn)rTrbthrottle_durationsr durationsrs r check_throttleszAPIView.check_throttles`s  **,, ; ;H))'488 ;"))(--//:::  .);I 9d333H NN7H - - - - - . .r"cb|jdS|}|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)rTrbr9rcschemes r rzAPIView.determine_versionusK  (<&&((((B4BBB6BBFKKr"c||}t|||||S)z5 Returns the initial request object. )parsersrg negotiatorparser_context)rvrrrpr)rTrbr9rcrs r initialize_requestzAPIView.initialize_requestsa0099 $$&&22442244)     r"c6|jdi||_||}|\|_|_|j|g|Ri|\}}||c|_|_||| || |dS)zX Runs anything that needs to occur prior to calling the method handler. NrH) rrraccepted_rendereraccepted_media_typerversionversioning_schemerrr)rTrbr9rcnegrrs r initialzAPIView.initials3D2<!7#>1$0J4JJJ6JJ5> M66wd6KKILF)7+F)0)BH &+2+FH ((,(A(A(C(CH %|''55  # x):<)H)H I I I,,,.. " "JC!HSMMr"c`t|tjtjfr5||j}|r||_ntj|_ | }| }|||}|| |d|_ |S)zz Handle any exception that occurs, by returning an appropriate response, or re-raising the error. NT)r7rriAuthenticationFailedrrrbr3rHTTP_403_FORBIDDENr=rr{raise_uncaught_exception exception)rTr>r3rAr?rs r handle_exceptionzAPIView.handle_exceptions cJ7&;= > > <66t|DDK <"-"("; 66884466$$S'22    ) )# . . .!r"ctjr5|j}t|jd}|dv}|||)Nformat)r)apiadmin)rDEBUGrbrrforce_plaintext_errors)rTr>rbrenderer_formatuse_plaintext_tracebacks r rz APIView.raise_uncaught_exceptionsL > DlG%g&?JJO&5=U&U #  * *+B C C C r"c||_||_|j|g|Ri|}||_|j|_ |j|g|Ri||j|j vr.t||j|j }n|j }||g|Ri|}n,#t$r}| |}Yd}~nd}~wwxYw|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)r9rcrrbr^r6rralowerhttp_method_namesrrdrrrr)rTrbr9rchandlerrr>s r dispatchzAPIView.dispatchsL   )$)'CDCCCFCC 4  2 DL 24 2 2 26 2 2 2~##%%)???!$(<(<(>(>"&">@@6ww888888HH 2 2 2,,S11HHHHHH 2/.wR4RRR6RR }sA2B'' C1C  Cc|j|j|g|Ri|S|||}t|tjS)z< Handler method for HTTP 'OPTIONS' request. N)r)metadata_classrddetermine_metadatarr HTTP_200_OK)rTrbr9rcr@s r optionszAPIView.optionssg   &/4/I$III&II I""$$77FFV%78888r"rF);r __module__ __qualname__rDEFAULT_RENDERER_CLASSESr]DEFAULT_PARSER_CLASSESrDEFAULT_AUTHENTICATION_CLASSESrDEFAULT_THROTTLE_CLASSESrDEFAULT_PERMISSION_CLASSESr!DEFAULT_CONTENT_NEGOTIATION_CLASSrDEFAULT_METADATA_CLASSrDEFAULT_VERSIONING_CLASSrrrschema classmethodrNpropertyrUr^rdrkrnrrrvryr{r!r*rrrrprrrrrrrrrrrrrrrrr __classcell__)rs@r rCrChs$<!8N)H#<%@ , N!8N#<H ]__F!!!![!0''X' X:::EEEE))) BBB                AAABBB <<< @@@ HHH BBB    ///          ...*LLL    &&&&<4:9999999r"rCNr)'r& 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*r0rArCrHr"r rs! 333333))))))))111111>>>>>>>>++++++444444%%%%%%--------******,,,,,,000000000000++++++2$""" Ba9a9a9a9a9da9a9a9a9a9r"