Source Code

This directory contains the source code for Cloud Robotics Core components. Most components are written in Go and Java.

Go

The Gazelle tool manages bazel BUILD files for Go.

Dependencies

To automatically update dependencies in bazel BUILD files run:

bazel run //:gazelle

To re-generate Go modules dependencies run this from the top-level source directory:

./src/gomod.sh

This will always download the latest stable tag of a go module. To use a specific version run eg::

cd src
# use an older version, that the latest stable
go get github.com/mitchellh/[email protected]
# use a specific, yet untagged version
go get github.com/mitchellh/go-server-timing@feb680ab92c20d57c527399b842e1941bde888c3

Licenses

Install go-license:

go install github.com/google/go-licenses@latest

run it:

cd src
# get a vsc of all licenses
~/go/bin/go-licenses csv .
# check for bad (forbidden) licenses, should be empty
~/go/bin/go-licenses check ./...

Docs

In order to force a new snapshot, run

VERSION=$(curl -s https://proxy.golang.org/github.com/googlecloudrobotics/core/@latest | jq -r ".Version")
echo "https://pkg.go.dev/github.com/googlecloudrobotics/core/src/go@${VERSION}"

and open the printed link. Then that version is part of the history.

third party

We track some external deps through nvchecker. Get the tool by running:

pip3 install nvchecker

Below are sample commands for the common workflows. Run all those from the root of the repo.

Add new dependency by adding a blob to nvchecker.toml:

[ingress-nginx]
source = "container"
registry = "k8s.gcr.io"
container = "ingress-nginx/controller"
prefix = "v"

Get initial version (use same command to update the version):

$ nvtake -c nvchecker.toml ingress-nginx=v0.44.0

Check for updates:

$ nvchecker -c nvchecker.toml
[I 09-06 12:26:20.253 core:354] ingress-nginx: updated from 0.44.0 to 1.0.0