https://github.com/anacrolix/godo
godo is an improved `go run`
https://github.com/anacrolix/godo
build-tool go golang wrapper
Last synced: about 1 year ago
JSON representation
godo is an improved `go run`
- Host: GitHub
- URL: https://github.com/anacrolix/godo
- Owner: anacrolix
- Created: 2015-06-28T08:25:24.000Z (about 11 years ago)
- Default Branch: master
- Last Pushed: 2024-02-22T23:56:23.000Z (over 2 years ago)
- Last Synced: 2024-05-01T21:01:29.819Z (about 2 years ago)
- Topics: build-tool, go, golang, wrapper
- Language: Go
- Homepage:
- Size: 25.4 KB
- Stars: 37
- Watchers: 3
- Forks: 3
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# godo
`godo` is an alternative to `go run`. It's useful when you want to avoid the `go build`/`go install`, `/path/to/somebin` cycle. There's also a bash completion script, which makes it easy to quickly invoke a Go package from your `GOPATH`.
`godo` differs from `go run` in the following respects:
* The package to execute is specified by import path, rather than some constituent source files.
- `godo github.com/anacrolix/missinggo/cmd/nop` vs.
- `go run $GOPATH/src/github.com/anacrolix/missinggo/cmd/nop/*.go`
* The generated binary is stored at `$TMPDIR/godo/$pkgname.$$`. This means that:
- It's easy to locate the binary for a process running through godo.
- The proctitle is `$pkgname.$$`, e.g. `torrent.123`, where the package name of the binary was `torrent`, and its PID is `123`.
- There is a bounded history of binaries due to the OS PID reuse policy. After PIDs cap at around 32K, they'll return to lower values, gradually replacing older binaries that are no longer associated with running processes.
* The main package isn't rebuilt unnecessarily, avoiding a link step for successive `godo` calls to the same package. For example a `go run` invocation for a large application on my system has a mandatory ~0.8s delay even if the files haven't changed. `godo` has this at 0.04s, because it's able to reuse the existing binary.
## Usage
```sh
$ godo -h
godo is an alternative to `go run`.
Usage:
godo [go build flags] [binary arguments]
godo -h | --help
```
### Example
```
# first run
$ time godo github.com/anacrolix/missinggo/cmd/nop
real 0m0.244s
user 0m0.177s
sys 0m0.071s
$ time godo github.com/anacrolix/missinggo/cmd/nop
real 0m0.046s
user 0m0.012s
sys 0m0.022s
# historical binaries
$ ls -tr $TMPDIR/godo/ | grep nop.
nop.40586
nop.40590
```
## Installation
go install github.com/anacrolix/godo@latest
Bash completion:
go install github.com/anacrolix/godo/go-list-cmd@latest
. "$GOPATH/src/github.com/anacrolix/godo/complete.sh"
## Godo-ception
```
$ godo github.com/anacrolix/godo cmd/go run "$GOPATH/src/github.com/anacrolix/godo/"*.go cmd/go list github.com/anacrolix/...
```