chore: update for upgrading version to 3.x; rename dir test-cases to test 🆙

oldratlee · oldratlee · commit 5727aef90b00 · 2024-04-12T18:15:54.000+08:00
diff --git a/.github/workflows/ci.yaml b/.github/workflows/ci.yaml
@@ -24,7 +24,7 @@ jobs:
         # 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
+      - run: test/integration-test.sh
       # https://remarkablemark.org/blog/2017/10/12/check-git-dirty/
       - name: Check git dirty
         run: |
diff --git a/.github/workflows/lint.yaml b/.github/workflows/lint.yaml
@@ -15,7 +15,7 @@ jobs:
       - uses: actions/checkout@v4
         with:
           submodules: recursive
-      - run: test-cases/lint.sh
+      - run: test/lint.sh
       # https://remarkablemark.org/blog/2017/10/12/check-git-dirty/
       - name: Check git dirty
         run: |
diff --git a/.gitmodules b/.gitmodules
@@ -1,3 +1,3 @@
-[submodule "test-cases/shunit2"]
-	path = test-cases/shunit2-lib
+[submodule "test/shunit2"]
+	path = test/shunit2-lib
 	url = https://github.com/kward/shunit2.git
diff --git a/README.md b/README.md
@@ -1,7 +1,7 @@
 # <div align="center"><a href="#dummy"><img src="https://github.com/oldratlee/useful-scripts/assets/1063891/990d7ab3-1a84-4024-b1c6-4c8d441dcfc6" alt="🐌 useful-scripts"></a></div>
 
 <p align="center">
-<a href="https://github.com/oldratlee/useful-scripts/actions/workflows/ci.yaml"><img src="https://img.shields.io/github/actions/workflow/status/oldratlee/useful-scripts/ci.yaml?branch=dev-2.x&logo=github&logoColor=white" alt="Github Workflow Build Status"></a>
+<a href="https://github.com/oldratlee/useful-scripts/actions/workflows/ci.yaml"><img src="https://img.shields.io/github/actions/workflow/status/oldratlee/useful-scripts/ci.yaml?branch=dev-3.x&logo=github&logoColor=white" alt="Github Workflow Build Status"></a>
 <a href="https://github.com/oldratlee/useful-scripts/releases"><img src="https://img.shields.io/github/release/oldratlee/useful-scripts.svg" alt="GitHub release"></a>
 <a href="https://www.apache.org/licenses/LICENSE-2.0.html"><img src="https://img.shields.io/github/license/oldratlee/useful-scripts?color=4D7A97&logo=apache" alt="License"></a>
 <a href="https://github.com/oldratlee/useful-scripts/stargazers"><img src="https://img.shields.io/github/stars/oldratlee/useful-scripts?style=flat" alt="GitHub Stars"></a>
@@ -52,7 +52,7 @@
 ----------------------
 
 ```bash
-source <(curl -fsSL https://raw.githubusercontent.com/oldratlee/useful-scripts/release-2.x/test-cases/self-installer.sh)
+source <(curl -fsSL https://raw.githubusercontent.com/oldratlee/useful-scripts/release-3.x/test/self-installer.sh)
 ```
 
 更多下载&使用方式，参见[下载使用](docs/install.md)。
diff --git a/bin/a2l b/bin/a2l
@@ -6,7 +6,7 @@
 #   $ ./a2l arg1 arg2
 #   $ ./a2l *.txt
 #
-# @online-doc https://github.com/oldratlee/useful-scripts/blob/dev-2.x/docs/shell.md#-a2l
+# @online-doc https://github.com/oldratlee/useful-scripts/blob/dev-3.x/docs/shell.md#-a2l
 # @author Jerry Lee (oldratlee at gmail dot com)
 set -eEuo pipefail
 
diff --git a/bin/ap b/bin/ap
@@ -8,7 +8,7 @@
 #   # print Absolute Path of arguments.
 #   $ ./ap a.txt ../dir1/b.txt
 #
