Metadata-Version: 1.0
Name: python-gcm
Version: 0.4
Summary: Python client for Google Cloud Messaging for Android (GCM)
Home-page: http://blog.namis.me/python-gcm/
Author: Nam Ngo
Author-email: nam@kogan.com.au
License: The MIT License (MIT)
Description: python-gcm
        ======================
        
        .. image:: https://badges.gitter.im/Join%20Chat.svg
           :alt: Join the chat at https://gitter.im/geeknam/python-gcm
           :target: https://gitter.im/geeknam/python-gcm?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge
        .. image:: https://img.shields.io/pypi/v/python-gcm.svg
           :target: https://pypi.python.org/pypi/python-gcm
        .. image:: https://img.shields.io/pypi/dm/python-gcm.svg
           :target: https://pypi.python.org/pypi/python-gcm
        .. image:: https://secure.travis-ci.org/geeknam/python-gcm.png?branch=master
           :alt: Build Status
           :target: http://travis-ci.org/geeknam/python-gcm
        .. image:: https://landscape.io/github/geeknam/python-gcm/master/landscape.png
           :target: https://landscape.io/github/geeknam/python-gcm/master
           :alt: Code Health
        .. image:: https://coveralls.io/repos/geeknam/python-gcm/badge.svg?branch=master
           :target: https://coveralls.io/r/geeknam/python-gcm
        .. image:: https://img.shields.io/gratipay/geeknam.svg
           :target: https://gratipay.com/geeknam/
        
        Python client for Google Cloud Messaging for Android (GCM)
        
        Installation
        -------------
        
        .. code-block:: bash
        
           pip install python-gcm
        
        Features
        ------------
        
        * Supports multicast message
        * Resend messages using exponential back-off
        * Proxy support
        * Easily handle errors
        * Uses `requests` from version > 0.2
        * `Topic Messaging  <https://developers.google.com/cloud-messaging/topic-messaging>`__
        * TCP connection pooling and Keep-Alive when passing an explict requests.Session object to the used GCM request call
        
        Usage
        ------------
        
        Read about `Google Cloud Messaging <https://developers.google.com/cloud-messaging>`__
        
        .. code-block:: python
        
           from gcm import GCM
        
           gcm = GCM(API_KEY)
           data = {'param1': 'value1', 'param2': 'value2'}
        
           # Downstream message using JSON request
           reg_ids = ['token1', 'token2', 'token3']
           response = gcm.json_request(registration_ids=reg_ids, data=data)
        
           # Downstream message using JSON request with extra arguments
           res = gcm.json_request(
               registration_ids=reg_ids, data=data,
               collapse_key='uptoyou', delay_while_idle=True, time_to_live=3600
           )
        
           # Topic Messaging
           topic = 'topic name'
           gcm.send_topic_message(topic=topic, data=data)
        
        See `examples <examples>`_  directory for more usage details, including error handling.
        
        Contributing
        ==========
        See `CONTRIBUTING.md <CONTRIBUTING.md>`_
        
        Licensing
        =======
        See `LICENSE <LICENSE>`_
        
Keywords: android gcm push notification google cloud messaging
Platform: UNKNOWN
