bash-it/lib/utilities.bash

# shellcheck shell=bash
#
# A collection of reusable functions.

###########################################################################
# Generic utilies
###########################################################################

function _bash-it-get-component-name-from-path() {
	local filename
	# filename without path
	filename="${1##*/}"
	# filename without path or priority
	filename="${filename##*${BASH_IT_LOAD_PRIORITY_SEPARATOR?}}"
	# filename without path, priority or extension
	echo "${filename%.*.bash}"
}

function _bash-it-get-component-type-from-path() {
	local filename
	# filename without path
	filename="${1##*/}"
	# filename without extension
	filename="${filename%.bash}"
	# extension without priority or name
	filename="${filename##*.}"
	echo "${filename}"
}

# This function searches an array for an exact match against the term passed
# as the first argument to the function. This function exits as soon as
# a match is found.
#
# Returns:
#   0 when a match is found, otherwise 1.
#
# Examples:
#   $ declare -a fruits=(apple orange pear mandarin)
#
#   $ _bash-it-array-contains-element apple "@{fruits[@]}" && echo 'contains apple'
#   contains apple
#
#   $ if $(_bash-it-array-contains-element pear "${fruits[@]}"); then
#       echo "contains pear!"
#     fi
#   contains pear!
#
#
function _bash-it-array-contains-element() {
	local e
	for e in "${@:2}"; do
		[[ "$e" == "$1" ]] && return 0
	done
	return 1
}

# Dedupe a simple array of words without spaces.
function _bash-it-array-dedup() {
	local IFS=$'\n'
	echo "$@" | tr ' ' '\n' | sort -u
}

# Outputs a full path of the grep found on the filesystem
function _bash-it-grep() {
	: "${BASH_IT_GREP:=$(type -p egrep || type -p grep)}"
	printf "%s" "${BASH_IT_GREP:-'/usr/bin/grep'}"
}

###########################################################################
# Component-specific functions (component is either an alias, a plugin, or a
# completion).
###########################################################################

function _bash-it-component-help() {
	local component file func
	component="$(_bash-it-pluralize-component "${1}")"
	file="$(_bash-it-component-cache-file "${component}")"
	if [[ ! -s "${file}" || -z "$(find "${file}" -mmin -300)" ]]; then
		rm -f "${file}" 2> /dev/null
		func="_bash-it-${component}"
		"${func}" | ${BASH_IT_GREP:-$(_bash-it-grep)} -E '   \[' > "${file}"
	fi
	cat "${file}"
}

function _bash-it-component-cache-file() {
	local component file
	component="$(_bash-it-pluralize-component "${1}")"
	file="${BASH_IT?}/tmp/cache/${component}"
	[[ -f "${file}" ]] || mkdir -p "${file%/*}"
	printf '%s' "${file}"
}

function _bash-it-pluralize-component() {
	local component="${1}"
	local -i len=$((${#component} - 1))
	# pluralize component name for consistency
	[[ "${component:${len}:1}" != 's' ]] && component="${component}s"
	[[ "${component}" == "alias" ]] && component="aliases"
	printf '%s' "${component}"
}

function _bash-it-clean-component-cache() {
	local component="$1"
	local cache
	local -a BASH_IT_COMPONENTS=(aliases plugins completions)
	if [[ -z "${component}" ]]; then
		for component in "${BASH_IT_COMPONENTS[@]}"; do
			_bash-it-clean-component-cache "${component}"
		done
	else
		cache="$(_bash-it-component-cache-file "${component}")"
		if [[ -f "${cache}" ]]; then
			rm -f "${cache}"
		fi
	fi
}

# Returns an array of items within each compoenent.
function _bash-it-component-list() {
	local IFS=$'\n' component="$1"
	_bash-it-component-help "${component}" | awk '{print $1}' | sort -u
}

function _bash-it-component-list-matching() {
	local component="$1"
	shift
	local term="$1"
	_bash-it-component-help "${component}" | ${BASH_IT_GREP:-$(_bash-it-grep)} -E -- "${term}" | awk '{print $1}' | sort -u
}

function _bash-it-component-list-enabled() {
	local IFS=$'\n' component="$1"
	_bash-it-component-help "${component}" | ${BASH_IT_GREP:-$(_bash-it-grep)} -E '\[x\]' | awk '{print $1}' | sort -u
}

function _bash-it-component-list-disabled() {
	local IFS=$'\n' component="$1"
	_bash-it-component-help "${component}" | ${BASH_IT_GREP:-$(_bash-it-grep)} -E -v '\[x\]' | awk '{print $1}' | sort -u
}

# Checks if a given item is enabled for a particular component/file-type.
# Uses the component cache if available.
#
# Returns:
#    0 if an item of the component is enabled, 1 otherwise.
#
# Examples:
#    _bash-it-component-item-is-enabled alias git && echo "git alias is enabled"
function _bash-it-component-item-is-enabled() {
	local component="$1"
	local item="$2"
	_bash-it-component-help "${component}" | ${BASH_IT_GREP:-$(_bash-it-grep)} -E '\[x\]' | ${BASH_IT_GREP:-$(_bash-it-grep)} -E -q -- "^${item}\s"
}

# Checks if a given item is disabled for a particular component/file-type.
# Uses the component cache if available.
#
# Returns:
#    0 if an item of the component is enabled, 1 otherwise.
#
# Examples:
#    _bash-it-component-item-is-disabled alias git && echo "git aliases are disabled"
function _bash-it-component-item-is-disabled() {
	local component="$1"
	local item="$2"
	_bash-it-component-help "${component}" | ${BASH_IT_GREP:-$(_bash-it-grep)} -E -v '\[x\]' | ${BASH_IT_GREP:-$(_bash-it-grep)} -E -q -- "^${item}\s"
}