From 6531e671ffc7c110d74339217065daa03ae1ce33 Mon Sep 17 00:00:00 2001 From: Chen Peng Date: Tue, 3 Dec 2024 12:22:40 +0800 Subject: [PATCH] rm: vender/bake.bash --- vendor/bake.bash | 733 ----------------------------------------------- 1 file changed, 733 deletions(-) delete mode 100644 vendor/bake.bash diff --git a/vendor/bake.bash b/vendor/bake.bash deleted file mode 100644 index 9b41165b..00000000 --- a/vendor/bake.bash +++ /dev/null @@ -1,733 +0,0 @@ -#!/usr/bin/env bash -set -o errtrace # -E trap inherited in sub script -set -o errexit # -e -set -o functrace # -T If set, any trap on DEBUG and RETURN are inherited by shell functions -set -o pipefail # default pipeline status==last command status, If set, status=any command fail -#set -o nounset # -u: don't use it ,it is crazy, 1.bash version is diff Behavior 2.we need like this: ${arr[@]+"${arr[@]}"} - -_bake_version=v0.4.20240406 - -# It can run normally on macos -# bake == (bash)ake == 去Make的bash tool -# -# https://github.com/chen56/bake -# -# bake 是个简单的命令行工具，以替代Makefile的子命令功能 -# make工具的主要特点是处理文件依赖进行增量编译，但flutter、golang、java、js项目的build工具 -# 太厉害了，这几年唯一还在用Makefile的理由就是他的子命令机制: "make build"、 -# "make run", 可以方便的自定义单一入口的父子命令，但Makefile本身的语法套路也很复杂， -# 很多批处理还是要靠bash, 这就尴尬了，工具太多，麻烦！本脚本尝试彻底摆脱使用Makefile。 -# 经尝试，代码很少啊 ，核心代码几百行啊，父子命令二三百行左右，option解析二三百行左右，功能足够了： -# -# bake命令规则： -# 1. 函数即命令，所有bake内的函数均可以在脚本外运行： -# ./bake [all function] # bake内的所有函数均可以在脚本外直接运行 -# ./bake info # 比如这个内部函数, 看bake内部变量，调试脚本用 -# ./bake test # 你如果定义过test()函数，就可以这样运行 -# 2. 带"."的函数，形成父子命令: -# web.build(){ echo "build web app"; } -# web.test(){ echo "build web app"; } -# 可以这样调用 -# ./bake web -h # 运行子命令,或看帮助 -# ./bake web.build -h # 上面等同 -# ./bake web test -h # 运行子命令,或看帮助 -# ./bake web.test -h # 与上面等同 -# 3. 特殊的root命令表示根命令 -# ./bake # 如果有root()函数，就执行它 -# 4. 像其他高级语言的cli工具一样，用简单变量就可以获取命令option: -# # a. 先在bake文件里里定义app options -# bake.opt --cmd build --long "target" --type string -# # b. 解析和使用option -# function build() { -# eval "$(bake.parse "$@")"; -# echo "build ... your option：target: $target"; -# } -# # c. 调用看看: -# ./bake build --target "macos" -# 5. bake尽量不依赖bash以外的其他工具，包括linux coreutils,更简单通用,但由于用了关联数组等 -# 依赖bash4+ -# 6. 有两种用法： -# - 这个文件copy走，把你的脚本放到本脚本最后即可. -# - 在你的脚本里直接curl下载本脚本后 source即可。 -# 范例可以看实际案例： -# - https://github.com/chen56/note/blob/main/bake -# - https://github.com/chen56/younpc/blob/main/bake - -############################################################# -# bake head 变量定义区 -# bake.bash 在头head定义变量，尾tail执行初始化，中间只有函数 -############################################################# - -# check bake dependencies -if ((BASH_VERSINFO[0] < 4 || (\ - BASH_VERSINFO[0] == 4 && BASH_VERSINFO[1] < 4))); then - echo "Error: It's 2082 ，Your bash is still this version(BASH_VERSINFO: ${BASH_VERSINFO[*]})，Please install bash 4.4+: - apt install bash # ubuntu - brew install bash # mac" - exit 124 # =>http code 424 -fi - -# On Mac OS, readlink -f doesn't work, so use.bake.__real_path get the real path of the file -bake.__real_path() { [[ $1 = /* ]] && echo "$1" || echo "$PWD/${1#./}" ; } - -# bake context -BAKE_PATH="$(bake.__real_path "${BASH_SOURCE[0]}")" -# shellcheck disable=SC2034 -BAKE_DIR="$(dirname "$BAKE_PATH")" -BAKE_FILE="$(basename "$BAKE_PATH")" - -# defalut option：bake --debug --help -# bake.parse 会按bake.opt的定义动态生成相应变量，这里事先声明，是为了备注其存在 -# 请参考[bake.parse] -__debug=false -__help=false - - -# Simulating object-oriented data structures with flat associative arrays -# use ./bake _self to see internal var -# save all other data -declare -A _bake_data - -# only save all commands, we use it to build command tree -# it is cache cmd tree from _bake_data -declare -A _bake_cmds - - - -########################################## -# bake internal function -########################################## - - -bake.__on_error() { - bake.__error "ERROR - trapped an error: ↑ , trace: ↓" - local i=0 - local stackInfo - while true; do - stackInfo=$(caller $i 2>&1 && true) && true - if [[ $? != 0 ]]; then return 0; fi - - # 一行调用栈 '97 bake.build ./note/bake' - # 解析后 => 行号no=97 , 报错的函数func=bake.build , file=./note/bake - local no func file - IFS=' ' read -r no func file <<<"$stackInfo" - - # 打印出可读性强的信息: - # => ./note/bake:38 -> bake.build - printf "%s\n" "$(bake.__real_path $file):$no -> $func" >&2 - - i=$((i + 1)) - done -} - - -# replace $HOME with "~" -# Usage: bake.__pwd -# Examples: 当前目录如果是"/Users/chen/git/note/" -# 转成更简单易读的 => "~/git/note/" -bake.__pwd() { echo "${PWD/#$HOME/\~}" ; } - -# 报错后终止程序，类似于其他语言的throw Excpetion -# 因set -o errexit 后，程序将在return 1 时退出， -# 退出前被‘trap bake.__on_error ERR’捕获并显示错误堆栈 -# Usage: bake.__throw -bake.__throw(){ - bake.__log FATAL "$@" - # set -o errexit 后，程序将退出，退出前被trap bake.__on_error Err捕获并显示错误堆栈 - return 200 -} -bake.__error() { - bake.__log ERROR "$@" -} -bake.__info() { - bake.__log INFO "$@" -} -bake.__debug() { - # shellcheck disable=SC2154 - if [[ "${__debug}" == true ]]; then - bake.__log DEBUG "$@" - fi -} -# Usage: bake.__log DEBUG "错误消息" -bake.__log(){ - local level="$1" - echo -e "$level $(date "+%F %T") $(bake.__pwd)\$ ${FUNCNAME[1]}() : $*" >&2 -} - - - - -# Usage: bake.__str_cutLeft -# bake.__path_dirname a/b/c a/b => c -bake.__str_cutLeft() { printf "${1#$2}"; } - -# 分割字符串 -# Usage: bake.__str_split [delimiter:default /] -# Example: bake.__str_split "a/b/c" "/" -# => $'a\nb\nc' # 会把字符串分割为以换行符间隔的字符串 -bake.__str_split() { - #${delimiter:-DEFAULT} unset 或null 都给默认值 - # https://www.gnu.org/software/bash/manual/html_node/Shell-Parameter-Expansion.html - local str="$1" - local delimiter="${2:-/}" - - # use <() process-substitution - # or here string <<< "" its add newline - local arr - # https://helpmanual.io/builtin/readarray/ - # -d The first character of delim is used to terminate each input line, rather than newline. - # -t Remove a trailing delim (default newline) from each line read. - readarray -t -d "$delimiter" arr <<< "${str}" - # same as: for i in "${arr[@]}"; do echo "$i" done - printf '%s\n' "${arr[@]}" -} - -# Usage: bake.__str_revertLines <<< "$(echo -e "a\nb\nc")" => "c\nb\na" -bake.__str_revertLines() { - # cat xxx | tail -r; # macos bsd only, not work on linux - # so use sed - sed '1!G;h;$!d' # sed magic -} - -# Usage: bake.__path_dirname [delimiter:default /] -# similar command dirname, but diff: -# dirname a => '.' -# bake.__path_dirname a => '' -# -# Example: delimiter: -# bake.__path_dirname a.b.c "." => "a.b" -# bake.__path_dirname a "." => "" -bake.__path_dirname() { - local path="$1" - local delimiter="${2:-/}" - -# bake.__path_dirname level1_path "." => "" - if [[ "$path" != *"$delimiter"* ]]; then - return - fi - echo "${path%"$delimiter"*}" -} -# Usage: bake.__path_first [delimiter:default /] -# bake.__path_first a.b.c . => a -bake.__path_first() { - local pathLikeStr="$1" delimiter="${2:-/}" - # if /a/b/c , call :bake.__path_first a/b/c / - if [[ "$pathLikeStr" == "$delimiter"* ]]; then - local removeDelim - removeDelim=$(bake.__str_cutLeft "$pathLikeStr" "$delimiter") - printf "$delimiter$(bake.__path_first "$removeDelim" "$delimiter")" - else # a/b/c - printf "${pathLikeStr%%$delimiter*}" - fi -} -# similar command basename -# Usage: bake.__path_basename [delimiter:default /] -bake.__path_basename() { - local pathLikeStr="$1" delimiter="${2:-/}" - # ${1##*/} => ## left remove until last "/" - echo "${pathLikeStr##*/}" -} - -# Samples: -# bake.__cmd_children -# => list root children -# bake.__cmd_children tests -# => list test children -bake.__cmd_children() ( - local path="${1:-root}" # default arg is root - - # ./bake bake info列出命令注册表，_bake_cmds数组长这样： - # cmd - bake.opt = bake.opt - # cmd - bake.parse = bake.parse - # cmd - bake.str_escape = bake.str_escape - # cmd - bake.str_unescape = bake.str_unescape - # cmd - bake.version = bake.version - # cmd - root = PARENT_CMD_NOT_FUNC - # cmd - study = PARENT_CMD_NOT_FUNC - # cmd - study.array = study.array - # cmd - study.declare = study.declare - - # 单独列出root的子命令 - if [[ "$path" == root ]]; then - for full_name in "${!_bake_cmds[@]}"; do - # 不包含'.'的命令是一级命令，即root的子命令 - [[ $full_name == *"."* ]] && continue; - [[ $full_name == "root" ]] && continue; - - echo "$full_name" - done - return 0 - fi - - # ${!_bake_data[@]}: get all array keys - for key in "${!_bake_cmds[@]}"; do - # if start $path - if [[ "$key" == "$path."* && "$key" != "$path" && "$key" != "root" ]]; then - # https://www.gnu.org/software/bash/manual/html_node/Shell-Parameter-Expansion.html - # remove prefix : key:a.b.c leftPathToBeCut:a => b.c - child=$(bake.__str_cutLeft "$key" "$path.") - # remove suffix: b.c => c - child=$(bake.__path_first "$child" ".") - printf '%s\n' "$child" - fi - done # | sort -u -) - -# Usage: bake.__cmd_up_chain -# sample: bake.__cmd_up_chain a.b => "a.b", "a", "root" -bake.__cmd_up_chain() { - local path="${1:-root}" - local up="$path" - while [[ "$up" != "" ]]; do - printf '%s\n' "$up" - up=$(bake.__path_dirname "$up" ".") - done - if [[ "$path" != "root" ]]; then printf "root\n"; fi -} -# Usage: bake.__cmd_down_chain -# reverse of bake.__cmd_up_chain -bake.__cmd_down_chain() { - bake.__cmd_up_chain "$1" | bake.__str_revertLines -} - - -# 列出命令所有选项，子命令会继承父命令选项 -# Usage: bake.__opts -# Examples: -# ./test.bash bake.__opts bake.opt -# bake.opt/opts/short -# bake.opt/opts/cmd -# bake.opt/opts/default -# bake.opt/opts/desc -# bake.opt/opts/long -# bake.opt/opts/required -# bake.opt/opts/type -# root/opts/debug -# root/opts/help -# root/opts/interactive -bake.__opts() { - local cmd=$1 - local upCmds - readarray -t upCmds <<<"$(bake.__cmd_up_chain "$cmd")" - - local key - for key in "${!_bake_data[@]}"; do - if [[ "${_bake_data["$key"]}" != "type:opt" ]]; then continue; fi - local upCmd - for upCmd in "${upCmds[@]}"; do - if [[ "$key" == "$upCmd/opts/"* ]]; then - printf '%s\n' "$key" - fi - done - done | sort -} - -# only use by bake.opt, -# because "bake.opt" is meta function, use this func to add self -bake.__opt_internal_add() { - local cmd="$1" long="$2" short="$3" type="$4" required="$5" default="$6" desc="$7" - _bake_data["$cmd/opts/$long"]="type:opt" - _bake_data["$cmd/opts/$long/long"]="$long" - _bake_data["$cmd/opts/$long/short"]="$short" - _bake_data["$cmd/opts/$long/type"]="$type" - _bake_data["$cmd/opts/$long/required"]="$required" - _bake_data["$cmd/opts/$long/default"]="$default" - _bake_data["$cmd/opts/$long/desc"]="$desc" -} - - -# Usage: bake.__cmd_register -# ensure all cmd register -bake.__cmd_register() { - local functionName - - while IFS=$'\n' read -r functionName; do - if [[ "$functionName" == */* ]]; then - echo "error: function $functionName() can not contains '/' " >&2 - return 1 - fi - local upCmd - for upCmd in $(bake.__cmd_up_chain "$functionName"); do - # if upCmd is a function , set upCmd value to data path - if compgen -A function | grep -q "^$upCmd$"; then - _bake_cmds["$upCmd"]="$upCmd" - else - _bake_cmds["$upCmd"]="PARENT_CMD_NOT_FUNC" - fi - done - - # declare -F | grep "declare -f" 列出函数列表 - # => declare -f bake.cmd - # cut : - # -d " " => 指定delim分割符 - # -f 3 => 指定list列出第3个字段即函数名 - done <<< "$(declare -F | grep "declare -f" | cut -d " " -f 3) " -} - -# 显示一条命令的帮助 -# Usage: bake.__help -# Examples: bake.__help deploy #显示deploy的帮助: -bake.__help() { - local cmd="${1:?bake.__help() required 'cmd' arg, Usage: bake.__help }" - shift - - echo - - if [[ "$cmd" == "root" ]] ;then - echo "Running:【: $(bake.__pwd)/$BAKE_FILE $*】" - else - echo "Running:【$(bake.__pwd)/$BAKE_FILE $cmd $*】" - fi - - # shellcheck disable=SC2154 - if [[ "$__debug" == true ]] ;then - echo "============================" - echo "__debug : $__debug" - echo "__help : $__help" - echo "\$* : 【$*】" - echo "BASH_SOURCE : 【${BASH_SOURCE[*]}】" - echo "========================================" - fi - - echo - echo "${_bake_data["${cmd}/desc"]}" - echo - - echo "Available Options:" - for optPath in $(bake.__opts "$cmd"); do - local opt - opt=$(bake.__path_basename "$optPath") - local long=${_bake_data["$optPath/long"]} - local type=${_bake_data["$optPath/type"]} - local required=${_bake_data["$optPath/required"]} - local short=${_bake_data["$optPath/short"]} - local default=${_bake_data["$optPath/default"]} - local desc="${_bake_data["$optPath/desc"]}" - - local optArgDesc="" - if [[ "$type" == "string" ]]; then - if [[ "$default" != "" ]]; then - optArgDesc+="<$type:${default}>" - else - optArgDesc="<$type>" - fi - fi - - printf " --%-20s -%-2s %-6s required:[%s] %b\n" "$long $optArgDesc" "$short" "$type" "$required" "$desc" - done - - echo " -Available Commands:" - for subCmd in $(bake.__cmd_children "$cmd"); do - - # only show public cmd if not verbose - # '_'起头的命令和'bake'命令，只有debug模式才打印出来 - if [[ ("$subCmd" == _* || "$subCmd" == bake*) ]]; then - if [[ "$__debug" != "true" ]]; then - continue - fi - fi - - local subCmdPath="$cmd/$subCmd" - [[ "$cmd" == "root" ]] && subCmdPath="$subCmd" - - local desc="${_bake_data["$subCmdPath/desc"]}" - desc="$(echo -e "$desc" | head -n 1 )" # backslash escapes interpretation - - - local maxLengthOfCmd=0 - for child in $(bake.__cmd_children "$cmd"); do - if ((${#child} > maxLengthOfCmd)); then maxLengthOfCmd=${#child}; fi - done - printf " %-$((maxLengthOfCmd))s ${desc}\n" "${subCmd}" - done -} - - -bake.__go_parse() { - # parse cmd : - # ./bake pub get -v -b - # -> { cmd:"pub.get", args:"-v -b" } - # ./bake -h - # -> { cmd:"", args:"-h" } - local cmd nextCmd arg - for arg in "$@"; do - nextCmd="$([[ "$cmd" == "" ]] && echo "$arg" || echo "$cmd.$arg")" - if [[ "${_bake_cmds["$nextCmd"]}" == "" ]]; then break; fi - cmd="$nextCmd" - shift - done - - if [[ "$cmd" == "" ]]; then cmd="root"; fi - eval "$(bake.parse "$cmd" "$@")" - - # shellcheck disable=SC2154 - if [[ "$__help" == "true" ]]; then - echo bake.__help "$cmd" "$@" - return 0 - fi - - # if fileExist then show help - if ! declare -F "$cmd" | grep "$cmd" &>/dev/null 2>&1; then - if [[ "${_bake_cmds["$cmd"]}" == "PARENT_CMD_NOT_FUNC" ]]; then - echo bake.__help "$cmd" "$@" - return 0 - fi - bake.__throw "Error: 404 ,cmd '${cmd}' not define, please define cmd function '${cmd}()'" - fi - - echo "$cmd" "$@" -} - -########################################## -# bake api function -# 下面都是公开函数 -########################################## - - -# bake.opt (public api) -# 为cmd配置option -# Examples: -# bake.opt --cmd "build" --long "is_zip" --type bool --required --short z --default true --desc "is_zip, build项目时是否压缩" -# bake.opt自己的options: -# cmd: 参数作用的命令全名 -# long: 参数长名，可以 ./bake build --is_zip 这样使用 -# type: 类型，目前支持 bool|string|list -# required: 是否必须提供，不提供将报错 -# short: 参数短名, 可以 ./bake build -z 这样使用 -# default: 缺省值, 未指定参数时，使用此值 -# desc: 参数帮助，将显示在‘./bake build -h’命令帮助里 -# 参考[bake.parse] -bake.opt() { - local __long __short __type __required __cmd __default __desc - # 本函数自己的options定义在本文件最下方 - eval "$(bake.parse "$@")" - if [[ "$__long" == "" ]]; then - echo "error: option required [--long]" >&2 && return 1 - fi - if [[ "$__type" == "" ]]; then - echo "error: option required [--type]" >&2 && return 1 - fi - if [[ "$__type" != "bool" && "$__type" != "string" && "$__type" != "list" ]]; then - echo "error: option [--type] must in [bool|string|list] " >&2 && return 1 - fi - bake.__opt_internal_add "$__cmd" "$__long" "$__short" "$__type" "${__required:-false}" "$__default" "$__desc" -} - -# bake.opt (public api) -# 像其他高级语言的cli工具一样，用简单变量就可以获取名称化的命令参数: -# 支持bool,string,list三种参数，用法如下： -# 你的./bake脚本里： -# bake.opt --cmd build --long "is_zip" --type bool -# bake.opt --cmd build --long "target" --type string -# bake.opt --cmd build --long "files" --type string -# function build() { -# # 模版代码，把生成的脚本eval出来 -# eval "$(bake.parse "$@")"; - -# echo "is_zip:$is_zip, target:$target, hosts:${hosts[@]}"; -# } -# 调用： -# ./bake build --target "macos" --is_zip --host host1 --host2 -# 调用结果是'bake.parse "$@"'将生成如下脚本: -# --------------------------------------------------------- -# declare __is_zip=true -# declare __target="macos" -# declare __hosts=("host1" "host2") -# declare __option_count=7 -# shift 6 -# --------------------------------------------------------- -# eval后，就可以直接使用变量了, 在函数中declare，不带-g参数默认为local变量，不会影响全局环境。 -# -# Usage: 固定格式：bake.parse "$@" -# 参考：[bake.opt] -bake.parse() { - local cmd="${FUNCNAME[1]}" - - # key is -h --help ... candidate words , - # value is optPath - declare -A allOptOnCmdChain - # collect opt from command chain : root>pub>pub.get - # root option first , priority low -> priority high: - for optPath in $(bake.__opts "$cmd" | bake.__str_revertLines); do - local opt - opt=$(bake.__path_basename "$optPath") - local short - short=${_bake_data["$optPath/short"]} - allOptOnCmdChain["--$opt"]="${optPath}" - if [[ "$short" != "" ]]; then allOptOnCmdChain["-$short"]="${optPath}"; fi - done - - # dynamic opt variable map : optPath:optVarName - # Why use dynamic variables: because the variable long is not fixed - # and We want to manipulate arrays(list type opt) more conveniently - local -A optVars - local totalArgs="$#" - # while all args , until it is not opt - while (($# > 0)); do - # match $1 arg in allOptOnCmdChain, guess $1 is a "-h" "-help" ... - local optPath - optPath=${allOptOnCmdChain["$1"]} - # if next arg not a opt , parsing complete; - if [[ "${optPath}" == "" ]]; then break; fi - - # __ prefix : avoid conflicts - optVars["$optPath"]="__$(bake.__path_basename "$optPath")" - declare "${optVars["$optPath"]}" - # reference to the current dynamic opt variable - declare -n currentOptValue=${optVars["$optPath"]} - - local optType=${_bake_data["$optPath/type"]} - case $optType in - bool) - currentOptValue=true - shift 1 - ;; - string) - [[ ! "${2+declare}" ]] && echo "parse error: opt need a value: $arg " >&2 && return 1 - currentOptValue="$2" - shift 2 - ;; - list) - [[ ! "${2+declare}" ]] && echo "parse error: opt need a value: $arg " >&2 && return 1 - currentOptValue+=("$2") # array add - shift 2 - ;; - *) - echo "parse error: not support $optPath.type: <$optType> " >&2 - return 1 - ;; - esac - done - for optPath in "${!optVars[@]}"; do - declare -p "${optVars["$optPath"]}" - done - echo "shift $(( totalArgs - $# ))" -} - - -# bake.cmd (public api) -# 注册一个命令的帮助信息 -# Examples: -# bake.cmd --cmd build --desc "build project" -# 尤其是可以配置root命令以定制根命令的帮助信息，比如: -# bake.cmd --cmd root \ -# --desc "flutter-note cli." -# 这样就可以用'./your_script -h' 查看根帮助了 -bake.cmd() { - local __cmd __desc - # 模版代码，放到每个需要使用option的函数中，然后就可以使用option了 - eval "$(bake.parse "$@")" - - if [[ "$__cmd" == "" ]]; then - echo "error: bake.cmd [--cmd] required " >&2 - return 1 - fi - _bake_data["$__cmd/desc"]="$__desc" -} - - -# list bake var info(public api),use for debug -# Usage: info -bake.info() { - -cat <<- EOF - - .----------------. .----------------. .----------------. .----------------. -| .--------------. || .--------------. || .--------------. || .--------------. | -| | ______ | || | __ | || | ___ ____ | || | _________ | | -| | |_ _ \ | || | / \ | || | |_ ||_ _| | || | |_ ___ | | | -| | | |_) | | || | / /\ \ | || | | |_/ / | || | | |_ \_| | | -| | | __'. | || | / ____ \ | || | | __'. | || | | _| _ | | -| | _| |__) | | || | _/ / \ \_ | || | _| | \ \_ | || | _| |___/ | | | -| | |_______/ | || ||____| |____|| || | |____||____| | || | |_________| | | -| | | || | | || | | || | | | -| '--------------' || '--------------' || '--------------' || '--------------' | - '----------------' '----------------' '----------------' '----------------' - -EOF - echo '# bake info & internal var' - echo - echo '## _bake_cmds' - for key in "${!_bake_cmds[@]}"; do - printf "%-60s = %q\n" "_bake_cmds[$key]" "${_bake_cmds["$key"]:0:100}" - done | sort - echo - echo '## _bake_data' - for key in "${!_bake_data[@]}"; do - printf "%-60s = %q\n" "_bake_data[$key]" "${_bake_data["$key"]:0:100}" - done | sort - echo - echo '## options' - echo "help = $__help" - echo "debug = $__debug" - echo - echo '## env' - echo "BASH_SOURCE = ${BASH_SOURCE[*]}" - echo -} - -# 入口 (public api) -bake.go() { - # init register all cmd - bake.__cmd_register - - # ⚠️ 注意！本函数把外部参数作为命令执行，所以如果有变量一定要__xxxx__格式，避免影响外部程序 - # ⚠️ 高危场景：在a命令内执行传来的参数是高危操作，假设 : - # 1> a(){ local x="a()inner"; $@ ; } - # 2> b(){ echo "b()这里你猜能看到a的内部变量吗：x: $x" ; } - # 3> a b - # 打印结果 => 这里你猜能看到a的内部变量吗：x: a()inner - # - # 行3"a b",将使a函数在其内部执行b函数，这是高危操作，因为a函数的上下文暴露在b函数里，local也不例外 - # 所以我们用另一个函数bake.__go_parse隔离环境 - eval "$(bake.__go_parse "$@")" -} - - -# bake内部版本(public api) -bake.version(){ - echo "$_bake_version" -} - - -############################################################# -# bake tail 初始化区 -# bake.bash 在头head定义变量，尾tail执行初始化，中间只有函数 -############################################################# - -# Add the error catch first -#https://www.gnu.org/software/bash/manual/html_node/Bourne-Shell-Builtins.html#index-trap -trap "bake.__on_error" ERR - -# 低级模式定义bake.opt函数的options -# bake.opt函数是注册options用的， 它自己也需要options，所以只能这样低级模式定义，吃自己的狗粮 -bake.__opt_internal_add bake.opt "cmd" "" "string" "true" "" "cmd name" -bake.__opt_internal_add bake.opt "long" "" "string" "true" "" "option long option: --port --host ..." -bake.__opt_internal_add bake.opt "type" "" "string" "true" "" "option type [bool|string|list]" -bake.__opt_internal_add bake.opt "required" "" "bool" "false" "false" "option required [true|false],default[false]" -bake.__opt_internal_add bake.opt "short" "" "string" "false" "" "option short option: -a -b -d ..." -bake.__opt_internal_add bake.opt "default" "" "string" "false" "" "option default" -bake.__opt_internal_add bake.opt "desc" "" "string" "false" "" "option desc" - -# !!! 这之后，再也不用 低级option模式bake.__opt_internal_add - -# 高级模式定义bake.cmd的options -bake.opt --cmd "bake.cmd" --long "cmd" --type string --desc "cmd function " -bake.opt --cmd "bake.cmd" --long "desc" --type string --desc "cmd desc, show in help" - -# root is special cmd(you can define it), bake add some common options to this cmd, you can add yourself options -bake.opt --cmd root --long "help" --short h --type bool --default false --desc "print help, show all commands" -bake.opt --cmd root --long "debug" --short d --type bool --default false --desc "debug mode, print more internal info" - -# TODO 非lib模式，即直接执行bake.bash,暂时未搞好 -if ((${#BASH_SOURCE[@]} == 1)); then - bake.go "$@" -fi - -# !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!! -# bake common script end line. -# The above code is common code that is not related to the specific app, -# if you want to define app-related commands, -# please put them below or other file. -# !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!! \ No newline at end of file