Gitiles
Code Review Sign In
gerrit.lfbroadband.org / plyxproto / 3880d236d876adce168c22f1eaab3dafa876f106
commit3880d236d876adce168c22f1eaab3dafa876f106[log] [tgz]
authorDusan Klinec <dusan.klinec@gmail.com>Mon Nov 10 19:01:13 2014 +0100
committerDusan Klinec <dusan.klinec@gmail.com>Mon Nov 10 19:01:13 2014 +0100
tree50933d4f8c0b79491f6f972fc6fe17d9473787c3
parentaa9ff47db80bf107999f00709291bd264a269dd7 [diff]
Prefixize demo script added.

* Demo script for prefixing identifiers for Protocol Buffers entities. It is useful when using with protoc objective C compiler which does not prefix entities. https://github.com/alexeyxo/protobuf-objc
1 file changed
tree: 50933d4f8c0b79491f6f972fc6fe17d9473787c3
  1. .gitignore
  2. LICENSE
  3. README.md
  4. demo.py
  5. ply/
  6. plyproto/
  7. prefixize.py
README.md

PLY Protobuf

[Protocol Buffers] 0 lexer & parser written in Python for [PLY] 1.

With this library you can create and process parse trees of a Protocol Buffers files with Python. For example usage see demo.py.

My use case: automated refactoring of .proto files.

Dependency

  • This project has only one dependency, [PLY] 1.
  • ply/ subdirectory is present in this repo for demonstration purposes and completeness only. If you intend to use this project, prefer better original [PLY] 1 repository which is up-to-date.

Contributions

  • There may be bugs although it works for me for quite complicated protocol buffers files. If you find a bug, please feel free to submit a pull request or file an issue.

Bugs

  • Oneof is not implemented yet.

Acknowledgement

This work was inspired by:

  • [plyj] 2, Java lexer & parser for PLY.
  • [pyparsing] 3, Protocol Buffers parsing example.
  • [PLYTalk] 4, nice tutorial for PLY I used.

Disclaimer

  • This project was created because I needed it for myself and I didn't find Protocol Buffers parser for PLY. It is my first PLY / parser generator project and the first version was created in couple hours so it is not polished code.
  • There already exist Protocol Buffer parsing variant as [pyparsing] 3 example, but my previous scripts used PLY for parsing Java so I chosen to stay with PLY and to create Protocol Buffer variant for PLY. I like the output I can get from PLY (e.g., line, character position in the input text) so I can automatically process input files - e.g., refactoring.
  • API for this project is not guaranteed to remain stable. In particular I mean model generated from .proto files. Initial model may be considered suboptimal and changed at some point. This project is intended to serve as an inspiration or a starting point. You will probably adapt it for your own needs.