gcloud-sdk for Rust

This library generated from Google API using tonic-build.

This is not official gcloud sdk from Google (and it doesn't exist for Rust at the moment of this page was updated).

Overview

This library contains all the code generated from the Google API.

When using each product API, you must explicitly include it in your build using a feature flag. For example, if you want to use Cloud Pub/Sub, write features = ["google-pubsub-v1"] to Cargo.toml.

The feature name is the period of the package name of each proto file, replaced by a hyphen. If you specify a package, it will automatically load the dependent packages and include them in the build. It means that features = ["google-spanner-admin-database-v1"] is the same as the code below:

pub mod google {
    pub mod api {
        tonic::include_proto!("google.api");
    }
    pub mod iam {
        pub mod v1 {
            tonic::include_proto!("google.iam.v1");
        }
    }
    pub mod longrunning {
        tonic::include_proto!("google.longrunning");
    }
    pub mod r#type {
        tonic::include_proto!("google.r#type");
    }
    pub mod rpc {
        tonic::include_proto!("google.rpc");
    }
    pub mod spanner {
        pub mod admin {
            pub mod database {
                pub mod v1 {
                    tonic::include_proto!("google.spanner.admin.database.v1");
                }
            }
        }
    }
}

In addition, multiple features can be specified.

The list of available features can be found here.

Example

The complete code can be found here.

use gcloud_sdk::*;

use gcloud_sdk::google::spanner::admin::database::v1::{
    database_admin_client::DatabaseAdminClient, ListDatabasesRequest,
};

#[tokio::main]
async fn main() -> Result<(), Box<dyn std::error::Error>> {
    let project = std::env::var("PROJECT")?;
    let instance = std::env::var("INSTANCE")?;

    // The library handles getting token from environment automatically
    let spanner_client: GoogleApiClientFn<DatabaseAdminClient<GoogleConnectorInterceptedService>> = GoogleApiClient::from_function(
        | channel, interceptor | DatabaseAdminClient::with_interceptor(channel, interceptor),
        "https://spanner.googleapis.com",
        chrono::Duration::minutes(15),
        None,
    )
        .await?;

    // The library caches clients and tokens automatically
    let response = spanner_client
        .get()
        .await?
        .list_databases(tonic::Request::new(ListDatabasesRequest {
            parent: format!("projects/{}/instances/{}", project, instance),
            page_size: 100,
            ..Default::default()
        }))
        .await?;

    println!("RESPONSE={:?}", response);

    Ok(())
}

Cargo.toml:

[dependencies]
gcloud-sdk = { version = "0.10", features = ["google-spanner-admin-database-v1"] }
tonic = { version = "0.7", features = ["tls"] }
prost = "0.10"
prost-types = "0.10"
tokio = { version = "1.14", features = ["rt-multi-thread", "time", "fs", "macros"] }
chrono = "0.4"

Fork

The library is a fork of mechiru/googapis and mechiru/gouth to keep up with the updates and API proto descriptions from Google more frequently and simplify dependencies management.

Why not to contribute back?

• Different goals from googapis.
  • This fork focuses on simplicity and provided authentication capabilities natively.
  • Has direct dependencies to tokio runtime and chrono. Uses synchronisation primitives (such as Mutex) from tokio everywhere.
  • Provides facade API for the caching async client implementation that hides complexity working with tokens and TLS.
• Different development cycles - the original development was updated less frequently than it was needed for me.

I'd be glad to contribute all of the changes back if author sees the same goals.

License

Licensed under either of Apache License, Version 2.0 or MIT license at your option.

Authors

• mechiru - the original project
• Abdulla Abdurakhmanov - updated for recent deps, introduced caching client implementation, merged/refactorings with gouth.