remove mglob external which is only used in quarantine code

added comment about removal to ipy_fsops.py
removed use from ipy_profile_sh.py
removed documentation on previously removed %mglob magic

IPython/deathrow/ipy_profile_sh.py

@@ -1,271 +1,268 b''
 """Shell mode for IPython.
 
 Start ipython in shell mode by invoking "ipython -p sh"
 
 (the old version, "ipython -p pysh" still works but this is the more "modern"
 shell mode and is recommended for users who don't care about pysh-mode
 compatibility)
 """
 
 from IPython.core import ipapi
 from IPython.core.error import TryNext
 import os,re,textwrap
 
 # The import below effectively obsoletes your old-style ipythonrc[.ini],
 # so consider yourself warned!
 
 import ipy_defaults
 
 def main():
     ip = ipapi.get()
     o = ip.options
     # autocall to "full" mode (smart mode is default, I like full mode)
 
     o.autocall = 2
 
     # Jason Orendorff's path class is handy to have in user namespace
     # if you are doing shell-like stuff
     try:
         ip.ex("from IPython.external.path import path" )
     except ImportError:
         pass
 
     # beefed up %env is handy in shell mode
     import envpersist
 
     # To see where mycmd resides (in path/aliases), do %which mycmd
     import ipy_which
 
     # tab completers for hg, svn, ...
     import ipy_app_completers
 
     # To make executables foo and bar in mybin usable without PATH change, do:
     # %rehashdir c:/mybin
     # %store foo
     # %store bar
     import ipy_rehashdir
 
     # does not work without subprocess module!
     #import ipy_signals
 
     ip.ex('import os')
     ip.ex("def up(): os.chdir('..')")
     ip.user_ns['LA'] = LastArgFinder()
 
     # You can assign to _prompt_title variable
     # to provide some extra information for prompt
     # (e.g. the current mode, host/username...)
 
     ip.user_ns['_prompt_title'] = ''
 
     # Nice prompt
     o.prompt_in1= r'\C_Green${_prompt_title}\C_LightBlue[\C_LightCyan\Y2\C_LightBlue]\C_Green|\#> '
     o.prompt_in2= r'\C_Green|\C_LightGreen\D\C_Green> '
     o.prompt_out= '<\#> '
 
     from IPython.core import release
 
     import sys
     # Non-chatty banner
     o.banner = "IPython %s   [on Py %s]\n" % (release.version,sys.version.split(None,1)[0])
 
 
     ip.default_option('cd','-q')
     ip.default_option('macro', '-r')
     # If you only rarely want to execute the things you %edit...
     #ip.default_option('edit','-x')
 
 
     o.prompts_pad_left="1"
     # Remove all blank lines in between prompts, like a normal shell.
     o.separate_in="0"
     o.separate_out="0"
     o.separate_out2="0"
 
     # now alias all syscommands
 
     db = ip.db
 
     syscmds = db.get("syscmdlist",[] )
     if not syscmds:
         print textwrap.dedent("""
         System command list not initialized, probably the first run...
         running %rehashx to refresh the command list. Run %rehashx
         again to refresh command list (after installing new software etc.)
         """)
         ip.magic('rehashx')
         syscmds = db.get("syscmdlist")
 
     # lowcase aliases on win32 only
     if os.name == 'posix':
         mapper = lambda s:s
     else:
         def mapper(s): return s.lower()
 
     for cmd in syscmds:
         # print "sys",cmd #dbg
         noext, ext = os.path.splitext(cmd)
         if ext.lower() == '.exe':
             cmd = noext
 
         key = mapper(cmd)
         if key not in ip.alias_manager.alias_table:
             # Dots will be removed from alias names, since ipython
             # assumes names with dots to be python code
 
             ip.define_alias(key.replace('.',''), cmd)
 
