protobuf-doc
v1.0.1
Published
A protocol buffer query string documentor
Maintainers
Readme
protobuf-doc is a CLI tool that decodes and documents Protobuf-encoded query string. It extracts structured information and formats it into Markdown for easier readability. At the moment, it only supports query strings found in google maps.
Frameworks/Technologies
Usage
protobuf-doc can be used directly without installation
npx protobuf-doc "<protobuf_string>" "<output_type>"Alternatively, install it globally for frequent use:
npm install -g protobuf-doc
protobuf-doc "<protobuf_string>" "<output_type>"Arguments
<protobuf_string> - string: A Protobuf-encoded query string, typically used in URLs
<output_type> - string: The output format. Currently, only 'md' (Markdown) is supported.
Example Usage
npx protobuf-doc "!1m7!1s0x3ae259fa5863aa65:0xe33d2d1f01284b9b!3s!6m4!4m1!1e1!4m1!1e3!2m2!1i10!2s!5m2!1sBnOwZvzePPfF4-EPy7LK0Ak!7e81!8m5!1b1!2b1!3b1!5b1!7b1!11m6!1e3!2e1!3sen!4slk!6m1!1i2!13m1!1e2" "md"TO-DO List
- [ ] Support JSON output for parsed Protobuf data.
- [ ] Extend parsing to non-Google Maps Protobuf query strings.
- [ ] Allow custom delimiters.
License
This project is licensed under the MIT License - see the LICENSE file for details.
Contributing
I welcome contributions from the community! Please see our CONTRIBUTING.md for details on how to contribute to this project.
Code of Conduct
Please note that this project is governed by a Code of Conduct. By participating, you are expected to uphold this code.
Acknowledgements
Special thanks to @marin-m for his outstanding work on the pbtk repository. His contributions and insights on protocol buffers were invaluable in my research and development process.
