Metadata-Version: 2.1
Name: sysaudit
Version: 0.3.0
Summary: Backport module for sys.audit and sys.addaudithook from Python 3.8
Home-page: https://sysaudit.readthedocs.io/
License: MIT
Author: brettlangdon
Author-email: me@brett.is
Requires-Python: >=2.7, !=3.0.*, !=3.1.*, !=3.2.*, !=3.3.*, !=3.4.*
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 2
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.5
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Project-URL: Repository, https://github.com/brettlangdon/sysaudit
Description-Content-Type: text/x-rst

sysaudit
========
.. image:: https://readthedocs.org/projects/sysaudit/badge/?version=latest
  :target: https://sysaudit.readthedocs.io/en/latest/?badge=latest
  :alt: Documentation Status

.. image:: https://github.com/brettlangdon/sysaudit/workflows/Build/badge.svg?branch=main&event=push
  :target: https://github.com/brettlangdon/sysaudit/actions?query=branch%3Amain+workflow%3ABuild+event%3Apush
  :alt: Build status

Backport module of `sys.audit <https://docs.python.org/3.8/library/sys.html#sys.audit>`_
and `sys.addaudithook <https://docs.python.org/3.8/library/sys.html#sys.addaudithook>`_
from Python 3.8.

**Note:** This module does *not* backport any of the built-in
`audit events <https://docs.python.org/3.8/library/audit_events.html#audit-events>`_.


Installation
------------

.. code-block:: bash

    pip install sysaudit

Quick Usage
-----------

`sysaudit` can be used as a drop-in replacement for `sys.audit` and `sys.addaudithook`.

.. code-block:: python

  import sysaudit

  def hook(event, args):
      print("Event:", event, args)

  sysaudit.addaudithook(hook)

  sysaudit.audit("event_name", 1, 2, dict(key="value"))
  # Event: event_name (1, 2, {'key': 'value'})

