Go to file
Jeff Carr e9cc02a060 change the help text
Signed-off-by: Jeff Carr <jcarr@wit.com>
2024-11-01 23:19:34 -05:00
.gitignore look for and use any go.work file 2024-03-07 19:30:09 -06:00
LICENSE blerg 2024-03-07 00:50:58 -06:00
Makefile show both ways to run this 2024-10-12 13:47:06 -05:00
README.md add --recursive 2024-03-21 19:43:26 -05:00
argv.go change the help text 2024-11-01 23:19:34 -05:00
control misc cleanups 2024-03-09 16:49:27 -06:00
main.go --go-src + --recursive 2024-03-21 22:47:17 -05:00
readWorkFile.go git clone deps 2024-03-09 09:23:04 -06:00

README.md

go-clone

5 years earlier, gohack was written for the same reasons this tool was written. gohack has a good justification for this kind of tool so here it is:

Gohack: mutable checkouts of Go module dependencies

The new Go module system is awesome. It ensures repeatable, deterministic builds of Go code. External module code is cached locally in a read-only directory, which is great for reproducibility. But if you're used to the global mutable namespace that is $GOPATH, there's an obvious question: what if I'm hacking on my program and I want to change one of those external modules?

You might want to put a sneaky log.Printf statement to find out how some internal data structure works, or perhaps try out a bug fix to see if it solves your latest problem. But since all those external modules are in read-only directories, it's hard to change them. And you really don't want to change them anyway, because that will break the integrity checking that the Go tool does when building.

Luckily the modules system provides a way around this: you can add a replace statement to the go.mod file which substitutes the contents of a directory holding a module for the readonly cached copy. You can of course do this manually, but gohack aims to make this process pain-free.

Install go-glone

go install go.wit.com/apps/go-clone@latest

go-glone itself

This will make a work directory and download everything needs to compile go-clone.

go-clone --work go.wit.com/apps/go-clone