gcloud-aio

The library provides three primary classes for different Google Cloud authentication scenarios:

1. IamClient: Used to interact with GCP public keys and to sign blobs via URL.
2. IapToken: Used for authorizing against an Identity-Aware Proxy (IAP) secured GCP service. Each instance corresponds to an ID token specific to a single target service.
3. Token: The standard class used for general Google Cloud authorization. Other gcloud-aio-* package components (like BigQuery, Storage, etc.) accept a Token instance as an argument. You can use a single Token across multiple components or define unique tokens for each service by specifying the required scopes.

The repository provides two distinct HTTP-based implementations of Google Cloud client libraries for Python:

1. gcloud-aio-*: Built using asyncio and the aiohttp library. Use this when you need non-blocking, asynchronous I/O.
2. gcloud-rest-*: A threadsafe implementation built using the requests library. Use this for standard synchronous or multi-threaded workflows.

Both implementations serve as alternatives to the official Google Cloud client libraries by providing HTTP-based access to Google Cloud services.

This repository provides two distinct types of HTTP implementations for Google Cloud client libraries in Python:

1. gcloud-aio-*: Built specifically for Python 3's asyncio (asynchronous/non-blocking).
2. gcloud-rest-*: A threadsafe implementation based on the requests library.

To install a specific client, use pip install with the appropriate prefix (gcloud-aio- or gcloud-rest-) followed by the service name.

# Example for installing the asyncio version of BigQuery
$ pip install --upgrade gcloud-aio-bigquery

# Example for installing the requests-based version of BigQuery
$ pip install --upgrade gcloud-rest-bigquery

You can install the asynchronous version (gcloud-aio-auth) or the REST version (gcloud-rest-auth) using pip. It is recommended to use the --upgrade flag to ensure you have the latest version.

$ pip install --upgrade gcloud-{aio,rest}-auth

Install the Google Cloud KMS client using pip. You can install either the asyncio-based version (gcloud-aio-kms) or the REST-based version (gcloud-rest-kms).

$ pip install --upgrade gcloud-aio-kms

You can install the library using pip. The codebase supports both the aio (asyncio) and rest versions.

To install the asyncio version:

pip install --upgrade gcloud-aio-storage

To install the REST version:

pip install --upgrade gcloud-rest-storage

You can install either the asyncio-based client (gcloud-aio-pubsub) or the REST-based client (gcloud-rest-pubsub) using pip. Use the following command to upgrade or install the package:

$ pip install --upgrade gcloud-{aio,rest}-pubsub

You can install the asynchronous or REST-based BigQuery client using pip. Use the following command to install or upgrade the package:

$ pip install --upgrade gcloud-aio-bigquery

You can install either the asyncio-based client (gcloud-aio-datastore) or the REST-based client (gcloud-rest-datastore) using pip. Use the following command to ensure you have the latest version:

$ pip install --upgrade gcloud-{aio,rest}-datastore

Install the Google Cloud Task Queue client using pip. You can choose between the aio (asyncio) or rest versions depending on your concurrency model requirements.

$ pip install --upgrade gcloud-{aio,rest}-taskqueue

The following Google Cloud services are supported through individual client packages. You can choose between the asyncio (gcloud-aio-*) or requests-based (gcloud-rest-*) implementation for each:

• Auth: gcloud-aio-auth / gcloud-rest-auth
• BigQuery: gcloud-aio-bigquery / gcloud-rest-bigquery
• Datastore: gcloud-aio-datastore / gcloud-rest-datastore
• KMS: gcloud-aio-kms / gcloud-rest-kms
• PubSub: gcloud-aio-pubsub / gcloud-rest-pubsub
• Storage: gcloud-aio-storage / gcloud-rest-storage
• Task Queue: gcloud-aio-taskqueue / gcloud-rest-taskqueue

The library supports the following authentication methods:

• Service account credentials
• Authorized user credentials
• GCE metadata credentials
• Impersonated service account credentials
• External account credentials (for workload identity federation)