luci-go: LUCI services and tools in Go

Installing

go get -u github.com/luci/luci-go/client/cmd/...
go get -u github.com/luci/luci-go/server/cmd/...

Code layout

• /appengine/... contains AppEngine server code. It imports packages from /common/... and /server/....
• /client/... contains all client code.
• /common/... contains code and structures shared between all of /appengine/..., /client/... and /server/...; for example, the structures used by the server APIs. These are inherently APIs.
• /server/... contains standalone server code. Its packages are reusable by /appengine/....
• /tools/... contains support tools used by other LUCI components.

Versioning

• Branch go1 contains the stable code.
• Branch master constains the latest code.

Contributing

• Sign the Google CLA.
• Make sure your user.email and user.name are configured in git config.
• Install test-only packages: go get -u -t github.com/luci/luci-go/client/...
• Install the pcg git hook: go get -u github.com/maruel/pre-commit-go/cmd/... && pcg

Run the following to setup the code review tool and create your first review:

git clone https://chromium.googlesource.com/chromium/tools/depot_tools.git $HOME/src/depot_tools
export PATH="$PATH:$HOME/src/depot_tools"
cd $GOROOT/github.com/luci/luci-go
git checkout -b work origin/master

# hack hack

git commit -a -m "This is awesome\nR=joe@example.com"
# This will ask for your Google Account credentials.
git cl upload -s
# Wait for LGTM over email.
# Check the commit queue box in codereview website.
# Wait for the change to be tested and landed automatically.

Use git cl help and git cl help <cmd> for more details.