---
id: types-grpcio-reflection
version: "1.0.0.20260508"
license: Apache-2.0
license_treatment: permissive
maintenance: active
---

# types-grpcio-reflection — Typing stubs for grpcio-reflection

License: permissive · Maintenance: active · Downloads: 146.8K/mo

## What it is and what it does

This is a type stub package—a collection of type annotations without runtime code—for grpcio-reflection. It allows static type checkers like mypy 1.20.0 and pyright 1.1.408 to understand the types and signatures of the grpcio-reflection library when you use it in your own code. The stubs are maintained as part of the typeshed project.

You install it alongside grpcio-reflection itself. The package has no runtime behavior; its only purpose is to give your type checker the information it needs to validate calls to grpcio-reflection APIs. It depends on types-grpcio and types-protobuf, which provide stubs for their respective libraries.

Use it for:

- Enable mypy or pyright to catch type errors in code that uses grpcio-reflection before runtime.
- Document the expected types of grpcio-reflection function arguments and return values in your IDE.
- Integrate gRPC reflection into a codebase that enforces strict type checking in CI/CD.
- Reduce debugging time by catching reflection API misuse at type-check time rather than runtime.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Provides type hints for grpcio-reflection, enabling static type checkers like mypy and pyright to validate code using gRPC reflection APIs.

Yes, if you use grpcio-reflection and run a static type checker. Install it as a dev dependency alongside grpcio-reflection. It has no runtime overhead and is actively maintained. If you do not use type checking or do not use grpcio-reflection, it is unnecessary.

## Install

pip install types-grpcio-reflection
uv add types-grpcio-reflection
poetry add types-grpcio-reflection

## Installing types-grpcio-reflection

Before you install: Low install friction with a wheel-only distribution. Actively maintained as part of typeshed; last commit 2026-08-14. Requires Python >=3.10.

License in practice: Licensed under Apache-2.0 (permissive), imposing no significant restrictions on use or redistribution in most contexts.

Quickstart:

pip install types-grpcio-reflection

# In your type-checked code, type checkers will now understand types-grpcio and types-protobuf APIs

Requires Python >=3.10; grpcio-reflection must be installed separately for runtime functionality.

Verify before relying:

- Whether this stub package is kept in sync with all grpcio-reflection 1.* releases or only a subset.
- Whether the stub covers all public APIs of grpcio-reflection or only a subset.
- Specific type-checking workflow integration steps beyond installation.

## Package facts

- License: Apache-2.0 (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 146.8K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

grpc reflection type stubs, grpcio-reflection typing, type hints for grpc, mypy stubs grpc, grpc type checking, type-stubs, grpc

[View on SkillFed](https://skillfed.io/packages/types-grpcio-reflection) · [View on PyPI](https://pypi.org/project/types-grpcio-reflection/)