76 lines
2.7 KiB
EmacsLisp
76 lines
2.7 KiB
EmacsLisp
|
;;; pushover.el --- Send generic messages to mobile device -*- lexical-binding: t -*-
|
||
|
|
;; Author: William Carroll <wpcarro@gmail.com>
|
||
|
|
|
||
|
|
;;; Commentary:
|
||
|
|
;; Pushover.net is a mobile app that accepts JSON. This supports loose
|
||
|
|
;; integration between things and mobile devices.
|
||
|
|
|
||
|
|
;;; Code:
|
||
|
|
|
||
|
|
;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
|
||
|
|
;; Dependencies
|
||
|
|
;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
|
||
|
|
|
||
|
|
(require 'request)
|
||
|
|
(require 'password-store)
|
||
|
|
|
||
|
|
;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
|
||
|
|
;; Library
|
||
|
|
;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
|
||
|
|
|
||
|
|
(defconst pushover/app-token
|
||
|
|
(password-store-get-field "api-keys/pushover.net" "emacs")
|
||
|
|
"App token for \"emacs\" application.")
|
||
|
|
|
||
|
|
(defconst pushover/user-key
|
||
|
|
(password-store-get "api-keys/pushover.net")
|
||
|
|
"Key that identifies me to pushover.")
|
||
|
|
|
||
|
|
(defconst pushover/url
|
||
|
|
"https://api.pushover.net/1/messages.json"
|
||
|
|
"URL to POST messages.")
|
||
|
|
|
||
|
|
;; TODO: Rename module "pushover".
|
||
|
|
|
||
|
|
(defun pushover/notify (message)
|
||
|
|
"Posts MESSAGE to all devices.
|
||
|
|
Here are the parameters that Pushover accepts:
|
||
|
|
|
||
|
|
Required parameters:
|
||
|
|
- token - your application's API token
|
||
|
|
- user - the user/group key (not e-mail address) of your user (or you),
|
||
|
|
viewable when logged into our dashboard (often referred to as USER_KEY in
|
||
|
|
our documentation and code examples)
|
||
|
|
- message - your message
|
||
|
|
|
||
|
|
Additional parameters (optional):
|
||
|
|
- attachment - an image attachment to send with the message; see attachments
|
||
|
|
for more information on how to upload files
|
||
|
|
device - your user's device name to send the message directly to that
|
||
|
|
device, rather than all of the user's devices (multiple devices may be
|
||
|
|
separated by a comma)
|
||
|
|
- title - your message's title, otherwise your app's name is used
|
||
|
|
- url - a supplementary URL to show with your message
|
||
|
|
- url_title - a title for your supplementary URL, otherwise just the URL is
|
||
|
|
shown
|
||
|
|
- priority - send as -2 to generate no notification/alert, -1 to always send
|
||
|
|
as a quiet notification, 1 to display as high-priority and bypass the user's
|
||
|
|
quiet hours, or 2 to also require confirmation from the user
|
||
|
|
- sound - the name of one of the sounds supported by device clients to
|
||
|
|
override the user's default sound choice
|
||
|
|
- timestamp - a Unix timestamp"
|
||
|
|
(request
|
||
|
|
pushover/url
|
||
|
|
:type "POST"
|
||
|
|
:params `(("token" . ,pushover/app-token)
|
||
|
|
("user" . ,pushover/user-key)
|
||
|
|
("message" . ,message))
|
||
|
|
:data nil
|
||
|
|
:parser 'json-read
|
||
|
|
:success (cl-function
|
||
|
|
(lambda (&key data &allow-other-keys)
|
||
|
|
(message "Pushover.net notification sent!")))))
|
||
|
|
|
||
|
|
(provide 'pushover)
|
||
|
|
;;; pushover.el ends here
|