grpcio-gcp

What it is and what it does

grpcio-gcp is a gRPC extension that adds connection pooling and affinity-based request routing for Google Cloud Platform services. It wraps the standard gRPC channel to manage a pool of underlying channels and route requests to specific backend instances based on configuration rules, useful for services that benefit from session affinity.

The package works by loading an API configuration file in text protobuf format that defines channel pool parameters and per-method routing rules, then providing a secure_channel factory that returns a channel pool object compatible with the standard gRPC Channel interface. It is a specialized tool for GCP service integration rather than a general-purpose gRPC enhancement.

Use it for:

• Manage connection pooling to Google Cloud services that require session affinity and benefit from multiple underlying channels.
• Bind gRPC requests to specific backend instances using affinity keys to maintain session state across method calls.
• Configure per-method routing rules (BIND, BOUND, UNBIND) to control how requests are distributed across a pool of channels.

Worth the install?

AI-flagged interpretation of the facts on this page — verify before relying

Extends gRPC with connection pooling and affinity-based routing for Google Cloud Platform services, managing multiple channels and binding requests to specific backend instances.

No. The package is abandoned (last release 2018-09-10) and targets Python 2.7 and Python 3.4–3.6, all end-of-life. For new projects, use current Google Cloud client libraries instead. Install only if maintaining legacy code that already depends on it.

Install

grpcio-gcp on PyPI

pip install grpcio-gcp

uv add grpcio-gcp

poetry add grpcio-gcp

Installing grpcio-gcp

Before you install

Low install friction with a single runtime dependency on grpcio. However, the package is abandoned—last release was 2018-09-10 with no updates since, and classifiers indicate support only for Python 2.7 and Python 3.4–3.6.

License in practice

Licensed under Apache License 2.0 (permissive), imposing no restrictions on use or redistribution in proprietary code, though you must retain license notices.

Quickstart

pip install grpcio-gcp

import grpcio_gcp

config = grpcio_gcp.api_config_from_text_pb(config_text)
options = [(grpcio_gcp.API_CONFIG_CHANNEL_ARG, config)]
channel_pool = grpcio_gcp.secure_channel(target, credentials, options)

Requires a gRPC config file in text protobuf format defining ChannelPoolConfig and MethodConfig; package targets Python 2.7 and Python 3.4–3.6.

Verify before relying

• Whether the package works with modern Python versions despite classifiers indicating only 2.7 and 3.4–3.6 support.
• Current state of Google Cloud client libraries' gRPC integration and whether this package remains necessary.
• Performance and stability of the channel pool implementation under production load.
• Whether grpcio dependency has breaking changes incompatible with this abandoned package.

Package facts

Evidence: grpcio_gcp-0.2.2-py2.py3-none-any.whl

Tags

More Distributed Computing packages