spcd/spcd.sh

#! /usr/bin/env sh

# defaults
[ -n "${SPCD_BRANCH_RELEASE}" ] || SPCD_BRANCH_RELEASE="main"
[ -n "${SPCD_BRANCH_STAGING}" ] || SPCD_BRANCH_STAGING="dev"
[ -n "${SPCD_BRANCH_FEATURE}" ] || SPCD_BRANCH_FEATURE="f"
[ -n "${SPCD_DNS_1}" ] || SPCD_DNS_1="9.9.9.9"
[ -n "${SPCD_GIT_MAIN}" ] || SPCD_GIT_MAIN="spcd"
[ -n "${SPCD_GIT_ROOT}" ] || SPCD_GIT_ROOT="rwx"
[ -n "${SPCD_URL_PYTHON}" ] || SPCD_URL_PYTHON="https://pypi.org/simple"

# main
spcd_main() {
	spcd_set_environment_variables
	#
	spcd_list_working_directory
	#
	spcd_set_packages_repositories
	spcd_set_packages_configuration
	#
	spcd_set_https_verification_off
	spcd_set_dns_resolving
	spcd_update_packages_catalog
	spcd_install_packages_tools
	spcd_install_ca_certificates
	spcd_write_ca_certificates
	spcd_update_ca_certificates
	spcd_set_https_verification_on
	spcd_update_packages_catalog
	spcd_upgrade_packages
	spcd_install_git
	spcd_install_python
	# TODO move to Python
	spcd_install_packages
	spcd_install_python_modules
	spcd_write_python_module
	spcd_switch_to_python
}

# steps

