ó
ˍEYc@sàdZd
dl
Z
d
dlZd
dlZd
dlZd
dlZd
dlZd
dlm	Z
d
dl
mZ
d
dl
mZ
d
dl
mZ
ejeƒ
Zddd	d
„Zd„Zd„Zd
„Zd„Zd„ZdS(sUtilities and helper functions.iÿÿÿÿN(
tlog(
tencodeutils(
tstrutils(
t
_i
iicsn‡f
d
†‰‡‡fd†‰‡f
d†‰
ˆdkrUtt
dƒ
ˆƒ
‚
n‡‡
‡fd†}|S(Nc

s
t|ˆƒS(
N(
t
isinstance(
t
e(
t
exceptions(sC/home/tvault/.virtenv/lib/python2.7/site-packages/os_brick/utils.pyt_retry_on_exception"s
cs5ˆ|}td
ˆ
|ƒ}t
jd|ƒ
|dS(NisSleeping for %s secondsg@@(tmaxtLOGtdebug(tprevious_attempt_numbertdelay_since_first_attempt_mstexptwait_for(tbackoff_ratetinterval(sC/home/tvault/.virtenv/lib/python2.7/site-packages/os_brick/utils.pyt_backoff_sleep%s




cs4|
d
}tj
d|ƒ
tj
d|ƒ
|ˆkS(Ng@@sFailed attempt %ss Have been at this for %s seconds(R	R
(RRtdelay_since_first_attempt(
tretries(sC/home/tvault/.virtenv/lib/python2.7/site-packages/os_brick/utils.pyt_print_stop+s




	

i
s;Retries must be greater than or equal to 1 (received: %s). c
s+tj
ˆƒ
‡
‡‡‡fd
†ƒ
}
|
S(Ncs1tj
d
ˆdˆdˆ
ƒ}|jˆ||
Ž
S(Ntretry_on_exceptiont	wait_funct	stop_func(tretryingtRetryingtcall(targstkwargst
r(RRRt
f(sC/home/tvault/.virtenv/lib/python2.7/site-packages/os_brick/utils.pyt_wrapper8s

	
(tsixtwraps(RR(RRR(
RsC/home/tvault/.virtenv/lib/python2.7/site-packages/os_brick/utils.pyt
_decorator6s'(t
ValueErrorR(RRRRR"((RRRRRRRsC/home/tvault/.virtenv/lib/python2.7/site-packages/os_brick/utils.pytretry s


cCs<|jƒ}|
jƒ}|d
kr(t
S||kr8t
StS(NtALL(tuppertTruetFalse(tcurrent_platformtconnector_platformtcurr_ptconn_p((sC/home/tvault/.virtenv/lib/python2.7/site-packages/os_brick/utils.pytplatform_matchesDs




cCsH|jƒ}|
jƒ}|d
kr(t
S||ks@||krDt
StS(NR%(R&R'R((t
current_ostconnector_ostcurr_ostconn_os((sC/home/tvault/.virtenv/lib/python2.7/site-packages/os_brick/utils.pyt
os_matchesQs





cCs_t|ƒ
t
k	r!td
ƒ
‚
nt|
ƒ
t
k	rBtdƒ
‚
n|jƒ}|j|
ƒ

|S(s#Try to safely merge 2 dictionaries.sdict1 is not a dictionarysdict2 is not a dictionary(ttypetdictt	Exceptiontcopytupdate(tdict1tdict2tdict3((sC/home/tvault/.virtenv/lib/python2.7/site-packages/os_brick/utils.pyt
merge_dict_s





c
s.ˆj‰
t
jˆƒ
‡‡
fd
†ƒ
}
|
S(sŠ
Trace calls to the decorated function.

    This decorator should always be defined as the outermost decorator so it
    is defined last. This is important so it does not interfere
    with other decorators.

    Using this decorator on a function will cause its execution to be logged at
    `DEBUG` level with arguments, return values, and exceptions.

    :returns: a function decorator
    c
sÚ
t|ƒ
d
kr|d
}n|
j
ddƒ}|r[t|dƒr[tj|jƒ
}nt}|jt	j
ƒ
s€ˆ||
ŽStjˆ||
Ž
}|j
diˆ
d6tjtj|ƒ
ƒ
d6ƒ
tjƒd}yˆ||
Ž}Wn[tk
rE

}
tttjƒdƒ
ƒ
|}|j
diˆ
d6|d	6|d
6ƒ
‚n
Xtttjƒdƒ
ƒ
|}t|tƒr‡
tj|ƒ
}	n*t|tjƒr«
tj|ƒ
}	n|}	|j
diˆ
d6|d	6|	d6ƒ
|S(
Nitselft
__module__s==> %(func)s: call %(all_args)rtfunctall_argsiès,<== %(func)s: exception (%(time)dms) %(exc)rttimetexcs,<== %(func)s: return (%(time)dms) %(result)rtresult(tlentgettNonethasattrtloggingt	getLoggerR=R	tisEnabledFort
py_loggingtDEBUGtinspecttgetcallargsR
Rt
mask_passwordR t	text_typeR@R5tinttroundRR4tmask_dict_passwordtstring_types(
RRt
maybe_selftloggerR?t
start_timeRBRAt
total_timetmask_result(Rt	func_name(sC/home/tvault/.virtenv/lib/python2.7/site-packages/os_brick/utils.pyttrace_logging_wrapperzsD





	






 
	





 


	




(t__name__t	functoolsR!(RRZ((RRYsC/home/tvault/.virtenv/lib/python2.7/site-packages/os_brick/utils.pyttraceks
	!2c

Cs:tj
rtj|ƒ
St|tƒr2|jd
ƒ
S|SdS(sðConvert to native string.

    Convert bytes and Unicode strings to native strings:

    * convert to bytes on Python 2:
      encode Unicode using encodeutils.safe_encode()
    * convert to Unicode on Python 3: decode bytes from UTF-8
    sutf-8N(R tPY2R
tto_utf8Rtbytestdecode(
ttext((sC/home/tvault/.virtenv/lib/python2.7/site-packages/os_brick/utils.pytconvert_str¯s
		



(t__doc__R\RLRGRJRR R@toslo_logRt
oslo_utilsR
Rt
os_brick.i18nRRHR[R	R$R-R2R;R]Rc(((sC/home/tvault/.virtenv/lib/python2.7/site-packages/os_brick/utils.pyt<module>
s"






$	
			D