Copyright 2018 The gRPC Authors

This repo is created to support GCP specific extensions for gRPC. To use the extension features, please refer to grpcio-gcp.

This repo also contains supporting infrastructures such as end2end tests and benchmarks for accessing cloud APIs with gRPC client libraries.

Download from github

 $ git clone https://github.com/GoogleCloudPlatform/grpc-gcp-python.git
 $ cd grpc-gcp-python
 $ git submodule update --init --recursive

Setup credentials. See Getting Started With Authentication for more details.

 $ export GOOGLE_APPLICATION_CREDENTIALS=path/to/key.json

Install the gRPC-GCP extension

 $ src/setup.sh

Install the gRPC-GCP extension test & benchmark suite

 $ tests/setup.sh

Run end to end integration tests.

 $ tests/integration.sh

Run end to end benchmark with gRPC-GCP extension.

 $ tests/benchmark.sh --gcp

Run end to end benchmark without gRPC-GCP extension. For comparison purspose.

 $ tests/benchmark.sh

Run grpc channel unit tests.

 $ tests/unit.sh

Run stress test against grpc client calls with weights.

 $ tests/stress.sh --gcp --weighted_cases 'list_sessions:100'