substrait-protobuf

What it is and what it does

substrait-protobuf is a generated Python package that exposes protobuf message definitions for the Substrait specification. Substrait is a cross-platform standard for representing query plans and expressions, and this package provides the Python bindings needed to work with those definitions programmatically.

The package is automatically generated and published whenever a new Substrait specification version is released, ensuring the bindings stay synchronized with the specification. It depends only on protobuf and requires Python 3.10 or later. The bindings are organized into modules like substrait.algebra_pb2, substrait.plan_pb2, and substrait.type_pb2, allowing you to import and use the message types directly in your code.

Use it for:

• Serialize and deserialize Substrait query plans in Python applications that need to exchange plans with other systems.
• Build query optimization or analysis tools that work with Substrait algebra and type definitions.
• Integrate Substrait specification support into data processing frameworks or query engines written in Python.

Worth the install?

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

Provides Python protobuf bindings for the Substrait specification, enabling serialization and deserialization of Substrait algebra, plan, and type definitions.

Yes, if you are building Python tools that need to work with Substrait query plans or expressions. The package is actively maintained, has no known vulnerabilities, and carries a permissive license. Install friction is minimal. It is a straightforward protobuf binding with no hidden dependencies or gotchas.

Install

substrait-protobuf on PyPI

pip install substrait-protobuf

uv add substrait-protobuf

poetry add substrait-protobuf

Installing substrait-protobuf

Before you install

Low install friction with a single protobuf dependency. Actively maintained with releases tracking the Substrait specification; last commit 2026-08-14 and release 5 days prior indicate current development.

License in practice

Apache-2.0 permissive license allows commercial and private use with minimal restrictions.

Quickstart

pip install substrait-protobuf

import substrait.algebra_pb2
import substrait.plan_pb2
import substrait.type_pb2

Requires Python >= 3.10

Verify before relying

• Whether the package is suitable for production use in query engines or data systems beyond protobuf serialization
• Performance characteristics when handling large or deeply nested Substrait plans

Package facts

Evidence: substrait_protobuf-0.100.0-py3-none-any.whl

Tags

More Software Development packages