կi6 , d Z ddlZddlZddlmZ ddlZddlmZmZ ddl m
Z
ddl m Z ddl m Z ddl m
Z
dd lmZ ej d
Z G d d e Z G d
de Z G d de Z G d de Z G d d ej2 ee Zy)z;Connect to and interact with a REST server and its objects. N)Template)urllibrange)
connection)element_containers)formats)util)
Collectionz [a-z_]\w*c e Zd ZdZy)Errorz'A general error derived from Exception.N)__name__
__module__ __qualname____doc__ R/var/www/html/venv/lib/python3.12/site-packages/pyactiveresource/activeresource.pyr r s 1r r c b e Zd ZdZd Zed Zd Zd Zd Z d Z
d Z d Z d
Z
d Zd Zd
Zy)Errorsz.Represents error lists returned by the server.c || _ i | _ y)zdConstructor for Errors object.
Args:
base: The parent resource object.
N)baseerrors)selfr s r __init__zErrors.__init__ s r c , t | j S Nlenr r s r sizez Errors.size& s 4;; r c , t | j S r r r s r __len__zErrors.__len__* s 4;; r c Z | j j |g j | y)zAdd an error to a resource object's attribute.
Args:
attribute: The attribute to add the error to.
error: The error string to add.
Returns:
None
N)r
setdefaultappend)r attributeerrors r addz
Errors.add- s#
y"-44U;r c ( | j d| y)zAdd an error to the base resource object rather than an attribute.
Args:
error: the error string to add.
Returns:
None
r N)r( )r r' s r add_to_basezErrors.add_to_base8 s
r c i | _ y)zoClear any errors that have been set.
Args:
None
Returns:
None
N)r r s r clearz Errors.clearB s r c | j j j }|D ]a }|j d }t j
| }||v r"| j
||t | dz d Q| j | c y )Nr ) r
attributeskeyssplitr
underscorer( r r* )r messagesattribute_keysmessage attr_namekeys r
from_arrayzErrors.from_arrayL sw --224 G
*I//),Cn$gc)nQ&6&7 89 )
r c | j j j }t j | D ]4 \ }}|D ]* }||v r| j || | j
| , 6 y r )r r/ r0 six iteritemsr( r* )r r3 r4 r7 r r5 s r from_hashzErrors.from_hashV s_ --224 ==2KC!.(HHS'*$$W- " 3r c t j | d d }t |t s|g}| j | y# t j $ r g }Y )w xY w)zGrab errors from an XML response.
Args:
xml_string: An xml errors object (e.g. '')
Returns:
None
r r' N)r xml_to_dict
isinstancelistr r8 )r
xml_stringr3 s r from_xmlzErrors.from_xml_ sZ ''
3H=gFH h- $:
! zz H s .A AAc j t j |j d }|si }t |t
rXd|v st
| dk( rF|j di }t |t r| j | y| j | y| j | y# t $ r i }Y w xY w)zGrab errors from a JSON response.
Args:
json_string: An json errors object (e.g. "{ 'errors': {} }")
Returns:
None
utf-8r r N) r json_to_dictdecode
ValueErrorr? dictr getr@ r8 r< )r json_stringdecodedr s r from_jsonzErrors.from_jsono s '' (:(:7(CDG G gt $(g*=W QRAR [[2.F&$''v&
NN7 # G s $B$ $ B21B2c d | j j |g }t | dk( r|d S |S )a Return the errors for the given attribute.
Args:
attribute: The attribute to retrieve errors for.
Returns:
An error string, or a list of error message strings or None
if none exist for the given attribute.
r. r )r rI r )r r& r s r onz Errors.on s3 B/ v;! !9
r c g }t j | j D ]E \ }}|D ]; }|dk( r|j | |j dj ||f = G |S )zReturns all the full error messages in an array.
Args:
None
Returns:
An array of error strings.
r )r: r; r r% join)r r3 r7 r r' s r
full_messageszErrors.full_messages sa ==5KC &= OOE* OOCHHc5\$:; 6 r N)r
r r r r propertyr r" r( r* r, r8 r< rB rL rN rR r r r r r sP 8 < *." $2 r r c e Zd ZdZd Zd Zy)ClassAndInstanceMethodz@A descriptor to allow class/instance methods with the same name.c || _ || _ y r ) class_methodinstance_method)r rW rX s r r z ClassAndInstanceMethod.__init__ s ( . r c ^ |rt || j S t || j S r )getattrrX rW )r instanceowners r __get__z ClassAndInstanceMethod.__get__ s+ 8T%9%9: :ud / /00r N)r
r r r r r] r r r rU rU s J/1r rU c e Zd ZdZd Zed Zd Zd Z eeedd Z d Z
d Z ee
e dd
Z d Z
d Z ee
edd
Zd Zd Z eeedd Zd Zd Z eeedd Zd Zd Z eeedd Zd Zd Z eeedd Zd Z d Z ee e dd Z d Z d Z ee e dd Z!d$d Z"d! Z#d" Z$ ee#e$dd# Z%y)% ResourceMetazA metaclass for ActiveResource objects.
Provides a separate namespace for configuration objects (user,password,
site, etc)c d|vs|d st j | |d< d|vs|d st j |d |d< t j | ||| }d|v r
|d |_ |S )zCreate a new class.
Args:
mcs: The metaclass.
name: The name of the class.
bases: List of base classes from which mcs inherits.
new_attrs: The class attribute dictionary.
_singular_plural_site)r r2 pluralizetype__new__site)mcsnamebases new_attrsklasss r rf zResourceMeta.__new__ s~ i 'y/E%)__T%:Ik " I %Yy-A#'>>)K2H#IIi S$y9 i "7+EJ r c 6 | j d }|t k( sd| j v rh| j Pt j
| j | j | j | j | j | _ | j S |j S )z4A connection object which handles all HTTP requests.r. _connection) __mro__object__dict__rn r
Connectionrg userpasswordtimeoutformat)cls super_classs r r zResourceMeta.connection sv kk!n & MS\\$A&","7"7HHchh ckk3::#O?? " )) )r c | j S r )_userrw s r get_userzResourceMeta.get_user yyr c d | _ || _ y r )rn rz rw values r set_userzResourceMeta.set_user s cocir Nz A username for HTTP Basic Auth.c | j S r ) _passwordr{ s r get_passwordzResourceMeta.get_password }} r c d | _ || _ y r )rn r r s r set_passwordzResourceMeta.set_password s
r z A password for HTTP Basic Auth.c | j S r )rc r{ s r get_sitezResourceMeta.get_site r} r c J |t j j | }|j r.t j j |j | _ |j r.t j j |j | _ d | _ || _ y r )
r parseurlparseusernameunquoterz rt r rn rc )rw r partss r set_sitezResourceMeta.set_site sl LL))%0E~~ "LL 0 0 @ ~~ & 4 4U^^ D
r z!The base REST site to connect to.c | j S r _headersr{ s r get_headerszResourceMeta.get_headers ||r c || _ y r r r s r set_headerszResourceMeta.set_headers s r z
HTTP headers.c | j S r )_timeoutr{ s r get_timeoutzResourceMeta.get_timeout
r r c d | _ || _ y r )rn r r s r set_timeoutzResourceMeta.set_timeout s r z"Socket timeout for HTTP operationsc | j S r )_formatr{ s r
get_formatzResourceMeta.get_format {{r c d | _ || _ y r )rn r r s r
set_formatzResourceMeta.set_format s r z.A format object for encoding/decoding requestsc | j S r rb r{ s r
get_pluralzResourceMeta.get_plural! r r c || _ y r r r s r
set_pluralzResourceMeta.set_plural$ s r z$The plural name of this object type.c | j S r ra r{ s r get_singularzResourceMeta.get_singular* r r c || _ y r r r s r set_singularzResourceMeta.set_singular- s
r z&The singular name of this object type.c t | d r | j S t j j | j
d S )z7Return the prefix source, by default derived from site._prefix_source )hasattrr r r urlsplitrg r{ s r get_prefix_sourcez ResourceMeta.get_prefix_source3 s7 3( )%% %<<((215 5r c || _ y)z>Set the prefix source, which will be rendered into the prefix.N)r r s r set_prefix_sourcez ResourceMeta.set_prefix_source: s
"r z+prefix for lookups for this type of object.c $ | j | S )z+Return the rendered prefix for this object.)_prefix)rw optionss r prefixzResourceMeta.prefixA s {{7##r c | j S r _primary_keyr{ s r get_primary_keyz ResourceMeta.get_primary_keyE s r c || _ y r r r s r set_primary_keyz ResourceMeta.set_primary_keyH s
r z5Name of attribute that uniquely identies the resourcer )&r
r r r rf rS r r| r rs r r rt r r rg r r headersr r ru r r rv r r pluralr r singularr r
prefix_sourcer r r primary_keyr r r r_ r_ sa
2 * * Hh5 7D lD9;H Hh7 9D {K&(G {K;=G j*dGIF j*d<>F lD@BH6# .0A4 JLM$ ! ?OTRTKr r_ c e Zd ZdZdZej ZdZdZ dZ
dZ dZ dZ
dAdZedAd ZedBd Zed Zed Zed Zed
Zed Zed ZedBd
ZedBd Zedi fd Zed ZedAd Z edAd Z ed Z ed Z edCd Z edCd Z!ed Z"ed Z#ed Z$edBd Z%d Z&d Z'dDd Z(dEd Z)d Z*d Z+d! Z,d" Z-d# Z.d$ Z/d% Z0 e1e/e0dd& Z2d' Z3d( Z4d) Z5e6jn rd* Z8nd+ Z9d, Z:d- Z;ed. Zd1 Z?d2 Z@dCd3ZAdCd4ZBd5 ZCd6 ZD eEd7d8 ZF eEd9d: ZG eEd;d< ZH eEd=d> ZI eEd?d@ ZJy)GActiveResourcez$Represents an activeresource object.Nidc |i }| j | _ i | _ |r|| _ ni | _ | j | t | | _ d| _ y)a Initialize a new ActiveResource object.
Args:
attributes: A dictionary of attributes which represent this object.
prefix_options: A dict of prefixes to add to the request for
nested URLs.
NT) __class__rl r/ _prefix_options_updater r _initialized)r r/ prefix_optionss r r zActiveResource.__init__[ sS *^^
#1D #%D Z Tl r c T |r | j |fi |S | j dd|i|S )a Core method for finding resources.
Args:
id_: A specific resource to retrieve.
from_: The path that resources will be fetched from.
kwargs: any keyword arguments for query.
Returns:
An ActiveResource object.
Raises:
connection.Error: On any communications errors.
Error: On any other errors.
from_r ) _find_single _find_every)rw id_r kwargss r findzActiveResource.findp s8 #3##C262 2 s5U5f55r c : | j dd|i|}|r|d S y)a Core method for finding resources.
Args:
from_: The path that resources will be fetched from.
kwargs: any keyword arguments for query.
Returns:
The first resource from the list of returned resources or None if
none are found.
Raises:
connection.Error: On any communications errors.
Error: On any other errors.
r r Nr )r )rw r r resourcess r
find_firstzActiveResource.find_first s. $COO:%:6: Q< r c & | j || S )ac Get a single resource from a specific URL.
Args:
from_: The path that resources will be fetched from.
kwargs: Any keyword arguments for query.
Returns:
An ActiveResource object.
Raises:
connection.Error: On any communications errors.
Error: On any other errors.
) _find_one)rw r r s r find_onezActiveResource.find_one s }}UF++r c | j | \ }}| j ||| } | j j || j }y# t j
$ r Y yw xY w)a Check whether a resource exists.
Args:
id_: The id or other key which specifies a unique object.
kwargs: Any keyword arguments for query.
Returns:
True if the resource is found, False otherwise.
TF)_split_options
_element_pathr headr r )rw r r r
query_optionspath_s r existszActiveResource.exists sg ),(:(:6(B%
nmD ##D#++6A s &A A&%A&c 6 | | }|j |S )a Create and save a resource with the given attributes.
Args:
attributes: A dictionary of attributes which represent this object.
Returns:
The new resource (which may or may not have been saved successfully).
)save)rw r/ resources r createzActiveResource.create s z?
r c i }i }t j | D ]" \ }}|| j v r|||< |||< $ ||gS )zSplit prefix options and query options.
Args:
options: A dictionary of prefix and/or query options.
Returns:
A tuple containing (prefix_options, query_options)
)r: r; _prefix_parameters)rw r r r r7 r s r r z ActiveResource._split_options sW
--0JCc,,..&+s#%*
c" 1
..r c | j | \ }}| j ||| }| j | j j || j
| S )a< Get a single object from the default URL.
Args:
id_: The id or other key which specifies a unique object.
kwargs: Any keyword arguments for the query.
Returns:
An ActiveResource object.
Raises:
ConnectionError: On any error condition.
)r r
_build_objectr
get_formattedr )rw r r r r r s r r zActiveResource._find_single sZ ),(:(:6(B%
nmD !=!=dCKK!P!/1 1r c || j | z }| j | j j || j S )aJ Find a single resource from a one-off URL.
Args:
from_: The path from which to retrieve the resource.
query_options: Any keyword arguments for the query.
Returns:
An ActiveResource object.
Raises:
connection.ConnectionError: On any error condition.
)
_query_stringr r r r )rw r r r s r r zActiveResource._find_one s? s(( 77 !=!=dCKK!PQQr c r | j | \ }}|r(|j | || j | z }d}n| j || }| j j || j }| j j |j }| j |||j S )zGet all resources.
Args:
from_: (optional) The path from which to retrieve the resource.
kwargs: Any keyword arguments for the query.
Returns:
A list of resources.
N) r updater _collection_pathr rI r rv rF body_build_collection)rw r r r r r responseobjss r r zActiveResource._find_every s ),(:(:6(B%
03,,];;D !N ''
FD>>%%dCKK8zz /$$T>8;K;KLLr c | || S )a3 Create an object or objects from the given resource.
Args:
attributes: A dictionary representing a resource.
prefix_options: A dict of prefixes to add to the request for
nested URLs.
Returns:
An ActiveResource object.
r )rw r/ r s r r z ActiveResource._build_object s :~..r c d t |t r|g}n fd|D }t |d|i S )a Create a Collection of objects from the given resources.
Args:
elements: A list of dictionaries representing resources.
prefix_options: A dict of prefixes to add to the request for
nested URLs.
headers: The response headers that came with the resources.
Returns:
A Collection of ActiveResource objects.
c 3 B K | ] }j | y wr )r ).0elrw r s r z3ActiveResource._build_collection..1 s" @H"!!"n5s r )metadata)r? rH r
)rw elementsr r s ` ` r r z ActiveResource._build_collection sB h % !zH@HH ( w.
r c 8 |rdt j | z S y)zReturn a query string for the given options.
Args:
query_options: A dictionary of query keys/values.
Returns:
A string containing the encoded query.
? )r to_query)rw r s r r z ActiveResource._query_string= s }55 5r c d| j | | j || j j | j | dz S )a
Get the element path for the given id.
Examples:
Comment.element_path(1, {'post_id': 5}) -> /posts/5/act
Args:
id_: The id of the object to retrieve.
prefix_options: A dict of prefixes to add to the request for
nested URLs.
query_options: A dict of items to add to the query string for
the request.
Returns:
The path (relative to site) to the element formatted with the query.
z0%(prefix)s/%(plural)s/%(id)s.%(format)s%(query)s)r r r rv queryr rb rv extensionr )rw r r r s r r z ActiveResource._element_pathK sI B ++n5 ++ **.. **=9 E; ; ;r c d| j | | j | j j | j | dz S )a Get the collection path for this object type.
Examples:
Comment.collection_path() -> /comments.xml
Comment.collection_path(query_options={'active': 1})
-> /comments.xml?active=1
Comment.collection_path({'posts': 5})
-> /posts/5/comments.xml
Args:
prefix_options: A dict of prefixes to add to the request for
nested URLs
query_options: A dict of items to add to the query string for
the request.
Returns:
The path (relative to site) to this type of collection.
z)%(prefix)s/%(plural)s.%(format)s%(query)s)r r rv r r )rw r r s r r z ActiveResource._collection_patha sD $ ; ++n5 ++ **.. **=9 >; ; ;r c | j | \ }}d| j | | j || j j | j | dz }|S )a Get the collection path for this resource type.
Args:
method_name: The HTTP method being used.
options: A dictionary of query/prefix options.
Returns:
The path (relative to site) to this type of collection.
z9%(prefix)s/%(plural)s/%(method_name)s.%(format)s%(query)sr r method_namerv r )r r rb rv r r )rw r r r r r s r _custom_method_collection_urlz,ActiveResource._custom_method_collection_urly sc ),(:(:7(C%
G{{>2{{ 'zz++''
6
8
8
r c r | j || }| j j || j S zGet a nested resource or resources.
Args:
method_name: the nested resource to retrieve.
kwargs: Any keyword arguments for the query.
Returns:
A dictionary representing the returned data.
)r r r r rw r r urls r
_class_getzActiveResource._class_get s1 // VD~~++C==r c t | j || }| j j || j | S )a( Get a nested resource or resources.
Args:
method_name: the nested resource to retrieve.
body: The data to send as the body of the request.
kwargs: Any keyword arguments for the query.
Returns:
A connection.Response object.
)r r postr rw r r r r s r _class_postzActiveResource._class_post s3 // VD~~""3 T::r c t | j || }| j j || j | S )a) Update a nested resource or resources.
Args:
method_name: the nested resource to update.
body: The data to send as the body of the request.
kwargs: Any keyword arguments for the query.
Returns:
A connection.Response object.
)r r putr r s r
_class_putzActiveResource._class_put s3 // VD~~!!#s{{D99r c r | j || }| j j || j S zDelete a nested resource or resources.
Args:
method_name: the nested resource to delete.
kwargs: Any keyword arguments for the query.
Returns:
A connection.Response object.
)r r deleter r s r
_class_deletez ActiveResource._class_delete s1 // VD~~$$S#++66r c r | j || }| j j || j S zPredicate a nested resource or resources exists.
Args:
method_name: the nested resource to predicate exists.
kwargs: Any keyword arguments for the query.
Returns:
A connection.Response object.
)r r r r r s r _class_headzActiveResource._class_head s1 // VD~~""3 44r c | j }t | }t }|j j | D ]? }dD ]8 }|j | s|j
|j | : A |S )a> Return a list of the parameters used in the site prefix.
e.g. /objects/$object_id would yield ['object_id']
/objects/${object_id}/people/$person_id/ would yield
['object_id', 'person_id']
Args:
None
Returns:
A set of named parameters.
)bracednamed)r r setpatternfinditer groupdictr( )rw r templater0 match
match_types r r z!ActiveResource._prefix_parameters sr D>u %%..t4E /
??$Z0HHU__ .z :; 0 5 r c
2 |i }t j dd| j }t | }| j }t |D cg c] }||j
|d f c} }|j | }t j dd| S c c}w )zReturn the prefix for this object type.
Args:
options: A dictionary containing additional prefixes to prepend.
Returns:
A string containing the path to this element.
z/$r z^/+)resubr r r rH rI safe_substitute)rw r r r# r0 kr s r r zActiveResource._prefix s ?GvvdB 1 12D>%%'>AGKK2 ./>?))'2vveR(( ?s
Bc j i }t j | j D ] \ }}t |t rPg }|D ]C }t |t
r |j
|j 3|j
| E |||< ft |t
r|j ||< |||< |S )z#Convert the object to a dictionary.)r: r; r/ r? r@ r r% to_dict)r valuesr7 r new_valueitems r r, zActiveResource.to_dict s --8JC%& !D n5 &&t||~6 &&t, "
(s E>2 #mmos #s 9
r c h t | d| j j j z di |S )Nto_r )rZ rl rv r )r r s r encodezActiveResource.encode
s. AwtUTZZ%6%6%@%@ @ALGLLr c n |s | j }t j | j |||| S )ad Convert the object to an xml string.
Args:
root: The name of the root element for xml output.
header: Whether to include the xml header.
pretty: Whether to "pretty-print" format the output.
dasherize: Whether to dasherize the xml attribute names.
Returns:
An xml string.
)rootheaderpretty dasherize)ra r to_xmlr, )r r4 r5 r6 r7 s r r8 zActiveResource.to_xml
s3 >>D{{4<<>"(%.0 0r c |dk( r | j }t j | j | j d S )z$Convert the object to a json string.T)r4 rD )ra r to_jsonr, r2 )r r4 s r r: zActiveResource.to_json s4 4<>>D||DLLN6==gFFr c | j j j | j | j | j
| j j }| j | y)zConnect to the server and update this resource's attributes.
Args:
None
Returns:
None
N)rl r r r r r r r )r r/ s r reloadzActiveResource.reload$ sS ZZ**88""477D,@,@A
""$
Z r c | | j j | j ro| j j j | j
| j | j | j j | j }n}| j j j | j | j | j j | j }| j | }|r|| _ | j j j- |j& }|r| j1 | y# t j $ r}| j j t j k( r0| j j# |j$ j& nV| j j t j( k( r/| j j+ |j$ j& Y d}~yd}~ww xY w# t j. $ r Y yw xY w)a< Save the object to the server.
Args:
None
Returns:
True on success, False on ResourceInvalid errors (sets the errors
attribute if an object is returned by the server).
Raises:
connection.Error: On any communications problems.
)dataNFT)r r, r rl r r r r r r2 r r _id_from_responseResourceInvalidrv r XMLFormatrB r r
JSONFormatrL rF r r )r r new_iderrr/ s r r zActiveResource.save1 s KK ww ::0044 **477D4H4HI
** ![[] 5 ,
::0055 --d.B.BC
** ![[] 6 , //9 $DG **11(--@J LL $ )) zz G$5$55 $$S\\%6%67""g&8&88 %%cll&7&78 }} s+ DE /H% H"+B-H H"%H;:H;c . t | j S )zReturns True if no errors have been set.
Args:
None
Returns:
True if no errors have been set, False otherwise.
r r s r is_validzActiveResource.is_validY s t{{###r c
t j d|j d|j dd }|r t |j d S y# t
$ r |j d cY S w xY w)zPull the ID out of a response from a create POST.
Args:
response: A Response object.
Returns:
An id string.
z\/([^\/]*?)(\.\w+)?$Locationlocationr r. N)r' searchrI intgrouprG )r r r$ s r r? z ActiveResource._id_from_responsec st 1",,z'/||J'CEF
&5;;q>**
& {{1~%
&s A A21A2c | j j j | j | j | j
| j j y)zxDeletes the resource from the remote service.
Args:
None
Returns:
None
N)rl r r r r r r r s r destroyzActiveResource.destroyt sC
$$""477D,@,@A
"" $r c ` | j j | j j S r )r/ rI rl r r s r get_idzActiveResource.get_id s! ""4::#9#9::r c J || j | j j < y r )r/ rl r )r r s r set_idzActiveResource.set_id s 27
../r z Value stored in the primary keyc n d| j v r || j v r| j | S t | )zRetrieve the requested attribute if it exists.
Args:
name: The attribute name.
Returns:
The attribute's value.
Raises:
AttributeError: if no such attribute exists.
r/ )rq r/ AttributeError)r ri s r __getattr__zActiveResource.__getattr__ s6 4== (t&t,, T""r c d| j v rM|| j v st | j |d rt j | || y|| j
|< yt j | || y)zSet the named attributes.
Args:
name: The attribute name.
value: The attribute's value.
Returns:
None
r N)rq rZ r rp __setattr__r/ )r ri r s r rW zActiveResource.__setattr__ s_ T]] *t}}$d(K""4u5 ).% tT5 1r c : | j d| j dS )N())ra r r s r __repr__zActiveResource.__repr__ s >>47733r c t || j r t | j |j S t | j | S r )r? r cmpr r others r __cmp__zActiveResource.__cmp__ s6 % 0477EHH--477E**r c |j | j k( xr4 | j |j k( xr | j |j k( S r )r r r r^ s r __eq__zActiveResource.__eq__ sH ??dnn4 Eww%((*E++u/D/DD
Er c v t t t t j | j
S r )hashtuplesortedr: r; r/ r s r __hash__zActiveResource.__hash__ s$ E& t!?@ABBr c t |t syt j | D ] \ }}t |t r| j | } || }njt |t
rXd}g }|D ]N }t |t r+|| j
| }|j || >|j | P n|}|| j |< y)zUpdate the object with the given attributes.
Args:
attributes: A dictionary of attributes.
Returns:
None
N) r? rH r: r; _find_class_forr@ _find_class_for_collectionr% r/ )r r/ r7 r rl attrchilds r r zActiveResource._update s *d+ --
3JC%& ,,S1 U|E4( "E!%. =$($C$CC$HE E%L1 E*
# #'DOOC # 4r c J | j t j | S )a Look in the parent modules for classes matching the element name.
One or both of element/class name must be specified.
Args:
collection_name: The name of the collection type.
Returns:
A Resource class.
)ri r singularize)rw collection_names r rj z)ActiveResource._find_class_for_collection s ""4#3#3O#DEEr c ( |s
|s t d |st j | }n|st j | }| j j d }t
t | dd D ]U } t dj |d| t j dj |d| } t || }|c S |r#t! t# | | fd| j i S y# t $ r Y w xY w# t $ r t dj |j |g t j dj |j |g }n# t $ r Y Y w xY w t || }|cY c S # t $ r Y Y w xY ww xY w)a Look in the parent modules for classes matching the element name.
One or both of element/class name must be specified.
Args:
element_name: The name of the element type.
class_name: The class name of the element type.
create_missing: Whether classes should be auto-created if no
existing match is found.
Returns:
A Resource class.
z1One of element_name,class_name must be specified..r Nr )r r r2 camelizer r1 r r
__import__rQ sysmodules ImportErrorrZ rT r
re str) rw element_name
class_namecreate_missing module_pathdepthmodulerl submodules r ri z ActiveResource._find_class_for s JKL L ??:6L |4Jnn**3/ 3{+Q3E
388K$789 SXXk&5.A%BC
3 4. J#,1OP P '
"
sxx ,(G HI # CHHfoo6B6D -E !FI" #Iz :E L%
sh 4AC.7
C=. C:9C:= FAE F E)%F(E))F-
E?:F? F
F F
Fc 0 | j | \ }}|j | j d| j j | | j
| j || j j j | j | dz }|S )a Get the element path for this type of object.
Args:
method_name: The HTTP method being used.
options: A dictionary of query/prefix options.
Returns:
The path (relative to site) to the element formatted with the query.
z@%(prefix)s/%(plural)s/%(id)s/%(method_name)s.%(format)s%(query)s)r r r r rv r )
r r r rl r rb r rv r r r r r r r r s r _custom_method_element_urlz)ActiveResource._custom_method_element_url s )-(;(;G(D%
d 2 23 Nzz(( 8||77 'zz((22(( 7
9
9
r c | j | \ }}|j | j d| j j | | j
|| j j j | j | dz }|S )a% Get the element path for creating new objects of this type.
Args:
method_name: The HTTP method being used.
options: A dictionary of query/prefix options.
Returns:
The path (relative to site) to the element formatted with the query.
z=%(prefix)s/%(plural)s/new/%(method_name)s.%(format)s%(query)sr ) r r r rl r rb rv r r r s r _custom_method_new_element_urlz-ActiveResource._custom_method_new_element_url- s )-(;(;G(D%
d 2 23 Kzz(( 8|| 'zz((22(( 7
9
9
r c | j || }| j j j || j j S r
)r rl r r r r r r r s r
_instance_getz ActiveResource._instance_getA s= --k6Bzz$$223
8J8JKKr c | j r| j || }n$|s| j }| j || }| j j
j
|| j j | S )a* Create a new resource/nested resource.
Args:
method_name: the nested resource to post to.
body: The data to send as the body of the request.
kwargs: Any keyword arguments for the query.
Returns:
A connection.Response object.
)r r r2 r rl r r r r r r r r s r _instance_postz ActiveResource._instance_postM sf 7711+vFC{{}55k6JCzz$$))#tzz/A/A4HHr c | j || }| j j j || j j | S )a Update a nested resource.
Args:
method_name: the nested resource to update.
body: The data to send as the body of the request.
kwargs: Any keyword arguments for the query.
Returns:
A connection.Response object.
)r rl r r r r s r
_instance_putz ActiveResource._instance_put_ s? --k6Bzz$$((djj.@.@$GGr c | j || }| j j j || j j S r )r rl r r r r s r _instance_deletez ActiveResource._instance_deletel s= --k6Bzz$$++C1C1CDDr c | j || }| j j j || j j S r )r rl r r r r s r _instance_headz ActiveResource._instance_headx s= --k6Bzz$$))#tzz/A/ABBr r
r r r r r r r r r )NNr )r )NTFT)T)NNT)Kr
r r r rn r rB r r r rc r rz r r classmethodr r r r r r r r r r r r r r r r
r r r r r r r, r2 r8 r: r< r rF r? rN rP rR rS r rU rW r[ r: PY2r` rb rg r rj ri r r r r r r r rU rI r r r r r r r r r O s .K GHI EH EL!* 6 6& $ , , "
/ /$ 1 1
R
R M M,
/
/ 8
> ; ; : :
7
7
5
5 ( ) )$$M0"G !&P$&"
$;8
&&$(I JB
# 2&4 ww + E
C(:
F
F *.8<.Q .Qb*(
LI$ H
E
C !
?C !-1A BD
?C
#O5G
HF !-1A BDr r )r r' ru stringr r: six.movesr r pyactiveresourcer r r r pyactiveresource.collectionr
compile
VALID_NAME Exceptionr rp r rU re r_ with_metaclassr r r r r s B
# ' / $ ! 2 RZZ
%
I
KV K\
1V
1WT4 WTtz C'S'' f= z Cr