a ΝGdZy@s<ddlZddlZddlZddlmZddlmZddlmZddl m Z ddl m Z ddl mZmZmZzddlmZWneyeZYn0eeZd Zd Zd Zd Zd ZdZdZdZdZdZ dZ!dZ"dZ#dZ$dZ%dZ&dZ'dZ(dZ)dZ*dZ+dZ,dZ-d Z.d!Z/d"Z0d#Z1d$Z2d%Z3d&d'Z4d(d)Z5Gd*d+d+eZ6Gd,d-d-e6Z7Gd.d/d/e6Z8Gd0d1d1e6Z9Gd2d3d3e6Z:Gd4d5d5e6Z;Gd6d7d7e6ZGdd?d?e6Z@Gd@dAdAe6ZAGdBdCdCe6ZBGdDdEdEeBZCeAeCfeA_DdFdGZEGdHdIdIe6ZFGdJdKdKe6ZGGdLdMdMeHZIdS)NN) OrderedDict)get_script_prefix)Promise)camelize)dict_has_ordered_keys filter_noneforce_real_str)abcobjectstringnumberintegerbooleanarrayfiledatez date-timepasswordbinarybytesfloatdoubleZint32Zint64emailZipv4Zipv6uriuuidZslugdecimalbodypathqueryZformDataheader definitionscCs@|dkr dS|dr.dt|ddddSt|d ddS) an Convert a python variable name into a Swagger spec attribute name. In particular, * if name starts with ``x_``, return ``x-{camelCase}`` * if name is ``ref``, return ``$ref`` * else return the name converted to camelCase, with trailing underscores stripped :param str attribute_name: python attribute name :return: swagger name ref$refZx_zx-NF)Zuppercase_first_letter_) startswithrrstrip)Zattribute_namer'L/var/www/html/django/DPS/env/lib/python3.9/site-packages/drf_yasg/openapi.pymake_swagger_name;s  r)cCs&t|tsJ||}t||SN) issubclass SwaggerDict__new__r__init__)clsresultr'r'r(_bare_SwaggerDictNs  r1csdeZdZdZfddZfddZddZfdd Zd d Ze d d Z ddZ ddZ Z S)r,a0A particular type of OrderedDict, which maps all attribute accesses to dict lookups using :func:`.make_swagger_name`. Attribute names starting with ``_`` are set on the object as-is and are not included in the specification output. Used as a base class for all Swagger helper models. c s,tt|||_t|tkr(|dSr*)superr,r. _extras__type_insert_extras__selfattrs __class__r'r(r.]s zSwaggerDict.__init__cs8|dr tt|||dS|dur4||t|<dSNr$)r%r2r, __setattr__r)r7keyvaluer9r'r(r<cs  zSwaggerDict.__setattr__cCsN|drtz|t|WStyHtdt|jd|Yn0dS)Nr$zobject of class z has no attribute )r%AttributeErrorr)KeyErrorr4__name__r7itemr'r'r( __getattr__js   zSwaggerDict.__getattr__cs,|drtt||dS|t|=dSr;)r%r2r, __delattr__r)rCr9r'r(rFss zSwaggerDict.__delattr__cCs(t|jD]\}}t|||qdS)a@ From an ordering perspective, it is desired that extra attributes such as vendor extensions stay at the bottom of the object. However, python2.7's OrderedDict craps out if you try to insert into it before calling init. This means that subclasses must call super().__init__ as the first statement of their own __init__, which would result in the extra attributes being added first. For this reason, we defer the insertion of the attributes and require that subclasses call ._insert_extras__ at the end of their __init__ method. N)sortedr3itemssetattr)r7attrvalr'r'r(r5yszSwaggerDict._insert_extras__cst|vrt|St|tr4t|dr4|}t|tjrt}|t|<|}t |sjt |}|D]\}}t |||<qn|St|t rt|St|tjrt|tjst|fdd|DS|S)z*Implementation detail of :meth:`.as_odict`_proxy____castc3s|]}t|VqdSr*r, _as_odict).0elemmemor'r( z(SwaggerDict._as_odict..)id isinstancerhasattrrLcollections_abcMappingrrHrrGr,rNstrr IterableIteratorr4)objrRr0rHrJrKr'rQr(rNs$      zSwaggerDict._as_odictcCs t|iS)z[Convert this object into an ``OrderedDict`` instance. :rtype: OrderedDict rMr7r'r'r(as_odictszSwaggerDict.as_odictcCs2ddt|D}tt|f|dt|fS)NcSs i|]\}}|ds||qS)Z_NP_)r%rOkvr'r'r( rTz*SwaggerDict.__reduce__..)varsrHr1r4iterr6r'r'r( __reduce__szSwaggerDict.__reduce__)rB __module__ __qualname____doc__r.r<rErFr5 staticmethodrNr_rf __classcell__r'r'r9r(r,Us     r,cseZdZdfdd ZZS)ContactNc sTtt|jfi||dur6|dur6|dur6td||_||_||_|dS)zSwagger Contact object At least one of the following fields is required: :param str name: contact name :param str url: contact url :param str email: contact e-mail Nz@one of name, url or email is requires for Swagger Contact object)r2rlr.AssertionErrornameurlrr5)r7rnrorextrar9r'r(r.s zContact.__init__)NNNrBrgrhr.rkr'r'r9r(rlsrlcseZdZdfdd ZZS)LicenseNc s>tt|jfi||dur&td||_||_|dS)zSwagger License object :param str name: Required. License name :param str url: link to detailed license information Nz+name is required for Swagger License object)r2rrr.rmrnror5)r7rnrorpr9r'r(r.s zLicense.__init__)Nrqr'r'r9r(rrsrrcseZdZdfdd ZZS)InfoNc stt|jfi||dus&|dur.td|durHt|tsHtd|durbt|tsbtd||_||_||_ ||_ ||_ ||_ | dS)aSwagger Info object :param str title: Required. API title. :param str default_version: Required. API version string (not to be confused with Swagger spec version) :param str description: API description; markdown supported :param str terms_of_service: API terms of service; should be a URL :param Contact contact: contact object :param License license: license object Nz6title and version are required for Swagger info objectz contact must be a Contact objectz license must be a License object)r2rsr.rmrVrlrrtitle_default_version descriptionterms_of_servicecontactlicenser5)r7rtZdefault_versionrvrwrxryrpr9r'r(r.s z Info.__init__)NNNNrqr'r'r9r(rssrsc s*eZdZdfdd ZeddZZS)SwaggerNc  stt|jfi| d|_||_|p*|j|j_|rdt|} | jrJ| j sRJd| j|_ | j g|_ | t ||_||_||_t||_t||_| |_t| |_|dS)aMRoot Swagger object. :param .Info info: info object :param str _url: URL used for setting the API host and scheme :param str _prefix: api path prefix to use in setting basePath; this will be appended to the wsgi SCRIPT_NAME prefix or Django's FORCE_SCRIPT_NAME if applicable :param str _version: version string to override Info :param dict[str,dict] security_definitions: list of supported authentication mechanisms :param list[dict[str,list[str]]] security: authentication mechanisms accepted globally :param list[str] consumes: consumed MIME types; can be overridden in Operation :param list[str] produces: produced MIME types; can be overridden in Operation :param Paths paths: paths object :param dict[str,Schema] definitions: named models z2.0z.if given, url must have both schema and netlocN)r2rzr.Zswaggerinforuversionurlparsenetlocschemehostschemes get_base_pathr base_pathconsumesproducesrsecurity_definitionssecuritypathsr r5) r7r{_url_prefix_versionrrrrrr rpror9r'r(r.s"     zSwagger.__init__cCsd|r|dr|dd}|ds,d|}||}|rN|drN|dd}|ds`d|}|S)aDetermine an appropriate value for ``basePath`` based on the SCRIPT_NAME and the api common prefix. :param str script_prefix: script prefix as defined by django ``get_script_prefix`` :param str api_prefix: api common prefix :return: joined base path /N)endswithr%)r/Z script_prefixZ api_prefixrr'r'r(rs     zSwagger.get_base_path) NNNNNNNNNN)rBrgrhr. classmethodrrkr'r'r9r(rzs $rzcseZdZfddZZS)Pathsc sRtt|jfi||D]&\}}|ds4J|dur|||<q|dS)zYA listing of all the paths in the API. :param dict[str,PathItem] paths: rN)r2rr.rHr%r5)r7rrprZpath_objr9r'r(r.)s  zPaths.__init__rqr'r'r9r(r(srcs2eZdZgdZdfdd ZeddZZS)PathItem)getputpostdeleteoptionsheadpatchNc  sVtt|jfi| ||_||_||_||_||_||_||_ t ||_ | dS)aInformation about a single path :param Operation get: operation for GET :param Operation put: operation for PUT :param Operation post: operation for POST :param Operation delete: operation for DELETE :param Operation options: operation for OPTIONS :param Operation head: operation for HEAD :param Operation patch: operation for PATCH :param list[Parameter] parameters: parameters that apply to all operations N) r2rr.rrrrrrrr parametersr5) r7rrrrrrrrrpr9r'r(r.9s  zPathItem.__init__cCsdd|DS)zA list of all standard Operations on this PathItem object. See :attr:`.OPERATION_NAMES`. :return: list of (method name, Operation) tuples :rtype: list[tuple[str,Operation]] cSs&g|]\}}|tjvr|r||fqSr')rOPERATION_NAMESr`r'r'r( XrTz'PathItem.operations..)rHr^r'r'r( operationsQszPathItem.operations)NNNNNNNN)rBrgrhrr.propertyrrkr'r'r9r(r6s rcseZdZdfdd ZZS) OperationNc  sltt|jfi| ||_||_||_t||_||_t||_ t||_ t||_ t| |_ | dS)aInformation about an API operation (path + http method combination) :param str operation_id: operation ID, should be unique across all operations :param Responses responses: responses returned :param list[Parameter] parameters: parameters accepted :param list[str] consumes: content types accepted :param list[str] produces: content types produced :param str summary: operation summary; should be < 120 characters :param str description: operation description; can be of any length and supports markdown :param list[str] tags: operation tags :param list[dict[str,list[str]]] security: list of security requirements N)r2rr. operation_idsummaryrvrr responsesrrtagsrr5) r7rrrrrrrvrrrpr9r'r(r.\s     zOperation.__init__)NNNNNNNrqr'r'r9r(r[srcCsf|r|tkrtd|tkr(|s(td|r<|tkr.+)/(?P[^/]+)$Fcsrtt|t|tkr"Jddj||d}|sh|||}t||shJ|djt|j|jd||_dS)aBase class for all reference types. A reference object has only one property, ``$ref``, which must be a JSON reference to a valid object in the specification, e.g. ``#/definitions/Article`` to refer to an article model. :param .ReferenceResolver resolver: component resolver which must contain the referenced object :param str name: referenced object name, e.g. "Article" :param str scope: reference scope, e.g. "definitions" :param type[.SwaggerDict] expected_type: the expected type that will be asserted on the object found in resolver :param bool ignore_unresolved: do not throw if the referenced object does not exist z do not instantiate _Ref directlyz#/{scope}/{name})scopernz is a {actual}, not a {expected})actualexpectedN) r2rr.r4rrrVrBr!)r7resolverrnr expected_typeignore_unresolvedref_namer]r9r'r(r.s   z _Ref.__init__cCs(|j|j}|j|d|ddS)zGet the object targeted by this reference from the given component resolver. :param .ReferenceResolver resolver: component resolver which must contain the referenced object :returns: the target object rnr)r) ref_name_rematchr! getdefaultgroup)r7rZ ref_matchr'r'r(resolvesz _Ref.resolvecs*|dkrtt|||Std|dS)Nr"z2only $ref can be set on Reference objects (not %s))r2r __setitem__NotImplementedErrorr=r9r'r(rsz_Ref.__setitem__cCs tddS)Nz*cannot delete property of Reference object)r)r7r>r'r'r( __delitem__ sz_Ref.__delitem__)F) rBrgrhrecompilerr.rrrrkr'r'r9r(rs   rcseZdZdfdd ZZS) SchemaRefFcs*t|jvsJtt|||tt|dS)a?Adds a reference to a named Schema defined in the ``#/definitions/`` object. :param .ReferenceResolver resolver: component resolver which must contain the definition :param str schema_name: schema name :param bool ignore_unresolved: do not throw if the referenced object does not exist N)SCHEMA_DEFINITIONSscopesr2rr.r)r7rZ schema_namerr9r'r(r.%szSchemaRef.__init__)Frqr'r'r9r(r$srcCst|tr||S|S)zResolve `ref_or_obj` if it is a reference type. Return it unchanged if not. :param ref_or_obj: object to dereference :type ref_or_obj: SwaggerDict or _Ref :param resolver: component resolver which must contain the referenced object )rVrr)Z ref_or_objrr'r'r( resolve_ref3s  rcseZdZdfdd ZZS) ResponsesNc sNtt|jfi||D]\}}|dur||t|<q||_|dS)a4Describes the expected responses of an :class:`.Operation`. :param responses: mapping of status code to response definition :type responses: dict[str or int,Response] :param Response default: description of the response structure to expect if another status code is returned N)r2rr.rHrZrr5)r7rrrpstatusresponser9r'r(r.@s zResponses.__init__)Nrqr'r'r9r(r?srcseZdZdfdd ZZS)ResponseNc sJtt|jfi|||_||_||_||rFt|trF| dS)awDescribes the structure of an operation's response. :param str description: response description :param schema: structure of the response body :type schema: Schema or SchemaRef or rest_framework.serializers.Serializer or type[rest_framework.serializers.Serializer] :param dict examples: example bodies mapped by mime type N) r2rr.rvrexamplesr5rVrr)r7rvrrrpr9r'r(r.Ps zResponse.__init__)NNrqr'r'r9r(rOsrc@seZdZdZddZddZddZdd d Zdd d Zdd dZ d ddZ d!ddZ ddZ e ddZddZddZddZdS)"ReferenceResolveraA mapping type intended for storing objects pointed at by Swagger Refs. Provides support and checks for different reference scopes, e.g. 'definitions'. For example: :: > components = ReferenceResolver('definitions', 'parameters') > definitions = components.with_scope('definitions') > definitions.set('Article', Schema(...)) > print(components) {'definitions': OrderedDict([('Article', Schema(...)]), 'parameters': OrderedDict()} cOsR|dd}|stdt|_d|_|D]"}t|ts@Jdt|j|<q*dS)zb :param str scopes: an enumeration of the valid scopes this resolver will contain force_initFaCreating an instance of ReferenceResolver almost certainly won't do what you want it to do. See https://github.com/axnsan12/drf-yasg/issues/211, https://github.com/axnsan12/drf-yasg/issues/271, https://github.com/axnsan12/drf-yasg/issues/325. Pass `force_init=True` to override this.Nzscope names must be strings)rrmr_objects _force_scoperVrZ)r7rkwargsrrr'r'r(r.qs zReferenceResolver.__init__cCs2||jvsJd|tdd}|j|_||_|S)aReturn a view into this :class:`.ReferenceResolver` whose scope is defaulted and forced to `scope`. :param str scope: target scope, must be in this resolver's `scopes` :return: the bound resolver :rtype: .ReferenceResolver zunknown scope %sT)r)rrrr)r7rretr'r'r( with_scopes  zReferenceResolver.with_scopecCsH|jp|}|dur*|jr*||jks*Jd|r8||jvsDJd||S)Nzcannot override forced scopezinvalid scope %srr)r7rZ real_scoper'r'r( _check_scopes  zReferenceResolver._check_scopeNcCsJ||}|dusJd||j|vs8Jd||f||j||<dS)zSet an object in the given scope, raise an error if it already exists. :param str name: reference name :param obj: referenced object :param str scope: reference scope Nz&referenced objects cannot be None/nullz#/%s/%s already existsrr)r7rnr]rr'r'r(sets zReferenceResolver.setcCs||}t|s$Jdt|j||d|}|dur|}||d|}|dus^Jd|durv||||n||krtd||}|S)zSet an object in the given scope only if it does not exist. :param str name: reference name :param function maker: object factory, called only if necessary :param str scope: reference scope z%setdefault expects a callable, not %sNz;maker returned None; referenced objects cannot be None/nullzOduring setdefault, maker for %s inserted a value and returned a different value)rcallabler4rBrrloggerdebug)r7rnmakerrrr?r'r'r( setdefaults  zReferenceResolver.setdefaultcCs6||}||j|vs(Jd||f|j||S)zGet an object from the given scope, raise an error if it does not exist. :param str name: reference name :param str scope: reference scope :return: the object z#/%s/%s is not definedrr7rnrr'r'r(rs zReferenceResolver.getcCs||}|j|||S)zGet an object from the given scope or a default value if it does not exist. :param str name: reference name :param default: the default value :param str scope: reference scope :return: the object or `default` )rrr)r7rnrrr'r'r(rs zReferenceResolver.getdefaultcCs||}||j|vS)zCheck if an object exists in the given scope. :param str name: reference name :param str scope: reference scope :return: True if the object exists :rtype: bool rrr'r'r(hass zReferenceResolver.hascCs |jrt|j|jSt|jSr*)rrerr^r'r'r(__iter__szReferenceResolver.__iter__cCs|jr|jgSt|jSr*)rlistrkeysr^r'r'r(rszReferenceResolver.scopescCs |jr|j|jS|jSr*)rrrr^r'r'r(rszReferenceResolver.keyscCs |jr|j|j|S|j|Sr*rrCr'r'r( __getitem__szReferenceResolver.__getitem__cCs tt|Sr*)rZdictr^r'r'r(__str__szReferenceResolver.__str__)N)N)N)NN)N)rBrgrhrir.rrrrrrrrrrrrrr'r'r'r(rbs    r)J collectionsloggingr urllib.parseparser}rZ django.urlsrZdjango.utils.functionalrZ inflectionrutilsrrr r rX ImportError getLoggerrBrrrZ TYPE_NUMBERZ TYPE_INTEGERZ TYPE_BOOLEANrZ TYPE_FILEZ FORMAT_DATEZFORMAT_DATETIMEZFORMAT_PASSWORDZ FORMAT_BINARYZ FORMAT_BASE64Z FORMAT_FLOATZ FORMAT_DOUBLEZ FORMAT_INT32Z FORMAT_INT64Z FORMAT_EMAILZ FORMAT_IPV4Z FORMAT_IPV6Z FORMAT_URIZ FORMAT_UUIDZ FORMAT_SLUGZFORMAT_DECIMALrrZIN_QUERYZIN_FORMZ IN_HEADERrr)r1r,rlrrrsrzrrrrrrrrrrrrrr rr'r'r'r(s~        W>% /6(