/usr/lib/python2.6/site-packages
Edit: /usr/lib/python2.6/site-packages/cmd2.pyc (65019B)
{DVc @ s$ d Z d d k Z d d k Z d d k Z d d k Z d d k Z d d k Z d d k Z d d k Z d d k Z d d k
Z
d d k Z d d k Z d d k
Z
d d k Z d d k Z d d k l Z l Z d d k l Z d d k Z d Z e i d d j o e i i n d e i f d YZ d
Z d Z d Z e e i _ g Z d
d Z d e! f d YZ" d Z# e i$ oK y" d d k% Z% d Z& d Z' Wn" e( j
o d Z& e& Z' n Xne i d j o e) Z* y8 e i+ d d e, d e i- d e i- d e i- e, Z* Wn e i. e/ e0 f j
o n Xe* o d Z& d Z' n d Z& e& Z' n>e) Z* y8 e i+ d d e, d e i- d e i- d e i- e, Z* Wn e1 j
o y d Z2 e i3 d d e, d e i- d e i- Z4 e4 i5 i6 e2 e4 i5 i7 e i3 d d e, d e i- d e i- Z4 e4 i8 i9 e2 j o
e, Z* n Wn e: j
o n Xn e: j
o n Xe* o d! Z& d" Z' n d# Z& e& Z' e i i; d$ d% e< f d& YZ= d' e> f d( YZ? d) Z@ d* ZA d+ eB f d, YZC d- e: f d. YZD d/ d0 ZE d1 e iF f d2 YZF d3 e< f d4 YZG d5 eH f d6 YZI d7 e: f d8 YZJ d9 ZK d: eL f d; YZM d< eL f d= YZN d> eN f d? YZO d@ e iP f dA YZQ eR dB j o e iS dC e iT n d S(D s- Variant on standard library's cmd with extra features.
To use, simply import cmd2.Cmd instead of cmd.Cmd; use precisely as though you
were using the standard library's cmd, while enjoying the extra features.
Searchable command history (commands: "hi", "li", "run")
Load commands from file, save to file, edit commands in file
Multi-line commands
Case-insensitive commands
Special-character shortcut commands (beyond cmd's "@" and "!")
Settable environment parameters
Optional _onchange_{paramname} called when environment parameter changes
Parsing commands with `optparse` options (flags)
Redirection to file with >, >>; input from file with <
Easy transcript-based testing of applications (see example/example.py)
Bash-style ``select`` available
Note that redirection with > and | will only work if `self.stdout.write()`
is used in place of `print`. The standard library's `cmd` module is
written to use `self.stdout.write()`,
- Catherine Devlin, Jan 03 2008 - catherinedevlin.blogspot.com
mercurial repository at http://www.assembla.com/wiki/show/python-cmd2
iN( t InteractiveConsolet InteractiveInterpreter( t make_options 0.6.8i i t OptionParserc B s) e Z d d d Z d Z d Z RS( i c C s t | i _ | o | GHn d S( N( t Truet valuest _exit( t selft statust msg( ( s( /usr/lib/python2.6/site-packages/cmd2.pyt exitA s c O s? y | i i GHWn t j
o n Xt i i | | | d S( N( t _funct __doc__t AttributeErrort optparseR t
print_help( R t argst kwargs( ( s( /usr/lib/python2.6/site-packages/cmd2.pyR F s
c C s t i | d S( s error(msg : string)
Print a usage message incorporating 'msg' to stderr and exit.
If you override this in a subclass, it should not return -- it
should either exit or raise an exception.
N( R t
OptParseError( R R ( ( s( /usr/lib/python2.6/site-packages/cmd2.pyt errorM s N( t __name__t
__module__t NoneR
R R ( ( ( s( /usr/lib/python2.6/site-packages/cmd2.pyR @ s c C s= d i d | D d } t i | | } | | i S( s
Preserves the spacing originally in the argument after
the removal of options.
>>> remaining_args('-f bar bar cow', ['bar', 'cow'])
'bar cow'
s \s+c s s" x | ] } t i | Vq Wd S( N( t ret escape( t .0t a( ( s( /usr/lib/python2.6/site-packages/cmd2.pys
^ s s \s*$( t joinR t searcht start( t oldArgst
newArgListt patternt matchObj( ( s( /usr/lib/python2.6/site-packages/cmd2.pyt remaining_argsV s c C s, y t | | SWn t j
o d SXd S( s Returns an attribute's value, or None (no error) if undefined.
Analagous to .get() for dictionaries. Useful when checking for
value of options that may not have been defined on a given
method.N( t getattrR
R ( t objt attr( ( s( /usr/lib/python2.6/site-packages/cmd2.pyt
_attr_get_b s c C sN y3 t i d | g d t i d t i i d SWn t j
o d SXd S( Nt whicht stdoutt stderri ( t
subprocesst Popent PIPEt STDOUTt communicatet OSErrorR ( t editor( ( s( /usr/lib/python2.6/site-packages/cmd2.pyt _whichl s 3t argc s` t t p
g n x* D]" } t i t i | i q$ W f d } | S( s Used as a decorator and passed a list of optparse-style options,
alters a cmd2 method to populate its ``opts`` argument from its
raw text argument.
Example: transform
def do_something(self, arg):
into
@options([make_option('-q', '--quick', action="store_true",
help="Makes things fast")],
"source dest")
def do_something(self, arg, opts):
if opts.quick:
self.fast_button = True
c s t x D] } i | q W i d i d f _ f d } d i i f | _ | S( Ns %s [options] %si c s yW i | i \ } } t | | } t | t o | i | } n | } Wn( t i j
o } | GH i d SXt | d o d S | | | } | S( NR ( t
parse_argst splitR" t
isinstancet ParsedStringt with_args_replacedR R R t hasattrR ( t instanceR2 t optsR t newArgst et result( t funct optionParser( s( /usr/lib/python2.6/site-packages/cmd2.pyt new_func s
s %s
%s( R t
add_optiont set_usageR R R t format_help( R> t optR@ ( t option_listt arg_desc( R? R> s( /usr/lib/python2.6/site-packages/cmd2.pyt option_setup s ( R5 t listt options_definedt appendt pyparsingt Literalt get_opt_string( RE RF RD RG ( ( RE RF s( /usr/lib/python2.6/site-packages/cmd2.pyt optionsv s
t PasteBufferErrorc B sM e Z e i d d j o
d Z n e i d d j o n d Z d Z RS( i t wins Redirecting to or from paste buffer requires pywin32
to be installed on operating system.
Download from http://sourceforge.net/projects/pywin32/t dars Redirecting to or from paste buffer requires xclip
to be installed on operating system.
On Debian/Ubuntu, 'sudo apt-get install xclip' will install it.c C s t i | | i d S( N( t Exceptiont __init__t errmsg( R ( ( s( /usr/lib/python2.6/site-packages/cmd2.pyRS s ( R R t syst platformRT RS ( ( ( s( /usr/lib/python2.6/site-packages/cmd2.pyRO s
sW Redirecting to or from paste buffer requires %s
to be installed on operating system.
%sc C sG t i d y t i } Wn t j
o
d } n Xt i | S( Ni t ( t win32clipboardt
OpenClipboardt GetClipboardDatat TypeErrort CloseClipboard( R= ( ( s( /usr/lib/python2.6/site-packages/cmd2.pyt get_paste_buffer s
c C s2 t i d t i t i | t i d S( Ni ( RX RY t EmptyClipboardt SetClipboardTextR\ ( t txt( ( s( /usr/lib/python2.6/site-packages/cmd2.pyt write_to_paste_buffer s
c G s t t d d S( Nt pywin32s6 Download from http://sourceforge.net/projects/pywin32/( Rb s6 Download from http://sourceforge.net/projects/pywin32/( R/ t pastebufferr( R ( ( s( /usr/lib/python2.6/site-packages/cmd2.pyR] s t darwins pbcopy -helpt shellR( t stdinR) c
C s= t i d d t d t i d t i d t i } | i i S( Ns pbcopy -helpRe R( Rf R) ( R* R+ R R, R( t read( t
pbcopyproc( ( s( /usr/lib/python2.6/site-packages/cmd2.pyR] s 0c
C sG t i d d t d t i d t i d t i } | i | i d S( Nt pbcopyRe R( Rf R) ( R* R+ R R, R. t encode( R` Rh ( ( s( /usr/lib/python2.6/site-packages/cmd2.pyRa s 0c G s t t d d S( NRi sF On MacOS X - error should not occur - part of the default installation( s pbcopysF On MacOS X - error should not occur - part of the default installation( R/ Rc ( R ( ( s( /usr/lib/python2.6/site-packages/cmd2.pyR] s s xclip -o -sel clips Testing for presence of xclip.s xclip -sel clipc C s4 t i d d t d t i d t i } | i i S( Ns xclip -o -sel clipRe R( Rf ( R* R+ R R, R( Rg ( t xclipproc( ( s( /usr/lib/python2.6/site-packages/cmd2.pyR] s 'c C s t i d d t d t i d t i } | i i | i | i i t i d d t d t i d t i } | i i | i | i i d S( Ns xclip -sel clipRe R( Rf t xclip( R* R+ R R, Rf t writeRj t close( R` Rk ( ( s( /usr/lib/python2.6/site-packages/cmd2.pyRa s '
'c G s t t d d S( NRl s; On Debian/Ubuntu, install with "sudo apt-get install xclip"( s xclips; On Debian/Ubuntu, install with "sudo apt-get install xclip"( R/ Rc ( R ( ( s( /usr/lib/python2.6/site-packages/cmd2.pyR] s s R6 c B s e Z d Z d Z RS( c C s> t d | i i | i i f } | i | _ | i | _ | S( Ns %s %s( R6 t parsedt commandR t parser( R t new( ( s( /usr/lib/python2.6/site-packages/cmd2.pyt full_parsed_statement s " c C sE t | } | i | _ | i | _ | | i d <| | i i d <| S( NR ( R6 Ro Rq t statement( R t newargsRr ( ( s( /usr/lib/python2.6/site-packages/cmd2.pyR7
s
( R R Rs R7 ( ( ( s( /usr/lib/python2.6/site-packages/cmd2.pyR6 s t StubbornDictc B sG e Z d Z d Z e Z d Z d Z d Z e d Z RS( sK Dictionary that tolerates many input formats.
Create it with stubbornDict(arg) factory function.
>>> d = StubbornDict(large='gross', small='klein')
>>> sorted(d.items())
[('large', 'gross'), ('small', 'klein')]
>>> d.append(['plain', ' plaid'])
>>> sorted(d.items())
[('large', 'gross'), ('plaid', ''), ('plain', ''), ('small', 'klein')]
>>> d += ' girl Frauelein, Maedchen\n\n shoe schuh'
>>> sorted(d.items())
[('girl', 'Frauelein, Maedchen'), ('large', 'gross'), ('plaid', ''), ('plain', ''), ('shoe', 'schuh'), ('small', 'klein')]
c C s t i | t i | d S( N( t dictt updateRv t to_dict( R R2 ( ( s( /usr/lib/python2.6/site-packages/cmd2.pyRx # s c C s | i | | S( N( Rx ( R R2 ( ( s( /usr/lib/python2.6/site-packages/cmd2.pyt __iadd__& s
c C s& t i | } | i t | | S( N( t copyRx t stubbornDict( R R2 t selfcopy( ( s( /usr/lib/python2.6/site-packages/cmd2.pyt __add__) s c C s& t i | } | i t | | S( N( R{ Rx R| ( R R2 R} ( ( s( /usr/lib/python2.6/site-packages/cmd2.pyt __radd__- s c C s t | d o | i } n t | d o h } x| | D]j } | i } | oQ | i d d } | d } t | d j o | d } n d } | | | >> sorted(stubbornDict('cow a bovine\nhorse an equine').items())
[('cow', 'a bovine'), ('horse', 'an equine')]
>>> sorted(stubbornDict(['badger', 'porcupine a poky creature']).items())
[('badger', ''), ('porcupine', 'a poky creature')]
>>> sorted(stubbornDict(turtle='has shell', frog='jumpy').items())
[('frog', 'jumpy'), ('turtle', 'has shell')]
( Rx Rv Ry ( R2 t kwargR= R ( ( s( /usr/lib/python2.6/site-packages/cmd2.pyR| G s
c C sb | oN y& t t i i | d i } Wq^ t j
o d | d } q^ Xn
t } | S( Ni s < %s( t opent ost patht
expanduserRg t IOErrorR] ( t fnameR= ( ( s( /usr/lib/python2.6/site-packages/cmd2.pyt replace_with_file_contentsV s & t EmbeddedConsoleExitc B s e Z RS( ( R R ( ( ( s( /usr/lib/python2.6/site-packages/cmd2.pyR ` s t EmptyStatementc B s e Z RS( ( R R ( ( ( s( /usr/lib/python2.6/site-packages/cmd2.pyR c s t c C sU t | d o | i | | St | | j o | | g | | } n | Sd S( s+ analogous to str.ljust, but works for listst ljustN( R8 R R ( t xt widtht fillchar( ( s( /usr/lib/python2.6/site-packages/cmd2.pyR f s
t Cmdc B s e Z e Z e Z d Z e Z d e i e i
Z h d d 6d d 6d d 6d d 6Z d
i
Z e Z d i
Z d Z d
Z e Z dn Z g Z e Z e Z e Z e Z dn Z d Z e d Z d Z dn d Z d Z! e Z" d Z# e$ i% i& d Z' e' pZ e( i) d d j o
d Z' q]x9 d d d d d d d g D] Z' e* e' o Pq=q=Wn h h d e 6d e 6d! 6h d" e 6d# e 6d$ 6h d% e 6d# e 6d& 6h d' e 6d# e 6d( 6h d) e 6d# e 6d* 6h d+ e 6d# e 6d, 6h d- e 6d. e 6d/ 6Z+ e) i, d0 j Z- d1 Z. d2 Z/ d3 Z0 d4 Z1 d5 Z2 e i3 Z4 e i5 e i6 e i7 g Z8 e8 i9 d6 e i: d7 e i; e i< d8 A Z= d9 g Z> e Z? g Z@ d: ZA d; ZB d< ZC d= ZD d> ZE d? ZF d@ ZG dA ZH dB ZI dC ZJ dD ZK dE ZL dF ZM dG ZN dn dH ZO dI ZP eP ZQ dJ ZR eR ZS eR ZT dK dL ZU eV eW dM dN dO dP d dQ g dR ZX dS ZY dT ZZ dU Z[ dV Z\ eV eW dW dX dO dP d dY g dZ d[ d\ Z] d] Z^ d^ Z_ e] Z` e_ Za e_ Zb d_ Zc ec Zd e ie e if e ig d` A da e ie e if e db dc e i< Zh dd Zi de Zj dn df Zk el im dg Zn dn dh Zo eo Zp di Zq eq Zr dj Zs dk Zt dl Zu dm Zv RS(o s > u !#$%.:?@_t helpt ?Re t !t loadt @t _relative_loads @@s& run r list l history hi ed edit li eofs set ed edit exitR` s command.txtt >s
prompt
colors Colorized output (*nix only)
continuation_prompt On 2nd+ line of input
debug Show full error stack on error
default_file_name for ``save``, ``load``, etc.
editor Program used by ``edit``
case_insensitive upper- and lower-case both OK
feedback_to_output include nonessentials in `|`, `>` results
quiet Don't print nonessential feedback
echo Echo command issued into output
timing Report execution times
abbrev Accept abbreviated commands
c C sD | o9 | i i | | d d j o | i i d q@ n d S( sG Convenient shortcut for self.stdout.write(); adds newline if necessary.is
N( R( Rm ( R R ( ( s( /usr/lib/python2.6/site-packages/cmd2.pyt poutput s c C s' | i o t i n t | GHd S( N( t debugt tracebackt print_exct str( R RT Rt ( ( s( /usr/lib/python2.6/site-packages/cmd2.pyt perror s
c C s2 | i p$ | i o | i | q. | GHn d S( s For printing nonessential feedback. Can be silenced with `quiet`.
Inclusion in redirected output is controlled by `feedback_to_output`.N( t quiett feedback_to_outputR ( R R ( ( s( /usr/lib/python2.6/site-packages/cmd2.pyt pfeedback s
it EDITORi RP t notepadt geditt katet vimt vit emacst nanot picos [1ms [22mt bolds [36ms [39mt cyans [34mt blues [31mt reds [35mt magentas [32mt greens [4ms [24mt underlinet Windowsc C sD | i o6 | i | i j o# | i | t | | i | t S| S( s Given a string (``val``), returns that string wrapped in UNIX-style
special characters that turn on (and then off) text color and style.
If the ``colors`` environment paramter is ``False``, or the application
is running on Windows, will return ``val`` unchanged.
``color`` should be one of the supported strings (or styles):
red/blue/green/cyan/magenta, bold, underline( t colorsR( t initial_stdoutt
colorcodesR t False( R R t color( ( s( /usr/lib/python2.6/site-packages/cmd2.pyt colorize s #c C sS | i i d h | i o d p d d 6t | i d 6d i | i d 6 d S( s) Summary report of interactive parameters.s
Commands are %(casesensitive)scase-sensitive.
Commands may be terminated with: %(terminators)s
Settable parameters: %(settable)s
s not RW t
casesensitivet terminatorsR t settableN( R( Rm t case_insensitiveR R R R ( R R ( ( s( /usr/lib/python2.6/site-packages/cmd2.pyt do_cmdenvironment s
c C s | ot | i | } | oZ t | | } y | i i d | i Wqw t j
o t i i | | d qw Xq n t i i | | d S( Nt filei ( t
func_namedR# R? R R( R
t cmdR t do_help( R R2 t funcnamet fn( ( s( /usr/lib/python2.6/site-packages/cmd2.pyR s $c O s t i i | | | t i | _ t | _ h | _ t | i
i d t | _
| i
g } t | D]% } | i d o | | d ql ql ~ | _ | i d S( Nt reverset do_i ( R R RS RU R( R t Historyt historyt pystatet sortedt shortcutst itemsR t reserved_wordst dirt
startswitht keywordst _init_parser( R R R t _[1]R ( ( s( /usr/lib/python2.6/site-packages/cmd2.pyRS s ,c C s: d i d t | i D } | i i d | d S( s% Lists single-key shortcuts available.s
c s s+ x$ | ] } d | d | d f Vq Wd S( s %s: %si i N( ( R t sc( ( s( /usr/lib/python2.6/site-packages/cmd2.pys s s, Single-key shortcuts for other commands:
%s
N( R R R R( Rm ( R R R= ( ( s( /usr/lib/python2.6/site-packages/cmd2.pyt do_shortcuts s "c C s d S( RW ( ( R ( ( s( /usr/lib/python2.6/site-packages/cmd2.pyt s s /*s */t ;c C sF t i | i d t i | i Bt i d | i Bd } t i g } | i D]- } | t | d o | p
t i | qU ~ d } t i d A} t i g } | i D] } | t i
| d | i q ~ d | _ | i t i
| i d } t i
d
d d
} | i i t i i d | i | i Bt i B}
t i | t i | | Ad
|
d t i | t i | d
|
i d d } | i o' | i i d | i d n | i o t i | _ no t i t i d | _ | i i d | i | At i | i d
|
i d d | i d | _ | i | At i | d
|
i d d | d t i | | A| Ad
|
i d d | | _ | i i | i | t i | | A| A| Ad
|
i d d d t i | | | _ | i i d | _ | i | | i B| i B| i B| i t i | d
|
B| _ | i i | i t i d } | i d t i
| i d }
|
d } | i t | t i | t i d t i |
t i d
B| _! | i! i | i d S( s
>>> c = Cmd()
>>> c.multilineCommands = ['multiline']
>>> c.case_insensitive = True
>>> c._init_parser()
>>> print (c.parser.parseString('').dump())
[]
>>> print (c.parser.parseString('').dump())
[]
>>> print (c.parser.parseString('/* empty command */').dump())
[]
>>> print (c.parser.parseString('plainword').dump())
['plainword', '']
- command: plainword
- statement: ['plainword', '']
- command: plainword
>>> print (c.parser.parseString('termbare;').dump())
['termbare', '', ';', '']
- command: termbare
- statement: ['termbare', '', ';']
- command: termbare
- terminator: ;
- terminator: ;
>>> print (c.parser.parseString('termbare; suffx').dump())
['termbare', '', ';', 'suffx']
- command: termbare
- statement: ['termbare', '', ';']
- command: termbare
- terminator: ;
- suffix: suffx
- terminator: ;
>>> print (c.parser.parseString('barecommand').dump())
['barecommand', '']
- command: barecommand
- statement: ['barecommand', '']
- command: barecommand
>>> print (c.parser.parseString('COMmand with args').dump())
['command', 'with args']
- args: with args
- command: command
- statement: ['command', 'with args']
- args: with args
- command: command
>>> print (c.parser.parseString('command with args and terminator; and suffix').dump())
['command', 'with args and terminator', ';', 'and suffix']
- args: with args and terminator
- command: command
- statement: ['command', 'with args and terminator', ';']
- args: with args and terminator
- command: command
- terminator: ;
- suffix: and suffix
- terminator: ;
>>> print (c.parser.parseString('simple | piped').dump())
['simple', '', '|', ' piped']
- command: simple
- pipeTo: piped
- statement: ['simple', '']
- command: simple
>>> print (c.parser.parseString('double-pipe || is not a pipe').dump())
['double', '-pipe || is not a pipe']
- args: -pipe || is not a pipe
- command: double
- statement: ['double', '-pipe || is not a pipe']
- args: -pipe || is not a pipe
- command: double
>>> print (c.parser.parseString('command with args, terminator;sufx | piped').dump())
['command', 'with args, terminator', ';', 'sufx', '|', ' piped']
- args: with args, terminator
- command: command
- pipeTo: piped
- statement: ['command', 'with args, terminator', ';']
- args: with args, terminator
- command: command
- terminator: ;
- suffix: sufx
- terminator: ;
>>> print (c.parser.parseString('output into > afile.txt').dump())
['output', 'into', '>', 'afile.txt']
- args: into
- command: output
- output: >
- outputTo: afile.txt
- statement: ['output', 'into']
- args: into
- command: output
>>> print (c.parser.parseString('output into;sufx | pipethrume plz > afile.txt').dump())
['output', 'into', ';', 'sufx', '|', ' pipethrume plz', '>', 'afile.txt']
- args: into
- command: output
- output: >
- outputTo: afile.txt
- pipeTo: pipethrume plz
- statement: ['output', 'into', ';']
- args: into
- command: output
- terminator: ;
- suffix: sufx
- terminator: ;
>>> print (c.parser.parseString('output to paste buffer >> ').dump())
['output', 'to paste buffer', '>>', '']
- args: to paste buffer
- command: output
- output: >>
- statement: ['output', 'to paste buffer']
- args: to paste buffer
- command: output
>>> print (c.parser.parseString('ignore the /* commented | > */ stuff;').dump())
['ignore', 'the /* commented | > */ stuff', ';', '']
- args: the /* commented | > */ stuff
- command: ignore
- statement: ['ignore', 'the /* commented | > */ stuff', ';']
- args: the /* commented | > */ stuff
- command: ignore
- terminator: ;
- terminator: ;
>>> print (c.parser.parseString('has > inside;').dump())
['has', '> inside', ';', '']
- args: > inside
- command: has
- statement: ['has', '> inside', ';']
- args: > inside
- command: has
- terminator: ;
- terminator: ;
>>> print (c.parser.parseString('multiline has > inside an unfinished command').dump())
['multiline', ' has > inside an unfinished command']
- multilineCommand: multiline
>>> print (c.parser.parseString('multiline has > inside;').dump())
['multiline', 'has > inside', ';', '']
- args: has > inside
- multilineCommand: multiline
- statement: ['multiline', 'has > inside', ';']
- args: has > inside
- multilineCommand: multiline
- terminator: ;
- terminator: ;
>>> print (c.parser.parseString('multiline command /* with comment in progress;').dump())
['multiline', ' command /* with comment in progress;']
- multilineCommand: multiline
>>> print (c.parser.parseString('multiline command /* with comment complete */ is done;').dump())
['multiline', 'command /* with comment complete */ is done', ';', '']
- args: command /* with comment complete */ is done
- multilineCommand: multiline
- statement: ['multiline', 'command /* with comment complete */ is done', ';']
- args: command /* with comment complete */ is done
- multilineCommand: multiline
- terminator: ;
- terminator: ;
>>> print (c.parser.parseString('multiline command ends\n\n').dump())
['multiline', 'command ends', '\n', '\n']
- args: command ends
- multilineCommand: multiline
- statement: ['multiline', 'command ends', '\n', '\n']
- args: command ends
- multilineCommand: multiline
- terminator: ['\n', '\n']
- terminator: ['\n', '\n']
>>> print (c.parser.parseString('multiline command "with term; ends" now\n\n').dump())
['multiline', 'command "with term; ends" now', '\n', '\n']
- args: command "with term; ends" now
- multilineCommand: multiline
- statement: ['multiline', 'command "with term; ends" now', '\n', '\n']
- args: command "with term; ends" now
- multilineCommand: multiline
- terminator: ['\n', '\n']
- terminator: ['\n', '\n']
>>> print (c.parser.parseString('what if "quoted strings /* seem to " start comments?').dump())
['what', 'if "quoted strings /* seem to " start comments?']
- args: if "quoted strings /* seem to " start comments?
- command: what
- statement: ['what', 'if "quoted strings /* seem to " start comments?']
- args: if "quoted strings /* seem to " start comments?
- command: what
i s [^=]t outputt parseStringt
terminators
EOFt caselesst multilineCommandRp t |t
identCharsc S s d S( RW ( ( R ( ( s( /usr/lib/python2.6/site-packages/cmd2.pyR s t ignoret pipeToc S s | d i S( i ( R ( R ( ( s( /usr/lib/python2.6/site-packages/cmd2.pyR s t outputToc S s | d i S( i ( t lower( R ( ( s( /usr/lib/python2.6/site-packages/cmd2.pyR s c S s | d i S( i ( R ( R ( ( s( /usr/lib/python2.6/site-packages/cmd2.pyR s c S s | d i S( i ( R ( R ( ( s( /usr/lib/python2.6/site-packages/cmd2.pyR s R Rt c S s | d i S( i ( R ( R ( ( s( /usr/lib/python2.6/site-packages/cmd2.pyR s c S s | d i S( i ( R ( R ( ( s( /usr/lib/python2.6/site-packages/cmd2.pyR s t suffixc S s | d i S( i ( R ( R ( ( s( /usr/lib/python2.6/site-packages/cmd2.pyR s t >( s stdout( s stdout( s stdout( s stdout( Ro R t Statekeepert
kept_stateRU t kept_sysR* R+ R R, t redirectRf R( R R t can_clipt EnvironmentErrorR R R R R t tempfilet
TemporaryFileRm R] ( R Rt R0 ( ( s( /usr/lib/python2.6/site-packages/cmd2.pyR" / s$
0
/ c C s | i o | i i o8 | i i p' | i i d t | i i q nF | i i o8 x5 | i i
D] } | i i i | p d ql Wn | i i | i i
| i i
d | _ n d S( Ni RW ( R2 Ro R R R( t seekRa Rg R R4 R. Rm Rn t restoreR3 R ( R Rt R= ( ( s( /usr/lib/python2.6/site-packages/cmd2.pyR) D s
"
c C s | i | } | i i | _ | i | i i } | p | i | Sy t | | } Wn t j
o | i | SX| | } | S( s Interpret the argument as though it had been typed in response
to the prompt.
This may be overridden, but should not normally need to be;
see the precmd() and postcmd() methods for useful execution hooks.
The return value is a flag indicating whether interpretation of
commands by the interpreter should stop.
This (`cmd2`) version of `onecmd` already override's `cmd`'s `onecmd`.
( Ro R t lastcmdR Rp t _defaultR# R
( R R* Rt R R> R ( ( s( /usr/lib/python2.6/site-packages/cmd2.pyR& R s c C sT | i } | i o( t i | } | p | i d Sn | i | i | S( N( Rs t default_to_shellR t systemR R t default( R Rt R2 R= ( ( s( /usr/lib/python2.6/site-packages/cmd2.pyR< j s
c C s | i o0 y t | } Wq t j
o
d } q Xnc | i i | | i i | i i } t | p
d } n | d d j o | d } n | S( sQ copied from cmd's cmdloop; like raw_input, but accounts for changed stdin, stdoutt EOFis
( t use_rawinputt raw_inputt EOFErrorR( Rm t flushRf t readlineR ( R t promptR* ( ( s( /usr/lib/python2.6/site-packages/cmd2.pyR- r s
c C s | i | i o | i o] yC d d k } | i | _ | i | i | i | i d Wn t j
o n Xn z | t
j o
| | _ n | i o! | i i
t | i d n t
} x | oz | i o | i i d } n | i | i } | i o t | i t o | i i
| d n | i | } q W| i Wd | i o | i o: y d d k } | i | i Wn t j
o n Xn | SX( s Repeatedly issue a prompt, accept input, parse an initial prefix
off the received input, and dispatch to action methods, passing them
the remainder of the line as argument.
iNs
: completes
i ( t preloopRA t completekeyRE t
get_completert
old_completert
set_completert completet parse_and_bindt ImportErrorR t introR( Rm R t cmdqueuet popR- RF t echoR5 Rf R R, t postloop( R RO RE R R* ( ( s( /usr/lib/python2.6/site-packages/cmd2.pyt _cmdloop s>
!
c C s | i S( N( t _STOP_SCRIPT_NO_EXIT( R R2 ( ( s( /usr/lib/python2.6/site-packages/cmd2.pyt do_EOF s c C s | i S( N( t _STOP_AND_EXIT( R R2 ( ( s( /usr/lib/python2.6/site-packages/cmd2.pyt do_quit s s
Your choice? c
C sS t | t o t | i | i } n g } x | D]} } t | t o | i | | f q< y | i | d | d f Wq< t j
o" | i | d | d f q< Xq< Wx; t | D]- \ } \ } } | i d | d | f q WxQ t oI t | } y# t
| } | | d d } PWq t j
o q Xq W| S( s Presents a numbered menu to the user. Modelled after
the bash shell's SELECT. Returns the item chosen.
Argument ``options`` can be:
| a single string -> will be split into one-word options
| a list of strings -> will be offered as options
| a list of tuples -> interpreted as (value, text), so
that the return value can differ from
the text advertised to the user i i s
%2d. %s
( R5 t
basestringt zipR4 RJ t
IndexErrort enumerateR R RB t intt
ValueError(
R RN RF t fulloptionsRD t idxt valuet textt responseR= ( ( s( /usr/lib/python2.6/site-packages/cmd2.pyt select s0 $
s -ls --longt actiont
store_trues describe function of parameterc C s
| i i } h } d } xi | i D]^ } | p | i | o@ d | t t | | f | | ( R R2 ( ( s( /usr/lib/python2.6/site-packages/cmd2.pyt do_shell s c s_ i d <| i i d i } i o
i p h } t d | i d | i o i | n d } f d } f d } | i d <| i d <| i d
<| i d : Executes a Python command.
py: Enters interactive Python mode.
End with ``Ctrl-D`` (Unix) / ``Ctrl-Z`` (Windows), ``quit()``, '`exit()``.
Non-python commands can be issued with ``cmd("your command")``.
Run python code from external files with ``run("filename.py")``
R i t localss. import sys, os;sys.path.insert(0, os.getcwd())c S s
t d S( N( R ( ( ( s( /usr/lib/python2.6/site-packages/cmd2.pyt quit% s c s i | d S( Ns
( R, ( R2 ( R ( s( /usr/lib/python2.6/site-packages/cmd2.pyR, ' s c sV y- t | } i | i | i Wn" t j
o } i | n Xd S( N( R t runcodeRg Rn R R ( R2 R R< ( R t interp( s( /usr/lib/python2.6/site-packages/cmd2.pyt run) s R{ R
R R~ sF Type "help", "copyright", "credits" or "license" for more information.Rf R( t banners Python %s on %s
%s
(%s)
%sN( s stdins stdout( R Ro R R t locals_in_pyR R| R1 RU R( Rf t interactt versionRV t __class__R t do_pyR R R: ( R R2 t localvarsR{ R, R~ t cprtt keepstate( ( R R} s( /usr/lib/python2.6/site-packages/cmd2.pyR s0
-s -ss --scripts" Script format; no separation linesRF s$ (limit on which commands to include)c C sl | o | i i | } n
| i } x? | D]7 } | i o | i | q- | i i | i q- Wd S( s
history [arg]: lists past commands issued
| no arg: list all
| arg is integer: list one history item, by index
| arg is string: string search
| arg is /enclosed in forward-slashes/: regular expression search
N( R t gett scriptR R( Rm t pr( R R2 R: R t hi( ( s( /usr/lib/python2.6/site-packages/cmd2.pyt
do_history? s
c C sF y+ | o | i i | d S| i d SWn t j
o d SXd S( Ni( R R R[ R ( R R2 ( ( s( /usr/lib/python2.6/site-packages/cmd2.pyt
last_matchingR s c C sm y | i i | p d } Wn% t j
o | i i | } n Xx! | D] } | i | i qL Wd S( sq list [arg]: lists last command issued
no arg -> list most recent command
arg is integer -> list one history item, by index
a..b, a:b, a:, ..b -> list spans from a (or start) to b (or end)
arg is string -> list all commands matching string search
arg is /enclosed in forward-slashes/ -> regular expression search
s -1N( R t spanR[ R R R ( R R2 R R ( ( s( /usr/lib/python2.6/site-packages/cmd2.pyt do_listZ s c C s | i p t d n | i } | o? y | i t | } Wqv t j
o | } d } qv Xn | i d } | o= t t i i
| d } | i | p d | i n t i
d | i | f | i | d S( s@ ed: edit most recent command in text editor
ed [N]: edit numbered command from history
ed [filename]: edit specified file name
commands are run after editor is closed.
"set edit (program-name)" or set EDITOR environment variable
to control which editing program is used.sG Please use 'set editor' to specify your text editing program of choice.RW iR/ s %s %sN( R0 R6 t default_file_nameR R] R^ R R R R R Rm Rn R> t do__load( R R2 t filenamet buffert f( ( s( /usr/lib/python2.6/site-packages/cmd2.pyt do_edn s
t *R` s /\R c
C s8 y | i i | } Wn9 t i j
o* | i d | t | i i n X| i p | i } | i
d j o d i | i } n6 | i
o | i t
| i
d } n | i d } yG t t i i | d } | i | | i | i d | Wn) t j
o } | i d | n Xd S(
s `save [N] [filename.ext]`
Saves command from history to file.
| N => Number of command (from history), or `*`;
| most recent command if omitteds# Could not understand save target %sR s
i iR/ s Saved to %ss Error saving %sN( t
saveparserR RK t ParseExceptionR t SyntaxErrort do_saveR R R R` R R R] R R R R Rm Rn R RR ( R R2 R R t savemeR R< ( ( s( /usr/lib/python2.6/site-packages/cmd2.pyR s&
c C s t | t o t | d } n | i i | } | o t i | i d } np t i i
| } y t t i i
| d } Wn; t j
o/ t d t i i
| | i f d } n X| S( Nt ri s %s.%s(
R5 R R t urlret matcht urllibt urlopent groupR R R R t defaultExtension( R R R= R ( ( s( /usr/lib/python2.6/site-packages/cmd2.pyt read_file_or_url s c C sz | oo | i d d } | d | d p d g d } } t i i | i p d | } | i d | | f n d S( s
Runs commands in script at file or URL; if this is called from within an
already-running script, the filename will be interpreted relative to the
already-running script's directory.i i RW s %s %sN( R4 R R R R t current_script_dirR ( R R2 t
targetnameR ( ( s( /usr/lib/python2.6/site-packages/cmd2.pyt do__relative_load s
# s (https?://[-\w\./]+)c C s" | d j o
| i } n< | i d d } | d | d p d g d i } } y | i | } Wn- t j
o! } | i d | | f d SXt | d } | | _ t | _
d | _ | _ t
i i | d | _ | i } | i i | i d | _ | o
| | i j S( s- Runs script of command(s) from a file or URL.i i RW s% Problem accessing script from %s:
%sNRf RA RF R. R ( s stdins use_rawinputs prompts continuation_prompts current_script_dir( R R R4 R R R R R1 Rf R RA RF R. R R R RT Rn R: R; RU ( R R2 R R R R< R R ( ( s( /usr/lib/python2.6/site-packages/cmd2.pyt do_load s(
)
c C s: | i | } | i | | o | i | } n d S( s% run [arg]: re-runs an earlier command
no arg -> run most recent command
arg is integer -> run one history item, by index
arg is string -> run most recent command by string search
arg is /enclosed in forward-slashes/ -> run most recent by regex
N( R R R, ( R R2 t runmeR ( ( s( /usr/lib/python2.6/site-packages/cmd2.pyt do_run s
c C sa y t t i i | } Wn( t j
o | i i d | d SX| i } | i | S( Ns Couldn't read from file %s
RW ( R R R R R R( Rm Rg Rn ( R Rt t sourceR t data( ( s( /usr/lib/python2.6/site-packages/cmd2.pyt
fileimport s
c sm d t f f d Y} | i _ t i d g t _ | } t i } | i | } | i d S( Nt
TestMyAppCasec s e Z i Z RS( ( R R R t CmdApp( ( R ( s( /usr/lib/python2.6/site-packages/cmd2.pyR s i ( t Cmd2TestCaseR t testfilesRU t argvt unittestt TextTestRunnerR~ t printErrors( R t callargsR t testcaset runnerR= ( ( R s( /usr/lib/python2.6/site-packages/cmd2.pyt runTranscriptTests s c C s1 x* | D]" } | i | d o | i Sq Wd S( Ns
( R, RW ( R R t initial_command( ( s( /usr/lib/python2.6/site-packages/cmd2.pyt run_commands_at_invocation s c C s} t i } | i d d d d d d d d | i \ } } | i o | i | n | i | p | i n d S( Ns -ts --testt destt testRe Rf R s1 Test against transcript(s) in FILE (wildcards OK)( R R RA R3 R R R RT ( R Rq t calloptsR ( ( s( /usr/lib/python2.6/site-packages/cmd2.pyt cmdloop s
N(w R R R RR R R R. R( RK t alphanumst
alphas8bitR R R4 R! R= t noSpecialParseR R R R R R R R R R R2 R R| R R R R RW RU R t environR R0 RU RV R1 R R> R R R R RS R t EmptyR R t pythonStyleCommentt
cStyleCommentR t addParseActionRL R R R R R R R R R Ro R R R R, R R" R) R& R< R- RT RV t do_eofRX t do_exitt do_qRd RN R Rl Rw Rx Ry R R R R t do_hit do_lt do_liR t do_editR R t numsR R R R R t compileR R R R t do_rR R R R ( ( ( s( /usr/lib/python2.6/site-packages/cmd2.pyR o s "
* " *! B
t HistoryItemc B s e Z d Z d Z d Z RS( s! -------------------------[%d]
%s
c C s) t i | | i | _ d | _ d S( N( R RS R t lowercaseR R` ( R t instr( ( s( /usr/lib/python2.6/site-packages/cmd2.pyRS s
c C s | i | i t | f S( N( t
listformatR` R ( R ( ( s( /usr/lib/python2.6/site-packages/cmd2.pyR s ( R R R RS R ( ( ( s( /usr/lib/python2.6/site-packages/cmd2.pyR s R c B sq e Z d Z d Z d Z d Z e i d Z d Z e i d Z
d Z d Z d
e d Z RS( sp A list of HistoryItems that knows how to respond to user requests.
>>> h = History([HistoryItem('first'), HistoryItem('second'), HistoryItem('third'), HistoryItem('fourth')])
>>> h.span('-2..')
['third', 'fourth']
>>> h.span('2..3')
['second', 'third']
>>> h.span('3')
['third']
>>> h.span(':')
['first', 'second', 'third', 'fourth']
>>> h.span('2..')
['second', 'third', 'fourth']
>>> h.span('-1')
['fourth']
>>> h.span('-2..-3')
['third', 'second']
>>> h.search('o')
['second', 'fourth']
>>> h.search('/IR/')
['first', 'third']
c C s% | } | d j o | d 8} n | S( Ni i ( ( R t onebasedR= ( ( s( /usr/lib/python2.6/site-packages/cmd2.pyt zero_based_index4 s
c C s* | o | i t | } n d } | S( N( R R] R ( R R R= ( ( s( /usr/lib/python2.6/site-packages/cmd2.pyt to_index9 s c C s | i } | d | d j o
d j n o$ t | d j o | d d !} n t i | } t i | t i } g } | D]! } | i | o | | q q ~ S( Ni it /i ( R R R R R t
IGNORECASER ( R R R R R ( ( s( /usr/lib/python2.6/site-packages/cmd2.pyR ? s 9sJ ^\s*(?P\-?\d+)?\s*(?P:|(\.{2,}))?\s*(?P\-?\d+)?\s*$c C s | i d j o
d } n | i i | } | p
t n | i d p | | i | i d g S| i | i d } | i | i d } t } | d j o2 | | j o | | } } t } n | d 7} n | | | !} | o | i n | S(
NR t -t allt :t separatorR t endi ( R R s all(
R t spanpatternR R[ R R R R R R ( R R t resultsR R R R= ( ( s( /usr/lib/python2.6/site-packages/cmd2.pyR H s&
s0 ^\s*(?P[\d]+)?\s*\-\s*(?P[\d]+)?\s*$c C s/ t | } t i | | t | | _ d S( N( R RH RJ R R` ( R Rr ( ( s( /usr/lib/python2.6/site-packages/cmd2.pyRJ ^ s c C s" x | D] } | i | q Wd S( N( RJ ( R Rr t n( ( s( /usr/lib/python2.6/site-packages/cmd2.pyt extendb s c s p | Sy9 t d j o
| d S| d g SWnNt j
o g St j
o/| i i } | oj | i d p d } | i d p d } | o t | d } n | o t | } n | | | !S i i d oM i d o= t
i d d !t
i t
i
Bt
i B f d } n f d } g } | D] } | | o | | qoqo~ SXd S( Ni ii R R c s
i | S( N( R ( R ( t finder( s( /usr/lib/python2.6/site-packages/cmd2.pyt isin s c s i | i j S( N( R R ( R ( t getme( s( /usr/lib/python2.6/site-packages/cmd2.pyR s ( R] R[ R^ t rangePatternR R R R R t endswithR R t DOTALLt MULTILINER ( R R t fromEndt rangeResultR R R R t itm( ( R R s( /usr/lib/python2.6/site-packages/cmd2.pyR f s2
*N( R R R R R R R R R R R RJ R R R R ( ( ( s( /usr/lib/python2.6/site-packages/cmd2.pyR s Rr c B s e Z RS( ( R R ( ( ( s( /usr/lib/python2.6/site-packages/cmd2.pyRr s c C s t | } | t j o y t t | SWn t t f j
o n Xy | i } Wn n X| d j p | d d j o t S| d j p | d d
j o t Sn y | | SWn n Xd | | f GH| S( s= Tries to force a new value into the same type as the current.t oni t yR t offR R s9 Problem setting parameter (now %s) to %s; incorrect type?( R R ( R R ( t typet boolR] R^ R[ R R R ( t currentRr t typ( ( s( /usr/lib/python2.6/site-packages/cmd2.pyRp s(
R1 c B s# e Z d Z d Z d Z RS( c C s. | | _ | | _ | i o | i n d S( N( R$ t attribst save( R R$ R ( ( s( /usr/lib/python2.6/site-packages/cmd2.pyRS s
c C s4 x- | i D]" } t | | t | i | q
Wd S( N( R Rq R# R$ ( R t attrib( ( s( /usr/lib/python2.6/site-packages/cmd2.pyR s
c C sB | i o4 x1 | i D]" } t | i | t | | q Wn d S( N( R$ R Rq R# ( R R ( ( s( /usr/lib/python2.6/site-packages/cmd2.pyR: s
( R R RS R R: ( ( ( s( /usr/lib/python2.6/site-packages/cmd2.pyR1 s t Borgc B s e Z d Z h Z d Z RS( sc All instances of any Borg subclass will share state.
from Python Cookbook, 2nd Ed., recipe 6.16c O s% t i | | | } | i | _ | S( N( t objectt __new__t
_shared_statet __dict__( R R t kR$ ( ( s( /usr/lib/python2.6/site-packages/cmd2.pyR s ( R R R R R ( ( ( s( /usr/lib/python2.6/site-packages/cmd2.pyR s t
OutputTrapc B s2 e Z d Z d Z d Z d Z d Z RS( s Instantiate an OutputTrap to divert/capture ALL stdout output. For use in unit testing.
Call `tearDown()` to return to normal output.c C s" d | _ t i | _ | t _ d S( NRW ( t contentsRU R( t
old_stdout( R ( ( s( /usr/lib/python2.6/site-packages/cmd2.pyRS s c C s | i | 7_ d S( N( R ( R R` ( ( s( /usr/lib/python2.6/site-packages/cmd2.pyRm s c C s | i } d | _ | S( NRW ( R ( R R= ( ( s( /usr/lib/python2.6/site-packages/cmd2.pyRg s c C s | i t _ d | _ d S( NRW ( R RU R( R ( R ( ( s( /usr/lib/python2.6/site-packages/cmd2.pyt tearDown s ( R R R RS Rm Rg R ( ( ( s( /usr/lib/python2.6/site-packages/cmd2.pyR s
R c B s e Z d Z d Z d Z d Z d Z e i d d d d d e
d e
Z e i e i
e i e i Z e i d
e e BZ e i d e i e i B Z d Z d
Z RS( s Subclass this, setting CmdApp, to make a unittest.TestCase class
that will execute the commands in a transcript file and expect the results shown.
See example.pyc C s h | _ x] | i i D]O } xF t i | D]5 } t | } t | i | i | <| i q, Wq Wt | i p t d n d S( Ns& No test files found - nothing to test.(
t transcriptsR R t globR t itert readlinesRn R t
StandardError( R t filesetR t tfile( ( s( /usr/lib/python2.6/site-packages/cmd2.pyt fetchTranscripts s
c C s7 | i o) t | _ | i | _ | i n d S( N( R R t
outputTrapt cmdappR ( R ( ( s( /usr/lib/python2.6/site-packages/cmd2.pyt setUp s
c C sN | i o@ t | i i } x( | D] \ } } | i | | q& Wn d S( N( R R R R t _test_transcript( R t itsR t
transcript( ( s( /usr/lib/python2.6/site-packages/cmd2.pyt runTest s
t quoteCharR t escChars \t multilinet unquoteResultsc C s t i | d S( i ( R R ( R ( ( s( /usr/lib/python2.6/site-packages/cmd2.pyR s s \sc C s d } t } | i } | d 7} d } xt| plxR | i | i i p; y | i } Wn t j
o t } Pn X| d 7} q5 W| t | i i g } | i } x| | i | i i oe | i | t | i i y | i } Wn' t j
o t d | d f n X| d 7} q Wd i
| } | i i | } | i i
} | i | i i o4 d | | | | f }
| i | i |
q+ n g } x_ | i | i i pH | i | y | i } Wn t j
o t } Pn X| d 7} qWd i
| } d | | | | | f }
| i i | } | i i d | } | i i d | } | i t i | | t i t i B |
q+ Wd S( Ni i sG Transcript broke off while reading command beginning at line %d with
%sRW s>
File %s, line %d
Command was:
%r
Expected: (nothing)
Got:
%r
s7
File %s, line %d
Command was:
%s
Expected:
%s
Got:
%s
( R t nextR R
RF t
StopIterationR R R. RJ R R, R Rg t assert_R t expectationParserR t
anyWhitespacet subR R R R ( R R R t lineNumt finishedR* t tests_runRp R R= t messaget expected( ( s( /usr/lib/python2.6/site-packages/cmd2.pyR sh
c C s | i o | i i n d S( N( R R R ( R ( ( s( /usr/lib/python2.6/site-packages/cmd2.pyR ! s
N( R R R R R R R R RK t QuotedStringR t regexPatternR R R t
printablest notRegexPatternR R R R R R R R R ( ( ( s( /usr/lib/python2.6/site-packages/cmd2.pyR s $
9t __main__t optionflags(U R R R R RU R R* R7 t doctestR R# R R R RV R{ t codeR R R RK t __version__t version_infot
ParserElementt
enablePackratR R" R& R1 t ValuesR RI RN R6 RO Rc t mswindowsRX R] Ra RN R R5 t
check_callR R, t CalledProcessErrorR/ R R
t
teststringR+ Rk Rf Rm Rn R( Rg RR t setDefaultWhitespaceCharsR R6 Rw Rv R| R t
SystemExitR R R R R RH R Rr Rp R R1 R R t TestCaseR R t testmodt NORMALIZE_WHITESPACE( ( ( s( /usr/lib/python2.6/site-packages/cmd2.pyt s
2
.
.
'
'
2
i [