|
#!/usr/bin/env bash
|
|
# -*- coding: utf-8; mode: sh indent-tabs-mode: nil -*-
|
|
# SPDX-License-Identifier: AGPL-3.0-or-later
|
|
#
|
|
# Tools to install and maintain golang [1] binaries & packages.
|
|
#
|
|
# [1] https://golang.org/doc/devel/release#policy
|
|
#
|
|
# A simple *helloworld* test with user 'my_user' :
|
|
#
|
|
# sudo -H adduser my_user
|
|
# ./manage go.golang go1.17.3 my_user
|
|
# ./manage go.install github.com/go-training/helloworld@latest my_user
|
|
# ./manage go.bash my_user
|
|
# $ helloword
|
|
# Hello World!!
|
|
#
|
|
# Don't forget to remove 'my_user': sudo -H deluser --remove-home my_user
|
|
|
|
# shellcheck source=utils/lib.sh
|
|
. /dev/null
|
|
|
|
# configure golang environment
|
|
# ----------------------------
|
|
|
|
[[ -z "${GO_VERSION}" ]] && GO_VERSION="go1.17.3"
|
|
|
|
GO_DL_URL="https://golang.org/dl"
|
|
|
|
# implement go functions
|
|
# -----------------------
|
|
|
|
go.help(){
|
|
cat <<EOF
|
|
go.:
|
|
ls : list golang binary archives (stable)
|
|
golang : (re-) install golang binary in user's \$HOME/local folder
|
|
install : install go package in user's \$HOME/go-apps folder
|
|
bash : start bash interpreter with golang environment sourced
|
|
EOF
|
|
}
|
|
|
|
go.ls(){
|
|
python3 <<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.ver_info(){
|
|
|
|
# print informations about a golang distribution. To print filename
|
|
# sha256 and size of the archive that fits to your OS and host:
|
|
#
|
|
# go.ver_info "${GO_VERSION}" archive "$(go.os)" "$(go.arch)" filename sha256 size
|
|
#
|
|
# usage: go.ver_info <go-vers> <kind> <os> <arch> [filename|sha256|size]
|
|
#
|
|
# kind: [archive|source|installer]
|
|
# os: [darwin|freebsd|linux|windows]
|
|
# arch: [amd64|arm64|386|armv6l|ppc64le|s390x]
|
|
|
|
python3 - "$@" <<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
|
|
}
|
|
|
|
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.golang() {
|
|
|
|
# install golang binary in user's $HOME/local folder:
|
|
#
|
|
# go.golang ${GO_VERSION} ${SERVICE_USER}
|
|
#
|
|
# usage: go.golang <go-vers> [<username>]
|
|
|
|
local version fname sha size user userpr
|
|
local buf=()
|
|
|
|
version="${1:-${GO_VERSION}}"
|
|
user="${2:-${USERNAME}}"
|
|
userpr=" ${_Yellow}|${user}|${_creset} "
|
|
|
|
rst_title "Install Go in ${user}'s HOME" section
|
|
|
|
mapfile -t buf < <(
|
|
go.ver_info "${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"
|
|
tee_stderr 0.1 <<EOF | sudo -i -u "${user}" | prefix_stdout "${userpr}"
|
|
mkdir -p \$HOME/local
|
|
rm -rf \$HOME/local/go
|
|
tar -C \$HOME/local -xzf ${CACHE}/${fname}
|
|
echo "export GOPATH=\$HOME/go-apps" > \$HOME/.go_env
|
|
echo "export PATH=\$HOME/local/go/bin:\\\$GOPATH/bin:\\\$PATH" >> \$HOME/.go_env
|
|
EOF
|
|
info_msg "test golang installation"
|
|
sudo -i -u "${user}" <<EOF
|
|
source \$HOME/.go_env
|
|
command -v go
|
|
go version
|
|
EOF
|
|
}
|
|
|
|
go.install() {
|
|
|
|
# install go package in user's $HOME/go-apps folder:
|
|
#
|
|
# go.install github.com/go-training/helloworld@lates ${SERVICE_USER}
|
|
#
|
|
# usage: go.install <package> [<username>]
|
|
|
|
local package user userpr
|
|
|
|
package="${1}"
|
|
user="${2:-${USERNAME}}"
|
|
userpr=" ${_Yellow}|${user}|${_creset} "
|
|
|
|
if [ -z "${package}" ]; then
|
|
die 42 "${FUNCNAME[0]}() - missing argument: <package>"
|
|
fi
|
|
tee_stderr 0.1 <<EOF | sudo -i -u "${user}" | prefix_stdout "${userpr}"
|
|
source \$HOME/.go_env
|
|
go install -v ${package}
|
|
EOF
|
|
}
|
|
|
|
go.bash() {
|
|
|
|
# start bash interpreter with golang environment sourced
|
|
#
|
|
# go.bash ${SERVICE_USER}
|
|
#
|
|
# usage: go.bash [<username>]
|
|
|
|
local user
|
|
user="${1:-${USERNAME}}"
|
|
sudo -i -u "${user}" bash --init-file "~${user}/.go_env"
|
|
}
|
|
|
|
go.version(){
|
|
local user
|
|
user="${1:-${USERNAME}}"
|
|
sudo -i -u "${user}" <<EOF
|
|
source \$HOME/.go_env
|
|
go version | cut -d' ' -f 3
|
|
EOF
|
|
}
|