[pull] dev-2.x from oldratlee:dev-2.x

.editorconfig

@@ -0,0 +1,23 @@
+root = true
+
+[*]
+charset = utf-8
+end_of_line = lf
+insert_final_newline = true
+tab_width = 4
+indent_style = space
+indent_size = 2
+trim_trailing_whitespace = true
+
+[*.{py,md,mkd,markdown}]
+indent_size = 4
+
+[*.xml]
+indent_style = tab
+
+[*.{md,mkd,markdown}]
+trim_trailing_whitespace = false
+
+# python files without extension
+[show-duplicate-java-classes]
+indent_size = 4

.github/dependabot.yml

@@ -0,0 +1,11 @@
+# To get started with Dependabot version updates, you'll need to specify which
+# package ecosystems to update and where the package manifests are located.
+# Please see the documentation for all configuration options:
+# https://docs.github.com/github/administering-a-repository/configuration-options-for-dependency-updates
+
+version: 2
+updates:
+  - package-ecosystem: github-actions
+    directory: /
+    schedule:
+      interval: daily

.github/workflows/ci.yaml

@@ -0,0 +1,32 @@
+# Quickstart for GitHub Actions
+# https://docs.github.com/en/actions/quickstart
+
+name: CI
+on: [ push, pull_request, workflow_dispatch ]
+
+jobs:
+
+  test:
+    runs-on: ${{ matrix.os }}
+    timeout-minutes: 5
+    strategy:
+      matrix:
+        os: [ ubuntu-latest, macos-11, macos-latest ]
+      fail-fast: false
+      max-parallel: 64
+    name: Test on ${{ matrix.os }}
+
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          submodules: recursive
+      - run: brew install coreutils gnu-sed
+        # https://docs.github.com/en/actions/learn-github-actions/variables#detecting-the-operating-system
+        # https://docs.github.com/en/actions/learn-github-actions/expressions
+        if: runner.os == 'macOS'
+      - run: test-cases/integration-test.sh
+      # https://remarkablemark.org/blog/2017/10/12/check-git-dirty/
+      - name: Check git dirty
+        run: |
+          git status --short
+          [ -z "$(git status --short)" ]

.github/workflows/lint.yaml

@@ -0,0 +1,23 @@
+# Quickstart for GitHub Actions
+# https://docs.github.com/en/actions/quickstart
+
+name: Lint
+on: [ push, pull_request, workflow_dispatch ]
+
+jobs:
+
+  test:
+    runs-on: ubuntu-latest
+    timeout-minutes: 5
+    name: Lint
+
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          submodules: recursive
+      - run: test-cases/lint.sh
+      # https://remarkablemark.org/blog/2017/10/12/check-git-dirty/
+      - name: Check git dirty
+        run: |
+          git status --short
+          [ -z "$(git status --short)" ]

.gitmodules

@@ -0,0 +1,3 @@
+[submodule "test-cases/shunit2"]
+	path = test-cases/shunit2-lib
+	url = https://github.com/kward/shunit2.git

bin/a2l

@@ -1,30 +1,92 @@
-#!/bin/bash
+#!/usr/bin/env bash
 # @Function
-# echo each arguments on one line colorfully.
+# print each arguments on one line colorfully.
 #
 # @Usage
 #   $ ./a2l arg1 arg2
 #   $ ./a2l *.txt
 #
 # @online-doc https://github.com/oldratlee/useful-scripts/blob/dev-2.x/docs/shell.md#-a2l
 # @author Jerry Lee (oldratlee at gmail dot com)
+set -eEuo pipefail
 
