miaou/miaou-bash
1
0
Fork 0
Code Issues Pull Requests Projects Releases Wiki Activity

functions.bash

Browse Source
This commit is contained in:
pvincent
2026-04-13 11:02:20 +04:00
parent ad1f350453
commit 6a59720ef5
6 changed files with 172 additions and 109 deletions
Download Patch File Download Diff File Expand all files Collapse all files
README.md
+1 -1
View File
@@ -35,7 +35,7 @@ Any feedback would be appreciated. [contact@artcode.re](mailto:contact@artcode.r
## useful library ## useful library
* source /opt/miaou-bash/lib/functions.sh * source /opt/miaou-bash/lib/functions.bash
## bindkeys ## bindkeys
install.sh
+21 -21
View File
@@ -9,15 +9,15 @@ readonly MAIN_TAR_GZ_URL="https://git.artcode.re/miaou/miaou-bash/archive/main.t
## FUNCTIONS ## FUNCTIONS
function push_directory { function push_directory {
pushd "$1" || (echo "unable to push directory <$1>" && exit 1) pushd "$1" || (echo "unable to push directory <$1>" && exit 1)
} }
function pop_directory { function pop_directory {
popd || (echo "unable to pop from previous directory" && exit 1) popd || (echo "unable to pop from previous directory" && exit 1)
} }
function root_required { function root_required {
[ "$(id -u)" -ne 0 ] && echo 'root privilege required' && exit 1 [ "$(id -u)" -ne 0 ] && echo 'root privilege required' && exit 1
} }
## MAIN ## MAIN
@@ -25,28 +25,28 @@ function root_required {
root_required root_required
if [[ $CURDIR != '/opt/miaou-bash' ]]; then if [[ $CURDIR != '/opt/miaou-bash' ]]; then
# download and fullfill /opt/miaou-bash, then run it from folder # download and fullfill /opt/miaou-bash, then run it from folder
if [[ -L /opt/miaou-bash ]]; then if [[ -L /opt/miaou-bash ]]; then
/opt/miaou-bash/install.sh /opt/miaou-bash/install.sh
else else
rm -rf /opt/miaou-bash rm -rf /opt/miaou-bash
push_directory "$(mktemp -d)" push_directory "$(mktemp -d)"
curl --no-progress-meter -O $MAIN_TAR_GZ_URL curl --no-progress-meter -O $MAIN_TAR_GZ_URL
tar -xzf main.tar.gz tar -xzf main.tar.gz
mv miaou-bash /opt/ mv miaou-bash /opt/
pop_directory pop_directory
rm -rf "$TEMP" rm -rf "$TEMP"
push_directory /opt/miaou-bash && ./install.sh push_directory /opt/miaou-bash && ./install.sh
fi fi
else else
MIAOU_BASH_DIR=$CURDIR MIAOU_BASH_DIR=$CURDIR
export MIAOU_BASH_DIR export MIAOU_BASH_DIR
source "$MIAOU_BASH_DIR/lib/functions.sh" source "$MIAOU_BASH_DIR/lib/functions.bash"
"$MIAOU_BASH_DIR/tools/idem_apt_install" "${REQUIRED_PKGS[@]}" "$MIAOU_BASH_DIR/tools/idem_apt_install" "${REQUIRED_PKGS[@]}"
./init.sh ./init.sh
fi fi
lib/functions.bash
+113
View File
@@ -0,0 +1,113 @@
## library of useful functions, usually prefixed with '_'
## ===============
## ARRAY Functions
## ===============
function _array_contains {
local -n array=$1
local element=$2
[[ " ${array[@]} " =~ " ${element} " ]] && return 0 || return 1
}
function _array_intersect {
local -n arr1=$1
local -n arr2=$2
local -n result=$3
declare -A include
for item in "${arr2[@]}"; do include["$item"]=1; done
result=()
for item in "${arr1[@]}"; do [[ -n ${include["$item"]} ]] && result+=("$item"); done
}
function _array_subtract {
local -n arr1=$1 # First array
local -n arr2=$2 # Array to subtract
local -n result=$3 # Output array
[[ ${#arr2[@]} == 0 ]] && result=("${arr1[@]}") && return
declare -A exclude
for item in "${arr2[@]}"; do exclude["$item"]=1; done
result=()
for item in "${arr1[@]}"; do [[ -z ${exclude["$item"]} ]] && result+=("$item"); done
}
## ==============
## TEXT Functions
## ==============
function _pluralize_simple {
echo -n "$1 "
[[ $1 -eq 1 || $1 -eq -1 ]] && echo ${2} || echo ${2}s
}
## ==============
## READ Functions
## ==============
function _confirm_destructive {
local message="${1:-This cannot be undone!}"
echo "⚠️ WARNING: $message"
read -p "Type YES to confirm: " response
case "$response" in
[yY][eE][sS] | [yY]) return 0 ;;
*) echo "canceled!" && return 1 ;;
esac
}
## ==============
## Deprecated: FIXME: to remove
## ==============
##
# return 0 (true) if array (passed by name) contains element
# usage:
# ARRAY=( a b c )
# containsElement ARRAY 'a' => 0
function containsElement {
isArray "$1" || (echo >&2 "ERROR: <$1> not an array!" && return 2)
array_inter="$1[@]"
array=("${!array_inter}")
for i in "${array[@]}"; do [[ "$i" == "$2" ]] && return 0; done
return 1
}
## return 0 (true) if arg1 (passed by name) is an array
function isArray {
[[ "$(declare -p "$1" 2>/dev/null)" =~ "declare -a" ]] || return 1
}
function isDebian {
grep ^ID=debian /etc/os-release
}
function isArch {
grep ^ID=arch /etc/os-release
}
function os-release {
grep ^ID= /etc/os-release | cut -d '=' -f2
}
function askConfirmation {
case "$1" in
y | Y | yes | YES)
QUESTION="(Y/n)?"
DEFAULT=0
;;
*)
QUESTION="(y/N)?"
DEFAULT=1
;;
esac
read -rp "$QUESTION : " choice
case "$choice" in
y | Y | yes | YES) return 0 ;; #true
n | no | N | NO) return 1 ;; #false
*) return $DEFAULT ;;
esac
}
lib/functions.sh
-50
View File
@@ -1,50 +0,0 @@
#!/bin/bash
##
# return 0 (true) if array (passed by name) contains element
# usage:
# ARRAY=( a b c )
# containsElement ARRAY 'a' => 0
function containsElement {
isArray "$1" || (echo >&2 "ERROR: <$1> not an array!" && return 2)
array_inter="$1[@]"
array=("${!array_inter}")
for i in "${array[@]}"; do [[ "$i" == "$2" ]] && return 0; done
return 1
}
## return 0 (true) if arg1 (passed by name) is an array
function isArray {
[[ "$(declare -p "$1" 2>/dev/null)" =~ "declare -a" ]] || return 1
}
function isDebian {
grep ^ID=debian /etc/os-release
}
function isArch {
grep ^ID=arch /etc/os-release
}
function os-release {
grep ^ID= /etc/os-release | cut -d '=' -f2
}
function askConfirmation {
case "$1" in
y | Y | yes | YES)
QUESTION="(Y/n)?"
DEFAULT=0
;;
*)
QUESTION="(y/N)?"
DEFAULT=1
;;
esac
read -rp "$QUESTION : " choice
case "$choice" in
y | Y | yes | YES) return 0 ;; #true
n | no | N | NO) return 1 ;; #false
*) return $DEFAULT ;;
esac
}
tools/idem_apt_install
+36 -36
View File
@@ -1,53 +1,53 @@
#!/bin/bash #!/bin/bash
function usage { function usage {
local BASECMD local BASECMD
BASECMD=$(basename "$0") BASECMD=$(basename "$0")
echo "usage: $BASECMD <packages...>" echo "usage: $BASECMD <packages...>"
case $(os-release) in case $(os-release) in
debian) debian)
echo 'idempotent debian package installation : update if necessary, install only if not yet done' echo 'idempotent debian package installation : update if necessary, install only if not yet done'
;; ;;
arch) arch)
echo 'idempotent archlinux package installation : update if necessary, install only if not yet done' echo 'idempotent archlinux package installation : update if necessary, install only if not yet done'
;; ;;
esac esac
exit 1 exit 1
} }
BASEDIR=$(dirname "$0") BASEDIR=$(dirname "$0")
source "$BASEDIR"/../lib/functions.sh source "$BASEDIR"/../lib/functions.bash
[ "$(id -u)" -ne 0 ] && echo 'root privilege required' && exit 2 [ "$(id -u)" -ne 0 ] && echo 'root privilege required' && exit 2
[[ $# -lt 1 ]] && usage [[ $# -lt 1 ]] && usage
case $(os-release) in case $(os-release) in
debian | ubuntu | linuxmint) debian | ubuntu | linuxmint)
if [ "$(date --date='-12 hours' +%s)" -gt "$(date -d "$(stat -c %y /var/lib/apt/lists/partial)" +%s)" ]; then if [ "$(date --date='-12 hours' +%s)" -gt "$(date -d "$(stat -c %y /var/lib/apt/lists/partial)" +%s)" ]; then
echo "updating repositoring..." echo "updating repositoring..."
apt-get update apt-get update
fi fi
for i in "$@"; do for i in "$@"; do
if ! dpkg -l "$i" 2>/dev/null | grep -q ^ii; then if ! dpkg -l "$i" 2>/dev/null | grep -q ^ii; then
sudo apt-get install -y "$i" sudo apt-get install -y "$i"
elif [ -n "${VERBOSE+x}" ] && $VERBOSE; then elif [ -n "${VERBOSE+x}" ] && $VERBOSE; then
echo "apt package <$i> already installed!" echo "apt package <$i> already installed!"
fi fi
done done
;; ;;
arch) arch)
sudo pacman -Syyu --noconfirm sudo pacman -Syyu --noconfirm
for i in "$@"; do for i in "$@"; do
if ! pacman -Ql "$i" &>/dev/null; then if ! pacman -Ql "$i" &>/dev/null; then
sudo pacman -S --noconfirm "$i" sudo pacman -S --noconfirm "$i"
elif [ -n "${VERBOSE+x}" ] && $VERBOSE; then elif [ -n "${VERBOSE+x}" ] && $VERBOSE; then
echo "pacman package <$i> already installed!" echo "pacman package <$i> already installed!"
fi fi
done done
;; ;;
*) *)
echo "unknown os release <$(os-release)>!" && exit 2 echo "unknown os release <$(os-release)>!" && exit 2
;; ;;
esac esac
tools/wget_semver
+1 -1
View File
@@ -42,7 +42,7 @@ function get_artcode {
if [ -z "$(command -v git)" ]; then if [ -z "$(command -v git)" ]; then
echo "INSTALLING PACKAGE <GIT> required" echo "INSTALLING PACKAGE <GIT> required"
source "$MIAOU_BASH_DIR/lib/functions.sh" source "$MIAOU_BASH_DIR/lib/functions.bash"
"$CURDIR/tools/idem_apt_install" git "$CURDIR/tools/idem_apt_install" git
fi fi