The C based gRPC (C++, Python, Ruby, Objective-C, PHP, C#) https://grpc.io/

History

Mark D. Roth c4117e4615 [xDS] implement GCP Auth filter (#37550 ) Final piece of gRFC A83 (https://github.com/grpc/proposal/pull/438): the GCP authentication filter itself. Infrastructure changes include: - Added a general-purpose LRU cache library that can be reused elsewhere. - Fixed the client channel code to use the channel args returned by the resolver for the dynamic filters. This was necessary so that the GCP auth filter could access the `XdsConfig` object, which is passed via a channel arg. - Unlike the other xDS HTTP filters we support, the GCP auth filter does not support config overrides, and its configuration includes a cache size parameter that we always need at the channel level, not per-call. As a result, I had to change the xDS HTTP filter API to give it the ability to set top-level fields in the service config, not just per-method fields. (We use the service config as a way of passing configuration down into xDS HTTP filters.) Note that for now, this works only on the client side, because we don't have machinery for a top-level service config on the server side. - The GCP auth filter is also the first case where the filter needs to know its instance name from the xDS config, so I changed the xDS HTTP filter API to plumb that through. - Fixed a bug in the HTTP client library that prevented the override functions from declining to override a particular request. Closes #37550 COPYBARA_INTEGRATE_REVIEW=https://github.com/grpc/grpc/pull/37550 from markdroth:xds_gcp_auth_filter `19eaefb52f` PiperOrigin-RevId: 669371249		3 months ago
..
artifacts	[CI] Upgraded all `Debian 10` based images to `Debian 11` (#37547 )	4 months ago
build_stats	cleanup tools/run_tests directory	8 years ago
dockerize	Move docker images from dockerhub to artifact registry. (#31591 )	2 years ago
generated	[xDS] implement GCP Auth filter (#37550 )	3 months ago
helper_scripts	[fix grpc_build_protobuf_at_head test timeout] added bazel override for protobuf in build_python.sh (#37404 )	4 months ago
interop	Upgrade sanity Docker image to debian:stretch	6 years ago
lb_interop_tests	[Python] Migrate from yapf to black (#33138 )	2 years ago
performance	Fix minor typos (#37450 )	4 months ago
python_utils	Fix minor typos (#37450 )	4 months ago
sanity	[Gpr_To_Absl_Logging] Remove gpr_log. Adding absl LOG wrappers. (#37431 )	4 months ago
xds_k8s_test_driver	[PSM Interop] Delete PSM interop source per new repo migration (#35466 )	11 months ago
README.md	Remove C# implementation (individual packages will continue to be maintained through v2.46.x patches or moved to grpc-dotnet) (#29225 )	3 years ago
run_grpclb_interop_tests.py	Fix minor typos (#37450 )	4 months ago
run_interop_tests.py	[test] Remove deprecated flag from run_tests* scripts (#37261 )	5 months ago
run_performance_tests.py	Fix minor typos (#37450 )	4 months ago
run_tests.py	[CI] Updated clang 17 to 18 for c++ tests (#37592 )	4 months ago
run_tests_matrix.py	[CI] Updated clang 17 to 18 for c++ tests (#37592 )	4 months ago
run_xds_tests.py	Fix minor typos (#37450 )	4 months ago
start_port_server.py	[reorg] move test/core/util -> test/core/test_util (#36446 )	8 months ago
task_runner.py	[Python] Migrate from yapf to black (#33138 )	2 years ago

README.md

Overview

This directory contains scripts that facilitate building and running tests. We are using python scripts as entrypoint for our tests because that gives us the opportunity to run tests using the same commandline regardless of the platform you are using.

Unit tests (run_tests.py)

Builds gRPC in given language and runs unit tests. Use tools/run_tests/run_tests.py --help for more help.

Example

tools/run_tests/run_tests.py -l python -c dbg

Useful options (among many others)

--use_docker Builds a docker container containing all the prerequisites for given language and runs the tests under that container.
--build_only Only build, do not run the tests.

Note: If you get an error such as ImportError: No module named httplib2, then you may be missing some Python modules. Install the module listed in the error and try again.

Note: some tests may be flaky. Check the "Issues" tab for known flakes and other issues.

The full suite of unit tests will take many minutes to run.

Interop tests (run_interop_tests.py)

Runs tests for cross-platform/cross-language interoperability. For more details, see Interop tests descriptions The script is also capable of running interop tests for grpc-java and grpc-go, using sources checked out alongside the ones of the grpc repository.

Example

tools/run_tests/run_interop_tests.py -l python -s c++ --use_docker (run interop tests with C# client and C++ server)

Note: if you see an error like no space left on device when running the interop tests using Docker, make sure that Docker is building the image files in a location with sufficient disk space.

Performance benchmarks (run_performance_tests.py)

The run_performance_tests.py script is deprecated. See end-to-end benchmarking documentation for more info.

Artifacts & Packages (task_runner.py)

A generalized framework for running predefined tasks based on their labels. We use this to building binary artifacts & distrib packages and testing them)

Example

tools/run_tests/task_runner.py -f python artifact linux x64 (build tasks with labels python, artifact, linux, and x64)