m 9Cc@sSdZdZdZdZdZdkZdkZdkZdkl Z dk Z dk Z dk l Z dk l Z lZy dkZWnCej o7y dkZWqej od klZqXnXdd Zd dd Zedded ZeddedZdZe iie_dZedjo endS(s<oodoctest - a utility to run python code samples from an OOo document By Olivier Grisel oodoctest extracts and run code samples found in an OpenOffice.org document to test their validity using the standard python doctest machinery. The goal is to make it easy to write runnable python documentation with OpenOffice.org. This script can be both used a command line tool (oodoctest.py --help) or as the provider of the OODocFileTest class to integration OO documents as part of unittest suite. OpenOffice.org is not required to run oodoctest. s (C) Copyright 2005 Olivier Grisel This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License version 2 as published by the Free Software Foundation. This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details. You should have received a copy of the GNU General Public License along with this program; if not, write to the Free Software Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA. s0.2.0s)Olivier Grisel s- use iterparse instead of parse - add support for the OpenDocument format (00 2.0 and 1.1.5) - find a way to plug it in OOo as a macro to inline test the document N(sStringIO(scopy(s DocFileCases DocTestParser(s ElementTreecCs|djo d}nd|}d|}d|}hd|<d|<d|<dd |<d d |<d d |<dd|<dd|<dd<}|S(sBuild an openoffice document namespace OpenOffice 1.1 and OpenDocument share a similar namespace structure. Only the base url changes. shttp://openoffice.org/2000s %s/offices{%s}bodys%s/texttofficetbodyttexttps{%s}ptss{%s}stcs{%s}cths{%s}htlevels {%s}leveltxlinkshttp://www.w3.org/1999/xlinkN(tbasetNonet oo_officetoo_bodytoo_texttns(R R R R R((tN/home/ogrisel/coding/oodoctest-download.gna.org/oodoctest.og.main/oodoctest.pyt_build_namespaceBs     k tcCs|djo t}n|io||i7}n|i|djo6|i|d}|o|dt|7}qnx,|i D]}t |d|d|}qW|i|djo|d7}n|i dj o||i 7}n|S( sRecursively extract text from an tree structured document >>> e = ElementTree.XML('''\ ... ... \ ... \ ... This is a \ ... paragraph\ ... 3 spacesendSpaces\ ... \ ... ... ''' % _build_namespace()) >>> print _extract_text(e) This is a paragraph 3 spaces endSpaces RRs RRRs N( RR RtelementRttagtgettcountertintt getchildrentchildt _extract_textttail(RRRRR((RR^s"    cKs|d jo h}n|o| otdn|o%ti|}ti||}nt ii |}t i |}|id} tit| dd} t| }t} t}x<|p4|i\} }|i| djo t}qqWg}d} x|D]\}}|djoqn|i| djoPn|i| djo%d | jo d} n|i#q|i| d jo$| t$|d | 7} |i#qqWd | jo&|i%|i'| |||d n|S(s\extract doctests from an OO document at 'path' return a list of doctests instances s8Package may only be specified for module-relative paths.s content.xmlteventststarttendRRRs>>>RRiN(sstartsend((tglobsR tpackagetmodule_relativet ValueErrortdoctestt_normalize_modulet_module_relative_pathtpathtostbasenametnametzipfiletZipFiletoofiletreadtcontentt ElementTreet iterparsetStringIOt iterparsertitertcontextRRtFalsetin_bodytnextt_RRtTruetteststcollected_textteventtclearRtappendtparsert get_doctest(R%R RRR>toptionsR9R;R+R:R-RR1R7R5R(RR3((Rtextract_doctestssN          &c Ks4t|d|d|d|d|\}t||S(sBuild a DocFileCase out of an OpenOffice document. Arguments are similar to those of the doctest.DocFileTest function R RRR>N( RAR%R RRR>ttestt DocFileCaseR@(R%R RRR>R@RB((Rt OODocFileTests cOsti}|idto ti|id|d|D]6}x-t||D]}|it||qWq~W|S(NR RRR>(smodule_relativespackagesglobssparser(tunittestt TestSuitetsuitetkwRR8R"R#tcopytkw2tkeythas_keytpathsR%RARBtaddTestRC(RMRHRJRKR%RBRG((RtOODocFileSuites   c Csdkl} | }|id|iddddddd d d d d d|iddd dddd ddddgd d|i\} }ti }g}|D]}|ti i||q~}|p dGH|itidnhdt<} d} | idjo| tiB} ng}x!|D]} |t| | 7}q=Wtid| }x|D]}|i|qsW|id| i dS(s/Run oodoctest.py as a command line utility (s OptionParsers$%prog [options] oofile [oofile2 ...]s-vs --verbosetactiont store_consttconstitdestt verbositythelps)show extracted doctests and their resultstdefaultis-es --ellipsistellipsisttypetchoices enaable ellipsis (default is on)tchoicestontoffs2You should provide an OpenOffice file as argument:R t optionflagstverboseN(!toptparset OptionParserR>t set_usaget add_optiont parse_argsR@targsR&tgetcwdtcwdt_[1]targR%tjoinRMt print_usagetsystexitR4RHR]RWR"tELLIPSISR9RAt DocTestRunnertrunnerRBtrunt summarizeRT(RMR9R>RoRdRfRgRhRBRHR%R]R@R`((Rtmains@        0 t__main__(t__doc__t __copyright__t __version__t __author__t__TODO__R&RkR)t cStringIOR0R"RERIRCt DocTestParsert cElementTreeR.t ImportErrort elementtreeR RRR8RARDROt DocFileSuiteRrt__name__(RER.RxRvRRCRR)RwRkRIRDRuRrRzR0RORAR"R&((Rt?s8          *E  )