injecttag

README

protoc-go-inject-tag

Why?

Golang protobuf doesn't support custom tags to generated structs. This script injects custom tags to generated protobuf files, useful for things like validation struct tags.

Install

• protobuf version 3

  For OS X:

  brew install --devel protobuf
  

• go support for protobuf: go get -u github.com/golang/protobuf/{proto,protoc-gen-go}

• go get github.com/favadi/protoc-go-inject-tag or download the binaries from releases page.

Usage

Add a comment with syntax // @inject_tag: custom_tag:"custom_value" before fields to add custom tag to in .proto files.

Example:

// file: test.proto
syntax = "proto3";

package pb;

message IP {
  // @inject_tag: valid:"ip"
  string Address = 1;
}

Generate with protoc command as normal.

protoc --go_out=. test.proto

Run protoc-go-inject-tag with generated file test.pb.go.

protoc-go-inject-tag -input=./test.pb.go

The custom tags will be injected to test.pb.go.

type IP struct {
	// @inject_tag: valid:"ip"
	Address string `protobuf:"bytes,1,opt,name=Address,json=address" json:"Address,omitempty" valid:"ip"`
}

Documentation

Index

• func WriteFile(inputPath string, areas []TextArea) (err error)
• type TextArea
  • func ParseFile(inputPath string) (areas []TextArea, err error)

Functions

func WriteFile

func WriteFile(inputPath string, areas []TextArea) (err error)

Types

type TextArea

type TextArea struct {
	Start int
	End   int
	Tag   string
}

func ParseFile

func ParseFile(inputPath string) (areas []TextArea, err error)