Skip to content
This repository has been archived by the owner on Mar 26, 2022. It is now read-only.
/ goprotowrap Public archive

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

License

Notifications You must be signed in to change notification settings

square/goprotowrap

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

28 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

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.

Build Status

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.

About

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

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages