Skip to main content

A tool to visualize .proto file hierarchies

Project description

Proto Explorer

A lightweight, interactive browser for exploring Protobuf/gRPC hierarchies

Python Streamlit Protobuf

Proto Explorer lets you visually explore Protobuf message hierarchies (*.proto files) using only the compiled Python files (*_pb2.py). No .proto files or regeneration required.

✅ Expand nested message fields
✅ Show oneof group hierarchy
✅ Correctly detect map<key, value> fields
✅ Load _pb2.py from custom paths
✅ No server or DB needed — runs locally


🌟 Demo Screenshot

Coming soon – add screenshot here once UI finalized You can insert a screenshot like:

Proto Explorer Screenshot


🔧 Installation

Clone the repository and install dependencies:

poetry install

Activate the Python virtual environment:

source $(poetry env info --path)/bin/activate

▶️ Run the App

proto-explorer --proto_module <compiled_protobuf_pb2_module> [--load_path </path/to/compiled/protobuf>]

Example:

proto-explorer --proto_module myproject.datamanager.users_pb2 --load_path ~/protos/compiled

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

proto_explorer-0.1.0.tar.gz (4.8 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

proto_explorer-0.1.0-py3-none-any.whl (6.1 kB view details)

Uploaded Python 3

File details

Details for the file proto_explorer-0.1.0.tar.gz.

File metadata

  • Download URL: proto_explorer-0.1.0.tar.gz
  • Upload date:
  • Size: 4.8 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: poetry/2.1.4 CPython/3.12.3 Linux/6.6.87.2-microsoft-standard-WSL2

File hashes

Hashes for proto_explorer-0.1.0.tar.gz
Algorithm Hash digest
SHA256 55908210d268cea5dc6d63f6df62a42790307356d1bf61b165a101d6cbc7aa61
MD5 061472cb50a8fa592b11e4503daf07b9
BLAKE2b-256 843f27205ff811ab52c6154a16cf547e48b418274ed08d7b76ab28eca1c83b72

See more details on using hashes here.

File details

Details for the file proto_explorer-0.1.0-py3-none-any.whl.

File metadata

  • Download URL: proto_explorer-0.1.0-py3-none-any.whl
  • Upload date:
  • Size: 6.1 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: poetry/2.1.4 CPython/3.12.3 Linux/6.6.87.2-microsoft-standard-WSL2

File hashes

Hashes for proto_explorer-0.1.0-py3-none-any.whl
Algorithm Hash digest
SHA256 e70b2ac95643b7725c102c26bbe62bd573cf5198d6436b0cb6ae98592f4547d0
MD5 2647ab47d3441638f07fdba2da5fdcee
BLAKE2b-256 5b2c37cfbb40d33303c5c4dac7b01700bbf7fe238cd6b3d0f4b00b06fed17c03

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page