diff options
Diffstat (limited to 'utils/lib_govm.sh')
| -rwxr-xr-x | utils/lib_govm.sh | 226 |
1 files changed, 226 insertions, 0 deletions
diff --git a/utils/lib_govm.sh b/utils/lib_govm.sh new file mode 100755 index 000000000..c74f4a65a --- /dev/null +++ b/utils/lib_govm.sh @@ -0,0 +1,226 @@ +#!/usr/bin/env bash +# SPDX-License-Identifier: AGPL-3.0-or-later +# +# Go versions manager to install and maintain golang [1] binaries & packages. +# +# [1] https://golang.org/doc/devel/release#policy + +# shellcheck source=utils/lib.sh +. /dev/null + +# configure golang environment for go.vm +# -------------------------------------- + +_GO_DL_URL="https://go.dev/dl" + +GOVERSION="${GOVERSION:-go$(awk '/^go /{print $2}' "${REPO_ROOT}/go.mod")}" +GOTOOLCHAIN=local + +GOROOT="${REPO_ROOT}/.govm/${GOVERSION}" +GOENV="${GOROOT}/.config/go.env" +GOVM_EXE="${GOROOT}/bin/go" + +GOPATH="${REPO_ROOT}/local/${GOVERSION}" # no support for multiple path names!! +GOCACHE="${GOPATH}/.cache/go-build" +GOMODCACHE="${GOPATH}/pkg/mod" + +# implement go functions +# ----------------------- + +go.help() { + cat <<EOF +go: GOROOT=${GOROOT} + install : compiles and installs packages +EOF +} + +go.tool() { + # shortcut for "go tool .." in the Go environment + go.env.dev + "${GOVM_EXE}" tool "$@" +} + +go.env.dev() { + if [ -z "$_GO_DEVTOOLS_INSTALLED" ]; then + build_msg INSTALL "[pkg.go.dev] ./go.mod: developer and CI tools" + go.tidy + else + go.vm.ensure + _GO_DEVTOOLS_INSTALLED=1 + fi +} + +go.tidy() { + go.vm.ensure + "${GOVM_EXE}" mod tidy + chmod -R u+w "${GOMODCACHE}" +} + +go.clean() { + if ! go.vm.is_installed; then + build_msg CLEAN "[Go] not installed" + return 0 + fi + build_msg CLEAN "[Go] drop folders ${GOROOT} and ${GOPATH}" + rm -rf "${GOROOT}" "${GOPATH}" +} + +go.install() { + go.vm.ensure + GOENV="${GOENV}" "${GOVM_EXE}" install "$@" + # not sure why, but go installs some files without setting the write access + # for the file owner + chmod -R u+w "${GOMODCACHE}" +} + +go.os() { + local OS + case "$(command uname -a)xx" in + Linux\ *) OS=linux ;; + Darwin\ *) OS=darwin ;; + FreeBSD\ *) OS=freebsd ;; + CYGWIN* | MSYS* | MINGW*) OS=windows ;; + *) die 42 "OS is unknown: $(command uname -a)" ;; + esac + echo "${OS}" +} + +go.arch() { + local ARCH + case "$(command uname -m)" in + "x86_64") ARCH=amd64 ;; + "aarch64") ARCH=arm64 ;; + "armv6" | "armv7l") ARCH=armv6l ;; + "armv8") ARCH=arm64 ;; + .*386.*) ARCH=386 ;; + ppc64*) ARCH=ppc64le ;; + *) die 42 "ARCH is unknown: $(command uname -m)" ;; + esac + echo "${ARCH}" +} + +# Go version management (go.vm) +# ----------------------------- + +go.vm.ensure() { + if ! go.vm.is_installed; then + # shellcheck disable=SC2119 + go.vm.install + fi +} + +go.vm.is_installed() { + # is true if "go" command is installed + [[ -f "${GOROOT}/bin/go" ]] +} + +# shellcheck disable=SC2120 +go.vm.install() { + + python -m pip install -U requests + + # Go versions manager; to install Go at arbitrary place: + # + # usage: go.vm.install <version> <dest> + + local version dest fname sha size tmp + version="${1:-$GOVERSION}" + dest="${2:-$GOROOT}" + + info_msg "Install Go in ${dest}" + + # HINT: the python requirements needed by go.vm.version are taken from the + # developer environment. If it is not yet installed, install it now .. + pyenv.install + + # fetch go version .. + local buf=() + mapfile -t buf < <( + go.vm.version "${version}" archive "$(go.os)" "$(go.arch)" filename sha256 size + ) + if [ ${#buf[@]} -eq 0 ]; then + die 42 "can't find info of golang version: ${version}" + fi + fname="${buf[0]}" + sha="${buf[1]}" + size="$(numfmt --to=iec "${buf[2]}")" + + info_msg "Download go binary ${fname} (${size}B)" + cache_download "${_GO_DL_URL}/${fname}" "${fname}" + + pushd "${CACHE}" &>/dev/null + echo "${sha} ${fname}" >"${fname}.sha256" + if ! sha256sum -c "${fname}.sha256" >/dev/null; then + die 42 "downloaded file ${fname} checksum does not match" + else + info_msg "${fname} checksum OK" + fi + popd &>/dev/null + + info_msg "install golang" + + tmp="$(mktemp -d)" + tar -C "${tmp}" -xzf "${CACHE}/${fname}" + rm -rf "${dest}" + mkdir -p "$(dirname "${dest}")" + mv "${tmp}/go" "${dest}" + + mkdir -p "$(dirname "$GOENV")" + export GOENV + + "${GOVM_EXE}" telemetry off + "${GOVM_EXE}" env -w \ + GOBIN="$GOBIN" \ + GOTOOLCHAIN="$GOTOOLCHAIN" \ + GOCACHE="$GOCACHE" \ + GOPATH="$GOPATH" \ + GOMODCACHE="$GOMODCACHE" + + mkdir -p "${GOMODCACHE}" +} + +go.vm.list() { + + # Go versions manager; list Go versions (stable) + + python <<EOF +import sys, json, requests +resp = requests.get("${_GO_DL_URL}/?mode=json&include=all") +for ver in json.loads(resp.text): + if not ver['stable']: + continue + for f in ver['files']: + if f['kind'] != 'archive' or not f['size'] or not f['sha256'] or len(f['os']) < 2: + continue + print(" %(version)-10s|%(os)-8s|%(arch)-8s|%(filename)-30s|%(size)-10s|%(sha256)s" % f) +EOF +} + +go.vm.version() { + + # Print information about a Go distribution. To print filename sha256 and + # size of the archive that fits to your OS and host: + # + # go.ver_info "${GOVERSION}" archive "$(go.os)" "$(go.arch)" filename sha256 size + # + # usage: go.vm.version <go-vers> <kind> <os> <arch> [filename|sha256|size] + # + # kind: [archive|source|installer] + # os: [darwin|freebsd|linux|windows] + # arch: [amd64|arm64|386|armv6l|ppc64le|s390x] + + python - "$@" <<EOF +import sys, json, requests +resp = requests.get("${_GO_DL_URL}/?mode=json&include=all") +for ver in json.loads(resp.text): + if ver['version'] != sys.argv[1]: + continue + for f in ver['files']: + if (f['kind'] != sys.argv[2] or f['os'] != sys.argv[3] or f['arch'] != sys.argv[4]): + continue + for x in sys.argv[5:]: + print(f[x]) + sys.exit(0) +sys.exit(42) +EOF +} |