pushnotify 0.5.1

A package for sending push notifications to Android and iOS devices. GNU GPL v3.

pushnotify is a package for sending push notifications. It currently supports Android devices running Notify My Android and Pushover, and iOS devices running Pushover and Prowl.

See

• https://www.notifymyandroid.com/

• https://pushover.net/ and

• http://www.prowlapp.com/

for more details about these applications.

Development

All development for pushnotify takes place on bitbucket:

• https://bitbucket.org/jgoettsch/py-pushnotify/

You can follow this project on Twitter:

• https://twitter.com/pypushnotify

To get started you can do the following:

$ hg clone https://bitbucket.org/jgoettsch/py-pushnotify/
$ cd py-pushnotify
$ pip install -r requirements_dev.txt
$ python setup.py develop

If you discover a bug, please create an issue ticket:

• https://bitbucket.org/jgoettsch/py-pushnotify/issues/new

To run the test suite, you will have to create three modules:

• pushnotify/tests/nmakeys.py:

  This file must contain two global variables: API_KEYS and DEVELOPER_KEY. API_KEYS is a list containing at least one valid API key as a string. DEVELOPER_KEY is a string containing a valid developer key.

• pushnotify/tests/prowlkeys.py:

  This file must contain two global variables: API_KEYS and PROVIDER_KEY. API_KEYS is a list containing at least one valid API key as a string. PROVIDER_KEY is a string containing a valid provider key. REG_TOKEN is a valid registration token that has already been validated through the retrieve_token/retrieve_apikey process.

• pushnotify/tests/pushoverkeys.py:

  This file must contain two global variables: TOKEN and USER. TOKEN is a string containing a valid API token. USER is a dictionary whose keys are strings containing valid user identifiers. The key values are lists containing strings, where each string contains a valid device identifier for the given API token. There must be one API token, and it must have one device indentifier.

Installation

If you have already downloaded pushnotify, run the following command inside this directory:

$ python setup.py install

If you have not yet downloaded pushnotify, it would be easier to do the following:

$ pip install pushnotify

Either method will install pushnotify into your current environment.

Changelog

For a full history of changes see the commit history:

• https://bitbucket.org/jgoettsch/py-pushnotify/commits/all

version 0.5.1

• license-change: this and future versions are now licensed under the GNU GPL v3.

• now uses the Requests package instead of urllib2

version 0.5

• backwards-incompatible change: each client now conforms to a standard interface, and can be instantiated with the get_client factory method

version 0.4

• each client now logs HTTP GET and POST operations

version 0.3.1

• Prowl.Client.retrieve_token and Prowl.Client.retrieve_apikey now raise a pushnotify.exceptions.ProviderKeyError if the specified Provider Key is invalid

version 0.3

• added support for Prowl: http://www.prowlapp.com/

version 0.2.1

• fixed an issue where developer keys were not being sent with Notify My Android verifications

version 0.2

• added support for Pushover: https://pushover.net/

version 0.1

• added support for Notify My Android: https://www.notifymyandroid.com/