uWSGI-pushbullet

uWSGI-pushbullet is a plugin to send notifications through the Pushbullet service.

Features

uWSGI-pushbullet provides the following features:

• Registers pushbullet alarm and pushbullet hook.
• Supports the whole Pushbullet API (send pushes to channels, devices, emails and so on).

Installation

This plugin requires:

• libcurl (to send HTTP requests with ease)
• jansson (for JSON parsing)

Please follow the specific documentation on how to install them.

This plugin is 2.0 friendly. You can thus build it with:

$ git clone https://github.com/aldur/uwsgi-pushbullet
$ uwsgi --build-plugin uwsgi-pushbullet

Configuration

To use this plugin you'll need your Pushbullet API access token.

You can configure the alarms in your app as follows:

[uwsgi]
plugins = pushbullet

; register a 'pushme' alarm
alarm = pushme pushbullet:token=<YOUR_API_TOKEN>,title=Alarm!
; raise alarms no more than 1 time per minute (default is 3 seconds)
alarm-freq = 60

; raise an alarm whenever uWSGI segfaults
alarm-segfault = pushme

; raise an alarm whenever /danger is hit
route = ^/danger alarm:pushme /danger has been visited!

; raise an alarm when the avergae response time is higher than 3000 milliseconds
metric-alarm = key=worker.0.avg_response_time,value=3000,alarm=pushme

; ...

The only mandatory key-value field needed to send an alarm is the token. In the previous example we've also set the push title.

Hooks, on the other side, require a body too:

[uwsgi]
plugins = pushbullet

hook-post-app = pushbullet:token=<YOUR_API_TOKEN>,body=Your app has been loaded.

; ...

Key-value fields

We support the entire Pushbullet HTTP API. Available key-values fields include:

• title
• body
• url
• device_iden
• email
• channel_tag
• client_iden
• source_device_iden

We automatically infer the push type by using the URL field.

On the uWSGI/networking side you can set:

• timeout: specifies the socket timeout.
• ssl_no_verify: tells Curl to not verify the server SSL certificate.