spcd/pidd.sh

#! /usr/bin/env sh

# defaults
[ -n "${PIDD_DNS}" ] || PIDD_DNS="\
9.9.9.9 \
"
[ -n "${PIDD_GIT_MAIN}" ] || PIDD_GIT_MAIN="pidd"
[ -n "${PIDD_GIT_ROOT}" ] || PIDD_GIT_ROOT="rwx"

# main
pidd_main() {
	pidd_list_environment_variables
	pidd_list_working_directory
	#
	pidd_set_environment_variables
	pidd_set_packages_repositories
	pidd_set_packages_configuration
	#
	pidd_set_https_verification_off
	pidd_set_dns_resolving
	pidd_update_packages_catalog
	pidd_install_packages_tools
	pidd_install_ca_certificates
	pidd_write_ca_certificates
	pidd_update_ca_certificates
	pidd_set_https_verification_on
	pidd_update_packages_catalog
	pidd_upgrade_packages
	pidd_install_git
	pidd_install_python
	# TODO move to Python
	pidd_install_rsync
	# TODO move to Python
	pidd_install_ssh
	pidd_clean_packages_cache
	pidd_install_python_modules
	pidd_write_python_module
	pidd_switch_to_python "${@}"
}

# context

pidd_list_environment_variables() {
	pidd_step "List environment variables"
	env | sort
}

pidd_list_working_directory() {
	pidd_step "List working directory"
	pidd_lwd__path="$(realpath .)"
	pidd_ls "${pidd_lwd__path}"
}

# steps