-    # mglob combines 'find', recursion, exclusion... '%mglob?' to learn more
-    ip.load("IPython.external.mglob")
-
     # win32 is crippled w/o cygwin, try to help it a little bit
     if sys.platform == 'win32':
         if 'cygwin' in os.environ['PATH'].lower():
             # use the colors of cygwin ls (recommended)
             ip.define_alias('d', 'ls -F --color=auto')
         else:
             # get icp, imv, imkdir, igrep, irm,...
             ip.load('ipy_fsops')
 
             # and the next best thing to real 'ls -F'
             ip.define_alias('d','dir /w /og /on')
 
     ip.set_hook('input_prefilter', slash_prefilter_f)
     extend_shell_behavior(ip)
 
 class LastArgFinder:
     """ Allow $LA to work as "last argument of previous command", like $! in bash
 
     To call this in normal IPython code, do LA()
     """
     def __call__(self, hist_idx = None):
         ip = ipapi.get()
         if hist_idx is None:
             return str(self)
         return ip.input_hist_raw[hist_idx].strip().split()[-1]
     def __str__(self):
         ip = ipapi.get()
         for cmd in reversed(ip.input_hist_raw):
             parts = cmd.strip().split()
             if len(parts) < 2 or parts[-1] in ['$LA', 'LA()']:
                 continue
             return parts[-1]
         return ""
 
 def slash_prefilter_f(self,line):
     """ ./foo, ~/foo and /bin/foo now run foo as system command
 
     Removes the need for doing !./foo, !~/foo or !/bin/foo
     """
     from IPython.utils import genutils
     if re.match('(?:[.~]|/[a-zA-Z_0-9]+)/', line):
         return "get_ipython().system(" + genutils.make_quoted_expr(line)+")"
     raise TryNext
 
 # XXX You do not need to understand the next function!
 # This should probably be moved out of profile
 
 def extend_shell_behavior(ip):
 
     # Instead of making signature a global variable tie it to IPSHELL.
     # In future if it is required to distinguish between different
     # shells we can assign a signature per shell basis
     ip.__sig__ = 0xa005
     # mark the IPSHELL with this signature
     ip.user_ns['__builtins__'].__dict__['__sig__'] = ip.__sig__
 
     from IPython.external.Itpl import ItplNS
     from IPython.utils.genutils import shell
     # utility to expand user variables via Itpl
     # xxx do something sensible with depth?
     ip.var_expand = lambda cmd, lvars=None, depth=2: \
         str(ItplNS(cmd, ip.user_ns, get_locals()))
 
     def get_locals():
         """ Substituting a variable through Itpl deep inside the IPSHELL stack
             requires the knowledge of all the variables in scope upto the last
             IPSHELL frame. This routine simply merges all the local variables
             on the IPSHELL stack without worrying about their scope rules
         """
         import sys
         # note lambda expression constitues a function call
         # hence fno should be incremented by one
         getsig = lambda fno: sys._getframe(fno+1).f_globals \
                              ['__builtins__'].__dict__['__sig__']
         getlvars = lambda fno: sys._getframe(fno+1).f_locals
         # trackback until we enter the IPSHELL
         frame_no = 1
         sig = ip.__sig__
         fsig = ~sig
         while fsig != sig :
             try:
                 fsig = getsig(frame_no)
             except (AttributeError, KeyError):
                 frame_no += 1
             except ValueError:
                 # stack is depleted
                 # call did not originate from IPSHELL
                 return {}
         first_frame = frame_no
         # walk further back until we exit from IPSHELL or deplete stack
         try:
             while(sig == getsig(frame_no+1)):
                 frame_no += 1
         except (AttributeError, KeyError, ValueError):
             pass
         # merge the locals from top down hence overriding
         # any re-definitions of variables, functions etc.
         lvars = {}
         for fno in range(frame_no, first_frame-1, -1):
             lvars.update(getlvars(fno))
         #print '\n'*5, first_frame, frame_no, '\n', lvars, '\n'*5 #dbg
         return lvars
 
     def _runlines(lines):
         """Run a string of one or more lines of source.
 
         This method is capable of running a string containing multiple source
         lines, as if they had been entered at the IPython prompt.  Since it
         exposes IPython's processing machinery, the given strings can contain
         magic calls (%magic), special shell access (!cmd), etc."""
 
         # We must start with a clean buffer, in case this is run from an
         # interactive IPython session (via a magic, for example).
         ip.resetbuffer()
         lines = lines.split('\n')
         more = 0
         command = ''
         for line in lines:
             # skip blank lines so we don't mess up the prompt counter, but do
             # NOT skip even a blank line if we are in a code block (more is
             # true)
             # if command is not empty trim the line
             if command != '' :
                 line = line.strip()
             # add the broken line to the command
             if line and line[-1] == '\\' :
                 command += line[0:-1] + ' '
                 more = True
                 continue
             else :
                 # add the last (current) line to the command
                 command += line
                 if command or more:
                     # push to raw history, so hist line numbers stay in sync
                     ip.input_hist_raw.append("# " + command + "\n")
 
                     more = ip.push_line(ip.prefilter(command,more))
                     command = ''
                     # IPython's runsource returns None if there was an error
                     # compiling the code.  This allows us to stop processing right
                     # away, so the user gets the error message at the right place.
                     if more is None:
                         break
         # final newline in case the input didn't have it, so that the code
         # actually does get executed
         if more:
             ip.push_line('\n')
 
     ip.runlines = _runlines
 
 main()