spcd_set_environment_variables() {
	spcd_step "Set environment variables"
	# check script first
	[ -n "${SPCD}" ] || spcd_error_ci "SPCD"
	# continuous integration / github → gitea → forgejo
	if [ -n "${GITHUB_ACTIONS}" ]; then
		# project branch
		if [ -n "${GITHUB_REF_NAME}" ]; then
			SPCD_PROJECT_BRANCH="${GITHUB_REF_NAME}"
		else
			spcd_error_ci "GITHUB_REF_NAME"
		fi
		# project root
		if [ -n "${GITHUB_SERVER_URL}" ]; then
			SPCD_PROJECT_ROOT="$(dirname "${GITHUB_SERVER_URL}")//"
			[ -n "${GITHUB_TOKEN}" ] &&
				SPCD_PROJECT_ROOT="${SPCD_PROJECT_ROOT}${GITHUB_TOKEN}@"
			SPCD_PROJECT_ROOT="\
${SPCD_PROJECT_ROOT}$(basename "${GITHUB_SERVER_URL}")"
		else
			spcd_error_ci "GITHUB_SERVER_URL"
		fi
		# project path & name
		if [ -n "${GITHUB_REPOSITORY}" ]; then
			# project path
			SPCD_PROJECT_PATH="$(dirname "${GITHUB_REPOSITORY}")"
			# project name
			SPCD_PROJECT_NAME="$(basename "${GITHUB_REPOSITORY}")"
		else
			spcd_error_ci "GITHUB_REPOSITORY"
		fi
	# continuous integration / gitlab
	elif [ -n "${GITLAB_CI}" ]; then
		# project branch
		if [ -n "${CI_COMMIT_BRANCH}" ]; then
			SPCD_PROJECT_BRANCH="${CI_COMMIT_BRANCH}"
		else
			spcd_error_ci "CI_COMMIT_BRANCH"
		fi
		# project root / protocol
		if [ -n "${CI_SERVER_PROTOCOL}" ]; then
			# project root / login
			if [ -n "${CI_REGISTRY_USER}" ]; then
				# project root / password
				if [ -n "${CI_REGISTRY_PASSWORD}" ]; then
					# project root / host
					if [ -n "${CI_SERVER_FQDN}" ]; then
						# project root
						SPCD_PROJECT_ROOT="${CI_SERVER_PROTOCOL}\
://${CI_REGISTRY_USER}:${CI_REGISTRY_PASSWORD}@${CI_SERVER_FQDN}"
						# project path
						if [ -n "${CI_PROJECT_NAMESPACE}" ]; then
							SPCD_PROJECT_PATH="${CI_PROJECT_NAMESPACE}"
							# project name
							if [ -n "${CI_PROJECT_NAME}" ]; then
								SPCD_PROJECT_NAME="${CI_PROJECT_NAME}"
							else
								spcd_error_ci "CI_PROJECT_NAME"
							fi
						else
							spcd_error_ci "CI_PROJECT_NAMESPACE"
						fi
					else
						spcd_error_ci "CI_SERVER_FQDN"
					fi
				else
					spcd_error_ci "CI_REGISTRY_PASSWORD"
				fi
			else
				spcd_error_ci "CI_REGISTRY_USER"
			fi
		else
			spcd_error_ci "CI_SERVER_PROTOCOL"
		fi
	# continuous integration / unsupported
	else
		spcd_error_ci "ø"
	fi
	# check project variables
	case "${SPCD_PROJECT_BRANCH}" in
	"${SPCD_BRANCH_RELEASE}" | \
		"${SPCD_BRANCH_STAGING}" | \
		"${SPCD_BRANCH_FEATURE}") ;;
	*) spcd_error_ci "SPCD_PROJECT_BRANCH" ;;
	esac
	[ -n "${SPCD_PROJECT_ROOT}" ] || spcd_error_ci "SPCD_PROJECT_ROOT"
	[ -n "${SPCD_PROJECT_PATH}" ] || spcd_error_ci "SPCD_PROJECT_PATH"
	[ -n "${SPCD_PROJECT_NAME}" ] || spcd_error_ci "SPCD_PROJECT_NAME"
	#
	spcd_echo "SPCD_PROJECT_BRANCH" \
		"SPCD_PROJECT_ROOT" "SPCD_PROJECT_PATH" "SPCD_PROJECT_NAME"
	# set path
	SPCD_PATH="$(realpath "${0}")"
	spcd_echo "SPCD_PATH"
	# set operating system id
	SPCD_OS_ID="$(spcd_grep_os ID)"
	case "${SPCD_OS_ID}" in
	"almalinux") SPCD_OS_ID="${SPCD_OS_ALMA}" ;;
	"alpine") SPCD_OS_ID="${SPCD_OS_ALPINE}" ;;
	"arch") SPCD_OS_ID="${SPCD_OS_ARCH}" ;;
	"debian") SPCD_OS_ID="${SPCD_OS_DEBIAN}" ;;
	"fedora") SPCD_OS_ID="${SPCD_OS_FEDORA}" ;;
	"rocky") SPCD_OS_ID="${SPCD_OS_ROCKY}" ;;
	"ubuntu") SPCD_OS_ID="${SPCD_OS_UBUNTU}" ;;
	*) spcd_error_os "SPCD_OS_ID" ;;
	esac
	# set operating system version
	case "${SPCD_OS_ID}" in
	"${SPCD_OS_ALMA}" | "${SPCD_OS_FEDORA}" | "${SPCD_OS_ROCKY}" | \
		"${SPCD_OS_ARCH}")
		SPCD_OS_VERSION=$(spcd_grep_os VERSION_ID |
			sed "s|^\([0-9]\+\)\..*|\1|")
		;;
	"${SPCD_OS_ALPINE}")
		SPCD_OS_VERSION=$(spcd_grep_os VERSION_ID |
			sed "s|^\([0-9]\+\.[0-9]\+\)\..*|\1|")
		;;
	"${SPCD_OS_DEBIAN}" | "${SPCD_OS_UBUNTU}")
		SPCD_OS_VERSION="$(spcd_grep_os VERSION_CODENAME)"
		;;
	*) ;;
	esac
	# check operating system version
	case "${SPCD_OS_ID}" in
	"${SPCD_OS_ALMA}" | "${SPCD_OS_ROCKY}")
		case "${SPCD_OS_VERSION}" in
		"9" | "8") ;;
		*) spcd_error_os "SPCD_OS_VERSION" ;;
		esac
		;;
	"${SPCD_OS_ALPINE}")
		case "${SPCD_OS_VERSION}" in
		"3.20" | "3.19") ;;
		*) spcd_error_os "SPCD_OS_VERSION" ;;
		esac
		;;
	"${SPCD_OS_ARCH}")
		case "${SPCD_OS_VERSION}" in
		"20240101" | "20231112") ;;
		*) spcd_error_os "SPCD_OS_VERSION" ;;
		esac
		;;
	"${SPCD_OS_DEBIAN}")
		case "${SPCD_OS_VERSION}" in
		"bullseye" | "bookworm") ;;
		*) spcd_error_os "SPCD_OS_VERSION" ;;
		esac
		;;
	"${SPCD_OS_FEDORA}")
		case "${SPCD_OS_VERSION}" in
		"40" | "39") ;;
		*) spcd_error_os "SPCD_OS_VERSION" ;;
		esac
		;;
	"${SPCD_OS_UBUNTU}")
		case "${SPCD_OS_VERSION}" in
		"noble" | "jammy") ;;
		*) spcd_error_os "SPCD_OS_VERSION" ;;
		esac
		;;
	*) ;;
	esac
	spcd_split
	spcd_echo "SPCD_OS_ID" "SPCD_OS_VERSION"
	# universal
	SPCD_DNS_FILE="/etc/resolv.conf"
	SPCD_PKG_CA="ca-certificates"
	SPCD_PKG_GIT="git"
	SPCD_PYTHON_ALIAS="python3"
	spcd_split
	spcd_echo "SPCD_DNS_FILE" "SPCD_PKG_CA" "SPCD_PKG_GIT" "SPCD_PYTHON_ALIAS"
	# set ca command & root
	case "${SPCD_OS_ID}" in
	"${SPCD_OS_ALMA}" | "${SPCD_OS_FEDORA}" | "${SPCD_OS_ROCKY}")
		SPCD_CA_ROOT="/etc/pki/ca-trust/source/anchors"
		SPCD_CMD_CA="update-ca-trust"
		;;
	"${SPCD_OS_ALPINE}")
		SPCD_CA_ROOT="/usr/local/share/ca-certificates"
		SPCD_CMD_CA="update-ca-certificates"
		;;
	"${SPCD_OS_ARCH}")
		SPCD_CA_ROOT="/etc/ca-certificates/trust-source/anchors"
		SPCD_CMD_CA="update-ca-trust"
		;;
	"${SPCD_OS_DEBIAN}" | "${SPCD_OS_UBUNTU}")
		SPCD_CA_ROOT="/usr/local/share/ca-certificates"
		SPCD_CMD_CA="update-ca-certificates"
		;;
	*) ;;
	esac
	spcd_split
	spcd_echo "SPCD_CA_ROOT" "SPCD_CMD_CA"
	# set package manager
	case "${SPCD_OS_ID}" in
	"${SPCD_OS_ALPINE}")
		SPCD_PM="${SPCD_PM_APK}"
		;;
	"${SPCD_OS_DEBIAN}" | "${SPCD_OS_UBUNTU}")
		SPCD_PM="${SPCD_PM_APT}"
		;;
	"${SPCD_OS_ALMA}" | "${SPCD_OS_FEDORA}" | "${SPCD_OS_ROCKY}")
		SPCD_PM="${SPCD_PM_DNF}"
		;;
	"${SPCD_OS_ARCH}")
		SPCD_PM="${SPCD_PM_PACMAN}"
		;;
	*) ;;
	esac
	spcd_split
	spcd_echo "SPCD_PM"
	case "${SPCD_PM}" in
	"${SPCD_PM_DNF}")
		SPCD_PM_CLEAN="dnf clean all"
		SPCD_PM_INSTALL="dnf install --assumeyes"
		SPCD_PM_QUERY="rpm --query"
		SPCD_PM_UPDATE="dnf makecache"
		SPCD_PM_UPGRADE="dnf upgrade --assumeyes"
		SPCD_PKG_PKG=""
		SPCD_PM_CONF_PATH="/etc/dnf/dnf.conf"
		SPCD_PM_CONF_TEXT="\
[main]
best=True
clean_requirements_on_remove=True
gpgcheck=1
installonly_limit=3
skip_if_unavailable=False
"
		SPCD_PM_HTTPS_PATH="/etc/dnf/dnf.conf.d/https.conf"
		SPCD_PM_HTTPS_TEXT="\
sslverify=False
"
		;;
	"${SPCD_PM_APK}")
		SPCD_PM_CLEAN="apk cache purge"
		SPCD_PM_INSTALL="apk add"
		SPCD_PM_QUERY="apk info"
		SPCD_PM_UPDATE="apk update"
		SPCD_PM_UPGRADE="apk upgrade"
		SPCD_PKG_PKG=""
		SPCD_PM_CONF_PATH=""
		SPCD_PM_CONF_TEXT=""
		SPCD_PM_HTTPS_PATH="/etc/apk/repositories.d/https"
		SPCD_PM_HTTPS_TEXT="\
--no-verify
"
		;;
	"${SPCD_PM_PACMAN}")
		SPCD_PM_CLEAN="pacman --sync --clean --noconfirm"
		SPCD_PM_INSTALL="pacman --sync --noconfirm"
		SPCD_PM_QUERY="pacman --query"
		SPCD_PM_UPDATE="pacman --sync --refresh"
		SPCD_PM_UPGRADE="pacman --sync --sysupgrade --noconfirm"
		SPCD_PKG_PKG=""
		SPCD_PM_CONF_PATH=""
		SPCD_PM_CONF_TEXT=""
		SPCD_PM_HTTPS_PATH="/etc/pacman.d/https.conf"
		SPCD_PM_HTTPS_TEXT="\
SSLVerify = No
"
		;;
	"${SPCD_PM_APT}")
		SPCD_PM_CLEAN="apt-get clean"
		SPCD_PM_INSTALL="apt-get install --assume-yes"
		SPCD_PM_QUERY="dpkg-query --show"
		SPCD_PM_UPDATE="apt-get update"
		SPCD_PM_UPGRADE="apt-get upgrade --assume-yes"
		SPCD_PKG_PKG="apt-utils"
		SPCD_PM_CONF_PATH="/etc/apt/apt.conf.d/apt.conf"
		SPCD_PM_CONF_TEXT="\
Acquire::Check-Valid-Until True;
APT::Get::Show-Versions True;
APT::Install-Recommends False;
APT::Install-Suggests False;
Dir::Etc::SourceParts \"\";
"
		SPCD_PM_HTTPS_PATH="/etc/apt/apt.conf.d/https"
		SPCD_PM_HTTPS_TEXT="\
Acquire::https::Verify-Peer False;
"
		;;
	*) ;;
	esac
	spcd_split
	spcd_echo "SPCD_PM_CLEAN" \
		"SPCD_PM_INSTALL" "SPCD_PM_QUERY" "SPCD_PM_UPDATE" "SPCD_PM_UPGRADE"
	spcd_split
	spcd_echo "SPCD_PKG_PKG" "SPCD_PM_CONF_PATH" "SPCD_PM_HTTPS_PATH"
	# specific
	case "${SPCD_OS_ID}" in
	"${SPCD_OS_ALMA}")
		SPCD_URL_DEFAULT="https://repo.almalinux.org/almalinux"
		;;
	"${SPCD_OS_ALPINE}")
		SPCD_URL_DEFAULT="https://dl-cdn.alpinelinux.org/alpine"
		;;
	"${SPCD_OS_ARCH}")
		SPCD_URL_DEFAULT="https://geo.mirror.pkgbuild.com"
		;;
	"${SPCD_OS_DEBIAN}")
		SPCD_URL_DEFAULT="http://deb.debian.org/debian"
		;;
	"${SPCD_OS_FEDORA}")
		SPCD_URL_DEFAULT="http://download.example/pub/fedora/linux/releases"
		;;
	"${SPCD_OS_ROCKY}")
		SPCD_URL_DEFAULT="http://dl.rockylinux.org/\$contentdir"
		;;
	"${SPCD_OS_UBUNTU}")
		SPCD_URL_DEFAULT="http://archive.ubuntu.com/ubuntu"
		;;
	*) ;;
	esac
	SPCD_URL_CHOSEN="${SPCD_URL_DEFAULT}"
	case "${SPCD_OS_ID}" in
	"${SPCD_OS_ALMA}")
		[ -n "${SPCD_URL_ALMA}" ] && SPCD_URL_CHOSEN="${SPCD_URL_ALMA}"
		;;
	"${SPCD_OS_ALPINE}")
		[ -n "${SPCD_URL_ALPINE}" ] && SPCD_URL_CHOSEN="${SPCD_URL_ALPINE}"
		;;
	"${SPCD_OS_ARCH}")
		[ -n "${SPCD_URL_ARCH}" ] && SPCD_URL_CHOSEN="${SPCD_URL_ARCH}"
		;;
	"${SPCD_OS_DEBIAN}")
		[ -n "${SPCD_URL_DEBIAN}" ] && SPCD_URL_CHOSEN="${SPCD_URL_DEBIAN}" ||
			SPCD_URL_CHOSEN="https://deb.debian.org/debian"
		;;
	"${SPCD_OS_FEDORA}")
		[ -n "${SPCD_URL_FEDORA}" ] && SPCD_URL_CHOSEN="${SPCD_URL_FEDORA}" ||
			SPCD_URL_CHOSEN="https://rpmfind.net/linux/fedora/linux/releases"
		;;
	"${SPCD_OS_ROCKY}")
		[ -n "${SPCD_URL_ROCKY}" ] && SPCD_URL_CHOSEN="${SPCD_URL_ROCKY}" ||
			SPCD_URL_CHOSEN="https://dl.rockylinux.org/\$contentdir"
		;;
	"${SPCD_OS_UBUNTU}")
		[ -n "${SPCD_URL_UBUNTU}" ] && SPCD_URL_CHOSEN="${SPCD_URL_UBUNTU}" ||
			SPCD_URL_CHOSEN="https://ubuntu.mirrors.ovh.net/ubuntu"
		;;
	*) ;;
	esac
	spcd_split
	spcd_echo "SPCD_URL_DEFAULT" "SPCD_URL_CHOSEN"
	# set python command & package
	case "${SPCD_OS_ID}" in
	"${SPCD_OS_ALMA}" | "${SPCD_OS_ROCKY}")
		SPCD_PYTHON_COMMAND="python3.12"
		SPCD_PYTHON_PACKAGE="python3.12"
		;;
	"${SPCD_OS_ALPINE}")
		case "${SPCD_OS_VERSION}" in
		"3.20") SPCD_PYTHON_COMMAND="python3.12" ;;
		"3.19") SPCD_PYTHON_COMMAND="python3.11" ;;
		*) ;;
		esac
		SPCD_PYTHON_PACKAGE="python3"
		;;
	"${SPCD_OS_ARCH}")
		SPCD_PYTHON_COMMAND="python3.12"
		SPCD_PYTHON_PACKAGE="python"
		;;
	"${SPCD_OS_DEBIAN}")
		case "${SPCD_OS_VERSION}" in
		"bookworm") SPCD_PYTHON_COMMAND="python3.11" ;;
		"bullseye") SPCD_PYTHON_COMMAND="python3.9" ;;
		*) ;;
		esac
		SPCD_PYTHON_PACKAGE="python3"
		;;
	"${SPCD_OS_FEDORA}")
		SPCD_PYTHON_COMMAND="python3.12"
		SPCD_PYTHON_PACKAGE="python3"
		;;
	"${SPCD_OS_UBUNTU}")
		case "${SPCD_OS_VERSION}" in
		"noble") SPCD_PYTHON_COMMAND="python3.12" ;;
		"jammy") SPCD_PYTHON_COMMAND="python3.10" ;;
		*) ;;
		esac
		SPCD_PYTHON_PACKAGE="python3"
		;;
	*) ;;
	esac
	spcd_split
	spcd_echo "SPCD_PYTHON_COMMAND" "SPCD_PYTHON_PACKAGE"
	# set python packages
	case "${SPCD_OS_ID}" in
	"${SPCD_OS_ALMA}" | "${SPCD_OS_FEDORA}" | "${SPCD_OS_ROCKY}")
		SPCD_PYTHON_PACKAGES="/usr/lib64/${SPCD_PYTHON_COMMAND}/site-packages"
		;;
	"${SPCD_OS_ALPINE}" | "${SPCD_OS_ARCH}")
		SPCD_PYTHON_PACKAGES="/usr/lib/${SPCD_PYTHON_COMMAND}/site-packages"
		;;
	"${SPCD_OS_DEBIAN}" | "${SPCD_OS_UBUNTU}")
		SPCD_PYTHON_PACKAGES="/usr/lib/${SPCD_PYTHON_ALIAS}/dist-packages"
		;;
	*) ;;
	esac
	SPCD_PYTHON_VENV_PACKAGES="\
${SPCD_PYTHON_VENV}/lib/${SPCD_PYTHON_COMMAND}/site-packages"
	spcd_split
	spcd_echo "SPCD_PYTHON_PACKAGES" "SPCD_PYTHON_VENV_PACKAGES"
	# variables
	[ -n "${SPCD_CA_1}" ] && SPCD_CA=true
	#
	spcd_split
	spcd_echo "SPCD_CA"
}

