lYc@sdZdZdZdZdZddlmZmZddlm Z ddl Z ddl Z ddl Z ddl Z ddlZd Zd Zd Zd Zd ZdZdZdZdZdZdZdZdZdZdZdZdZdZ dZ!dZ"dZ#dZ$dZ%d Z&d!Z'd"Z(d#Z)e j*d$kr:d%Z+ne j,d&krRd'Z+nd%Z+yddl-Z.e/Z0Wn e1Z0nXydd(l2m3Z3Wn*e4k rd)e j5fd*YZ3nXe j6e7Z8e8j9 re8j:e3nd+e;fd,YZ<d-e;fd.YZ=d/Z>e?a@d0eAfd1YZBd2eBfd3YZCd4eBfd5YZDd6ZEd7ZFd8e;fd9YZGd:eGfd;YZHd<eHfd=YZId>eGfd?YZJd@e;fdAYZKdBe;fdCYZLdDe;fdEYZMdFZNdGZOdHe;fdIYZPdJeQfdKYZRdLZSdMZTddlUZVdNe;fdOYZWe7dPkreWdQZXeXjYdRndS(Ss This is a configuration module for Python. This module should work under Python versions >= 2.2, and cannot be used with earlier versions since it uses new-style classes. Development and testing has only been carried out (so far) on Python 2.3.4 and Python 2.4.2. See the test module (test_config.py) included in the U{distribution} (follow the download link). A simple example - with the example configuration file:: messages: [ { stream : `sys.stderr` message: 'Welcome' name: 'Harry' } { stream : `sys.stdout` message: 'Welkom' name: 'Ruud' } { stream : $messages[0].stream message: 'Bienvenue' name: Yves } ] a program to read the configuration would be:: from config import Config f = file('simple.cfg') cfg = Config(f) for m in cfg.messages: s = '%s, %s' % (m.message, m.name) try: print >> m.stream, s except IOError, e: print e which, when run, would yield the console output:: Welcome, Harry Welkom, Ruud Bienvenue, Yves See U{this tutorial} for more information. @version: 0.3.9 @author: Vinay Sajip @copyright: Copyright (C) 2004-2010 Vinay Sajip. All Rights Reserved. @var streamOpener: The default stream opener. This is a factory function which takes a string (e.g. filename) and returns a stream suitable for reading. If unable to open the stream, an IOError exception should be thrown. The default value of this variable is L{defaultStreamOpener}. For an example of how it's used, see test_config.py (search for streamOpener). s&Vinay Sajip talphas0.3.9s 11 May 2010i(t StringTypet UnicodeType(t OrderedDictNtat9t"tt{t}t[sa[t]t(s((t)t.t,t:t@t+t-t*t/t%t`t$tTruetFalsetNonet5ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz_twin32s tmacs (t NullHandlerRcBseZdZRS(cCsdS(N((tselftrecord((s=/var/www/c4bv.valis/psync-server-c4/p3py_sub/paytor/config.pytemits(t__name__t __module__R"(((s=/var/www/c4bv.valis/psync-server-c4/p3py_sub/paytor/config.pyRstConfigInputStreamcBs2eZdZdZdZdZdZRS(s An input stream which can read either ANSI files with default encoding or Unicode files with BOMs. Handles UTF-8, UTF-16LE, UTF-16BE. Could handle UTF-32 if Python had built-in support. cCs%d }|jd}d}trT|tjkr9d}qT|tjkrTd}qTn|d kr|d tjkrd}d}q|d tjkrd}d}q|d tjkrd}d }qd }n|d kr|j |n|rtj |}||}n||_ ||_ d S( s Initialize an instance. @param stream: The underlying stream to be read. Should be seekable. @type stream: A stream (file-like object). iisutf-32lesutf-32beisutf-8isutf-16lesutf-16beiN( Rtreadt has_utf32tcodecst BOM_UTF32_LEt BOM_UTF32_BEtBOM_UTF8t BOM_UTF16_LEt BOM_UTF16_BEtseekt getreadertstreamtencoding(R R0R1t signaturetusedtreader((s=/var/www/c4bv.valis/psync-server-c4/p3py_sub/paytor/config.pyt__init__s4         cCsm|dks|jdkr0|jj|}n9d}x0|dkrh||jjd7}|d8}q9W|S(Niui(R1RR0R&(R tsizetrv((s=/var/www/c4bv.valis/psync-server-c4/p3py_sub/paytor/config.pyR&scCs|jjdS(N(R0tclose(R ((s=/var/www/c4bv.valis/psync-server-c4/p3py_sub/paytor/config.pyR8scCsd|jdkrd}nd}x?tr_|jjd}|rL||7}n|dkr!Pq!q!W|S(NRuis (R1RRR0R&(R tlinetc((s=/var/www/c4bv.valis/psync-server-c4/p3py_sub/paytor/config.pytreadlines    (R#R$t__doc__R5R&R8R;(((s=/var/www/c4bv.valis/psync-server-c4/p3py_sub/paytor/config.pyR%s  # tConfigOutputStreamcBs5eZdZddZdZdZdZRS(s An output stream which can write either ANSI files with default encoding or Unicode files with BOMs. Handles UTF-8, UTF-16LE, UTF-16BE. Could handle UTF-32 if Python had built-in support. cCs|dk r!t|j}n||_|dkrI|jtjn||dkrh|jtjn]|dkr|jtjn>|dkr|jtj n|dkr|jtj n|dk rtj |}||}n||_ dS(s Initialize an instance. @param stream: The underlying stream to be written. @type stream: A stream (file-like object). @param encoding: The desired encoding. @type encoding: str sutf-8sutf-16besutf-16lesutf-32besutf-32leN( RtstrtlowerR1twriteR(R+R-R,R*R)t getwriterR0(R R0R1twriter((s=/var/www/c4bv.valis/psync-server-c4/p3py_sub/paytor/config.pyR5s"        cCs|jj|dS(N(R0R@(R tdata((s=/var/www/c4bv.valis/psync-server-c4/p3py_sub/paytor/config.pyR@scCs|jjdS(N(R0tflush(R ((s=/var/www/c4bv.valis/psync-server-c4/p3py_sub/paytor/config.pyRDscCs|jjdS(N(R0R8(R ((s=/var/www/c4bv.valis/psync-server-c4/p3py_sub/paytor/config.pyR8 sN(R#R$R<RR5R@RDR8(((s=/var/www/c4bv.valis/psync-server-c4/p3py_sub/paytor/config.pyR=s    cCstt|dS(s This function returns a read-only stream, given its name. The name passed in should correspond to an existing stream, otherwise an exception will be raised. This is the default value of L{streamOpener}; assign your own callable to streamOpener to return streams based on names. For example, you could use urllib2.urlopen(). @param name: The name of a stream, most commonly a file name. @type name: str @return: A stream with the specified name. @rtype: A read-only stream (file-like object) trb(R%tfile(tname((s=/var/www/c4bv.valis/psync-server-c4/p3py_sub/paytor/config.pytdefaultStreamOpener st ConfigErrorcBseZdZRS(sE This is the base class of exceptions raised by this module. (R#R$R<(((s=/var/www/c4bv.valis/psync-server-c4/p3py_sub/paytor/config.pyRIstConfigFormatErrorcBseZdZRS(sa This is the base class of exceptions raised due to syntax errors in configurations. (R#R$R<(((s=/var/www/c4bv.valis/psync-server-c4/p3py_sub/paytor/config.pyRJ%stConfigResolutionErrorcBseZdZRS(sc This is the base class of exceptions raised due to semantic errors in configurations. (R#R$R<(((s=/var/www/c4bv.valis/psync-server-c4/p3py_sub/paytor/config.pyRK,scCs8t|tdkrtS|jdd}|jS(s% See if a passed-in value is an identifier. If the value passed in is not a string, False is returned. An identifier consists of alphanumerics or underscore characters. Examples:: isWord('a word') ->False isWord('award') -> True isWord(9) -> False isWord('a_b_c_') ->True @note: isWord('9abc') will return True - not exactly correct, but adequate for the way it's used here. @param s: The name to be tested @type s: any @return: True if a word, else False @rtype: bool Rt_(ttypeRtreplacetisalnum(ts((s=/var/www/c4bv.valis/psync-server-c4/p3py_sub/paytor/config.pytisWord3scCs>|s|}n+|ddkr,||}n|d|}|S(s Make a path from a prefix and suffix. Examples:: makePath('', 'suffix') -> 'suffix' makePath('prefix', 'suffix') -> 'prefix.suffix' makePath('prefix', '[1]') -> 'prefix[1]' @param prefix: The prefix to use. If it evaluates as false, the suffix is returned. @type prefix: str @param suffix: The suffix to use. It is either an identifier or an index in brackets. @type suffix: str @return: The path concatenation of prefix and suffix, with a dot if the suffix is not a bracketed index. @rtype: str iR R((tprefixtsuffixR7((s=/var/www/c4bv.valis/psync-server-c4/p3py_sub/paytor/config.pytmakePathMs   t ContainercBs;eZdZdZdZdZdZdZRS(s This internal class is the base class for mappings and sequences. @ivar path: A string which describes how to get to this instance from the root of the hierarchy. Example:: a.list.of[1].or['more'].elements cCstj|d|dS(s Initialize an instance. @param parent: The parent of this instance in the hierarchy. @type parent: A L{Container} instance. tparentN(tobjectt __setattr__(R RV((s=/var/www/c4bv.valis/psync-server-c4/p3py_sub/paytor/config.pyR5vscCstj|d|dS(s Set the path for this instance. @param path: The path - a string which describes how to get to this instance from the root of the hierarchy. @type path: str tpathN(RWRX(R RY((s=/var/www/c4bv.valis/psync-server-c4/p3py_sub/paytor/config.pytsetPathscCsFt|tr!|j|}n!t|trB|j|}n|S(s Evaluate items which are instances of L{Reference} or L{Expression}. L{Reference} instances are evaluated using L{Reference.resolve}, and L{Expression} instances are evaluated using L{Expression.evaluate}. @param item: The item to be evaluated. @type item: any @return: If the item is an instance of L{Reference} or L{Expression}, the evaluated value is returned, otherwise the item is returned unchanged. (t isinstancet Referencetresolvet Expressiontevaluate(R titem((s=/var/www/c4bv.valis/psync-server-c4/p3py_sub/paytor/config.pyR_s cCs tdS(s Write this instance to a stream at the specified indentation level. Should be redefined in subclasses. @param stream: The stream to write to @type stream: A writable stream (file-like object) @param indent: The indentation level @type indent: int @param container: The container of this instance @type container: L{Container} @raise NotImplementedError: If a subclass does not override this N(tNotImplementedError(R R0tindentt container((s=/var/www/c4bv.valis/psync-server-c4/p3py_sub/paytor/config.pyt writeToStreamscCst|trd}n |d}t|ts@t|tr]|jd||tfn;t|tkr~t|}n|jd||tfdS(Nt s s%s%r%ss%s%s%s( R[tMappingR\R^R@tNEWLINERMRtrepr(R tvalueR0Rbtindstr((s=/var/www/c4bv.valis/psync-server-c4/p3py_sub/paytor/config.pyt writeValues  (R#R$R<R5RZR_RdRk(((s=/var/www/c4bv.valis/psync-server-c4/p3py_sub/paytor/config.pyRUks    RfcBseZdZddZdZdZeZdZdZ dZ e dZ dZ e Zd Zdd Zd Zd Zd ZdZdZdZddZRS(sN This internal class implements key-value mappings in configurations. cCs`tj||tj|ddtj|ditj|dgtj|didS(s Initialize an instance. @param parent: The parent of this instance in the hierarchy. @type parent: A L{Container} instance. RYRRCtordertcommentsN(RUR5RWRX(R RV((s=/var/www/c4bv.valis/psync-server-c4/p3py_sub/paytor/config.pyR5s cCsptj|d}||kr-t|ntj|d}tj|d}||=|j|||=dS(s Remove an item RCRlRmN(RWt__getattribute__tAttributeErrortremove(R tkeyRCRlRm((s=/var/www/c4bv.valis/psync-server-c4/p3py_sub/paytor/config.pyt __delitem__s  cCsDtj|d}||kr-t|n||}|j|S(NRC(RWRnRoR_(R RqRCR7((s=/var/www/c4bv.valis/psync-server-c4/p3py_sub/paytor/config.pyt __getitem__s   cCs|dkriS|dkr gStj|d}|j|}|rYt||}n-tj||}|dkrt|n|S(Nt__dict__t __methods__t __members__RC(RuRv(RWRnthas_keytgetattrRRo(R RGRCtuseDataR7((s=/var/www/c4bv.valis/psync-server-c4/p3py_sub/paytor/config.pyRns   ccs0x#|jD]}|||fVq WtdS(N(tkeyst StopIteration(R Rq((s=/var/www/c4bv.valis/psync-server-c4/p3py_sub/paytor/config.pyt iteritemsscCstj|d}||kS(NRl(RWRn(R R`Rl((s=/var/www/c4bv.valis/psync-server-c4/p3py_sub/paytor/config.pyt __contains__scCstj|d}tj|d}tj|d}|||<||kr\|j|n|sutd|n|||RWRn(R ((s=/var/www/c4bv.valis/psync-server-c4/p3py_sub/paytor/config.pyt__str__*scCsttj|dS(NRC(RhRWRn(R ((s=/var/www/c4bv.valis/psync-server-c4/p3py_sub/paytor/config.pyt__repr__-scCsttj|dS(NRl(tlenRWRn(R ((s=/var/www/c4bv.valis/psync-server-c4/p3py_sub/paytor/config.pyt__len__0scCs |jS(N(titerkeys(R ((s=/var/www/c4bv.valis/psync-server-c4/p3py_sub/paytor/config.pyt__iter__3scCstj|d}|jS(NRl(RWRnR(R Rl((s=/var/www/c4bv.valis/psync-server-c4/p3py_sub/paytor/config.pyR6scCs|d}t|dkr0|jdtnat|trO|jtn|jd|tf|j||d|jd|tfdS(s Write this instance to a stream at the specified indentation level. Should be redefined in subclasses. @param stream: The stream to write to @type stream: A writable stream (file-like object) @param indent: The indentation level @type indent: int @param container: The container of this instance @type container: L{Container} s is { }%ss%s{%sis%s}%sN(RR@RgR[Rftsave(R R0RbRcRj((s=/var/www/c4bv.valis/psync-server-c4/p3py_sub/paytor/config.pyRd:s ic Cs|d}tj|d}tj|d}d}x|D]}|j|}t|rc|} n t|} |r|jd||fn|jd||| f||} t| tr| j|||q;|j | ||q;WdS(s Save this configuration to the specified stream. @param stream: A stream to which the configuration is written. @type stream: A write-only stream (file-like object). @param indent: The indentation level for the output. @type indent: int s RlRCis%s#%ss%s%-*s :N( RWRnRmRQRhR@R[RURdRk( R R0RbRjRlRCtmaxlenRqRtskeyRi((s=/var/www/c4bv.valis/psync-server-c4/p3py_sub/paytor/config.pyRQs        N(R#R$R<RR5RrRst __getattr__RnR|R}RRRXt __setitem__RzRRRRRRRdR(((s=/var/www/c4bv.valis/psync-server-c4/p3py_sub/paytor/config.pyRfs(              tConfigcBsieZdZdefdYZd d dZdZd dZd dZ ddZ d Z RS( s This class represents a configuration, and is the only one which clients need to interface to, under normal circumstances. t NamespacecBs eZdZdZdZRS(s| This internal class is used for implementing default namespaces. An instance acts as a namespace. cCst|_t|_dS(N(tsystos(R ((s=/var/www/c4bv.valis/psync-server-c4/p3py_sub/paytor/config.pyR5xs cCsddj|jjS(NsR(tjoinRtRz(R ((s=/var/www/c4bv.valis/psync-server-c4/p3py_sub/paytor/config.pyR|s(R#R$R<R5R(((s=/var/www/c4bv.valis/psync-server-c4/p3py_sub/paytor/config.pyRrs cCstj||tj|dt|tj|dtjgtj|dt|dk rt |t st |t rt dkrt a nt |}ntj|d}||ndS(s8 Initializes an instance. @param streamOrFile: If specified, causes this instance to be loaded from the stream (by calling L{load}). If a string is provided, it is passed to L{streamOpener} to open a stream. Otherwise, the passed value is assumed to be a stream and used as is. @type streamOrFile: A readable stream (file-like object) or a name. @param parent: If specified, this becomes the parent of this instance in the configuration hierarchy. @type parent: a L{Container} instance. R4t namespacest resolvingtloadN(RfR5RWRXt ConfigReaderRRtsetRR[RRt streamOpenerRHRn(R t streamOrFileRVR((s=/var/www/c4bv.valis/psync-server-c4/p3py_sub/paytor/config.pyR5s    cCs-tj|d}|j||jdS(s Load the configuration from the specified stream. Multiple streams can be used to populate the same instance, as long as there are no clashing keys. The stream is closed. @param stream: A stream from which the configuration is read. @type stream: A read-only stream (file-like object). @raise ConfigError: if keys in the loaded configuration clash with existing keys. @raise ConfigFormatError: if there is a syntax error in the stream. R4N(RWRnRR8(R R0R4((s=/var/www/c4bv.valis/psync-server-c4/p3py_sub/paytor/config.pyRs  cCsFtj|d}|dkr.|j|nt|d||dS(s Add a namespace to this configuration which can be used to evaluate (resolve) dotted-identifier expressions. @param ns: The namespace to be added. @type ns: A module or other namespace suitable for passing as an argument to vars(). @param name: A name for the namespace, which, if specified, provides an additional level of indirection. @type name: str RiN(RWRnRR~tsetattr(R tnsRGR((s=/var/www/c4bv.valis/psync-server-c4/p3py_sub/paytor/config.pyt addNamespaces  cCsCtj|d}|dkr.|j|nt|d|dS(s Remove a namespace added with L{addNamespace}. @param ns: The namespace to be removed. @param name: The name which was specified when L{addNamespace} was called. @type name: str RiN(RWRnRRptdelattr(R RRGR((s=/var/www/c4bv.valis/psync-server-c4/p3py_sub/paytor/config.pytremoveNamespaces icCs0tj||||dkr,|jndS(s Save this configuration to the specified stream. The stream is closed if this is the top-level configuration in the hierarchy. L{Mapping.save} is called to do all the work. @param stream: A stream to which the configuration is written. @type stream: A write-only stream (file-like object). @param indent: The indentation level for the output. @type indent: int iN(RfRR8(R R0Rb((s=/var/www/c4bv.valis/psync-server-c4/p3py_sub/paytor/config.pyRs  cCsDd|}yt|SWn%tk r?}tt|nXdS(s Obtain a value in the configuration via its path. @param path: The path of the required value @type path: str @return the value at the specified path. @rtype: any @raise ConfigError: If the path is invalid sself.N(tevalt ExceptionRIR>(R RYRPte((s=/var/www/c4bv.valis/psync-server-c4/p3py_sub/paytor/config.pyt getByPaths N( R#R$R<RWRRR5RRRRR(((s=/var/www/c4bv.valis/psync-server-c4/p3py_sub/paytor/config.pyRls     tSequencecBsxeZdZdefdYZd dZdZdZdZ dZ dZ d Z d Z d ZRS( sU This internal class implements a value which is a sequence of other values. tSeqItercBs)eZdZdZdZdZRS(sX This internal class implements an iterator for a L{Sequence} instance. cCs1||_ttj|d|_d|_dS(NRCi(tseqRRWRntlimittindex(R R((s=/var/www/c4bv.valis/psync-server-c4/p3py_sub/paytor/config.pyR5s cCs|S(N((R ((s=/var/www/c4bv.valis/psync-server-c4/p3py_sub/paytor/config.pyRscCs>|j|jkrtn|j|j}|jd7_|S(Ni(RRR{R(R R7((s=/var/www/c4bv.valis/psync-server-c4/p3py_sub/paytor/config.pytnexts  (R#R$R<R5RR(((s=/var/www/c4bv.valis/psync-server-c4/p3py_sub/paytor/config.pyRs  cCs:tj||tj|dgtj|dgdS(s Initialize an instance. @param parent: The parent of this instance in the hierarchy. @type parent: A L{Container} instance. RCRmN(RUR5RWRX(R RV((s=/var/www/c4bv.valis/psync-server-c4/p3py_sub/paytor/config.pyR5scCsBtj|d}tj|d}|j||j|dS(s Add an item to the sequence. @param item: The item to add. @type item: any @param comment: A comment for the item. @type comment: str RCRmN(RWRnR~(R R`RRCRm((s=/var/www/c4bv.valis/psync-server-c4/p3py_sub/paytor/config.pyR~s  cCstj|d}y||}Wn<tttfk r^td|tj|dfnXt|ts|j|}n3g}x$|D]}|j |j|qW|}|S(NRCs%r is not a valid index for %rRY( RWRnt IndexErrortKeyErrort TypeErrorRKR[tlistR_R~(R RRCR7tresultR((s=/var/www/c4bv.valis/psync-server-c4/p3py_sub/paytor/config.pyRss& cCs tj|S(N(RR(R ((s=/var/www/c4bv.valis/psync-server-c4/p3py_sub/paytor/config.pyR%scCsttj|dS(NRC(RhRWRn(R ((s=/var/www/c4bv.valis/psync-server-c4/p3py_sub/paytor/config.pyR(scCs t|S(N(R>(R ((s=/var/www/c4bv.valis/psync-server-c4/p3py_sub/paytor/config.pyR+scCsttj|dS(NRC(RRWRn(R ((s=/var/www/c4bv.valis/psync-server-c4/p3py_sub/paytor/config.pyR.scCs|d}t|dkr0|jdtnat|trO|jtn|jd|tf|j||d|jd|tfdS(s Write this instance to a stream at the specified indentation level. Should be redefined in subclasses. @param stream: The stream to write to @type stream: A writable stream (file-like object) @param indent: The indentation level @type indent: int @param container: The container of this instance @type container: L{Container} s is [ ]%ss%s[%sis%s]%sN(RR@RgR[RfR(R R0RbRcRj((s=/var/www/c4bv.valis/psync-server-c4/p3py_sub/paytor/config.pyRd1s c Cs|dkrtdntj|d}tj|d}|d}xtdt|D]r}||}||}|r|jd||fnt|tr|j|||q_|j |||q_WdS(s Save this instance to the specified stream. @param stream: A stream to which the configuration is written. @type stream: A write-only stream (file-like object). @param indent: The indentation level for the output, > 0 @type indent: int is,sequence cannot be saved as a top-level itemRCRms s%s#%sN( RIRWRntxrangeRR@R[RURdRk( R R0RbRCRmRjtiRiR((s=/var/www/c4bv.valis/psync-server-c4/p3py_sub/paytor/config.pyRHs    N(R#R$R<RWRRR5R~RsRRRRRdR(((s=/var/www/c4bv.valis/psync-server-c4/p3py_sub/paytor/config.pyRs       R\cBsDeZdZdZdZdZdZdZdZRS(sW This internal class implements a value which is a reference to another value. cCs"||_||_|g|_dS(sK Initialize an instance. @param config: The configuration which contains this reference. @type config: A L{Config} instance. @param type: The type of reference. @type type: BACKTICK or DOLLAR @param ident: The identifier which starts the reference. @type ident: str N(tconfigRMtelements(R RRMtident((s=/var/www/c4bv.valis/psync-server-c4/p3py_sub/paytor/config.pyR5cs  cCs|jj||fdS(s Add an element to the reference. @param type: The type of reference. @type type: BACKTICK or DOLLAR @param ident: The identifier which continues the reference. @type ident: str N(RR~(R RMR((s=/var/www/c4bv.valis/psync-server-c4/p3py_sub/paytor/config.pyt addElementrs cCs9x2|dk r4t|t r4tj|d}qW|S(s  Find the closest enclosing configuration to the specified container. @param container: The container to start from. @type container: L{Container} @return: The closest enclosing configuration, or None. @rtype: L{Config} RVN(RR[RRWRn(R Rc((s=/var/www/c4bv.valis/psync-server-c4/p3py_sub/paytor/config.pyt findConfig}s c Cs3d }tj|d}|j|}x|d k r |jtkrtj|d}t}t|dd!}x{|D]s}yPyt|t |}Wn)t k rt|it |}nXt }PWqwt j d||qwXqwW|rPqn|jd} | |jkr:|jj| td| n|jj| | } yK|| }x)|jdD]} | d} || }qkW|jj| PWn=tk rn*t j d| tjdd }nX|jj| |jtj|d }q*W|d kr/td ||fn|S( s Resolve this instance in the context of a container. @param container: The container to resolve from. @type container: L{Container} @return: The resolved value. @rtype: any @raise ConfigResolutionError: If resolution fails. RYRiisunable to resolve %r in %risCircular reference: %rsUnable to resolve %r: %sRVs-unable to evaluate %r in the configuration %sN(RRWRnRRMtBACKTICKRR>RtvarsRRtloggertdebugRRRpRKtaddRtexc_infotdiscard( R RcR7RYtcurrentRtfoundRPRtfirstkeyRqR`((s=/var/www/c4bv.valis/psync-server-c4/p3py_sub/paytor/config.pyR]sZ        cCs}|jd}xF|jdD]7\}}|tkrD|d|7}q|d|7}qW|jtkrqt|tSt|SdS(Niis.%ss[%r](RtDOTRMRtDOLLAR(R RPtttttv((s=/var/www/c4bv.valis/psync-server-c4/p3py_sub/paytor/config.pyRs   cCs |jS(N(R(R ((s=/var/www/c4bv.valis/psync-server-c4/p3py_sub/paytor/config.pyRs( R#R$R<R5RRR]RR(((s=/var/www/c4bv.valis/psync-server-c4/p3py_sub/paytor/config.pyR\_s  9 R^cBs2eZdZdZdZdZdZRS(s_ This internal class implements a value which is obtained by evaluating an expression. cCs||_||_||_dS(s Initialize an instance. @param op: the operation expressed in the expression. @type op: PLUS, MINUS, STAR, SLASH, MOD @param lhs: the left-hand-side operand of the expression. @type lhs: any Expression or primary value. @param rhs: the right-hand-side operand of the expression. @type rhs: any Expression or primary value. N(toptlhstrhs(R RRR((s=/var/www/c4bv.valis/psync-server-c4/p3py_sub/paytor/config.pyR5s  cCsd|j|j|jfS(Ns%r %s %r(RRR(R ((s=/var/www/c4bv.valis/psync-server-c4/p3py_sub/paytor/config.pyRscCs |jS(N(R(R ((s=/var/www/c4bv.valis/psync-server-c4/p3py_sub/paytor/config.pyRscCs|j}t|tr*|j|}n!t|trK|j|}n|j}t|tru|j|}n!t|tr|j|}n|j}|tkr||}nU|t kr||}n<|t kr||}n#|t kr||}n ||}|S(s Evaluate this instance in the context of a container. @param container: The container to evaluate in from. @type container: L{Container} @return: The evaluated value. @rtype: any @raise ConfigResolutionError: If evaluation fails. @raise ZeroDivideError: If division by zero occurs. @raise TypeError: If the operation is invalid, e.g. subtracting one string from another. ( RR[R\R]R^R_RRtPLUStMINUStSTARtSLASH(R RcRRRR7((s=/var/www/c4bv.valis/psync-server-c4/p3py_sub/paytor/config.pyR_s*            (R#R$R<R5RRR_(((s=/var/www/c4bv.valis/psync-server-c4/p3py_sub/paytor/config.pyR^s    RcBseZdZdZdZdZdZeZdZdddZ dZ dZ d Z d Zd Zd Zd ZdZdZdZdZdZRS(sE This internal class implements a parser for configurations. cCsd|_||_d|_d|_d|_d|_d|_d|_d|_ d|_ d|_ dt |_ |j |j |_g|_g|_d|_dS(Nit#s s'"s:-+*/%,.{}[]()@`$t 0123456789s%s(RtfilenameRtlinenotcolnotlastct last_tokent commentcharst whitespacetquotestpuncttdigitst WORDCHARSt wordcharst identcharstpbcharstpbtokensR(R R((s=/var/www/c4bv.valis/psync-server-c4/p3py_sub/paytor/config.pyR5s               cCsd|j|j|jfS(s Return the current location (filename, line, column) in the stream as a string. Used when printing error messages, @return: A string representing a location in the stream being read. @rtype: str s %s(%d,%d)(RRR(R ((s=/var/www/c4bv.valis/psync-server-c4/p3py_sub/paytor/config.pytlocation&s cCsg|jr|jj}nH|jjd}|jd7_|dkrc|jd7_d|_n|S(s Get the next char from the stream. Update line and column numbers appropriately. @return: The next character from the stream. @rtype: str is (RtpopR0R&RR(R R:((s=/var/www/c4bv.valis/psync-server-c4/p3py_sub/paytor/config.pytgetChar2s   cCsdt|S(Ns(tid(R ((s=/var/www/c4bv.valis/psync-server-c4/p3py_sub/paytor/config.pyRDsc Cs|jr|jjS|j}d|_d}t}xctr|j}|sSPn0|dkr|j|_|j d7_ q7n||j kr|}|}t }t }t }|j}||kr |j} | |krt}||7}||7}q0|j j| |j j|n|j j|xtr|j}|sOPn||7}||kr| r| st|dkr|j|d r|ddkrPqn|dkr| }q3t }q3W|std|j||fnPn||jkr||_q7q7||jkr|}|}|jd ksU|j|jkr|d krjt}q|d krt}qnPq7||jkr|}t}t } xtr|j}|sPn||jkr||7}q|d kr|jd d kr| r||7}q|dkrK|jdd krK| rK||7}q|dkr|jdd kr|jdd kr||7}t} q|r||jkr|j j|nPqWPq7||jkrz|}t}|j}x/|r||jkr||7}|j}qW|r7|j j|n|dkrLt}n*|dkrat}n|dkrvt }nPq7td|j|fq7W|r|d|_n d|_||_!||fS(sd Get a token from the stream. String values are returned in a form where you need to eval() the returned value to get the actual string. The return value is (token_type, token_value). Multiline string tokenizing is thanks to David Janes (BlogMatrix) @return: The next token. @rtype: A token tuple. RRiiiis\s&%s: Unterminated quoted string: %r, %rR R R RiRteERtERRRs%s: Unexpected character: %riN("RRR0RRtEOFRRR;RRtSTRINGRRR~RtendswithRJRRRRRtLBRACK2tLPAREN2RtNUMBERtfindRtWORDtTRUEtFALSEtNONER( R R0ttokenRR:tquotetescapedt multilinetc1tc2t in_exponent((s=/var/www/c4bv.valis/psync-server-c4/p3py_sub/paytor/config.pytgetTokenIs                <   " !       ( ' !             cCs|dk rO|dkr'tdn|jjttj|d|n|j||j|_ |j |j|j dt krt d|j |j dfndS(s Load the configuration from the specified stream. @param stream: A stream from which to load the configuration. @type stream: A stream (file-like object). @param parent: The parent of the configuration (to which this reader belongs) in the hierarchy. Specified when the configuration is included in another one. @type parent: A L{Container} instance. @param suffix: The suffix of this configuration in the parent configuration. Should be specified whenever the parent is not None. @raise ConfigError: If parent is specified but suffix is not. @raise ConfigFormatError: If there are syntax errors in the stream. s5internal error: load called with parent but no suffixRYis%s: expecting EOF, found %riN(RRIRRZRTRWRnt setStreamRRtparseMappingBodyRRJR(R R0RVRS((s=/var/www/c4bv.valis/psync-server-c4/p3py_sub/paytor/config.pyRs  ( cCsI||_t|dr$|j}nd}||_d|_d|_dS(s Set the stream to the specified value, and prepare to read from it. @param stream: A stream from which to load the configuration. @type stream: A stream (file-like object). RGt?iN(R0thasattrRGRRR(R R0R((s=/var/www/c4bv.valis/psync-server-c4/p3py_sub/paytor/config.pyRs    cCsX|jd|kr<td|j||jdfn|j}|j|_|S(s Ensure that the current token type matches the specified value, and advance to the next token. @param t: The token type to match. @type t: A valid token type. @return: The token which was last read from the stream before this function is called. @rtype: a token tuple - see L{getToken}. @raise ConfigFormatError: If the token does not match what's expected. is%s: expecting %s, found %ri(RRJRR(R ttR7((s=/var/www/c4bv.valis/psync-server-c4/p3py_sub/paytor/config.pytmatchs ) cCs1x*|jdttgkr,|j|qWdS(s Parse the internals of a mapping, and add entries to the provided L{Mapping}. @param parent: The mapping to add entries to. @type parent: A L{Mapping} instance. iN(RRRtparseKeyValuePair(R RV((s=/var/www/c4bv.valis/psync-server-c4/p3py_sub/paytor/config.pyRsc Cs|j}|j\}}|tkr3|}|}nG|tkrXt|}d|}n"d}t||j|f|j|_|jdtkr|j|_|j ||}nt }y|j |||Wn9t k r} td|j| |jdfnX|jd}|t ttttgkrmd}t||j|jdfn|tkr|j|_ndS(s Parse a key-value pair, and add it to the provided L{Mapping}. @param parent: The mapping to add entries to. @type parent: A L{Mapping} instance. @raise ConfigFormatError: if a syntax error is found. s[%s]s&%s: expecting word or string, found %ris %s: %s, %ris>%s: expecting one of EOF, WORD, STRING,RCURLY, COMMA, found %rN(RRRRRRJRRtCOLONt parseValueRRRRtRCURLYtCOMMA( R RVRRRRqRStmsgRiR((s=/var/www/c4bv.valis/psync-server-c4/p3py_sub/paytor/config.pyRs4       & c Cs|jd}|ttttttttt t g krF|j }nk|t krg|j ||}nJ|ttgkr|j||}n#td|j|jdf|S(sO Parse a value. @param parent: The container to which the value will be added. @type parent: A L{Container} instance. @param suffix: The suffix for the value. @type suffix: str @return: The value @rtype: any @raise ConfigFormatError: if a syntax error is found. is%s: unexpected input: %ri(RRRRtLPARENRRRRRRt parseScalartLBRACKt parseSequencetLCURLYtATt parseMappingRJR(R RVRSRR7((s=/var/www/c4bv.valis/psync-server-c4/p3py_sub/paytor/config.pyR,s  c Cst|}|jttj|d||jt|j}|jd}x|t t t t tt ttttttg krdt|}|j||}|j|||jd}|j}|tkrT|jt|jd}|j}qTqTqTW|jt|S(s Parse a sequence. @param parent: The container to which the sequence will be added. @type parent: A L{Container} instance. @param suffix: The suffix for the value. @type suffix: str @return: a L{Sequence} instance representing the sequence. @rtype: L{Sequence} @raise ConfigFormatError: if a syntax error is found. RYis[%d](RRZRTRWRnRRRRRRRRRRRRRRRRRR~RtRBRACK(R RVRSR7RRRi((s=/var/www/c4bv.valis/psync-server-c4/p3py_sub/paytor/config.pyREs& "           cCs|jdtkrk|jtt|}|jttj|d||j||jt n7|jt |jt \}}t t ||}|S(s Parse a mapping. @param parent: The container to which the mapping will be added. @type parent: A L{Container} instance. @param suffix: The suffix for the value. @type suffix: str @return: a L{Mapping} instance representing the mapping. @rtype: L{Mapping} @raise ConfigFormatError: if a syntax error is found. iRY(RRRRfRZRTRWRnRRRRRR(R RVRSR7Rtfn((s=/var/www/c4bv.valis/psync-server-c4/p3py_sub/paytor/config.pyRes     cCsn|j}|jd}xN|ttgkri|j||j}t|||}|jd}qW|S(s Parse a scalar - a terminal value such as a string or number, or an L{Expression} or L{Reference}. @return: the parsed scalar @rtype: any scalar @raise ConfigFormatError: if a syntax error is found. i(t parseTermRRRRR^(R RRR((s=/var/www/c4bv.valis/psync-server-c4/p3py_sub/paytor/config.pyR~s    cCsq|j}|jd}xQ|tttgkrl|j||j}t|||}|jd}qW|S(s Parse a term in an additive expression (a + b, a - b) @return: the parsed term @rtype: any scalar @raise ConfigFormatError: if a syntax error is found. i(t parseFactorRRRtMODRR^(R RRR((s=/var/www/c4bv.valis/psync-server-c4/p3py_sub/paytor/config.pyR s    cCsK|jd}|ttttttgkrc|jd}|tkrSt|}n|j|n|t kr|jt |j }|jt n|t kr|jt |j t }n|tkr|jt|j t}|jtnL|tkr$|jt|j }n#td|j|jdf|S(s Parse a factor in an multiplicative expression (a * b, a / b, a % b) @return: the parsed factor @rtype: any scalar @raise ConfigFormatError: if a syntax error is found. iis%s: unexpected input: %r(RRRRRRRRRRRtRPARENRtparseReferenceRRRJR(R RR7((s=/var/www/c4bv.valis/psync-server-c4/p3py_sub/paytor/config.pyR s.            cCsY|jt}t|j||d}x*|jdttgkrT|j|q+W|S(s Parse a reference. @return: the parsed reference @rtype: L{Reference} @raise ConfigFormatError: if a syntax error is found. ii(RRR\RRRRt parseSuffix(R RMtwordR7((s=/var/www/c4bv.valis/psync-server-c4/p3py_sub/paytor/config.pyRs cCs|jd}|tkrL|jt|jt}|jt|dn|jt|j\}}|ttgkrtd|j |fn|j |_t |}|jt |jt |dS(s Parse a reference suffix. @param ref: The reference of which this suffix is a part. @type ref: L{Reference}. @raise ConfigFormatError: if a syntax error is found. iis'%s: expected number or string, found %rN(RRRRRRRRRJRRRRR(R trefRRR((s=/var/www/c4bv.valis/psync-server-c4/p3py_sub/paytor/config.pyRs      N(R#R$R<R5RRRRRRRRRRRRRRRR R RR(((s=/var/www/c4bv.valis/psync-server-c4/p3py_sub/paytor/config.pyRs(    v   '     ! cCsl||}||}t|tr;t|tr;d}n-t|trbt|trbd}nd}|S(s A default resolver for merge conflicts. Returns a string indicating what action to take to resolve the conflict. @param map1: The map being merged into. @type map1: L{Mapping}. @param map2: The map being used as the merge operand. @type map2: L{Mapping}. @param key: The key in map2 (which also exists in map1). @type key: str @return: One of "merge", "append", "mismatch" or "overwrite" indicating what action should be taken. This should be appropriate to the objects being merged - e.g. there is no point returning "merge" if the two objects are instances of L{Sequence}. @rtype: str tmergeR~tmismatch(R[RfR(tmap1tmap2Rqtobj1tobj2R7((s=/var/www/c4bv.valis/psync-server-c4/p3py_sub/paytor/config.pytdefaultMergeResolves    cCs+t|||}|dkr'd}n|S(s An overwriting resolver for merge conflicts. Calls L{defaultMergeResolve}, but where a "mismatch" is detected, returns "overwrite" instead. @param map1: The map being merged into. @type map1: L{Mapping}. @param map2: The map being used as the merge operand. @type map2: L{Mapping}. @param key: The key in map2 (which also exists in map1). @type key: str Rt overwrite(R(RRRqR7((s=/var/www/c4bv.valis/psync-server-c4/p3py_sub/paytor/config.pytoverwriteMergeResolves   t ConfigMergercBs>eZdZedZdZdZdZdZRS(sE This class is used for merging two configurations. If a key exists in the merge operand but not the merge target, then the entry is copied from the merge operand to the merge target. If a key exists in both configurations, then a resolver (a callable) is called to decide how to handle the conflict. cCs ||_dS(s Initialise an instance. @param resolver: @type resolver: A callable which takes the argument list (map1, map2, key) where map1 is the mapping being merged into, map2 is the merge operand and key is the clashing key. The callable should return a string indicating how the conflict should be resolved. For possible return values, see L{defaultMergeResolve}. The default value preserves the old behaviour N(tresolver(R R((s=/var/www/c4bv.valis/psync-server-c4/p3py_sub/paytor/config.pyR5s cCs|j||dS(sF Merge two configurations. The second configuration is unchanged, and the first is changed to reflect the results of the merge. @param merged: The configuration to merge into. @type merged: L{Config}. @param mergee: The configuration to merge. @type mergee: L{Config}. N(t mergeMapping(R tmergedtmergee((s=/var/www/c4bv.valis/psync-server-c4/p3py_sub/paytor/config.pyR+s c Cs|j}x|jD]}||kr<||||Ts            E.   Pyzs=  `!   $