-í ›KX;cs/dZdkZdkZdkZdkZdkZdkZdkZdkZ dk l Z dk Z dZ deifd„ƒYZeidƒZeied„Zdfd „ƒYZd efd „ƒYZd efd „ƒYZdefd„ƒYZdefd„ƒYZeieieed„Zeieieed„Zdefd„ƒYZeZeZ defd„ƒYZ!e!Z"e!Z#defd„ƒYZ$de!fd„ƒYZ%defd„ƒYZ&defd„ƒYZ'd efd!„ƒYZ(d"efd#„ƒYZ)d$e'fd%„ƒYZ*d&e&fd'„ƒYZ+d(e'fd)„ƒYZ,d*e&fd+„ƒYZ-d,e*fd-„ƒYZ.d.efd/„ƒYZ/d0e/fd1„ƒYZ0d2e0fd3„ƒYZ1d4efd5„ƒYZ2d6efd7„ƒYZ3d8efd9„ƒYZ4d:efd;„ƒYZ5d<efd=„ƒYZ6d>efd?„ƒYZ7d@efdA„ƒYZ8dBefdC„ƒYZ9dDe i fdE„ƒYZ:dFe:fdG„ƒYZ;eidHƒZ<eidIƒZ=dJfdK„ƒYZ>e?dLjoQdMe:fdN„ƒYZ@dOZAdkBZBeBiCeAƒZDe>e@ƒZEeEiFeDƒndS(Psë ConfigFile -- Interface to simple template based configuration files. The format of these files is as follows: globalvar = 2 [ABC] a = 1 b = abc.html c = text with spaces [DEF] a = 2 b = a + 3 c = a string Entries in square brackets indicate new subsections. Global variables may be set prior to starting any subsection. Emtpy lines and lines starting with '#' (comments) are ignored. Indentation is not necessary; lines can start at any column. Entries may span multiple lines by using '' continuations at the line ends, e.g. [Continuation] a = first line second line The lines are stripped of any white space before removing the trailing '' and concatenating them. Comment lines are removed as well. To parse these files, a template in form of a class including subclasses (identifying the subsections) must be given to the reader. This template defines which sections and attributes are known. All others are rejected. A sample template for the above looks like this: from mx.Misc.ConfigFile import * class Template(ConfigNamespace): global = IntegerEntry() class ABC(ConfigSection): a = IntegerEntry('0') b = StringEntry('default.html') c = StringEntry() class DEF(ConfigSection): a = IntegerEntry('0') b = EvalEntry('0') c = StringEntry('default value') The main class representing the global namespace of the ini file must have ConfigNamespace as baseclass. It may contain any number of ConfigSection subclasses each defining parsed attributes. The ini file may only contain entries defined in this template. In case an unkown section is found, the main class is looked up for a ConfigSection subclass with name 'DefaultSection'. This section object is then taken as template for a new section of the given name. The same feature is available for attributes in sections. In case a given attribute is not found in the templates, the section's 'DefaultAttribute' attribute is deepcopied and the used as attribute template. Needs mxTools to be installed. XXX Add support for long strings (including embedded control characters and spanning multiple lines) Copyright (c) 2000, Marc-Andre Lemburg; All Rights Reserved. See the documentation for further information on copyrights, or contact the author. All Rights Reserved. N(sfreezeisErrorcstZRS(N(s__name__s __module__(((s</mit/seven/lib/python2.2/site-packages/mx/Misc/ConfigFile.pysErrorYss"(?:\$([a-zA-Z0-9._]+)|\${([^}]*)})csˆx}dou|i|ƒ} | oPn| iƒ}||dp|ddƒ}|d}|i |t ƒ} | t jo<|i |t ƒ} | t jotii |dƒ} nnxH|dD]<}yt| |ƒ} Wn tj otd|‚nXqÀW| iƒ\} } t| tƒo=| } | i tjo| i| i||ƒn| i } n|| t| ƒ|| }qW|SdS(sú Expands all variables of the form $var or ${var} using the dictionaries locals,globals,os.environ in that order as database. Default value is the empty string, just like for shell environment variables. iis.ssattribute "%s" undefinedN(s shell_varssearchstextsmsgroupssgssplitsvarpathsvarnameslocalssgetsNonesvaluesglobalssossenvironsattrsgetattrsAttributeErrorsErrorsspanslsrs isinstancesEntrysentrysNotGivensparsesdefaultsstr(stextslocalssglobalsssplits shell_varsvarpathsattrsgsvarnamesmslsvaluesrsentry((s</mit/seven/lib/python2.2/site-packages/mx/Misc/ConfigFile.pys expand_vars`s8       !sEntrycsbtZdZeZdZeeefZ ed„Z d„Z e i ed„Zd„Zd„ZRS(sÙ Converts the value to another datatype depending on the .converters attribute. Each of those functions is applied to the value. The first one to not raise an exception succeeds. scs|tj o ||_ndS(N(sdefaultsNotGivensself(sselfsdefault((s</mit/seven/lib/python2.2/site-packages/mx/Misc/ConfigFile.pys__init__Ÿs csŠ|it|ƒ||ƒ}xB|iD]1}y||ƒ}PWnt i ƒd}nXq%W|‚t }|i |||ƒ|_}|SdS(s¬ Parse text according to the namespace dictionaries locals and globals. Sets self.value and returns the parsed value as well. iN(sselfs pre_processsstrstextslocalssglobalss converterss convertersvaluessyssexc_infoslastexcsNones post_process(sselfstextslocalssglobalssvalues converterslastexc((s</mit/seven/lib/python2.2/site-packages/mx/Misc/ConfigFile.pysparse¤s  cs|||ƒ||ƒSdS(sˆ Preprocess the text value. Default behaviour is to strip the text and then apply variable expansion. N(s expand_varssstripstextslocalssglobals(sselfstextslocalssglobalssstrips expand_vars((s</mit/seven/lib/python2.2/site-packages/mx/Misc/ConfigFile.pys pre_processºs cs|SdS(sŠ Postprocess the value after conversion has been applied. The default behaviour is to leave it as it is. N(svalue(sselfsvalueslocalssglobals((s</mit/seven/lib/python2.2/site-packages/mx/Misc/ConfigFile.pys post_processÆscs;|itjo|i|ihhƒnt|iƒSdS(sŽ Return a stringified version of self.value. The default value is parsed in case no value has yet been set. N(sselfsvaluesNotGivensparsesdefaultsstr(sself((s</mit/seven/lib/python2.2/site-packages/mx/Misc/ConfigFile.pys__str__Ïs(s__name__s __module__s__doc__sNotGivensvaluesdefaultsintsfloatsstrs converterss__init__sparsesstringsstrips expand_varss pre_processs post_processs__str__(((s</mit/seven/lib/python2.2/site-packages/mx/Misc/ConfigFile.pysEntry‹s    s IntegerEntrycstZdZefZRS(s' Converts the value to an integer. (s__name__s __module__s__doc__sints converters(((s</mit/seven/lib/python2.2/site-packages/mx/Misc/ConfigFile.pys IntegerEntryÝs s FloatEntrycstZdZefZRS(s$ Converts the value to a float. (s__name__s __module__s__doc__sfloats converters(((s</mit/seven/lib/python2.2/site-packages/mx/Misc/ConfigFile.pys FloatEntryãs s NumericEntrycstZdZeefZRS(s8 Converts the value to a number (integer or float). (s__name__s __module__s__doc__sintsfloats converters(((s</mit/seven/lib/python2.2/site-packages/mx/Misc/ConfigFile.pys NumericEntryés s StringEntrycstZdZefZRS(s% Converts the value to a string. (s__name__s __module__s__doc__sstrs converters(((s</mit/seven/lib/python2.2/site-packages/mx/Misc/ConfigFile.pys StringEntryïs cs||||dƒƒSdS(Ns,(smapsstripssplitstext(stextsstripssplitsmapstuple((s</mit/seven/lib/python2.2/site-packages/mx/Misc/ConfigFile.pys comma_listõscs||||ƒƒSdS(N(smapsstripssplitstext(stextsstripssplitsmapstuple((s</mit/seven/lib/python2.2/site-packages/mx/Misc/ConfigFile.pys spaced_listûss TupleEntrycs tZdZefZd„ZRS(sÛ Converts the value to a tuple of strings. value must be a string with entries separated by ','. Entries are split at each occurance of ',' and then stripped of surrounding spaces. cst|ƒSdS(N(stuplesvalue(sselfsvalueslocalssglobals((s</mit/seven/lib/python2.2/site-packages/mx/Misc/ConfigFile.pys post_process s(s__name__s __module__s__doc__s comma_lists converterss post_process(((s</mit/seven/lib/python2.2/site-packages/mx/Misc/ConfigFile.pys TupleEntrys  s ListEntrycstZdZefZRS(sÚ Converts the value to a list of strings. value must be a string with entries separated by ','. Entries are split at each occurance of ',' and then stripped of surrounding spaces. (s__name__s __module__s__doc__s comma_lists converters(((s</mit/seven/lib/python2.2/site-packages/mx/Misc/ConfigFile.pys ListEntrys sSpacedTupleEntrycstZdZefZRS(sØ Converts the value to a tuple of strings. value must be a string with entries separated by whitespace. Entries are split at each occurance of whitespace; surrounding spaces is removed. (s__name__s __module__s__doc__s spaced_lists converters(((s</mit/seven/lib/python2.2/site-packages/mx/Misc/ConfigFile.pysSpacedTupleEntry#s sSpacedListEntrycstZdZefZRS(s× Converts the value to a list of strings. value must be a string with entries separated by whitespace. Entries are split at each occurance of whitespace; surrounding spaces is removed. (s__name__s __module__s__doc__s spaced_lists converters(((s</mit/seven/lib/python2.2/site-packages/mx/Misc/ConfigFile.pysSpacedListEntry.s s FileEntrycstZdZefZRS(s! Entry field for an OS file. (s__name__s __module__s__doc__sstrs converters(((s</mit/seven/lib/python2.2/site-packages/mx/Misc/ConfigFile.pys FileEntry9s s PathEntrycs tZdZefZd„ZRS(sV Entry field for an OS path. Paths will always end with os.sep if given. cs4|o|dtijo|ti}n|SdS(Niÿÿÿÿ(svaluesosssep(sselfsvalueslocalssglobals((s</mit/seven/lib/python2.2/site-packages/mx/Misc/ConfigFile.pys post_processGs(s__name__s __module__s__doc__sstrs converterss post_process(((s</mit/seven/lib/python2.2/site-packages/mx/Misc/ConfigFile.pys PathEntry?s  sAbsoluteFileEntrycs tZdZefZd„ZRS(sm Entry field for an absolute OS pathname. The pathname will always start with os.sep if given. cs4|o|dtijoti|}n|SdS(Ni(svaluesosssep(sselfsvalueslocalssglobals((s</mit/seven/lib/python2.2/site-packages/mx/Misc/ConfigFile.pys post_processVs(s__name__s __module__s__doc__sstrs converterss post_process(((s</mit/seven/lib/python2.2/site-packages/mx/Misc/ConfigFile.pysAbsoluteFileEntryMs  sAbsolutePathEntrycs tZdZefZd„ZRS(sq Entry field for an absolute OS path. The pathname will always start and end with os.sep if given. cs]|oN|dtijoti|}n|dtijo|ti}nn|SdS(Niiÿÿÿÿ(svaluesosssep(sselfsvalueslocalssglobals((s</mit/seven/lib/python2.2/site-packages/mx/Misc/ConfigFile.pys post_processes (s__name__s __module__s__doc__sstrs converterss post_process(((s</mit/seven/lib/python2.2/site-packages/mx/Misc/ConfigFile.pysAbsolutePathEntry\s  sRelativePathEntrycs#tZdZed„Zd„ZRS(sÔ Entry field for relative paths. The path stored is the result of joining the given parameter with a basepath. basepath is subject to variable expansion at parsing time. cs||_ti||ƒdS(N(sbasepathsselfs PathEntrys__init__sdefault(sselfsbasepathsdefault((s</mit/seven/lib/python2.2/site-packages/mx/Misc/ConfigFile.pys__init__ws cs&tiit|i||ƒ|ƒSdS(N( sosspathsjoins expand_varssselfsbasepathslocalssglobalssvalue(sselfsvalueslocalssglobals((s</mit/seven/lib/python2.2/site-packages/mx/Misc/ConfigFile.pys post_process|s(s__name__s __module__s__doc__sNotGivens__init__s post_process(((s</mit/seven/lib/python2.2/site-packages/mx/Misc/ConfigFile.pysRelativePathEntryns  sRelativeFileEntrycs#tZdZed„Zd„ZRS(sá Entry field for relative pathnames to files. The path stored is the result of joining the given parameter with a basepath. basepath is subject to variable expansion at parsing time. cs||_ti||ƒdS(N(sbasepathsselfs PathEntrys__init__sdefault(sselfsbasepathsdefault((s</mit/seven/lib/python2.2/site-packages/mx/Misc/ConfigFile.pys__init__‰s cs&tiit|i||ƒ|ƒSdS(N( sosspathsjoins expand_varssselfsbasepathslocalssglobalssvalue(sselfsvalueslocalssglobals((s</mit/seven/lib/python2.2/site-packages/mx/Misc/ConfigFile.pys post_processŽs(s__name__s __module__s__doc__sNotGivens__init__s post_process(((s</mit/seven/lib/python2.2/site-packages/mx/Misc/ConfigFile.pysRelativeFileEntry€s  sExistingPathEntrycstZdZd„ZRS(sl Checks value to point to an existing OS path. Raises an exception if the path does not exist. csY|o|dtijo|ti}ntii|ƒ otd|‚n|SdS(Niÿÿÿÿsnon existing path "%s"(svaluesosssepspathsexistssError(sselfsvalueslocalssglobals((s</mit/seven/lib/python2.2/site-packages/mx/Misc/ConfigFile.pys post_process˜s (s__name__s __module__s__doc__s post_process(((s</mit/seven/lib/python2.2/site-packages/mx/Misc/ConfigFile.pysExistingPathEntry’s sExistingFileEntrycstZdZd„ZRS(si Checks value to point to an existing file. Raises an exception if the file does not exist. cs5| ptii|ƒ otd|‚n|SdS(Nsnon existing file "%s"(svaluesosspathsexistssError(sselfsvalueslocalssglobals((s</mit/seven/lib/python2.2/site-packages/mx/Misc/ConfigFile.pys post_process¦s(s__name__s __module__s__doc__s post_process(((s</mit/seven/lib/python2.2/site-packages/mx/Misc/ConfigFile.pysExistingFileEntry s sExistingRelativePathEntrycstZdZd„ZRS(sÊ Entry field for relative paths. The path stored is the result of joining the given parameter with a basepath. Raises an exception if the path does not exist. csQtiit|i||ƒ|ƒ}tii |ƒ ot d|‚n|SdS(Nsnon existing path "%s"( sosspathsjoins expand_varssselfsbasepathslocalssglobalssvaluesexistssError(sselfsvalueslocalssglobals((s</mit/seven/lib/python2.2/site-packages/mx/Misc/ConfigFile.pys post_processµs$(s__name__s __module__s__doc__s post_process(((s</mit/seven/lib/python2.2/site-packages/mx/Misc/ConfigFile.pysExistingRelativePathEntry¬s sURLEntrycstZdZd„ZRS(s Entry field for URLs. The field takes a default value as argument. Needs mxHTMLTools to be installed. csdkl}|i|ƒSdS(N(s HTMLTools(smxs HTMLToolssURLsvalue(sselfsvalueslocalssglobalss HTMLTools((s</mit/seven/lib/python2.2/site-packages/mx/Misc/ConfigFile.pys post_processÅs (s__name__s __module__s__doc__s post_process(((s</mit/seven/lib/python2.2/site-packages/mx/Misc/ConfigFile.pysURLEntry¼s sRelativeURLEntrycs&tZdZded„Zd„ZRS(sÌ Entry field for relative URLs. A base URL can be set which is then urljoined with the value given. The field also takes a default value. Needs mxHTMLTools to be installed. scs||_ti||ƒdS(N(sbaseurlsselfs StringEntrys__init__sdefault(sselfsbaseurlsdefault((s</mit/seven/lib/python2.2/site-packages/mx/Misc/ConfigFile.pys__init__Ôs cs0dkl}|it|i||ƒ|ƒSdS(N(s HTMLTools( smxs HTMLToolssurljoins expand_varssselfsbaseurlslocalssglobalssvalue(sselfsvalueslocalssglobalss HTMLTools((s</mit/seven/lib/python2.2/site-packages/mx/Misc/ConfigFile.pys post_processÙs (s__name__s __module__s__doc__sNotGivens__init__s post_process(((s</mit/seven/lib/python2.2/site-packages/mx/Misc/ConfigFile.pysRelativeURLEntryÊs sAbsoluteURLEntrycstZdZd„ZRS(sº Entry field for absolute URLs. A base URL can be set which is then urljoined with the value given. The field also takes a default value as second argument. cs<ti||||ƒ}|i otd|‚n|SdS(Nsneed an absolute URL: "%s"( sRelativeURLEntrys post_processsselfsvalueslocalssglobalssurlsabsolutesError(sselfsvalueslocalssglobalssurl((s</mit/seven/lib/python2.2/site-packages/mx/Misc/ConfigFile.pys post_processçs (s__name__s __module__s__doc__s post_process(((s</mit/seven/lib/python2.2/site-packages/mx/Misc/ConfigFile.pysAbsoluteURLEntryßs s DateEntrycstZdZd„ZRS(s› Date entry field. The value is stored using a DateTime instance. A time part is ignored. Needs mxDateTime to be installed. csdkl}||ƒSdS(N(sDateFromString(smx.DateTime.ParsersDateFromStringsvalue(sselfsvalueslocalssglobalssDateFromString((s</mit/seven/lib/python2.2/site-packages/mx/Misc/ConfigFile.pys post_processøs (s__name__s __module__s__doc__s post_process(((s</mit/seven/lib/python2.2/site-packages/mx/Misc/ConfigFile.pys DateEntryîs s DateTimeEntrycstZdZd„ZRS(s€ Date/time entry field. The value is stored using a DateTime instance. Needs mxDateTime to be installed. csdkl}||ƒSdS(N(sDateTimeFromString(smx.DateTime.ParsersDateTimeFromStringsvalue(sselfsvalueslocalssglobalssDateTimeFromString((s</mit/seven/lib/python2.2/site-packages/mx/Misc/ConfigFile.pys post_processs (s__name__s __module__s__doc__s post_process(((s</mit/seven/lib/python2.2/site-packages/mx/Misc/ConfigFile.pys DateTimeEntryýs s TimeEntrycstZdZd„ZRS(s  Time entry field. The value is stored using a DateTimeDelta instance. A date part is ignored. Needs mxDateTime to be installed. csdkl}||ƒSdS(N(sTimeFromString(smx.DateTime.ParsersTimeFromStringsvalue(sselfsvalueslocalssglobalssTimeFromString((s</mit/seven/lib/python2.2/site-packages/mx/Misc/ConfigFile.pys post_processs (s__name__s __module__s__doc__s post_process(((s</mit/seven/lib/python2.2/site-packages/mx/Misc/ConfigFile.pys TimeEntry s sDateTimeDeltaEntrycstZdZd„ZRS(s‹ Date/time delta entry field. The value is stored using a DateTimeDelta instance. Needs mxDateTime to be installed. csdkl}||ƒSdS(N(sDateTimeDeltaFromString(smx.DateTime.ParsersDateTimeDeltaFromStringsvalue(sselfsvalueslocalssglobalssDateTimeDeltaFromString((s</mit/seven/lib/python2.2/site-packages/mx/Misc/ConfigFile.pys post_process#s (s__name__s __module__s__doc__s post_process(((s</mit/seven/lib/python2.2/site-packages/mx/Misc/ConfigFile.pysDateTimeDeltaEntrys sRelativeDateTimeEntrycstZdZd„ZRS(s‘ Relative date/time entry field. The value is stored using a RelativeDateTime instance. Needs mxDateTime to be installed. csdkl}||ƒSdS(N(sRelativeDateTimeFromString(smx.DateTime.ParsersRelativeDateTimeFromStringsvalue(sselfsvalueslocalssglobalssRelativeDateTimeFromString((s</mit/seven/lib/python2.2/site-packages/mx/Misc/ConfigFile.pys post_process1s (s__name__s __module__s__doc__s post_process(((s</mit/seven/lib/python2.2/site-packages/mx/Misc/ConfigFile.pysRelativeDateTimeEntry(s s EvalEntrycstZdZed„ZRS(s  Allows simple calculations to be done using the current locals (the symbols defined in the class where the entry is located) and globals. cs ||||ƒ|_|iSdS(N(sevalstextslocalssglobalssselfsvalue(sselfstextslocalssglobalsseval((s</mit/seven/lib/python2.2/site-packages/mx/Misc/ConfigFile.pysparse=s(s__name__s __module__s__doc__sevalsparse(((s</mit/seven/lib/python2.2/site-packages/mx/Misc/ConfigFile.pys EvalEntry6s s SafeEvalEntrycstZdZed„ZRS(sÅ Allows simple calculations to be done using the current locals (the symbols defined in the class where the entry is located) and globals. Builtins are not available. cs ||||ƒ|_|iSdS(N(srevalstextslocalssglobalssselfsvalue(sselfstextslocalssglobalssreval((s</mit/seven/lib/python2.2/site-packages/mx/Misc/ConfigFile.pysparseMs(s__name__s __module__s__doc__srevalsparse(((s</mit/seven/lib/python2.2/site-packages/mx/Misc/ConfigFile.pys SafeEvalEntryDs s DictEntrycstZdZd„ZRS(s± Allows the construction of a Python dictionary. The entries value is taken as list of key: value pairs which are evaluated in the current locals (the symbols defined in the class where the entry is located) and globals. Parsing is left to the Python interpreter. The needed curly brackets {} are added by the parsing method. Sample: dict = 'a': (1,2,3), 'b': (3,4,5) cs(td|d||ƒ|_|iSdS(Ns{s}(sevalstextslocalssglobalssselfsvalue(sselfstextslocalssglobals((s</mit/seven/lib/python2.2/site-packages/mx/Misc/ConfigFile.pysparseds(s__name__s __module__s__doc__sparse(((s</mit/seven/lib/python2.2/site-packages/mx/Misc/ConfigFile.pys DictEntryTs sConfigNamespacecsŒtZeZeZeeieiei ei fei ei ei eieifeieid„Zd„Zd„Zd„Zd„ZRS(Nc s|i}t|ƒ|i} | i|iƒxì| iƒD]Þ\}}|d djo | |=nt |ƒ} | |jo2|djo t |tƒo|ƒ| |