spcd_list_working_directory() {
	spcd_step "List working directory"
	spcd_lwd__path="$(realpath .)"
	spcd_ls "${spcd_lwd__path}"
}

spcd_set_packages_repositories() {
	spcd_step "Set packages repositories"
	case "${SPCD_OS_ID}" in
	"${SPCD_OS_ALMA}")
		case "${SPCD_OS_VERSION}" in
		"8") spcd_spr__file="/etc/yum.repos.d/almalinux.repo" ;;
		"9") spcd_spr__file="/etc/yum.repos.d/almalinux-baseos.repo" ;;
		*) ;;
		esac
		spcd_sed "${spcd_spr__file}" \
			"|^mirrorlist|# mirrorlist|" \
			"|${SPCD_URL_DEFAULT}|${SPCD_URL_CHOSEN}|" \
			"|^# baseurl|baseurl|"
		;;
	"${SPCD_OS_ALPINE}")
		spcd_spr__file="/etc/apk/repositories"
		spcd_write "${spcd_spr__file}" "\
${SPCD_URL_CHOSEN}/v${SPCD_OS_VERSION}/main
${SPCD_URL_CHOSEN}/v${SPCD_OS_VERSION}/community
"
		;;
	"${SPCD_OS_DEBIAN}")
		spcd_spr__file="/etc/apt/sources.list"
		spcd_write "${spcd_spr__file}" "\
deb ${SPCD_URL_CHOSEN} ${SPCD_OS_VERSION} main
deb ${SPCD_URL_CHOSEN} ${SPCD_OS_VERSION}-backports main
deb ${SPCD_URL_CHOSEN} ${SPCD_OS_VERSION}-updates main
deb ${SPCD_URL_CHOSEN}-security ${SPCD_OS_VERSION}-security main
"
		;;
	"${SPCD_OS_ROCKY}")
		case "${SPCD_OS_VERSION}" in
		"8") spcd_spr__file="/etc/yum.repos.d/Rocky-BaseOS.repo" ;;
		"9") spcd_spr__file="/etc/yum.repos.d/rocky.repo" ;;
		*) ;;
		esac
		spcd_sed "${spcd_spr__file}" \
			"|^mirrorlist|# mirrorlist|" \
			"|${SPCD_URL_DEFAULT}|${SPCD_URL_CHOSEN}|" \
			"|^#baseurl|baseurl|"
		;;
	"${SPCD_OS_UBUNTU}")
		spcd_spr__file="/etc/apt/sources.list"
		spcd_write "${spcd_spr__file}" "\
deb ${SPCD_URL_CHOSEN} ${SPCD_OS_VERSION} main universe
deb ${SPCD_URL_CHOSEN} ${SPCD_OS_VERSION}-backports main universe
deb ${SPCD_URL_CHOSEN} ${SPCD_OS_VERSION}-updates main universe
deb ${SPCD_URL_CHOSEN} ${SPCD_OS_VERSION}-security main universe
"
		;;
	*) ;;
	esac
}

