Skip to main content
Help us improve PyPI by participating in user testing. All experience levels needed!

No project description provided

Project description

Description

exgurd provides a decorator to guard a function or method against exceptions. This is useful in situations where untrusted code is executed, e.g. when executing a third-party module in a framework.

In comparison to the suppress context manager from Python 3, exguard provides more means to control exception handling:

  • filter on modules and namespaces to define which exceptions to catch and leave exceptions in other code untouched
  • execute a callback function once an exception was caught
  • execute a callback function in the finally block

For example, an API method in a web application that calls through to code in third-party modules can be guarded against exceptions in this modules only, while having exceptions in the framework itself be raised verbatim:

from exguard import guard, traceback_str

def throw_to_client(exception, module):
    tb = traceback_str(exception)

    # Do something to pass a traceback to the browser, disable the plugin,…
    pass

# All third-party modules are under one namespace
@guard(modules=["myframework.plugins"], submodules=True, fullstack=True, cb_except=throw_to_client)
def call_plugin_api():
    # An exception inside this will be caught
    myframework.plugins.evil.crash()

    # This will still raise an exception like normal
    x = 17 / 0

Authors

exguard has been started as a part of Veripeditus, mainly by Eike Tim Jesinghaus <eike@naturalnet.de>.

Changelog

0.2.1

  • Guard against <string> or other non-module frames.

0.2

  • Add utility function to get full traceback as string.
  • Re-licence under MIT.
  • Minor documentation updates.

0.1

  • First release.

Project details


Release history Release notifications

This version
History Node

0.2.1

History Node

0.2

History Node

0.1

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Filename, size & hash SHA256 hash help File type Python version Upload date
exguard-0.2.1-py3-none-any.whl (7.0 kB) Copy SHA256 hash SHA256 Wheel 3.5 Aug 31, 2017
exguard-0.2.1.tar.gz (4.1 kB) Copy SHA256 hash SHA256 Source None Aug 31, 2017

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging CloudAMQP CloudAMQP RabbitMQ AWS AWS Cloud computing Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page