-# @online-doc https://github.com/oldratlee/useful-scripts/blob/dev-2.x/docs/shell.md#-ap-and-rp
+# @online-doc https://github.com/oldratlee/useful-scripts/blob/dev-3.x/docs/shell.md#-ap-and-rp
 # @author Jerry Lee (oldratlee at gmail dot com)
 set -eEuo pipefail
 
diff --git a/bin/c b/bin/c
@@ -7,7 +7,7 @@
 #   $ ls -l | c
 #   $ c -q < ~/.ssh/id_rsa.pub
 #
-# @online-doc https://github.com/oldratlee/useful-scripts/blob/dev-2.x/docs/shell.md#-c
+# @online-doc https://github.com/oldratlee/useful-scripts/blob/dev-3.x/docs/shell.md#-c
 # @author Jerry Lee (oldratlee at gmail dot com)
 set -eEuo pipefail
 
diff --git a/bin/coat b/bin/coat
@@ -7,7 +7,7 @@
 #   $ coat /path/to/file1
 #   $ coat /path/to/file1 /path/to/file2
 #
-# @online-doc https://github.com/oldratlee/useful-scripts/blob/dev-2.x/docs/shell.md#-coat
+# @online-doc https://github.com/oldratlee/useful-scripts/blob/dev-3.x/docs/shell.md#-coat
 # @author Jerry Lee (oldratlee at gmail dot com)
 set -eEuo pipefail
 
diff --git a/bin/cp-into-docker-run b/bin/cp-into-docker-run
@@ -5,7 +5,7 @@
 # Example:
 #  cp-into-docker-run -c container_foo command_copied_into_container command_arg1
 #
-# @online-doc https://github.com/oldratlee/useful-scripts/blob/dev-2.x/docs/shell.md#-cp-into-docker-run
+# @online-doc https://github.com/oldratlee/useful-scripts/blob/dev-3.x/docs/shell.md#-cp-into-docker-run
 # @author Jerry Lee (oldratlee at gmail dot com)
 set -eEuo pipefail
 
diff --git a/bin/echo-args b/bin/echo-args
@@ -2,7 +2,7 @@
 # @Function
 # print arguments in human and debugging friendly style.
 #
-# @online-doc https://github.com/oldratlee/useful-scripts/blob/dev-2.x/docs/shell.md#-echo-args
+# @online-doc https://github.com/oldratlee/useful-scripts/blob/dev-3.x/docs/shell.md#-echo-args
 # @author Jerry Lee (oldratlee at gmail dot com)
 set -eEuo pipefail
 
diff --git a/bin/find-in-jars b/bin/find-in-jars
@@ -11,7 +11,7 @@
 #   $ find-in-jars 'Service\.class$' -e jar -e zip
 #   $ find-in-jars 'Mon[^$/]*Service\.class$' -s ' <-> '
 #
-# @online-doc https://github.com/oldratlee/useful-scripts/blob/dev-2.x/docs/java.md#-find-in-jars
+# @online-doc https://github.com/oldratlee/useful-scripts/blob/dev-3.x/docs/java.md#-find-in-jars
 # @author Jerry Lee (oldratlee at gmail dot com)
 set -eEuo pipefail
 
diff --git a/bin/rp b/bin/rp
@@ -8,7 +8,7 @@
 #   # if more than 1 argument, print relative path to last argument.
 #   $ ./rp a.txt ../b.txt /etc/passwd /etc/apache2
 #
-# @online-doc https://github.com/oldratlee/useful-scripts/blob/dev-2.x/docs/shell.md#-ap-and-rp
+# @online-doc https://github.com/oldratlee/useful-scripts/blob/dev-3.x/docs/shell.md#-ap-and-rp
 # @author Jerry Lee (oldratlee at gmail dot com)
 set -eEuo pipefail
 
diff --git a/bin/show-busy-java-threads b/bin/show-busy-java-threads
@@ -5,7 +5,7 @@
 # @Usage
 #   $ ./show-busy-java-threads
 #