pidd_set_environment_variables() {
	pidd_step "Set environment variables"
	# set path
	PIDD_PATH="$(realpath "${0}")"
	pidd_echo "PIDD_PATH"
	# set operating system id
	PIDD_OS_ID="$(pidd_grep_os ID)"
	case "${PIDD_OS_ID}" in
	"almalinux") PIDD_OS_ID="${PIDD_OS_ALMA}" ;;
	"alpine") PIDD_OS_ID="${PIDD_OS_ALPINE}" ;;
	"arch") PIDD_OS_ID="${PIDD_OS_ARCH}" ;;
	"debian") PIDD_OS_ID="${PIDD_OS_DEBIAN}" ;;
	"fedora") PIDD_OS_ID="${PIDD_OS_FEDORA}" ;;
	"rocky") PIDD_OS_ID="${PIDD_OS_ROCKY}" ;;
	"ubuntu") PIDD_OS_ID="${PIDD_OS_UBUNTU}" ;;
	*) pidd_error_os "PIDD_OS_ID" ;;
	esac
	# set operating system version
	case "${PIDD_OS_ID}" in
	"${PIDD_OS_ALMA}" | "${PIDD_OS_ARCH}" | "${PIDD_OS_FEDORA}" | "${PIDD_OS_ROCKY}")
		PIDD_OS_VERSION=$(pidd_grep_os VERSION_ID |
			sed "s|^\([0-9]\+\)\..*|\1|")
		;;
	"${PIDD_OS_ALPINE}")
		PIDD_OS_VERSION=$(pidd_grep_os VERSION_ID |
			sed "s|^\([0-9]\+\.[0-9]\+\)\..*|\1|")
		;;
	"${PIDD_OS_DEBIAN}" | "${PIDD_OS_UBUNTU}")
		PIDD_OS_VERSION="$(pidd_grep_os VERSION_CODENAME)"
		;;
	*) ;;
	esac
	# check operating system version
	case "${PIDD_OS_ID}" in
	"${PIDD_OS_ALMA}" | "${PIDD_OS_ROCKY}")
		case "${PIDD_OS_VERSION}" in
		"8" | "9") ;;
		*) pidd_error_os "PIDD_OS_VERSION" ;;
		esac
		;;
	"${PIDD_OS_ALPINE}")
		case "${PIDD_OS_VERSION}" in
		"3.18" | "3.19") ;;
		*) pidd_error_os "PIDD_OS_VERSION" ;;
		esac
		;;
	"${PIDD_OS_ARCH}")
		case "${PIDD_OS_VERSION}" in
		"20231112" | "20240101") ;;
		*) pidd_error_os "PIDD_OS_VERSION" ;;
		esac
		;;
	"${PIDD_OS_DEBIAN}")
		case "${PIDD_OS_VERSION}" in
		"bookworm" | "bullseye") ;;
		*) pidd_error_os "PIDD_OS_VERSION" ;;
		esac
		;;
	"${PIDD_OS_FEDORA}")
		case "${PIDD_OS_VERSION}" in
		"39" | "40") ;;
		*) pidd_error_os "PIDD_OS_VERSION" ;;
		esac
		;;
	"${PIDD_OS_UBUNTU}")
		case "${PIDD_OS_VERSION}" in
		"jammy" | "noble") ;;
		*) pidd_error_os "PIDD_OS_VERSION" ;;
		esac
		;;
	*) ;;
	esac
	pidd_split
	pidd_echo "PIDD_OS_ID" "PIDD_OS_VERSION"
	# universal
	PIDD_DNS_FILE="/etc/resolv.conf"
	PIDD_PKG_CA="ca-certificates"
	PIDD_PKG_GIT="git"
	# TODO move to Python
	PIDD_PKG_RSYNC="rsync"
	PIDD_PYTHON_ALIAS="python3"
	pidd_split
	pidd_echo "PIDD_DNS_FILE" "PIDD_PKG_CA" "PIDD_PKG_GIT" "PIDD_PYTHON_ALIAS"
	# set ca command & root
	case "${PIDD_OS_ID}" in
	"${PIDD_OS_ALMA}" | "${PIDD_OS_FEDORA}" | "${PIDD_OS_ROCKY}")
		PIDD_CA_ROOT="/etc/pki/ca-trust/source/anchors"
		PIDD_CMD_CA="update-ca-trust"
		;;
	"${PIDD_OS_ALPINE}")
		PIDD_CA_ROOT="/usr/local/share/ca-certificates"
		PIDD_CMD_CA="update-ca-certificates"
		;;
	"${PIDD_OS_ARCH}")
		PIDD_CA_ROOT="/etc/ca-certificates/trust-source/anchors"
		PIDD_CMD_CA="update-ca-trust"
		;;
	"${PIDD_OS_DEBIAN}" | "${PIDD_OS_UBUNTU}")
		PIDD_CA_ROOT="/usr/local/share/ca-certificates"
		PIDD_CMD_CA="update-ca-certificates"
		;;
	*) ;;
	esac
	pidd_split
	pidd_echo "PIDD_CA_ROOT" "PIDD_CMD_CA"
	# set package manager
	case "${PIDD_OS_ID}" in
	"${PIDD_OS_ALPINE}")
		PIDD_PM="${PIDD_PM_APK}"
		;;
	"${PIDD_OS_DEBIAN}" | "${PIDD_OS_UBUNTU}")
		PIDD_PM="${PIDD_PM_APT}"
		;;
	"${PIDD_OS_ALMA}" | "${PIDD_OS_FEDORA}" | "${PIDD_OS_ROCKY}")
		PIDD_PM="${PIDD_PM_DNF}"
		;;
	"${PIDD_OS_ARCH}")
		PIDD_PM="${PIDD_PM_PACMAN}"
		;;
	*) ;;
	esac
	pidd_split
	pidd_echo "PIDD_PM"
	case "${PIDD_PM}" in
	"${PIDD_PM_DNF}")
		PIDD_PM_CLEAN="dnf clean all"
		PIDD_PM_INSTALL="dnf install --assumeyes"
		PIDD_PM_QUERY="rpm --query"
		PIDD_PM_UPDATE="dnf makecache"
		PIDD_PM_UPGRADE="dnf upgrade --assumeyes"
		PIDD_PKG_PKG=""
		PIDD_PM_CONF_PATH="/etc/dnf/dnf.conf"
		PIDD_PM_CONF_TEXT="\
[main]
best=True
clean_requirements_on_remove=True
gpgcheck=1
installonly_limit=3
skip_if_unavailable=False
"
		PIDD_PM_HTTPS_PATH="/etc/dnf/dnf.conf.d/https.conf"
		PIDD_PM_HTTPS_TEXT="\
sslverify=False
"
		;;
	"${PIDD_PM_APK}")
		PIDD_PM_CLEAN="apk cache purge"
		PIDD_PM_INSTALL="apk add"
		PIDD_PM_QUERY="apk info"
		PIDD_PM_UPDATE="apk update"
		PIDD_PM_UPGRADE="apk upgrade"
		PIDD_PKG_PKG=""
		PIDD_PM_CONF_PATH=""
		PIDD_PM_CONF_TEXT=""
		PIDD_PM_HTTPS_PATH="/etc/apk/repositories.d/https"
		PIDD_PM_HTTPS_TEXT="\
--no-verify
"
		;;
	"${PIDD_PM_PACMAN}")
		PIDD_PM_CLEAN="pacman --sync --clean --noconfirm"
		PIDD_PM_INSTALL="pacman --sync --noconfirm"
		PIDD_PM_QUERY="pacman --query"
		PIDD_PM_UPDATE="pacman --sync --refresh"
		PIDD_PM_UPGRADE="pacman --sync --sysupgrade --noconfirm"
		PIDD_PKG_PKG=""
		PIDD_PM_CONF_PATH=""
		PIDD_PM_CONF_TEXT=""
		PIDD_PM_HTTPS_PATH="/etc/pacman.d/https.conf"
		PIDD_PM_HTTPS_TEXT="\
SSLVerify = No
"
		;;
	"${PIDD_PM_APT}")
		PIDD_PM_CLEAN="apt-get clean"
		PIDD_PM_INSTALL="apt-get install --assume-yes"
		PIDD_PM_QUERY="dpkg-query --show"
		PIDD_PM_UPDATE="apt-get update"
		PIDD_PM_UPGRADE="apt-get upgrade --assume-yes"
		PIDD_PKG_PKG="apt-utils"
		PIDD_PM_CONF_PATH="/etc/apt/apt.conf.d/apt.conf"
		PIDD_PM_CONF_TEXT="\
Acquire::Check-Valid-Until True;
APT::Get::Show-Versions True;
APT::Install-Recommends False;
APT::Install-Suggests False;
Dir::Etc::SourceParts \"\";
"
		PIDD_PM_HTTPS_PATH="/etc/apt/apt.conf.d/https"
		PIDD_PM_HTTPS_TEXT="\
Acquire::https::Verify-Peer False;
"
		;;
	*) ;;
	esac
	pidd_split
	pidd_echo "PIDD_PM_CLEAN" \
		"PIDD_PM_INSTALL" "PIDD_PM_QUERY" "PIDD_PM_UPDATE" "PIDD_PM_UPGRADE"
	pidd_split
	pidd_echo "PIDD_PKG_PKG" "PIDD_PM_CONF_PATH" "PIDD_PM_HTTPS_PATH"
	# specific
	case "${PIDD_OS_ID}" in
	"${PIDD_OS_ALMA}")
		PIDD_URL_DEFAULT="https://repo.almalinux.org/almalinux"
		;;
	"${PIDD_OS_ALPINE}")
		PIDD_URL_DEFAULT="https://dl-cdn.alpinelinux.org/alpine"
		;;
	"${PIDD_OS_ARCH}")
		PIDD_URL_DEFAULT="https://geo.mirror.pkgbuild.com"
		;;
	"${PIDD_OS_DEBIAN}")
		PIDD_URL_DEFAULT="http://deb.debian.org/debian"
		;;
	"${PIDD_OS_FEDORA}")
		PIDD_URL_DEFAULT="http://download.example/pub/fedora/linux/releases"
		;;
	"${PIDD_OS_ROCKY}")
		PIDD_URL_DEFAULT="http://dl.rockylinux.org/\$contentdir"
		;;
	"${PIDD_OS_UBUNTU}")
		PIDD_URL_DEFAULT="http://archive.ubuntu.com/ubuntu"
		;;
	*) ;;
	esac
	PIDD_URL_CHOSEN="${PIDD_URL_DEFAULT}"
	case "${PIDD_OS_ID}" in
	"${PIDD_OS_ALMA}")
		[ -n "${PIDD_URL_ALMA}" ] && PIDD_URL_CHOSEN="${PIDD_URL_ALMA}"
		;;
	"${PIDD_OS_ALPINE}")
		[ -n "${PIDD_URL_ALPINE}" ] && PIDD_URL_CHOSEN="${PIDD_URL_ALPINE}"
		;;
	"${PIDD_OS_ARCH}")
		[ -n "${PIDD_URL_ARCH}" ] && PIDD_URL_CHOSEN="${PIDD_URL_ARCH}"
		;;
	"${PIDD_OS_DEBIAN}")
		[ -n "${PIDD_URL_DEBIAN}" ] && PIDD_URL_CHOSEN="${PIDD_URL_DEBIAN}" ||
			PIDD_URL_CHOSEN="https://deb.debian.org/debian"
		;;
	"${PIDD_OS_FEDORA}")
		[ -n "${PIDD_URL_FEDORA}" ] && PIDD_URL_CHOSEN="${PIDD_URL_FEDORA}" ||
			PIDD_URL_CHOSEN="https://rpmfind.net/linux/fedora/linux/releases"
		;;
	"${PIDD_OS_ROCKY}")
		[ -n "${PIDD_URL_ROCKY}" ] && PIDD_URL_CHOSEN="${PIDD_URL_ROCKY}" ||
			PIDD_URL_CHOSEN="https://dl.rockylinux.org/\$contentdir"
		;;
	"${PIDD_OS_UBUNTU}")
		[ -n "${PIDD_URL_UBUNTU}" ] && PIDD_URL_CHOSEN="${PIDD_URL_UBUNTU}" ||
			PIDD_URL_CHOSEN="https://ubuntu.mirrors.ovh.net/ubuntu"
		;;
	*) ;;
	esac
	pidd_split
	pidd_echo "PIDD_URL_DEFAULT" "PIDD_URL_CHOSEN"
	# set python command & package
	case "${PIDD_OS_ID}" in
	"${PIDD_OS_ALMA}" | "${PIDD_OS_ROCKY}")
		PIDD_PYTHON_COMMAND="python3.11"
		PIDD_PYTHON_PACKAGE="python3.11"
		;;
	"${PIDD_OS_ALPINE}")
		PIDD_PYTHON_COMMAND="python3.11"
		PIDD_PYTHON_PACKAGE="python3"
		;;
	"${PIDD_OS_ARCH}")
		PIDD_PYTHON_COMMAND="python3.12"
		PIDD_PYTHON_PACKAGE="python"
		;;
	"${PIDD_OS_DEBIAN}")
		case "${PIDD_OS_VERSION}" in
		"bookworm") PIDD_PYTHON_COMMAND="python3.11" ;;
		"bullseye") PIDD_PYTHON_COMMAND="python3.9" ;;
		*) ;;
		esac
		PIDD_PYTHON_PACKAGE="python3"
		;;
	"${PIDD_OS_FEDORA}")
		PIDD_PYTHON_COMMAND="python3.12"
		PIDD_PYTHON_PACKAGE="python3"
		;;
	"${PIDD_OS_UBUNTU}")
		case "${PIDD_OS_VERSION}" in
		"noble") PIDD_PYTHON_COMMAND="python3.12" ;;
		"jammy") PIDD_PYTHON_COMMAND="python3.10" ;;
		*) ;;
		esac
		PIDD_PYTHON_PACKAGE="python3"
		;;
	*) ;;
	esac
	# set python packages
	case "${PIDD_OS_ID}" in
	"${PIDD_OS_ALMA}" | "${PIDD_OS_FEDORA}" | "${PIDD_OS_ROCKY}")
		PIDD_PYTHON_PACKAGES="/usr/lib64/${PIDD_PYTHON_COMMAND}/site-packages"
		;;
	"${PIDD_OS_ALPINE}" | "${PIDD_OS_ARCH}")
		PIDD_PYTHON_PACKAGES="/usr/lib/${PIDD_PYTHON_COMMAND}/site-packages"
		;;
	"${PIDD_OS_DEBIAN}" | "${PIDD_OS_UBUNTU}")
		PIDD_PYTHON_PACKAGES="/usr/lib/${PIDD_PYTHON_ALIAS}/dist-packages"
		;;
	*) ;;
	esac
	pidd_split
	pidd_echo "PIDD_PYTHON_COMMAND" "PIDD_PYTHON_PACKAGE" "PIDD_PYTHON_PACKAGES"
	# variables
	[ -n "${PIDD_CA_1}" ] && PIDD_CA=true
	# continuous integration platform
	if [ -n "${GITHUB_ACTIONS}" ]; then
		# github → gitea → forgejo
		if [ -n "${GITHUB_SERVER_URL}" ]; then
			PIDD_PROJECT_ROOT="$(dirname "${GITHUB_SERVER_URL}")//"
			if [ -n "${GITHUB_TOKEN}" ]; then
				PIDD_PROJECT_ROOT="${PIDD_PROJECT_ROOT}${GITHUB_TOKEN}@"
			fi
			PIDD_PROJECT_ROOT="${PIDD_PROJECT_ROOT}$(basename "${GITHUB_SERVER_URL}")"
		else
			pidd_error_ci "GITHUB_SERVER_URL"
		fi
		if [ -n "${GITHUB_REPOSITORY}" ]; then
			PIDD_PROJECT_PATH="$(dirname "${GITHUB_REPOSITORY}")"
			PIDD_PROJECT_NAME="$(basename "${GITHUB_REPOSITORY}")"
		else
			pidd_error_ci "GITHUB_REPOSITORY"
		fi
		if [ -n "${GITHUB_REF_NAME}" ]; then
			PIDD_PROJECT_BRANCH="${GITHUB_REF_NAME}"
		else
			pidd_error_ci "GITHUB_REF_NAME"
		fi
	elif [ -n "${GITLAB_CI}" ]; then
		# gitlab
		if [ -n "${CI_SERVER_PROTOCOL}" ]; then
			if [ -n "${CI_REGISTRY_USER}" ]; then
				if [ -n "${CI_REGISTRY_PASSWORD}" ]; then
					if [ -n "${CI_SERVER_FQDN}" ]; then
						PIDD_PROJECT_ROOT="${CI_SERVER_PROTOCOL}\
://${CI_REGISTRY_USER}:${CI_REGISTRY_PASSWORD}@${CI_SERVER_FQDN}"
						if [ -n "${CI_PROJECT_NAMESPACE}" ]; then
							PIDD_PROJECT_PATH="${CI_PROJECT_NAMESPACE}"
							if [ -n "${CI_PROJECT_NAME}" ]; then
								PIDD_PROJECT_NAME="${CI_PROJECT_NAME}"
							else
								pidd_error_ci "CI_PROJECT_NAME"
							fi
						else
							pidd_error_ci "CI_PROJECT_NAMESPACE"
						fi
					else
						pidd_error_ci "CI_SERVER_FQDN"
					fi
				else
					pidd_error_ci "CI_REGISTRY_PASSWORD"
				fi
			else
				pidd_error_ci "CI_REGISTRY_USER"
			fi
		else
			pidd_error_ci "CI_SERVER_PROTOCOL"
		fi
		if [ -n "${CI_COMMIT_BRANCH}" ]; then
			PIDD_PROJECT_BRANCH="${CI_COMMIT_BRANCH}"
		else
			pidd_error_ci "CI_COMMIT_BRANCH"
		fi
	else
		# unsupported
		pidd_error_ci "ø"
	fi
	[ -n "${PIDD_PROJECT_ROOT}" ] || pidd_error_ci "PIDD_PROJECT_ROOT"
	[ -n "${PIDD_PROJECT_PATH}" ] || pidd_error_ci "PIDD_PROJECT_PATH"
	[ -n "${PIDD_PROJECT_NAME}" ] || pidd_error_ci "PIDD_PROJECT_NAME"
	[ -n "${PIDD_PROJECT_BRANCH}" ] || pidd_error_ci "PIDD_PROJECT_BRANCH"
	#
	pidd_split
	pidd_echo "PIDD_CA"
	pidd_split
	pidd_echo "PIDD_PROJECT_ROOT" \
		"PIDD_PROJECT_PATH" "PIDD_PROJECT_NAME" "PIDD_PROJECT_BRANCH"
	# TODO move to Python
	case "${PIDD_PM}" in
	"${PIDD_PM_APK}" | "${PIDD_PM_APT}") PIDD_PKG_SSH="openssh-client" ;;
	"${PIDD_PM_DNF}") PIDD_PKG_SSH="openssh-clients" ;;
	"${PIDD_PM_PACMAN}") PIDD_PKG_SSH="openssh" ;;
	*) ;;
	esac
}

