Metadata-Version: 1.1
Name: shell
Version: 1.0.0
Summary: A better way to run shell commands in Python.
Home-page: http://github.com/toastdriven/shell
Author: Daniel Lindsley
Author-email: daniel@toastdriven.com
License: BSD
Description: =====
        shell
        =====
        
        """A better way to run shell commands in Python."""
        
        Built because every time I go to use `subprocess`_, I spend more time in the
        docs & futzing around than actually implementing what I'm trying to get done.
        
        Dare I say: "shell commands for humans"? *gasp*
        
        
        Requirements
        ============
        
        * Python 2.6+ or Python 3.3+
        
        
        Usage
        =====
        
        If you just need to quickly run a command, you can use the ``shell`` shortcut
        function::
        
            >>> from shell import shell
            >>> ls = shell('ls')
            >>> for file in ls.output():
            ...     print file
            'another.txt'
        
        If you need to extend the behavior, you can also use the ``Shell`` object::
        
            >>> from shell import Shell
            >>> sh = Shell(has_input=True)
            >>> cat = sh.run('cat -u')
            >>> cat.write('Hello, world!')
            >>> cat.output()
            ['Hello, world!']
        
        You can even chain calls if you'd like::
        
            >>> from shell import shell
            >>> shell('cat -u', has_input=True).write('Hello, world!').output()
            ['Hello, world!']
        
        
        Installation
        ============
        
        Using ``pip``, simply run::
        
            pip install shell
        
        
        License
        =======
        
        New BSD
        
Platform: UNKNOWN
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: BSD License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Classifier: Topic :: System :: Shells
Classifier: Programming Language :: Python :: 2
Classifier: Programming Language :: Python :: 3
