Name: protoc-docs-plugin
Owner: Google APIs
Description: A protoc plugin that appends docstrings to Message subclasses on the default Python pb2 generated output.
Created: 2017-06-08 14:38:04.0
Updated: 2018-05-23 19:30:21.0
Pushed: 2018-05-17 18:07:14.0
Size: 66
Language: Python
GitHub Committers
| User | Most Recent Commit | # Commits |
|---|
Other Committers
| User | Most Recent Commit | # Commits |
|---|
This is a protoc plugin intended to augment protoc's default Python
output with docstrings. It has been loosely designed to be able to support
docstrings for other langauges also, but this is contingent upon the
availability of appropriate insertion points in those languages.
This package depends on the current version of protobuf and pypandoc
from PyPI.
p install protoc-docs-plugin
Additionally, this package also depends on the pandoc OS package, which
you will need to install from your OS package manager.
While it will run standalone as well, it only ever actually makes sense
to invoke it from protoc.
Add --pydocstring_out to the same command to protoc that has a previous
--python_out directive.
Example:
otoc foo.proto --python_out=. --pydocstring_out=.
Order does matter here; protoc must write the plain Python output first
before it can augment it with the output from this plugin.