#!/usr/bin/zsh

# 路径名称: 公共/函数.zsh
# 脚本作用: 通用zsh函数合集 方便zsh脚本快速调用
# 第一作者: 寻觅(xunmiemail@vip.qq.com)
# 创建时间: 2024年2月4日23:24:12
# 使用方法: 在言灵根目录下使用`. 公共/函数.zsh`


# 启动言灵公共函数模块的标识符
言灵_函数=1

###############################################################################
# 终端配色                                                                    #
###############################################################################

# 色彩配置
readonly 色彩重置='\e[0m'
readonly 色彩=(
	'\e[92m'		# 1: 绿
	'\e[90m'		# 2: 灰
	'\e[31m'		# 3: 暗红
	'\e[32m'		# 4: 暗绿
	'\e[33m'		# 5: 暗黄
)

# 用于规范输出的工具
# 位置参数 1 -> 整数 <- 1: 成功(亮绿); 2: 失败(红色); 3: 信息(绿色); 4: 通知(黄色)
# 位置参数 2 -> 字符 <- 在命令行输出的字符串
# 实例 `输出 0 "执行成功"`; `输出 3 "请及时更新依赖"`
输出() {
    if (($1 == 0)); then
        echo -e "${色彩[2]}[${色彩重置}${色彩[1]} 成功 ${色彩重置}${色彩[2]}]${色彩重置} $2"
    elif (($1 == 1)); then
        echo -e "${色彩[2]}[${色彩重置}${色彩[3]} 失败 ${色彩重置}${色彩[2]}]${色彩重置} $2"
        exit 1
    elif (($1 == 2)); then
        echo -e "${色彩[2]}[${色彩重置}${色彩[4]} 信息 ${色彩重置}${色彩[2]}]${色彩重置} $2"
    elif (($1 == 3)); then
        echo -e "${色彩[2]}[${色彩重置}${色彩[5]} 通知 ${色彩重置}${色彩[2]}]${色彩重置} $2"
    fi
}

# 灰色信息(处理一些无关紧要的信息, 调用后在没有清除颜色之前会一直使用灰色输出)
色彩_灰色() {
    echo -e "${色彩[2]}\c"
}

# 清除颜色(一般和灰色信息连用)
色彩_清除() {
    echo -e "${色彩重置}\c"
}

###############################################################################
# 通用函数                                                                    #
###############################################################################

# 用判断用户输入的值, 输入 `是/Y/y/yes` 返会0, 其他情况返会1
# 位置参数 1 -> 字符 <- 用于提示用户选择时候的提示语
是否() {
        输出 3 "$1((是/否 Yes/No))"
        read r
        if echo "$r" | grep -Eq "^[是Yy][Ee]?[Ss]?$";then
                return 0
        fi
	return 1
}