'ff5dZdZdZdZgdZdZd'd Zd(d Zd)dZdddddddZ d*dZ d+dZ d,dZ d-dZ d.dZ d/dZdd idfdZ d/d Z d0d#Z d1d$Zd2d%Z d/d&ZdS)3z@ezCLI : a toolbox for easy development of Command Line InterfacezChristophe Schlickz1.5z 2019-12-01)convertparseinjectgridpauseuserlooptimerinspecttestcoderead_txt write_txtread_blk write_blkread_csv write_csvread_ini write_inicJt|ddiS#t$r|cYSwxYw)zconvert each literal expression in 'string' into its canonical data type - 'string' may contain an arbitrary sequence of comma-separated expressions - any non-convertible literal expression is simply returned as a string __builtins__)eval Exception)strings E/net/cremi/pblasi100p/Bureau/espaces/www/pai/python/SOL-A/G1/ezCLI.pyrrs4 6N2./// !!!6MMM!s  ""r =cd}||||}|rt|tr||||}tt |t |z}||z }d|vrtdt|r%tdd |z|dhkr|S|d}t|dkr|dn|S)aparse 'string' and return a tuple of values or a dictionary of named values string:str = input string to be parsed into values and/or named values default:str = optional string storing default values and named values vsep:str = separator string used between values nsep:str = separator string used between name and value Note: almost arbitrary strings may be used for vsep and nsep, except that they cannot start with any of the 8 delimiters: ' " ( ) [ ] { } cgt|t|ddf\}}}}}dtdtdt|f\}} } } t| D]\} } | dkr |dvrd|z }| d kr |d vrd |z }%| |vr|s|| A| |vrI|sG|| ||d kr||| | |z|kr|s|s| g|z| | | |z<|| | |z|kr|s|s| g|z| | | |z<d gidd | | D}}|D]}| | s;|d t| R|| ^}}d|D| }}|D]!}t||t|<"|d s|d =nt|d |d <|S)z>split 'string' into a dictionary of values and/or named valuesz([{z)]}'rr#"rr&rcg|]}||Sr).0items r z.parse..splitstring..:sNNNDN4NNNc^g|]*}||+Sr)stripr+names rr-z.parse..splitstring..>s-CCCTdjjllCDJJLLCCCr.) lenchrlist enumerateappendfindpopjoinsplitcountrr1tuple)rvsepnsepstackvlennlenenterleavestatevmodnmodcodencdicitemsr,namesvalr3s r splitstringzparse..splitstring#sx')#d))SYYu&L#E4ueR#b''4<<?E4t$ % %1 ceunnagee 88% ::e:U\\!____ ::e: ::a==EJJuRy11 1 1599;;; !AdF( t # #E #% #QqvX !AdF( t # #E #% #QqvXRNNBGGDMM,?,?,E,ENNNC;; ZZ  Ns2w~~gdjjll.C.CDDDhJJt$$kucCCUCCCSYY[[Se::$gcllWT]]++: r7#B#b'NN#b' Jr.rz"only named values are allowed herezunallowed names %r,r#r) r1 isinstancestrdictr6rMkeys ValueErrorr4 NameErrorr;)rdefaultr?r@rPrLdiffs rrrs+B  FLLNND$//# K'#P++gmmood4*P*P tGMMOO$$tCIIKK'8'88 9 9C 88::  &D Tzz$HIII TJ)$8388D>>$IJJJXXZZB4 B##c((a--AS8r.###Tct|rt|nd}|D],}||t||d}-|S)adreplace all instances of 'pattern' in 'string' by items of 'cells' string:str = arbitrary string including several instances of 'pattern' cells:list = list of values that are sequentially injected in 'string' pattern:str = string defining replacement pattern for injection trunc:bool = truncate (or not) cell content to the length of 'pattern' Nr#)slicer4replacerS)rcellspatterntrunccells rrrNsQ /G 4 0 0%JJdfnnWc$ii6FJJVV -r.FNc t|ttt|c fd|D}td|D  n kr  fd|D}gd}|d|z|zd}d  fd |Dd gzd }t |dd |d zd}|rdfdDd dt d zD} fd|D}ddfdDzg|dd<dt||D}d|S)areturn a string containing a 2D grid representation for 'matrix' matrix:list|tuple = 2D matrix containing arbitrary data in cells inner:bool = draw (or not) inner lines of the grid outer:bool = draw (or not) outer lines of the grid label:bool = add (or not) labels (letters for cols, digits for rows) size:int = horizontal size for each cell (default = compute best size) Note: the width of each cell is truncated to 'size' when provided cbg|]+}tD]}|||dzr||nd,S)r#r)range)r+linecolcolss rr-zgrid..gs\ 7 7 7%++ 7 7#&c#a%i 0DIIb 7 7 7 7r.c3NK|] }tt|V!dSNr4rS)r+rOs r zgrid..js. . .c#c((mm . . . . . .r.Ncg|]}t|ttfs*t|dn.ns N N N?B1;3E{0K0K ;CHHUdUO " "4 ( ( (S%4%&&u--44T:: N N Nr.)z , # , , u% │ , #│ ,──┼─ , │ u/┌──┐ ,│# │ ,│ │ ,└──┘ u5┌─┬┐ ,│#││ ,├─┼┤ ,└─┴┘ r&rQc|d|d|z|dz|dz zz|d|zz|dz|dzS)Nrr#r&r))lstpqs rzgrid..ysG3q63q6!8CF?QqS"99#a&(B3q6I#a&Pr.c*g|]}|Sr)r))r+framergrepeatrqs rr-zgrid..zs'???&&d++???r.rr#r'# z ABCDEFGHIJKLMNOQRSTUVWXYZcXg|]&}ddD]}||z'S)r#Nr0)r+abclabels rr-zgrid..~s: @ @ @VABBZ @ @qskkmm @ @ @ @r.cBg|]}dD]}|r|rt|ndS))r#rr)rSr+rrs rr-zgrid..s9 O O OQ O OA(a(c!fffS O O O Or.cRg|]#}dtt|fz$S)z%*s rj)r+rrowss rr-zgrid..s/ ; ; ;qfCII** ; ; ;r.rc3BK|]}|VdSri)ro)r+rKrqs rrkzgrid..s- @ @A$ @ @ @ @ @ @r.rcg|] \}}||z Sr)r)rs rr-zgrid..s / / /SQqQqS / / /r.)r4maxmapr<rrdr;zip) matrixinnerouterlabelrqframesr{rlabelrrgr|rrrs ` @@@@@rrrZs&6{{CC00*$ 7 7 7 7 7 7 7&  . .v . . . . .% \%44 t||TU N N N N NFL N N N& E E E& 5  % %c * *% P P& &?????????Da N N% ssVSX . . 4 4T : :% 0 )F @ @ @ @V @ @ @$ GF O O%Q-- O O OF ; ; ; ;F ; ; ;F @ @ @ @ @ @ @@@@AE!A#J / /C.. / / /E 5  r.r~)sependaskpromptokcD|sddd}d|D}fdt|fzDd}}|D]V}t|t||||d|dz} t |} | |vr| cS| sn-WdS) a'pause' is similar to 'print', but offers pause for user confirmation args:tuple = tuple of objects to be displayed sequentially on screen sep:str = string inserted between each object in 'args' end:str = string inserted after the last object, before the prompt ask:object = special value in 'args' that triggers prompt for user prompt:str = string displayed each time the 'ask' value is found ok:str|list|set|tuple = strings corresponding to allowed answers for the user input. All other strings are considered as invalid answers The function loops over the arguments in 'args' and displays them on screen, as the standard 'print' function. However, each time the special value stored in 'ask' is encountered, the 'prompt' string is displayed and the function pauses and waits for user confirmation. If the user enters an empty string (i.e. just hit the key), the display loop continues with the next object. If the user enters another string, the display loop is interrupted if this string is present in the 'ok' set. The prompt is repeated until the user enters either a string from 'ok' or an empty string. The function returns the string entered by the user or None if no interruption has occured z' TO CONTINUE, TO BREAK Ou─c6h|]}|Sr))lowerr*s r zpause..s $$$ $$$r.c&g|] \}}|k |Sr)r))r+rJargrs rr-zpause..s"FFF#3#::!:::r.N)rrr#)ror7printr\inputr) rrrrrargsstopsstartstopanswers ` rrrs. K 6 = =b J JF$$$$$"FFFF4;!7!7FFF%d 4eD!! "5555tAvuV}}f 2  f}}} U r.r'cddlm}d} d} dtfddD} d } | d | dd z}|"| | | d | d | }|d }||}|d}|r | ||r9|dz}t d|z} | dvr|r|rtdrn| dvr | |y| dvr | || }t||rdndn}#t$rp}t|trd|z}n7d | dd}t||dz }Yd}~nd}~wwxYw|9|r | |dSdS)acommand line loop with automatic user input processing and error checking process:func = processing function called for each command line input prompt:str = message string displayed when waiting for user input hello:str = hello string displayed before starting the interactive loop bye:str = goodbye string displayed after ending the interactive loop usage:str = usage string displayed when user enters '?' or 'help' about:str = about string displayed when user enters '!' or 'about' safe:bool = ask (or not) for user confirmation before breaking loop n:int = number of iterations for interactive loop (default = infinite) r) format_exccD|d|r|rdndz|zS)Nr~rr0)sts rryzuserloop..s(aggdmmq'>Q'>ttB?!Cr.crtdd|ddfS)Nr~u────────────────────────────────────────────────────────────────────────────────)rr;r1rs rryzuserloop..s+E$))[!''$--$MNNOOr.Nc|Srir)rs rryzuserloop..s!r.c3TK|]"}jd|zdV#dS)z__%s__rN) __globals__get)r+rprocesss rrkzuserloop..sV@@ "&&x!|R88@@@@@@r.z"file author date version doc usagez Enter 'help' or '?' to display some user instructions Enter 'about' or '!' to display some info about the application Enter 'exit' or an empty line to stop the interaction loopz(File: %s Author: %s Date: %s Version: %sruzEnter command linezSee you later...r#z<> %s: )rexitrr)?help)!aboutr~z Error: %s) tracebackrr>r<rr1rrrrrRAssertionErrorr; splitlines)rrhellobyeusagersaferJrmerger{infohelpercommandoutputeerrors` rrrsl#""""" C C% O O% _ g @@@@6<<>>@@@ @ @$C  ] 9D!H DE ] E%%QQ(( 0 0E ^ !F ] U[ S EE%LLL FAeI 677G}}+%% 4d4u}}}4u}},&&e h}}-''ux''""E&f6Ldd"$M$M$M$M$M  A~ & &> aIIjjll5577<==E ElllAFAAAAAA  %%*****s) E GA&F??Gcddlm}ddlm}|ddj|ddj}}t t |t |z}|}| d| d} }|d|d||dz| zd z} } t| |} t| |} | | nT#t$r,| g} | | n #t$rtd |zwxYwYnt$rtd |zwxYw|} td t!|D]}| | | |z} | dt#| dd d}|st%| St'd |t%| |fzdS)ameasure time required for 'n' successive executions of 'fcall' fcall:str = string defining the function call 'f(args)' to measure 'f(args)' is evaluated in the namespace of the caller function, so 'args' may contain expressions with either literals or binded names show:bool = display measured time on screen or return it as an float n:int = number of function calls performed during time measure Note: when the execution of 'fcall' fails, a 'RuntimeError' is raised rrA)timer#()N[]zincorrect function call %rzP..TIMER IS RUNNING....TIMER IS RUNNING....TIMER IS RUNNING....TIMER IS RUNNING..r'z#Timing for %s = %.3g sec (%s calls))r rAr f_globalsf_localsrTr6rMr1r9rfindr TypeErrorr RuntimeErrorrrdrSabsr)fcallshowrJrAr global_names local_names namespacerwrxr3rfchronos rrrs&#eggajm5uuwwqz!}7M ,4 **,,--[5F5F5H5H0I0IIJJ) ++--%uzz# C0@0@1RaRy#ac!e ,s2$M T9Ad4&;&;tQQXXX OOO4 NNNL)E)MNNNN! LLL,'Ce'KLLLL 466&51222 88aQQXXXDDFF&c$ii"ooo>E !c&kk!-F Q0GGHHHHHs*/%D E&D('E&(EE& E&Pc  ddlm}dd|ddj|ddj}}t |t |z}hd hd t fd|Dttrfd Dn-d d Dfd Dstd fdD}tttfdD} |z dz dddzzzfd|D} ttdt!| | D} |r t#| ddind| S)ayinspect the values for a set of comma-separated variable names names:str = string containing a set of comma-separated variable names 'names' gets a special meaning when it is set to bool instead of str - names=False: displays all non-hidden local and global variables - names=True: also displays hidden local and global variables where hidden names means all names starting with the '__' prefix show:bool = display values on screen or return them as a single string wrap:bool = wrap or truncate values exceeding maximal field width field:int = maximal field width before applying wrapping or truncating rrcL|d|dzdz dz|| dzdzdzS)zAremove the middle part of 'val' to get a string of length 'width'Nr&z ... rtr))rOrrs rr`zinspect..truncs6 {q { g %UFAIaKLL(9 99r.c(gt|d}}}||z |krE|d|||z}|||||dz}||z |kE|||d||S)z>split and wrap 'val' to get a set of strings of length 'width'rrr#N)r4rr8r;)rOrroffsetsplitsrJrwrxs rr<zinspect..splitss3xxqAF A#++ ))CAeG $ $afmmC!H&=&=&=1Q3q A#++ MM#abb'6;;v#6#66r.r#>typemethodmodulefunction generatorbuiltin_function_or_method>__spec__ __cached__ __loader__rc`g|]*}|dvrt|djv(|+Sr")r__name__)r+r, discard_names discard_typess rr-zinspect.."sKEEETd1g].J.JT!W .mCCCCCr.cBg|]}s|d|S)__) startswith)r+r3rNs rr-zinspect..%s/ N N Nd5 N8M8M NT N N Nr.c6g|]}|Sr)r0r2s rr-zinspect..(s 7 7 7dTZZ\\ 7 7 7r.rQcg|]}|v| Sr)r)r+r3rs rr-zinspect..)s# 9 9 9dty'8'8T'8'8'8r.zno valid names to inspectc g|] }| Sr)r)rs rr-zinspect..,s . . .IdO . . .r.c:g|]}|Sr))ljust)r+r3lsizes rr-zinspect../s% / / /4::e   / / /r.rtr~rcg|]f}tt|krt|n4st|nt|gSr))r4repr)r+rOrrsizer<r`wraps rr-zinspect..3s O O O@CDII%//49996.6s.FFT 4((FFFFFFr.r)r rArrr6rMrTrRboolr<rWrrr4r>sortedrrr;)rNrrfieldrArrrMvalueslhandrhandfieldsrrrrrrr<r`s` ` @@@@@@@@rr r s}:::777$eggajm5uuwwqz!}7M , |!!## $ $tK,=,=,?,?'@'@ @%222-GGG-EEEEEUEEEFF)t: N N N Ni N N NEE 8 7ekk#&6&6 7 7 7E 9 9 9 9e 9 9 9E .splitcode..Os A A ATDJJLL A A Ar.r)r6lstripr7r5r;r<)rIrFrJrKs r splitcodeztestcode..splitcodeAsT$++--((4E $..1 du~~quCFF$q'' 88% 88% 88 AE B ARWWT]]%8%8Q%@%@ A A AAr.c,dt||fS#t$rIdt||fcYS#t$r'}dt |jd|fcYd}~cYSd}~wwxYwt$r%}dt |jd|fcYd}~Sd}~wwxYw)zCeval/exec 'statement', according to names and values in 'namespace'r#rr'z: N)r SyntaxErrorexecrrr) statementrrs revalexecztestcode..evalexecQs4 9--- - IIIT)Y/// / / / HHHBDGG4D4D4Daa(H$HHHHHHHHHH FFF"$q''2B2B2BAA&F"FFFFFFFFsF B1B A"AA"BA"" B.BBBrrr#r~r}rz>>> NrOFz r)r rArrrTr6rMr1rrrRrSr]r) rIrrr rrArrrremoderOs rr r 9sBBB GGG#eggajm5uuwwqz!}7M ,4 **,,--[5F5F5H5H0I0IIJJ)i 4(())  d  DOOC00 > ?????????????????? @@@      )HHX,>,>> ? ??@s<CA C  C,AC < C C  CC C,Dc|||fdkrt|||}||fdkr|dkr|t|zdzn|x}}|||t|||<||} t |d|5}|||cdddS#1swxYwYdS#t$r"ddlm } td | |zwxYw) areplace or insert a multi-line string in the content of a text file filename:str = output filename filename may include absolute or relative path using '/' separators string:str = string to be written in file (start,stop,step):(int,int,int) = standard slice parameters for lines default values for (start,stop,step) replaces the whole file content default values for (stop,step) inserts string at line index 'start' any other combination replaces the lines in slice(start,stop,step) sep:str = line separator string encoding:str = standard Python codec identifier (e.g. 'latin1' or 'utf8') Note: the function always returns the whole file content as a string rrr"rr#wNrzcannot write file '%s') r r<r4r\r;rwriterrr) rrrrr rrlinesr!rs rr r s|  D*$$ X 1 1 1 7 7 < .str.)NNr}r)r1rN)rTrr6rMr r<rr8) rrr1filtersrvoidblocksr"r*keys rr r s$  $ +s4j#g7$w}}:O:OO P P'XhehGGG$&zz###e55 ++%"2"23"7"7+ U##UU 4  e 4 4 "fmmE""" -r.c t|tr||}nt|ttfs|g}t ||d|D|||||S)areplace or insert a set of blocks in the content of a BLK file filename:str = output filename blocks:str|list|tuple = set of blocks to be written in file if blocks:str, it is written unchanged as a slice in file if blocks:list|tuple, each item is written as a new block in file (start,stop,step):(int,int,int) = standard slice parameters default values for (start,stop,step) replaces the whole file content default values for (stop,step) inserts blocks at line index 'start' any other combination replaces the lines in slice(start,stop,step) sep:str = block separator string encoding:str = standard Python codec identifier (e.g. 'latin1' or 'utf8') Note: the function always returns the whole file content as a string c3PK|]!}t|trdnd|V"dS)rrN)rRrS)r+r*s rrkzwrite_blk..s\&*&*7As6K6K1  1 e'&*&*&*&*&*&*r.)rRrSr<r6r>r r;)rr-rrr rrs rrrs"s>fll3&7&7VV fd5\ * *=fXF 8SXX&*&*"(&*&*&***+0$c8 M MMr.rQ c d  fd}t||||dd|}t|dkr|n|dS)areturn the content of a CSV file converted to a 1D, 2D or 3D matrix filename:str = input filename raw:bool = return cells as strings or apply 'convert' to each cell colsep:str = col separator string rowsep:str = row separator string sep:str = block separator string strip:bool = strip (or not) leading and trailing whitespaces encoding:str = standard Python codec identifier (e.g. 'latin1' or 'utf8') cfd||D}t|dkr|n|dS)zDextract the CSV data stored in 'string' and return a 1D or 2D matrixc|g|]8}|dfd|D9S)r}c~g|]9}r|n t|:Sr))r1r)r+raraws rr-z4read_csv..csv...sJ--- #=tzz||| (=(=---r.)rr<)r+rowcolsepr6s rr-z)read_csv..csv..sj***14^^C((*----))F++---***r.r#r)r<r4)rr6r8rowseprs `` rcsvzread_csv..csvs]*****8> V8L8L***F[[A%%666!94r.c |Srir))r*r8r:r6r9s rryzread_csv..sSSVV<<r.N)Nr}r#r)r r4) rr6r8r9rr1r csv_filterrr:s ``` @rrrsi555=<<<<<<* Hc5 *E*Ex P P&v;;!##2r.c  d fd}  |rt|}nt fd|Dr)tt|}nWt fd| |Dr# fd|D}n fd|D}t |||||||S)aFreplace or insert a 1D, 2D or 3D matrix in the content of a CSV file filename:str = output filename matrix:str|list|tuple = matrix to be written in file if matrix:str, it is written unchanged at 'start' line index if matrix:list|tuple, it is first converted into a CSV string (start,stop,step):(int,int,int) = standard slice parameters for lines default values for (start,stop,step) replaces the whole file content default values for (stop,step) inserts matrix at line index 'start' any other combination replaces the lines in slice(start,stop,step) colsep:str = col separator string rowsep:str = row separator string sep:str = block separator string encoding:str = standard Python codec identifier (e.g. 'latin1' or 'utf8') Note: the function always returns the whole file content as a string c<t|ttf Sri)rRr6r>)datas rryzwrite_csv..sJtT%L999r.c<tfd|DgS)Nc3RK|]!}|r|gnt|V"dSri)r6r+msingles rrkz.write_csv....s<EEA71##QEEEEEEr.)sum)matrDs rryzwrite_csv..s&SEEEEEEErJJr.c3.K|]}|VdSrir)rBs rrkzwrite_csv.. s+ % %66!99 % % % % % %r.c3.K|]}|VdSrir)rBs rrkzwrite_csv.. s+ + +66!99 + + + + + +r.c3K|]F}|rt|n'tt|VGdSrirSr;rr+r7r8rDs rrkzwrite_csv.. sb,, &,VC[[OSfkk#c#,,6O6O,,,,,,r.cg|]>}|rt|n!fd|D?S)c3K|]F}|rt|n'tt|VGdSrirJrKs rrkz'write_csv...sg7=7=14DJ6#;;8-s3xxx;;s3s||,,7=7=7=7=7=7=r.)rSr;)r+blkr8r9rDs rr-zwrite_csv..sPPPAD!&++=c#hhh6;;7=7=7=7=7=8;7=7=7=,=,=PPPr.)rSallr;rr) rrrrr r8r9rrflatrDs `` @rrrsA( : 9& J J J J$ VF^^ P [[FF % % % %f % % %%%P [[S ) )FF + + + +dd6ll + + +++P [[,,,,,$*,,,,,FFPPPPPPHNPPPF 8VUD$X F FFr.cHd}d}d}|||d}diidddf\} } } } t||||dgzD]\} }| dkr<| r|r| nt| | | | <|dd} } } i| | <ng| d kr| d z|z} nF| r|r| nt| | | | <| |} } | r| st |d |t | d kr | d} n | ds| d=| S) a[return the content of an INI file converted to a 2-level dictionary filename:str = input filename raw:bool = return values as strings or apply 'convert' to each value sep:str = line separator string strip:bool = strip (or not) leading and trailing whitespaces encoding:str = standard Python codec identifier (e.g. 'latin1' or 'utf8') cnd|ddddfS)N:rr#rr)r<r)s rryzread_ini..s/sEKK$4$4Q$7$=$=c$B$B1$EFr.c d|fS)Nrr)r)s rryzread_ini..!s sElr.c>|ddddS)Nrr&) partitionr)s rryzread_ini..#sus33CCaC8r.)Nrrr)r+r1r)rrrSrz in file r#)r rr1r rstriprr4)rr6rr1r sect_filter cont_filter prop_filterr+rMsectionr3valuerrs rrrsyGF+**+99+;K @ @'!#BR 3%$x(02225 = =leU || Fs&FeeuW~d#"[[]]BUtgRE'NN #ckELLNN*ee Fs&FeeuW~d#LLNNELLNNEd =T= 555((; < <<ZZ1__eBiee 9#%) ,r.c d}dt|tr:||rd|i}dfd|D}nt|}t |||||||S)areplace or insert a set of items in the content of an INI file filename:str = output filename items:str|dict = set of items to be written in file if items:str, it is written unchanged at 'start' line index if items:dict, it is first converted into an INI string (start,stop,step):(int,int,int) = standard slice parameters for lines default values for (start,stop,step) replaces the whole file content default values for (stop,step) inserts items at line index 'start' any other combination replaces the lines in slice(start,stop,step) sep:str = line separator string encoding:str = standard Python codec identifier (e.g. 'latin1' or 'utf8') Note: the function always returns the whole file content as a string cZtd|D S)Nc3@K|]}t|tVdSri)rRrT)r+ds rrkz.write_ini....Is,"L"L!:a#5#5"L"L"L"L"L"Lr.)anyrrLs rryzwrite_ini..Is(s"L"Lszz||"L"L"LLLLr.cDt|Sri)rrMrbs rryzwrite_ini..KsfSYY[[))r.rr~c3K|]9\}}|rd|znddd|DzV:dS)z [%s] rr~c3*K|]\}}|d|VdSrr))r+rJvs rrkz&write_ini...NsMF,F,!qqqGF,F,F,F,F,F,r.Nr)r+sectproporders rrkzwrite_ini..NsLL0:d-18zD((bDIIF,F,$uT{{F,F,F,=,=,,LLLLLLr.)rRrTr;rSr ) rrMrrr rr nosectionsris @rrr7s$ML* ) )%dz%-2u+% IILLLL>CeEllLLL L LEEE  8UE4sH E EEr.)rrr)rZT)TTFN)NNNNNNFr')Tr)FTTr)Tr)Nrr#r~Tr)Nrr#r~r)FrQr~r1Tr)Nrr#rQr~r1r)Fr~Tr)__doc__ __author__ __version____date____all__rrrrrrrr r r r r rrrrrr)r.rrps FF"   F F F """59595959n    ****^d2#     D9=131111lIIII>7A7A7A7Ar....fDH@@@@4AEAAAA: tR&<AEMMMM,@F"(33332:;