Metadata-Version: 2.3
Name: proto-explorer
Version: 0.2.0
Summary: A tool to visualize .proto file hierarchies
License: MIT
Keywords: protobuf,grpc,schema,explorer,streamlit
Author: Lei Yuan
Author-email: lee14159@gmail.com
Requires-Python: >=3.10
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Requires-Dist: protobuf (>=6.31.0,<7.0.0)
Requires-Dist: pytest (==8.2.0)
Requires-Dist: streamlit (>=1.50.0,<2.0.0)
Description-Content-Type: text/markdown

# Proto Explorer
*A lightweight, interactive browser for exploring Protobuf/gRPC hierarchies*

[![Python](https://img.shields.io/badge/python-3.10%2B-blue)]()
[![Streamlit](https://img.shields.io/badge/streamlit-app-red)](https://streamlit.io/)
[![Protobuf](https://img.shields.io/badge/protobuf-compiler-green)]()

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](docs/screenshot.png)

---

## 🔧 Installation

Clone the repository and install dependencies:
```text
pip install proto-explorer
```
---

## ▶️ Run the App

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

Example:

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

