mirror of https://github.com/kennyp/asdf-golang.git synced 2024-10-06 04:32:07 +08:00

Go to file

William Poetra Yoga 4f8976deb0 Prevent double-downloading installation archive (#61 ) This small change prevents `asdf` from downloading the installation archive twice. This reverts a line change from #54. Side note: according to https://asdf-vm.com/plugins/create.html, `bin/download` should do the downloading, not `bin/install`.		2021-10-20 13:12:58 -04:00
.github/ISSUE_TEMPLATE	Update issue templates	2019-03-02 03:03:39 -05:00
bin	Prevent double-downloading installation archive (#61 )	2021-10-20 13:12:58 -04:00
lib	Add help texts per plugin guidelins. (#46 )	2021-01-04 19:19:48 -05:00
.gitignore	Extract version from go.mod files (#32 )	2020-06-16 18:08:17 -04:00
.travis.yml	Add `bin/download` per latest asdf guidelines (#45 )	2021-01-04 17:36:54 -05:00
LICENSE	Initial Commit	2016-02-29 02:23:40 -05:00
README.md	Document ASDF_GOLANG_DEFAULT_PACKAGES_FILE (#60 )	2021-09-09 14:14:08 -04:00

README.md

asdf-golang

golang plugin for asdf version manager

Requirements

MacOS

GNU Core Utils - brew install coreutils

Linux (Debian)

GNU Core Utils - apt install coreutils
curl - apt install curl

Install

asdf plugin-add golang https://github.com/kennyp/asdf-golang.git

Use

Check the asdf readme for instructions on how to install & manage versions of go.

When using `go get`

After using go get to install a package you need to run asdf reshim golang to get any new shims.

Default `go get` packages

asdf-golang can automatically install a default set of packages with go get -u $PACKAGE right after installing a new Go version. To enable this feature, provide a $HOME/.default-golang-pkgs file that lists one package per line, for example:

// allows comments
github.com/Dreamacro/clash
github.com/jesseduffield/lazygit

You can specify a non-default location of this file by setting a ASDF_GOLANG_DEFAULT_PACKAGES_FILE variable.

Version selection

When using .tool-versions or .go-version, the exact version specified in the file will be selected.

When using go.mod, the highest compatible version that is currently installed will be selected. As per the Go modules reference, that is the highest minor version with a matching major version. For example, a go 1.14 directive in a go.mod file will result in the highest installed 1.minor.patch being selected, not necessarily 1.14.patch.

Contributing

Feel free to create an issue or pull request if you find a bug.

Issues

Assumes Linux, FreeBSD, or Mac
Assumes x86_64, i386, i686, armv6l, armv7l, arm64 and ppc64le

License

MIT License