IPython/quarantine/ipy_fsops.py

@@ -1,246 +1,254 b''
 """ File system operations
 
 Contains: Simple variants of normal unix shell commands (icp, imv, irm,
 imkdir, igrep).
 
 Some "otherwise handy" utils ('collect' for gathering files to
 ~/_ipython/collect, 'inote' for collecting single note lines to
 ~/_ipython/note.txt)
 
 Mostly of use for bare windows installations where cygwin/equivalent is not
 installed and you would otherwise need to deal with dos versions of the
 commands (that e.g. don't understand / as path separator). These can
 do some useful tricks on their own, though (like use 'mglob' patterns).
 
 Not to be confused with ipipe commands (ils etc.) that also start with i.
+
+QUARANTINE, NEEDS UPDATING TO THE NEW IPYTHON API TO WORK
+
+this depends on mglob that used to be in externals,
+if this code is updated to run again with current IPython, you may need to
+reintroduce that file back. In doing so, look for the possibility of achieving
+the same effect only with the standard library (which may have improved by now,
+since we currently depend on Python 2.6).
 """
 
 from IPython.core import ipapi
 from IPython.core.error import TryNext
 ip = ipapi.get()
 
 import shutil,os,shlex
 from IPython.external import mglob
 from IPython.external.path import path
 from IPython.core.error import UsageError
 import IPython.utils.generics
 
 def parse_args(args):
     """ Given arg string 'CMD files... target', return ([files], target) """
 
     tup = args.split(None, 1)
     if len(tup) == 1:
         raise UsageError("Expected arguments for " + tup[0])
 
     tup2 = shlex.split(tup[1])
 
     flist, trg = mglob.expand(tup2[0:-1]), tup2[-1]
     if not flist:
         raise UsageError("No files found:" + str(tup2[0:-1]))
     return flist, trg
 
 def icp(ip,arg):
     """ icp files... targetdir
 
     Copy all files to target, creating dirs for target if necessary
 
     icp srcdir dstdir
 
     Copy srcdir to distdir
 
     """
     import distutils.dir_util
 
     fs, targetdir = parse_args(arg)
     if not os.path.isdir(targetdir) and len(fs) > 1:
         distutils.dir_util.mkpath(targetdir,verbose =1)
     for f in fs:
         if os.path.isdir(f):
             shutil.copytree(f, targetdir)
         else:
             shutil.copy2(f,targetdir)
     return fs
 ip.define_alias("icp",icp)
 
 def imv(ip,arg):
     """ imv src tgt
 
     Move source to target.
     """
 
     fs, target = parse_args(arg)
     if len(fs) > 1:
         assert os.path.isdir(target)
     for f in fs:
         shutil.move(f, target)
     return fs
 ip.define_alias("imv",imv)
 
 def irm(ip,arg):
     """ irm path[s]...
 
     Remove file[s] or dir[s] path. Dirs are deleted recursively.
     """
     try:
         paths = mglob.expand(arg.split(None,1)[1])
     except IndexError:
         raise UsageError("%irm paths...")
     import distutils.dir_util
     for p in paths:
         print "rm",p
         if os.path.isdir(p):
             distutils.dir_util.remove_tree(p, verbose = 1)
         else:
             os.remove(p)
 
 ip.define_alias("irm",irm)
 
 def imkdir(ip,arg):
     """ imkdir path
 
     Creates dir path, and all dirs on the road
     """
     import distutils.dir_util
     targetdir = arg.split(None,1)[1]
     distutils.dir_util.mkpath(targetdir,verbose =1)
 
 ip.define_alias("imkdir",imkdir)
 
 def igrep(ip,arg):
     """ igrep PAT files...
 
     Very dumb file scan, case-insensitive.
 
     e.g.
 
     igrep "test this" rec:*.py
 
     """
     elems = shlex.split(arg)
     dummy, pat, fs = elems[0], elems[1], mglob.expand(elems[2:])
     res = []
     for f in fs:
         found = False
         for l in open(f):
             if pat.lower() in l.lower():
                 if not found:
                     print "[[",f,"]]"
                     found = True
                     res.append(f)
                 print l.rstrip()
     return res
 
 ip.define_alias("igrep",igrep)
 
 def collect(ip,arg):
     """ collect foo/a.txt rec:bar=*.py
 
     Copies foo/a.txt to ~/_ipython/collect/foo/a.txt and *.py from bar,
     likewise
 
     Without args, try to open ~/_ipython/collect dir (in win32 at least).
     """
     from IPython.external.path import path
     basedir = path(ip.ipython_dir + '/collect')
     try:
         fs = mglob.expand(arg.split(None,1)[1])
     except IndexError:
         os.startfile(basedir)
         return
     for f in fs:
         f = path(f)
         trg = basedir / f.splitdrive()[1].lstrip('/\\')
         if f.isdir():
             print "mkdir",trg
             trg.makedirs()
             continue
         dname = trg.dirname()
         if not dname.isdir():
             dname.makedirs()
         print f,"=>",trg
         shutil.copy2(f,trg)
 
 ip.define_alias("collect",collect)
 
 def inote(ip,arg):
     """ inote Hello world
 
     Adds timestamp and Hello world to ~/_ipython/notes.txt
 
     Without args, opens notes.txt for editing.
     """
     import time
     fname = ip.ipython_dir + '/notes.txt'
 
     try:
         entry = " === " + time.asctime() + ': ===\n' + arg.split(None,1)[1] + '\n'
         f= open(fname, 'a').write(entry)
     except IndexError:
         ip.hooks.editor(fname)
 
 ip.define_alias("inote",inote)
 
 def pathobj_mangle(p):
     return p.replace(' ', '__').replace('.','DOT')
 def pathobj_unmangle(s):
     return s.replace('__',' ').replace('DOT','.')
 
 
 
 class PathObj(path):
     def __init__(self,p):
         self.path = p
         if p != '.':
             self.ents = [pathobj_mangle(ent) for ent in os.listdir(p)]
         else:
             self.ents = None
     def __complete__(self):
         if self.path != '.':
             return self.ents
         self.ents = [pathobj_mangle(ent) for ent in os.listdir('.')]
         return self.ents
     def __getattr__(self,name):
         if name in self.ents:
             if self.path.endswith('/'):
                 sep = ''
             else:
                 sep = '/'
 
             tgt = self.path + sep + pathobj_unmangle(name)
             #print "tgt",tgt
             if os.path.isdir(tgt):
                 return PathObj(tgt)
             if os.path.isfile(tgt):
                 return path(tgt)
 
         raise AttributeError, name  # <<< DON'T FORGET THIS LINE !!
     def __str__(self):
         return self.path
 
     def __repr__(self):
         return "<PathObj to %s>" % self.path
 
     def __call__(self):
         print "cd:",self.path
         os.chdir(self.path)
 
 def complete_pathobj(obj, prev_completions):
     if hasattr(obj,'__complete__'):
         res = obj.__complete__()
         if res:
             return res
     # just return normal attributes of 'path' object if the dir is empty
     raise TryNext
 
 complete_pathobj = IPython.utils.generics.complete_object.when_type(PathObj)(complete_pathobj)
 
 def test_pathobj():
     #p = PathObj('c:/prj')
     #p2 = p.cgi
     #print p,p2
     rootdir = PathObj("/")
     startmenu = PathObj("d:/Documents and Settings/All Users/Start Menu/Programs")
     cwd = PathObj('.')
     ip.push("rootdir startmenu cwd")
 
 #test_pathobj()

