o FD©iÍ*ã@sddlmZGdd„dƒZdS)é)Úresolve_schema_instancec@sHeZdZdZdd„Zdd„Zdd„Zdd „Zd d „Zd d „Z dd„Z dS)ÚSchemaResolvera¿Resolve marshmallow Schemas in OpenAPI components and translate to OpenAPI `schema objects `_, `parameter objects `_ or `reference objects `_. cCs||_||_dS)N)Úopenapi_versionÚ converter)Úselfrr©rú`/var/www/Datamplify/venv/lib/python3.10/site-packages/apispec/ext/marshmallow/schema_resolver.pyÚ__init__s zSchemaResolver.__init__cKsŒ| ¡D]?}t|tƒs qd|vr| |d¡|d<|jjdkr3| | di¡¡d|vr3| |d¡| di¡ ¡D]}|  |¡q;qdS)zÂResolve marshmallow Schemas in a dict mapping operation to OpenApi `Operation Object https://github.com/OAI/OpenAPI-Specification/blob/master/versions/3.0.2.md#operationObject`_ Ú parameterséÚ callbacksÚ requestBodyÚ responsesN) ÚvaluesÚ isinstanceÚdictÚresolve_parametersrÚmajorÚresolve_callbackÚgetÚresolve_schemaÚresolve_response)rÚ operationsÚkwargsÚ operationÚresponserrrÚresolve_operationss  ÿ  ÿõz!SchemaResolver.resolve_operationscCs4| ¡D]}t|tƒr| ¡D]}| |¡qqdS)a Resolve marshmallow Schemas in a dict mapping callback name to OpenApi `Callback Object https://github.com/OAI/OpenAPI-Specification/blob/master/versions/3.0.2.md#callbackObject`_. This is done recursively, so it is possible to define callbacks in your callbacks. Example: :: # Input { "userEvent": { "https://my.example/user-callback": { "post": { "requestBody": { "content": {"application/json": {"schema": UserSchema}} } }, } } } # Output { "userEvent": { "https://my.example/user-callback": { "post": { "requestBody": { "content": { "application/json": { "schema": {"$ref": "#/components/schemas/User"} } } } }, } } } N)rrrr)rr ÚcallbackÚpathrrrr%s (   €ýzSchemaResolver.resolve_callbackcCs|g}|D]7}t|tƒr1t| di¡tƒs1d|vr1t| d¡ƒ}||jj|fd| d¡i|¤Ž7}q| |¡| |¡q|S)a÷Resolve marshmallow Schemas in a list of OpenAPI `Parameter Objects `_. Each parameter object that contains a Schema will be translated into one or more Parameter Objects. If the value of a `schema` key is marshmallow Schema class, instance or a string that resolves to a Schema Class each field in the Schema will be expanded as a separate Parameter Object. Example: :: # Input class UserSchema(Schema): name = fields.String() id = fields.Int() [{"in": "query", "schema": "UserSchema"}] # Output [ { "in": "query", "name": "id", "required": False, "schema": {"type": "integer"}, }, { "in": "query", "name": "name", "required": False, "schema": {"type": "string"}, }, ] If the Parameter Object contains a `content` key a single Parameter Object is returned with the Schema translated into a Schema Object or Reference Object. Example: :: # Input [ { "in": "query", "name": "pet", "content": {"application/json": {"schema": "PetSchema"}}, } ] # Output [ { "in": "query", "name": "pet", "content": { "application/json": { "schema": {"$ref": "#/components/schemas/Pet"} } }, } ] :param list parameters: the list of OpenAPI parameter objects to resolve. ÚschemaÚinÚlocation) rrrrÚpoprÚschema2parametersrÚappend)rr ÚresolvedÚ parameterÚschema_instancerrrrRs$Cÿþÿÿ ÿ  z!SchemaResolver.resolve_parameterscCs6| |¡d|vr|d ¡D] }| |¡qdSdS)a¾Resolve marshmallow Schemas in OpenAPI `Response Objects `_. Schemas may appear in either a Media Type Object or a Header Object. Example: :: # Input { "content": {"application/json": {"schema": "PetSchema"}}, "description": "successful operation", "headers": {"PetHeader": {"schema": "PetHeaderSchema"}}, } # Output { "content": { "application/json": {"schema": {"$ref": "#/components/schemas/Pet"}} }, "description": "successful operation", "headers": { "PetHeader": {"schema": {"$ref": "#/components/schemas/PetHeader"}} }, } :param dict response: the response object to resolve. ÚheadersN)rr)rrÚheaderrrrr¥s  þzSchemaResolver.resolve_responsecCstt|tƒsdSd|vr| |d¡|d<|jjdkr4d|vr6|d ¡D]}d|vr3| |d¡|d<q$dSdSdS)aYResolve marshmallow Schemas in an OpenAPI component or header - modifies the input dictionary to translate marshmallow Schemas to OpenAPI Schema Objects or Reference Objects. OpenAPIv3 Components: :: # Input { "description": "user to add to the system", "content": {"application/json": {"schema": "UserSchema"}}, } # Output { "description": "user to add to the system", "content": { "application/json": { "schema": {"$ref": "#/components/schemas/User"} } }, } :param dict|str data: either a parameter or response dictionary that may contain a schema, or a reference provided as string Nrr Úcontent)rrÚresolve_schema_dictrrr)rÚdatar*rrrrÅs  €üzSchemaResolver.resolve_schemacs¼t|tƒrX| d¡dkrd|vrˆ |d¡|d<| d¡dkr3d|vr3‡fdd„|d ¡Dƒ|d<dD]}||vrH‡fd d „||Dƒ||<q5d |vrVˆ |d ¡|d <|Sˆj |¡S) aLResolve a marshmallow Schema class, object, or a string that resolves to a Schema class or a schema reference or an OpenAPI Schema Object containing one of the above to an OpenAPI Schema Object or Reference Object. If the input is a marshmallow Schema class, object or a string that resolves to a Schema class the Schema will be translated to an OpenAPI Schema Object or Reference Object. Example: :: # Input "PetSchema" # Output {"$ref": "#/components/schemas/Pet"} If the input is a dictionary representation of an OpenAPI Schema Object recursively search for a marshmallow Schemas to resolve. For `"type": "array"`, marshmallow Schemas may appear as the value of the `items` key. For `"type": "object"` Marshmalow Schemas may appear as values in the `properties` dictionary. Examples: :: # Input {"type": "array", "items": "PetSchema"} # Output {"type": "array", "items": {"$ref": "#/components/schemas/Pet"}} # Input { "type": "object", "properties": {"pet": "PetSchcema", "user": "UserSchema"}, } # Output { "type": "object", "properties": { "pet": {"$ref": "#/components/schemas/Pet"}, "user": {"$ref": "#/components/schemas/User"}, }, } :param string|Schema|dict schema: the schema to resolve. ÚtypeÚarrayÚitemsÚobjectÚ propertiescsi|] \}}|ˆ |¡“qSr©r+)Ú.0ÚkÚv©rrrÚ s ÿÿz6SchemaResolver.resolve_schema_dict..)ÚoneOfÚanyOfÚallOfcsg|]}ˆ |¡‘qSrr2)r3Úsr6rrÚ &s ÿz6SchemaResolver.resolve_schema_dict..Únot)rrrr+r/rÚresolve_nested_schema)rrÚkeywordrr6rr+ìs" 0   þ  ÿ€ z"SchemaResolver.resolve_schema_dictN) Ú__name__Ú __module__Ú __qualname__Ú__doc__r rrrrrr+rrrrrs -S 'rN)ÚcommonrrrrrrÚs