;๒ น0sDc@sัdZdkZdkZdklZdklZdfd„ƒYZdeideieidZ d Z deid Z ei e ƒZ ei e ƒZei e ƒZd „Zed jo eƒndS( s@ Template parsing module inspired by REXX (with thanks to Donn Cave for discussion). Template initialization has the form: T = Template(template_string, wild_card_marker, single_char_marker, x = regex_x, y = regex_y, ...) Parsing has the form ([match1, match2, ..., matchn], lastindex) = T.PARSE(string) Only the first argument is mandatory. The resultant object efficiently parses strings that match the template_string, giving a list of substrings that correspond to each "directive" of the template. Template directives: Wildcard: The template may be initialized with a wildcard that matches any string up to the string matching the next directive (which may not be a wild card or single character marker) or the next literal sequence of characters of the template. The character that represents a wildcard is specified by the wild_card_marker parameter, which has no default. For example, using X as the wildcard: >>> T = Template("prefixXinteriorX", "X") >>> T.PARSE("prefix this is before interior and this is after") ([' this is before ', ' and this is after'], 47) >>> T = Template("X", "X") >>> T.PARSE('go to index') (['A HREF="index.html"', 'go to index', '/A'], 36) Obviously the character used to represent the wildcard must be distinct from the characters used to represent literals or other directives. Fixed length character sequences: The template may have a marker character which indicates a fixed length field. All adjacent instances of this marker will be matched by a substring of the same length in the parsed string. For example: >>> T = Template("NNN-NN-NNNN", single_char_marker="N") >>> T.PARSE("1-2-34-5-12") (['1-2', '34', '5-12'], 11) >>> T.PARSE("111-22-3333") (['111', '22', '3333'], 11) >>> T.PARSE("1111-22-3333") ValueError: literal not found at (3, '-') A template may have multiple fixed length markers, which allows fixed length fields to be adjacent, but recognized separately. For example: >>> T = Template("MMDDYYX", "X", "MDY") >>> T.PARSE("112489 Somebody's birthday!") (['11', '24', '89', " Somebody's birthday!"], 27) Regular expression markers: The template may have markers associated with regular expressions. the regular expressions may be either string represenations of compiled. For example: >>> T = Template("v: s i", v=id, s=str, i=int) >>> T.PARSE("this_is_an_identifier: 'a string' 12344") (['this_is_an_identifier', "'a string'", '12344'], 39) >>> Here id, str, and int are regular expression conveniences provided by this module. Directive markers may be mixed and matched, except that wildcards cannot precede wildcards or single character markers. Example: >>> T = Template("ssnum: NNN-NN-NNNN, fn=X, ln=X, age=I, quote=Q", "X", "N", I=int, Q=str) >>> T.PARSE("ssnum: 123-45-6789, fn=Aaron, ln=Watters, age=13, quote='do be do be do'") (['123', '45', '6789', 'Aaron', 'Watters', '13', "'do be do be do'"], 72) >>> N(s StringType(sfindsTemplatecBs#tZeed„Zdd„ZRS(NcKsโ||_||_||_|iƒ} |o| i |ƒn|o3x|D]}| i |ƒqMW|d|_}n| |_x3| D]+} t | ƒdjotd| ‚q‰q‰Wh|_}xJ|iƒD]<\} } t| ƒtjoti| ƒ} n| || s blahsss=' <-- a string --> ' --> 'blah blah another string blah' blahs s --> NNNiXsis''A STRING' --> 15964653alpha beta gammasXsXis)prefix'string'interior1234junk not parsedsMMDDYYXsMDYs122961 Somebody's birthday!( sTemplatesTsPARSEsstrsT1sssintsT2sT3sT4(sT4ss((sG/home/packages/reportlab/reportlab_2_0/reportlab/tools/docco/t_parse.pystestใss__main__(s__doc__sresstringstypess StringTypesfindsTemplatesletterssdigitss USERNAMEREGEXsSTRINGLITREGEXsSIMPLEINTREGEXscompilesidsstrsintstests__name__( s USERNAMEREGEXs StringTypesstringsSTRINGLITREGEXsSIMPLEINTREGEXsidsresintsstrsTemplatestestsfind((sG/home/packages/reportlab/reportlab_2_0/reportlab/tools/docco/t_parse.pys?Os  €#