+readonly PROG=${0##*/}
+readonly PROG_VERSION='2.x-dev'
 
-# NOTE: $'foo' is the escape sequence syntax of bash
-readonly ec=$'\033' # escape char
-readonly eend=$'\033[0m' # escape end
+################################################################################
+# parse options
+################################################################################
 
-colorEcho() {
-    local color="$1"
-    shift
-    # check isatty in bash https://stackoverflow.com/questions/10022323
-    # if stdout is console, turn on color output.
-    [ -t 1 ] && echo "$ec[1;${color}m$@$eend" || echo "$@"
+usage() {
+  cat <<EOF
+Usage: $PROG [OPTION]... ARG...
+print each arguments on one line colorfully.
+
+Example:
+  $PROG arg1 arg2
+  $PROG */*.py
+
+Options:
+  -h, --help      display this help and exit
+  -V, --version   display version information and exit
+EOF
+
+  exit
+}
+
+progVersion() {
+  printf '%s\n' "$PROG $PROG_VERSION"
+  exit
 }
 
-readonly -a ECHO_COLORS=(33 35 36 31 32 37 34)
-COUNT=0
+args=()
+while (($# > 0)); do
+  case "$1" in
+  -h | --help)
+    usage
+    ;;
+  -V | --version)
+    progVersion
+    ;;
+  --)
+    shift
+    args=(${args[@]:+"${args[@]}"} "$@")
+    break
+    ;;
+  -*)
+    # if unrecognized option, treat it and all follow arguments as args
+    args=(${args[@]:+"${args[@]}"} "$@")
+    break
+    ;;
+  *)
+    # if not option, treat it and all follow arguments as args
+    args=(${args[@]:+"${args[@]}"} "$@")
+    break
+    ;;
+  esac
+done
+readonly args
+
+################################################################################
+# biz logic
+################################################################################
+
+readonly -a ROTATE_COLORS=(33 35 36 31 32 37 34)
+COLOR_INDEX=0
+rotateColorPrint() {
+  local content=$*
+  # - if stdout is a terminal, turn on color output.
+  #   '-t' check: is a terminal?
+  #   check isatty in bash https://stackoverflow.com/questions/10022323
+  # - skip color for white space
+  if [[ ! -t 1 || $content =~ ^[[:space:]]*$ ]]; then
+    printf '%s\n' "$content"
+  else
+    local color=${ROTATE_COLORS[COLOR_INDEX++ % ${#ROTATE_COLORS[@]}]}
+    printf '\e[1;%sm%s\e[0m\n' "$color" "$content"
+  fi
+}
 
-for a; do
-    colorEcho "${ECHO_COLORS[COUNT++ % ${#ECHO_COLORS[@]}]}" "$a"
+for a in ${args[@]:+"${args[@]}"}; do
+  rotateColorPrint "$a"
 done

bin/ap

@@ -1,4 +1,4 @@
-#!/bin/bash
+#!/usr/bin/env bash
 # @Function
 # convert to Absolute Path.
 #
@@ -10,13 +10,126 @@
 #
 # @online-doc https://github.com/oldratlee/useful-scripts/blob/dev-2.x/docs/shell.md#-ap-and-rp
 # @author Jerry Lee (oldratlee at gmail dot com)
+set -eEuo pipefail
 
-[ $# -eq 0 ] && files=(.) || files=("$@")
+readonly PROG=${0##*/}
+readonly PROG_VERSION='2.x-dev'
 
-for f in "${files[@]}" ; do
-    ! [ -e "$f" ] && {
-        echo "$f does not exists!"
-        continue
-    }
-    readlink -f "$f"
+################################################################################
+# util functions
+################################################################################
+
+errorMsgPrint() {
+  local errorMsg="$PROG: $*"
+  # if stdout is a terminal, turn on color output.
+  #   '-t' check: is a terminal?
+  #   check isatty in bash https://stackoverflow.com/questions/10022323
+  if [ -t 1 ]; then
+    printf '\e[1;31m%s\e[0m\n' "$errorMsg"
+  else
+    printf '%s\n' "$errorMsg"
+  fi
+} >&2
+
+die() {
+  local prompt_help=false exit_status=2
+  while (($# > 0)); do
+    case "$1" in
+    -h)
+      prompt_help=true
+      shift
+      ;;
+    -s)
+      exit_status=$2
+      shift 2
+      ;;
+    *)
+      break
+      ;;
+    esac
+  done
+
+  (($# > 0)) && errorMsgPrint "$*"
+  $prompt_help && echo "Try '$PROG --help' for more information."
+
+  exit "$exit_status"
+} >&2
+
+# `realpath` command exists on Linux and macOS, return resolved physical path
+#   - realpath command on macOS do NOT support option `-e`;
+#     combined `[ -e $file ]` to check file existence first.
+#   - How can I get the behavior of GNU's readlink -f on a Mac?
+#     https://stackoverflow.com/questions/1055671
+realpath() {
+  [ -e "$1" ] && command realpath -- "$1"
+}
+
+usage() {
+  cat <<EOF
+Usage: $PROG [OPTION]... [FILE]...
+convert to Absolute Path.
+
+Example:
+  $PROG arg1 arg2
+  $PROG */*.py
+
+Options:
+  -h, --help      display this help and exit
+  -V, --version   display version information and exit
+EOF
+
+  exit
+}
+
+progVersion() {
+  printf '%s\n' "$PROG $PROG_VERSION"
+  exit
+}
+
+################################################################################
+# parse options
+################################################################################
+
+files=()
+while (($# > 0)); do
+  case "$1" in
+  -h | --help)
+    usage
+    ;;
+  -V | --version)
+    progVersion
+    ;;
+  --)
+    shift
+    files=(${files[@]:+"${files[@]}"} "$@")
+    break
+    ;;
+  -*)
+    die -h "unrecognized option '$1'"
+    ;;
+  *)
+    # if not option, treat all follow files as args
+    files=(${files[@]:+"${files[@]}"} "$@")
+    break
+    ;;
+  esac
 done
+
+# if files is empty, use "."
+readonly files=("${files[@]:-.}")
+
+################################################################################
+# biz logic
+################################################################################
+
+has_error=false
+
+for f in "${files[@]}"; do
+  realpath "$f" || {
+    has_error=true
+    errorMsgPrint "$f: No such file or directory!"
+  }
+done
+
+# set exit status
+! $has_error