�
�d{Tc@
s�dZd
dl
mZ
dZdddddfZd
d	lZd
d	lZd
d	lZd
d
lm	Z	m
Z

d
dlmZ
d
dlm
Z

d
d
lmZ
d
dlmZmZmZ
d
dlmZ
d
dlmZ
d
dlmZmZ
d
dlmZ
ejZgZ de!f
d��YZ"d�Z#d�Z$d�Z%d�Z&d�Z'd�Z(d�Z)d�Z*d�Z+d�Z,d�Z-d �Z.ied!6e/d"6e0d#6e)d$6ed%6e*d&6ej1d'6e&d(6e'd)6e'd*6e(d+6e+d,6e,d-6e-d.6e.d/6e$d06e%d16Z2d2�Z3d3d4�
Z4d5�Z5d6�Z6ie5d!6e4d,6Z7x*e2j8�D]Z9e7j:e9e6e9�
�
qVWd7�Z;d8d9�
Z<ed:�
e<�
Z=d;�Z>d<�Z?d=�Z@d>�ZAeBeBd?�ZCd@�ZDeCZEeBeBdA�ZFdeGf
dB��YZHdCeGf
dD��YZIdeGf
dE��YZJdeHeJfdF��YZKdeKf
dG��YZLdeGf
dH��YZMdI�ZNeBdJ�
ZOd	S(KsEClasses to handle advanced configuration in simple to complex applications.

Allows to load the configuration from a file or from command line
options, to generate a sample configuration file or to display
program's usage. Fills the gap between optik/optparse and ConfigParser
by adding data types (which are also available as a standalone optik
extension in the `optik_ext` module).


Quick start: simplest usage
---------------------------

.. python ::

  >>> import sys
  >>> from logilab.common.configuration import Configuration
  >>> options = [('dothis', {'type':'yn', 'default': True, 'metavar': '<y or n>'}),
  ...            ('value', {'type': 'string', 'metavar': '<string>'}),
  ...            ('multiple', {'type': 'csv', 'default': ('yop',),
  ...                          'metavar': '<comma separated values>',
  ...                          'help': 'you can also document the option'}),
  ...            ('number', {'type': 'int', 'default':2, 'metavar':'<int>'}),
  ...           ]
  >>> config = Configuration(options=options, name='My config')
  >>> print config['dothis']
  True
  >>> print config['value']
  None
  >>> print config['multiple']
  ('yop',)
  >>> print config['number']
  2
  >>> print config.help()
  Usage:  [options]

  Options:
    -h, --help            show this help message and exit
    --dothis=<y or n>
    --value=<string>
    --multiple=<comma separated values>
                          you can also document the option [current: none]
    --number=<int>

  >>> f = open('myconfig.ini', 'w')
  >>> f.write('''[MY CONFIG]
  ... number = 3
  ... dothis = no
  ... multiple = 1,2,3
  ... ''')
  >>> f.close()
  >>> config.load_file_configuration('myconfig.ini')
  >>> print config['dothis']
  False
  >>> print config['value']
  None
  >>> print config['multiple']
  ['1', '2', '3']
  >>> print config['number']
  3
  >>> sys.argv = ['mon prog', '--value', 'bacon', '--multiple', '4,5,6',
  ...             'nonoptionargument']
  >>> print config.load_command_line_configuration()
  ['nonoptionargument']
  >>> print config['value']
  bacon
  >>> config.generate_config()
  # class for simple configurations which don't need the
  # manager / providers model and prefer delegation to inheritance
  #
  # configuration values are accessible through a dict like interface
  #
  [MY CONFIG]

  dothis=no

  value=bacon

  # you can also document the option
  multiple=4,5,6

  number=3

  Note : starting with Python 2.7 ConfigParser is able to take into
  account the order of occurrences of the options into a file (by
  using an OrderedDict). If you have two options changing some common
  state, like a 'disable-all-stuff' and a 'enable-some-stuff-a', their
  order of appearance will be significant : the last specified in the
  file wins. For earlier version of python and logilab.common newer
  than 0.61 the behaviour is unspecified.

i����(
tprint_functionsrestructuredtext entOptionsManagerMixIntOptionsProviderMixIntConfigurationMixInt
Configurationt#OptionsManager2ConfigurationAdapterN(texistst
expanduser(
tcopy(
twarn(
tstring_types(trangetconfigparsertinput(
t
str_encode(
t
deprecated(tnormalize_texttunquote(
t	optik_exttUnsupportedActionc
B
seZ
dZRS(
sBraised by set_option when it doesn't know what to do for an action(t__name__t
__module__t__doc__(((sM/opt/alt/python27/lib/python2.7/site-packages/logilab/common/configuration.pyR�s
cC
s=|pt|
d
d�}|s9ddl}|j�}n|S(Ntencodingi����(tgetattrtNonetlocaletgetpreferredencoding(RtstreamR((sM/opt/alt/python27/lib/python2.7/site-packages/logilab/common/configuration.pyt
_get_encoding�s





cC
s=||d
kr9d}tj
||
||d
f�
�
n|S(sFvalidate and return a converted value for option of type 'choice'
    tchoicess-option %s: invalid value: %r, should be in %s(RtOptionValueError(toptdicttnametvaluetmsg((sM/opt/alt/python27/lib/python2.7/site-packages/logilab/common/configuration.pytchoice_validator�s

#
cC
se|d
}tj
d|
|�}x?|D]7}||kr&d}tj||
||f�
�
q&q&W|S(sFvalidate and return a converted value for option of type 'choice'
    Rs-option %s: invalid value: %r, should be in %sN(Rt	check_csvRR(R R!R"RtvaluesR#((sM/opt/alt/python27/lib/python2.7/site-packages/logilab/common/configuration.pytmultiple_choice_validator�s






#
cC
stj
d
|
|�S(sCvalidate and return a converted value for option of type 'csv'
    N(RR%R(R R!R"((sM/opt/alt/python27/lib/python2.7/site-packages/logilab/common/configuration.pyt
csv_validator�scC
stj
d
|
|�S(sBvalidate and return a converted value for option of type 'yn'
    N(Rtcheck_ynR(R R!R"((sM/opt/alt/python27/lib/python2.7/site-packages/logilab/common/configuration.pytyn_validator�scC
stj
d
|
|�S(sEvalidate and return a converted value for option of type 'named'
    N(Rtcheck_namedR(R R!R"((sM/opt/alt/python27/lib/python2.7/site-packages/logilab/common/configuration.pytnamed_validator�scC
stj
d
|
|�S(s8validate and return a filepath for option of type 'file'N(Rt
check_fileR(R R!R"((sM/opt/alt/python27/lib/python2.7/site-packages/logilab/common/configuration.pytfile_validator�scC
stj
d
|
|�S(s<validate and return a valid color for option of type 'color'N(Rtcheck_colorR(R R!R"((sM/opt/alt/python27/lib/python2.7/site-packages/logilab/common/configuration.pytcolor_validator�scC
stj
d
|
|�S(s:validate and return a string for option of type 'password'N(Rtcheck_passwordR(R R!R"((sM/opt/alt/python27/lib/python2.7/site-packages/logilab/common/configuration.pytpassword_validator�scC
stj
d
|
|�S(sBvalidate and return a mx DateTime object for option of type 'date'N(Rt
check_dateR(R R!R"((sM/opt/alt/python27/lib/python2.7/site-packages/logilab/common/configuration.pytdate_validator�scC
stj
d
|
|�S(s;validate and return a time object for option of type 'time'N(Rt
check_timeR(R R!R"((sM/opt/alt/python27/lib/python2.7/site-packages/logilab/common/configuration.pyttime_validator�scC
stj
d
|
|�S(s9validate and return an integer for option of type 'bytes'N(Rtcheck_bytesR(R R!R"((sM/opt/alt/python27/lib/python2.7/site-packages/logilab/common/configuration.pytbytes_validator�ststringtinttfloattfiletfonttcolortregexptcsvtyntbooltnamedtpasswordtdatettimetbytestchoicetmultiple_choicecC
s�|tkrt
d
|�
�
nyt||
||�SWn_tk
r�


yt||�
SWq�tjk
rr


�q�


tjd|||f�
�
q�Xn
XdS(NsUnsupported type "%s"s"%s value (%r) should be of type %s(t
VALIDATORSt	Exceptiont	TypeErrorRR(topttypeR toptionR"((sM/opt/alt/python27/lib/python2.7/site-packages/logilab/common/configuration.pyt_call_validator�s











	
s	password:cC
sSd
dlm}
x<t
rN||
�
}|d�
}||krA|Std�

qWdS(Ni����(
tgetpasss	confirm: spassword mismatch, try again(RPtTruetprint(R tquestionRPR"tvalue2((sM/opt/alt/python27/lib/python2.7/site-packages/logilab/common/configuration.pytinput_password�s

	




cC
st|
�
j
�}|pdS(
N(R
tstripR(R RSR"((sM/opt/alt/python27/lib/python2.7/site-packages/logilab/common/configuration.pytinput_string
s

c

s�f
d
�}
|
S(Nc
s�x�tr�t
|
�
}|j�s%dSyt�|d|�SWqtjk
r�
}
t|�
jd
d�dj�}t	d|�

qXqWdS(Nt
:i
i����s
bad value: %s(
RQR
RVRRORRtstrtsplitRR(R RSR"texR#(
RM(sM/opt/alt/python27/lib/python2.7/site-packages/logilab/common/configuration.pytinput_validator

s
	






"
((RMR\((
RMsM/opt/alt/python27/lib/python2.7/site-packages/logilab/common/configuration.pyt_make_input_function	
s

cC
s�|jdks|jr |
jS|
jd
d}y|jjj|}Wntk
ra


d}nFX|j|�
}|j	||�}t
|j||�}t||�}|t
jks�|r�|j}n|
jj|jt|�
�S(s�monkey patch OptionParser.expand_default since we have a particular
    way to handle defaults to avoid overriding values in the configuration
    file
    iiN(tparserRtdefault_tagthelpt
_long_optstoptions_managert_all_optionstKeyErrortget_option_deftoption_attrnameRtconfigtformat_option_valueRt
NO_DEFAULTtNO_DEFAULT_VALUEtreplaceRY(tselfRNtoptnametproviderR"R ((sM/opt/alt/python27/lib/python2.7/site-packages/logilab/common/configuration.pytexpand_default 
s













tcC
s6y|
d
}Wntk
r"


|SXt
||
||�S(s�return a validated value for an option according to its type

    optional argument name is only used for error message formatting
    ttype(RdRO(R"R R!t_type((sM/opt/alt/python27/lib/python2.7/site-packages/logilab/common/configuration.pyt	_validate6
s




s([0.60] convert() was renamed _validate()c
C
s=g|j�D]}
|
j
�^q
}d
dtjj|�
S(sreturn string as a comments# s%s# (t
splitlinesRVtostlineseptjoin(R9tlinetlines((sM/opt/alt/python27/lib/python2.7/site-packages/logilab/common/configuration.pytcommentE
s%
c
C
s�|s
d
S|t|�
kr$d|St|�
}t
|d�\}
}|rSd|St
|
d�\}}|rvd|
St
|d�\}}|r�d|Sd|S(	Nt
0s%.2fsi<s%sss%sminis%shs%sd(R:tdivmod(R"tnbmintnbsectnbhourtnbmin_tnbdaytnbhour_((sM/opt/alt/python27/lib/python2.7/site-packages/logilab/common/configuration.pytformat_timeJ
s














c
C
s�|s
d
S|t|�
kr$d|St|�
}d}
xCd
D];}t
|d�\}}|rld	||
fS|}
|}q=Wd	||fS(NR{s%.2fBt
BtKBtMBtGBtTBis%s%s(R�R�R�R�(R:R|(R"tprevunittunittnexttremain((sM/opt/alt/python27/lib/python2.7/site-packages/logilab/common/configuration.pytformat_bytes[
s














cC
sQ
t|
t
tf�r'd
j|
�
}
n&
t|
t�rqd
jg|
j�D]\}}d||f^qI�
}
n�t|
d�r�|
j}
n�|jd�
dkr�|
r�dp�d}
n�t|
t	�r�|
j
�r�d|
}
no|jd�
d	kr
t|
ttt
f�r
t|
�
}
n3|jd�
d
krM
t|
d�rM
t|
�
}
n|
S(s5return the user input's value from a 'compiled' valuet
,s%s:%stmatchRqRAtyestnos'%s'RFRGt__int__(t
isinstancetlistttupleRwtdicttitemsthasattrtpatterntgetR
tisspaceR;R:tlongR�R�(R R"t
kt
v((sM/opt/alt/python27/lib/python2.7/site-packages/logilab/common/configuration.pyRhj
s


;






-

$

cC
s_t||�}|r7t
tt|�
|�d
|�


nt
d|
d
|�


t|||�
dS(s.format an options section using the INI formatR<s[%s]N(RRRt_encodeRzt
ini_format(RtsectiontoptionsRtdoc((sM/opt/alt/python27/lib/python2.7/site-packages/logilab/common/configuration.pytini_format_section}
s


"

cC
s�x�|
D]�\}}}t||�}|j
d
�
}|r{t|dddd�
}td|�

tt||�d|�


n
td|�

|d	kr�td|d|�


qt||�j�}td||fd|�


qWd	S(
s#format options using the INI formatR`tline_leniOtindents# R<s#%s=s%s=%sN(RhR�RRRR�RRV(RR�RRmR R"R`((sM/opt/alt/python27/lib/python2.7/site-packages/logilab/common/configuration.pyR��
s










c	C
sF
t||�}|
r<t
d
|
dt|
�
fd|�


n|r}t
tt|dddd�
|�d|�


t
d|�

nx�|D]�\}}}|jd�
}t
d	|d|�


|r�t|dddd
�
}t
t||�d|�


n|r�tt||�|�}t
d|�

t
d|jdd
�d|�


q�q�WdS(s8format an options section using as ReST formatted outputs%s
%st
'R<R�iOR�RpR`s:%s:s  s  Default: ``%s``s`` s```` ``N(RRRtlenR�RR�RhRk(	RR�R�RR�RmR R"R`((sM/opt/alt/python27/lib/python2.7/site-packages/logilab/common/configuration.pytrest_format_section�
s 

'

+











cB
s
eZ
dZddd
d�Zddd�Zed�
Zd�Zd�Z	d�Z
d	�Zd
�Zdddd�Z
ddd
�Zd�Zdd�
Zdd�
Zdd
dd�Zd�Zd�Zdd�
Zd
d�
Zd�Zd�Zd
d�
ZRS(s`MixIn to handle a configuration from both a configuration file and
    command line options
    icC
sb||_|j
|
d
|�


g|_i|_i|_i|_t�|_||_d|_	dS(Ntversioni(
tconfig_filet
reset_parserstoptions_providersRct_short_optionst_nocallback_optionsR�t	_mygroupstquiett	_maxlevel(RltusageR�R�R�((sM/opt/alt/python27/lib/python2.7/site-packages/logilab/common/configuration.pyt__init__�
s
	
		
	
	
	
RpcC
sRtj
�|_tjd
|
d|�|_||j_t|jjj	�
|_
dS(NR�R�(tcptConfigParsertcfgfile_parserRtOptionParsertcmdline_parserRbtsettoption_classtATTRSt_optik_option_attrs(RlR�R�((sM/opt/alt/python27/lib/python2.7/site-packages/logilab/common/configuration.pyR��
s

cC
s�
|
jd
k
st
d�
�
x]tt|j�
�
D]6}|
j|j|jkr1|jj||
�
Pq1q1W|jj|
�

g|
jD]}d|dkr�|^q�}t|
dd�}|r�|r�|j	|
j
j�|
j||
�
n0x-|D]%\}}|j
|
|j||�
q�Wxt|D]l\}	}
|	j�}	g|
jD].}|djdd�j�|	krC
|^qC
}|j	|	|
||
�
q!
WdS(	sregister an options provideris!provider's priority can't be >= 0tgroupi
t
option_groupsRpN((tprioritytAssertionErrorRR�R�tinserttappendR�Rtadd_option_groupR!tupperRtadd_optik_optionR�R�(RlRnt	own_groupt
iRNtnon_group_spec_optionstgroupstoptR tgnametgdoctgoptions((sM/opt/alt/python27/lib/python2.7/site-packages/logilab/common/configuration.pytregister_options_provider�
s&















.
cC
s�|st�
|
|j
kr+|j
|
}nftj|jd
|
j��

}|jj|�

|j|_||j
|
<|
dkr�|jj	|
�

nx*|D]"\}}|j
||||�
q�WdS(s9add an option group including the listed options
        ttitletDEFAULTN(R�R�RtOptionGroupR�t
capitalizeR�tlevelR�tadd_sectionR�(Rlt
group_nameR�R�RnR�R�R ((sM/opt/alt/python27/lib/python2.7/site-packages/logilab/common/configuration.pyR��
s







cC
s�d
|kr3td|t
�
|jd
�
|d<n|j|
||�\}}|j||�}|
|j|<t|j|jp�d�|_dS(Nt
inputlevelsJ[0.50] "inputlevel" in option dictionary for %s is deprecated, use "level"R�i(	R	tDeprecationWarningtpoptoptik_optiont
add_optionRctmaxR�R�(RlRntoptikcontainerR�R targsRN((sM/opt/alt/python27/lib/python2.7/site-packages/logilab/common/configuration.pyR��
s








cC
s4
t|�
}i}d
|kr.||j
|
<nd|d
<|j|d<d|kr�d|kr�|jd�
dk	r�|d
dkr�|dcd7<n|d=ndt|�
g
}d	|kr�||j|d	<|jd
|d	�

|d	=nx9t|j	��
D]%}||j
kr

|j|�

q

q

W||fS(
sjget our personal option definition and return a suitable form for
        use with optik/optparse
        tactiontcallbacktdefaultR`t
store_truetstore_falses [current: %default]s--tshortt
-N(R�R�(RR�tcb_set_provider_optionR�RRYR�R�R�tkeysR�R�(RlRnR�R tothersR�tkey((sM/opt/alt/python27/lib/python2.7/site-packages/logilab/common/configuration.pyR��
s*




















cC
sV|jd
�
r|d}n|j
|d}|dkrBd}n|j||�
dS(s!optik callback for option settings--ii
N(t
startswithR�Rtglobal_set_option(RlRNR�R"R^((sM/opt/alt/python27/lib/python2.7/site-packages/logilab/common/configuration.pyR�s

	
cC
s|j|
j
|
|�
d
S(s)set option on the correct option providerN(Rct
set_option(RlR�R"((sM/opt/alt/python27/lib/python2.7/site-packages/logilab/common/configuration.pyR�)scC
s`
i}g}x�|jD]�}x�|j
�D]�\}}|dkrM|j}n||kr_q)ng|D]3\}	}
}|
jd
�
dk	rf|	|
|f^qf}|s�q)n||kr�|j|�

n|j|g�}||7}q)WqW|
p�tj}
t	||
�}t
}
xJ|D]B}|
r5
tdd|
�


nt|
|j
�|||�
t}
q
WdS(srwrite a configuration file according to the current configuration
        into the given stream or stdout
        Rqs

R<N(R�toptions_by_sectionRR!R�R�t
setdefaulttsyststdoutRtFalseRRtformat_sectionR�RQ(RlRtskipsectionsRR�tsectionsRnR�R�t
nt
dR�t
alloptionstprinted((sM/opt/alt/python27/lib/python2.7/site-packages/logilab/common/configuration.pytgenerate_config-s2








*















i
cC
sN|j�
z2t
j|j|
|d
|p.tjd|j�
Wd|j�
XdS(s_write a man page for the current configuration into the given
        stream or stdout
        RR�N(t_monkeypatch_expand_defaultRtgenerate_manpageR�R�R�R�t_unmonkeypatch_expand_default(RltpkginfoR�R((sM/opt/alt/python27/lib/python2.7/site-packages/logilab/common/configuration.pyR�Ks




c
C
s"x|jD]}
|
j
�
q
Wd
S(s-initialize configuration using default valuesN(R�t
load_defaults(RlRn((sM/opt/alt/python27/lib/python2.7/site-packages/logilab/common/configuration.pytload_provider_defaultsYs
cC
s|j|
�

|j
�
d
S(s load the configuration from fileN(tread_config_filetload_config_file(RlR�((sM/opt/alt/python27/lib/python2.7/site-packages/logilab/common/configuration.pytload_file_configuration^s

c
s�
d
}x�|�jk
r�dj
dg
|�
d}|�jkrEPn|�f
d�
}ddj
dg
|�
}id	d
6|d	6|d6}�jd}�j|�j||�
|j||ff
7_|d
7}q	W|
dkr��j}
n|
dk	r
t	|
�
}
n|
r�
t
|
�
r�
�j}|j|
g
�

xo|j
j�D]5\}	}
|	j�rF
|
rF
|
|j
|	j�<qF
qF
Wn&�js�
d
}t|dtj�


dSdS(srread the configuration file but do not load it (i.e. dispatching
        values to each options provider)
        i
R�R�s-helpc
s$t�j
|�
�

tjd
�

dS(Ni(RRR`R�texit(RNR�tvalt
pR�(
Rl(sM/opt/alt/python27/lib/python2.7/site-packages/logilab/common/configuration.pythelpfuncls

s%s verbose help.t
 tmoreR�R�R`is1No config file found, using default configurationR<N(R�RwRcR�R�R�R�RR�RRR�treadt	_sectionsR�tisupperR�R�RRR�tstderr(RlR�t	helplevelR�R
thelpmsgR RnR^tsectR&R#((
RlsM/opt/alt/python27/lib/python2.7/site-packages/logilab/common/configuration.pyR
cs6


















	



	


cC
s�|
dk	r|
j
�}
nxt|jD]i}x`|j�D]R\}}}|
dk	re||
kreq8nd
|krwq8n|j|||�
q8Wq%W|dk	r�|j|�

ndS(sointeractively get configuration values by asking to the user and generate
        a configuration file
        RqN(RR�R�tall_optionstinput_optionR�(RltonlysectionR�RRnR�RNR ((sM/opt/alt/python27/lib/python2.7/site-packages/logilab/common/configuration.pytinput_config�s







c
C
su|j}
xe|
j
�D]W}xN|
j|�
D]=\}}y|j||�
Wq,ttfk
rh


q,q,Xq,WqWd
S(sddispatch values previously read from a configuration file to each
        options provider)
        N(R�R�R�R�RdtOptionError(RlR^R�RNR"((sM/opt/alt/python27/lib/python2.7/site-packages/logilab/common/configuration.pyR

�s	




c
K
sPxI|
j�D];\}}|j
d
d�}|j|}|j||�
q
WdS(s=override configuration according to given parameters
        t
_R�N(R�RkRcR�(RltkwargsR�t	opt_valueRn((sM/opt/alt/python27/lib/python2.7/site-packages/logilab/common/configuration.pytload_configuration�s



cC
s�|j�
z�|
dkr)tjd
}
nt|
�
}
|jjd|
�
\}}
xn|jj�D]]}|j	}xK|j
j�D]:}t||d�}|dkr�qnt|||�
qWq`W|
SWd|j
�
XdS(sioverride configuration according to command line parameters

        return additional arguments
        i
R�N(R�RR�targvR�R�t
parse_argsR�R�Rgt__dict__RtsetattrR�(RlR�R�RnRgtattrR"((sM/opt/alt/python27/lib/python2.7/site-packages/logilab/common/configuration.pytload_command_line_configuration�s






	





cC
sVtj
|jd
|
j�d|�
}||_t|j|�|_|jj|�

dS(s,add a dummy option section for help purpose R�tdescriptionN(RR�R�R�R�R�R�R�(RlR�R
R�R�((sM/opt/alt/python27/lib/python2.7/site-packages/logilab/common/configuration.pytadd_help_section�s

	
	

c

C
s7ytj
j|_ttj
_Wntk
r2


n
XdS(
N(Rt
HelpFormatterRot+_OptionsManagerMixIn__expand_default_backuptAttributeError(
Rl((sM/opt/alt/python27/lib/python2.7/site-packages/logilab/common/configuration.pyR��s




c

C
s(tt
jd
�r$|jt
j_ndS(NRo(R�RR!
R"
Ro(
Rl((sM/opt/alt/python27/lib/python2.7/site-packages/logilab/common/configuration.pyR��scC
s<|
|jj
_|j�
z|jj�SWd
|j�
Xd
S(s.return the usage string for available options N(R�t	formattertoutput_levelR�tformat_helpR�(RlR�((sM/opt/alt/python27/lib/python2.7/site-packages/logilab/common/configuration.pyR`�s




N((RRRRR�R�RQR�R�R�R�R�R�R�R�R�R
R
R
R

R
R
R 
R�R�R`(((sM/opt/alt/python27/lib/python2.7/site-packages/logilab/common/configuration.pyR
�
s,		
		
		#	
				tMethodc
B
s)eZ
dZd
�Zd�Zd�ZRS(s�used to ease late binding of default method (so you can define options
    on the class using default methods on the configuration instance)
    cC
s|
|_d|_dS(
N(tmethodRt_inst(Rltmethname((sM/opt/alt/python27/lib/python2.7/site-packages/logilab/common/configuration.pyR��s
	
cC
s|jd
kr|
|_nd
S(sbind the method to its instanceN(R)
R(Rltinstance((sM/opt/alt/python27/lib/python2.7/site-packages/logilab/common/configuration.pytbind�s
c
O
s1|jst
d
�
�
t|j|j�|
|�S(Nsunbound method(R)
R�RR(
(RlR�R
((sM/opt/alt/python27/lib/python2.7/site-packages/logilab/common/configuration.pyt__call__�s

(RRRR�R,
R-
(((sM/opt/alt/python27/lib/python2.7/site-packages/logilab/common/configuration.pyR'
�s
		cB
s�eZ
dZd
ZdZdZdZd�Zd�Zdd�
Z
dd�
Zed�
e�
Z
d	�Zddd
�Zdd�
Zd
�Zd�Zd�Zdd�
ZRS(s-Mixin to provide options to an OptionsManageri����R�ic
C
s�tj
�|_x�|jD]�}
y|
\}
}Wn!tk
rR


td
|
�
�
n
Xt|jd�
t�r|dj	|�

qt|jd�
t�r|dj	|�

qqW|j
�
dS(NsBad option: %rR�R�(RtValuesRgR�t
ValueErrorRKR�R�R'
R,
R�(RlRNR ((sM/opt/alt/python27/lib/python2.7/site-packages/logilab/common/configuration.pyR�s











c
C
svxo|jD]d\}
}|j
d
�
}|dkr
|j|
|�}|tkrUq
n|j|
|||�
q
q
WdS(s,initialize the provider using default valuesR�R�N(R�R�toption_defaulttREQUIREDR�(RlR�R R�R�((sM/opt/alt/python27/lib/python2.7/site-packages/logilab/common/configuration.pyR�s




cC
sI|dkr|j
|
�
}n|jd
�
}t|�
rE|�}n|S(s&return the default value for an optionR�N(RReR�tcallable(RlR�R R�((sM/opt/alt/python27/lib/python2.7/site-packages/logilab/common/configuration.pyR0
s




cC
s:|dkr|j
|
�
}n|jd
|
jdd��S(s6get the config attribute corresponding to opt
        tdestR�R
N(RReR�Rk(RlR�R ((sM/opt/alt/python27/lib/python2.7/site-packages/logilab/common/configuration.pyRf%s

sJ[0.60] OptionsProviderMixIn.option_name() was renamed to option_attrname()cC
st|j
|j|
�
d
�S(s*get the current value for the given optionN(RRgRfR(RlR�((sM/opt/alt/python27/lib/python2.7/site-packages/logilab/common/configuration.pytoption_value-scC
sL|dkr|j
|
�
}n|dk	r?t|||
�}n|dkr`|jd
d�}n|jd�
dkr�|j|
|�}t|j|d�}|r�|j|�

|}q�n|dkr�t|j|j|
|�|�
n_
|d
kr
t|j|j|
|�d�
n1
|dkrE
t|j|j|
|�d	�
n
|d
kr|j|
|�}
t|j|
d�}|dkr�
t	|t
tf�r�
|}n"|dk	r�
g}|j|�

nt|j|
|�
qHt	|t�rt|j|
||f
�
qH|j|�

n2|dkr<|dd|
|d�
nt
|�
�
dS(sHmethod called to set an option (registered in the options list)
        R�tstoreRqRCR�tcountiR�i
R�R�N(R�R6
(RReRsR�RfRRgtupdateR
R�R�R�R�R(RlR�R"R�R Rmtcurrentvaluet_list((sM/opt/alt/python27/lib/python2.7/site-packages/logilab/common/configuration.pyR�1sD













"

"

"





	







iccC
s1
|j|
|�}|t
kr'd
}nT|jdd�|krCdS|ddks_|dkrhd}ndt||�}td|
�

t|jd	�
p�|
�

t|d}|||�}x4|t
kr�|r�td
�

||d|
�}q�W|dkr
|dk	r
|}n|j|
|d|�

dS(
Ns(required): R�iRqRDs: s(default: %s): s:%s:R`splease specify a values%s: R (R0
R1
R�RRhRRtINPUT_FUNCTIONSR�(RlRNR R�R�t
defaultstrt	inputfuncR"((sM/opt/alt/python27/lib/python2.7/site-packages/logilab/common/configuration.pyR
Ys$


	



	









	
cC
s[|jst
�
x)|jD]}|d
|
kr|dSqWtd|
|jf|
��
dS(s8return the dictionary defining an option given it's nameii
sno such option %s in section %rN(R�R�R
R!(RlR�RN((sM/opt/alt/python27/lib/python2.7/site-packages/logilab/common/configuration.pyRens




c
c
s|xu|j�D]g\}
}|
d
krL|jd
kr:q
n|jj�}
nx%|D]\}}}|
||fV
qSWq
Wd
S(s�return an iterator on available options for this provider
        option are actually described by a 3-uple:
        (section, option name, option dictionary)
        N(R�RR!R�(RlR�R�RNt
optiondictR"((sM/opt/alt/python27/lib/python2.7/site-packages/logilab/common/configuration.pyR
xs





c
c
s�i}
xK|jD]@\}}|
j
|jd
�
g�j|||j|�
f�

qWd|
krwd|
jd�
fV
nx+|
j�D]\}}|j�|fV
q�WdS(streturn an iterator on options grouped by section

        (section, [list of (optname, optdict, optvalue)])
        R�N(	R�R�R�R�R4
RR�R�R�(RlR�RmR R�R�((sM/opt/alt/python27/lib/python2.7/site-packages/logilab/common/configuration.pyR��s






cc
sJ|
dkr|j
}
nx+|
D]#\}}|||j|�
fV
qWdS(
N(RR�R4
(RlR�RmR ((sM/opt/alt/python27/lib/python2.7/site-packages/logilab/common/configuration.pytoptions_and_values�s



(N(RRRR�R!R�R�R�R�RR0
RfRtoption_nameR4
R�R
ReR
R�R>
(((sM/opt/alt/python27/lib/python2.7/site-packages/logilab/common/configuration.pyR�s"



	
			(	
	
	cB
sPeZ
dZd
�Zd�Zd�Zd�Zd�Zd�Zdd�
Z
RS(	s]basic mixin for simple configurations which don't need the
    manager / providers model
    c
O
s�|
s|jd
d�
n|jdd�
t
j||
|�

tj|�

t|dd�s�g|_xm|jD]_\}}y|dj�df}Wnt	k
r�


qnn
X||jkrn|jj
|�

qnqnWn|j|dt�


dS(NR�RpR�i
R�R�R�(
R�R
R�RRRR�R�R�RdR�R�R�(RlR�R
RNR tgdef((sM/opt/alt/python27/lib/python2.7/site-packages/logilab/common/configuration.pyR��s







	








cC
s�i}xH|
D]@\}}|j|j
d
|jj��g�j||f�

q
Wx0|j�D]"\}}
|j|d|
|�
q^W|jt	|
�
7_dS(s%add some options to the configurationR�N(
R�R�R!R�R�R�R�RR�R�(RlR�toptions_by_groupRmR R�((sM/opt/alt/python27/lib/python2.7/site-packages/logilab/common/configuration.pytregister_options�s

8


c

C
stj
|�

dS(
N(RR�(
Rl((sM/opt/alt/python27/lib/python2.7/site-packages/logilab/common/configuration.pyR��s
c

C
st|j
jj��
S(
N(titerRgR
t	iteritems(
Rl((sM/opt/alt/python27/lib/python2.7/site-packages/logilab/common/configuration.pyt__iter__�s
cC
sJyt|j
|j|
�
�SWn&tjtfk
rE


t|
�
�
n
XdS(
N(RRgRfRRR#
Rd(RlR�((sM/opt/alt/python27/lib/python2.7/site-packages/logilab/common/configuration.pyt__getitem__�s



cC
s|j|
|�
dS(
N(
R�(RlR�R"((sM/opt/alt/python27/lib/python2.7/site-packages/logilab/common/configuration.pyt__setitem__�s
cC
s<yt|j
|j|
�
�SWnttfk
r7


|SXdS(
N(RRgRfR
R#
(RlR�R�((sM/opt/alt/python27/lib/python2.7/site-packages/logilab/common/configuration.pyR��s



N(RRRR�RB
R�RE
RF
RG
RR�(((sM/opt/alt/python27/lib/python2.7/site-packages/logilab/common/configuration.pyR�s
							cB
s)eZ
dZddddddd
�ZRS(s�class for simple configurations which don't need the
    manager / providers model and prefer delegation to inheritance

    configuration values are accessible through a dict like interface
    cC
sq|dk	r||_
n|dk	r0||_n|dk	rH||_ntt|�jd
|
d|d|�
dS(NR�R�R�(RR�R!RtsuperRR�(RlR�R�R!R�R�R�((sM/opt/alt/python27/lib/python2.7/site-packages/logilab/common/configuration.pyR��s





N(RRRRR�(((sM/opt/alt/python27/lib/python2.7/site-packages/logilab/common/configuration.pyR�s	
cB
s>eZ
dZd
�Zd�Zd�Zd�Zdd�
ZRS(sgAdapt an option manager to behave like a
    `logilab.common.configuration.Configuration` instance
    cC
s
|
|_dS(
N(
Rg(RlRn((sM/opt/alt/python27/lib/python2.7/site-packages/logilab/common/configuration.pyR��s
cC
st|j
|
�S(
N(RRg(RlR�((sM/opt/alt/python27/lib/python2.7/site-packages/logilab/common/configuration.pyt__getattr__�s
cC
sQ|jj
|
}yt|j|j|
�
�SWntk
rL


t|
�
�
n
XdS(
N(RgRcRRfR#
Rd(RlR�Rn((sM/opt/alt/python27/lib/python2.7/site-packages/logilab/common/configuration.pyRF
�s






cC
s#|jj
|jj|
�
|�
dS(
N(RgR�Rf(RlR�R"((sM/opt/alt/python27/lib/python2.7/site-packages/logilab/common/configuration.pyRG
�s
cC
sF|jj
|
}yt|j|j|
�
�SWntk
rA


|SXdS(
N(RgRcRRfR#
(RlR�R�Rn((sM/opt/alt/python27/lib/python2.7/site-packages/logilab/common/configuration.pyR��s






N(	RRRR�RI
RF
RG
RR�(((sM/opt/alt/python27/lib/python2.7/site-packages/logilab/common/configuration.pyR�s
				cC
s4i}x
|
D]
}|d
dkrb|d\}}}|j|g�j
|d
||f�

q
n|d
dkr�|d\}}	|j|	g�j
|d
|f�

q
n|d
dkr�|d\}}
}|j|g�j
|d
|
|f�

q
n|ddkr
q
ntd|d
�
�
q
Wg}x�|jD]�\}
}x�|j|
d�D]�}|d
dkr�
|d\}}|j�}||d	<qW
|d
dkr�
|d}
qW
|d
dkrW
|d}
|j�}|
|d
<qW
qW
W|j
|
|f�

q8
W|rtd|�
�
ntd|d
|j�}|j|�

|
j	�
t
�}x�|
D]�}|d
dkr�|d\}}	||||	<|j|	�

qY|d
dkrY|d\}
}
}|||
<|j|
�

qYqYWxO|jD]D\}
}|jd
�
r�|
|kr�|j
|
||
d|�

q�q�WdS(s�initialize newconfig from a deprecated configuration file

    possible changes:
    * ('renamed', oldname, newname)
    * ('moved', option, oldgroup, newgroup)
    * ('typechanged', option, oldtype, newvalue)
    itmovedi
trenamedttypechangedtaddedtremovedsunknown change %sR�Rqsunapplied changes: %sR�R!R N(RM
RN
((R�R�RKR�R�RRR!R
treverseR�taddR�R�(t	newconfigtchangest
configfiletchangesindexR�RNtoldgrouptnewgrouptoldnametnewnametoldtypetnewvalueR�Rmtoptdeft	oldconfigtdone((sM/opt/alt/python27/lib/python2.7/site-packages/logilab/common/configuration.pytread_old_config�sb	




&



#



&

























	













cC
s�i}t|�
}x�t
t|�
d
dd�D]�}||\}}||krr|j|�

||j|�

n&|j�}||f||<|||<|
dk	r/|
||d<q/q/Wt|�
S(s	
preprocess a list of options and remove duplicates, returning a new list
    (tuple actually) of options.

    Options dictionaries are copied to avoid later side-effect. Also, if
    `otpgroup` argument is specified, ensure all options are in the given group.
    i
i����R�N(R�RR�R�R7
RRR�(R�toptgroupR�R�RmR ((sM/opt/alt/python27/lib/python2.7/site-packages/logilab/common/configuration.pyt
merge_options=s

#










(PRt
__future__Rt
__docformat__t__all__RuR�tretos.pathRRRtwarningsR	tsixR
t	six.movesRRR�R
tlogilab.common.compatRR�tlogilab.common.deprecationRtlogilab.common.textutilsRRtlogilab.commonRR
R1
RKRRR$R'R(R*R,R.R0R2R4R6R8R:R;tcompileRJRORURWR]R:
R�RMR�RoRstconvertRzR�R�RhRR�R�R�R�tobjectR
R'
RRRRR^
R`
(((sM/opt/alt/python27/lib/python2.7/site-packages/logilab/common/configuration.pyt<module>ls�

	








		
											


















				




						�<�4	?