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.