gobin

Overview ¶

Command gobin Go commands by reading their import paths, go-getting their repositories and building new executables.

Command gobin can search for and list Go executables, create a $GOPATH workspace out of a binary. It can also update an executable which does not have its sources fetched in current $GOPATH.

Source ¶

Command gobin can guess an origin of the sources used to build Go executables it finds on a system. It can be used to create precise mirror of the sources for system Go executables, without any unneeded packages.

~ $ gobin -s /tmp/gopath godoc golint goimports gotree gowhich
code.google.com/p/go.tools (download)
github.com/rjeczalik/tools (download)
github.com/rjeczalik/which (download)
(...)
github.com/rjeczalik/which/cmd/gowhich
code.google.com/p/go.tools/cmd/godoc
~ $ tree -L 3 /tmp/gopath/src/
/tmp/gopath/src/
├── code.google.com
│   └── p
│       └── go.tools
└── github.com
    └── rjeczalik
        ├── tools
        └── which

7 directories, 0 files

Update ¶

Command gobin can update single executable or automagically discover all of them in directories specified in $GOPATH, $GOBIN and $GOPATH environment variables.

Executing gobin without any arguments makes it list all Go executables found in $GOPATH, $GOBIN and $GOPATH.

Updating multiple executables is performed on multiple goroutines, bumping up $GOMAXPROCS environment variable may speed up the overall run-time significantly.

Example

~ $ GOMAXPROCS=2 gobin -u
ok 	/home/rjeczalik/bin/goimports	(code.google.com/p/go.tools/cmd/goimports)	13.966s
ok 	/home/rjeczalik/bin/godoc	(code.google.com/p/go.tools/cmd/godoc)	17.960s
ok 	/home/rjeczalik/bin/pulsecli	(github.com/x-formation/pulsekit/cmd/pulsecli)	13.052s
ok 	/home/rjeczalik/workspace/bin/pulsecli	(github.com/x-formation/pulsekit/cmd/pulsecli)	13.052s

Usage

NAME:
    gobin - looks for Go executables system-wide ($PATH/$GOBIN/$GOPATH),
            lists them, fetches their sources and updates them

USAGE:
    gobin [-u] [-s=.|gopath] [path|package...]

FLAGS:
    -u                Updates Go binaries
    -s <dir>          Go-gets sources for Go specified binaries into <dir> $GOPATH
                      (use '.' for current $GOPATH)
    -ldflags=<flags>  passes "-ldflags=flags" to "go install"

EXAMPLES:
    gobin                    Lists all Go binaries (looks up $PATH/$GOBIN/$GOPATH)
    gobin -s=. ~/bin         Go-gets sources used to build all Go binaries in ~/bin
                             into current $GOPATH
    gobin -s=/var/mirror     Go-gets all sources used to build all Go binaries found
                             on system into new /var/mirror $GOPATH
    gobin -u                 Updates all Go binaries
    gobin -u github.com      Updates all Go binaries installed from github.com
    gobin ~/bin              Lists all Go binaries from the ~/bin directory