https://github.com/eugene-eeo/signalsdb

query unix signals
https://github.com/eugene-eeo/signalsdb

Last synced: about 2 months ago
JSON representation

query unix signals

• Host: GitHub
• URL: https://github.com/eugene-eeo/signalsdb
• Owner: eugene-eeo
• License: mit
• Created: 2015-04-19T15:36:53.000Z (over 9 years ago)
• Default Branch: master
• Last Pushed: 2016-09-14T01:39:55.000Z (about 8 years ago)
• Last Synced: 2024-07-27T11:42:31.992Z (about 2 months ago)
• Language: Python
• Size: 113 KB
• Stars: 6
• Watchers: 2
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.rst
  • License: LICENSE

Awesome Lists containing this project

README

        
|logo| SignalsDB

================

SignalsDB is an MIT-licensed library written in Python providing

a simple way to query a curated database of Unix signals.

Usage:

------

To explain a Unix signal based on the integer id::

    >>> from signalsdb.api import explain

    >>> explain(13)

    {'action': 'kill',

     'description': 'write on a pipe with no reader',

     'id': 13,

     'signal': 'SIGPIPE'}

Then to query the signals DB based on the signal name or action

in a case insensitive way using regexes::

    >>> from signalsdb.api import search

    >>> search(signal='sigp\w', action='kill')

    [{'action': 'kill',

      'description': 'write on a pipe with no reader',

      'id': 13,

      'signal': 'SIGPIPE'},

     {'action': 'kill',

      'description': 'profiling timer alarm',

      'id': 27,

      'signal': 'SIGPROF'}]

Installation:

-------------

From PyPI::

    $ pip install signalsdb

For hacking on SignalsDB it is recommended that you install

from the git repository::

    $ git clone [email protected]:eugene-eeo/signalsdb.git

    $ cd signalsdb

    $ pip install .

.. |logo| image:: https://raw.githubusercontent.com/eugene-eeo/signalsdb/master/media/logo-small.png