Skip to main content
Help us improve Python packaging – donate today!

Unofficial Pushed.co API wrapper

Project Description

https://travis-ci.org/digmore/pypushed.svg?branch=master https://coveralls.io/repos/github/digmore/pypushed/badge.svg?branch=master

Overview

Python wrapper for the pushed.co API. https://pushed.co

Send push notifications to mobile devices without writing your own mobile app. Have notifications pushed to you rather than relying on polling RSS feeds and the like.

Usage

Currently only the push functionality and some of the OAuth2 is implemented here.

Basic usage:

import pushed

APP_KEY = 'MY_PUSHED_APP_KEY'
APP_SECRET = 'MY_PUSHED_APP_SECRET'
CHANNEL_ALIAS = 'MY_CHANNEL_ALIAS'
PUSHED_ID = 'PUSHED_ID_FOR_SUBSCRIBER'

p = pushed.Pushed(APP_KEY, APP_SECRET)

# Push message to your application's subscribers
shipment = p.push_app('test app push')

# Push message to your channel's subscribers
shipment = p.push_channel('test channel push', CHANNEL_ALIAS)

# Push message to a user by Pushed ID
shipment = p.push_pushed_id('test Pushed ID push', PUSHED_ID)

# Push URL enriched message to your application's subscribers
shipment =  p.push_app('test app push', content_url='http://example.com')

Pushing to a user requires an OAuth2 access token. You must swap a temporary code for this access token using the Pushed API. These temporary codes arrive by webhook, when a subscriber follows your authorization link and agrees to the access.

To generate an authorization link to share with your users:

p = pushed.Pushed(APP_KEY, APP_SECRET)
uri = p.authorization_link('https://example.org/my-webhook-handler')

Using a code to get an access token, then sending a message to the user:

p = pushed.Pushed(APP_KEY, APP_SECRET)
access_token = p.access_token(temporary_code)
shipment = p.push_user('test user push', access_token)

All four push methods return an alphanumeric Shipment ID which you can check against your Pushed.co control panel. If the Pushed API returns a JSON failure message then a PushedAPIError will be raised using its type and message fields.

The content_url parameter is optional and is supported by all push types. It allows you to enrich your messages with a hyperlink if desired.

Installation

Using pip

pip install pushed

Release history Release notifications

This version
History Node

0.1.4

History Node

0.1.2

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Filename, size & hash SHA256 hash help File type Python version Upload date
pushed-0.1.4-py2.py3-none-any.whl (5.7 kB) Copy SHA256 hash SHA256 Wheel py2.py3 Mar 15, 2016
pushed-0.1.4.tar.gz (3.7 kB) Copy SHA256 hash SHA256 Source None Mar 15, 2016

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging CloudAMQP CloudAMQP RabbitMQ AWS AWS Cloud computing Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page