;ς ΞΡAHc@sdZdZdZdkZdkZdklZdklZde fd„ƒYZ d„Z yei i pd ZWnej o d ZnXd fd „ƒYZd efd „ƒYZd„Zd„Zed„Zed„Zdfd„ƒYZeid„Zed„ZdS(sώString interpolation for Python (by Ka-Ping Yee, 14 Feb 2000). This module lets you quickly and conveniently interpolate values into strings (in the flavour of Perl or Tcl, but with less extraneous punctuation). You get a bit more power than in the other languages, because this module allows subscripting, slicing, function calls, attribute lookup, or arbitrary expressions. Variables and expressions are evaluated in the namespace of the caller. The itpl() function returns the result of interpolating a string, and printpl() prints out an interpolated string. Here are some examples: from Itpl import printpl printpl("Here is a $string.") printpl("Here is a $module.member.") printpl("Here is an $object.member.") printpl("Here is a $functioncall(with, arguments).") printpl("Here is an ${arbitrary + expression}.") printpl("Here is an $array[3] member.") printpl("Here is a $dictionary['member'].") The filter() function filters a file object so that output through it is interpolated. This lets you produce the illusion that Python knows how to do interpolation: import Itpl sys.stdout = Itpl.filter() f = "fancy" print "Isn't this $f?" print "Standard output has been replaced with a $sys.stdout object." sys.stdout = Itpl.unfilter() print "Okay, back $to $normal." Under the hood, the Itpl class represents a string that knows how to interpolate values. An instance of the class parses the string once upon initialization; the evaluation and substitution can then be done each time the instance is evaluated with str(instance). For example: from Itpl import Itpl s = Itpl("Here is $foo.") foo = 5 print str(s) foo = "bar" print str(s) $Id: Itpl.py 2918 2007-12-31 14:34:47Z vivainio $ sKa-Ping Yee sMITN(s tokenprog(s StringTypes ItplErrorcBstZd„Zd„ZRS(NcCs||_||_dS(N(stextsselfspos(sselfstextspos((s</nyx/web/d/b/dbachman/work/src/ipython-0.8.4/IPython/Itpl.pys__init__Vs cCsdt|iƒ|ifSdS(Ns&unfinished expression in %s at char %d(sreprsselfstextspos(sself((s</nyx/web/d/b/dbachman/work/src/ipython-0.8.4/IPython/Itpl.pys__str__Ys(s__name__s __module__s__init__s__str__(((s</nyx/web/d/b/dbachman/work/src/ipython-0.8.4/IPython/Itpl.pys ItplErrorUs cCsFti||ƒ}|tjot||ƒ‚n||iƒfSdS(N(s tokenprogsmatchstextspossNones ItplErrorsend(stextspossmatch((s</nyx/web/d/b/dbachman/work/src/ipython-0.8.4/IPython/Itpl.pys matchorfail]s sasciisItplcBs8tZdZedd„Zd„Zd„Zd„ZRS(s*Class representing a string with interpolation abilities. Upon creation, an instance works out what parts of the format string are literal and what parts need to be evaluated. The evaluation and substitution happens in the namespace of the caller when str(instance) is called.sbackslashreplacecCs^t|tƒ o td‚n||_||_||_d} g} d}xΥnoΝt i |d|ƒ}|djoPn||d} | djoΠ| id|||!fƒ|ddf\}}xw|oot||ƒ\} }| id\}}|||!} | djo|d}qΚ| d jo|d}qΚqΚW| id||d|d!fƒqN| | jox| id|||!fƒt||dƒ\} }x |t|ƒjo ||d jo)|dt|ƒjo||d| jot||dƒ\} }qͺ||d joœ|ddf\}}x„|owt||ƒ\} }| id\}}|||!} | dd jo|d}qA| dd jo|d}qAqAWqͺPqͺW| id||d|!fƒqN| id|||d!fƒ|d| dj}qUW|t|ƒjo| id||fƒn| |_d S(sŒThe single mandatory argument to this constructor is a format string. The format string is parsed according to the following rules: 1. A dollar sign and a name, possibly followed by any of: - an open-paren, and anything up to the matching paren - an open-bracket, and anything up to the matching bracket - a period and a name any number of times, is evaluated as a Python expression. 2. A dollar sign immediately followed by an open-brace, and anything up to the matching close-brace, is evaluated as a Python expression. 3. Outside of the expressions described in the above two rules, two dollar signs in a row give you one literal dollar sign. Optional arguments: - codec('utf_8'): a string containing the name of a valid Python codec. - encoding_errors('backslashreplace'): a string with a valid error handling policy. See the codecs module documentation for details. These are used to encode the format string if a call to str() fails on the expanded result.sneeds string initializers?abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789_iis$s{iis}s.s([s)]N(s isinstancesformats basestrings TypeErrorsselfscodecsencoding_errorss namecharsschunksspossstringsfindsdollarsnextcharsappendslevels matchorfailsmatchsregsststartstendstokenslen(sselfsformatscodecsencoding_errorsstendsdollarslevelsposststarts namecharsstokensnextcharschunkssmatch((s</nyx/web/d/b/dbachman/work/src/ipython-0.8.4/IPython/Itpl.pys__init__ssj         & = "cCsdt|iƒSdS(Ns (sreprsselfsformat(sself((s</nyx/web/d/b/dbachman/work/src/ipython-0.8.4/IPython/Itpl.pys__repr__Εsc CsΧg}|i}xx|iD]m\}}|oPt|||ƒ}y|t |ƒƒWq†t j o|t |ƒƒq†Xq||ƒqWdi|ƒ}yt |ƒSWn)tj o|i|i|iƒSnXdS(sEvaluate to a string in the given globals/locals. The final output is built by calling str(), but if this fails, the result is encoded with the instance's codec and error handling policy, via a call to out.encode(self.codec,self.encoding_errors)sN(sresultsappendsappsselfschunkssliveschunksevalsglobslocsvalsstrsUnicodeEncodeErrorsunicodesjoinsouts UnicodeErrorsencodescodecsencoding_errors( sselfsglobslocsvalschunkslivesresultsoutsapp((s</nyx/web/d/b/dbachman/work/src/ipython-0.8.4/IPython/Itpl.pys_strΘs"  cCs`tidƒ}x"|idtjo |i}qW|i|if\}}|i ||ƒSdS(s<Evaluate and substitute the appropriate parts of the string.is__name__N( ssyss _getframesframes f_globalss__name__sf_backsf_localsslocsglobsselfs_str(sselfslocsglobsframe((s</nyx/web/d/b/dbachman/work/src/ipython-0.8.4/IPython/Itpl.pys__str__ίs(s__name__s __module__s__doc__s itpl_encodings__init__s__repr__s_strs__str__(((s</nyx/web/d/b/dbachman/work/src/ipython-0.8.4/IPython/Itpl.pysItplks R  sItplNScBs2tZdZeddd„Zd„Zd„ZRS(stClass representing a string with interpolation abilities. This inherits from Itpl, but at creation time a namespace is provided where the evaluation will occur. The interpolation becomes a bit more efficient, as no traceback needs to be extracte. It also allows the caller to supply a different namespace for the interpolation to occur than its own.sutf_8sbackslashreplacecCsC|tjo |}n||_||_ti||||ƒdS(sItplNS(format,globals[,locals]) -> interpolating string instance. This constructor, besides a format string, takes a globals dictionary and optionally a locals (which defaults to globals if not provided). For further details, see the Itpl constructor.N( slocalssNonesglobalssselfsItpls__init__sformatscodecsencoding_errors(sselfsformatsglobalsslocalsscodecsencoding_errors((s</nyx/web/d/b/dbachman/work/src/ipython-0.8.4/IPython/Itpl.pys__init__σs     cCs|i|i|iƒSdS(s<Evaluate and substitute the appropriate parts of the string.N(sselfs_strsglobalsslocals(sself((s</nyx/web/d/b/dbachman/work/src/ipython-0.8.4/IPython/Itpl.pys__str__scCsdt|iƒSdS(Ns (sreprsselfsformat(sself((s</nyx/web/d/b/dbachman/work/src/ipython-0.8.4/IPython/Itpl.pys__repr__s(s__name__s __module__s__doc__sNones__init__s__str__s__repr__(((s</nyx/web/d/b/dbachman/work/src/ipython-0.8.4/IPython/Itpl.pysItplNSκs  cCstt|ƒƒSdS(N(sstrsItplstext(stext((s</nyx/web/d/b/dbachman/work/src/ipython-0.8.4/IPython/Itpl.pysitpl scCst|ƒGHdS(N(sitplstext(stext((s</nyx/web/d/b/dbachman/work/src/ipython-0.8.4/IPython/Itpl.pysprintpl scCstt|||ƒƒSdS(N(sstrsItplNSstextsglobalsslocals(stextsglobalsslocals((s</nyx/web/d/b/dbachman/work/src/ipython-0.8.4/IPython/Itpl.pysitplns scCst|||ƒGHdS(N(sitplnsstextsglobalsslocals(stextsglobalsslocals((s</nyx/web/d/b/dbachman/work/src/ipython-0.8.4/IPython/Itpl.pys printplnsssItplFilecBs2tZdZd„Zd„Zd„Zd„ZRS(s@A file object that filters each write() through an interpolator.cCs ||_dS(N(sfilesself(sselfsfile((s</nyx/web/d/b/dbachman/work/src/ipython-0.8.4/IPython/Itpl.pys__init__scCsdt|iƒdSdS(Ns(sreprsselfsfile(sself((s</nyx/web/d/b/dbachman/work/src/ipython-0.8.4/IPython/Itpl.pys__repr__scCst|i|ƒSdS(N(sgetattrsselfsfilesattr(sselfsattr((s</nyx/web/d/b/dbachman/work/src/ipython-0.8.4/IPython/Itpl.pys __getattr__scCs |iitt|ƒƒƒdS(N(sselfsfileswritesstrsItplstext(sselfstext((s</nyx/web/d/b/dbachman/work/src/ipython-0.8.4/IPython/Itpl.pyswrites(s__name__s __module__s__doc__s__init__s__repr__s __getattr__swrite(((s</nyx/web/d/b/dbachman/work/src/ipython-0.8.4/IPython/Itpl.pysItplFiles    cCst|ƒSdS(sνReturn an ItplFile that filters writes to the given file object. 'file = filter(file)' replaces 'file' with a filtered object that has a write() method. When called with no argument, this creates a filter to sys.stdout.N(sItplFilesfile(sfile((s</nyx/web/d/b/dbachman/work/src/ipython-0.8.4/IPython/Itpl.pysfilterscCs|o|ip tiiSdS(sΩReturn the original file that corresponds to the given ItplFile. 'file = unfilter(file)' undoes the effect of 'file = filter(file)'. 'sys.stdout = unfilter()' undoes the effect of 'sys.stdout = filter()'.N(sifilesfilessyssstdout(sifile((s</nyx/web/d/b/dbachman/work/src/ipython-0.8.4/IPython/Itpl.pysunfilters(s__doc__s __author__s __license__sstringssysstokenizes tokenprogstypess StringTypes ValueErrors ItplErrors matchorfailsstdinsencodings itpl_encodingsAttributeErrorsItplsItplNSsitplsprintplsNonesitplnss printplnssItplFilesstdoutsfiltersunfilter(s StringTypesstrings __license__sitplsItplNSsfiltersunfilters ItplErrors __author__ssyssitplnss itpl_encodings printplnss tokenprogsItplFiles matchorfailsprintplsItpl((s</nyx/web/d/b/dbachman/work/src/ipython-0.8.4/IPython/Itpl.pys?0s*