ó
³EYc@s~
dZd
dl
Z
d
dlZd
dlmZ
d
dlZd
dlmZ
d
dlm	Z	
d
dl
mZ
d
dl
mZ
d„Z
d	ef
d
„ƒYZdef
d„ƒYZeje
jƒ
d
ef
d„ƒYƒ
Zdef
d„ƒYZdef
d„ƒYZdef
d„ƒYZdef
d„ƒYZdeefd„ƒYZdeefd„ƒYZdeefd„ƒYZdS(sG
Base utilities to build API operation managers and objects on top of.
iÿÿÿÿN(
tResponse(
tparse(
t
exceptions(
tencodeutils(
tstrutilsc

CsLy|jr|jSWnt
k
r'


n
Xy|jSWnt
k
rG


|SXd
S(s³Return id if argument is a Resource.

    Abstracts the common pattern of allowing both an object or an object's ID
    (UUID) as a parameter when dealing with relationships.
    N(tuuidtAttributeErrortid(
tobj((sP/home/tvault/.virtenv/lib/python2.7/site-packages/cinderclient/apiclient/base.pytgetid&s
	








t
HookableMixincBs2eZ
dZiZed
„ƒ
Zed„ƒ
ZRS(s,Mixin so classes can register and run hooks.cCs7|
|jkrg|j|
<n|j|
j
|ƒ

d
S(sÂAdd a new hook of specified type.

        :param cls: class that registers hooks
        :param hook_type: hook type, e.g., '__pre_parse_args__'
        :param hook_func: hook function
        N(t
_hooks_maptappend(tclst	hook_typet	hook_func((sP/home/tvault/.virtenv/lib/python2.7/site-packages/cinderclient/apiclient/base.pytadd_hook<s
cOs:|jj
|
ƒ
pg}x|D]}|||Ž
qWd
S(s
Run all hooks of specified type.

        :param cls: class that registers hooks
        :param hook_type: hook type, e.g., '__pre_parse_args__'
        :param **args: args to be passed to every hook function
        :param **kwargs: kwargs to be passed to every hook function
        N(Rtget(R
Rtargstkwargst
hook_funcsR((sP/home/tvault/.virtenv/lib/python2.7/site-packages/cinderclient/apiclient/base.pyt	run_hooksIs	


(t__name__t
__module__t__doc__RtclassmethodRR(((sP/home/tvault/.virtenv/lib/python2.7/site-packages/cinderclient/apiclient/base.pyR
8s


tBaseManagercBsqeZ
dZd	Zd
„Zd	d	d„Zd„Zd„Ze	d„
Z
d	d	d„Zd	d	d„Zd„Z
RS(
s´Basic manager type providing common operations.

    Managers interact with a particular type of API (servers, flavors, images,
    etc.) and provide CRUD operations for them.
    cCs tt
|ƒjƒ
|
|_d
S(s{Initializes BaseManager with `client`.

        :param client: instance of BaseClient descendant for HTTP requests
        N(tsuperRt__init__tclient(tselfR((sP/home/tvault/.virtenv/lib/python2.7/site-packages/cinderclient/apiclient/base.pyR_s
cCsµ|r'|jj
|
d
|ƒ

jƒ}n|jj|
ƒ
jƒ}|dkrW|j}n||}y|d}Wnttfk
rˆ


n
Xg|D]!}|r|||dtƒ
^qS(s·
List the collection.

        :param url: a partial URL, e.g., '/servers'
        :param response_key: the key to be looked up in response dictionary,
            e.g., 'servers'
        :param obj_class: class for constructing the returned objects
            (self.resource_class will be used by default)
        :param json: data that will be encoded as JSON and passed in POST
            request (GET will be sent by default)
        tjsontvaluestloadedN(	RtpostRRtNonetresource_classtKeyErrort	TypeErrortTrue(Rturltresponse_keyt	obj_classRtbodytdatatres((sP/home/tvault/.virtenv/lib/python2.7/site-packages/cinderclient/apiclient/base.pyt_listgs
!




cCs2|jj
|
ƒ
jƒ}|j|||d
tƒ
S(sÄGet an object from collection.

        :param url: a partial URL, e.g., '/servers'
        :param response_key: the key to be looked up in response dictionary,
            e.g., 'server'
        R!(RRRR$R'(RR(R)R+((sP/home/tvault/.virtenv/lib/python2.7/site-packages/cinderclient/apiclient/base.pyt_get„s
cCs|jj
|
ƒ
}|jd
kS(seRetrieve request headers for an object.

        :param url: a partial URL, e.g., '/servers'
        iÌ(Rtheadtstatus_code(RR(tresp((sP/home/tvault/.virtenv/lib/python2.7/site-packages/cinderclient/apiclient/base.pyt_headŽs
cCs@|jj
|
d
|ƒ

jƒ}|r,||S|j|||ƒS(s¬
Create an object.

        :param url: a partial URL, e.g., '/servers'
        :param json: data that will be encoded as JSON and passed in POST
            request (GET will be sent by default)
        :param response_key: the key to be looked up in response dictionary,
            e.g., 'servers'
        :param return_raw: flag to force returning raw JSON instead of
            Python object of self.resource_class
        R(RR"RR$(RR(RR)t
return_rawR+((sP/home/tvault/.virtenv/lib/python2.7/site-packages/cinderclient/apiclient/base.pyt_post–s


cCsd|jj
|
d
|ƒ

}|jr`|jƒ}|dk	rM|j|||ƒS|j||ƒSndS(sD
Update an object with PUT method.

        :param url: a partial URL, e.g., '/servers'
        :param json: data that will be encoded as JSON and passed in POST
            request (GET will be sent by default)
        :param response_key: the key to be looked up in response dictionary,
            e.g., 'servers'
        RN(RtputtcontentRR#R$(RR(RR)R2R+((sP/home/tvault/.virtenv/lib/python2.7/site-packages/cinderclient/apiclient/base.pyt_put¦s		


cCsR|jj
|
d
|ƒ

jƒ}|dk	r>|j|||ƒS|j||ƒSdS(sF
Update an object with PATCH method.

        :param url: a partial URL, e.g., '/servers'
        :param json: data that will be encoded as JSON and passed in POST
            request (GET will be sent by default)
        :param response_key: the key to be looked up in response dictionary,
            e.g., 'servers'
        RN(RtpatchRR#R$(RR(RR)R+((sP/home/tvault/.virtenv/lib/python2.7/site-packages/cinderclient/apiclient/base.pyt_patch¸s	

cCs|jj
|
ƒ
S(
sYDelete an object.

        :param url: a partial URL, e.g., '/servers/my-server'
        (Rtdelete(RR(((sP/home/tvault/.virtenv/lib/python2.7/site-packages/cinderclient/apiclient/base.pyt_deleteÇsN(RRRR#R$RR.R/R3tFalseR5R8R:R<(((sP/home/tvault/.virtenv/lib/python2.7/site-packages/cinderclient/apiclient/base.pyRWs
		
	tManagerWithFindcBs2eZ
dZejd
„ƒ
Zd„Zd„ZRS(s5Manager with additional `find()`/`findall()` methods.c


CsdS(
N((
R((sP/home/tvault/.virtenv/lib/python2.7/site-packages/cinderclient/apiclient/base.pytlistÓsc
Ksv|j|
}t
|ƒ
}|d
krOd|jj|
f}tj|ƒ
‚
n#|dkrjtjƒ‚
n|d
SdS(s¨Find a single item with attributes matching ``**kwargs``.

        This isn't very efficient: it loads the entire list then filters on
        the Python side.
        isNo %s matching %s.i
N(tfindalltlenR$RRtNotFoundt
NoUniqueMatch(RRtmatchestnum_matchestmsg((sP/home/tvault/.virtenv/lib/python2.7/site-packages/cinderclient/apiclient/base.pytfind×s





c
stg}|
jƒ}x[|j
ƒD]M‰y0t‡f
d
†|Dƒ
ƒ
rT|jˆƒ

nWqtk
rk


qqXqW|S(s¤Find all items with attributes matching ``**kwargs``.

        This isn't very efficient: it loads the entire list then filters on
        the Python side.
        c
3s*|] \}
}tˆ|
ƒ|kV
qdS(
N(
tgetattr(t.0tattrtvalue(
R(sP/home/tvault/.virtenv/lib/python2.7/site-packages/cinderclient/apiclient/base.pys	<genexpr>òs
(titemsR?tallRR(RRtfoundtsearches((
RsP/home/tvault/.virtenv/lib/python2.7/site-packages/cinderclient/apiclient/base.pyR@çs








(RRRtabctabstractmethodR?RGR@(((sP/home/tvault/.virtenv/lib/python2.7/site-packages/cinderclient/apiclient/base.pyR>Ïs	tCrudManagercBs€eZ
dZdZdZdd
„
Zd„Zd„Zd„Z	d„Z
dd„
Zdd„
Zd„Z
d	„Zdd
„
ZRS(sBase manager class for manipulating entities.

    Children of this class are expected to define a `collection_key` and `key`.

    - `collection_key`: Usually a plural noun by convention (e.g. `entities`);
      used to refer collections in both URL's (e.g.  `/v3/entities`) and JSON
      objects containing a list of member resources (e.g. `{'entities': [{},
      {}, {}]}`).
    - `key`: Usually a singular noun by convention (e.g. `entity`); used to
      refer to an individual member of the collection.

    cKs`|
dk	r|
nd
}|d|j
7}|jd|jƒ
}|dk	r\|d|7}n|S(sBuilds a resource URL for the given kwargs.

        Given an example collection where `collection_key = 'entities'` and
        `key = 'entity'`, the following URL's could be generated.

        By default, the URL will represent a collection of entities, e.g.::

            /entities

        If kwargs contains an `entity_id`, then the URL will represent a
        specific member, e.g.::

            /entities/{entity_id}

        :param base_url: if provided, the generated URL will be appended to it
        ts/%ss%s_idN(R#tcollection_keyRtkey(Rtbase_urlRR(t	entity_id((sP/home/tvault/.virtenv/lib/python2.7/site-packages/cinderclient/apiclient/base.pyt	build_url
s

cCsvxo|
jƒj
ƒD][\}}|dkr;|
j|ƒ

qt|tƒr|
j|ƒ

t|ƒ
|
d
|<qqW|
S(s Drop null values and handle ids.s%s_idN(tcopyRLR#tpopt
isinstancetResourceR	(RRRUtref((sP/home/tvault/.virtenv/lib/python2.7/site-packages/cinderclient/apiclient/base.pyt_filter_kwargs'
s





c
Ks8|j|
ƒ
}
|j
|j|
i
|
|j6|jƒS(
N(R^R5RXRU(RR((sP/home/tvault/.virtenv/lib/python2.7/site-packages/cinderclient/apiclient/base.pytcreate2
s






c
Ks+|j|
ƒ
}
|j
|j|
|jƒS(
N(R^R/RXRU(RR((sP/home/tvault/.virtenv/lib/python2.7/site-packages/cinderclient/apiclient/base.pyR9
s



c
Ks%|j|
ƒ
}
|j
|j|
ƒ
S(
N(R^R3RX(RR((sP/home/tvault/.virtenv/lib/python2.7/site-packages/cinderclient/apiclient/base.pyR0?
s

cKs\|j|ƒ
}|j
d
i|jd|
|
d6|rJdtj|ƒ
ndd6|jƒS(smList the collection.

        :param base_url: if provided, the generated URL will be appended to it
        s%(base_url)s%(query)sRVs?%sRStquery(R^R.RXR
t	urlencodeRT(RRVR((sP/home/tvault/.virtenv/lib/python2.7/site-packages/cinderclient/apiclient/base.pyR?C
s


!cKs+|j|ƒ
}|j
|jd
|
|
ƒ
S(skUpdate an element.

        :param base_url: if provided, the generated URL will be appended to it
        RV(R^R8RX(RRVR((sP/home/tvault/.virtenv/lib/python2.7/site-packages/cinderclient/apiclient/base.pyR6Q
sc
KsX|j|
ƒ
}
|
j
ƒ}|jd
|jƒ

|j|j|
i
||j6|jƒS(Ns%s_id(R^RYRZRUR:RX(RRtparams((sP/home/tvault/.virtenv/lib/python2.7/site-packages/cinderclient/apiclient/base.pytupdateZ
s






c
Ks%|j|
ƒ
}
|j
|j|
ƒ
S(
N(R^R<RX(RR((sP/home/tvault/.virtenv/lib/python2.7/site-packages/cinderclient/apiclient/base.pyR;d
s

cKsÅ|j|ƒ
}|j
d
i|jd|
|
d6|rJdtj|ƒ
ndd6|jƒ}t|ƒ
}|dkr¡d|jj|f}t	j
d|ƒ‚
n |d	kr¹t	j‚
n|dSd
S(s’Find a single item with attributes matching ``**kwargs``.

        :param base_url: if provided, the generated URL will be appended to it
        s%(base_url)s%(query)sRVs?%sRSR`isNo %s matching %s.i”
i
N(R^R.RXR
RaRTRAR$RRRBRC(RRVRtrltnumRF((sP/home/tvault/.virtenv/lib/python2.7/site-packages/cinderclient/apiclient/base.pyRGj
s


!




N(RRRR#RTRURXR^R_RR0R?R6RcR;RG(((sP/home/tvault/.virtenv/lib/python2.7/site-packages/cinderclient/apiclient/base.pyRRûs

						
	t	ExtensioncBs5eZ
dZdZdZd„Zd„Zd„ZRS(sExtension descriptor.t__pre_parse_args__t__post_parse_args__cCs3tt
|ƒjƒ
|
|_||_|jƒ
dS(
N(RRfRtnametmodulet_parse_extension_module(RRiRj((sP/home/tvault/.virtenv/lib/python2.7/site-packages/cinderclient/apiclient/base.pyRˆ
s

	
	
c
Cs…d|_
xu|jjjƒD]a\}
}|
|jkrJ|j|
|ƒ
qyt|tƒrh||_
nWqt	k
r|


qXqWdS(
N(
R#t
manager_classRjt__dict__RLtSUPPORTED_HOOKSRt
issubclassRR&(Rt	attr_namet
attr_value((sP/home/tvault/.virtenv/lib/python2.7/site-packages/cinderclient/apiclient/base.pyRkŽ
s
	







c

Csd
|jS(Ns<Extension '%s'>(
Ri(
R((sP/home/tvault/.virtenv/lib/python2.7/site-packages/cinderclient/apiclient/base.pyt__repr__š
s
(s__pre_parse_args__s__post_parse_args__N(	RRRRnR#RlRRkRr(((sP/home/tvault/.virtenv/lib/python2.7/site-packages/cinderclient/apiclient/base.pyRf‚
s

		tRequestIdMixincBs8eZ
dZd
„Zed„ƒ
Zd„Zd„ZRS(s=Wrapper class to expose x-openstack-request-id to the caller.c

Cs
g|_dS(
N(
tx_openstack_request_ids(
R((sP/home/tvault/.virtenv/lib/python2.7/site-packages/cinderclient/apiclient/base.pytsetup 
s
c


Cs|jS(
N(
Rt(
R((sP/home/tvault/.virtenv/lib/python2.7/site-packages/cinderclient/apiclient/base.pytrequest_ids£
scCsQ|
d
krd
St
|
tƒr@x+|
D]}|j|ƒ

q&Wn
|j|
ƒ

d
S(slAdd request_ids as an attribute to the object

        :param resp: list, Response object or string
        N(R#R[R?t_append_request_id(RR2tresp_obj((sP/home/tvault/.virtenv/lib/python2.7/site-packages/cinderclient/apiclient/base.pytappend_request_ids§
s


cCsHt|
t
ƒr4|
jjd
ƒ
}|jj|ƒ

n|jj|
ƒ

dS(Nsx-openstack-request-id(R[RtheadersRRtR(RR2t
request_id((sP/home/tvault/.virtenv/lib/python2.7/site-packages/cinderclient/apiclient/base.pyRw·
s

(RRRRutpropertyRvRyRw(((sP/home/tvault/.virtenv/lib/python2.7/site-packages/cinderclient/apiclient/base.pyRsž
s


		R\cBs˜eZ
dZeZd
Zedd„Zd„Ze	d„ƒ
Z
d„Zd„Ze	d„ƒ
Z
d„Zd	„Zd
„Zd„Zd„Zd
„ZRS(sqBase class for OpenStack resources (tenant, user, etc.).

    This is pretty much just a bag for attributes.
    RicCsp|
|_||_
|j|ƒ

||_|rUt|d
ƒrU|jjdƒ
|_n|jƒ
|j	|ƒ

dS(s

Populate and bind to a manager.

        :param manager: BaseManager object
        :param info: dictionary representing resource attributes
        :param loaded: prevent lazy-loading if set to True
        :param resp: Response or list of Response objects
        RztEtagN(
tmanagert_infot_add_detailst_loadedthasattrRzRt	_checksumRuRy(RR~tinfoR!R2((sP/home/tvault/.virtenv/lib/python2.7/site-packages/cinderclient/apiclient/base.pyRË
s	
	


	




c
sRtd
„ˆj
jƒDƒ
ƒ
}
dj‡f
d†|
Dƒ
ƒ
}dˆjj|fS(Nc
ss1|]'}
|
dd
kr|
dkr|
V
qdS(it
_R~RtN(smanagersx_openstack_request_ids((RIt
k((sP/home/tvault/.virtenv/lib/python2.7/site-packages/cinderclient/apiclient/base.pys	<genexpr>Ý
s


s, c
3s(|]}
d|
tˆ|
ƒfV
qd
S(s%s=%sN(
RH(RIR†(
R(sP/home/tvault/.virtenv/lib/python2.7/site-packages/cinderclient/apiclient/base.pys	<genexpr>á
ss<%s %s>(tsortedRmtkeystjoint	__class__R(RtreprkeysR„((
RsP/home/tvault/.virtenv/lib/python2.7/site-packages/cinderclient/apiclient/base.pyRrÜ
s
	

c

Cs8|j|j
kr4|jr4tjt||jƒƒ
Sd
S(sAHuman-readable ID which can be used for bash completion.
        N(t	NAME_ATTRRmtHUMAN_IDRtto_slugRHR#(
R((sP/home/tvault/.virtenv/lib/python2.7/site-packages/cinderclient/apiclient/base.pythuman_idä
s

cCs‚x{|
jƒD]m\}}yt
|||ƒ
Wn=tk
rC


q
n*tk
rl


t
|tj|ƒ
|ƒ
n
X||j|<q
WdS(
N(RLtsetattrRtUnicodeEncodeErrorRtsafe_encodeR(RR„R†t
v((sP/home/tvault/.virtenv/lib/python2.7/site-packages/cinderclient/apiclient/base.pyRۓ
s








cCsy|
|jks|
|j
krP|jƒsA|jƒ
|j|
ƒ
St|
ƒ
‚
n%|
|jkrj|j|
S|j
|
SdS(
N(RmRt	is_loadedRt__getattr__R(RR†((sP/home/tvault/.virtenv/lib/python2.7/site-packages/cinderclient/apiclient/base.pyR•÷
s






c


Cs
|jj
S(
N(R~tapi_version(
R((sP/home/tvault/.virtenv/lib/python2.7/site-packages/cinderclient/apiclient/base.pyR–sc
CsU|jt
ƒ

t|jd
ƒs#dS|jj|jƒ
}
|
rQ|j|
jƒ

ndS(NR(t
set_loadedR'R‚R~RRR€R(Rtnew((sP/home/tvault/.virtenv/lib/python2.7/site-packages/cinderclient/apiclient/base.pyRs




cCs9t|
t
ƒstSt|
|jƒs)tS|j|
jkS(
N(R[R\tNotImplementedRŠR=R(Rtother((sP/home/tvault/.virtenv/lib/python2.7/site-packages/cinderclient/apiclient/base.pyt__eq__s




cCs|j|
ƒ
S(
N(
R›(RRš((sP/home/tvault/.virtenv/lib/python2.7/site-packages/cinderclient/apiclient/base.pyt__ne__s
c


Cs|jS(
N(
R(
R((sP/home/tvault/.virtenv/lib/python2.7/site-packages/cinderclient/apiclient/base.pyR”s
cCs
|
|_dS(
N(
R(Rtval((sP/home/tvault/.virtenv/lib/python2.7/site-packages/cinderclient/apiclient/base.pyR— s
c

Cstj
|jƒ
S(
N(RYtdeepcopyR(
R((sP/home/tvault/.virtenv/lib/python2.7/site-packages/cinderclient/apiclient/base.pytto_dict#s
N(RRRR=RRŒR#RRrR|RR€R•R–RR›RœR”R—RŸ(((sP/home/tvault/.virtenv/lib/python2.7/site-packages/cinderclient/apiclient/base.pyR\Â
s
			
	
				tListWithMetac
BseZ
d„ZRS(
cCs1tt
|ƒj|
ƒ

|jƒ
|j|ƒ

dS(
N(RR RRuRy(RR R2((sP/home/tvault/.virtenv/lib/python2.7/site-packages/cinderclient/apiclient/base.pyR(s



(RRR(((sP/home/tvault/.virtenv/lib/python2.7/site-packages/cinderclient/apiclient/base.pyR 's
tDictWithMetac
BseZ
d„ZRS(
cCs1tt
|ƒj|
ƒ

|jƒ
|j|ƒ

dS(
N(RR¡RRuRy(RR R2((sP/home/tvault/.virtenv/lib/python2.7/site-packages/cinderclient/apiclient/base.pyR/s



(RRR(((sP/home/tvault/.virtenv/lib/python2.7/site-packages/cinderclient/apiclient/base.pyR¡.s
t
TupleWithMetac
BseZ
d„Zd
„ZRS(cCstt
|ƒj||
ƒS(
N(RR¢t__new__(R
R R2((sP/home/tvault/.virtenv/lib/python2.7/site-packages/cinderclient/apiclient/base.pyR£6s
cCs|jƒ
|j
|ƒ

dS(
N(RuRy(RR R2((sP/home/tvault/.virtenv/lib/python2.7/site-packages/cinderclient/apiclient/base.pyR9s


(RRR£R(((sP/home/tvault/.virtenv/lib/python2.7/site-packages/cinderclient/apiclient/base.pyR¢5s
	(RRPRYtrequestsRtsixtsix.moves.urllibR
tcinderclient.apiclientRt
oslo_utilsRRR	tobjectR
Rt
add_metaclasstABCMetaR>RRRfRsR\R?R tdictR¡ttupleR¢(((sP/home/tvault/.virtenv/lib/python2.7/site-packages/cinderclient/apiclient/base.pyt<module>s(




	x
+‡$e