spcd_set_packages_configuration() {
	spcd_step "Set packages configuration"
	spcd_write "${SPCD_PM_CONF_PATH}" "${SPCD_PM_CONF_TEXT}"
	case "${SPCD_OS_ID}" in
	"${SPCD_OS_DEBIAN}" | "${SPCD_OS_UBUNTU}")
		export DEBIAN_FRONTEND="noninteractive"
		;;
	*) ;;
	esac
}

# agnostic steps

spcd_set_https_verification_off() {
	if [ -n "${SPCD_CA}" ] || [ "${SPCD_PM}" = "${SPCD_PM_APT}" ]; then
		spcd_step "Set HTTPS verification off"
		spcd_mkdir "$(dirname "${SPCD_PM_HTTPS_PATH}")"
		spcd_write "${SPCD_PM_HTTPS_PATH}" "${SPCD_PM_HTTPS_TEXT}"
	fi
}

spcd_set_dns_resolving() {
	spcd_step "Set DNS resolving"
	while true; do
		spcd_sdr__index=$((spcd_sdr__index + 1))
		eval "spcd_sdr__value=\"\${SPCD_DNS_${spcd_sdr__index}}\""
		[ -n "${spcd_sdr__value}" ] || break
		spcd_sdr__text="${spcd_sdr__text}\
nameserver ${spcd_sdr__value}
"
	done
	spcd_write "${SPCD_DNS_FILE}" "${spcd_sdr__text}"
}