-# @online-doc https://github.com/oldratlee/useful-scripts/blob/dev-2.x/docs/java.md#-show-busy-java-threads
+# @online-doc https://github.com/oldratlee/useful-scripts/blob/dev-3.x/docs/java.md#-show-busy-java-threads
 # @author Jerry Lee (oldratlee at gmail dot com)
 # @author superhj1987 (superhj1987 at 126 dot com)
 
diff --git a/bin/show-duplicate-java-classes b/bin/show-duplicate-java-classes
@@ -11,7 +11,7 @@
 #   $ show-duplicate-java-classes -L path/to/lib_dir1 # search jars in the subdirectories of lib dir
 #   $ show-duplicate-java-classes -J path/to/lib_dir1 # search jars in the jar file
 #
-# @online-doc https://github.com/oldratlee/useful-scripts/blob/dev-2.x/docs/java.md#-show-duplicate-java-classes
+# @online-doc https://github.com/oldratlee/useful-scripts/blob/dev-3.x/docs/java.md#-show-duplicate-java-classes
 # @author tg123 (farmer1992 at gmail dot com)
 # @author Jerry Lee (oldratlee at gmail dot com)
 
diff --git a/bin/taoc b/bin/taoc
@@ -7,7 +7,7 @@
 #   $ taoc /path/to/file1
 #   $ taoc /path/to/file1 /path/to/file2
 #
-# @online-doc https://github.com/oldratlee/useful-scripts/blob/dev-2.x/docs/shell.md#-coat
+# @online-doc https://github.com/oldratlee/useful-scripts/blob/dev-3.x/docs/shell.md#-coat
 # @author Jerry Lee (oldratlee at gmail dot com)
 set -eEuo pipefail
 
diff --git a/bin/tcp-connection-state-counter b/bin/tcp-connection-state-counter
@@ -5,7 +5,7 @@
 # @Usage
 #   $ ./tcp-connection-state-counter
 #
-# @online-doc https://github.com/oldratlee/useful-scripts/blob/dev-2.x/docs/shell.md#-tcp-connection-state-counter
+# @online-doc https://github.com/oldratlee/useful-scripts/blob/dev-3.x/docs/shell.md#-tcp-connection-state-counter
 # @author Jerry Lee (oldratlee at gmail dot com)
 # @author @sunuslee (sunuslee at gmail dot com)
 set -eEuo pipefail
diff --git a/bin/uq b/bin/uq
@@ -7,7 +7,7 @@
 # @Usage
 #   uq [OPTION]... [INPUT [OUTPUT]]
 #
-# @online-doc https://github.com/oldratlee/useful-scripts/blob/dev-2.x/docs/shell.md#-uq
+# @online-doc https://github.com/oldratlee/useful-scripts/blob/dev-3.x/docs/shell.md#-uq
 # @author Zava Xu (zava.kid at gmail dot com)
 # @author Jerry Lee (oldratlee at gmail dot com)
 set -eEuo pipefail
diff --git a/bin/xpf b/bin/xpf
@@ -6,7 +6,7 @@
 # @Usage
 #   $ ./xpf file
 #
-# @online-doc https://github.com/oldratlee/useful-scripts/blob/dev-2.x/docs/shell.md#-xpl-and-xpf
+# @online-doc https://github.com/oldratlee/useful-scripts/blob/dev-3.x/docs/shell.md#-xpl-and-xpf
 # @author Jerry Lee (oldratlee at gmail dot com)
 set -eEuo pipefail
 
diff --git a/bin/xpl b/bin/xpl
@@ -5,7 +5,7 @@
 # @Usage
 #   $ ./xpf [file [file ...] ]
 #
-# @online-doc https://github.com/oldratlee/useful-scripts/blob/dev-2.x/docs/shell.md#-xpl-and-xpf
+# @online-doc https://github.com/oldratlee/useful-scripts/blob/dev-3.x/docs/shell.md#-xpl-and-xpf
 # @author Jerry Lee (oldratlee at gmail dot com)
 set -eEuo pipefail
 
