Flask integration

This extension adds support for the Flask web framework.

Installation

pip install hawk-python-sdk[flask]

import Catcher module to your project.

from hawk_python_sdk.modules.flask import HawkFlask

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

Now all global flask errors would be sent to Hawk.

Try-except

If you want to catch errors in try-except blocks see this

Manual sending

You can send any error to Hawk. See this

Event context

See this

Affected user

See this

Addons

When some event handled by Flask Catcher, it adds some addons to the event data for Hawk.

name	type	description
`url`	str	Request URL
`method`	str	Request method
`headers`	dict	Request headers
`cookies`	dict	Request cookies
`params`	dict	Request params
`form`	dict	Request form
`json`	dict	Request json data

Init params

To init Hawk Catcher just pass a project token.

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

Additional params

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

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

Parameters:

name	type	required	description
`token`	str	required	Your project's Integration Token
`release`	str	optional	Release name for Suspected Commits feature
`collector_endpoint`	string	optional	Collector endpoint for sending event to
`context`	dict	optional	Additional context to be send with every event
`before_send`	Callable[[dict], None]	optional	This Method allows you to filter any data you don't want sending to Hawk
`set_user`	Callable[[Request], User]	optional	This Method allows you to set user for every request by flask request object
`with_addons`	bool	optional	Add framework addons to event data

Requirements

See this

And for flask you need:

Flask
blinker