pidd_set_packages_repositories() {
	pidd_step "Set packages repositories"
	case "${PIDD_OS_ID}" in
	"${PIDD_OS_ALMA}")
		case "${PIDD_OS_VERSION}" in
		"8") pidd_spr__file="/etc/yum.repos.d/almalinux.repo" ;;
		"9") pidd_spr_file="/etc/yum.repos.d/almalinux-baseos.repo" ;;
		*) ;;
		esac
		pidd_sed "${pidd_spr__file}" \
			"|^mirrorlist|# mirrorlist|" \
			"|${PIDD_URL_DEFAULT}|${PIDD_URL_CHOSEN}|" \
			"|^# baseurl|baseurl|"
		;;
	"${PIDD_OS_ALPINE}")
		pidd_spr__file="/etc/apk/repositories"
		pidd_write "${pidd_spr__file}" "\
${PIDD_URL_CHOSEN}/v${PIDD_OS_VERSION}/main
${PIDD_URL_CHOSEN}/v${PIDD_OS_VERSION}/community
"
		;;
	"${PIDD_OS_DEBIAN}")
		pidd_spr__file="/etc/apt/sources.list"
		pidd_write "${pidd_spr__file}" "\
deb ${PIDD_URL_CHOSEN} ${PIDD_OS_VERSION} main
deb ${PIDD_URL_CHOSEN} ${PIDD_OS_VERSION}-backports main
deb ${PIDD_URL_CHOSEN} ${PIDD_OS_VERSION}-updates main
deb ${PIDD_URL_CHOSEN}-security ${PIDD_OS_VERSION}-security main
"
		;;
	"${PIDD_OS_ROCKY}")
		case "${PIDD_OS_VERSION}" in
		"8") pidd_spr__file="/etc/yum.repos.d/Rocky-BaseOS.repo" ;;
		"9") pidd_spr__file="/etc/yum.repos.d/rocky.repo" ;;
		*) ;;
		esac
		pidd_sed "${pidd_spr__file}" \
			"|^mirrorlist|# mirrorlist|" \
			"|${PIDD_URL_DEFAULT}|${PIDD_URL_CHOSEN}|" \
			"|^#baseurl|baseurl|"
		;;
	"${PIDD_OS_UBUNTU}")
		pidd_spr__file="/etc/apt/sources.list"
		pidd_write "${pidd_spr__file}" "\
deb ${PIDD_URL_CHOSEN} ${PIDD_OS_VERSION} main
deb ${PIDD_URL_CHOSEN} ${PIDD_OS_VERSION}-backports main
deb ${PIDD_URL_CHOSEN} ${PIDD_OS_VERSION}-updates main
deb ${PIDD_URL_CHOSEN} ${PIDD_OS_VERSION}-security main
"
		;;
	*) ;;
	esac
}