spcd_update_packages_catalog() {
	spcd_step "Update packages catalog"
	${SPCD_PM_UPDATE} || exit
}

spcd_install_packages_tools() {
	spcd_step "Install packages tools"
	spcd_install_package "${SPCD_PKG_PKG}"
}

spcd_install_ca_certificates() {
	spcd_step "Install CA"
	spcd_install_package "${SPCD_PKG_CA}"
}

spcd_write_ca_certificates() {
	spcd_step "Write CA certificates"
	spcd_mkdir "${SPCD_CA_ROOT}"
	while true; do
		spcd_wcc__index=$((spcd_wcc__index + 1))
		eval "spcd_wcc__text=\"\${SPCD_CA_${spcd_wcc__index}}\""
		[ -n "${spcd_wcc__text}" ] || break
		spcd_wcc__path="${SPCD_CA_ROOT}/${spcd_wcc__index}.crt"
		spcd_split
		spcd_write "${spcd_wcc__path}" "${spcd_wcc__text}"
		spcd_openssl "${spcd_wcc__path}"
	done
}

spcd_update_ca_certificates() {
	spcd_step "Update CA certificates"
	${SPCD_CMD_CA} || exit
}

spcd_set_https_verification_on() {
	spcd_step "Set HTTPS verification on"
	spcd_rm "${SPCD_PM_HTTPS_PATH}"
}

