; 0sDc@sdZdkZdkZdkZdkZdZdZdZdfdYZe djoXe ei djo dGHqeZ e i ei dZdkZeiendS( s Parser for "Aaron's Markup Language" - a markup language which is easier to type in than XML, yet gives us a reasonable selection of formats. The general rule is that if a line begins with a '.', it requires special processing. Otherwise lines are concatenated to paragraphs, and blank lines separate paragraphs. If the line ".foo bar bletch" is encountered, it immediately ends and writes out any current paragraph. It then looks for a parser method called 'foo'; if found, it is called with arguments (bar, bletch). If this is not found, it assumes that 'foo' is a paragraph style, and the text for the first line of the paragraph is 'bar bletch'. It would be up to the formatter to decide whether on not 'foo' was a valid paragraph. Special commands understood at present are: .image filename - adds the image to the document .beginPre Code - begins a Preformatted object in style 'Code' .endPre - ends a preformatted object. NiissParsercBstZdZdZdZdZdZdZdZdZ d Z d Z d Z e d Ze d ZdZRS(NcCs|idS(N(sselfsreset(sself((sD/home/packages/reportlab/reportlab_2_0/reportlab/tools/docco/yaml.pys__init__5scCs1d|_d|_g|_g|_t|_dS(NisNormal(sselfs_lineNos_styles_resultss_bufsPLAINs_mode(sself((sD/home/packages/reportlab/reportlab_2_0/reportlab/tools/docco/yaml.pysreset8s     cCsLt|di}x|D]}|i|d qW|i|iSdS(Nsri( sopensfilenames readlinessdataslinesselfsreadLinesendParas_results(sselfsfilenamesdatasline((sD/home/packages/reportlab/reportlab_2_0/reportlab/tools/docco/yaml.pys parseFile?s  c Cs|id|_ti|}t|djo2|itjo|i q|i i |nU|ddjo3|i ti |d}|d|df\}}t|i|ootd|} yt| t|Wqtj o5}tiid|t|||ifqXq|i ti |dd}t|djptd|d|if|\}}|d|_|i i |n|i i |dS( Niis.sself.s*Parser method: apply(%s,%s) %s at line %d s isStyle %s but no data at line %d(sselfs_lineNosstringslstripslinesstrippedslens_modesPLAINsendParas_bufsappendssplitswordsscmdsargsshasattrs __class__sevalsmethodsapplystuples TypeErrorserrssyssstderrswritesAssertionErrorsstyletagsdatas_style( sselfslinesstyletagsargsserrsstrippedscmdswordssdatasmethod((sD/home/packages/reportlab/reportlab_2_0/reportlab/tools/docco/yaml.pysreadLineIs0 )  .  cCsti|id}|o_|itjo/|iid|i ti|idfq{|iid|i |fng|_d|_ dS(Ns s Preformatteds s ParagraphsNormal( sstringsjoinsselfs_bufstexts_modes PREFORMATTEDs_resultssappends_style(sselfstext((sD/home/packages/reportlab/reportlab_2_0/reportlab/tools/docco/yaml.pysendParaos/  cCst|_||_dS(N(s PREFORMATTEDsselfs_modes stylenames_style(sselfs stylename((sD/home/packages/reportlab/reportlab_2_0/reportlab/tools/docco/yaml.pysbeginPre}s cCs|it|_dS(N(sselfsendParasPLAINs_mode(sself((sD/home/packages/reportlab/reportlab_2_0/reportlab/tools/docco/yaml.pysendPres cCs$|i|iid|fdS(NsImage(sselfsendParas_resultssappendsfilename(sselfsfilename((sD/home/packages/reportlab/reportlab_2_0/reportlab/tools/docco/yaml.pysimages cCs|iid|fdS(sInserts a vertical spacersVSpaceN(sselfs_resultssappendspoints(sselfspoints((sD/home/packages/reportlab/reportlab_2_0/reportlab/tools/docco/yaml.pysvSpacescCs|iiddfdS(sInserts a frame breaks PageBreaksblahN(sselfs_resultssappend(sself((sD/home/packages/reportlab/reportlab_2_0/reportlab/tools/docco/yaml.pys pageBreakscCs'|i|iid||fdS(s8Goes and gets the Python object and adds it to the storysCustomN(sselfsendParas_resultssappends moduleNamesfuncName(sselfs moduleNamesfuncName((sD/home/packages/reportlab/reportlab_2_0/reportlab/tools/docco/yaml.pyscustoms cCsti||}|itjo |ii dd|ifnt |i djodxa|i D]R}|i djo<|ii dd|if|ii dd|ifqbqbWnt |idjox|iD]}|i djo|ii ddd|if|ii dd|ifxa|iD]R}|i djo<|ii dd|if|ii dd|ifq8q8WqqWnd S( s_Documents the entire module at this point by making paragraphs and preformatted objectss Paragraphs DocStringisofficials PreformattedsFunctionHeaders Class %s:sDocStringIndentN(scodegrabsgetObjectsDefinedIns modulenamespathnamesdoccosdocsNonesselfs_resultssappendslens functionssfnsstatussprotosclassessclssnamesmethodssmth(sselfs modulenamespathnamesmthsdoccosfnscls((sD/home/packages/reportlab/reportlab_2_0/reportlab/tools/docco/yaml.pys getModuleDocs*  (   cCsti||}d}x|iD]}|i|jod}|i i ddd|if|i i dd|i fx]|iD]R}|idjo<|i i dd|if|i i dd|i fqqWPq"q"W|ptd |d S( s*Documents the class and its public methodsiis PreformattedsFunctionHeaders Class %s:s DocStringsofficialsDocStringIndentsNo Classes Defined in N(scodegrabsgetObjectsDefinedIns modulenamespathnamesdoccosfoundsclassessclssnames classnamesselfs_resultssappendsdocsmethodssmthsstatussprotosAssertionError(sselfs modulenames classnamespathnamesmthsfoundsdoccoscls((sD/home/packages/reportlab/reportlab_2_0/reportlab/tools/docco/yaml.pys getClassDocs    $ cCs|iid|fdS(NsNextPageTemplate(sselfs_resultssappends templateName(sselfs templateName((sD/home/packages/reportlab/reportlab_2_0/reportlab/tools/docco/yaml.pysnextPageTemplates(s__name__s __module__s__init__sresets parseFilesreadLinesendParasbeginPresendPresimagesvSpaces pageBreakscustomsNones getModuleDocs getClassDocsnextPageTemplate(((sD/home/packages/reportlab/reportlab_2_0/reportlab/tools/docco/yaml.pysParser4s   &         s__main__susage: yaml.py source.txt(s__doc__ssyssstringsimpscodegrabsPLAINs PREFORMATTEDs BULLETCHARsParsers__name__slensargvsps parseFilesresultsspprint( spprintspsstrings PREFORMATTEDsPLAINsParserscodegrabsresultsssyssimps BULLETCHAR((sD/home/packages/reportlab/reportlab_2_0/reportlab/tools/docco/yaml.pys?&s