Airship Python Library

Resources

• GitHub Repo 
• Python Package Index (PyPI) 
• Airship API Reference
• Python Library API Reference

Installation

Using pip:

pip install urbanairship

Using the library

The library is intended to be used with the small footprint of a single import.

To get started, import the package, and create an Airship object representing a single Airship application:

import urbanairship as ua
client = ua.BasicAuthClient('<app key>', '<master secret>')

push = ua.Push(client)
push.audience = ua.ios_channel('074e84a2-9ed9-4eee-9ca4-cc597bfdbef3')
push.notification = ua.notification(ios=ua.ios(alert='Hello from Python', badge=1))
push.device_types = ua.device_types('ios')
push.send()

The library uses Requests  for communication with the Airship API, providing connection pooling and strict SSL checking. The Airship object is threadsafe and can be instantiated once and reused in multiple threads.

Logging

urbanairship uses the standard logging module for integration into an application’s existing logging. If you do not have logging configured otherwise, set it up in your application.

import logging
logging.basicConfig()

If you’re having trouble with the Airship API, you can turn on verbose debug logging.

logging.getLogger('urbanairship').setLevel(logging.DEBUG)

As of Python 2.7, DeprecationWarning warnings are silenced by default. To enable them, use the warnings module.

import warnings
warnings.simplefilter('default')