pidd_set_packages_configuration() {
	pidd_step "Set packages configuration"
	pidd_write "${PIDD_PM_CONF_PATH}" "${PIDD_PM_CONF_TEXT}"
	case "${PIDD_OS_ID}" in
	"${PIDD_OS_DEBIAN}" | "${PIDD_OS_UBUNTU}")
		export DEBIAN_FRONTEND="noninteractive"
		;;
	*) ;;
	esac
}

# agnostic steps

pidd_set_https_verification_off() {
	if [ -n "${PIDD_CA}" ] || [ "${PIDD_PM}" = "${PIDD_PM_APT}" ]; then
		pidd_step "Set HTTPS verification off"
		pidd_mkdir "$(dirname "${PIDD_PM_HTTPS_PATH}")"
		pidd_write "${PIDD_PM_HTTPS_PATH}" "${PIDD_PM_HTTPS_TEXT}"
	fi
}

pidd_set_dns_resolving() {
	pidd_step "Set DNS resolving"
	for pidd_sdr__server in ${PIDD_DNS}; do
		pidd_sdr__text="${pidd_sdr__text}\
nameserver ${pidd_sdr__server}
"
	done
	pidd_write "${PIDD_DNS_FILE}" "${pidd_sdr__text}"
}

pidd_update_packages_catalog() {
	pidd_step "Update packages catalog"
	${PIDD_PM_UPDATE} || exit
}

