Nest Engineering Docs
PackagesPackages

Generated protobuf/Connect stubs

Python 3.13 generated protobuf and ConnectRPC stubs from proto/

nest-protos is a generated Python 3.13 package that centralizes protobuf messages and ConnectRPC stubs used by backend services and clients.

Package profile

FieldValue
Locationpackages/python/nest_protos/
RuntimePython 3.13
Installuv sync --all-packages
Importdev_api.*, raven.*, spanner.*
TypeGenerated library (no runtime entrypoint)

Source of truth

  • Proto definitions live in proto/.
  • Workspace config and plugin mappings live in buf.yaml and buf.gen.yaml.

Generated outputs

  • Python protobuf messages (*_pb2.py) and typing stubs (*_pb2.pyi).
  • ConnectRPC client/server helpers (*_connect.py).
  • Dart stubs for Raven are generated into apps/raven/lib/gen by the same buf generate.

Modules

  • dev_api.v1: stubs for the dev-api service.
  • raven.raven.v1: stubs for the Raven ConnectRPC service.
  • spanner: shared Spanner-related protobuf messages.

Local development

  • Never hand-edit generated code.
  • After changing .proto files, run buf generate from the repo root.
  • Ensure access to buf.build for the remote plugins used by generation.

Ownership

  • Shared platform asset; changes should be coordinated with service owners.

References

  • Proto sources: proto/
  • Generation config: buf.yaml, buf.gen.yaml

Last updated on

Shared Python utilities (common)

Shared Python 3.13 utilities used across services and jobs

Flutter window effects (flutter_acrylic)

Desktop window acrylic/mica effects plugin used by Raven