envoy_data_plane
Python dataclasses for the Envoy Data-Plane-API
What it is and what it does
envoy_data_plane is a Python library that wraps the Envoy Data-Plane-API protocol buffers as native Python dataclasses, generated using betterproto. It gives you type-safe, IDE-aware access to every Envoy API type without writing raw protobuf code. The library is intended for developers building Envoy control planes, configuration generators, or other tooling that needs to work with Envoy's configuration model programmatically.
The package depends only on betterproto2 and requires Python 3.11 or later. It is actively maintained and published to PyPI to track the current Envoy release. Common use cases include generating Envoy configurations via Python scripts, building custom control planes with IDE autocompletion, and laying groundwork for gRPC-based control planes in Python.
Use it for:
- Generate Envoy configuration files programmatically from Python, with type checking and IDE autocompletion.
- Build a custom Envoy control plane in Python with validated, strongly-typed configuration objects.
- Prototype or test Envoy configurations using Python scripts before deploying to production.
- Integrate Envoy configuration management into larger Python infrastructure-as-code workflows.
Worth the install?
AI-flagged interpretation of the facts on this page — verify before relying
Provides Python dataclasses for the Envoy Data-Plane-API, generated from protocol buffers using betterproto, enabling type-safe programmatic access to Envoy configuration types.
Yes, if you are building Envoy tooling or control planes in Python. The low install friction, active maintenance, MIT license, and single dependency make it a straightforward addition. No known vulnerabilities. The main caveat is verifying that the package version matches your target Envoy release, since it tracks the current Envoy version rather than maintaining branches for older releases.
Install
envoy-data-plane on PyPI
pip
pip install envoy-data-planeuv
uv add envoy-data-planepoetry
poetry add envoy-data-planeInstalling envoy_data_plane
Before you install
Low install friction with a single pure-Python dependency (betterproto2). Active maintenance with a recent release (24 days old), supporting Python 3.11+.
License in practice
MIT license permits unrestricted use, modification, and distribution with minimal obligations—suitable for proprietary and open-source projects alike.
Quickstart
python -m pip install envoy_data_plane
from envoy_data_plane import config
# Import and use Envoy API types for configuration generation
Requires Python 3.11 or later
Verify before relying
- Whether the package tracks all current Envoy releases or lags behind the latest XDS API versions
- IDE autocompletion quality and completeness of the generated dataclass types
- Performance characteristics when working with large or deeply nested configurations
Package facts
| License | MIT (permissive) |
| Python support | supports the current Python release (<4,>=3.11) |
| Install friction | low — pure-Python wheel |
| Runtime dependencies | 1 — betterproto2 |
| Maintenance | actively maintained — 24 days since the last release |
| First released | |
| Downloads | 1,516,177/month — #3,823 on PyPI (30-day window, as of 2026-08-14) |
| Known vulnerabilities | none known (OSV.dev, checked 2026-08-14) |
Evidence: envoy_data_plane-2.2.0-py3-none-any.whl
Tags
More Internet packages
Botocore provides low-level, data-driven access…
permissive · top 100 on PyPI
aiobotocoreProvides an async client for AWS services using…
permissive · top 100 on PyPI
pydanticPydantic validates Python data structures…
permissive · top 100 on PyPI
filelockProvides a platform-independent file locking…
permissive · top 100 on PyPI
fastapiFastAPI is a Python web framework for building…
permissive · top 100 on PyPI
googleapis-common-protosProvides common Protocol Buffer message…
permissive · top 100 on PyPI
betterproto2Generates idiomatic Python code from Protobuf…
permissive · top 5,000 on PyPI
proto-google-cloud-datastore-v1Provides Protocol Buffer definitions and gRPC…
permissive · top 15,000 on PyPI
betterproto-fwGenerates idiomatic Python code from Protobuf 3…
permissive · top 15,000 on PyPI
betterprotoGenerates idiomatic Python code from Protobuf 3…
permissive · top 5,000 on PyPI
pure-protobufEncodes and decodes Protocol Buffer messages…
permissive · top 15,000 on PyPI
betterproto2-compilerGenerates idiomatic Python code from Protobuf 3…
permissive · top 15,000 on PyPI
proto-plusProto Plus wraps protocol buffers to provide…
permissive · top 1,000 on PyPI
flyteidl2Provides Python protobuf message definitions…
permissive · top 15,000 on PyPI