diff --git a/docs/install.md b/docs/install.md
@@ -14,21 +14,21 @@ git clone git://github.com/oldratlee/useful-scripts.git
 cd useful-scripts
 
 # 使用Release分支的内容
-git checkout release-2.x
+git checkout release-3.x
 
 # 更新脚本
 git pull
 ```
 
 包含2个分支：
 
-- `dev-2.x`：开发分支
-- `release-2.x`：发布分支，功能稳定的脚本
+- `dev-3.x`：开发分支
+- `release-3.x`：发布分支，功能稳定的脚本
 
 当然如果你不想安装`git`，`github`是支持`svn`的：
 
 ```bash
-svn co https://github.com/oldratlee/useful-scripts/branches/release-2.x
+svn co https://github.com/oldratlee/useful-scripts/branches/release-3.x
 
 cd useful-scripts
 
@@ -41,29 +41,29 @@ PS：
 
 ### 打包下载
 
-下载文件[release-2.x.zip](https://github.com/oldratlee/useful-scripts/archive/release-2.x.zip)：
+下载文件[release-3.x.zip](https://github.com/oldratlee/useful-scripts/archive/release-3.x.zip)：
 
 ```bash
-wget --no-check-certificate https://github.com/oldratlee/useful-scripts/archive/release-2.x.zip
+wget --no-check-certificate https://github.com/oldratlee/useful-scripts/archive/release-3.x.zip
 
-unzip release-2.x.zip
+unzip release-3.x.zip
 ```
 
 下载和运行单个文件
 -------------------
 
-以[`show-busy-java-threads`](https://raw.github.com/oldratlee/useful-scripts/release-2.x/bin/show-busy-java-threads)为例。
+以[`show-busy-java-threads`](https://raw.github.com/oldratlee/useful-scripts/release-3.x/bin/show-busy-java-threads)为例。
 
 ### `curl`文件直接用`bash`运行
 
 ```bash
-curl -sLk 'https://raw.github.com/oldratlee/useful-scripts/release-2.x/bin/show-busy-java-threads' | bash
+curl -sLk 'https://raw.github.com/oldratlee/useful-scripts/release-3.x/bin/show-busy-java-threads' | bash
 ```
 
 ### 下载单个文件
 
 ```bash
-wget --no-check-certificate https://raw.github.com/oldratlee/useful-scripts/release-2.x/bin/show-busy-java-threads
+wget --no-check-certificate https://raw.github.com/oldratlee/useful-scripts/release-3.x/bin/show-busy-java-threads
 chmod +x show-busy-java-threads
 
 ./show-busy-java-threads
diff --git a/docs/shell.md b/docs/shell.md
@@ -198,8 +198,8 @@ B.java
 # 把参数按行输出方便查看 或是 grep
 $ a2l **/*.sh
 lib/console-text-color-themes.sh
-test-cases/parseOpts_test.sh
-test-cases/self-installer.sh
+test/parseOpts_test.sh
+test/self-installer.sh
 ...
 ```
 
diff --git a/legacy-bin/cp-svn-url b/legacy-bin/cp-svn-url
@@ -6,7 +6,7 @@
 #   $ ./cp-svn-url
 #   $ ./cp-svn-url /path/to/svn/work/dir
 #
-# @online-doc https://github.com/oldratlee/useful-scripts/blob/dev-2.x/docs/vcs.md#-cp-svn-url
+# @online-doc https://github.com/oldratlee/useful-scripts/blob/dev-3.x/docs/vcs.md#-cp-svn-url
 # @author ivanzhangwb (ivanzhangwb at gmail dot com)
 
 readonly PROG=${0##*/}
diff --git a/legacy-bin/svn-merge-stop-on-copy b/legacy-bin/svn-merge-stop-on-copy
@@ -7,7 +7,7 @@
 #   $ ./svnmerge.sh <source branch> [target branch]
 #   if no target branch, merge to current svn direcotry
 #
-# @online-doc https://github.com/oldratlee/useful-scripts/blob/dev-2.x/docs/vcs.md#-svn-merge-stop-on-copy
+# @online-doc https://github.com/oldratlee/useful-scripts/blob/dev-3.x/docs/vcs.md#-svn-merge-stop-on-copy
 # @author jiangjizhong(@jzwlqx)
 # @author Jerry Lee (oldratlee at gmail dot com)
 
diff --git a/legacy-bin/swtrunk b/legacy-bin/swtrunk
@@ -5,7 +5,7 @@
 # @Usage
 #   $ ./swtrunk [<svn work dir>...]
 #
-# @online-doc https://github.com/oldratlee/useful-scripts/blob/dev-2.x/docs/vcs.md#-swtrunk
+# @online-doc https://github.com/oldratlee/useful-scripts/blob/dev-3.x/docs/vcs.md#-swtrunk
 # @author Jerry Lee (oldratlee at gmail dot com)
 
 colorEcho() {
diff --git a/lib/console-text-color-themes.sh b/lib/console-text-color-themes.sh
@@ -2,7 +2,7 @@
 # @Function
 # show all console text color themes.
 #
-# @online-doc https://github.com/oldratlee/useful-scripts/blob/dev-2.x/docs/shell.md#-console-text-color-themessh
+# @online-doc https://github.com/oldratlee/useful-scripts/blob/dev-3.x/docs/shell.md#-console-text-color-themessh
 # @author Jerry Lee (oldratlee at gmail dot com)
 
 colorEcho() {
diff --git a/lib/parseOpts.sh b/lib/parseOpts.sh
@@ -15,7 +15,7 @@
 #           _OPT_VALUE_c_long = (c.sh -p pv -q qv arg1) # Array type
 #           _OPT_ARGS = (aa bb cc) # Array type
 #
-# @online-doc https://github.com/oldratlee/useful-scripts/blob/dev-2.x/docs/shell.md#-parseoptssh
+# @online-doc https://github.com/oldratlee/useful-scripts/blob/dev-3.x/docs/shell.md#-parseoptssh
 # @author Jerry Lee (oldratlee at gmail dot com)
 
 #####################################################################
diff --git a/test/bump-scripts-version.sh b/test/bump-scripts-version.sh
@@ -58,7 +58,7 @@ die() {
 # biz logic
 ################################################################################
 
-(($# != 1)) && die "need only 1 argument for version!$NL${NL}usage:$NL  $0 2.x.y"
+(($# != 1)) && die "need only 1 argument for version!$NL${NL}usage:$NL  $0 3.x.y"
 readonly bump_version=$1
 
 # adjust current dir to project dir
diff --git a/test/integration-test.sh b/test/integration-test.sh
diff --git a/test/lint.sh b/test/lint.sh
diff --git a/test/my_unit_test_lib.sh b/test/my_unit_test_lib.sh
diff --git a/test/parseOpts_test.sh b/test/parseOpts_test.sh
diff --git a/test/self-installer.sh b/test/self-installer.sh
@@ -2,7 +2,7 @@
 
 if type -P svn &>/dev/null; then
   [ ! -d "/tmp/useful-scripts-$USER" ] &&
-    svn checkout https://github.com/oldratlee/useful-scripts/branches/release-2.x "/tmp/useful-scripts-$USER"
+    svn checkout https://github.com/oldratlee/useful-scripts/branches/release-3.x "/tmp/useful-scripts-$USER"
 fi
 
 export PATH="$PATH:/tmp/useful-scripts-$USER/bin:/tmp/useful-scripts-$USER/legacy-bin"
diff --git a/test/shunit2-lib b/test/shunit2-lib
diff --git a/test/uq_test.sh b/test/uq_test.sh
diff --git a/test/uq_test_another_input b/test/uq_test_another_input
diff --git a/test/uq_test_input b/test/uq_test_input

Original file line number	Diff line number	Diff line change
`@@ -6,7 +6,7 @@`
`6`	`6`	`# $ ./a2l arg1 arg2`
`7`	`7`	`# $ ./a2l *.txt`
`8`	`8`	`#`
`9`		`-# @online-doc https://github.com/oldratlee/useful-scripts/blob/dev-2.x/docs/shell.md#-a2l`
	`9`	`+# @online-doc https://github.com/oldratlee/useful-scripts/blob/dev-3.x/docs/shell.md#-a2l`
`10`	`10`	`# @author Jerry Lee (oldratlee at gmail dot com)`
`11`	`11`	`set -eEuo pipefail`
`12`	`12`
Original file line number	Diff line number	Diff line change
`@@ -8,7 +8,7 @@`
`8`	`8`	`# # print Absolute Path of arguments.`
`9`	`9`	`# $ ./ap a.txt ../dir1/b.txt`
`10`	`10`	`#`
`11`		`-# @online-doc https://github.com/oldratlee/useful-scripts/blob/dev-2.x/docs/shell.md#-ap-and-rp`
	`11`	`+# @online-doc https://github.com/oldratlee/useful-scripts/blob/dev-3.x/docs/shell.md#-ap-and-rp`
`12`	`12`	`# @author Jerry Lee (oldratlee at gmail dot com)`
`13`	`13`	`set -eEuo pipefail`
`14`	`14`
Original file line number	Diff line number	Diff line change
`@@ -7,7 +7,7 @@`
`7`	`7`	`# $ ls -l \| c`
`8`	`8`	`# $ c -q < ~/.ssh/id_rsa.pub`
`9`	`9`	`#`
`10`		`-# @online-doc https://github.com/oldratlee/useful-scripts/blob/dev-2.x/docs/shell.md#-c`
	`10`	`+# @online-doc https://github.com/oldratlee/useful-scripts/blob/dev-3.x/docs/shell.md#-c`
`11`	`11`	`# @author Jerry Lee (oldratlee at gmail dot com)`
`12`	`12`	`set -eEuo pipefail`
`13`	`13`
Original file line number	Diff line number	Diff line change
`@@ -7,7 +7,7 @@`
`7`	`7`	`# $ coat /path/to/file1`
`8`	`8`	`# $ coat /path/to/file1 /path/to/file2`
`9`	`9`	`#`
`10`		`-# @online-doc https://github.com/oldratlee/useful-scripts/blob/dev-2.x/docs/shell.md#-coat`
	`10`	`+# @online-doc https://github.com/oldratlee/useful-scripts/blob/dev-3.x/docs/shell.md#-coat`
`11`	`11`	`# @author Jerry Lee (oldratlee at gmail dot com)`
`12`	`12`	`set -eEuo pipefail`
`13`	`13`
Original file line number	Diff line number	Diff line change
`@@ -5,7 +5,7 @@`
`5`	`5`	`# Example:`
`6`	`6`	`# cp-into-docker-run -c container_foo command_copied_into_container command_arg1`
`7`	`7`	`#`
`8`		`-# @online-doc https://github.com/oldratlee/useful-scripts/blob/dev-2.x/docs/shell.md#-cp-into-docker-run`
	`8`	`+# @online-doc https://github.com/oldratlee/useful-scripts/blob/dev-3.x/docs/shell.md#-cp-into-docker-run`
`9`	`9`	`# @author Jerry Lee (oldratlee at gmail dot com)`
`10`	`10`	`set -eEuo pipefail`
`11`	`11`
Original file line number	Diff line number	Diff line change
`@@ -2,7 +2,7 @@`
`2`	`2`	`# @Function`
`3`	`3`	`# print arguments in human and debugging friendly style.`
`4`	`4`	`#`
`5`		`-# @online-doc https://github.com/oldratlee/useful-scripts/blob/dev-2.x/docs/shell.md#-echo-args`
	`5`	`+# @online-doc https://github.com/oldratlee/useful-scripts/blob/dev-3.x/docs/shell.md#-echo-args`
`6`	`6`	`# @author Jerry Lee (oldratlee at gmail dot com)`
`7`	`7`	`set -eEuo pipefail`
`8`	`8`