=!gfddlZddlZddlZddlmZddlmZmZddl Z ddl m Z m Z ddl mZddlmZddlmZddlmZmZddlmZmZdd lmZd d lmZd d lmZd d lm Z d dl!m"Z"m#Z#m$Z$d dlm%Z%m&Z&d dl'm(Z(m)Z)m*Z*ej+e,Z-ej.dZ/dZ0dZ1GddeZGddZ2dS)N) OrderedDict defaultdict) URLPattern URLResolver) versioning)SchemaGenerator)EndpointEnumerator)endpoint_ordering get_pk_name)get_pk_description is_list_view) api_settings)openapi)swagger_settings)SwaggerGenerationError)get_basic_type_infoget_queryset_fieldget_queryset_from_view)ReferenceResolver SwaggerDict)force_real_str get_consumes get_producesz{(?P\w+)}cd|D}t|}t|}|}t|D]\}}|||kr |d|}ndd|zS)Nc^g|]*}|dd+S)/)stripsplit).0paths N/var/www/html/nourish/venv/lib/python3.11/site-packages/drf_yasg/generators.py zcommon_path..s0@@@$4::c??((--@@@r)minmax enumeratejoin)paths split_pathss1s2commonics r" common_pathr0s@@%@@@K [  B [  B F" 1 1::VF E  &!! !!r$c |dvS)N>listcreateupdatedestroyretrievepartial_update)actions r"is_custom_actionr:(s  r$cPeZdZd fd ZfdZd fd ZdZd dZdZd Z xZ S) r Nchtt|||||_dSN)superr __init__request)selfpatternsurlconfr@ __class__s r"r?zEndpointEnumerator.__init__/s/  $''007CCC r$c|drtd||t t ||S)N)zEurl pattern does not end in $ ('%s') - unexpected things might happen)endswithloggerwarning unescape_pathr>r get_path_from_regex)rA path_regexrDs r"rKz&EndpointEnumerator.get_path_from_regex3s^   s # # p NNbdn o o o!!%(:D"A"A"U"UV`"a"abbbr$cltt|||sdSt|jdd}t|jdd}|5t |tjr|r|| dvrdSt|jdtdSdS)NFversionversioning_class:swagger_schemaT) r>r should_include_endpointgetattrr@cls issubclassrNamespaceVersioningrobject) rAr!callbackapp_name namespaceurl_namerOrPrDs r"rSz*EndpointEnumerator.should_include_endpoint8s'..FFtXVV 5$, 488"8<1CTJJ  'J7GIg,h,h ' 7)//#*>*>>>u 8&>x&H&H;;F(,fh'?H)00:::: NNNNN#=NMMMMMNG[11 P#'#9#9$1%GOe'2B2BCCU\UeJSjG4E4EFFY`Yj&7 $:$$ $$%566668??W NNOOOO}2CDDD sAC1)AC11&DDc.tjdd|S)zzUnescape all backslash escapes from `s`. :param str s: string with backslash escapes :rtype: str z\\(.)z\1)resub)rAss r"unescapezEndpointEnumerator.unescapesvhq)))r$cFd}|rt|}|s|||z }ng|||d|z }||z }||d}||S)aRemove backslashes escapes from all path components outside {parameters}. This is needed because ``simplify_regex`` does not handle this correctly. **NOTE:** this might destructively affect some url regex patterns that contain metacharacters (e.g. \w, \d) outside path parameter groups; if you are in this category, God help you :param str path: path possibly containing :return: the unescaped path :rtype: str rMN)PATH_PARAMETER_REsearchrstartgroupend)rAr! clean_pathmatchs r"rJz EndpointEnumerator.unescape_paths  &%,,T22E dmmD111  $--^ekkmm^(<== =J %++-- 'J %D &r$)NNN)rMrMN)NrMNNN) __name__ __module__ __qualname__r?rKrSrcrsrrJ __classcell__)rDs@r"r r .sccccc      *1111f***r$r ceZdZdZeZeZddddddZdd Z e d Z d Z d Z ddZddZdZdZdZdZdZdZdZdZdZdZdZd S)OpenAPISchemaGeneratorz This class iterates over all registered API endpoints and returns an appropriate OpenAPI 2.0 compliant schema. Method implementations shamelessly stolen and adapted from rest-framework ``SchemaGenerator``. r6r3r4r7r5)getpostputpatchdeleterMNct|j||dd|||_||_||_g|_g|_tj |_ |tj tj }|rgtj |}|jdvs|jst!d|jrt$d|zdS||j_dSdS)a :param openapi.Info info: information about the API :param str version: API version string; if omitted, `info.default_version` will be used :param str url: API scheme, host and port; if ``None`` is passed and ``DEFAULT_API_URL`` is not set, the url will be inferred from the request made against the schema view, so you should generally not need to set this parameter explicitly; if the empty string is passed, no host and scheme will be emitted If `url` is not ``None`` or the empty string, it must be a scheme-absolute uri (i.e. starting with http:// or https://), and any path component is ignored; See also: :ref:`documentation on base URL construction ` :param patterns: if given, only these patterns will be enumerated for inclusion in the API spec :param urlconf: if patterns is not given, use this urlconf to enumerate patterns; if not given, the default urlconf is used descriptionrMN)httphttpsz%`url` must be an absolute HTTP(S) urlzKpath component of api base URL %s is ignored; use FORCE_SCRIPT_NAME instead)rtitler_genrarOconsumesproducesrSCHEMA_COERCE_METHOD_NAMEScoerce_method_namesrDEFAULT_API_URLurlparseschemenetlocrr!rHrIurl)rArarOrrBrC parsed_urls r"r?zOpenAPISchemaGenerator.__init__s"$DJTXXmR5P5PRZ\cdd     #/#J ;+;G"2C  $!*3//J (999AR9,-TUUU $lorrsssss #  $ $r$c|jjSr=)rr)rAs r"rzOpenAPISchemaGenerator.urls y}r$cLtj}|tj|i}|S)aGet the security schemes for this API. This determines what is usable in security requirements, and helps clients configure their authorization credentials. :return: the security schemes usable with this API :rtype: dict[str,dict] or None )rSECURITY_DEFINITIONSr _as_odict)rAsecurity_definitionss r"get_security_definitionsz/OpenAPISchemaGenerator.get_security_definitionss- 0D  +#.#89Mr#R#R ##r$c~tj}| d|D}d|D}t|t}|S)ajGet the base (global) security requirements of the API. This is never called if :meth:`.get_security_definitions` returns `None`. :param security_definitions: security definitions as returned by :meth:`.get_security_definitions` :return: the security schemes accepted by default :rtype: list[dict[str,list[str]]] or None Ncg|]}|giSr8r8)r security_schemes r"r#zDOpenAPISchemaGenerator.get_security_requirements..s$g$g$gor%:$g$g$gr$c8g|]}tj|iSr8)rr)r srs r"r#zDOpenAPISchemaGenerator.get_security_requirements..s% _ _ _2!6r2!>!> _ _ _r$rh)rSECURITY_REQUIREMENTSrxr2)rArsecurity_requirementss r"get_security_requirementsz0OpenAPISchemaGenerator.get_security_requirementssW!1 F ($g$gRf$g$g$g ! _ _I^ _ _ _ &'<$ G G G$$r$Fc 6||}|tjd}t t j|_tt j |_ | ||||\}}| }|r| |}nd}|j} | ||} tjd|j||jpd|j pd||| ||jd t'|S)aGenerate a :class:`.Swagger` object representing the API schema. :param request: the request used for filtering accessible endpoints and finding the spec URI :type request: rest_framework.request.Request or None :param bool public: if True, all endpoints are included regardless of access through `request` :return: the generated Swagger specification :rtype: openapi.Swagger T) force_initN) rar)rrrsecurity_url_prefix_versionr8) get_endpointsreference_resolver_classrSCHEMA_DEFINITIONSrrDEFAULT_PARSER_CLASSESrrDEFAULT_RENDERER_CLASSESr get_pathsrrrbuild_absolute_uriSwaggerrarOdict) rAr@public endpoints componentsr)rfrrrs r" get_schemaz!OpenAPISchemaGenerator.get_schemas)&&w// 2273MZ^2__ $\%HII $\%JKK y*gvNN v#<<>>  )$($B$BCW$X$X ! !$( !h ;7.,,..C %$-2G4RVR_Rgcg!5@Uft|  @DJ?O?O   r$c |j|||}t|dd}|C|D].\}}t||d}|t |jd|/t |dd|S)aPCreate a view instance from a view callback as registered in urlpatterns. :param callback: view callback registered in urlpatterns :param str method: HTTP method :param request: request to bind to the view :type request: rest_framework.request.Request or None :return: the view instance _swagger_auto_schemaNswagger_fake_viewT)r create_viewrTitemssetattr__func__)rArYrzr@view overrides_ view_methods r"rz"OpenAPISchemaGenerator.create_view&sy$$Xvw??H&z8OpenAPISchemaGenerator.get_endpoints.._s(XXXMD'x~w/XXXr$) endpoint_enumerator_classrrBrCrsrr2rrrqrUr) rAr@ enumeratorr view_pathsr!rzrYrrs @r"rz$OpenAPISchemaGenerator.get_endpointsMs33DI4F HYcj3kk 0022  && &/ * * "D&(##Hfg>>D##D$//D t  # #VTN 3 3 3%\HTNNXXXXZEUEUEWEWXXXXr$c,t|dr|j}n3t|||rd}n|j|}d|ddD}t|rmd|jD}t|dkr;|j|}||j vr |j |}||gzS|dd|gzS||j vr |j |}||gzS) aXReturn a list of keys that should be used to group an operation within the specification. :: /users/ ("users", "list"), ("users", "create") /users/{pk}/ ("users", "read"), ("users", "update"), ("users", "delete") /users/enabled/ ("users", "enabled") # custom viewset list action /users/{pk}/star/ ("users", "star") # custom viewset detail action /users/{pk}/groups/ ("users", "groups", "list"), ("users", "groups", "create") /users/{pk}/groups/{pk}/ ("users", "groups", "read"), ("users", "groups", "update") :param str subpath: path to the operation with any common prefix/base path removed :param str method: HTTP method :param view: the view associated with the operation :rtype: list[str] r9r2cg|]}d|v| S){r8)r components r"r#z=OpenAPISchemaGenerator.get_operation_keys..zs-! ! ! #)## ###r$rch|] }|dk| S)headr8)r rzs r" z.s)!&8H8H8H8H8Hr$rN) hasattrr9r default_mappinglowerrrr: action_maplenr)rAsubpathrzrr9named_path_componentsmapped_methodss r"get_operation_keysz)OpenAPISchemaGenerator.get_operation_keysasN 4 " " >[FFGVT22 >-fllnn=! ! }}S!!'',,! ! !  F # # =%)_N>""Q&&-fllnn=T555!5f=F,x77,SbS1VH<< T- - --f5F%x//r$c<g}|D]}|dd}g}|D]}d|vrn||d|dd}|sdS|d|zdzt |S)a Given a list of all paths, return the common prefix which should be discounted when generating a schema structure. This will be the longest common string that does not include that last component of the URL, or the last component before a path parameter. For example: :: /api/v1/users/ /api/v1/users/{pk}/ The path prefix is ``/api/v1/``. :param list[str] paths: list of paths :rtype: str rrNr)rrrqr(r0)rAr)prefixesr!rinitial_componentsrrfs r"determine_path_prefixz,OpenAPISchemaGenerator.determine_path_prefixs$ 0 0DC..s33J!# ' 5 5 )##E")))4444XX0"566F ss OOC&L3. / / / /8$$$r$c>|p|j|||S)aCheck if a given endpoint should be included in the resulting schema. :param str path: request path :param str method: http request method :param view: instantiated view callback :param bool public: if True, all endpoints are included regardless of access through `request` :returns: true if the view should be excluded :rtype: bool )rhas_view_permissions)rAr!rzrrs r"rSz.OpenAPISchemaGenerator.should_include_endpoints#K77fdKKKr$c,tj|S)zConstruct the Swagger Paths object. :param OrderedDict[str,openapi.PathItem] paths: mapping of paths to :class:`.PathItem` objects :returns: the :class:`.Paths` object :rtype: openapi.Paths r))rPaths)rAr)s r"get_paths_objectz'OpenAPISchemaGenerator.get_paths_objects}5))))r$c |stjidfS|t|pd}d|vs Jdt }t |D]\}\}} i} | D]Q\} } ||| | |s| | ||| ||} | | | | <R| rK|t|d}| dsd|z}| ||| ||<|||fS)a+Generate the Swagger Paths for the API from the given endpoints. :param dict endpoints: endpoints as returned by get_endpoints :param ReferenceResolver components: resolver/container for Swagger References :param Request request: the request made against the schema view; can be None :param bool public: if True, all endpoints are included regardless of access through `request` :returns: the :class:`.Paths` object and the longest common path prefix, as a 2-tuple :rtype: tuple[openapi.Paths,str] rrMrz,base path cannot be templated in swagger 2.0Nr)rrrr2keysrrxrrS get_operationrr startswith get_path_itemr)rArrr@rrfr)r!rr operationsrzr operation path_suffixs r"rz OpenAPISchemaGenerator.get_pathss /=r***B. .++D1A1A,B,BCCIr&   "P    )/ 0A0A)B)B T T %D%8WJ ' ; ; 33D&$OO ..tT66:W^__ (1:Jv||~~. T#3v;;<<0 "--c224"% "3K%)%7%7h %S%Sk"$$U++V33r$c  ||t|d||}|||}tj} t |d| } |d| } | dS| |||||||} | |} | dSd| vr,t| j t|j kr| ` d| vr,t| j t|j kr| ` | S)aGet an :class:`.Operation` for the given API endpoint (path, method). This method delegates to :meth:`~.inspectors.ViewInspector.get_operation` of a :class:`~.inspectors.ViewInspector` determined according to settings and :func:`@swagger_auto_schema <.swagger_auto_schema>` overrides. :param view: the view associated with this endpoint :param str path: the path component of the operation URL :param str prefix: common path prefix among all endpoints :param str method: the http method of the operation :param openapi.ReferenceResolver components: referenceable components :param Request request: the request made against the schema view; can be None :rtype: openapi.Operation NrR auto_schemarr) rr get_overridesrDEFAULT_AUTO_SCHEMA_CLASSrTrrrjrr) rArr!rfrzrr@operation_keysrview_inspector_clsview_inspectorrs r"rz$OpenAPISchemaGenerator.get_operations 00c&kkll1CVTRR&&tV44 .G$T+;=OPP&]]=:LMM  %4++D$ GU^`noo"00@@  4  " "s9+='>'>#dmBTBT'T'T"  " "s9+='>'>#dmBTBT'T'T"r$cT|||}tjdd|i|S)aGet a :class:`.PathItem` object that describes the parameters and operations related to a single path in the API. :param str path: the path :param type view_cls: the view that was bound to this path in urlpatterns :param dict[str,openapi.Operation] operations: operations defined on this path, keyed by lowercase HTTP method :rtype: openapi.PathItem parametersr8)get_path_parametersrPathItem)rAr!rrpath_parameterss r"rz$OpenAPISchemaGenerator.get_path_items5224BBII?IjIIIr$c|}t|d|}t||d}t|di}||vr||}tj|S)a"Get overrides specified for a given operation. :param view: the view associated with the operation :param str method: HTTP method :return: a dictionary containing any overrides set by :func:`@swagger_auto_schema <.swagger_auto_schema>` :rtype: dict r9Nr)rrTcopydeepcopy)rArrzr9 action_methodrs r"rz$OpenAPISchemaGenerator.get_overrides"sjx00fd33 M+A2FF Y  !&)I}Y'''r$c fg}t|}tj|D] }t||\}}t |p dt ji}t|dd|kr>|dt jkr(t|d|dd|d<|rt|ddr|j } n&|r"t|ddrt||} nd} t j d |t| d t j d |} ||  |S) aReturn a list of Parameter instances corresponding to any templated path variables. :param str path: templated request path :param type view_cls: the view class associated with the path :return: path parameters :rtype: list[openapi.Parameter] rw lookup_fieldNlookup_value_regexrl help_textF primary_keyT)rnrrequiredin_r8)r uritemplate variablesrrr TYPE_STRINGrTrrr ParameterrIN_PATHrq) rAr!rr querysetvariabler model_fieldattrsrfields r"r z*OpenAPISchemaGenerator.get_path_parameters3s_ )(33#-d33 % %H!3Hh!G!G E;' 44UAT8UEx66(BBuV}X_XkGkGk#*85I599U^`dKeKe#f#fi  #w{KGG #)3  #mU!K!K #0 DD " %*;77O   E   e $ $ $ $r$)rMNNN)NFr=)rrr__doc__r rrrrr?propertyrrrrrrrrrrSrrrrrr r8r$r"rrsr!30! O"$"$"$"$HX $ $ $%%%     @*999$YYY(101010f % % %D L L L***#4#4#4J$$$L J J J((("!!!!!r$r)3rloggingr~ urllib.parseparser collectionsrrr django.urlsrrrest_frameworkrrest_framework.schemas.openapir!rest_framework.schemas.generatorsr _EndpointEnumeratorr r rest_framework.schemas.utilsr r rest_framework.settingsrrMr app_settingsrerrorsrinspectors.fieldrrrrrutilsrrr getLoggerrrHcompilerr0r:rr8r$r"r5s#  00000000////////%%%%%%::::::WWWWWWLLLLLLLLIIIIIIII000000************]]]]]]]]]]33333333==========  8 $ $BJ677 " " " ,Dddddddddddr$