docs/source/interactive/shell.txt

@@ -1,294 +1,283 b''
 .. _ipython_as_shell:
 
 =========================
 IPython as a system shell
 =========================
 
 .. warning::
 
     As of the 0.11 version of IPython, most of the APIs used by the shell
     profile have been changed, so the profile currently does very little
     beyond changing the IPython prompt.  To help restore the shell
     profile to past functionality described here, the old code is found in 
     :file:`IPython/deathrow`, which needs to be updated to use the
     APIs in 0.11.
 
 Overview
 ========
 
 The 'sh' profile optimizes IPython for system shell usage. Apart from
 certain job control functionality that is present in unix (ctrl+z does
 "suspend"), the sh profile should provide you with most of the
 functionality you use daily in system shell, and more. Invoke IPython
 in 'sh' profile by doing 'ipython -p sh', or (in win32) by launching
 the "pysh" shortcut in start menu.
 
 If you want to use the features of sh profile as your defaults (which
 might be a good idea if you use other profiles a lot of the time but
 still want the convenience of sh profile), add ``import ipy_profile_sh``
 to your $IPYTHONDIR/ipy_user_conf.py.
 
 The 'sh' profile is different from the default profile in that:
 
  * Prompt shows the current directory
  * Spacing between prompts and input is more compact (no padding with
    empty lines). The startup banner is more compact as well.
  * System commands are directly available (in alias table) without
    requesting %rehashx - however, if you install new programs along
    your PATH, you might want to run %rehashx to update the persistent
    alias table
  * Macros are stored in raw format by default. That is, instead of
    '_ip.system("cat foo"), the macro will contain text 'cat foo')
  * Autocall is in full mode
  * Calling "up" does "cd .."
 
 The 'sh' profile is different from the now-obsolete (and unavailable)
 'pysh' profile in that the ``$$var = command`` and ``$var = command`` syntax is
 not supported anymore. Use ``var = !command`` instead (which is available in all
 IPython profiles).
 
 Aliases
 =======
 
 All of your $PATH has been loaded as IPython aliases, so you should be
 able to type any normal system command and have it executed. See
 %alias?  and %unalias? for details on the alias facilities. See also
 %rehashx? for details on the mechanism used to load $PATH.
 
 
 Directory management
 ====================
 
 Since each command passed by ipython to the underlying system is executed
 in a subshell which exits immediately, you can NOT use !cd to navigate
 the filesystem.
 
 IPython provides its own builtin '%cd' magic command to move in the
 filesystem (the % is not required with automagic on). It also maintains
 a list of visited directories (use %dhist to see it) and allows direct
 switching to any of them. Type 'cd?' for more details.
 
 %pushd, %popd and %dirs are provided for directory stack handling.
 
 
 Enabled extensions
 ==================
 
 Some extensions, listed below, are enabled as default in this profile.
 
 envpersist
 ----------
 
 %env can be used to "remember" environment variable manipulations. Examples::
 
 	%env - Show all environment variables
 	%env VISUAL=jed  - set VISUAL to jed
 	%env PATH+=;/foo - append ;foo to PATH
 	%env PATH+=;/bar - also append ;bar to PATH
 	%env PATH-=/wbin; - prepend /wbin; to PATH
 	%env -d VISUAL   - forget VISUAL persistent val
 	%env -p          - print all persistent env modifications
 
 ipy_which
 ---------
 
 %which magic command. Like 'which' in unix, but knows about ipython aliases.
 
 Example::
 
  [C:/ipython]|14> %which st
  st -> start .
  [C:/ipython]|15> %which d
  d -> dir /w /og /on
  [C:/ipython]|16> %which cp
  cp -> cp
    == c:\bin\cp.exe
  c:\bin\cp.exe
 
 ipy_app_completers
 ------------------
 
 Custom tab completers for some apps like svn, hg, bzr, apt-get. Try 'apt-get install <TAB>' in debian/ubuntu.
 
 ipy_rehashdir
 -------------
 
 Allows you to add system command aliases for commands that are not along your path. Let's say that you just installed Putty and want to be able to invoke it without adding it to path, you can create the alias for it with rehashdir::
 
  [~]|22> cd c:/opt/PuTTY/
  [c:opt/PuTTY]|23> rehashdir .
               <23> ['pageant', 'plink', 'pscp', 'psftp', 'putty', 'puttygen', 'unins000']
 
 Now, you can execute any of those commams directly::
 
  [c:opt/PuTTY]|24> cd
  [~]|25> putty
 
 (the putty window opens).
 
 If you want to store the alias so that it will always be available, do '%store putty'. If you want to %store all these aliases persistently, just do it in a for loop::
 
  [~]|27> for a in _23:
     |..>     %store $a
     |..>
     |..>
  Alias stored: pageant (0, 'c:\\opt\\PuTTY\\pageant.exe')
  Alias stored: plink (0, 'c:\\opt\\PuTTY\\plink.exe')
  Alias stored: pscp (0, 'c:\\opt\\PuTTY\\pscp.exe')
  Alias stored: psftp (0, 'c:\\opt\\PuTTY\\psftp.exe')
  ...
 
