Truss helps you build go-kit microservices without having to worry about writing or maintaining boilerplate code.
Go Makefile Other
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.

README.md

Truss Build Status

Truss handles the painful parts of services, freeing you to focus on the business logic.

Everything all the time forever

Install

Currently, there is no binary distribution of Truss, you must install from source.

To install this software, you must:

  1. Install protoc 3 or newer. The easiest way is to download a release from github and add to $PATH. Otherwise install from source.

  2. Install Truss with

    go get -u -d github.com/tuneinc/truss
    cd $GOPATH/src/github.com/tuneinc/truss
    make dependencies
    make
    

    On Windows, do the following instead:

    go get -u -d github.com/tuneinc/truss
    cd %GOPATH%/src/github.com/tuneinc/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.