How to develop truss

Dependencies

$ go get github.com/jteeuwen/go-bindata/...

Whenever templates are modified, the templates must be recompiled to binary, this is done with:

$ go generate github.com/Unity-Technologies/truss/...

Then to build truss and its protoc plugin to your $GOPATH/bin directory:

$ go install github.com/Unity-Technologies/truss/...

Both can be done from the Makefile in the root directory:

$ cd $GOPATH/github.com/Unity-Technologies/truss
$ make

Before submitting a pull request always run tests that cover modified code. Also build truss and run truss's integration test. This can be done by

$ cd $GOPATH/src/github.com/Unity-Technologies/truss
$ make
$ make test
# If the tests failed and you want to remove generated code
$ make testclean

Truss works as follows:

Read in a group of .proto files
Execute protoc with our protoc-gen-protocast protoc plugin, which outputs the protoc AST representation of the .proto files
Parse protoc's AST output and the .proto file with the grpc Service definition for http annotations using go-truss/deftree
Use protoc and protoc-gen-go to generate .pb.go files containing protobuf structs and transport for golang
Use the constructed deftree with gengokit to template out basic gokit service with grpc and http/json transport and empty handlers
Generate documentation from comments with gendocs

If there was already generated code in the filesystem then truss will not overwrite user code in the /NAME-service/handlers directory

Additional internal packages of note used by these programs are:

deftree, located in deftree/, which makes sense of the protobuf file passed to it by protoc, and is used by gengokit and gendoc