o ).hR@s~ddlZddlmZddlmZddlmZmZddlm Z ddl m Z ddl m Z mZmZmZddlmZmZdd lmZdd lmZmZmZmZmZmZdd lmZdd l m!Z!dd l"m#Z#ddZ$Gddde%Z&Gddde'Z(Gddde)Z*GdddZ+dZ,GdddeZ-Gddde-Z.Gddde-Z/Gdd d e-Z0Gd!d"d"e0Z1Gd#d$d$e-Z2Gd%d&d&eZ3dS)'N) OrderedDict)parse)ImproperlyConfiguredObjectDoesNotExist)Manager)QuerySet)NoReverseMatch Resolver404get_script_prefixresolve) smart_str uri_to_iri) gettext_lazy)Field SkipFieldempty get_attributeis_simple_callable iter_options)reverse) api_settings)htmlcCs&t||}t|d|}|t||juS)z4 Determine if a method has been overridden. __func__)getattrr) method_nameklassinstancemethoddefault_methodrW/var/www/supernova/superenvnew/lib/python3.10/site-packages/rest_framework/relations.pymethod_overriddens  r!c@eZdZdZdS)ObjectValueErrorz Raised when `queryset.get()` failed due to an underlying `ValueError`. Wrapping prevents calling code conflating this with unrelated errors. N__name__ __module__ __qualname____doc__rrrr r#r#c@r")ObjectTypeErrorz Raised when `queryset.get()` failed due to an underlying `TypeError`. Wrapping prevents calling code conflating this with unrelated errors. Nr$rrrr r*$r)r*cs8eZdZdZfddZddZeddZdZZ S) Hyperlinkz A string like object that additionally has an associated name. We use this for hyperlinked URLs that may render as a named link in some contexts, or render as a plain URL in others. cst||}||_|SN)super__new__obj)clsurlr/ret __class__rr r.1szHyperlink.__new__cCst||jfSr,)strnameselfrrr __getnewargs__6szHyperlink.__getnewargs__cCs t|jSr,)r5r/r7rrr r69s zHyperlink.nameT) r%r&r'r(r.r9propertyr6 is_hyperlink __classcell__rrr3r r++s   r+c@s eZdZdZddZddZdS) PKOnlyObjectz This is a mock object, used for when we only need the pk of the object instance, but still want to return an object with a .pk attribute, in order to keep the same interface as a regular model instance. cCs ||_dSr,pk)r8r?rrr __init__I zPKOnlyObject.__init__cCs d|jS)Nz%sr>r7rrr __str__LrAzPKOnlyObject.__str__N)r%r&r'r(r@rBrrrr r=Cs r=) read_only write_onlyrequireddefaultinitialsourcelabel help_textstyleerror_messages allow_empty html_cutoffhtml_cutoff_textcseZdZdZdZdZfddZfddZeddZ e ffdd Z d d Z d d Z fddZdddZeddZeddZddZddZZS) RelatedFieldNc s|d|j|_tj}|durt|}|d||_|d|jp$ttj|_t dt |s;|jdus;| ds;Jd|jdurI| drIJd|dd|d dt j d i|dS) NquerysetrNrO get_querysetrCzfRelational field must provide a `queryset` argument, override `get_queryset`, or set read_only=`True`.zZRelational fields should not provide a `queryset` argument, when setting read_only=`True`.manyrMr)poprQrHTML_SELECT_CUTOFFintrNrO_HTML_SELECT_CUTOFF_TEXTr!rPgetr-r@)r8kwargscutoff_from_settingsr3rr r@^s&   zRelatedField.__init__cs6|ddr|j|i|Stj|g|Ri|S)NrSF)rT many_initr-r.)r0argsrZr3rr r.ws zRelatedField.__new__cOs>d||i|i}|D] }|tvr||||<q tdi|S)aX This method handles creating a parent `ManyRelatedField` instance when the `many=True` keyword argument is passed. Typically you won't need to override this method. Note that we're over-cautious in passing most arguments to both parent and child classes in order to try to cover the general case. If you're overriding this method you'll probably want something much simpler, eg: @classmethod def many_init(cls, *args, **kwargs): kwargs['child'] = cls() return CustomManyRelatedField(*args, **kwargs) child_relationNr)MANY_RELATION_KWARGSManyRelatedField)r0r]rZ list_kwargskeyrrr r\~s  zRelatedField.many_initcs|dkrd}t|SN)r-run_validationr8datar3rr res zRelatedField.run_validationcCs |j}t|ttfr|}|Sr,)rQ isinstancerrall)r8rQrrr rRszRelatedField.get_querysetcCdSNFrr7rrr use_pk_only_optimizationz%RelatedField.use_pk_only_optimizationcsx|r6|jr6z%t||jdd}||jd}t|r!|}t|d|}t|dWSty5Ynwt|S)Nr?r>) rl source_attrsrserializable_valuerrr=AttributeErrorr-)r8rattribute_instancevaluer3rr rs    zRelatedField.get_attributecs>}|dur iS|dur|d|}tfdd|DS)Ncs g|] }||fqSr)to_representation display_value.0itemr7rr s z,RelatedField.get_choices..)rRr)r8cutoffrQrr7r get_choicess  zRelatedField.get_choicescC|Sr,r{r7rrr choiceszRelatedField.choicescC|jSr,r~r7rrr grouped_choiceszRelatedField.grouped_choicescCt|j|jd|j|jdSN)rz)rz cutoff_textrr{rNrOr7rrr r  zRelatedField.iter_optionscCt|Sr,r5)r8rrrr ruzRelatedField.display_valuer,)r%r&r'rQrNrOr@r. classmethodr\rrerRrlrr{r:r~rrrur<rrr3r rPYs&       rPcs(eZdZdZfddZddZZS)StringRelatedFieldzd A read only field that represents its targets using their plain string representation. c sd|d<tjdi|dS)NTrCrr-r@r8rZr3rr r@szStringRelatedField.__init__cCrr,rr8rsrrr rtrz$StringRelatedField.to_representation)r%r&r'r(r@rtr<rrr3r rs rcsLeZdZedededdZfddZddZd d Zd d ZZ S) PrimaryKeyRelatedFieldThis field is required.z0Invalid pk "{pk_value}" - object does not exist.z8Incorrect type. Expected pk value, received {data_type}.)rEdoes_not_existincorrect_typec s$|dd|_tjdi|dS)Npk_fieldr)rTrr-r@rr3rr r@szPrimaryKeyRelatedField.__init__cCrj)NTrr7rrr rlrmz/PrimaryKeyRelatedField.use_pk_only_optimizationc Cs|jdur |j|}|}zt|trt|j|dWSty.|jd|dYdStt fyC|jdt |j dYdSw)Nr>r)pk_valuer data_type) rto_internal_valuerRrhbool TypeErrorrYrfail ValueErrortyper%r8rgrQrrr rs    z(PrimaryKeyRelatedField.to_internal_valuecCs|jdur |j|jS|jSr,)rrtr?rrrr rts z(PrimaryKeyRelatedField.to_representation) r%r&r'rWdefault_error_messagesr@rlrrtr<rrr3r rs  rcsreZdZdZdZedededededdZdfd d Zd d Zd dZ ddZ ddZ ddZ Z S)HyperlinkedRelatedFieldr?Nrz!Invalid hyperlink - No URL match.z(Invalid hyperlink - Incorrect URL match.z*Invalid hyperlink - Object does not exist.z:Incorrect type. Expected URL string, received {data_type}.)rEno_matchincorrect_matchrrc sj|dur||_|jdusJd|d|j|_|d|j|_|dd|_t|_tjdi|dS)N%The `view_name` argument is required. lookup_fieldlookup_url_kwargformatr) view_namerTrrrrr-r@r8rrZr3rr r@ sz HyperlinkedRelatedField.__init__cCs |jdkS)Nr?)rr7rrr rl/rAz0HyperlinkedRelatedField.use_pk_only_optimizationcCs||j}|j|i}|}z |jdi|WSty1tttd}| tdt yJt ttd}| tdw)z Return the object corresponding to a matched URL. Takes the matched URL conf arguments, and should return an object instance, or raise an `ObjectDoesNotExist` exception. Nr) rrrRrYrr#r5sysexc_infowith_tracebackrr*)r8r view_args view_kwargs lookup_value lookup_kwargsrQexcrrr get_object2s    z"HyperlinkedRelatedField.get_objectcCs@t|dr |jdvr dSt||j}|j|i}|j||||dS)z Given an object, return the URL that hyperlinks to the object. May raise a `NoReverseMatch` if the `view_name` and `lookup_field` attributes are not configured to correctly match the URL conf. r?rcN)rZrequestr)hasattrr?rrrr)r8r/rrrrrZrrr get_urlFs   zHyperlinkedRelatedField.get_urlc Cs,|jd}z|d}Wnty |jdt|jdYnw|r;t|j }t }||r;d|t |d}t t |}zt|}WntyV|dYnwz |j|j|}Wn tym|j}Ynw|j|krx|dz ||j|j|jWStttfy|dYdSw) Nr)zhttp:zhttps:rr/rrr)contextrY startswithrqrrr%rurlparsepathr lenr unquoter r versioning_schemeget_versioned_viewnamerrr]rZrr#r*)r8rgr http_prefixprefixmatchexpected_viewnamerrr rUs>          z)HyperlinkedRelatedField.to_internal_valuecCsd|jvs Jd|jj|jd}|jd}|r%|jr%|j|kr%|j}z |||j||}Wn!tyQd}|dvrJddd|}|d|7}t||jw|durXdSt ||S) Nrzz`%s` requires the request in the serializer context. Add `context={'request': request}` when instantiating the serializer.rzCould not resolve URL for hyperlinked relationship using view name "%s". You may have failed to include the related model in your API, or incorrectly configured the `lookup_field` attribute on this field.)rdNzthe empty stringNonez} WARNING: The value of the field on the model instance was %s, which may be why it didn't match any entries in your URL conf.) rr4r%rYrrrrrr+)r8rsrrr1msg value_stringrrr rtys4      z)HyperlinkedRelatedField.to_representationr,)r%r&r'rrrWrr@rlrrrrtr<rrr3r rs$rcs*eZdZdZdfdd ZddZZS)HyperlinkedIdentityFieldz A read-only field that represents the identity URL for an object, itself. This is in contrast to `HyperlinkedRelatedField` which represents the URL of relationships to other objects. Nc s8|dusJdd|d<d|d<tj|fi|dS)NrTrC*rHrrr3rr r@sz!HyperlinkedIdentityField.__init__cCrjrkrr7rrr rlsz1HyperlinkedIdentityField.use_pk_only_optimizationr,)r%r&r'r(r@rlr<rrr3r rsrcsDeZdZdZededdZd fdd Zdd Zd d ZZ S) SlugRelatedFieldzm A read-write field that represents the target of the relationship by a unique 'slug' attribute. z/Object with {slug_name}={value} does not exist.zInvalid value.)rinvalidNc s,|dusJd||_tjdi|dS)Nz&The `slug_field` argument is required.r) slug_fieldr-r@)r8rrZr3rr r@szSlugRelatedField.__init__c Csl|}z |jdi|j|iWSty%|jd|jt|dYdSttfy5|dYdSw)Nr) slug_namersrr)rRrYrrrr rrrrrr rs z"SlugRelatedField.to_internal_valuecCs t||jSr,)rr)r8r/rrr rt z"SlugRelatedField.to_representationr,) r%r&r'r(rWrr@rrtr<rrr3r rs rcseZdZdZgZgZededdZdZdZ dfdd Z dd Z d d Z d d Z ddZdddZeddZeddZddZZS)r`a Relationships with `many=True` transparently get coerced into instead being a ManyRelatedField with a child relationship. The `ManyRelatedField` class is responsible for handling iterating through the values and passing each one to the child relationship. This class is treated as private API. You shouldn't generally need to be using this class directly yourself, and should instead simply set 'many=True' on the relationship. z5Expected a list of items but got type "{input_type}".zThis list may not be empty.) not_a_listrNcs||_|dd|_tj}|durt|}|d||_|d|jp&ttj |_|dus1Jdt j |i||jj d|ddS)NrMTrNrOz(`child_relation` is a required argument.rd) field_nameparent) r^rTrMrrUrVrNrOrWrXr-r@bind)r8r^r]rZr[r3rr r@szManyRelatedField.__init__cCs@t|r|j|vrt|jddrtS||jS||jtS)NpartialF)r is_html_inputrrrootrgetlistrY)r8 dictionaryrrr get_values   zManyRelatedField.get_valuecsVt|ts t|dsjdt|jdjs"t|dkr"dfdd|DS)N__iter__r) input_typerrcg|]}j|qSr)r^rrvr7rr ry z6ManyRelatedField.to_internal_value..)rhr5rrrr%rMrrfrr7r r s  z"ManyRelatedField.to_internal_valuec Cst|dr |jdur gSzt||j}WnFttfyZ}z8|jtur-|WYd}~S|j r7WYd}~dS|j s=t dj t |j|j|jjj|jj|d}t ||d}~wwt|drd|S|S)Nr?zGot {exc_type} when attempting to get a value for field `{field}` on serializer `{serializer}`. The serializer field might be named incorrectly and not match any attribute or key on the `{instance}` instance. Original exception text was: {exc}.)exc_typefield serializerrrri)rr?rroKeyErrorrqrFr get_default allow_nullrErrrr%rrr4ri)r8r relationshiprrrrr rs0  zManyRelatedField.get_attributecsfdd|DS)Ncrr)r^rt)rwrsr7rr ry5rz6ManyRelatedField.to_representation..r)r8iterablerr7r rt4s z"ManyRelatedField.to_representationcCs |j|Sr,)r^r{)r8rzrrr r{:rzManyRelatedField.get_choicescCr|r,r}r7rrr r~=rzManyRelatedField.choicescCrr,rr7rrr rArz ManyRelatedField.grouped_choicescCrrrr7rrr rErzManyRelatedField.iter_optionsr,)r%r&r'r(rGdefault_empty_htmlrWrrNrOr@rrrrtr{r:r~rrr<rrr3r r`s(      r`)4r collectionsrurllibrdjango.core.exceptionsrrdjango.db.modelsrdjango.db.models.queryr django.urlsrr r r django.utils.encodingr r django.utils.translationrrWrest_framework.fieldsrrrrrrrest_framework.reverserrest_framework.settingsrrest_framework.utilsrr!rr#rr*r5r+r=r_rPrrrrrr`rrrr s8           !