An Asynchronous Apple Push Notification (apns2) Client for Rust
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.travis
examples
src
.gitignore
.travis.yml
CHANGELOG.md
Cargo.toml
LICENSE
README.md
a2_travis.enc
rustfmt.toml

README.md

a2

Travis Build Status MIT licensed crates.io

HTTP/2 Apple Push Notification Service for Rust using Tokio and async sending.

Documentation

Features

  • Fast asynchronous sending, based on h2 and hyper crates.
  • Payload serialization/deserialization with serde.
  • Provides a type-safe way of constructing different types of payloads. Custom data through Serialize, allowing use of structs or dynamic hashmaps.
  • Supports .p12 certificate databases to connect using a custom certificate.
  • Supports .p8 private keys to connect using authentication tokens.
  • If using authentication tokens, handles signature renewing for Apple's guidelines and caching for maximum performance.

Usage

Add this to Cargo.toml:

[dependencies]
a2 = "0.3"
tokio = "0.1"
futures = "0.1"

then add to your crate root:

extern crate a2;
extern crate tokio;
extern crate futures;

Examples

The library supports connecting to Apple Push Notification service either using a certificate with a password or a private key with a team id and key id. Both are available from your Apple account and with both it is possible to send push notifications to one application.

To see it used in a real project, take a look to the XORC Notifications, which is a full-fledged consumer for sending push notifications.

Gotchas

We've been pushing some millions of notifications daily through this library and are quite happy with it. Some things to know, if you're evaluating the library for production use:

  • Do not open new connections for every request. Apple will treat it as Denial of Service attack and block the sending IP address. When using the same Client for multiple requests, the Client keeps the connection alive if pushing steady traffic through it.

  • For one app, one connection is quite enough already for certain kind of loads. With http2 protocol, the events are asynchronous and the pipeline can hold several outgoing requests at the same time. The biggest reason to open several connections is for redundancy, running your sender service on different machines.

  • It seems to be Apple doesn't like when sending tons of notifications with faulty device tokens and it might lead to ConnectionErrors. Do not send more notifications with tokens that return Unregistered, BadDeviceToken or DeviceTokenNotForTopic.

Tests

cargo test

Contact

oh_lawd @ IRC (Freenode, Mozilla)