spcd_upgrade_packages() {
	spcd_step "Upgrade packages"
	${SPCD_PM_UPGRADE} || exit
}

spcd_install_git() {
	spcd_step "Install Git"
	spcd_install_package "${SPCD_PKG_GIT}"
}

spcd_install_python() {
	spcd_step "Install Python"
	spcd_install_package "${SPCD_PYTHON_PACKAGE}"
	spcd_split
	spcd_ln_python "${SPCD_PYTHON_COMMAND}"
}

# TODO move to Python
spcd_install_packages() {
	# dos2unix
	spcd_step "Install dos2unix"
	spcd_install_package "dos2unix"
	# epel
	spcd_step "Install EPEL"
	case "${SPCD_OS_ID}" in
	"${SPCD_OS_ALMA}" | "${SPCD_OS_ROCKY}")
		spcd_install_package "epel-release"
		[ -n "${SPCD_URL_EPEL}" ] && spcd_ip__epel="${SPCD_URL_EPEL}" ||
			spcd_ip__epel="https://dl.fedoraproject.org"
		spcd_sed "/etc/yum.repos.d/epel.repo" \
			"|^metalink|# metalink|" \
			"|https://download.example|${spcd_ip__epel}|" \
			"|^#baseurl|baseurl|"
		;;
	*) ;;
	esac
	# graphviz
	spcd_step "Install GraphViz"
	spcd_install_package "graphviz"
	# plantuml
	spcd_step "Install PlantUML"
	spcd_install_package "plantuml"
	# rsync
	spcd_step "Install Rsync"
	spcd_install_package "rsync"
	# shell check
	spcd_step "Install ShellCheck"
	case "${SPCD_PM}" in
	"${SPCD_PM_DNF}") spcd_install_package "ShellCheck" ;;
	*) spcd_install_package "shellcheck" ;;
	esac
	# shfmt
	spcd_step "Install ShellFormat"
	case "${SPCD_OS_ID}" in
	"${SPCD_OS_ALMA}" | "${SPCD_OS_ROCKY}") ;;
	"${SPCD_OS_DEBIAN}")
		[ "${SPCD_OS_VERSION}" != "bullseye" ] && spcd_install_package "shfmt"
		;;
	*) spcd_install_package "shfmt" ;;
	esac
	# ssh
	spcd_step "Install SSH"
	case "${SPCD_PM}" in
	"${SPCD_PM_APK}" | "${SPCD_PM_APT}")
		spcd_install_package "openssh-client"
		;;
	"${SPCD_PM_DNF}") spcd_install_package "openssh-clients" ;;
	"${SPCD_PM_PACMAN}") spcd_install_package "openssh" ;;
	*) ;;
	esac
	# venv
	spcd_step "Install Python virtual environment"
	case "${SPCD_OS_ID}" in
	"${SPCD_OS_DEBIAN}" | "${SPCD_OS_UBUNTU}")
		spcd_install_package "python3-venv"
		;;
	"${SPCD_OS_ARCH}")
		# FIXME arch
		exit 255
		;;
	*) ;;
	esac
	spcd_split
	spcd_write "/etc/pip.conf" "\
[global]
index-url = ${SPCD_URL_PYTHON}
"
	spcd_split
	"${SPCD_PYTHON_ALIAS}" -m "venv" "${SPCD_PYTHON_VENV}"
	spcd_split
	. "${SPCD_PYTHON_VENV}/bin/activate"
	spcd_split
	pip install --upgrade "pip"
	spcd_split
	pip install \
		"pelican" \
		"ruff" \
		"sphinx" "sphinx-rtd-theme"
}

