a cf@srdZddlmZddlmZddlmZddlmZm Z ddl m Z ddl m Z Gdd d ZGd d d eZd S) aL The metadata API is used to allow customization of how `OPTIONS` requests are handled. We currently provide a single default implementation that returns some fairly ad-hoc information about the view. Future implementations might use JSON schema or other definitions in order to return this information in a more standardized way. )PermissionDenied)Http404 force_str) exceptions serializers) clone_request)ClassLookupDictc@seZdZddZdS) BaseMetadatacCs tddS)zx Return a dictionary of metadata about the view. Used to return responses for OPTIONS requests. z).determine_metadata() must be overridden.N)NotImplementedError)selfrequestviewrT/home/httpd/docs/test/DocsMgr/lib/python3.9/site-packages/rest_framework/metadata.pydetermine_metadataszBaseMetadata.determine_metadataN)__name__ __module__ __qualname__rrrrrr sr c-@seZdZdZeejdejdejdej dej dej dej dej dejd ejd ejd ejd ejd ejdejdejdejdejdejdejdejdejdiZddZddZddZddZ dS)SimpleMetadataz This is the default metadata implementation. It returns an ad-hoc set of information about the view. There are not any formalized standards for `OPTIONS` responses for us to base this on. fieldbooleanstringurlemailregexZslugintegerfloatdecimaldatedatetimetimedurationchoicezmultiple choicez file uploadz image uploadlistz nested objectcCsT||dd|jDdd|jDd}t|drP|||}|rP||d<|S)NcSsg|] }|jqSr media_type).0rendererrrr ?z5SimpleMetadata.determine_metadata..cSsg|] }|jqSrr%)r'parserrrrr)@r*)name descriptionZrendersZparsesget_serializeractions)Z get_view_nameZget_view_descriptionZrenderer_classesZparser_classeshasattrdetermine_actions)r r rmetadatar/rrrr;s  z!SimpleMetadata.determine_metadatac Csi}ddht|j@D]}t|||_zpz4t|dr@||j|dkrZt|drZ|Wntjt t fyvYn0| }| |||<W||_q||_0q|S)z For generic class based views we return information about the fields that are accepted for 'PUT' and 'POST' methods. PUTPOSTcheck_permissions get_object) setallowed_methodsrr r0r5r6rZ APIExceptionrrr.get_serializer_info)r r rr/method serializerrrrr1Hs    z SimpleMetadata.determine_actionscs(t|dr|j}fdd|jDS)zn Given an instance of a serializer, return a dictionary of metadata about its fields. childcs(i|] \}}t|tjs||qSr) isinstancerZ HiddenFieldget_field_info)r' field_namerr rr ls z6SimpleMetadata.get_serializer_info..)r0r<fieldsitems)r r;rr@rr9cs   z"SimpleMetadata.get_serializer_infocCs|j|t|ddd}gd}|D]0}t||d}|dur$|dkr$t|dd||<q$t|d drt||j|d <nt|d dr|||d <|d st|tj tj fst |d rdd|j D|d <|S)zl Given an instance of a serializer field, return a dictionary of metadata about it. requiredF)typerD) read_onlylabel help_textZ min_length max_lengthZ min_valueZ max_valueZ max_digitsZdecimal_placesNTZ strings_onlyr<rBchildrenrFchoicescSs"g|]\}}|t|dddqS)TrK)valueZ display_namer)r'Z choice_valueZ choice_namerrrr)s z1SimpleMetadata.get_field_info..) label_lookupgetattrrr>r<r9getr=rZ RelatedFieldZManyRelatedFieldr0rMrC)r rZ field_infoattrsattrrNrrrr>rs*      zSimpleMetadata.get_field_infoN)!rrr__doc__r rFieldZ BooleanFieldZ CharFieldZ UUIDFieldZURLFieldZ EmailFieldZ RegexFieldZ SlugFieldZ IntegerFieldZ FloatFieldZ DecimalFieldZ DateFieldZ DateTimeFieldZ TimeFieldZ DurationFieldZ ChoiceFieldZMultipleChoiceFieldZ FileFieldZ ImageFieldZ ListFieldZ DictField SerializerrOrr1r9r>rrrrrs: rN)rTZdjango.core.exceptionsrZ django.httprZdjango.utils.encodingrZrest_frameworkrrZrest_framework.requestrZ"rest_framework.utils.field_mappingr r rrrrrs