dgilland / Pushjack
Programming Languages
pushjack
|version| |travis| |coveralls| |license|
Push notifications for APNS (iOS) and GCM (Android).
Links
- Project: https://github.com/dgilland/pushjack
- Documentation: https://pushjack.readthedocs.io
- PyPi: https://pypi.python.org/pypi/pushjack/
- TravisCI: https://travis-ci.org/dgilland/pushjack
Quickstart
Install using pip:
::
pip install pushjack
Whether using APNS
or GCM
, pushjack provides clients for each.
APNS
Send notifications using the APNSClient
class:
.. code-block:: python
from pushjack import APNSClient
client = APNSClient(certificate='<path/to/certificate.pem>',
default_error_timeout=10,
default_expiration_offset=2592000,
default_batch_size=100,
default_retries=5)
token = '<device token>'
alert = 'Hello world.'
# Send to single device.
# NOTE: Keyword arguments are optional.
res = client.send(token,
alert,
badge='badge count',
sound='sound to play',
category='category',
content_available=True,
title='Title',
title_loc_key='t_loc_key',
title_loc_args='t_loc_args',
action_loc_key='a_loc_key',
loc_key='loc_key',
launch_image='path/to/image.jpg',
extra={'custom': 'data'})
# Send to multiple devices by passing a list of tokens.
client.send([token], alert, **options)
Access response data.
.. code-block:: python
# List of all tokens sent.
res.tokens
# List of errors as APNSServerError objects
res.errors
# Dict mapping errors as token => APNSServerError object.
res.token_errors
Override defaults for error_timeout, expiration_offset, and batch_size.
.. code-block:: python
client.send(token,
alert,
expiration=int(time.time() + 604800),
error_timeout=5,
batch_size=200)
Send a low priority message.
.. code-block:: python
# The default is low_priority == False
client.send(token, alert, low_priority=True)
Get expired tokens.
.. code-block:: python
expired_tokens = client.get_expired_tokens()
Close APNS connection.
.. code-block:: python
client.close()
For the APNS sandbox, use APNSSandboxClient
instead:
.. code-block:: python
from pushjack import APNSSandboxClient
GCM
Send notifications using the GCMClient
class:
.. code-block:: python
from pushjack import GCMClient
client = GCMClient(api_key='<api-key>')
registration_id = '<registration id>'
alert = 'Hello world.'
notification = {'title': 'Title', 'body': 'Body', 'icon': 'icon'}
# Send to single device.
# NOTE: Keyword arguments are optional.
res = client.send(registration_id,
alert,
notification=notification,
collapse_key='collapse_key',
delay_while_idle=True,
time_to_live=604800)
# Send to multiple devices by passing a list of ids.
client.send([registration_id], alert, **options)
Alert can also be be a dictionary with data fields.
.. code-block:: python
alert = {'message': 'Hello world', 'custom_field': 'Custom Data'}
Alert can also contain the notification payload.
.. code-block:: python
alert = {'message': 'Hello world', 'notification': notification}
Send a low priority message.
.. code-block:: python
# The default is low_priority == False
client.send(registration_id, alert, low_priority=True)
Access response data.
.. code-block:: python
# List of requests.Response objects from GCM Server.
res.responses
# List of messages sent.
res.messages
# List of registration ids sent.
res.registration_ids
# List of server response data from GCM.
res.data
# List of successful registration ids.
res.successes
# List of failed registration ids.
res.failures
# List of exceptions.
res.errors
# List of canonical ids (registration ids that have changed).
res.canonical_ids
For more details, please see the full documentation at https://pushjack.readthedocs.io.
.. |version| image:: http://img.shields.io/pypi/v/pushjack.svg?style=flat-square :target: https://pypi.python.org/pypi/pushjack/
.. |travis| image:: http://img.shields.io/travis/dgilland/pushjack/master.svg?style=flat-square :target: https://travis-ci.org/dgilland/pushjack
.. |coveralls| image:: http://img.shields.io/coveralls/dgilland/pushjack/master.svg?style=flat-square :target: https://coveralls.io/r/dgilland/pushjack
.. |license| image:: http://img.shields.io/pypi/l/pushjack.svg?style=flat-square :target: https://pypi.python.org/pypi/pushjack/