googleapis / google-cloud-rust

---

NOTE: this project is experimental and is supported on a best effort basis.

---

Google Cloud API Client Libraries for Rust

Rust idiomatic client libraries for Google Cloud Platform services.

Libraries are available on GitHub and crates.io for developing Rust applications that interact with individual Google Cloud services:

Source code	Release Level	Version
TODO()

Enabling APIs

Before you can interact with a given Google Cloud Service, you must enable its API.

Links are available for enabling APIs in each library's README.md.

Authentication

Download your Service Account Credentials JSON file

To use Application Default Credentials, you first need to download a set of JSON credentials for your project. Go to APIs & Auth > Credentials in the [Google Developers Console][devconsole] and select Service account from the Add credentials dropdown.

This file is your only copy of these credentials. It should never be committed with your source code, and should be stored securely.

Once downloaded, store the path to this file in the GOOGLE_APPLICATION_CREDENTIALS environment variable.

Other Authentication Methods

Other authentication methods are outlined in the README for TODO(), which is the authentication library used by all Google Cloud Rust clients.

Example Applications

TODO()

Supported Rust Versions

Our client libraries are compatible with the current edition of Rust.

Versioning

Our libraries follow Semantic Versioning.

Any release versioned 0.x.y is subject to backwards-incompatible changes at any time.

GA: Libraries defined at the GA (general availability) quality level are stable. The code surface will not change in backwards-incompatible ways unless absolutely necessary (e.g. because of critical security issues) or with an extensive deprecation period. Issues and requests against GA libraries are addressed with the highest priority.

Please note that the auto-generated portions of the GA libraries (the ones in modules such as v1 or v2) are considered to be of Beta quality, even if the libraries that wrap them are GA.

Preview: Libraries defined at the Preview quality level are expected to be mostly stable, while we work towards their release candidate. We will address issues and requests with a higher priority.

Contributing

Contributions to this library are always welcome and highly encouraged.

See CONTRIBUTING for more information on how to get started.

License

Apache 2.0 - See LICENSE for more information.

google-cloud-rust's Issues

Would you be willing to take ownership of google-apis-rs?

Hello,

There is this excellent project that has just been deprecated:

https://github.com/Byron/google-apis-rs/

The background is given in these discussions:

• https://rust-lang.zulipchat.com/#narrow/stream/318791-t-crates-io/topic/Can.20I.20reclaim.203.20Google.20CLI.20crates.2Cpublished.20by.20someone.20else.3F
• https://rust-lang.zulipchat.com/#narrow/stream/318791-t-crates-io/topic/On.20Google.20APIs.20and.20Sebastian.20Thiel's.20crates

The Rust ecosystem is risking to be left without a comprehensive way to interact with Google APIs. There are other initiatives but they are not this rigorous in terms of the coverage. This page gives a nice overview of what google-apis-rs is capable of:

https://byron.github.io/google-apis-rs/

Would you be willing to adopt the repository and maintain it moving forward, with the community's effort of course?

Thank you!

/cc @danoscarmike, @codyoss

refactor upload to not copy full payload into memory

We need to come up with some adapters so we can make use of reqwest::multipart::Part::stream.

refactor download to stream payload to AsyncWrite

Need to due some performance testing and see if we can reduce the amount of allocations that happening when streaming bytes.

[Policy Bot] found one or more issues with this repository.

Policy Bot found one or more issues with this repository.

• Default branch is 'main'
• Branch protection is enabled
• Merge commits disabled
• There is a CODEOWNERS file
• GitHub detects a valid LICENSE.md
• There is a CODE_OF_CONDUCT.md
• There is a CONTRIBUTING.md
• There is a SECURITY.md

conflicting crate name

for better or worse https://crates.io/crates/google-cloud-auth has the same name as the auth/ member of this workspace.

Not expressing an opinion about whether having 'official' or 'community' crates is better, but you won't be able to publish or have people consume this effort with a conflicting name.

Interested in owning ours?

Hi,

A while ago, we needed a library to talk to spanner and a few other GCP services. We worked with some folk over at GCP to get a rust library that builds off of the GRPC models made. We've been the custodian for it since, mostly because, well, nobody else wanted it, and we had the need.

I'll admit, it feels a bit weird for us to support this, and while it works and does what we need, I wouldn't call it well polished. Hopefully, it's enough to get your effort properly kick-started at least.

(Sorry for not reaching out earlier, but I just discovered this effort yesterday.)