;ò "h>c@s&dZdkZdkZdklZlZlZdkZdZei deefƒZ ei dƒZ hdd<dd <d d>> template = Template("../templates/log.ezt") or by calling the parse() method of a template instance directly with a EZT template string: >>> template = Template() >>> template.parse(''' ... [title_string] ...

[title_string]

... [for a_sequence]

[a_sequence]

... [end]
... The [person] is [if-any state]in[else]out[end]. ... ... ... ''') The application should build a dictionary 'data' and pass it together with the output fileobject to the templates generate method: >>> data = {'title_string' : "A Dummy Page", ... 'a_sequence' : ['list item 1', 'list item 2', 'another element'], ... 'person': "doctor", ... 'state' : None } >>> import sys >>> template.generate(sys.stdout, data) A Dummy Page

A Dummy Page

list item 1

list item 2

another element

The doctor is out. Template syntax error reporting should be improved. Currently it is very sparse (template line numbers would be nice): >>> Template().parse("[if-any where] foo [else] bar [end unexpected args]") Traceback (innermost last): File "", line 1, in ? File "ezt.py", line 220, in parse self.program = self._parse(text) File "ezt.py", line 275, in _parse raise ArgCountSyntaxError(str(args[1:])) ArgCountSyntaxError: ['unexpected', 'args'] >>> Template().parse("[if unmatched_end]foo[end]") Traceback (innermost last): File "", line 1, in ? File "ezt.py", line 206, in parse self.program = self._parse(text) File "ezt.py", line 266, in _parse raise UnmatchedEndError() UnmatchedEndError Directives ========== Several directives allow the use of dotted qualified names refering to objects or attributes of objects contained in the data dictionary given to the .generate() method. Simple directives ----------------- [QUAL_NAME] This directive is simply replaced by the value of identifier from the data dictionary. QUAL_NAME might be a dotted qualified name refering to some instance attribute of objects contained in the dats dictionary. Numbers are converted to string though. [include "filename"] or [include QUAL_NAME] This directive is replaced by content of the named include file. Block directives ---------------- [for QUAL_NAME] ... [end] The text within the [for ...] directive and the corresponding [end] is repeated for each element in the sequence referred to by the qualified name in the for directive. Within the for block this identifiers now refers to the actual item indexed by this loop iteration. [if-any QUAL_NAME [QUAL_NAME2 ...]] ... [else] ... [end] Test if any QUAL_NAME value is not None or an empty string or list. The [else] clause is optional. CAUTION: Numeric values are converted to string, so if QUAL_NAME refers to a numeric value 0, the then-clause is substituted! [if-index INDEX_FROM_FOR odd] ... [else] ... [end] [if-index INDEX_FROM_FOR even] ... [else] ... [end] [if-index INDEX_FROM_FOR first] ... [else] ... [end] [if-index INDEX_FROM_FOR last] ... [else] ... [end] [if-index INDEX_FROM_FOR NUMBER] ... [else] ... [end] These five directives work similar to [if-any], but are only useful within a [for ...]-block (see above). The odd/even directives are for example useful to choose different background colors for adjacent rows in a table. Similar the first/last directives might be used to remove certain parts (for example "Diff to previous" doesn't make sense, if there is no previous). [is QUAL_NAME STRING] ... [else] ... [end] [is QUAL_NAME QUAL_NAME] ... [else] ... [end] The [is ...] directive is similar to the other conditional directives above. But it allows to compare two value references or a value reference with some constant string. N(s StringTypesIntTypes FloatTypes(?:"(?:[^\\"]|\\.)*"|[-\w.]+)s&\[(%s(?: +%s)*)\]|(\[\[\])|\[#[^\]]*\]s"(?:[^\\"]|\\.)*"|[-\w.]+sif-indexisforisiss [ ]* \s*s\s\s+s %(%|[0-9]+)sTemplatecBs’tZedd„Zd„Zd„Zd„Zefd„Zd„Zd„Z d „Z d „Z d „Z d „Z d „Zd„Zd„ZRS(NicCs%||_|o|i|ƒndS(N(scompress_whitespacesselfsfnames parse_file(sselfsfnamescompress_whitespace((sbuild/generator/ezt.pys__init__Ós cCs|it|ƒƒ|_dS(sHfname -> a string object with pathname of file containg an EZT template.N(sselfs_parses _FileReadersfnamesprogram(sselfsfname((sbuild/generator/ezt.pys parse_fileØscCs7t|tƒ ot|ƒ}n|i|ƒ|_dS(s¾Parse the template specified by text_or_reader. The argument should be a string containing the template, or it should specify a subclass of ezt.Reader which can read templates. N(s isinstancestext_or_readersReaders _TextReadersselfs_parsesprogram(sselfstext_or_reader((sbuild/generator/ezt.pysparseÝscCs5tƒ}||_h|_|i|i||ƒdS(N(s_contextsctxsdatas for_indexsselfs_executesprogramsfp(sselfsfpsdatasctx((sbuild/generator/ezt.pysgenerateès   cCsti|iƒ}g}g} | o g}nxÉtt |ƒƒD]µ}||}|d}|djoH|o=|io"tidtid|ƒƒ}n|i|ƒqøqC|djo|o|idƒqøqC|oti|ƒ} | d}|djo^t | ƒdjott| dƒƒ‚n| d d} || }|| 3|| d d string object containing the HTML template. This is a private helper function doing the real work for method parse. It returns the parsed template as a 'program'. This program is a sequence made out of strings or (function, argument) 2-tuples. Note: comment directives [# ...] are automatically dropped by _re_parse. iis s is[selseiiÿÿÿÿsends_cmd_s-s_sforsissincludes"sif-anyN(1s _re_parsessplitsreaderstextspartssprogramsstacks for_namessrangeslensispieceswhichsselfscompress_whitespaces_re_whitespacessubs _re_newlinesappends_re_argssfindallsargsscmdsArgCountSyntaxErrorsstrsidxs true_sectionspops IndexErrorsUnmatchedEndErrors else_sectionsgetattrsresfuncs _block_cmdss_block_cmd_specss _prepare_refs file_argssNonesinclude_filenamesf_argssargsextends_parses read_others _cmd_includes _cmd_formats _cmd_printsUnclosedBlocksError(sselfsreaders for_namess file_argssargsprogramswhichsinclude_filenamesf_argssargssfuncs else_sectionsstacksidxs true_sectionscmdspartssispiece((sbuild/generator/ezt.pys_parseîsœ     "      "    '  0  #(. cCsNxG|D]?}t|tƒo|i|ƒq|d|d||ƒqWdS(sËThis private helper function takes a 'program' sequence as created by the method '_parse' and executes it step by step. strings are written to the file object 'fp' and functions are called. iiN(sprogramssteps isinstances StringTypesfpswritesctx(sselfsprogramsfpsctxsstep((sbuild/generator/ezt.pys_executeXs cCslt||ƒ}t|dƒo<xFno-|idƒ}| oPn|i|ƒq)Wn|i|ƒdS(Nsreadii@( s _get_valuesvalrefsctxsvalueshasattrsreadschunksfpswrite(sselfsvalrefsfpsctxsvalueschunk((sbuild/generator/ezt.pys _cmd_printcsc CsÀ|\}}t||ƒ} ti| ƒ}xtt |ƒƒD]{}||} |ddjo | djo@t | ƒ}|t |ƒjot|||ƒ} q«d} n|i| ƒq=WdS(Niis%s(svalrefsargss _get_valuesctxsfmts _re_substssplitspartssrangeslensispiecesintsidxsfpswrite( sselfs.2sfpsctxsvalrefsargssidxsispartsspiecesfmt((sbuild/generator/ezt.pys _cmd_formatps    cCsD|\}}t||ƒ}|i|i|i|ƒƒ||ƒdS(N( svalrefsreaders _get_valuesctxsfnamesselfs_executes_parses read_othersfp(sselfs.2sfpsctxsvalrefsreadersfname((sbuild/generator/ezt.pys _cmd_include}s c Cs^|\}}}d}x)|D]!}t||ƒo d}PqqW|i |||||ƒdS(sDIf any value is a non-empty string or non-empty list, then T else F.iiN( sargssvalrefss t_sections f_sectionsvaluesvalrefs _get_valuesctxsselfs_do_ifsfp( sselfsargssfpsctxsvalrefssvalues t_sectionsvalrefs f_section((sbuild/generator/ezt.pys _cmd_if_anyƒs c Csá|\\}}}} |i|d\}}|djo|ddj}nx|djo|ddj}nW|djo|dj}n:|djo|t |ƒdj}n|t |ƒj}|i ||| ||ƒdS(Nisevenisoddisfirstslast(sargssvalrefsvalues t_sections f_sectionsctxs for_indexslistsidxslensintsselfs_do_ifsfp( sselfsargssfpsctxsidxslistsvalues t_sectionsvalrefs f_section((sbuild/generator/ezt.pys _cmd_if_indexs    c Csh|\\}}}}t||ƒ}ti t||ƒƒti |ƒj}|i |||||ƒdS(N( sargssleft_refs right_refs t_sections f_sections _get_valuesctxsvaluesstringslowersselfs_do_ifsfp( sselfsargssfpsctxs right_refsleft_refsvalues t_sections f_section((sbuild/generator/ezt.pys_cmd_isœs'cCs\|tjo|}t}n|o |}n|}|tj o|i|||ƒndS(N( s t_sectionsNones f_sectionsvaluessectionsselfs_executesfpsctx(sselfsvalues t_sections f_sectionsfpsctxssection((sbuild/generator/ezt.pys_do_if¢s    c Cs£|\\} }} t| |ƒ}t|tƒo t ƒ‚n| d}|dg|i |<}x3|D]+}|i| ||ƒ|dd|d a string containing a dotted identifier. example:"foo.bar.bang" for_names -> a list of active for sequences. Returns a `value reference', a 3-Tupel made out of (refname, start, rest), for fast access later. is"iiÿÿÿÿisargs.N(srefnamesNonesintsidxs ValueErrorslens file_argssstringssplitspartssstartsrests for_namessname(srefnames for_namess file_argssidxsstartspartssrestsname((sbuild/generator/ezt.pys _prepare_refÀs*    c Cs|\}}}|tjo|Sn|ii|ƒo!|i|\}}||}n1|i i|ƒo|i |}n t |ƒ‚xC|D];}yt ||ƒ}Wqtj ot |ƒ‚qXqWt|tƒp t|tƒot|ƒSn|tjodSn|SdS(s(refname, start, rest) -> a prepared `value reference' (see above). ctx -> an execution context instance. Does a name space lookup within the template name space. Active for blocks take precedence over data dictionary members with the same name. sN(srefnamesstartsrestsNonesctxs for_indexshas_keyslistsidxsobsdatasUnknownReferencesattrsgetattrsAttributeErrors isinstancesIntTypes FloatTypesstr( s.0sctxsrefnamesstartsrestsattrsidxslistsob((sbuild/generator/ezt.pys _get_valueâs(    s_contextcBstZdZRS(s%A container for the execution context(s__name__s __module__s__doc__(((sbuild/generator/ezt.pys_contexts sReadercBstZdZRS(s9Abstract class which allows EZT to detect Reader objects.(s__name__s __module__s__doc__(((sbuild/generator/ezt.pysReader s s _FileReadercBs tZdZd„Zd„ZRS(s$Reads templates from the filesystem.cCs1t|dƒiƒ|_tii|ƒ|_dS(Nsrb( sopensfnamesreadsselfstextsosspathsdirnames_dir(sselfsfname((sbuild/generator/ezt.pys__init__scCs ttii|i|ƒƒSdS(N(s _FileReadersosspathsjoinsselfs_dirsrelative(sselfsrelative((sbuild/generator/ezt.pys read_others(s__name__s __module__s__doc__s__init__s read_other(((sbuild/generator/ezt.pys _FileReader s  s _TextReadercBs tZdZd„Zd„ZRS(s&'Reads' a template from provided text.cCs ||_dS(N(stextsself(sselfstext((sbuild/generator/ezt.pys__init__scCs tƒ‚dS(N(sBaseUnavailableError(sselfsrelative((sbuild/generator/ezt.pys read_others(s__name__s __module__s__doc__s__init__s read_other(((sbuild/generator/ezt.pys _TextReaders  s EZTExceptioncBstZdZRS(s#Parent class of all EZT exceptions.(s__name__s __module__s__doc__(((sbuild/generator/ezt.pys EZTExceptions sArgCountSyntaxErrorcBstZdZRS(s6A bracket directive got the wrong number of arguments.(s__name__s __module__s__doc__(((sbuild/generator/ezt.pysArgCountSyntaxError s sUnknownReferencecBstZdZRS(sGThe template references an object not contained in the data dictionary.(s__name__s __module__s__doc__(((sbuild/generator/ezt.pysUnknownReference#s sNeedSequenceErrorcBstZdZRS(sGThe object dereferenced by the template is no sequence (tuple or list).(s__name__s __module__s__doc__(((sbuild/generator/ezt.pysNeedSequenceError&s sUnclosedBlocksErrorcBstZdZRS(s)This error may be simply a missing [end].(s__name__s __module__s__doc__(((sbuild/generator/ezt.pysUnclosedBlocksError)s sUnmatchedEndErrorcBstZdZRS(s6This error may be caused by a misspelled if directive.(s__name__s __module__s__doc__(((sbuild/generator/ezt.pysUnmatchedEndError,s sBaseUnavailableErrorcBstZdZRS(s6Base location is unavailable, which disables includes.(s__name__s __module__s__doc__(((sbuild/generator/ezt.pysBaseUnavailableError/s cCstidƒddtdgjpt‚tidƒddtddtdgjpt‚tidƒddtddtdgjpt‚tidƒd dtd dtd gjpt‚tid ƒdd tdgjpt‚tid ƒdd tdgjpt‚dS(Ns[a]ss[a] [b]s s[b]s [a c] [b]s[a c]s x [a] y [b] zsx s y s zs [a "b" c "d"]s["a \"b[foo]" c.d f](s _re_parsessplitsNonesAssertionError(((sbuild/generator/ezt.pys test_parse4s )222)cCs5dk}dk}d|j}|i|d|ƒSdS(Ns-vsverbose(sdoctestseztsargvsverbosestestmod(sargvseztsdoctestsverbose((sbuild/generator/ezt.pys_testAs s__main__i((s__doc__sstringsrestypess StringTypesIntTypes FloatTypesoss_itemscompiles _re_parses_re_argss_block_cmd_specsskeyss _block_cmdss _re_newlines_re_whitespaces _re_substsTemplatesbooleans _prepare_refs _get_values_contextsReaders _FileReaders _TextReaders Exceptions EZTExceptionsArgCountSyntaxErrorsUnknownReferencesNeedSequenceErrorsUnclosedBlocksErrorsUnmatchedEndErrorsBaseUnavailableErrors test_parses_tests__name__ssyssexitsargv( s _re_newlinesIntTypes_testsBaseUnavailableErrorsNeedSequenceErrorsbooleansUnknownReferencesTemplatesReaders_contexts StringTypes_block_cmd_specss FloatTypes _TextReaders EZTExceptions_re_whitespacesArgCountSyntaxErrorsresUnclosedBlocksErrorsUnmatchedEndErrors _re_parses_items _get_valuesstrings _prepare_refssyss_re_argss _re_substs test_parses _block_cmdss _FileReadersos((sbuild/generator/ezt.pys?†s@"   ! è  " $