pidd_install_packages_tools() {
	pidd_step "Install packages tools"
	pidd_install_package "${PIDD_PKG_PKG}"
}

pidd_install_ca_certificates() {
	pidd_step "Install CA"
	pidd_install_package "${PIDD_PKG_CA}"
}

pidd_write_ca_certificates() {
	pidd_step "Write CA certificates"
	pidd_mkdir "${PIDD_CA_ROOT}"
	pidd_wcc__index=1
	eval "pidd_wcc__text=\"\${PIDD_CA_${pidd_wcc__index}}\""
	while [ -n "${pidd_wcc__text}" ]; do
		pidd_wcc__path="${PIDD_CA_ROOT}/${pidd_wcc__index}.crt"
		pidd_split
		pidd_write \
		"${pidd_wcc__path}" \
		"${pidd_wcc__text}"
		pidd_openssl "${pidd_wcc__path}"
		pidd_wcc__index=$((pidd_wcc__index + 1))
		eval "pidd_wcc__text=\"\${PIDD_CA_${pidd_wcc__index}}\""
	done
}

pidd_update_ca_certificates() {
	pidd_step "Update CA certificates"
	${PIDD_CMD_CA} || exit
}

pidd_set_https_verification_on() {
	pidd_step "Set HTTPS verification on"
	pidd_rm "${PIDD_PM_HTTPS_PATH}"
}

