o FDi@sdZddlmZddlZddlZddlZddlZddlmZddlm Z gdZ d)d d Z d*ddZ ddd+ddZ d,ddZd-ddZd.dd Zd/d0d'd(ZdS)1z)Utilities to get schema instances/classes) annotationsN)fields) Components)onlyexclude load_only dump_onlypartialschema3type[marshmallow.Schema] | marshmallow.Schema | strreturnmarshmallow.SchemacCs:t|trt|tjr|St|tjr|Stj|S)zReturn schema instance for given schema (instance or class). :param type|Schema|str schema: instance, class or class name of marshmallow.Schema :return: schema instance of given schema (instance or class) ) isinstancetype issubclass marshmallowSchemaclass_registry get_classr rW/var/www/Datamplify/venv/lib/python3.10/site-packages/apispec/ext/marshmallow/common.pyresolve_schema_instances  r3type[marshmallow.Schema] | str | marshmallow.Schema9type[marshmallow.Schema] | list[type[marshmallow.Schema]]cCs>t|tr t|tjr |St|tjrt|Stjt|S)zReturn schema class for given schema (instance or class). :param type|Schema|str: instance, class or class name of marshmallow.Schema :return: schema class of given schema (instance or class) )rrrrrrrstrrrrrresolve_schema_cls s  rFexclude_dump_only-type[marshmallow.Schema] | marshmallow.Schemarbooldict[str, fields.Field]cCsjt|tjr |j}nt|trt|tjrt|j}nt |dt |dd}t ||t |||dS)zReturn fields from schema. :param Schema schema: A marshmallow Schema instance or a class object :param bool exclude_dump_only: whether to filter fields in Meta.dump_only :rtype: dict, of field name field object pairs z1 is neither a Schema class nor a Schema instance.MetaNr) rrrrrrcopydeepcopy_declared_fields ValueErrorgetattrwarn_if_fields_defined_in_metafilter_excluded_fields)r rrr"rrr get_fields/s   r*rcCslt|dds t|ddr2t|}tt|dt|ks(tt|dt|kr4tjdtdddSdSdS)zWarns user that fields defined in Meta.fields or Meta.additional will be ignored. :param dict fields: A dictionary of fields name field object pairs :param Meta: the schema's Meta class rN additionalzOnly explicitly-declared fields will be included in the Schema Object. Fields defined in Meta.fields or Meta.additional are ignored. stacklevel)r'setkeyswarningswarn UserWarning)rr"declared_fieldsrrrr(Es  r(csBtt|dgrt|dgfdd|D}|S)zFilter fields that should be ignored in the OpenAPI spec. :param dict fields: A dictionary of fields name field object pairs :param Meta: the schema's Meta class :param bool exclude_dump_only: whether to filter dump_only fields rrcs(i|]\}}|vrr|js||qSr)r).0keyvaluerrrr fs z*filter_excluded_fields..)r/r'updateitems)rr"rfiltered_fieldsrr8rr)Ys  r)$tuple[type[marshmallow.Schema], ...]c Csnt|tjs tdg}tD] }t||}zt|Wn ty(t|}Ynw||qt |j g|S)Nz6can only make a schema key based on a Schema instance.) rrr TypeError MODIFIERSr'hash frozensetappendtuple __class__)r modifiersmodifier attributerrrmake_schema_keyos      rH componentsrnamercounterintcCs^||jvr|S|stjd|dtddn |dtt| }|d7}t||t||S)aFunction to generate a unique name based on the provided name and names already in the spec. Will append a number to the name to make it unique if the name is already in the spec. :param Components components: instance of the components of the spec :param string name: the name to use as a basis for the unique name :param int counter: the counter of the number of recursions :return: the unique name z&Multiple schemas resolved to the name z. The name has been modified. Either manually add each of the schemas with a different name or provide a custom schema_name_resolver.r,r-N)schemasr1r2r3lenrget_unique_schema_name)rIrJrKrrrrPs  rP)r r r r )r rr r)r rrr r r!)rr!)rr!rr r r!)r r r r=)r)rIrrJrrKrLr r)__doc__ __future__rr#r1rmarshmallow.class_registryr apispec.corerr?rrr*r(r)rHrPrrrrs"