-mglob
------
-
-Provide the magic function %mglob, which makes it easier (than the 'find' command) to collect (possibly recursive) file lists. Examples::
-
- [c:/ipython]|9> mglob *.py
- [c:/ipython]|10> mglob *.py rec:*.txt
- [c:/ipython]|19> workfiles = %mglob !.svn/ !.hg/ !*_Data/ !*.bak rec:.
-
-Note that the first 2 calls will put the file list in result history (_, _9, _10), and the last one will assign it to 'workfiles'.
-
 
 Prompt customization
 ====================
 
 The sh profile uses the following prompt configurations::
 
     c.PromptManager.in_template = r'{color.LightGreen}\u@\h{color.LightBlue}[{color.LightCyan}\Y1{color.LightBlue}]{color.Green}|\#> '
     c.PromptManager.in2_template = r'{color.Green}|{color.LightGreen}\D{color.Green}> '
     c.PromptManager.out_template = r'<\#> '
 
 You can change the prompt configuration to your liking by editing
 ipython_config.py.
 
 .. _string_lists:
 
 String lists
 ============
 
 String lists (IPython.utils.text.SList) are handy way to process output
 from system commands. They are produced by ``var = !cmd`` syntax.
 
 First, we acquire the output of 'ls -l'::
 
     [Q:doc/examples]|2> lines = !ls -l
      ==
     ['total 23',
      '-rw-rw-rw- 1 ville None 1163 Sep 30  2006 example-demo.py',
      '-rw-rw-rw- 1 ville None 1927 Sep 30  2006 example-embed-short.py',
      '-rwxrwxrwx 1 ville None 4606 Sep  1 17:15 example-embed.py',
      '-rwxrwxrwx 1 ville None 1017 Sep 30  2006 example-gnuplot.py',
      '-rwxrwxrwx 1 ville None  339 Jun 11 18:01 extension.py',
      '-rwxrwxrwx 1 ville None  113 Dec 20  2006 seteditor.py',
      '-rwxrwxrwx 1 ville None  245 Dec 12  2006 seteditor.pyc']
 
 Now, let's take a look at the contents of 'lines' (the first number is
 the list element number)::
 
     [Q:doc/examples]|3> lines
                     <3> SList (.p, .n, .l, .s, .grep(), .fields() available). Value:
 
     0: total 23
     1: -rw-rw-rw- 1 ville None 1163 Sep 30  2006 example-demo.py
     2: -rw-rw-rw- 1 ville None 1927 Sep 30  2006 example-embed-short.py
     3: -rwxrwxrwx 1 ville None 4606 Sep  1 17:15 example-embed.py
     4: -rwxrwxrwx 1 ville None 1017 Sep 30  2006 example-gnuplot.py
     5: -rwxrwxrwx 1 ville None  339 Jun 11 18:01 extension.py
     6: -rwxrwxrwx 1 ville None  113 Dec 20  2006 seteditor.py
     7: -rwxrwxrwx 1 ville None  245 Dec 12  2006 seteditor.pyc
 
 Now, let's filter out the 'embed' lines::
 
     [Q:doc/examples]|4> l2 = lines.grep('embed',prune=1)
     [Q:doc/examples]|5> l2
                     <5> SList (.p, .n, .l, .s, .grep(), .fields() available). Value:
 
     0: total 23
     1: -rw-rw-rw- 1 ville None 1163 Sep 30  2006 example-demo.py
     2: -rwxrwxrwx 1 ville None 1017 Sep 30  2006 example-gnuplot.py
     3: -rwxrwxrwx 1 ville None  339 Jun 11 18:01 extension.py
     4: -rwxrwxrwx 1 ville None  113 Dec 20  2006 seteditor.py
     5: -rwxrwxrwx 1 ville None  245 Dec 12  2006 seteditor.pyc
 
 Now, we want strings having just file names and permissions::
 
     [Q:doc/examples]|6> l2.fields(8,0)
                     <6> SList (.p, .n, .l, .s, .grep(), .fields() available). Value:
 
     0: total
     1: example-demo.py -rw-rw-rw-
     2: example-gnuplot.py -rwxrwxrwx
     3: extension.py -rwxrwxrwx
     4: seteditor.py -rwxrwxrwx
     5: seteditor.pyc -rwxrwxrwx
 
 Note how the line with 'total' does not raise IndexError.
 
 If you want to split these (yielding lists), call fields() without
 arguments::
 
     [Q:doc/examples]|7> _.fields()
                     <7>
     [['total'],
      ['example-demo.py', '-rw-rw-rw-'],
      ['example-gnuplot.py', '-rwxrwxrwx'],
      ['extension.py', '-rwxrwxrwx'],
      ['seteditor.py', '-rwxrwxrwx'],
      ['seteditor.pyc', '-rwxrwxrwx']]
 
 If you want to pass these separated with spaces to a command (typical
 for lists if files), use the .s property::
 
 
     [Q:doc/examples]|13> files = l2.fields(8).s
     [Q:doc/examples]|14> files
                     <14> 'example-demo.py example-gnuplot.py extension.py seteditor.py seteditor.pyc'
     [Q:doc/examples]|15> ls $files
     example-demo.py  example-gnuplot.py  extension.py  seteditor.py  seteditor.pyc
 
 SLists are inherited from normal python lists, so every list method is
 available::
 
     [Q:doc/examples]|21> lines.append('hey')
 
 
 Real world example: remove all files outside version control
 ------------------------------------------------------------
 
 First, capture output of "hg status"::
 
     [Q:/ipython]|28> out = !hg status
      ==
     ['M IPython\\extensions\\ipy_kitcfg.py',
      'M IPython\\extensions\\ipy_rehashdir.py',
     ...
      '? build\\lib\\IPython\\Debugger.py',
      '? build\\lib\\IPython\\extensions\\InterpreterExec.py',
      '? build\\lib\\IPython\\extensions\\InterpreterPasteInput.py',
     ...
 
 (lines starting with ? are not under version control).
 
 ::
 
     [Q:/ipython]|35> junk = out.grep(r'^\?').fields(1)
     [Q:/ipython]|36> junk
                 <36> SList (.p, .n, .l, .s, .grep(), .fields() availab
     ...
     10: build\bdist.win32\winexe\temp\_ctypes.py
     11: build\bdist.win32\winexe\temp\_hashlib.py
     12: build\bdist.win32\winexe\temp\_socket.py
 
 Now we can just remove these files by doing 'rm $junk.s'. 
 
 The .s, .n, .p properties
 -------------------------
 
 The ``.s`` property returns one string where lines are separated by
 single space (for convenient passing to system commands). The ``.n``
 property return one string where the lines are separated by a newline
 (i.e. the original output of the function). If the items in string
 list are file names, ``.p`` can be used to get a list of "path" objects
 for convenient file manipulation.