grpc-interceptor

Simplifies gRPC interceptors

grpc-interceptor Permissive license MIT DORMANT ★ 151 v0.15.4 released 2023-11-16

Install

grpc-interceptor on PyPI

pip

pip install grpc-interceptor

uv

uv add grpc-interceptor

poetry

poetry add grpc-interceptor

Package facts

License	MIT (permissive)
Python support	supports the current Python release (>=3.7,<4.0)
Install friction	low — pure-Python wheel
Runtime dependencies	1 — grpcio
Maintenance	dormant — 1,001 days since the last release
Last repo commit	2024-04-11
First released	2020-07-13
Popularity	one of the top 1,000 most-downloaded packages on PyPI (30-day window, as of 2026-08-13)
Known vulnerabilities	none known (OSV.dev, checked 2026-08-13)

Evidence: grpc_interceptor-0.15.4-py3-none-any.whl

Keywords: grpc, interceptor

License :: OSI Approved :: MIT LicenseProgramming Language :: Python :: 3Programming Language :: Python :: 3.7Programming Language :: Python :: 3.8

About grpc-interceptor

from the package's own PyPI description — quoted content, verbatim

Tests (image) Codecov (image) Read the Docs (image) PyPI (image)

Summary

Simplified Python gRPC interceptors.

The Python grpc package provides service interceptors, but they're a bit hard to use because of their flexibility. The grpc interceptors don't have direct access to the request and response objects, or the service context. Access to these are often desired, to be able to log data in the request or response, or set status codes on the context.

Installation

To just get the interceptors (and probably not write your own):

$ pip install grpc-interceptor

To also get the testing framework, which is good if you're writing your own interceptors:

$ pip install grpc-interceptor[testing]

...

Read as markdown · JSON record · Source repository · Homepage · Docs

AI interpretation — verify before relying

AI-generated interpretation of the package facts above; every digit, version, license, or vulnerability id it cites is grounded in the facts already shown on this page

Provides simplified server and client interceptors for gRPC services, making it easier to access request/response objects and service context for logging, error handling, and metadata injection.

Low friction: pure Python wheel with a single runtime dependency (grpcio). Maintenance is dormant—last release was 1001 days ago (2023-11-16)—but the repository remains active and the package is stable enough for established use cases.

MIT license (permissive) places no restrictions on use, modification, or distribution; suitable for both open-source and commercial projects.

Usage

pip install grpc-interceptor

from grpc_interceptor import ServerInterceptor

class MyInterceptor(ServerInterceptor):
    def intercept(self, method, request_or_iterator, context, method_name):
        return method(request_or_iterator, context)

interceptors = [MyInterceptor()]
server = grpc.server(futures.ThreadPoolExecutor(max_workers=10), interceptors=interceptors)

Requires grpcio to be installed; Python 3.7 or later.

Verdict: Stable, low-friction utility for simplifying gRPC interceptor patterns in Python. No known vulnerabilities and permissive licensing make it safe to adopt. Dormant maintenance (1001 days since last release) is acceptable for a mature, focused library, but users should be prepared to maintain a fork or patch if breaking changes in grpcio emerge.

Needs verification

Whether the package remains compatible with current grpcio versions (last tested/released 2023-11-16).
Whether asyncio client interceptor support has been added since the last release.

grpc interceptorgrpc middlewaregrpc error handlinggrpc request logginggrpc metadata injectiongrpc service interceptorpython grpc utilities