Protobuf HTTP API Cleaner
This tool removes all traces google api annotations from a protocol buffer file. This is useful to client apps that do not the need the api annotations as those annotations are mostly useful to the server side code.
For example if you had a potocol buffer definition which contains the http api annotation like this:
syntax = "proto3"; import "google/protobuf/empty.proto";import "google/api/annotations.proto"; package app; service AppApi { rpc GetConfigInfo(google.protobuf.Empty) returns (ConfigInfoResponse) { option (google.api.http) = { get: "/v1/configs" }; }} message ConfigInfoResponse { string some_config = 1;}
and running it through this library binary would produce an output like this:
syntax = "proto3"; import "google/protobuf/empty.proto"; package app; service AppApi { rpc GetConfigInfo(google.protobuf.Empty) returns (ConfigInfoResponse) { }} message ConfigInfoResponse { string some_config = 1;}
Installation
You can install globally with:
npm i -g proto_api_cleaner
or add to your projects package.json by omitting the -g
in the command above 😉.
Usage
Usage: proto_api_cleaner -p [protoPath] -o [outputPath]
Options:
--help Show help [boolean]
--version Show version number [boolean]
-p, --proto Input path to Protocol Buffer file [required]
-o, --out Optional path to output converted file or else it overwrites
input file
Project specific usage:
The ideal use case is to install it into your client side javascript package.json and then have a script that runs this binary against your protocol buffer files.
Contribution
Contributions are welcome. There are bunch of improvements that could be added, such as :
- Input path should accept a glob input
- Export cleanup logic as a module that can be used directly in code
- ... feel free to open suggestion issues
License
MIT