# HG changeset patch # User catherine@dellzilla # Date 1222706909 14400 # Node ID 3de2a3eb765afce52478bfe83099c48507b3bd8d # Parent 00898931969b3805a7a4538fea655b83b87fa43d oops, renesting directory diff -r 00898931969b -r 3de2a3eb765a README.txt --- a/README.txt Mon Sep 29 12:35:59 2008 -0400 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 @@ -1,177 +0,0 @@ -`cmd2` is a tool for writing command-line interactive applications. It is based on the Python Standard Library's `cmd` module, and can be used anyplace `cmd` is used simply by importing `cmd2` instead. - -`cmd2` provides the following features, in addition to those already existing in `cmd`: - -- Searchable command history -- 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 -- Parsing commands with flags -- Redirection to file with `>`, `>>`; input from file with `<` -- Bare '>', '>>' with no filename send output to paste buffer -- Pipe output to shell commands with `|` - -Instructions for implementing each feature follow. - -- Searchable command history - - All commands will automatically be tracked in the session's history, unless the command is listed in Cmd's excludeFromHistory attribute. - The history is accessed through the `history`, `list`, and `run` commands - (and their abbreviations: `hi`, `li`, `l`, `r`). - If you wish to exclude some of your custom commands from the history, append their names - to the list at Cmd.ExcludeFromHistory. - -- Load commands from file, save to file, edit commands in file - - Type `help load`, `help save`, `help edit` for details. - -- Multi-line commands - - Any command accepts multi-line input when its name is listed in `Cmd.multilineCommands`. - The program will keep expecting input until a line ends with any of the characters - in `Cmd.terminators` . The default terminators are `;` and `/n` (empty newline). - -- Case-insensitive commands - - All commands are case-insensitive, unless `Cmd.caseInsensitive` is set to `False`. - -- Special-character shortcut commands (beyond cmd's "@" and "!") - - To create a single-character shortcut for a command, update `Cmd.shortcuts`. - -- Settable environment parameters - - To allow a user to change an environment parameter during program execution, - append the parameter's name to `Cmd.settable`. - -- Parsing commands with `optparse` options (flags) - - :: - - @options([make_option('-m', '--myoption', action="store_true", help="all about my option")]) - def do_myfunc(self, arg, opts): - if opts.myoption: - ... - - See Python standard library's `optparse` documentation: http://docs.python.org/lib/optparse-defining-options.html - -- Catherine Devlin, http://catherinedevlin.blogspot.com - -cmd2 can be installed with `easy_install cmd2` - -Cheese Shop page: http://pypi.python.org/pypi/cmd2 - -Example cmd2 application (cmd2_example.py) :: - - from cmd2 import Cmd, make_option, options - - class CmdLineApp(Cmd): - multilineCommands = ['orate'] - Cmd.shortcuts.update({'&': 'speak'}) - maxrepeats = 3 - Cmd.settable.append('maxrepeats') - - @options([make_option('-p', '--piglatin', action="store_true", help="atinLay"), - make_option('-s', '--shout', action="store_true", help="N00B EMULATION MODE"), - make_option('-r', '--repeat', type="int", help="output [n] times") - ]) - def do_speak(self, arg, opts=None): - """Repeats what you tell me to.""" - arg = ' '.join(arg) - if opts.piglatin: - arg = '%s%say' % (arg[1:], arg[0]) - if opts.shout: - arg = arg.upper() - repetitions = opts.repeat or 1 - for i in range(min(repetitions, self.maxrepeats)): - self.stdout.write(arg) - self.stdout.write('\n') - # self.stdout.write is better than "print", because Cmd can be - # initialized with a non-standard output destination - - do_say = do_speak # now "say" is a synonym for "speak" - do_orate = do_speak # another synonym, but this one takes multi-line input - - app = CmdLineApp() - app.cmdloop() - -Sample session using the above code :: - - c:\cmd2>python cmd2_example.py - (Cmd) speak softly - softly - (Cmd) speak --piglatin softly - oftlysay - (Cmd) speak -psr 2 softly - OFTLYSAY - OFTLYSAY - (Cmd) speak --repeat 1000000 softly - softly - softly - softly - (Cmd) show maxrepeats - maxrepeats: 3 - (Cmd) set maxrepeats 5 - maxrepeats - was: 3 - now: 5 - (Cmd) speak --repeat 1000000 softly - softly - softly - softly - softly - softly - (Cmd) orate blah blah - > blah - > and furthermore - > blah - > - blah blah blah and furthermore blah - (Cmd) &greetings - greetings - (Cmd) history - -------------------------[1] - speak softly - -------------------------[2] - speak --piglatin softly - -------------------------[3] - speak -psr 2 softly - -------------------------[4] - speak --repeat 1000000 softly - -------------------------[5] - show maxrepeats - -------------------------[6] - set maxrepeats 5 - -------------------------[7] - speak --repeat 1000000 softly - -------------------------[8] - orate blah blah - blah - and furthermore - blah - - -------------------------[9] - &greetings - (Cmd) run - orate blah blah - blah - and furthermore - blah - - blah blah blah and furthermore blah - (Cmd) run 3 - speak -psr 2 softly - OFTLYSAY - OFTLYSAY - (Cmd) history maxrepeats - -------------------------[5] - set maxrepeats - -------------------------[6] - set maxrepeats 5 - (Cmd) speak a dead parrot > pet.txt - (Cmd) speak < pet.txt - a dead parrot - (Cmd) speak only resting | wc - 1 2 13 - (Cmd) diff -r 00898931969b -r 3de2a3eb765a __init__.py --- a/__init__.py Mon Sep 29 12:35:59 2008 -0400 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 @@ -1,3 +0,0 @@ -from cmd2 import Cmd, options, make_option -__all__ = ["cmd2", "flagReader", "bootstrap"] -__version__ = '0.3.7' \ No newline at end of file diff -r 00898931969b -r 3de2a3eb765a bootstrap.py --- a/bootstrap.py Mon Sep 29 12:35:59 2008 -0400 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 @@ -1,62 +0,0 @@ -############################################################################## -# -# Copyright (c) 2006 Zope Corporation and Contributors. -# All Rights Reserved. -# -# This software is subject to the provisions of the Zope Public License, -# Version 2.1 (ZPL). A copy of the ZPL should accompany this distribution. -# THIS SOFTWARE IS PROVIDED "AS IS" AND ANY AND ALL EXPRESS OR IMPLIED -# WARRANTIES ARE DISCLAIMED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED -# WARRANTIES OF TITLE, MERCHANTABILITY, AGAINST INFRINGEMENT, AND FITNESS -# FOR A PARTICULAR PURPOSE. -# -############################################################################## -"""Bootstrap a buildout-based project - -Simply run this script in a directory containing a buildout.cfg. -The script accepts buildout command-line options, so you can -use the -c option to specify an alternate configuration file. - -$Id$ -""" - -import os, shutil, sys, tempfile, urllib2 - -tmpeggs = tempfile.mkdtemp() - -try: - import pkg_resources -except ImportError: - ez = {} - exec urllib2.urlopen('http://peak.telecommunity.com/dist/ez_setup.py' - ).read() in ez - ez['use_setuptools'](to_dir=tmpeggs, download_delay=0) - - import pkg_resources - -if sys.platform == 'win32': - def quote(c): - if ' ' in c: - return '"%s"' % c # work around spawn lamosity on windows - else: - return c -else: - def quote (c): - return c - -cmd = 'from setuptools.command.easy_install import main; main()' -ws = pkg_resources.working_set -assert os.spawnle( - os.P_WAIT, sys.executable, quote (sys.executable), - '-c', quote (cmd), '-mqNxd', quote (tmpeggs), 'zc.buildout', - dict(os.environ, - PYTHONPATH= - ws.find(pkg_resources.Requirement.parse('setuptools')).location - ), - ) == 0 - -ws.add_entry(tmpeggs) -ws.require('zc.buildout') -import zc.buildout.buildout -zc.buildout.buildout.main(sys.argv[1:] + ['bootstrap']) -shutil.rmtree(tmpeggs) diff -r 00898931969b -r 3de2a3eb765a cmd2.py --- a/cmd2.py Mon Sep 29 12:35:59 2008 -0400 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 @@ -1,677 +0,0 @@ -"""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 -Parsing commands with `optparse` options (flags) -Redirection to file with >, >>; input from file with < - -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 - -CHANGES: -As of 0.3.0, options should be specified as `optparse` options. See README.txt. -flagReader.py options are still supported for backward compatibility -""" -import cmd, re, os, sys, optparse, subprocess, tempfile, pyparsing, doctest -from optparse import make_option -__version__ = '0.3.7' - -class OptionParser(optparse.OptionParser): - def exit(self, status=0, msg=None): - self.values._exit = True - if msg: - print msg - - def error(self, msg): - """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. - """ - raise - -def options(option_list): - def option_setup(func): - optionParser = OptionParser() - for opt in option_list: - optionParser.add_option(opt) - optionParser.set_usage("%s [options] arg" % func.__name__.strip('do_')) - def newFunc(instance, arg): - try: - opts, arg = optionParser.parse_args(arg.split()) - arg = ' '.join(arg) - except (optparse.OptionValueError, optparse.BadOptionError, - optparse.OptionError, optparse.AmbiguousOptionError, - optparse.OptionConflictError), e: - print e - optionParser.print_help() - return - if hasattr(opts, '_exit'): - return None - result = func(instance, arg, opts) - return result - newFunc.__doc__ = '%s\n%s' % (func.__doc__, optionParser.format_help()) - return newFunc - return option_setup - -class PasteBufferError(EnvironmentError): - if sys.platform[:3] == 'win': - errmsg = """Redirecting to or from paste buffer requires pywin32 -to be installed on operating system. -Download from http://sourceforge.net/projects/pywin32/""" - else: - errmsg = """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.""" - def __init__(self): - Exception.__init__(self, self.errmsg) - -'''check here if functions exist; otherwise, stub out''' -pastebufferr = """Redirecting to or from paste buffer requires %s -to be installed on operating system. -%s""" -if subprocess.mswindows: - try: - import win32clipboard - def getPasteBuffer(): - win32clipboard.OpenClipboard(0) - try: - result = win32clipboard.GetClipboardData() - except TypeError: - result = '' #non-text - win32clipboard.CloseClipboard() - return result - def writeToPasteBuffer(txt): - win32clipboard.OpenClipboard(0) - win32clipboard.EmptyClipboard() - win32clipboard.SetClipboardText(txt) - win32clipboard.CloseClipboard() - except ImportError: - def getPasteBuffer(): - raise OSError, pastebufferr % ('pywin32', 'Download from http://sourceforge.net/projects/pywin32/') - setPasteBuffer = getPasteBuffer -else: - can_clip = False - try: - subprocess.check_call('xclip -o -sel clip', shell=True, stdout=subprocess.PIPE, stdin=subprocess.PIPE) - can_clip = True - except AttributeError: # check_call not defined, Python < 2.5 - teststring = 'Testing for presence of xclip.' - xclipproc = subprocess.Popen('xclip -sel clip', shell=True, stdout=subprocess.PIPE, stdin=subprocess.PIPE) - xclipproc.stdin.write(teststring) - xclipproc.stdin.close() - xclipproc = subprocess.Popen('xclip -o -sel clip', shell=True, stdout=subprocess.PIPE, stdin=subprocess.PIPE) - if xclipproc.stdout.read() == teststring: - can_clip = True - except (subprocess.CalledProcessError, OSError, IOError): - pass - if can_clip: - def getPasteBuffer(): - xclipproc = subprocess.Popen('xclip -o -sel clip', shell=True, stdout=subprocess.PIPE, stdin=subprocess.PIPE) - return xclipproc.stdout.read() - def writeToPasteBuffer(txt): - xclipproc = subprocess.Popen('xclip -sel clip', shell=True, stdout=subprocess.PIPE, stdin=subprocess.PIPE) - xclipproc.stdin.write(txt) - xclipproc.stdin.close() - # but we want it in both the "primary" and "mouse" clipboards - xclipproc = subprocess.Popen('xclip', shell=True, stdout=subprocess.PIPE, stdin=subprocess.PIPE) - xclipproc.stdin.write(txt) - xclipproc.stdin.close() - else: - def getPasteBuffer(): - raise OSError, pastebufferr % ('xclip', 'On Debian/Ubuntu, install with "sudo apt-get install xclip"') - setPasteBuffer = getPasteBuffer - -pyparsing.ParserElement.setDefaultWhitespaceChars(' \t') -def parseSearchResults(pattern, s): - generator = pattern.scanString(s) - try: - result, start, stop = generator.next() - result['before'], result['after'] = s[:start], s[stop:] - result['upToIncluding'] = s[:stop] - except StopIteration: - result = pyparsing.ParseResults('') - result['before'] = s - return result - -class Cmd(cmd.Cmd): - caseInsensitive = True - multilineCommands = [] - continuationPrompt = '> ' - shortcuts = {'?': 'help', '!': 'shell', '@': 'load'} - excludeFromHistory = '''run r list l history hi ed edit li eof'''.split() - defaultExtension = 'txt' - defaultFileName = 'command.txt' - editor = os.environ.get('EDITOR') - _STOP_AND_EXIT = 2 - if not editor: - if sys.platform[:3] == 'win': - editor = 'notepad' - else: - for editor in ['gedit', 'kate', 'vim', 'emacs', 'nano', 'pico']: - if not os.system('which %s' % (editor)): - break - - settable = ['prompt', 'continuationPrompt', 'defaultFileName', 'editor', 'caseInsensitive'] - _TO_PASTE_BUFFER = 1 - def do_cmdenvironment(self, args): - self.stdout.write(""" - Commands are %(casesensitive)scase-sensitive. - Commands may be terminated with: %(terminators)s - Settable parameters: %(settable)s - """ % - { 'casesensitive': ('not ' and self.caseInsensitive) or '', - 'terminators': self.terminatorPattern, - 'settable': ' '.join(self.settable) - }) - - def do_help(self, arg): - cmd.Cmd.do_help(self, arg) - try: - fn = getattr(self, 'do_' + arg) - if fn and fn.optionParser: - fn.optionParser.print_help(file=self.stdout) - except AttributeError: - pass - - def __init__(self, *args, **kwargs): - cmd.Cmd.__init__(self, *args, **kwargs) - self.history = History() - - def do_shortcuts(self, args): - """Lists single-key shortcuts available.""" - result = "\n".join('%s: %s' % (sc[0], sc[1]) for sc in self.shortcuts.items()) - self.stdout.write("Single-key shortcuts for other commands:\n%s\n" % (result)) - - terminatorPattern = ((pyparsing.Literal(';') ^ pyparsing.Literal('\n\n')) - ^ (pyparsing.Literal('\nEOF') + pyparsing.lineEnd))('terminator') - argSeparatorPattern = pyparsing.Word(pyparsing.printables)('command') \ - + pyparsing.SkipTo(pyparsing.StringEnd())('args') - filenamePattern = pyparsing.Word(pyparsing.alphanums + '#$-_~{},.!:\\/') - integerPattern = pyparsing.Word(pyparsing.nums).setParseAction( lambda s,l,t: [ int(t[0]) ] ) - pipePattern = pyparsing.Literal('|')('pipe') + pyparsing.restOfLine('pipeTo') - redirectOutPattern = (pyparsing.Literal('>>') ^ '>')('output') \ - + pyparsing.Optional(filenamePattern)('outputTo') - redirectInPattern = pyparsing.Literal('<')('input') \ - + pyparsing.Optional(filenamePattern)('inputFrom') - punctuationPattern = pipePattern ^ redirectInPattern ^ redirectOutPattern - for p in (terminatorPattern, pipePattern, redirectInPattern, redirectOutPattern, punctuationPattern): - p.ignore(pyparsing.sglQuotedString) - p.ignore(pyparsing.dblQuotedString) - - def parsed(self, s): - ''' - >>> c = Cmd() - >>> r = c.parsed('quotes "are > ignored" < inp.txt') - >>> r.statement, r.input, r.inputFrom, r.output, r.outputFrom - ('quotes "are > ignored" ', '<', 'inp.txt', '', '') - >>> r = c.parsed('very complex; < from.txt >> to.txt etc.') - >>> r.statement, r.terminator, r.input, r.inputFrom, r.output, r.outputTo - ('very complex;', ';', '<', 'from.txt', '>>', 'to.txt') - >>> c.parsed('nothing to parse').statement - 'nothing to parse' - >>> r = c.parsed('ignore > within a terminated statement; > out.txt') - >>> r.statement, r.terminator, r.input, r.inputFrom, r.output, r.outputTo - ('ignore > within a terminated statement;', ';', '', '', '>', 'out.txt') - >>> r = c.parsed('send it to | sort | wc') - >>> r.statement, r.pipe, r.pipeTo - ('send it to ', '|', ' sort | wc') - >>> r = c.parsed('got from < thisfile.txt plus blah blah') - >>> r.statement, r.input, r.inputFrom - ('got from ', '<', 'thisfile.txt') - ''' - if isinstance(s, pyparsing.ParseResults): - return s - result = (pyparsing.SkipTo(pyparsing.StringEnd()))('fullStatement').parseString(s) - if s[0] in self.shortcuts: - s = self.shortcuts[s[0]] + ' ' + s[1:] - result['statement'] = s - result['parseable'] = s - result += parseSearchResults(self.terminatorPattern, s) - if result.terminator: - result['statement'] = result.upToIncluding - result['unterminated'] = result.before - result['parseable'] = result.after - else: - result += parseSearchResults(self.punctuationPattern, s) - result['statement'] = result['unterminated'] = result.before - result += parseSearchResults(self.pipePattern, result.parseable) - result += parseSearchResults(self.redirectInPattern, result.parseable) - result += parseSearchResults(self.redirectOutPattern, result.parseable) - result += parseSearchResults(self.argSeparatorPattern, result.statement) - if self.caseInsensitive: - result['command'] = result.command.lower() - result['statement'] = '%s %s' % (result.command, result.args) - return result - - def extractCommand(self, statement): - try: - (command, args) = statement.split(None,1) - except ValueError: - (command, args) = statement, '' - if self.caseInsensitive: - command = command.lower() - return command, args - - def onecmd(self, line, assumeComplete=False): - """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. - - """ - line = line.strip() - if not line: - return - statement = self.parsed(line) - while (statement.command in self.multilineCommands) and not \ - (statement.terminator or assumeComplete): - statement = self.parsed('%s\n%s' % (statement.fullStatement, - self.pseudo_raw_input(self.continuationPrompt))) - - statekeeper = None - stop = 0 - if statement.input: - if statement.inputFrom: - try: - newinput = open(statement.inputFrom, 'r').read() - except OSError, e: - print e - return 0 - else: - newinput = getPasteBuffer() - start, end = self.redirectInPattern.scanString(statement.fullStatement).next()[1:] - return self.onecmd('%s%s%s' % (statement.fullStatement[:start], - newinput, statement.fullStatement[end:])) - if statement.pipe and statement.pipeTo: - redirect = subprocess.Popen(statement.pipeTo, shell=True, stdout=subprocess.PIPE, stdin=subprocess.PIPE) - statekeeper = Statekeeper(self, ('stdout',)) - self.stdout = redirect.stdin - elif statement.output: - statekeeper = Statekeeper(self, ('stdout',)) - if statement.outputTo: - mode = 'w' - if statement.output == '>>': - mode = 'a' - try: - self.stdout = open(statement.outputTo, mode) - except OSError, e: - print e - return 0 - else: - statekeeper = Statekeeper(self, ('stdout',)) - self.stdout = tempfile.TemporaryFile() - if statement.output == '>>': - self.stdout.write(getPasteBuffer()) - stop = cmd.Cmd.onecmd(self, statement.statement) - try: - if statement.command not in self.excludeFromHistory: - self.history.append(statement.fullStatement) - finally: - if statekeeper: - if statement.output and not statement.outputTo: - self.stdout.seek(0) - writeToPasteBuffer(self.stdout.read()) - elif statement.pipe: - for result in redirect.communicate(): - statekeeper.stdout.write(result or '') - self.stdout.close() - statekeeper.restore() - - return stop - - def pseudo_raw_input(self, prompt): - """copied from cmd's cmdloop; like raw_input, but accounts for changed stdin, stdout""" - - if self.use_rawinput: - try: - line = raw_input(prompt) - except EOFError: - line = 'EOF' - else: - self.stdout.write(prompt) - self.stdout.flush() - line = self.stdin.readline() - if not len(line): - line = 'EOF' - else: - if line[-1] == '\n': # this was always true in Cmd - line = line[:-1] - return line - - def cmdloop(self, intro=None): - """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. - """ - - # An almost perfect copy from Cmd; however, the pseudo_raw_input portion - # has been split out so that it can be called separately - - self.preloop() - if self.use_rawinput and self.completekey: - try: - import readline - self.old_completer = readline.get_completer() - readline.set_completer(self.complete) - readline.parse_and_bind(self.completekey+": complete") - except ImportError: - pass - try: - if intro is not None: - self.intro = intro - if self.intro: - self.stdout.write(str(self.intro)+"\n") - stop = None - while not stop: - if self.cmdqueue: - line = self.cmdqueue.pop(0) - else: - line = self.pseudo_raw_input(self.prompt) - line = self.precmd(line) - stop = self.onecmd(line) - stop = self.postcmd(stop, line) - self.postloop() - finally: - if self.use_rawinput and self.completekey: - try: - import readline - readline.set_completer(self.old_completer) - except ImportError: - pass - return stop - - def do_EOF(self, arg): - return True - do_eof = do_EOF - - def clean(self, s): - """cleans up a string""" - if self.caseInsensitive: - return s.strip().lower() - return s.strip() - - def showParam(self, param): - param = self.clean(param) - if param in self.settable: - val = getattr(self, param) - self.stdout.write('%s: %s\n' % (param, str(getattr(self, param)))) - - def do_quit(self, arg): - return self._STOP_AND_EXIT - do_exit = do_quit - do_q = do_quit - - def do_show(self, arg): - 'Shows value of a parameter' - if arg.strip(): - self.showParam(arg) - else: - for param in self.settable: - self.showParam(param) - - def do_set(self, arg): - 'Sets a parameter' - try: - paramName, val = arg.split(None, 1) - paramName = self.clean(paramName) - if paramName not in self.settable: - raise NotSettableError - currentVal = getattr(self, paramName) - val = cast(currentVal, self.parsed(val).unterminated) - setattr(self, paramName, val) - self.stdout.write('%s - was: %s\nnow: %s\n' % (paramName, currentVal, val)) - except (ValueError, AttributeError, NotSettableError), e: - self.do_show(arg) - - def do_shell(self, arg): - 'execute a command as if at the OS prompt.' - os.system(arg) - - def do_history(self, arg): - """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 - """ - if arg: - history = self.history.get(arg) - else: - history = self.history - for hi in history: - self.stdout.write(hi.pr()) - def last_matching(self, arg): - try: - if arg: - return self.history.get(arg)[-1] - else: - return self.history[-1] - except: - return None - def do_list(self, arg): - """list [arg]: lists last command issued - - no arg -> list absolute last - arg is integer -> list one history item, by index - - arg, arg - (integer) -> list up to or after #arg - arg is string -> list last command matching string search - arg is /enclosed in forward-slashes/ -> regular expression search - """ - try: - self.stdout.write(self.last_matching(arg).pr()) - except: - pass - do_hi = do_history - do_l = do_list - do_li = do_list - - def do_ed(self, arg): - """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.""" - if not self.editor: - print "please use 'set editor' to specify your text editing program of choice." - return - filename = self.defaultFileName - buffer = '' - try: - arg = int(arg) - buffer = self.last_matching(arg) - except: - if arg: - filename = arg - else: - buffer = self.last_matching(arg) - - if buffer: - f = open(filename, 'w') - f.write(buffer or '') - f.close() - - os.system('%s %s' % (self.editor, filename)) - self.do__load(filename) - do_edit = do_ed - - saveparser = (pyparsing.Optional(pyparsing.Word(pyparsing.nums)^'*')("idx") + - pyparsing.Optional(pyparsing.Word(pyparsing.printables))("fname") + - pyparsing.stringEnd) - def do_save(self, arg): - """`save [N] [filename.ext]` - Saves command from history to file. - N => Number of command (from history), or `*`; - most recent command if omitted""" - - try: - args = self.saveparser.parseString(arg) - except pyparsing.ParseException: - print self.do_save.__doc__ - return - fname = args.fname or self.defaultFileName - if args.idx == '*': - saveme = '\n\n'.join(self.history[:]) - elif args.idx: - saveme = self.history[int(args.idx)-1] - else: - saveme = self.history[-1] - try: - f = open(fname, 'w') - f.write(saveme) - f.close() - print 'Saved to %s' % (fname) - except Exception, e: - print 'Error saving %s: %s' % (fname, str(e)) - - def do_load(self, fname=None): - """Runs command(s) from a file.""" - if fname is None: - fname = self.defaultFileName - keepstate = Statekeeper(self, ('stdin','use_rawinput','prompt','continuationPrompt')) - if isinstance(fname, file): - self.stdin = fname - else: - try: - self.stdin = open(fname, 'r') - except IOError, e: - try: - self.stdin = open('%s.%s' % (fname, self.defaultExtension), 'r') - except IOError: - print 'Problem opening file %s: \n%s' % (fname, e) - keepstate.restore() - return - self.use_rawinput = False - self.prompt = self.continuationPrompt = '' - stop = self.cmdloop() - self.stdin.close() - keepstate.restore() - self.lastcmd = '' - return (stop == self._STOP_AND_EXIT) and self._STOP_AND_EXIT - do__load = do_load # avoid an unfortunate legacy use of do_load from sqlpython - - def do_run(self, arg): - """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 - """ - 'run [N]: runs the SQL that was run N commands ago' - runme = self.last_matching(arg) - print runme - if runme: - runme = self.precmd(runme) - stop = self.onecmd(runme) - stop = self.postcmd(stop, runme) - do_r = do_run - - def fileimport(self, statement, source): - try: - f = open(source) - except IOError: - self.stdout.write("Couldn't read from file %s\n" % source) - return '' - data = f.read() - f.close() - return data - -class HistoryItem(str): - def __init__(self, instr): - str.__init__(self, instr) - self.lowercase = self.lower() - self.idx = None - def pr(self): - return '-------------------------[%d]\n%s\n' % (self.idx, str(self)) - -class History(list): - rangeFrom = re.compile(r'^([\d])+\s*\-$') - def append(self, new): - new = HistoryItem(new) - list.append(self, new) - new.idx = len(self) - def extend(self, new): - for n in new: - self.append(n) - def get(self, getme): - try: - getme = int(getme) - if getme < 0: - return self[:(-1 * getme)] - else: - return [self[getme-1]] - except IndexError: - return [] - except (ValueError, TypeError): - getme = getme.strip() - mtch = self.rangeFrom.search(getme) - if mtch: - return self[(int(mtch.group(1))-1):] - if getme.startswith(r'/') and getme.endswith(r'/'): - finder = re.compile(getme[1:-1], re.DOTALL | re.MULTILINE | re.IGNORECASE) - def isin(hi): - return finder.search(hi) - else: - def isin(hi): - return (getme.lower() in hi.lowercase) - return [itm for itm in self if isin(itm)] - -class NotSettableError(Exception): - pass - -def cast(current, new): - """Tries to force a new value into the same type as the current.""" - typ = type(current) - if typ == bool: - try: - return bool(int(new)) - except ValueError, TypeError: - pass - try: - new = new.lower() - except: - pass - if (new=='on') or (new[0] in ('y','t')): - return True - if (new=='off') or (new[0] in ('n','f')): - return False - else: - try: - return typ(new) - except: - pass - print "Problem setting parameter (now %s) to %s; incorrect type?" % (current, new) - return current - -class Statekeeper(object): - def __init__(self, obj, attribs): - self.obj = obj - self.attribs = attribs - self.save() - def save(self): - for attrib in self.attribs: - setattr(self, attrib, getattr(self.obj, attrib)) - def restore(self): - for attrib in self.attribs: - setattr(self.obj, attrib, getattr(self, attrib)) - -if __name__ == '__main__': - doctest.testmod() diff -r 00898931969b -r 3de2a3eb765a cmd2/README.txt --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/cmd2/README.txt Mon Sep 29 12:48:29 2008 -0400 @@ -0,0 +1,177 @@ +`cmd2` is a tool for writing command-line interactive applications. It is based on the Python Standard Library's `cmd` module, and can be used anyplace `cmd` is used simply by importing `cmd2` instead. + +`cmd2` provides the following features, in addition to those already existing in `cmd`: + +- Searchable command history +- 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 +- Parsing commands with flags +- Redirection to file with `>`, `>>`; input from file with `<` +- Bare '>', '>>' with no filename send output to paste buffer +- Pipe output to shell commands with `|` + +Instructions for implementing each feature follow. + +- Searchable command history + + All commands will automatically be tracked in the session's history, unless the command is listed in Cmd's excludeFromHistory attribute. + The history is accessed through the `history`, `list`, and `run` commands + (and their abbreviations: `hi`, `li`, `l`, `r`). + If you wish to exclude some of your custom commands from the history, append their names + to the list at Cmd.ExcludeFromHistory. + +- Load commands from file, save to file, edit commands in file + + Type `help load`, `help save`, `help edit` for details. + +- Multi-line commands + + Any command accepts multi-line input when its name is listed in `Cmd.multilineCommands`. + The program will keep expecting input until a line ends with any of the characters + in `Cmd.terminators` . The default terminators are `;` and `/n` (empty newline). + +- Case-insensitive commands + + All commands are case-insensitive, unless `Cmd.caseInsensitive` is set to `False`. + +- Special-character shortcut commands (beyond cmd's "@" and "!") + + To create a single-character shortcut for a command, update `Cmd.shortcuts`. + +- Settable environment parameters + + To allow a user to change an environment parameter during program execution, + append the parameter's name to `Cmd.settable`. + +- Parsing commands with `optparse` options (flags) + + :: + + @options([make_option('-m', '--myoption', action="store_true", help="all about my option")]) + def do_myfunc(self, arg, opts): + if opts.myoption: + ... + + See Python standard library's `optparse` documentation: http://docs.python.org/lib/optparse-defining-options.html + +- Catherine Devlin, http://catherinedevlin.blogspot.com + +cmd2 can be installed with `easy_install cmd2` + +Cheese Shop page: http://pypi.python.org/pypi/cmd2 + +Example cmd2 application (cmd2_example.py) :: + + from cmd2 import Cmd, make_option, options + + class CmdLineApp(Cmd): + multilineCommands = ['orate'] + Cmd.shortcuts.update({'&': 'speak'}) + maxrepeats = 3 + Cmd.settable.append('maxrepeats') + + @options([make_option('-p', '--piglatin', action="store_true", help="atinLay"), + make_option('-s', '--shout', action="store_true", help="N00B EMULATION MODE"), + make_option('-r', '--repeat', type="int", help="output [n] times") + ]) + def do_speak(self, arg, opts=None): + """Repeats what you tell me to.""" + arg = ' '.join(arg) + if opts.piglatin: + arg = '%s%say' % (arg[1:], arg[0]) + if opts.shout: + arg = arg.upper() + repetitions = opts.repeat or 1 + for i in range(min(repetitions, self.maxrepeats)): + self.stdout.write(arg) + self.stdout.write('\n') + # self.stdout.write is better than "print", because Cmd can be + # initialized with a non-standard output destination + + do_say = do_speak # now "say" is a synonym for "speak" + do_orate = do_speak # another synonym, but this one takes multi-line input + + app = CmdLineApp() + app.cmdloop() + +Sample session using the above code :: + + c:\cmd2>python cmd2_example.py + (Cmd) speak softly + softly + (Cmd) speak --piglatin softly + oftlysay + (Cmd) speak -psr 2 softly + OFTLYSAY + OFTLYSAY + (Cmd) speak --repeat 1000000 softly + softly + softly + softly + (Cmd) show maxrepeats + maxrepeats: 3 + (Cmd) set maxrepeats 5 + maxrepeats - was: 3 + now: 5 + (Cmd) speak --repeat 1000000 softly + softly + softly + softly + softly + softly + (Cmd) orate blah blah + > blah + > and furthermore + > blah + > + blah blah blah and furthermore blah + (Cmd) &greetings + greetings + (Cmd) history + -------------------------[1] + speak softly + -------------------------[2] + speak --piglatin softly + -------------------------[3] + speak -psr 2 softly + -------------------------[4] + speak --repeat 1000000 softly + -------------------------[5] + show maxrepeats + -------------------------[6] + set maxrepeats 5 + -------------------------[7] + speak --repeat 1000000 softly + -------------------------[8] + orate blah blah + blah + and furthermore + blah + + -------------------------[9] + &greetings + (Cmd) run + orate blah blah + blah + and furthermore + blah + + blah blah blah and furthermore blah + (Cmd) run 3 + speak -psr 2 softly + OFTLYSAY + OFTLYSAY + (Cmd) history maxrepeats + -------------------------[5] + set maxrepeats + -------------------------[6] + set maxrepeats 5 + (Cmd) speak a dead parrot > pet.txt + (Cmd) speak < pet.txt + a dead parrot + (Cmd) speak only resting | wc + 1 2 13 + (Cmd) diff -r 00898931969b -r 3de2a3eb765a cmd2/__init__.py --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/cmd2/__init__.py Mon Sep 29 12:48:29 2008 -0400 @@ -0,0 +1,3 @@ +from cmd2 import Cmd, options, make_option, Statekeeper +__all__ = ["cmd2", "flagReader", "bootstrap"] +__version__ = '0.3.7' \ No newline at end of file diff -r 00898931969b -r 3de2a3eb765a cmd2/bootstrap.py --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/cmd2/bootstrap.py Mon Sep 29 12:48:29 2008 -0400 @@ -0,0 +1,62 @@ +############################################################################## +# +# Copyright (c) 2006 Zope Corporation and Contributors. +# All Rights Reserved. +# +# This software is subject to the provisions of the Zope Public License, +# Version 2.1 (ZPL). A copy of the ZPL should accompany this distribution. +# THIS SOFTWARE IS PROVIDED "AS IS" AND ANY AND ALL EXPRESS OR IMPLIED +# WARRANTIES ARE DISCLAIMED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED +# WARRANTIES OF TITLE, MERCHANTABILITY, AGAINST INFRINGEMENT, AND FITNESS +# FOR A PARTICULAR PURPOSE. +# +############################################################################## +"""Bootstrap a buildout-based project + +Simply run this script in a directory containing a buildout.cfg. +The script accepts buildout command-line options, so you can +use the -c option to specify an alternate configuration file. + +$Id$ +""" + +import os, shutil, sys, tempfile, urllib2 + +tmpeggs = tempfile.mkdtemp() + +try: + import pkg_resources +except ImportError: + ez = {} + exec urllib2.urlopen('http://peak.telecommunity.com/dist/ez_setup.py' + ).read() in ez + ez['use_setuptools'](to_dir=tmpeggs, download_delay=0) + + import pkg_resources + +if sys.platform == 'win32': + def quote(c): + if ' ' in c: + return '"%s"' % c # work around spawn lamosity on windows + else: + return c +else: + def quote (c): + return c + +cmd = 'from setuptools.command.easy_install import main; main()' +ws = pkg_resources.working_set +assert os.spawnle( + os.P_WAIT, sys.executable, quote (sys.executable), + '-c', quote (cmd), '-mqNxd', quote (tmpeggs), 'zc.buildout', + dict(os.environ, + PYTHONPATH= + ws.find(pkg_resources.Requirement.parse('setuptools')).location + ), + ) == 0 + +ws.add_entry(tmpeggs) +ws.require('zc.buildout') +import zc.buildout.buildout +zc.buildout.buildout.main(sys.argv[1:] + ['bootstrap']) +shutil.rmtree(tmpeggs) diff -r 00898931969b -r 3de2a3eb765a cmd2/cmd2.py --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/cmd2/cmd2.py Mon Sep 29 12:48:29 2008 -0400 @@ -0,0 +1,677 @@ +"""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 +Parsing commands with `optparse` options (flags) +Redirection to file with >, >>; input from file with < + +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 + +CHANGES: +As of 0.3.0, options should be specified as `optparse` options. See README.txt. +flagReader.py options are still supported for backward compatibility +""" +import cmd, re, os, sys, optparse, subprocess, tempfile, pyparsing, doctest +from optparse import make_option +__version__ = '0.3.7' + +class OptionParser(optparse.OptionParser): + def exit(self, status=0, msg=None): + self.values._exit = True + if msg: + print msg + + def error(self, msg): + """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. + """ + raise + +def options(option_list): + def option_setup(func): + optionParser = OptionParser() + for opt in option_list: + optionParser.add_option(opt) + optionParser.set_usage("%s [options] arg" % func.__name__.strip('do_')) + def newFunc(instance, arg): + try: + opts, arg = optionParser.parse_args(arg.split()) + arg = ' '.join(arg) + except (optparse.OptionValueError, optparse.BadOptionError, + optparse.OptionError, optparse.AmbiguousOptionError, + optparse.OptionConflictError), e: + print e + optionParser.print_help() + return + if hasattr(opts, '_exit'): + return None + result = func(instance, arg, opts) + return result + newFunc.__doc__ = '%s\n%s' % (func.__doc__, optionParser.format_help()) + return newFunc + return option_setup + +class PasteBufferError(EnvironmentError): + if sys.platform[:3] == 'win': + errmsg = """Redirecting to or from paste buffer requires pywin32 +to be installed on operating system. +Download from http://sourceforge.net/projects/pywin32/""" + else: + errmsg = """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.""" + def __init__(self): + Exception.__init__(self, self.errmsg) + +'''check here if functions exist; otherwise, stub out''' +pastebufferr = """Redirecting to or from paste buffer requires %s +to be installed on operating system. +%s""" +if subprocess.mswindows: + try: + import win32clipboard + def getPasteBuffer(): + win32clipboard.OpenClipboard(0) + try: + result = win32clipboard.GetClipboardData() + except TypeError: + result = '' #non-text + win32clipboard.CloseClipboard() + return result + def writeToPasteBuffer(txt): + win32clipboard.OpenClipboard(0) + win32clipboard.EmptyClipboard() + win32clipboard.SetClipboardText(txt) + win32clipboard.CloseClipboard() + except ImportError: + def getPasteBuffer(): + raise OSError, pastebufferr % ('pywin32', 'Download from http://sourceforge.net/projects/pywin32/') + setPasteBuffer = getPasteBuffer +else: + can_clip = False + try: + subprocess.check_call('xclip -o -sel clip', shell=True, stdout=subprocess.PIPE, stdin=subprocess.PIPE) + can_clip = True + except AttributeError: # check_call not defined, Python < 2.5 + teststring = 'Testing for presence of xclip.' + xclipproc = subprocess.Popen('xclip -sel clip', shell=True, stdout=subprocess.PIPE, stdin=subprocess.PIPE) + xclipproc.stdin.write(teststring) + xclipproc.stdin.close() + xclipproc = subprocess.Popen('xclip -o -sel clip', shell=True, stdout=subprocess.PIPE, stdin=subprocess.PIPE) + if xclipproc.stdout.read() == teststring: + can_clip = True + except (subprocess.CalledProcessError, OSError, IOError): + pass + if can_clip: + def getPasteBuffer(): + xclipproc = subprocess.Popen('xclip -o -sel clip', shell=True, stdout=subprocess.PIPE, stdin=subprocess.PIPE) + return xclipproc.stdout.read() + def writeToPasteBuffer(txt): + xclipproc = subprocess.Popen('xclip -sel clip', shell=True, stdout=subprocess.PIPE, stdin=subprocess.PIPE) + xclipproc.stdin.write(txt) + xclipproc.stdin.close() + # but we want it in both the "primary" and "mouse" clipboards + xclipproc = subprocess.Popen('xclip', shell=True, stdout=subprocess.PIPE, stdin=subprocess.PIPE) + xclipproc.stdin.write(txt) + xclipproc.stdin.close() + else: + def getPasteBuffer(): + raise OSError, pastebufferr % ('xclip', 'On Debian/Ubuntu, install with "sudo apt-get install xclip"') + setPasteBuffer = getPasteBuffer + +pyparsing.ParserElement.setDefaultWhitespaceChars(' \t') +def parseSearchResults(pattern, s): + generator = pattern.scanString(s) + try: + result, start, stop = generator.next() + result['before'], result['after'] = s[:start], s[stop:] + result['upToIncluding'] = s[:stop] + except StopIteration: + result = pyparsing.ParseResults('') + result['before'] = s + return result + +class Cmd(cmd.Cmd): + caseInsensitive = True + multilineCommands = [] + continuationPrompt = '> ' + shortcuts = {'?': 'help', '!': 'shell', '@': 'load'} + excludeFromHistory = '''run r list l history hi ed edit li eof'''.split() + defaultExtension = 'txt' + defaultFileName = 'command.txt' + editor = os.environ.get('EDITOR') + _STOP_AND_EXIT = 2 + if not editor: + if sys.platform[:3] == 'win': + editor = 'notepad' + else: + for editor in ['gedit', 'kate', 'vim', 'emacs', 'nano', 'pico']: + if not os.system('which %s' % (editor)): + break + + settable = ['prompt', 'continuationPrompt', 'defaultFileName', 'editor', 'caseInsensitive'] + _TO_PASTE_BUFFER = 1 + def do_cmdenvironment(self, args): + self.stdout.write(""" + Commands are %(casesensitive)scase-sensitive. + Commands may be terminated with: %(terminators)s + Settable parameters: %(settable)s + """ % + { 'casesensitive': ('not ' and self.caseInsensitive) or '', + 'terminators': self.terminatorPattern, + 'settable': ' '.join(self.settable) + }) + + def do_help(self, arg): + cmd.Cmd.do_help(self, arg) + try: + fn = getattr(self, 'do_' + arg) + if fn and fn.optionParser: + fn.optionParser.print_help(file=self.stdout) + except AttributeError: + pass + + def __init__(self, *args, **kwargs): + cmd.Cmd.__init__(self, *args, **kwargs) + self.history = History() + + def do_shortcuts(self, args): + """Lists single-key shortcuts available.""" + result = "\n".join('%s: %s' % (sc[0], sc[1]) for sc in self.shortcuts.items()) + self.stdout.write("Single-key shortcuts for other commands:\n%s\n" % (result)) + + terminatorPattern = ((pyparsing.Literal(';') ^ pyparsing.Literal('\n\n')) + ^ (pyparsing.Literal('\nEOF') + pyparsing.lineEnd))('terminator') + argSeparatorPattern = pyparsing.Word(pyparsing.printables)('command') \ + + pyparsing.SkipTo(pyparsing.StringEnd())('args') + filenamePattern = pyparsing.Word(pyparsing.alphanums + '#$-_~{},.!:\\/') + integerPattern = pyparsing.Word(pyparsing.nums).setParseAction( lambda s,l,t: [ int(t[0]) ] ) + pipePattern = pyparsing.Literal('|')('pipe') + pyparsing.restOfLine('pipeTo') + redirectOutPattern = (pyparsing.Literal('>>') ^ '>')('output') \ + + pyparsing.Optional(filenamePattern)('outputTo') + redirectInPattern = pyparsing.Literal('<')('input') \ + + pyparsing.Optional(filenamePattern)('inputFrom') + punctuationPattern = pipePattern ^ redirectInPattern ^ redirectOutPattern + for p in (terminatorPattern, pipePattern, redirectInPattern, redirectOutPattern, punctuationPattern): + p.ignore(pyparsing.sglQuotedString) + p.ignore(pyparsing.dblQuotedString) + + def parsed(self, s): + ''' + >>> c = Cmd() + >>> r = c.parsed('quotes "are > ignored" < inp.txt') + >>> r.statement, r.input, r.inputFrom, r.output, r.outputFrom + ('quotes "are > ignored" ', '<', 'inp.txt', '', '') + >>> r = c.parsed('very complex; < from.txt >> to.txt etc.') + >>> r.statement, r.terminator, r.input, r.inputFrom, r.output, r.outputTo + ('very complex;', ';', '<', 'from.txt', '>>', 'to.txt') + >>> c.parsed('nothing to parse').statement + 'nothing to parse' + >>> r = c.parsed('ignore > within a terminated statement; > out.txt') + >>> r.statement, r.terminator, r.input, r.inputFrom, r.output, r.outputTo + ('ignore > within a terminated statement;', ';', '', '', '>', 'out.txt') + >>> r = c.parsed('send it to | sort | wc') + >>> r.statement, r.pipe, r.pipeTo + ('send it to ', '|', ' sort | wc') + >>> r = c.parsed('got from < thisfile.txt plus blah blah') + >>> r.statement, r.input, r.inputFrom + ('got from ', '<', 'thisfile.txt') + ''' + if isinstance(s, pyparsing.ParseResults): + return s + result = (pyparsing.SkipTo(pyparsing.StringEnd()))('fullStatement').parseString(s) + if s[0] in self.shortcuts: + s = self.shortcuts[s[0]] + ' ' + s[1:] + result['statement'] = s + result['parseable'] = s + result += parseSearchResults(self.terminatorPattern, s) + if result.terminator: + result['statement'] = result.upToIncluding + result['unterminated'] = result.before + result['parseable'] = result.after + else: + result += parseSearchResults(self.punctuationPattern, s) + result['statement'] = result['unterminated'] = result.before + result += parseSearchResults(self.pipePattern, result.parseable) + result += parseSearchResults(self.redirectInPattern, result.parseable) + result += parseSearchResults(self.redirectOutPattern, result.parseable) + result += parseSearchResults(self.argSeparatorPattern, result.statement) + if self.caseInsensitive: + result['command'] = result.command.lower() + result['statement'] = '%s %s' % (result.command, result.args) + return result + + def extractCommand(self, statement): + try: + (command, args) = statement.split(None,1) + except ValueError: + (command, args) = statement, '' + if self.caseInsensitive: + command = command.lower() + return command, args + + def onecmd(self, line, assumeComplete=False): + """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. + + """ + line = line.strip() + if not line: + return + statement = self.parsed(line) + while (statement.command in self.multilineCommands) and not \ + (statement.terminator or assumeComplete): + statement = self.parsed('%s\n%s' % (statement.fullStatement, + self.pseudo_raw_input(self.continuationPrompt))) + + statekeeper = None + stop = 0 + if statement.input: + if statement.inputFrom: + try: + newinput = open(statement.inputFrom, 'r').read() + except OSError, e: + print e + return 0 + else: + newinput = getPasteBuffer() + start, end = self.redirectInPattern.scanString(statement.fullStatement).next()[1:] + return self.onecmd('%s%s%s' % (statement.fullStatement[:start], + newinput, statement.fullStatement[end:])) + if statement.pipe and statement.pipeTo: + redirect = subprocess.Popen(statement.pipeTo, shell=True, stdout=subprocess.PIPE, stdin=subprocess.PIPE) + statekeeper = Statekeeper(self, ('stdout',)) + self.stdout = redirect.stdin + elif statement.output: + statekeeper = Statekeeper(self, ('stdout',)) + if statement.outputTo: + mode = 'w' + if statement.output == '>>': + mode = 'a' + try: + self.stdout = open(statement.outputTo, mode) + except OSError, e: + print e + return 0 + else: + statekeeper = Statekeeper(self, ('stdout',)) + self.stdout = tempfile.TemporaryFile() + if statement.output == '>>': + self.stdout.write(getPasteBuffer()) + stop = cmd.Cmd.onecmd(self, statement.statement) + try: + if statement.command not in self.excludeFromHistory: + self.history.append(statement.fullStatement) + finally: + if statekeeper: + if statement.output and not statement.outputTo: + self.stdout.seek(0) + writeToPasteBuffer(self.stdout.read()) + elif statement.pipe: + for result in redirect.communicate(): + statekeeper.stdout.write(result or '') + self.stdout.close() + statekeeper.restore() + + return stop + + def pseudo_raw_input(self, prompt): + """copied from cmd's cmdloop; like raw_input, but accounts for changed stdin, stdout""" + + if self.use_rawinput: + try: + line = raw_input(prompt) + except EOFError: + line = 'EOF' + else: + self.stdout.write(prompt) + self.stdout.flush() + line = self.stdin.readline() + if not len(line): + line = 'EOF' + else: + if line[-1] == '\n': # this was always true in Cmd + line = line[:-1] + return line + + def cmdloop(self, intro=None): + """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. + """ + + # An almost perfect copy from Cmd; however, the pseudo_raw_input portion + # has been split out so that it can be called separately + + self.preloop() + if self.use_rawinput and self.completekey: + try: + import readline + self.old_completer = readline.get_completer() + readline.set_completer(self.complete) + readline.parse_and_bind(self.completekey+": complete") + except ImportError: + pass + try: + if intro is not None: + self.intro = intro + if self.intro: + self.stdout.write(str(self.intro)+"\n") + stop = None + while not stop: + if self.cmdqueue: + line = self.cmdqueue.pop(0) + else: + line = self.pseudo_raw_input(self.prompt) + line = self.precmd(line) + stop = self.onecmd(line) + stop = self.postcmd(stop, line) + self.postloop() + finally: + if self.use_rawinput and self.completekey: + try: + import readline + readline.set_completer(self.old_completer) + except ImportError: + pass + return stop + + def do_EOF(self, arg): + return True + do_eof = do_EOF + + def clean(self, s): + """cleans up a string""" + if self.caseInsensitive: + return s.strip().lower() + return s.strip() + + def showParam(self, param): + param = self.clean(param) + if param in self.settable: + val = getattr(self, param) + self.stdout.write('%s: %s\n' % (param, str(getattr(self, param)))) + + def do_quit(self, arg): + return self._STOP_AND_EXIT + do_exit = do_quit + do_q = do_quit + + def do_show(self, arg): + 'Shows value of a parameter' + if arg.strip(): + self.showParam(arg) + else: + for param in self.settable: + self.showParam(param) + + def do_set(self, arg): + 'Sets a parameter' + try: + paramName, val = arg.split(None, 1) + paramName = self.clean(paramName) + if paramName not in self.settable: + raise NotSettableError + currentVal = getattr(self, paramName) + val = cast(currentVal, self.parsed(val).unterminated) + setattr(self, paramName, val) + self.stdout.write('%s - was: %s\nnow: %s\n' % (paramName, currentVal, val)) + except (ValueError, AttributeError, NotSettableError), e: + self.do_show(arg) + + def do_shell(self, arg): + 'execute a command as if at the OS prompt.' + os.system(arg) + + def do_history(self, arg): + """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 + """ + if arg: + history = self.history.get(arg) + else: + history = self.history + for hi in history: + self.stdout.write(hi.pr()) + def last_matching(self, arg): + try: + if arg: + return self.history.get(arg)[-1] + else: + return self.history[-1] + except: + return None + def do_list(self, arg): + """list [arg]: lists last command issued + + no arg -> list absolute last + arg is integer -> list one history item, by index + - arg, arg - (integer) -> list up to or after #arg + arg is string -> list last command matching string search + arg is /enclosed in forward-slashes/ -> regular expression search + """ + try: + self.stdout.write(self.last_matching(arg).pr()) + except: + pass + do_hi = do_history + do_l = do_list + do_li = do_list + + def do_ed(self, arg): + """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.""" + if not self.editor: + print "please use 'set editor' to specify your text editing program of choice." + return + filename = self.defaultFileName + buffer = '' + try: + arg = int(arg) + buffer = self.last_matching(arg) + except: + if arg: + filename = arg + else: + buffer = self.last_matching(arg) + + if buffer: + f = open(filename, 'w') + f.write(buffer or '') + f.close() + + os.system('%s %s' % (self.editor, filename)) + self.do__load(filename) + do_edit = do_ed + + saveparser = (pyparsing.Optional(pyparsing.Word(pyparsing.nums)^'*')("idx") + + pyparsing.Optional(pyparsing.Word(pyparsing.printables))("fname") + + pyparsing.stringEnd) + def do_save(self, arg): + """`save [N] [filename.ext]` + Saves command from history to file. + N => Number of command (from history), or `*`; + most recent command if omitted""" + + try: + args = self.saveparser.parseString(arg) + except pyparsing.ParseException: + print self.do_save.__doc__ + return + fname = args.fname or self.defaultFileName + if args.idx == '*': + saveme = '\n\n'.join(self.history[:]) + elif args.idx: + saveme = self.history[int(args.idx)-1] + else: + saveme = self.history[-1] + try: + f = open(fname, 'w') + f.write(saveme) + f.close() + print 'Saved to %s' % (fname) + except Exception, e: + print 'Error saving %s: %s' % (fname, str(e)) + + def do_load(self, fname=None): + """Runs command(s) from a file.""" + if fname is None: + fname = self.defaultFileName + keepstate = Statekeeper(self, ('stdin','use_rawinput','prompt','continuationPrompt')) + if isinstance(fname, file): + self.stdin = fname + else: + try: + self.stdin = open(fname, 'r') + except IOError, e: + try: + self.stdin = open('%s.%s' % (fname, self.defaultExtension), 'r') + except IOError: + print 'Problem opening file %s: \n%s' % (fname, e) + keepstate.restore() + return + self.use_rawinput = False + self.prompt = self.continuationPrompt = '' + stop = self.cmdloop() + self.stdin.close() + keepstate.restore() + self.lastcmd = '' + return (stop == self._STOP_AND_EXIT) and self._STOP_AND_EXIT + do__load = do_load # avoid an unfortunate legacy use of do_load from sqlpython + + def do_run(self, arg): + """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 + """ + 'run [N]: runs the SQL that was run N commands ago' + runme = self.last_matching(arg) + print runme + if runme: + runme = self.precmd(runme) + stop = self.onecmd(runme) + stop = self.postcmd(stop, runme) + do_r = do_run + + def fileimport(self, statement, source): + try: + f = open(source) + except IOError: + self.stdout.write("Couldn't read from file %s\n" % source) + return '' + data = f.read() + f.close() + return data + +class HistoryItem(str): + def __init__(self, instr): + str.__init__(self, instr) + self.lowercase = self.lower() + self.idx = None + def pr(self): + return '-------------------------[%d]\n%s\n' % (self.idx, str(self)) + +class History(list): + rangeFrom = re.compile(r'^([\d])+\s*\-$') + def append(self, new): + new = HistoryItem(new) + list.append(self, new) + new.idx = len(self) + def extend(self, new): + for n in new: + self.append(n) + def get(self, getme): + try: + getme = int(getme) + if getme < 0: + return self[:(-1 * getme)] + else: + return [self[getme-1]] + except IndexError: + return [] + except (ValueError, TypeError): + getme = getme.strip() + mtch = self.rangeFrom.search(getme) + if mtch: + return self[(int(mtch.group(1))-1):] + if getme.startswith(r'/') and getme.endswith(r'/'): + finder = re.compile(getme[1:-1], re.DOTALL | re.MULTILINE | re.IGNORECASE) + def isin(hi): + return finder.search(hi) + else: + def isin(hi): + return (getme.lower() in hi.lowercase) + return [itm for itm in self if isin(itm)] + +class NotSettableError(Exception): + pass + +def cast(current, new): + """Tries to force a new value into the same type as the current.""" + typ = type(current) + if typ == bool: + try: + return bool(int(new)) + except ValueError, TypeError: + pass + try: + new = new.lower() + except: + pass + if (new=='on') or (new[0] in ('y','t')): + return True + if (new=='off') or (new[0] in ('n','f')): + return False + else: + try: + return typ(new) + except: + pass + print "Problem setting parameter (now %s) to %s; incorrect type?" % (current, new) + return current + +class Statekeeper(object): + def __init__(self, obj, attribs): + self.obj = obj + self.attribs = attribs + self.save() + def save(self): + for attrib in self.attribs: + setattr(self, attrib, getattr(self.obj, attrib)) + def restore(self): + for attrib in self.attribs: + setattr(self.obj, attrib, getattr(self, attrib)) + +if __name__ == '__main__': + doctest.testmod() diff -r 00898931969b -r 3de2a3eb765a cmd2/flagReader.py --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/cmd2/flagReader.py Mon Sep 29 12:48:29 2008 -0400 @@ -0,0 +1,90 @@ +"""Defines and parses UNIX-style flags to modify command arguments. + +Use of flagReader is DEPRECATED in favor of optparse from the +Python standard library. For backwards compatibility, flagReader +has been re-implemented as a wrapper around optparse. + +print flagReader.FlagSet.parse.__doc__ for usage examples. +""" + +import re, optparse, warnings +warnings.warn("""flagReader has been deprecated. Use optparse instead.""", DeprecationWarning) + +class Flag(object): + def __init__(self, name, abbrev=None, nargs=0): + """Flag(name, abbrev=None, nargs=0) : Defines a flag. + + name: the full name of the flag (double-dash form) + abbrev: the single-letter abbreviated form of the flag; defaults to + nargs: number of arguments expected after the flag""" + + self.name = name + self.abbrev = abbrev or name[0] + self.fullabbrev = '-%s' % (self.abbrev) + self.fullname = '--%s' % (name) + self.nargs = nargs + +class FlagSet(object): + def __init__(self, flags): + if not issubclass(type(flags), list): + raise TypeError, 'Argument must be a list' + self.flags = flags + self.lookup = {} + for flag in self.flags: + self.lookup[flag.abbrev] = flag + self.lookup[flag.fullabbrev] = flag + self.lookup[flag.fullname] = flag + self.abbrevPattern = re.compile('^-([%s]+)$' % (''.join(f.abbrev for f in flags))) + def parse(self, arg): + """ + Finds flags; returns {flag: (values, if any)} and the remaining argument. + + >>> f = FlagSet([Flag('foo'), Flag('bar'), Flag('gimmea', nargs=1)]) + >>> f.parse('-fb') + ({'foo': [], 'bar': []}, '') + >>> f.parse('no flags') + ({}, 'no flags') + >>> f.parse('-f blah') + ({'foo': []}, 'blah') + >>> f.parse('--bar') + ({'bar': []}, '') + >>> f.parse('--bar -f') + ({'foo': [], 'bar': []}, '') + >>> f.parse('--notaflag') + ({}, '--notaflag') + >>> f.parse('') + ({}, '') + >>> f.parse('--gimmea bee -f and then some other stuff') + ({'gimmea': ['bee'], 'foo': []}, 'and then some other stuff') + >>> f.parse('hidden -bar') + ({}, 'hidden -bar') + >>> f.parse('-g myarg -b') + ({'gimmea': ['myarg'], 'bar': []}, '') + """ + parser = optparse.OptionParser() + for flag in self.flags: + if flag.nargs: + parser.add_option(flag.fullabbrev, flag.fullname, action="store", + type="string", dest=flag.name) + else: + parser.add_option(flag.fullabbrev, flag.fullname, action="store_true", + dest=flag.name) + try: + (options, args) = parser.parse_args(arg.split()) + except SystemExit, e: + return {}, arg + + result = {} + for (k,v) in options.__dict__.items(): + if v == True: + result[k] = [] + elif v: + result[k] = [v] + return result, ' '.join(args) + +def _test(): + import doctest + doctest.testmod() + +if __name__ == '__main__': + _test() \ No newline at end of file diff -r 00898931969b -r 3de2a3eb765a flagReader.py --- a/flagReader.py Mon Sep 29 12:35:59 2008 -0400 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 @@ -1,90 +0,0 @@ -"""Defines and parses UNIX-style flags to modify command arguments. - -Use of flagReader is DEPRECATED in favor of optparse from the -Python standard library. For backwards compatibility, flagReader -has been re-implemented as a wrapper around optparse. - -print flagReader.FlagSet.parse.__doc__ for usage examples. -""" - -import re, optparse, warnings -warnings.warn("""flagReader has been deprecated. Use optparse instead.""", DeprecationWarning) - -class Flag(object): - def __init__(self, name, abbrev=None, nargs=0): - """Flag(name, abbrev=None, nargs=0) : Defines a flag. - - name: the full name of the flag (double-dash form) - abbrev: the single-letter abbreviated form of the flag; defaults to - nargs: number of arguments expected after the flag""" - - self.name = name - self.abbrev = abbrev or name[0] - self.fullabbrev = '-%s' % (self.abbrev) - self.fullname = '--%s' % (name) - self.nargs = nargs - -class FlagSet(object): - def __init__(self, flags): - if not issubclass(type(flags), list): - raise TypeError, 'Argument must be a list' - self.flags = flags - self.lookup = {} - for flag in self.flags: - self.lookup[flag.abbrev] = flag - self.lookup[flag.fullabbrev] = flag - self.lookup[flag.fullname] = flag - self.abbrevPattern = re.compile('^-([%s]+)$' % (''.join(f.abbrev for f in flags))) - def parse(self, arg): - """ - Finds flags; returns {flag: (values, if any)} and the remaining argument. - - >>> f = FlagSet([Flag('foo'), Flag('bar'), Flag('gimmea', nargs=1)]) - >>> f.parse('-fb') - ({'foo': [], 'bar': []}, '') - >>> f.parse('no flags') - ({}, 'no flags') - >>> f.parse('-f blah') - ({'foo': []}, 'blah') - >>> f.parse('--bar') - ({'bar': []}, '') - >>> f.parse('--bar -f') - ({'foo': [], 'bar': []}, '') - >>> f.parse('--notaflag') - ({}, '--notaflag') - >>> f.parse('') - ({}, '') - >>> f.parse('--gimmea bee -f and then some other stuff') - ({'gimmea': ['bee'], 'foo': []}, 'and then some other stuff') - >>> f.parse('hidden -bar') - ({}, 'hidden -bar') - >>> f.parse('-g myarg -b') - ({'gimmea': ['myarg'], 'bar': []}, '') - """ - parser = optparse.OptionParser() - for flag in self.flags: - if flag.nargs: - parser.add_option(flag.fullabbrev, flag.fullname, action="store", - type="string", dest=flag.name) - else: - parser.add_option(flag.fullabbrev, flag.fullname, action="store_true", - dest=flag.name) - try: - (options, args) = parser.parse_args(arg.split()) - except SystemExit, e: - return {}, arg - - result = {} - for (k,v) in options.__dict__.items(): - if v == True: - result[k] = [] - elif v: - result[k] = [v] - return result, ' '.join(args) - -def _test(): - import doctest - doctest.testmod() - -if __name__ == '__main__': - _test() \ No newline at end of file