semvec/pypi-packages huggingface dataset:
gcm-clerk 0.1.6
Python client for Google Cloud Messaging (GCM)
License: Apache 2.0
Keywords: gcm push notification google cloud messaging android

gcm-client
==========
Python client for `Google Cloud Messaging (GCM) <http://developer.android.com/google/gcm/index.html>`_.
Check `documentation <http://gcm-client.readthedocs.org>`_ to learn how to use it.

Check the client with similar interface for `Apple Push Notification service <https://pypi.python.org/pypi/apns-clerk/>`_.
This package is based on gcm-client, which was created by `Sardar Yumatov <mailto:ja.doma@gmail.com>`_.


Requirements
------------

- `requests <http://docs.python-requests.org>`_ - HTTP request, handles proxies etc.
- `omnijson <https://pypi.python.org/pypi/omnijson/>`_ if you use Python 2.5 or older.

Alternatives
------------
Th only alternative library known at the time of writing was `python-gcm
<https://pypi.python.org/pypi/python-gcm>`_.  This library differs in the
following design decisions:

- *Predictable execution time*. Do not automatically retry request on failure.
  According to Google's recommendations, each retry has to wait exponential
  back-off delay. We use Celery back-end, where the best way to retry after
  some delay will be scheduling the task with ``countdown=delay``.  Sleeping
  while in Celery worker hurts your concurrency.
- *Do not forget results if you need to retry*. This sounds obvious, but
  ``python-gcm`` drops important results, such as canonical ID mapping if
  request needs to be (partially) retried.
- *Clean pythonic API*. No need to borrow all Java like exceptions etc.
- *Do not hard-code validation, let GCM fail*. This decision makes library
  a little bit more future proof.

Support
-------
Please report any bugs or requests through `Bitbucket <https://bitbucket.org/aleksihoffman/gcm-clerk>`_


Todo
----
* Own documentation for gcm-clerk
* Attributions for previous work etc.