#google #api #googleapis #gcloud #gcp

googapis

This library generated from Google API using tonic-build

14 unstable releases (5 breaking)

0.6.0 Nov 25, 2021
0.4.2 Mar 23, 2021
0.3.3 Nov 13, 2020
0.3.0+20200719 Jul 19, 2020

#26 in Web programming

Download history 624/week @ 2021-08-15 228/week @ 2021-08-22 388/week @ 2021-08-29 344/week @ 2021-09-05 304/week @ 2021-09-12 151/week @ 2021-09-19 309/week @ 2021-09-26 473/week @ 2021-10-03 468/week @ 2021-10-10 554/week @ 2021-10-17 728/week @ 2021-10-24 393/week @ 2021-10-31 333/week @ 2021-11-07 231/week @ 2021-11-14 297/week @ 2021-11-21 258/week @ 2021-11-28

1,137 downloads per month
Used in 6 crates (5 directly)

MIT/Apache

30MB
393K SLoC

googapis

ci Rust Documentation Latest Version

This library generated from Google API using tonic-build.

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.

Version matrices

googapis tonic tonic-build
0.1.x 0.2.x 0.2.x
0.2.x 0.2.x 0.2.x
0.3.x 0.3.x 0.3.x
0.4.x 0.4.x 0.4.x
0.5.x 0.5.x 0.5.x
0.6.x 0.6.x 0.6.x

Example

The complete code can be found here.

Cargo.toml:

[dependencies]
googapis = { version = "0.6", features = ["google-spanner-admin-database-v1"] }
gouth = { version = "0.2" }
tonic = { version = "0.6", features = ["tls"] }
prost = "0.9"
prost-types = "0.9"
tokio = { version = "1.13", features = ["rt-multi-thread", "time", "fs", "macros"] }

main.rs:

use googapis::{
    google::spanner::admin::database::v1::{
        database_admin_client::DatabaseAdminClient, ListDatabasesRequest,
    },
    CERTIFICATES,
};
use gouth::Token;
use tonic::{
    metadata::MetadataValue,
    transport::{Certificate, Channel, ClientTlsConfig},
    Request,
};

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

    let tls_config = ClientTlsConfig::new()
        .ca_certificate(Certificate::from_pem(CERTIFICATES))
        .domain_name("spanner.googleapis.com");

    let channel = Channel::from_static("https://spanner.googleapis.com")
        .tls_config(tls_config)?
        .connect()
        .await?;

    let mut service = DatabaseAdminClient::with_interceptor(channel, move |mut req: Request<()>| {
        let token = &*token.header_value().unwrap();
        let meta = MetadataValue::from_str(token).unwrap();
        req.metadata_mut().insert("authorization", meta);
        Ok(req)
    });

    let response = service
        .list_databases(Request::new(ListDatabasesRequest {
            parent: format!("projects/{}/instances/{}", project, instance),
            page_size: 100,
            ..Default::default()
        }))
        .await?;

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

    Ok(())
}

License

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

Dependencies

~6.5MB
~111K SLoC