##// END OF EJS Templates
Merge pull request #686 from minrk/qtssh...
Merge pull request #686 from minrk/qtssh add ssh tunnel support to qtconsole, making it much easier for users to tunnel a connection to a Qt console without having to forward all ports manually.

File last commit:

r4574:a8c54759
r4600:ba8f0672 merge
Show More
alias.py
263 lines | 9.3 KiB | text/x-python | PythonLexer
Brian Granger
More work on componentizing everything....
r2243 # encoding: utf-8
"""
Brian Granger
First draft of refactored Component->Configurable.
r2731 System command aliases.
Brian Granger
More work on componentizing everything....
r2243
Authors:
Brian Granger
First draft of refactored Component->Configurable.
r2731 * Fernando Perez
Brian Granger
More work on componentizing everything....
r2243 * Brian Granger
"""
#-----------------------------------------------------------------------------
Fernando Perez
Aliases fixes: ls alias improvements and frontend-dependent fixes....
r3003 # Copyright (C) 2008-2010 The IPython Development Team
Brian Granger
More work on componentizing everything....
r2243 #
Fernando Perez
Aliases fixes: ls alias improvements and frontend-dependent fixes....
r3003 # Distributed under the terms of the BSD License.
#
# The full license is in the file COPYING.txt, distributed with this software.
Brian Granger
More work on componentizing everything....
r2243 #-----------------------------------------------------------------------------
#-----------------------------------------------------------------------------
# Imports
#-----------------------------------------------------------------------------
import __builtin__
import keyword
import os
Brian Granger
More work on refactoring things into components....
r2244 import re
Brian Granger
More work on componentizing everything....
r2243 import sys
Brian Granger
First draft of refactored Component->Configurable.
r2731 from IPython.config.configurable import Configurable
Brian Granger
More work on refactoring things into components....
r2244 from IPython.core.splitinput import split_user_input
Brian Granger
More work on componentizing everything....
r2243
Brian Granger
First draft of refactored Component->Configurable.
r2731 from IPython.utils.traitlets import List, Instance
Brian Granger
More work on refactoring things into components....
r2244 from IPython.utils.autoattr import auto_attr
Brian Granger
Work to address the review comments on Fernando's branch....
r2498 from IPython.utils.warn import warn, error
Brian Granger
More work on componentizing everything....
r2243
#-----------------------------------------------------------------------------
Brian Granger
More work on refactoring things into components....
r2244 # Utilities
Brian Granger
More work on componentizing everything....
r2243 #-----------------------------------------------------------------------------
Brian Granger
More work on refactoring things into components....
r2244 # This is used as the pattern for calls to split_user_input.
shell_line_split = re.compile(r'^(\s*)(\S*\s*)(.*$)')
Brian Granger
More work on componentizing everything....
r2243 def default_aliases():
Fernando Perez
Aliases fixes: ls alias improvements and frontend-dependent fixes....
r3003 """Return list of shell aliases to auto-define.
"""
# Note: the aliases defined here should be safe to use on a kernel
# regardless of what frontend it is attached to. Frontends that use a
# kernel in-process can define additional aliases that will only work in
# their case. For example, things like 'less' or 'clear' that manipulate
# the terminal should NOT be declared here, as they will only work if the
# kernel is running inside a true terminal, and not over the network.
Brian Granger
More work on componentizing everything....
r2243 if os.name == 'posix':
Fernando Perez
Aliases fixes: ls alias improvements and frontend-dependent fixes....
r3003 default_aliases = [('mkdir', 'mkdir'), ('rmdir', 'rmdir'),
('mv', 'mv -i'), ('rm', 'rm -i'), ('cp', 'cp -i'),
('cat', 'cat'),
]
# Useful set of ls aliases. The GNU and BSD options are a little
# different, so we make aliases that provide as similar as possible
# behavior in ipython, by passing the right flags for each platform
if sys.platform.startswith('linux'):
ls_aliases = [('ls', 'ls -F --color'),
# long ls
('ll', 'ls -F -o --color'),
# ls normal files only
('lf', 'ls -F -o --color %l | grep ^-'),
# ls symbolic links
('lk', 'ls -F -o --color %l | grep ^l'),
# directories or links to directories,
('ldir', 'ls -F -o --color %l | grep /$'),
# things which are executable
('lx', 'ls -F -o --color %l | grep ^-..x'),
]
else:
# BSD, OSX, etc.
ls_aliases = [('ls', 'ls -F'),
# long ls
('ll', 'ls -F -l'),
# ls normal files only
('lf', 'ls -F -l %l | grep ^-'),
# ls symbolic links
('lk', 'ls -F -l %l | grep ^l'),
# directories or links to directories,
('ldir', 'ls -F -l %l | grep /$'),
# things which are executable
('lx', 'ls -F -l %l | grep ^-..x'),
]
default_aliases = default_aliases + ls_aliases
elif os.name in ['nt', 'dos']:
default_aliases = [('ls', 'dir /on'),
('ddir', 'dir /ad /on'), ('ldir', 'dir /ad /on'),
('mkdir', 'mkdir'), ('rmdir', 'rmdir'),
('echo', 'echo'), ('ren', 'ren'), ('copy', 'copy'),
]
Brian Granger
More work on componentizing everything....
r2243 else:
Fernando Perez
Aliases fixes: ls alias improvements and frontend-dependent fixes....
r3003 default_aliases = []
return default_aliases
Brian Granger
More work on componentizing everything....
r2243
class AliasError(Exception):
pass
class InvalidAliasError(AliasError):
pass
Brian Granger
More work on refactoring things into components....
r2244 #-----------------------------------------------------------------------------
# Main AliasManager class
#-----------------------------------------------------------------------------
Brian Granger
First draft of refactored Component->Configurable.
r2731 class AliasManager(Configurable):
Brian Granger
More work on componentizing everything....
r2243
Brian Granger
Massive refactoring of of the core....
r2245 default_aliases = List(default_aliases(), config=True)
user_aliases = List(default_value=[], config=True)
Brian Granger
Moving and renaming in preparation of subclassing InteractiveShell....
r2760 shell = Instance('IPython.core.interactiveshell.InteractiveShellABC')
Brian Granger
More work on componentizing everything....
r2243
Brian Granger
Adding support for HasTraits to take keyword arguments.
r2740 def __init__(self, shell=None, config=None):
super(AliasManager, self).__init__(shell=shell, config=config)
Brian Granger
More work on componentizing everything....
r2243 self.alias_table = {}
self.exclude_aliases()
self.init_aliases()
Brian Granger
More work on refactoring things into components....
r2244
Brian Granger
More work on componentizing everything....
r2243 def __contains__(self, name):
Fernando Perez
Aliases fixes: ls alias improvements and frontend-dependent fixes....
r3003 return name in self.alias_table
Brian Granger
More work on componentizing everything....
r2243
@property
def aliases(self):
return [(item[0], item[1][1]) for item in self.alias_table.iteritems()]
def exclude_aliases(self):
# set of things NOT to alias (keywords, builtins and some magics)
no_alias = set(['cd','popd','pushd','dhist','alias','unalias'])
no_alias.update(set(keyword.kwlist))
no_alias.update(set(__builtin__.__dict__.keys()))
self.no_alias = no_alias
def init_aliases(self):
# Load default aliases
Brian Granger
Massive refactoring of of the core....
r2245 for name, cmd in self.default_aliases:
Brian Granger
More work on componentizing everything....
r2243 self.soft_define_alias(name, cmd)
# Load user aliases
Brian Granger
Massive refactoring of of the core....
r2245 for name, cmd in self.user_aliases:
Brian Granger
More work on componentizing everything....
r2243 self.soft_define_alias(name, cmd)
Brian Granger
Massive refactoring of of the core....
r2245 def clear_aliases(self):
self.alias_table.clear()
Brian Granger
More work on componentizing everything....
r2243 def soft_define_alias(self, name, cmd):
"""Define an alias, but don't raise on an AliasError."""
try:
self.define_alias(name, cmd)
except AliasError, e:
error("Invalid alias: %s" % e)
def define_alias(self, name, cmd):
"""Define a new alias after validating it.
This will raise an :exc:`AliasError` if there are validation
problems.
"""
nargs = self.validate_alias(name, cmd)
self.alias_table[name] = (nargs, cmd)
Brian Granger
Massive refactoring of of the core....
r2245 def undefine_alias(self, name):
if self.alias_table.has_key(name):
del self.alias_table[name]
Brian Granger
More work on componentizing everything....
r2243 def validate_alias(self, name, cmd):
"""Validate an alias and return the its number of arguments."""
if name in self.no_alias:
raise InvalidAliasError("The name %s can't be aliased "
"because it is a keyword or builtin." % name)
if not (isinstance(cmd, basestring)):
raise InvalidAliasError("An alias command must be a string, "
"got: %r" % name)
nargs = cmd.count('%s')
if nargs>0 and cmd.find('%l')>=0:
raise InvalidAliasError('The %s and %l specifiers are mutually '
'exclusive in alias definitions.')
return nargs
def call_alias(self, alias, rest=''):
"""Call an alias given its name and the rest of the line."""
cmd = self.transform_alias(alias, rest)
try:
self.shell.system(cmd)
except:
self.shell.showtraceback()
def transform_alias(self, alias,rest=''):
"""Transform alias to system command string."""
nargs, cmd = self.alias_table[alias]
if ' ' in cmd and os.path.isfile(cmd):
cmd = '"%s"' % cmd
# Expand the %l special to be the user's input line
if cmd.find('%l') >= 0:
cmd = cmd.replace('%l', rest)
rest = ''
if nargs==0:
# Simple, argument-less aliases
cmd = '%s %s' % (cmd, rest)
else:
# Handle aliases with positional arguments
args = rest.split(None, nargs)
if len(args) < nargs:
raise AliasError('Alias <%s> requires %s arguments, %s given.' %
(alias, nargs, len(args)))
cmd = '%s %s' % (cmd % tuple(args[:nargs]),' '.join(args[nargs:]))
return cmd
Brian Granger
More work on refactoring things into components....
r2244
def expand_alias(self, line):
""" Expand an alias in the command line
Returns the provided command line, possibly with the first word
(command) translated according to alias expansion rules.
[ipython]|16> _ip.expand_aliases("np myfile.txt")
<16> 'q:/opt/np/notepad++.exe myfile.txt'
"""
pre,fn,rest = split_user_input(line)
res = pre + self.expand_aliases(fn, rest)
return res
def expand_aliases(self, fn, rest):
"""Expand multiple levels of aliases:
if:
alias foo bar /tmp
alias baz foo
then:
baz huhhahhei -> bar /tmp huhhahhei
"""
line = fn + " " + rest
done = set()
while 1:
pre,fn,rest = split_user_input(line, shell_line_split)
if fn in self.alias_table:
if fn in done:
warn("Cyclic alias definition, repeated '%s'" % fn)
return ""
done.add(fn)
l2 = self.transform_alias(fn, rest)
if l2 == line:
break
# ls -> ls -F should not recurse forever
if l2.split(None,1)[0] == line.split(None,1)[0]:
line = l2
break
line=l2
else:
break
return line