³ò æßCc@s´dZddkZddkZddklZddklZdefd„ƒYZd„Z ddd „ƒYZ d „Z d „Z d dd „ƒYZ eid„Zdd„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) iÿÿÿÿN(t StringType(t tokenprogt ItplErrorcBseZd„Zd„ZRS(cCs||_||_dS(N(ttexttpos(tselfRR((sItpl.pyt__init__4s cCsdt|iƒ|ifS(Ns&unfinished expression in %s at char %d(treprRR(R((sItpl.pyt__str__7s(t__name__t __module__RR(((sItpl.pyR3s cCsBti||ƒ}|djot||ƒ‚n||iƒfS(N(RtmatchtNoneRtend(RRR ((sItpl.pyt matchorfail;s tItplcBs)eZdZd„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.c Cs;t|ƒtjo td‚n||_d}g}d}xÂti|d|ƒ}|djoPn||d}|djoË|id|||!fƒ|dd}}xw|oot||ƒ\}}|id\} } || | !} | djo|d}q®| d jo|d}q®q®W|id||d|d!fƒq>||jos|id|||!fƒt||dƒ\}}x|t |ƒjo||d joI|dt |ƒjo2||d|jot||dƒ\}}qŽ||d jo—|dd}}x„|owt||ƒ\}}|id\} } || | !} | dd jo|d}q | dd jo|d}q q WqŽPqŽW|id||d|!fƒq>|id|||d!fƒ|d|dj}q>|t |ƒjo|id||fƒn||_ d S(sThe single 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.sneeds string initializert?abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789_it$it{iit}t.s([s)]N( ttypeRt TypeErrortformattstringtfindtappendRtregstlentchunks( RRt namecharsRRtdollartnextchartlevelR ttstartttendttoken((sItpl.pyRIsR      & ,  (".cCsdt|iƒdS(Ns(RR(R((sItpl.pyt__repr__sc CsÁy ddWntii}nXx"|idtjo |i}q%W|i|i}}g}xN|iD]C\}}|o#|it t |||ƒƒƒqj|i|ƒqjWt i |dƒS(s<Evaluate and substitute the appropriate parts of the string.iiR t( tsyst exc_tracebackttb_framet f_globalsR tf_backtf_localsRRtstrtevalRtjoin(Rtframetloctglobtresulttlivetchunk((sItpl.pyRs% *(R R t__doc__RR&R(((sItpl.pyRAs D cCstt|ƒƒS(N(R.R(R((sItpl.pytitplŸscCst|ƒGHdS(N(R8(R((sItpl.pytprintpl stItplFilecBs2eZdZd„Zd„Zd„Zd„ZRS(s@A file object that filters each write() through an interpolator.cCs ||_dS(N(tfile(RR;((sItpl.pyR¤scCsdt|iƒdS(NsR?(((sItpl.pyR:¢s    cCs t|ƒS(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.(R:(R;((sItpl.pytfilter©scCs|o |ip tiiS(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()'.(R;R(tstdout(tifile((sItpl.pytunfilter±s(((R7R(RttypesRttokenizeRt ValueErrorRRRR8R9R:RAR@R RC(((sItpl.pys-s ^