cloud-pubsub

Provides methods to consume messages from Google PubSub using Futures and Hyper.

Authentication

Authentication is provided by rust-goauth. The BaseClient expects to receipt the path to the file containing your Google Cloud service account JSON key.

Token Renewal

The JWT token has a short life time and needs to be renewed periodically for long lived processes.

There is a provided helper which will renew the token every 15 mins:

``` let pubsub = match BaseClient::create(config.googleapplicationcredentials) { Err(e) => panic!("Failed to initialize pubsub: {}", e), Ok(p) => p, };

tokio::run(lazy(move || { pubsub.spawntokenrenew(); })) ```

Env Config

Envy is an excellent way to load your config.

```

[derive(Deserialize)]

struct Config { pubsubsubscription: String, googleapplication_credentials: String, }

fn main() { let parsedenv = envy::fromenv::(); if let Err(e) = parsedenv { eprintln!("ENV is not valid: {}", e); std::process::exit(1); } let config = parsedenv.unwrap();

let pubsub = match BaseClient::create(config.google_application_credentials) {
    Err(e) => panic!("Failed to initialize pubsub: {}", e),
    Ok(p) => p,
};

} ```

Subscribing

The full canonical subscription name should be used when subscribing:

let sub = my_client.subscribe("projects/{google-project-id}/subscriptions/{subscription-name}")

Currently a subscription needs to be created using the gcloud CLI or the web interface. There are plans to support creating a subscription directly from a topic name.