Airship Python Library

Python library for using Airship’s messaging platform and related features.

Resources

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
airship = ua.Airship('<app key>', '<master secret>')

push = airship.create_push()
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.

Set up logging
import logging
logging.basicConfig()

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

Turn on verbose 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.

Turn on deprecation warnings
import warnings
warnings.simplefilter('default')