spcd_install_python_modules() {
	spcd_step "Install Python modules"
	spcd_ipm__root="$(mktemp --directory)" || exit
	spcd_ipm__target="${SPCD_PYTHON_VENV_PACKAGES}"
	echo "→ ${spcd_ipm__root}"
	for spcd_ipm__repository in "${SPCD_GIT_MAIN}" "${SPCD_GIT_ROOT}"; do
		case "${spcd_ipm__repository}" in
		http*) spcd_ipm__url="${spcd_ipm__repository}" ;;
		*/*) spcd_ipm__url="${SPCD_PROJECT_ROOT}/${spcd_ipm__repository}" ;;
		*) spcd_ipm__url="\
${SPCD_PROJECT_ROOT}/${SPCD_PROJECT_PATH}/${spcd_ipm__repository}" ;;
		esac
		spcd_ipm__name="$(basename "${spcd_ipm__url}")"
		spcd_split
		echo "\
${spcd_ipm__url}
↓"
		git clone \
			"${spcd_ipm__url}" \
			"${spcd_ipm__root}/${spcd_ipm__name}" ||
			exit
		spcd_ipm__path="${spcd_ipm__root}/${spcd_ipm__name}/${spcd_ipm__name}"
		echo "\
${spcd_ipm__path}
↓
${spcd_ipm__target}"
		cp --recursive "${spcd_ipm__path}" "${spcd_ipm__target}" ||
			exit
		# check matching of file and variable
		spcd_ipm__script="${spcd_ipm__root}/${spcd_ipm__name}/spcd.sh"
		if [ -f "${spcd_ipm__script}" ]; then
			spcd_split
			spcd_ipm__check="${spcd_ipm__root}/check.sha512sum"
			sha512sum "${spcd_ipm__script}" >"${spcd_ipm__check}"
			printf "%s" "${SPCD}" >"${spcd_ipm__script}"
			ls -l "${spcd_ipm__script}"
			dos2unix "${spcd_ipm__script}"
			ls -l "${spcd_ipm__script}"
			sha512sum -c "${spcd_ipm__check}" || spcd_error_ci "SPCD"
		fi
	done
	spcd_split
	spcd_ls "${spcd_ipm__target}"
	spcd_split
	spcd_rm "${spcd_ipm__root}"
}

spcd_write_python_module() {
	spcd_step "Write Python module"
	for spcd_wpm__variable in \
		OS_ID OS_VERSION \
		PROJECT_ROOT PROJECT_PATH PROJECT_NAME \
		PYTHON_VENV_BINARIES PYTHON_VENV_PACKAGES \
		OPEN DOWN VERT SPLT __UP SHUT; do
		spcd_wpm__value="$(spcd_echo "SPCD_${spcd_wpm__variable}")"
		spcd_wpm__text="${spcd_wpm__text}${spcd_wpm__value}
"
	done
	for spcd_wpm__root in \
		"${SPCD_PYTHON_PACKAGES}" "${SPCD_PYTHON_VENV_PACKAGES}"; do
		spcd_write "${spcd_wpm__root}/env.py" "${spcd_wpm__text}
SPCD_STEP = $((SPCD_STEP + 1))
"
	done
}

spcd_switch_to_python() {
	spcd_step "Switch to Python"
	spcd_stp__name="$(basename "${SPCD_GIT_MAIN}")"
	echo "\
${SPCD_PATH}
↓
${SPCD_PYTHON_ALIAS} / ${spcd_stp__name}"
	"${SPCD_PYTHON_ALIAS}" -m "${spcd_stp__name}"
}

# functions

spcd_cat() {
	spcd_cat__file="${1}"
	if [ -n "${spcd_cat__file}" ]; then
		spcd_open "${spcd_cat__file}"
		cat "${spcd_cat__file}" || exit
		spcd_shut "${spcd_cat__file}"
	fi
}

spcd_echo() {
	if [ -n "${1}" ]; then
		for spcd_echo__name in "${@}"; do
			spcd_echo__text=""
			eval "spcd_echo__text=\"\${${spcd_echo__name}}\""
			echo "${spcd_echo__name} = \"${spcd_echo__text}\""
		done
	fi
}

spcd_error_ci() {
	echo "× CI: ${*}"
	exit "${SPCD_ERROR_CI}"
}

spcd_error_os() {
	spcd_error_os__variable="${1}"
	printf "× OS: "
	spcd_echo "${spcd_error_os__variable}"
	exit "${SPCD_ERROR_OS}"
}

spcd_grep_os() {
	spcd_grep_os__variable="${1}"
	[ -n "${spcd_grep_os__variable}" ] &&
		grep "^${spcd_grep_os__variable}=" "/etc/os-release" |
		sed "s|^${spcd_grep_os__variable}=||" |
			sed "s|^\"\(.*\)\"$|\1|"
}

spcd_install_package() {
	spcd_install_package__name="${1}"
	if [ -n "${spcd_install_package__name}" ]; then
		${SPCD_PM_INSTALL} "${spcd_install_package__name}" || exit
		${SPCD_PM_CLEAN} || exit
	fi
}

spcd_ln_python() {
	spcd_ln_python__command="${1}"
	if [ -n "${spcd_ln_python__command}" ]; then
		echo "→ ${SPCD_PYTHON_ALIAS} → ${spcd_ln_python__command}"
		ln -f -s "${spcd_ln_python__command}" \
			"/usr/bin/${SPCD_PYTHON_ALIAS}" || exit
	fi
}

spcd_ls() {
	spcd_ls__path="${1}"
	if [ -n "${spcd_ls__path}" ]; then
		spcd_open "${spcd_ls__path}"
		ls -a -l "${spcd_ls__path}" || exit
		spcd_shut "${spcd_ls__path}"
	fi
}

spcd_mkdir() {
	spcd_mkdir__path="${1}"
	if [ -n "${spcd_mkdir__path}" ]; then
		echo "→ ${spcd_mkdir__path}"
		mkdir --parents "${spcd_mkdir__path}" || exit
	fi
}

spcd_open() {
	echo "${SPCD_OPEN}${*}"
}

spcd_openssl() {
	spcd_openssl__file="${1}"
	if [ -f "${spcd_openssl__file}" ]; then
		openssl x509 \
			-in "${spcd_openssl__file}" \
			-noout -text ||
			exit
	fi
}

spcd_rm() {
	spcd_rm__path="${1}"
	if [ -e "${spcd_rm__path}" ]; then
		echo "← ${spcd_rm__path}"
		rm -r "${spcd_rm__path}" || exit
	fi
}

spcd_sed() {
	spcd_sed__file="${1}"
	shift
	if [ -f "${spcd_sed__file}" ]; then
		spcd_cat "${spcd_sed__file}"
		for spcd_sed__regex in "${@}"; do
			sed --in-place "s${spcd_sed__regex}g" "${spcd_sed__file}" &&
				spcd_cat "${spcd_sed__file}" || exit
		done
	fi
}

spcd_shut() {
	echo "${SPCD_SHUT}${*}"
}

spcd_split() {
	echo "${SPCD_SPLT}"
}

spcd_step() {
	SPCD_STEP=$((SPCD_STEP + 1))
	echo "\
${SPCD_DOWN}
${SPCD_VERT} ${SPCD_STEP} ${*}
${SPCD___UP}"
}

spcd_write() {
	spcd_write__file="${1}"
	spcd_write__text="${2}"
	if [ -n "${spcd_write__file}" ]; then
		[ -f "${spcd_write__file}" ] && spcd_cat "${spcd_write__file}"
		echo "→ ${spcd_write__file}"
		printf "%s" "${spcd_write__text}" >"${spcd_write__file}" || exit
		spcd_cat "${spcd_write__file}"
	fi
}

# constants

SPCD_BOX_DOWN="╭"
SPCD_BOX_LEFT="╴"
SPCD_BOX_RIGHT="╶"
SPCD_BOX_UP="╰"
SPCD_BOX_VERTICAL="│"

SPCD_ERROR_CI=1
SPCD_ERROR_OS=2

SPCD_OS_ALMA="alma"
SPCD_OS_ALPINE="alpine"
SPCD_OS_ARCH="arch"
SPCD_OS_DEBIAN="debian"
SPCD_OS_FEDORA="fedora"
SPCD_OS_ROCKY="rocky"
SPCD_OS_UBUNTU="ubuntu"

SPCD_PM_APK="apk"
SPCD_PM_APT="apt"
SPCD_PM_DNF="dnf"
SPCD_PM_PACMAN="pacman"

SPCD_PYTHON_VENV="/opt/venv"
SPCD_PYTHON_VENV_BINARIES="${SPCD_PYTHON_VENV}/bin"

SPCD_HORIZONTAL="────╌╌╌╌┄┄┄┄┈┈┈┈"

SPCD_OPEN="${SPCD_BOX_DOWN}${SPCD_BOX_LEFT}"
SPCD_DOWN="${SPCD_BOX_DOWN}${SPCD_HORIZONTAL}"
SPCD_VERT="${SPCD_BOX_VERTICAL}"
SPCD_SPLT="${SPCD_BOX_RIGHT}${SPCD_HORIZONTAL}"
SPCD___UP="${SPCD_BOX_UP}${SPCD_HORIZONTAL}"
SPCD_SHUT="${SPCD_BOX_UP}${SPCD_BOX_LEFT}"

# run
spcd_main