Metadata-Version: 1.1
Name: delegator.py
Version: 0.0.8
Summary: Subprocesses for Humans 2.0.
Home-page: https://github.com/kennethreitz/delegator
Author: Kenneth Reitz
Author-email: me@kennethreitz.com
License: MIT
Description: 
        Delegator.py — Subprocesses for Humans 2.0
        =======================================
        
        
        .. image:: https://img.shields.io/pypi/v/delegator.py.svg
            :target: https://pypi.python.org/pypi/delegator.py
        
        .. image:: https://img.shields.io/pypi/l/delegator.py.svg
            :target: https://pypi.python.org/pypi/delegator.py
        
        .. image:: https://img.shields.io/pypi/wheel/delegator.py.svg
            :target: https://pypi.python.org/pypi/delegator.py
        
        .. image:: https://img.shields.io/pypi/pyversions/delegator.py.svg
            :target: https://pypi.python.org/pypi/delegator.py
        
        .. image:: https://img.shields.io/badge/SayThanks.io-☼-1EAEDB.svg
            :target: https://saythanks.io/to/kennethreitz
        
        
        **Delegator.py** is a simple library for dealing with subprocesses, inspired
        by both `envoy <https://github.com/kennethreitz/envoy>`_ and `pexpect <http://pexpect.readthedocs.io>`_ (in fact, it depends on it!).
        
        This module features two main functions ``delegator.run()`` and ``delegator.chain()``. One runs commands, blocking or non-blocking, and the other runs a chain of commands, seperated by the standard unix pipe operator: ``|``.
        
        Basic Usage
        -----------
        
        Basic run functionality:
        
        .. code:: pycon
        
            >>> c = delegator.run('ls')
            >>> print c.out
            README.rst   delegator.py
        
            >>> c = delegator.run('long-running-process', block=False)
            >>> c.pid
            35199
            >>> c.block()
            >>> c.return_code
            0
        
        Commands can be passed in as lists as well (e.g. ``['ls', '-lrt']``), for parameterization.
        
        Basic chain functionality:
        
        .. code:: pycon
        
           # Can also be called with ([['fortune'], ['cowsay']]).
           # or, delegator.run('fortune').pipe('cowsay')
        
           >>> c = delegator.chain('fortune | cowsay')
           >>> print c.out
             _______________________________________
            / Our swords shall play the orators for \
            | us.                                   |
            |                                       |
            \ -- Christopher Marlowe                /
             ---------------------------------------
                    \   ^__^
                     \  (oo)\_______
                        (__)\       )\/\
                            ||----w |
                            ||     ||
        
        
        Expect functionality is built-in too, on non-blocking commands:
        
        .. code:: pycon
        
            >>> c.expect('Password:')
            >>> c.send('PASSWORD')
            >>> c.block()
        
        Other functions:
        
        .. code:: pycon
        
            >>> c.kill()
            >>> c.send('SIGTERM', signal=True)
        
            # Only available when block=True, otherwise, use c.out.
            >>> c.err
            ''
        
            # Direct access to pipes.
            >>> c.std_err
            <open file '<fdopen>', mode 'rU' at 0x10a5351e0>
        
        
        
        Installation
        ------------
        
        ::
        
            $ pip install delegator.py
        
        ✨🍰✨
        
Platform: UNKNOWN
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 2.6
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.3
Classifier: Programming Language :: Python :: 3.4
Classifier: Programming Language :: Python :: 3.5
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: Implementation :: CPython
Classifier: Programming Language :: Python :: Implementation :: PyPy
