o QDi&@s4dZddlmZddlZddlZddlmZddlmZddl Z ddl m Z ddl m Z ddl m Z dd l mZdd l mZdd l mZdd lmZeeZgd Zd@ddZdAddZedBddZdCddZ   dDdEd(d)ZdFd,d-ZdGd/d0ZdHd2d3ZdId5d6ZdJd7d8Z dKd9d:Z!edLd>d?Z"dS)Ma\ Validate Swagger Specs against the Swagger 1.2 Specification. The validator aims to check for full compliance with the Specification. The validator uses the published jsonschema files for basic structural validation, augmented with custom validation code where necessary. https://github.com/swagger-api/swagger-spec/blob/master/versions/1.2.md ) annotationsN)Any)urlparse) RefResolver)get_uri_from_file_path)read_resource_file)read_url)SwaggerValidationError)wrap_exception)default_handlers)integernumberstringbooleanapi_declarationdict[str, Any]return list[str]cCs|di}dd|DS)NmodelscSsg|]}|dqS)id).0modelrr[/var/www/Datamplify/venv/lib/python3.10/site-packages/swagger_spec_validator/validator12.py #sz!get_model_ids..)getvalues)rrrrr get_model_ids!s rurlstrresourcecCsFt|jdkrtj|}ddd}tj|||}|S||}|S) a9Fetch the complete resource path to get the api declaration. :param url: A file or http uri hosting the resource listing. :type url: string :param resource: Resource path starting with a '/'. eg. '/pet' :type resource: string :returns: Complete resource path hosting the api declaration. filer rrcSs|dsJ|dddS)N/z.json) startswith)r rrrresource_file_name2sz-get_resource_path..resource_file_nameN)r rrr)rschemeospathdirnamejoin)rr parent_dirr%r(rrrget_resource_path&s  r,NonecCstd|tt||dS)a6Simple utility function to perform recursive validation of a Resource Listing and all associated API Declarations. This is trivial wrapper function around :py:func:`swagger_spec_validator.validate_resource_listing` and :py:func:`swagger_spec_validator.validate_api_declaration`. You are encouraged to write your own version of this if required. :param url: the URL of the Resource Listing. :returns: `None` in case of success, otherwise raises an exception. :raises: :py:class:`swagger_spec_validator.SwaggerValidationError` Validating %sN)loginfo validate_specr)rrrrvalidate_spec_url=s r2resource_listingcCs@t||dD]}t||d}td|tt|qdS)a Validates the resource listing, fetches the api declarations and consequently validates them as well. :type resource_listing: dict :param url: url serving the resource listing; needed to resolve api declaration path. :type url: string :returns: `None` in case of success, otherwise raises an exception. :raises: :py:class:`swagger_spec_validator.SwaggerValidationError` apisr(r.N)validate_resource_listingr,r/r0validate_api_declarationr)r3rapir(rrrr1Rs   r1TFobj model_ids allow_arraysbool allow_voids allow_refs allow_filec Cs|d}|d}|dur\|tvrdS|r|dkrdS|dkr<|s&td|d}|dur3tdt||d d dS|d krH|sFtd dS||vrV|rTtd |dStd||durr|sftd||vrptd|dStd)u Validate an object that contains a data type (§4.3.3). Params: - obj: the dictionary containing the data type to validate - model_ids: a list of model ids - allow_arrays: whether an array is permitted in the data type. This is used to prevent nested arrays. - allow_voids: whether a void type is permitted. This is used when validating Operation Objects (§5.2.3). - allow_refs: whether '$ref's are permitted. If true, then 'type's are not allowed to reference model IDs. typez$refNvoidarrayz"array" not alloweditemsz"items" not foundF)r:Filez-Type "File" is only valid for form parametersz$must use "$ref" for referencing "%s"zunknown type "%s"z"$ref" not allowedzunknown model id "%s"zno "$ref" or "type" present)rPRIMITIVE_TYPESr validate_data_type) r8r9r:r<r=r>typrefrBrrrrEhsF      rEr model_namec Cs|dgD]}||dvrtd||q||dkr)d||d}t||diD](\}}z t||ddWq1tyY}ztd|d |d t|d }~wwd S) u"Validate a Model Object (§5.2.7).required propertiesz,Model "{}": required property "{}" not foundrz*model name: {} does not match model id: {}T)r=zModel "z ", property "z": N)rr formatrBrEr)rrHr9rIerror prop_nameproperrrvalidate_models.  rP parametercCs"|ddk}t||d|ddS)u&Validate a Parameter Object (§5.2.4). paramTypeformF)r=r>N)rrE)rQr9r>rrrvalidate_parametersrT operationc Csz t||dddWnty"}z td|dt|d}~ww|dD]$}zt||Wq'tyK}ztd|d|d t|fd}~wwdS) u'Validate an Operation Object (§5.2.3).FT)r=r<zOperation "{}": {}nicknameN parametersz"Operation "%s", parameter "%s": %sname)rEr rKrrT)rUr9rOrQrrrvalidate_operations( rYr7cCs|dD]}t||qdS)u!Validate an API Object (§5.2.2). operationsN)rY)r7r9rUrrr validate_apis  r[cCsTt|dt|}|dD]}t||q |diD] \}}t|||qdS)uJValidate an API Declaration (§5.2). :param api_declaration: a dictionary respresentation of an API Declaration. :returns: `None` in case of success, otherwise raises an exception. :raises: :py:class:`swagger_spec_validator.SwaggerValidationError` :raises: :py:class:`jsonschema.exceptions.ValidationError` z schemas/v1.2/apiDeclaration.jsonr4rN) validate_jsonrr[rrBrP)rr9r7rHrrrrr6s   r6cCst|ddS)uValidate a Resource Listing (§5.1). :param resource_listing: a dictionary respresentation of a Resource Listing. Note that you will have to invoke `validate_api_declaration` on each linked API Declaration. :returns: `None` in case of success, otherwise raises an exception. :raises: :py:class:`swagger_spec_validator.SwaggerValidationError` :raises: :py:class:`jsonschema.exceptions.ValidationError` z!schemas/v1.2/resourceListing.jsonN)r\)r3rrrr5s r5 json_documentlist[Any] | dict[str, Any] schema_pathcCs2t|\}}tt||td}tj|||ddS)zValidate a json document against a json schema. :param json_document: json document in the form of a list or dict. :param schema_path: package relative path of the json schema file. )base_urireferrerhandlers)resolverN)rrrr jsonschemavalidate)r]r_schemarcrrrr\ s r\)rrrr)rrr rrr)rrrr-)r3rrrrr-)TFTF)r8rr9rr:r;r<r;r=r;r>r;rr-)rrrHrr9rrr-)rQrr9rrr-)rUrr9rrr-)r7rr9rrr-)rrrr-)r3rrr-)r]r^r_rrr-)#__doc__ __future__rloggingr'typingr urllib.parserrdrswagger_spec_validator.commonrrrr r %swagger_spec_validator.ref_validatorsr getLogger__name__r/rDrr,r2r1rErPrTrYr[r6r5r\rrrrsD                @