Hawk Python Catcher

Python errors Catcher module for Hawk.so.

Usage

Install module

Install hawkcatcher from PyPI.

$ pip install hawkcatcher

Import Catcher module to your project.

from hawkcatcher import Hawk

Then enable Hawk Catcher with your token and domain.

hawk = Hawk(
    "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJwcm9qZWN0SWQiOiI1ZTZmNWM3NzAzOWI0MDAwMjNmZDViODAiLCJpYXQiOjE1ODQzNTY0NzF9.t-5Gelx3MgHVBrxTsoMyPQAdQ6ufVbPsts9zZLW3gM8")

Now all global errors would be sent to Hawk.

Try-except

If you want to catch errors in try-except blocks then use hawk.catch() in except:

try:
    ...
except:
    hawk.send()

Manual sending

You can also pass event to the hawk.send() call, for example:

try:
    ...
except:
    hawk.send(ValueError("error description"))

Event context

It is possible to pass additional event context for debugging purposes:

try:
    ...
except:
    hawk.send(ValueError("error description"), {"params": "value"})

Affected user

You can also pass user, who affected with specific error:

try:
    ...
except:
    hawk.send(ValueError("error description"), {"params": "value"}, {"id": 123})

Init params

To init Hawk Catcher just pass a project token.

hawk = Hawk('1234567-abcd-8901-efgh-123456789012')

Additional params

If you need to use custom Hawk server then pass a dictionary with params.

hawk = Hawk({
    'token': '1234567-abcd-8901-efgh-123456789012',
    'collector_endpoint': 'https://<id>.k1.hawk.so',
})

Requirements

Python >= 3.5
requests

Links

Repository: https://github.com/codex-team/hawk.python

Report a bug: https://github.com/codex-team/hawk.python/issues

PyPI Package: https://pypi.python.org/pypi/hawkcatcher

CodeX Team: https://ifmo.su

Release files for hawkcatcher 3.4.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for hawkcatcher 3.4.1
File	Size	Uploaded
hawkcatcher-3.4.1.tar.gz	7.6 kB	Mar 17, 2023	Details

Built distribution (wheel)

Table of built distributions (wheels) for hawkcatcher 3.4.1
File	Interpreter	ABI	Platform	Reset
hawkcatcher-3.4.1-py3-none-any.whl 9.1 kB Mar 17, 2023	Python 3	none	any	Details

Total release size: 16.7 kB

Release files / hawkcatcher-3.4.1.tar.gz

Download URL	hawkcatcher-3.4.1.tar.gz
Size	7.6 kB
Tags	Source
SHA-256 checksum How to use checksums	`afa083cf860145acba7ab4ff1ad899ae7b934bd954d28fb01b6f786dc56a8acc`
BLAKE2b-256 checksum How to use checksums	`3a63955b3a27ba8cc2e3e49225a5a6549a581e78eea395e7228a68d9f47c8d72`
Upload date	Mar 17, 2023
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/4.0.2 CPython/3.9.6`

Release files / hawkcatcher-3.4.1-py3-none-any.whl

Download URL	hawkcatcher-3.4.1-py3-none-any.whl
Size	9.1 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`bf99dd877c17518dfd63de5e4a14ea0c77188e3dcf256f985b770b74db1744c3`
BLAKE2b-256 checksum How to use checksums	`924946bcd9cf59607d8c9b8cd10323fbfd4d8501a9bd44ba7756169c95e823a2`
Upload date	Mar 17, 2023
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/4.0.2 CPython/3.9.6`