jfyne/protoc repository overview

⁠Protocol Buffers + Docker

All inclusive protoc suite, powered by Docker and Alpine Linux.

⁠What's included:

• protobuf 3.6.0.1
• gRPC 1.13.0
• gRPC-Web 1.0.0
• Google Well Known Types are automatically included (via google/)
• Go related tools compiled with 1.8.1, gRPC support is built-in:
  • github.com/golang/protobuf/protoc-gen-go
  • github.com/gogo/protobuf/protoc-gen-gofast
  • github.com/gogo/protobuf/protoc-gen-gogo
  • github.com/gogo/protobuf/protoc-gen-gogofast
  • github.com/gogo/protobuf/protoc-gen-gogofaster
  • github.com/gogo/protobuf/protoc-gen-gogoslick
  • github.com/twitchtv/twirp/protoc-gen-twirp
  • github.com/grpc-ecosystem/grpc-gateway/protoc-gen-swagger
  • github.com/grpc-ecosystem/grpc-gateway/protoc-gen-grpc-gateway
  • github.com/mwitkow/go-proto-validators
  • github.com/moul/protoc-gen-gotemplate
  • github.com/micro/protoc-gen-micro

⁠Supported languages

• C
• C++
• C#
• Java / JavaNano (Android)
• JavaScript
• Objective-C
• Python
• Ruby
• Go
• Swift 4
• Rust

⁠Usage

$ docker run --rm znly/protoc --help
Usage: /usr/bin/protoc [OPTION] PROTO_FILES

Don't forget you need to bind mount your files:

$ docker run --rm -v $(pwd):$(pwd) -w $(pwd) znly/protoc --python_out=. -I. myfile.proto

⁠Google Well Known Types

They are embedded in the image and are included by protoc automatically. They accessible via google/protobuf/:

syntax = "proto3";

import "google/protobuf/timestamp.proto";
import "google/protobuf/duration.proto";

⁠Gogo

gogo.proto is embedded in the image and can be included with:

syntax = "proto3";

import "github.com/gogo/protobuf/gogoproto/gogo.proto";

⁠Image Size

The current image is about ~189mb and one layer. Most the space is spent on Go tools. All the binaries are UPX'ed. Including the Swift stdlib.