goprotowrap

README

goprotowrap

⚠️ The Go plugin for protoc got smarter: you should no longer need this

A package-at-a-time wrapper for protoc, for generating Go protobuf code.

protowrap is a small tool we found helpful when working with protocol buffers in Go at Square. We're publishing it in the hope that others find it useful too. Contributions are welcome.

Install

go get -u github.com/square/goprotowrap/cmd/protowrap

Philosophy

Unlike other language plugins, the Go protobuf plugin expects to be called separately for each package, and given all files in that package (fixed).

protowrap is called instead of protoc, and ensures that .proto files are processed one Go package at a time.

It parses out the flags it understands, passing the rest through to protoc unchanged.

Operation

• search for all .proto files under the same import paths as the .proto file arguments
• call protoc to generate FileDescriptorProtos
• inspect the FileDescriptorProtos to deduce package information
• group .proto files into packages
• call protoc once for each package

TODOs

• Replace square-specific handling of go_package with recently updated upstream logic.
• In the initial call to protoc for generating FileDescriptorProtos, pass .proto files to protoc in batches instead of all at once.
• Better tests, especially of the code paths not exercised by our build process.

License

Copyright 2016 Square, Inc.

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.

Documentation

Index

• Constants

Constants

const Version = "0.2.0"