No description, website, or topics provided.
Switch branches/tags
Nothing to show
Clone or download
Pull request Compare This branch is 12 commits ahead, 789 commits behind urbanairship:master.
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.gitignore
.hgignore
AUTHORS
LICENSE
MANIFEST.in
README.rst
keys-example.ini
setup.py
tests.py
urbanairship.py

README.rst

About

This here is a library for using the Urban Airship web service API for iPhone and Android C2DM push notifications.

Requirements

Tested on Python 2.5 and 2.6 -- it'll probably work on earlier versions. If you're using Python 2.5 or earlier, you'll need to install simplejson.

Functionality

As of 0.42 the library handles these parts of the API:

  • device token registration
  • APID token registration
  • basic push
  • registering and pushing with tags
  • broadcast
  • feedback service
  • device token deactivation (deregistration)
  • device token listing

iOS Usage

>>> import urbanairship
>>> airship = urbanairship.Airship(application_key, master_secret)
>>> airship.register('valid_token', alias='adam')
>>> airship.push({'aps': {'alert': 'Hello'}}, aliases=['adam'],
...     device_tokens=['some_other_token'])

Android C2DM Usage

>>> import urbanairship
>>> airship = urbanairship.Airship(application_key, master_secret)
>>> airship.registerAPID('valid_token', alias='matt')
>>> airship.push({'android': {'alert': 'Hello'}}, aliases=['matt'],
...     device_tokens=['some_other_token'])

Unit Tests Usage

  • copy keys-example.ini to keys.ini
  • edit keys.ini with your test master secret and application secret keys
  • run tests.py

Questions

The best place to ask questions is our developers mailing list: http://groups.google.com/group/urbanairship-dev

History

  • 0.1 Initial release
  • 0.2 Added tags, broadcast, feedback
  • 0.3 Added deregister, device token list, other minor improvements
  • 0.4 Added Android C2DM APID support
  • 0.42 Merged schedule_for fork into this branch (from hkukreja)