README
¶
Truss 
Fork By
https://github.com/metaverse/truss
Truss handles the painful parts of services, freeing you to focus on the business logic.
Install
Currently, there is no binary distribution of Truss, you must install from source.
To install this software, you must:
-
Install protoc 3 or newer. The easiest way is to download a release from github and add to
$PATH. Otherwise install from source. -
Install Truss with
# or git clone https://github.com/douchunrong/truss.git go get -u -d github.com/douchunrong/truss cd $GOPATH/src/github.com/douchunrong/truss make dependencies makeOn Windows, do the following instead:
go get -u -d github.com/douchunrong/truss cd %GOPATH%/src/github.com/douchunrong/truss wininstall.bat
Usage
Using Truss is easy. You define your service with gRPC and protoc buffers, and Truss uses that definition to create an entire service. You can even add http annotations for HTTP 1.1/JSON transport!
Then you open the handlers/handlers.go,
add you business logic, and you're good to go.
Here is an example service definition: Echo Service
Try Truss for yourself on Echo Service to see the service that is generated:
truss _example/echo.proto
See USAGE.md and TUTORIAL.md for more details.
Developing
See DEVELOPING.md for details.
配置常见错误
1. proto 文件中添加
import "github.com/douchunrong/truss/deftree/googlethirdparty/annotations.proto";
如果出现 not found github.com/douchunrong/truss/deftree/googlethirdparty/annotations.proto
检查 $GO_PATH 下有没有本项目
2. make 报错
错误：
apple@appledeMacBook-Pro truss % make
go generate github.com/douchunrong/truss/gengokit/template
gengokit/template/gogenerate.go:1: running "go-bindata": exec: "go-bindata": executable file not found in $PATH
make: *** [gobindata] Error 1
原因：未找到 go-bindata 可执行文件
解决办法：需要重新导入环境变量,将 $GTOPATH/bin 加入到 $PATH 中。（我使用的相关环境变量写到了 ~/.bash_profile ，执行 source ~/.bash_profile 即可）
Directories
¶
| Path | Synopsis |
|---|---|
|
_example
|
|
|
cmd
|
|
|
Deftree, which stands for "definition tree", creates a tree of nodes representing the components of a service defined through Protobuf definition files.
|
Deftree, which stands for "definition tree", creates a tree of nodes representing the components of a service defined through Protobuf definition files. |
|
gogothirdparty
Package gogoproto provides extensions for protocol buffers to achieve:
|
Package gogoproto provides extensions for protocol buffers to achieve: |
|
Package gendoc is a truss plugin to generate markdown documentation for a protobuf definition file.
|
Package gendoc is a truss plugin to generate markdown documentation for a protobuf definition file. |
|
generator
Package generator generates a gokit service based on a service definition.
|
Package generator generates a gokit service based on a service definition. |
|
handlers
Package handlers renders the Go source files found in <svcname>/handlers/.
|
Package handlers renders the Go source files found in <svcname>/handlers/. |
|
httptransport
Package httptransport provides functions and template helpers for templating the http-transport of a go-kit based service.
|
Package httptransport provides functions and template helpers for templating the http-transport of a go-kit based service. |
|
template
This file is here to hold the `go generate` command above.
|
This file is here to hold the `go generate` command above. |
|
Package svcdef provides a straightforward view of the Go code for a gRPC service defined using protocol buffers.
|
Package svcdef provides a straightforward view of the Go code for a gRPC service defined using protocol buffers. |
|
svcparse
Svcparse, which stands for "service parser" will parse the 'service' declarations within a provided protobuf and associate comments within that file with the various components of the service.
|
Svcparse, which stands for "service parser" will parse the 'service' declarations within a provided protobuf and associate comments within that file with the various components of the service. |
|
execprotoc
Package execprotoc provides an interface for interacting with proto requiring only paths to files on disk
|
Package execprotoc provides an interface for interacting with proto requiring only paths to files on disk |
|
parsesvcname
Package parsesvcname will parse the service name of a protobuf package.
|
Package parsesvcname will parse the service name of a protobuf package. |