CL-PUSHOVER - Common Lisp bindings to Pushover

An utility library for using Pushover notifications in Common Lisp.

The goal of this library is complete coverage of Pushover APIs. However, it is being developed as a part of another project that occupies most of my time, so features will be added as needed or as the time allows.

Status

Implemented

• Full API for sending Pushover notifications.

To be implemented

• Actual handling of errors reported by Pushover API.
• API for querying receipts.
• API for cancelling emergency-priority retries.
• API for user/group verification.
• API for subscriptions.
• API for groups.
• API for licensing.
• Toolkit for the Open Client API (possibly as an another library).

How to use

Include this library in your Quicklisp’s local projects. Load with standard

(ql:quickload :cl-pushover)

To send a Pushover notifications, you need to provide at least three pieces of information:

• your Pushover app token
• destination user/group token
• message body

The simplest request would be:

(cl-pushover:send-pushover :token "your app token" :destination-key "destination user/group token" :message "Body of the message.")

You can omit the :token parameter by setting it in a variable cl-pushover:*default-app-token*.

For more, refer to the docstring of cl-pushover:send-pushover function and the documentation of Pushover API.

Note, that if you want to skip type/sanity checks for some reason (e.g. efficiency), you can call cl-pushover::%send-pushover, which is an unsafe version of the cl-pushover:send-pushover function. Please refer to the code for details.

Examples of other Pushover APIs will be added as the support for those APIs is implemented.

Contributions

Issues and pull requests welcome :).

License

MIT. See LICENSE file.