pidd_upgrade_packages() {
	pidd_step "Upgrade packages"
	${PIDD_PM_UPGRADE} || exit
}

pidd_install_git() {
	pidd_step "Install Git"
	pidd_install_package "${PIDD_PKG_GIT}"
}

pidd_install_python() {
	pidd_step "Install Python"
	pidd_install_package "${PIDD_PYTHON_PACKAGE}"
	pidd_split
	pidd_ln_python "${PIDD_PYTHON_COMMAND}"
}

# TODO move to Python
pidd_install_rsync() {
	pidd_step "Install Rsync"
	pidd_install_package "${PIDD_PKG_RSYNC}"
}

# TODO move to Python
pidd_install_ssh() {
	pidd_step "Install SSH"
	pidd_install_package "${PIDD_PKG_SSH}"
}

pidd_clean_packages_cache() {
	pidd_step "Clean packages cache"
	${PIDD_PM_CLEAN} || exit
}

pidd_install_python_modules() {
	pidd_step "Install Python modules"
	pidd_ipm__root="$(mktemp --directory)" || exit
	echo "→ ${pidd_ipm__root}"
	for pidd_ipm__repository in "${PIDD_GIT_MAIN}" "${PIDD_GIT_ROOT}"; do
		case "${pidd_ipm__repository}" in
		http*) pidd_ipm__url="${pidd_ipm__repository}" ;;
		/*) pidd_ipm__url="${PIDD_PROJECT_ROOT}${pidd_ipm__repository}" ;;
		*) pidd_ipm__url="\
${PIDD_PROJECT_ROOT}/${PIDD_PROJECT_PATH}/${pidd_ipm__repository}" ;;
		esac
		pidd_ipm__name="$(basename "${pidd_ipm__url}")"
		pidd_split
		echo "\
${pidd_ipm__url}
↓"
		git clone \
			"${pidd_ipm__url}" \
			"${pidd_ipm__root}/${pidd_ipm__name}" ||
			exit
		pidd_ipm__path="${pidd_ipm__root}/${pidd_ipm__name}/${pidd_ipm__name}"
		echo "\
${pidd_ipm__path}
↓
${PIDD_PYTHON_PACKAGES}"
		cp --recursive "${pidd_ipm__path}" "${PIDD_PYTHON_PACKAGES}" ||
			exit
	done
	pidd_split
	pidd_ls "${PIDD_PYTHON_PACKAGES}"
	pidd_split
	pidd_rm "${pidd_ipm__root}"
}

pidd_write_python_module() {
	pidd_step "Write Python module"
	for pidd_wpm__variable in \
		OS_ID OS_VERSION \
		PROJECT_ROOT PROJECT_PATH PROJECT_NAME \
		OPEN DOWN VERT SPLT __UP SHUT; do
		pidd_wpm__value="$(pidd_echo "PIDD_${pidd_wpm__variable}")"
		pidd_wpm__text="${pidd_wpm__text}${pidd_wpm__value}
"
	done
	pidd_write "${PIDD_PYTHON_PACKAGES}/env.py" "${pidd_wpm__text}
PIDD_STEP = $((PIDD_STEP + 1))
"
}

pidd_switch_to_python() {
	pidd_step "Switch to Python"
	pidd_stp__name="$(basename "${PIDD_GIT_MAIN}")"
	echo "\
${PIDD_PATH}
↓
${PIDD_PYTHON_PACKAGES}/${pidd_stp__name}"
	"${PIDD_PYTHON_ALIAS}" -m "${pidd_stp__name}" "${@}"
}

# functions

pidd_cat() {
	pidd_cat__file="${1}"
	if [ -n "${pidd_cat__file}" ]; then
		pidd_open "${pidd_cat__file}"
		cat "${pidd_cat__file}" || exit
		pidd_shut "${pidd_cat__file}"
	fi
}

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

pidd_error_ci() {
	echo "× CI: ${*}"
	exit "${PIDD_ERROR_CI}"
}

pidd_error_os() {
	pidd_error_os__variable="${1}"
	printf "× OS: "
	pidd_echo "${pidd_error_os__variable}"
	exit "${PIDD_ERROR_OS}"
}

pidd_grep_os() {
	pidd_grep_os__variable="${1}"
	if [ -n "${pidd_grep_os__variable}" ]; then
		grep "^${pidd_grep_os__variable}=" "/etc/os-release" |
			sed "s|^${pidd_grep_os__variable}=||" |
			sed "s|^\"\(.*\)\"$|\1|"
	fi
}

pidd_install_package() {
	pidd_install_package__name="${1}"
	if [ -n "${pidd_install_package__name}" ]; then
		${PIDD_PM_INSTALL} "${pidd_install_package__name}" || exit
	fi
}

pidd_ln_python() {
	pidd_ln_python__command="${1}"
	if [ -n "${pidd_ln_python__command}" ]; then
		echo "→ ${PIDD_PYTHON_ALIAS} → ${pidd_ln_python__command}"
		ln -f -s "${pidd_ln_python__command}" "/usr/bin/${PIDD_PYTHON_ALIAS}" ||
			exit
	fi
}

pidd_ls() {
	pidd_ls__path="${1}"
	if [ -n "${pidd_ls__path}" ]; then
		pidd_open "${pidd_ls__path}"
		ls -a -l "${pidd_ls__path}" || exit
		pidd_shut "${pidd_ls__path}"
	fi
}

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

pidd_open() {
	echo "${PIDD_OPEN}${*}"
}

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

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

pidd_sed() {
	pidd_sed__file="${1}"
	shift
	if [ -f "${pidd_sed__file}" ]; then
		pidd_cat "${pidd_sed__file}"
		for pidd_sed__regex in "${@}"; do
			sed --in-place "s${pidd_sed__regex}g" "${pidd_sed__file}" &&
				pidd_cat "${pidd_sed__file}" ||
				exit
		done
	fi
}

pidd_shut() {
	echo "${PIDD_SHUT}${*}"
}

pidd_split() {
	echo "${PIDD_SPLT}"
}

pidd_step() {
	PIDD_STEP=$((PIDD_STEP + 1))
	echo "\
${PIDD_DOWN}
${PIDD_VERT} ${PIDD_STEP} ${*}
${PIDD___UP}"
}

pidd_write() {
	pidd_write__file="${1}"
	pidd_write__text="${2}"
	if [ -n "${pidd_write__file}" ]; then
		[ -f "${pidd_write__file}" ] && pidd_cat "${pidd_write__file}"
		echo "→ ${pidd_write__file}"
		printf "%s" "${pidd_write__text}" >"${pidd_write__file}" || exit
		pidd_cat "${pidd_write__file}"
	fi
}

# constants

PIDD_BOX_DOWN="╭"
PIDD_BOX_LEFT="╴"
PIDD_BOX_RIGHT="╶"
PIDD_BOX_UP="╰"
PIDD_BOX_VERTICAL="│"

PIDD_ERROR_CI=2
PIDD_ERROR_OS=1

PIDD_OS_ALMA="alma"
PIDD_OS_ALPINE="alpine"
PIDD_OS_ARCH="arch"
PIDD_OS_DEBIAN="debian"
PIDD_OS_FEDORA="fedora"
PIDD_OS_ROCKY="rocky"
PIDD_OS_UBUNTU="ubuntu"

PIDD_PM_APK="apk"
PIDD_PM_APT="apt"
PIDD_PM_DNF="dnf"
PIDD_PM_PACMAN="pacman"

PIDD_HORIZONTAL="────╌╌╌╌┄┄┄┄┈┈┈┈"

PIDD_OPEN="${PIDD_BOX_DOWN}${PIDD_BOX_LEFT}"
PIDD_DOWN="${PIDD_BOX_DOWN}${PIDD_HORIZONTAL}"
PIDD_VERT="${PIDD_BOX_VERTICAL}"
PIDD_SPLT="${PIDD_BOX_RIGHT}${PIDD_HORIZONTAL}"
PIDD___UP="${PIDD_BOX_UP}${PIDD_HORIZONTAL}"
PIDD_SHUT="${PIDD_BOX_UP}${PIDD_BOX_LEFT}"

# run
pidd_main "${@}"