Metadata-Version: 2.1
Name: listen
Version: 0.2.1
Summary: Simple but powerful signal handling to process OS signals in python
Home-page: https://github.com/antevens/listen
Author: Antonia Stevens
Author-email: a@antevens.com
License: LICENSE
Keywords: signal,unix,kill,abort,quit,info
Platform: UNKNOWN
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 2
Classifier: Programming Language :: Python :: 3
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Other Environment
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Information Technology
Classifier: Intended Audience :: System Administrators
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Description-Content-Type: text/markdown

listen
======

Simple but powerful signal handling to process OS signals in python

##Example Usage:

    import listen
    import subprocess

### Instanciate SignalHandler
    sig_hand = listen.SignalHandler()

### Start external process
    external_process = subprocess.Popen(['sh', '-c', 'sleep 30'])

### Register some signal handlers to kill external process on SIGINT (ctrl-c)
    kill_event = sig_hand.reg_on_status(external_process.kill)

### Wait for external process
    external_process.wait()

### Press ctrl-c to send SIGINT or alternatively use the following to unregister the event
    sig_hand.del_status_event(kill_event)

For a more detailed example including interaction with bash please see
the tests/example.py and tests/external_process.bash


