Why Gemfury?
Push, build, and install
RubyGems
npm packages
Python packages
Maven artifacts
PHP packages
Go Modules
Debian packages
RPM packages
NuGet packages
doctorondemand / djangorestframework python
Repository URL to install this package:
|
Version:
3.6.4 ▾
|
«¬YL ã
@ s d d l m Z d d l m Z d d l m Z m Z d d l m Z d d l m
Z
d d l m Z d d l
m Z m Z m Z d d l m Z d d l m Z d d
l m Z m Z m Z m Z d d l m Z m Z m Z m Z m! Z! d d l" m# Z# d d
l$ m% Z% d d l& m' Z' d d Z( Gd d d e j) Z* e Gd d d e+ Z, d1 Z- Gd" d# d# e Z. Gd$ d% d% e. Z/ Gd& d' d' e. Z0 Gd( d) d) e. Z1 Gd* d+ d+ e1 Z2 Gd, d- d- e. Z3 Gd. d/ d/ e Z4 d0 S)2é )Úunicode_literals)Ú OrderedDict)ÚImproperlyConfiguredÚObjectDoesNotExist)ÚManager)ÚQuerySet)Úsix)Úpython_2_unicode_compatibleÚ
smart_textÚ
uri_to_iri)Úparse)Ú
ugettext_lazy)ÚNoReverseMatchÚ Resolver404Úget_script_prefixÚresolve)ÚFieldÚemptyÚ
get_attributeÚis_simple_callableÚ iter_options)Úreverse)Ú api_settings)Úhtmlc C s7 t | | } t | d | } | t | | j k S)z4
Determine if a method has been overridden.
Ú__func__)Úgetattrr )Ú method_nameÚklassÚinstanceÚmethodÚdefault_method© r! úW/Users/carlton/Documents/Django-Stack/django-rest-framework/rest_framework/relations.pyÚmethod_overridden s r# c @ sF e Z d Z d Z d d Z d d Z e d d Z d Z d 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.
c C s" t j j | | } | | _ | S)N)r Ú text_typeÚ__new__Úobj)ÚselfÚurlr' Úretr! r! r" r& * s zHyperlink.__new__c C s t | | j f S)N)ÚstrÚname)r( r! r! r" Ú__getnewargs__/ s zHyperlink.__getnewargs__c C s t j | j S)N)r r% r' )r( r! r! r" r, 2 s zHyperlink.nameTN) Ú__name__Ú
__module__Ú __qualname__Ú__doc__r& r- Úpropertyr, Z is_hyperlinkr! r! r! r" r$ $ s
r$ c @ s. e Z d Z d Z d d Z d d Z d S)Ú 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.
c C s
| | _ d S)N)Úpk)r( r4 r! r! r" Ú__init__C s zPKOnlyObject.__init__c C s d | j S)Nz%s)r4 )r( r! r! r" Ú__str__F s zPKOnlyObject.__str__N)r. r/ r0 r1 r5 r6 r! r! r! r" r3 < s r3 Ú read_onlyÚ
write_onlyÚrequiredÚdefaultÚinitialÚsourceÚlabelÚ help_textÚstyleÚerror_messagesÚ allow_emptyÚ html_cutoffÚhtml_cutoff_textc sÜ e Z d Z d Z d Z d Z f d d Z f d d Z e d d Z e
f d d Z d
d Z d d
Z
d d Z d d d Z e d d Z e d d Z d d Z d d Z S)Ú RelatedFieldNc s | j d | j | _ t j } | d k r9 t | } | j d | | _ | j d | j pl t t j | _ t d t
| s´ | j d k s´ | j d d s´ t d | j d k oÒ | j d d sâ t d | j d d | j d d t
t
| j | d S)
NÚquerysetrB rC Ú get_querysetr7 zfRelational 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`.ÚmanyrA )ÚpoprE r ÚHTML_SELECT_CUTOFFÚintrB rC Ú_ÚHTML_SELECT_CUTOFF_TEXTr# rD ÚgetÚAssertionErrorÚsuperr5 )r( ÚkwargsÚcutoff_from_settings)Ú __class__r! r" r5 X s $ % zRelatedField.__init__c s> | j d d r" | j | | St t | j | | | S)NrG F)rH Ú many_initrO rD r& )ÚclsÚargsrP )rR r! r" r& q s zRelatedField.__new__c O sP d | | | i } x. | j D] } | t k r" | | | | <q" Wt | 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_relation)ÚkeysÚMANY_RELATION_KWARGSÚManyRelatedField)rT rU rP Ú list_kwargsÚkeyr! r! r" rS x s
zRelatedField.many_initc s( | d k r d } t t | j | S)NÚ )rO rD Úrun_validation)r( Údata)rR r! r" r] s zRelatedField.run_validationc C s. | j } t | t t f r* | j } | S)N)rE Ú
isinstancer r Úall)r( rE r! r! r" rF s zRelatedField.get_querysetc C s d S)NFr! )r( r! r! r" Úuse_pk_only_optimization¡ s z%RelatedField.use_pk_only_optimizationc C s | j r
| j r
y[ t | | j d d
} | j | j d } t | rb | j } t d | SWn t k
r Yn Xt | | j S)Né r4 éÿÿÿÿrc )ra Ú source_attrsr Úserializable_valuer r4 r3 ÚAttributeError)r( r Úvaluer! r! r" r ¤ s
zRelatedField.get_attributec sU j } | d k r i S| d k r8 | d |
} t f d d | D S)Nc s. g | ]$ } j | j | f q Sr! )Úto_representationÚ
display_value)Ú.0Úitem)r( r! r" ú
<listcomp>À s z,RelatedField.get_choices.<locals>.<listcomp>)rF r )r( ÚcutoffrE r! )r( r" Ú get_choicesµ s zRelatedField.get_choicesc C s
| j S)N)rn )r( r! r! r" ÚchoicesÇ s zRelatedField.choicesc C s | j S)N)ro )r( r! r! r" Úgrouped_choicesË s z RelatedField.grouped_choicesc C s+ t | j d | j d | j d | j S)Nrm Ú cutoff_text)r rn rB rC )r( r! r! r" r Ï s zRelatedField.iter_optionsc C s
t j | S)N)r r% )r( r r! r! r" ri Ö s zRelatedField.display_value)r. r/ r0 rE rB rC r5 r& Ú classmethodrS r r] rF ra r rn r2 ro rp r ri r! r! )rR r" rD S s rD c s4 e Z d Z d Z f d d Z d d Z S)ÚStringRelatedFieldzd
A read only field that represents its targets using their
plain string representation.
c s$ d | d <t t | j | d S)NTr7 )rO rs r5 )r( rP )rR r! r" r5 à s
zStringRelatedField.__init__c C s
t j | S)N)r r% )r( rg r! r! r" rh ä s z$StringRelatedField.to_representation)r. r/ r0 r1 r5 rh r! r! )rR r" rs Ú s rs c sp e Z d Z d e d d e d d e d i Z f d d Z d d
Z d d Z d
d Z S)ÚPrimaryKeyRelatedFieldr9 zThis field is required.Údoes_not_existz0Invalid pk "{pk_value}" - object does not exist.Úincorrect_typez8Incorrect type. Expected pk value, received {data_type}.c s/ | j d d | _ t t | j | d S)NÚpk_field)rH rw rO rt r5 )r( rP )rR r! r" r5 ï s z PrimaryKeyRelatedField.__init__c C s d S)NTr! )r( r! r! r" ra ó s z/PrimaryKeyRelatedField.use_pk_only_optimizationc C s | j d k r! | j j | } y | j j d | SWnX t k
rb | j d d | Yn4 t t f k
r | j d d t | j Yn Xd S)Nr4 ru Úpk_valuerv Ú data_type)
rw Úto_internal_valuerF rM r ÚfailÚ TypeErrorÚ
ValueErrorÚtyper. )r( r^ r! r! r" rz ö s
z(PrimaryKeyRelatedField.to_internal_valuec C s) | j d k r" | j j | j S| j S)N)rw rh r4 )r( rg r! r! r" rh s z(PrimaryKeyRelatedField.to_representation) r. r/ r0 rK Údefault_error_messagesr5 ra rz rh r! r! )rR r" rt è s
rt c s¯ e Z d Z d Z d Z d e d d e d d e d d e d
d e d i Z d f d
d Z d d Z d d Z d d Z
d d Z d d Z S)ÚHyperlinkedRelatedFieldr4 Nr9 zThis field is required.Úno_matchz!Invalid hyperlink - No URL match.Úincorrect_matchz(Invalid hyperlink - Incorrect URL match.ru z*Invalid hyperlink - Object does not exist.rv z:Incorrect type. Expected URL string, received {data_type}.c s | d k r | | _ | j d k s0 t d | j d | j | _ | j d | j | _ | j d d | _ t | _ t t | j | d S)Nz%The `view_name` argument is required.Ú lookup_fieldÚlookup_url_kwargÚformat)
Ú view_namerN rH r r r
r rO r r5 )r( r rP )rR r! r" r5 s z HyperlinkedRelatedField.__init__c C s
| j d k S)Nr4 )r )r( r! r! r" ra ! s z0HyperlinkedRelatedField.use_pk_only_optimizationc C s/ | | j } | j | i } | j j | S)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.
)r r rF rM )r( r Z view_argsZ view_kwargsÚ lookup_valueÚ
lookup_kwargsr! r! r" Ú
get_object$ s
z"HyperlinkedRelatedField.get_objectc
C sb t | d r" | j d k r" d St | | j } | j | i } | j | d | d | d | S)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.
r4 Nr\ rP Úrequestr
)Nr\ )Úhasattrr4 r r r r )r( r' r r r
r rP r! r! r" Úget_url/ s
z HyperlinkedRelatedField.get_urlc % C s | j j d d } y | j d
} Wn. t k
rX | j d d t | j Yn X| r£ t j | j } t } | j | r£ d | t
| d
} t | } y t | } Wn t
k
rà | j d Yn Xy | j j | j | } Wn t k
r| j } Yn X| j | k r7| j d y | j | j | j | j SWn( t t t f k
r| j d Yn Xd S) Nr úhttp:úhttps:rv ry ú/r r ru )r r )ÚcontextrM Ú
startswithrf r{ r~ r. ÚurlparseÚpathr Úlenr r r Zversioning_schemeZget_versioned_viewnamer r rU rP r r| r} )r( r^ r Z http_prefixÚprefixÚmatchZexpected_viewnamer! r! r" rz > s4
!
z)HyperlinkedRelatedField.to_internal_valuec
C s d | j k s% t d | j j | j d } | j j d d } | rn | j rn | j | k rn | j } y | j | | j | | } Wn[ t k
rê d } | d k rÓ d d d d i | } | d | 7} t | | j Yn X| d k rû d St
| | S)
Nr zz`%s` requires the request in the serializer context. Add `context={'request': request}` when instantiating the serializer.r
zÌCould 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.r\ zthe empty stringÚNonez} 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.)r\ N) r rN rR r. rM r
r r r r r$ )r( rg r r
r) ÚmsgZ value_stringr! r! r" rh b s(
z)HyperlinkedRelatedField.to_representation)
r. r/ r0 r r rK r r5 ra r r rz rh r! r! )rR r" r s $r c s7 e Z d Z d Z d f d d Z d d Z S)Ú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 sI | d k s t d d | d <d | d <t t | j | | d S)Nz%The `view_name` argument is required.Tr7 Ú*r< )rN rO r r5 )r( r rP )rR r! r" r5 s
z!HyperlinkedIdentityField.__init__c C s d S)NFr! )r( r! r! r" ra s z1HyperlinkedIdentityField.use_pk_only_optimization)r. r/ r0 r1 r5 ra r! r! )rR r" r s r c sa e Z d Z d Z d e d d e d i Z d f d d Z d d
Z d d Z S)
ÚSlugRelatedFieldzm
A read-write field that represents the target of the relationship
by a unique 'slug' attribute.
ru z/Object with {slug_name}={value} does not exist.ÚinvalidzInvalid value.Nc s; | d k s t d | | _ t t | j | d S)Nz&The `slug_field` argument is required.)rN Ú
slug_fieldrO r r5 )r( r rP )rR r! r" r5 ¯ s zSlugRelatedField.__init__c
C s y | j j | j | i SWnX t k
rV | j d d | j d t | Yn% t t f k
rz | j d Yn Xd S)Nru Z slug_namerg r )rF rM r r r{ r
r| r} )r( r^ r! r! r" rz ´ s
&z"SlugRelatedField.to_internal_valuec C s t | | j S)N)r r )r( r' r! r! r" rh ¼ s z"SlugRelatedField.to_representation) r. r/ r0 r1 rK r r5 rz rh r! r! )rR r" r ¥ s r c sÐ e Z d Z d Z g Z g Z d e d d e d i Z d Z d Z d f d d Z
d d
Z d d Z d
d Z
d d Z d d d Z e d d Z e d d Z d d Z S)rY 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.
Ú
not_a_listz5Expected a list of items but got type "{input_type}".r zThis list may not be empty.Nc sÉ | | _ | j d d | _ t j } | d k r? t | } | j d | | _ | j d | j pr t t j | _ | d k s t
d t t | j
| | | j j d d d | d S) NrA TrB rC z(`child_relation` is a required argument.Ú
field_namer\ Úparent)rV rH rA r rI rJ rB rC rK rL rN rO rY r5 Úbind)r( rV rU rP rQ )rR r! r" r5 Õ s zManyRelatedField.__init__c C sZ t j | rG | j | k r7 t | j d d r7 t S| j | j S| j | j t S)NÚpartialF)r Ú
is_html_inputr r Úrootr ÚgetlistrM )r( Ú
dictionaryr! r! r" Ú get_valueæ s zManyRelatedField.get_valuec s t | t d s% t | d rA j d d t | j j rj t | d k rj j d f d d | D S) Nr\ Ú__iter__r Ú
input_typer r c s" g | ] } j j | q Sr! )rV rz )rj rk )r( r! r" rl ù s z6ManyRelatedField.to_internal_value.<locals>.<listcomp>)r_ r~ r r{ r. rA r )r( r^ r! )r( r" rz ò s %
z"ManyRelatedField.to_internal_valuec C sQ t | d r" | j d k r" g St | | j } t | d rM | j S| S)Nr4 r` )r r4 r rd r` )r( r Z relationshipr! r! r" r ý s z ManyRelatedField.get_attributec s f d d | D S)Nc s" g | ] } j j | q Sr! )rV rh )rj rg )r( r! r" rl s z6ManyRelatedField.to_representation.<locals>.<listcomp>r! )r( Úiterabler! )r( r" rh s z"ManyRelatedField.to_representationc C s | j j | S)N)rV rn )r( rm r! r! r" rn s z ManyRelatedField.get_choicesc C s
| j S)N)rn )r( r! r! r" ro s zManyRelatedField.choicesc C s | j S)N)ro )r( r! r! r" rp s z ManyRelatedField.grouped_choicesc C s+ t | j d | j d | j d | j S)Nrm rq )r rn rB rC )r( r! r! r" r s z ManyRelatedField.iter_options)r. r/ r0 r1 r; Údefault_empty_htmlrK r rB rC r5 r§ rz r rh rn r2 ro rp r r! r! )rR r" rY À s rY N)
z read_onlyz
write_onlyzrequiredzdefaultzinitialzsourcezlabelz help_textzstylezerror_messagesz allow_emptyz html_cutoffzhtml_cutoff_text)5Ú
__future__r Ú collectionsr Údjango.core.exceptionsr r Údjango.db.modelsr Údjango.db.models.queryr Ú django.utilsr Údjango.utils.encodingr r
r Z django.utils.six.moves.urllibr r Údjango.utils.translationr
rK Úrest_framework.compatr r r r Úrest_framework.fieldsr r r r r Zrest_framework.reverser Úrest_framework.settingsr Úrest_framework.utilsr r# r% r$ Úobjectr3 rX rD rs rt r r r rY r! r! r! r" Ú<module> s6 "(