[!IMPORTANT]
This is a WIP/cleanup release for upgrading version to 3.x

• remove legacy bin 🚮
• rename dir test-cases to test 🆙

It's time to say goodbye, my friend

It's been a long day without you my friend
And I'll tell you all about it when I see you again
We've come a long way from where we began
Oh I'll tell you all about it when I see you again

Have Fun! 💕
2024-04-15

☘️ Features

• [c]: ensure use command on path, and check the command existence on PATH 👣
• [coat/taoc]: add --help/--version options 🚩

🍬 Improvements

• [find-in-jars]: add IFS= for read, more robust 💪
  • file paths may contain leading spaces
• [show-busy-java-threads]:
  • improve Separator blank line output 💅 fix wrong blank line logic
  • extract timestamp var to avoid inconsistency ⌚️
• use ${var##} instead of basename 🎛️
  • faster, no subprocess fork
• use command realpath instead of function portableReadLink 🔗
  • faster and without losing portability

🛠️ Refactor

• [show-busy-java-threads]: rename global var USER -> WHOAMI 👤
• [uq]: use exponential operation instead of multiplication to calculate size 🧮
• [c]: rename functions 🔡
• use bash builtin type -P instead of which command 🐚
• extract UNAME var 🔠
• use Shell Arithmetic comparison instead of Conditional Expressions 🔢
• use ||/&& instead of one branch/one line if 🎰
• remove unnecessary file descriptor number 1 in redirections ➡️
• simplify and uniform the codes
  • remove declare for global vars, more consistent
  • use upper-case var name for global readonly vars
  • unset temp global vars after use
• unify error message format and refactor related functions ℹ️
  • keep usage function simple
  • use -s/-h option for optional argument of die function
  • use bash builtin type -P instead of which command 🐚
  • rename var, use COLOR_INDEX instead of COUNT
• small code cleanup
  • merge colorPrint function if only one caller
  • remove local nl=$'\n' declaration if only one usage
  • remove unnecessary {} when use var
  • use upper-case var name for global readonly vars
  • use = instead of == in Conditional Expressions
  • remove section comments for simple section
  • improve/fix/add code comments

📚 Documentation

• update manual pages links to manned.org 📚
• use shellcheck item doc link instead of prolixity comments ✨

🚜 Build/CI

• upgrade GitHub actions; add dependabot.yml 🤖
• upgrade shunit2 lib

Have Fun! 💕
2024-04-12

☘️ Improvements

• [show-busy-java-threads] support Java21 🆕 ☕️
  • missing stack on Java21, because Java21 changed the format of stack title line (issue #120 submmited by @jianyun)
• [show-busy-java-threads] improve separator blank line output format 💅

Have Fun! 💕
2024-02-18

🐞 BugFix

• coat/taoc: missing last line if there’s no newline at the end of the file 🌗 🙀
• find bash with /usr/bin/env in shebang (by @hyperupcall in #119) 🐚
• xpl: missing error exit code when file not existed or open file failure ❗️

🛠️ Improvements/Refactor

• coat/taoc: 🐈
  • remove pipe when naked cat
  • extract colorLines function
• awl: merge function colorPrint into rotateColorPrint 🛠️
• improve readability
  • remove var interpolation in printf format if possible
  • rename vars, e.g. message -> content, normal -> color_reset
  • use \e instead of \033
  • improve comments for -t check
• simplify var usage
  • remove unnecessary {} when use var
  • remove quote of values in simple assignment
    • All values undergo tilde expansion, parameter and variable expansion,
      command substitution, arithmetic expansion, and quote removal.
      Word splitting and filename expansion are not performed.
    • more info about assignment see
      https://www.gnu.org/software/bash/manual/html_node/Shell-Parameters.html

🚜 Build

• upgrade shunit2 lib

Have Fun! 💕
2024-01-25

🐞 BugFix

• c: wrong exit code with -q option 🐞

🛠️ Improvements/Refactor

• use ${array[@]:-}/${array[@]:+} to simplify codes 🚞
• use file descriptor number instead of /dev/std* (#114 by @wushengde)
• bump-scripts-version.sh:
  • fix Bash Pitfalls No.1/No.5
  • use printf instead of echo
• console-text-color-themes.sh:
  • use BASH_SOURCE array to detect whether this script is sourced or not 🕵️
  • use printf 💪 instead of echo
  • use if instead of &&
  • remove global var declare

📚 Documentation

• add more resources of bash 📚

Have Fun! 💕
2023-12-05

☘️ Features

• add taoc 🫴 🐈
• echo-args: align the index number

🛠️ Improvements/Refactor

• c, improve readable: 👓
  • simplify teeAndCopy function
  • use boolean option parse value holder
  • reanme var
• improve shell robustness/portability 💪
  • use printf instead of echo
  • use if-else instead of &&-||
  • involved almost all scripts:
    c/coat/a2l/echo-args/ap/rp/xpl/xpf/uq
cp-into-docker-run/tcp-connection-state-counter/console-text-color-themes.sh
find-in-jars/show-busy-java-threads
• fix shellcheck issues

📚 Documentation

• update logo and image links in docs 🌁
• disable default link of github images

🚜 Build/CI

• update ci.yaml, test on latest MacOS 🍎
• upgrade shunit2 lib

Have Fun! 💕
2023-09-06

Improvements/Refactor

• show-duplicate-java-classes: print info message and exit when search no jar files or find no class files ℹ️
• coat/a2l: skip color for white space lines 🌈
• refactor: declare var as readonly if possible 📌
  • more info in Google's Shell Style Guide:
  • https://zh-google-styleguide.readthedocs.io/en/latest/google-shell-styleguide/naming_conventions/#id4
  • https://zh-google-styleguide.readthedocs.io/en/latest/google-shell-styleguide/naming_conventions/#id6
• refactor: use $* in string instead of $@ 🚞

Style

• style: adjust file format 💅
  • update .editorconfig
  • shell files
    • use 2 spaces indentation
    • use $() instead of ``

Docs

• add dev guide #64 🎓
• add logo 🎨
• add TOC for README
• improve wording/format

Build/CI

• add github action ci.yaml(remove travis) 👷‍♀️
• add MacOS CI 🍎

Have Fun! 💕
2022-12-24

Improvements

• show-duplicate-java-classes:
  • fix wrong CPU percentage order under ps from procps-ng 3.3.12 🍢
  • use one option --cpu-sample-interval instead of --top-delay/--use-ps ⏳

Cleanup

• code cleanup
  • remove unused var
  • reorder parameters of function
• improve documentations
  • update travis badge to travis.com

Have Fun! 💕
2021-7-21

Improvements

• show-duplicate-java-classes:
  • output duplicate ratio and class number of class path #59 🕵️‍♂️
  • improve percent output format
• cp-into-docker-run:
  • check required option -c/--container 🗂
• code cleanup
• improve documentations: fix broken link #98

Have Fun! 💕
2021-5-16

Improvements

• show-busy-java-threads: 🕵️‍♂️
  • improve jstack command search order, JAVA_HOME before PATH
• find-in-jars:
  • check list zip entries fail, especially common case "Empty zipfile" 📭
  • improve command to list zip entries search 🕵️‍♂️
• improve scripts cp-into-docker-run/ap/xpf: use portableReadLink 🔗

BugFix

• xpl: fix unbound variable args[@] ♾

Have Fun! 💕
2021-4-30

New Features

1. add cp-into-docker-run 🗂

Improvements

• show-duplicate-java-classes: ☕️
  • improve jar in jar index marker
  • improve sort logic in print_duplicate_classes_info

Have Fun! 💕
2021-4-26

New Features

1. add version option for scripts #73 🎱
2. show-duplicate-java-classes:
   • show duplicate class paths total count 🔢
   • output class path index

Improvements

• show-duplicate-java-classes:
  • improve output sort 📶
    • sort by multiple keys:
      1. class paths count, descending
      2. duplicate classes count, descending
      3. class paths, ascending
    • sort also ensure output consistent for same input.
• find-in-jars:
  • performance improvement, use grep -c option reduce internal output
• show-busy-java-threads:
  • rename i to update_round_num
• improve help and docs 📚
• code refactor/cleanup

Have Fun! 💕
2021-4-5

New Features

1. show-busy-java-threads:
   • add "No java process found" check, output in error message 📭
   • add update_delay/update_count/pid_list option value validation
2. show-duplicate-java-classes:
   • show duplicate classes total count 🔢
   • output responsive progress info at console 🛎
   • add option -R, --no-find-progress, do not display responsive find progress 🔇
   • validate lib/class dir
3. find-in-jars:
   • add -L, --files-not-contained-found and -l, --files-contained-found options
   • add option -R, --no-find-progress, do not display responsive find progress 🔇
4. uq:
   • add max input defensive check option -XM, --max-input ⛑

BugFix

• show-busy-java-threads: fix top extract error by process name 👓
  • COMMAND column of top -H output can be thread name not process name
  • top output sample and env info:

    $ uname -a
    Linux 33e449b39f66 4.19.121-linuxkit #1 SMP Thu Jan 21 15:36:34 UTC 2021 x86_64 x86_64 x86_64 GNU/Linux
    $ java -version
    openjdk version "11.0.9.1" 2020-11-04
    OpenJDK Runtime Environment (build 11.0.9.1+1-Ubuntu-0ubuntu1.18.04)
    OpenJDK 64-Bit Server VM (build 11.0.9.1+1-Ubuntu-0ubuntu1.18.04, mixed mode, sharing)
    $ top -v
      procps-ng 3.3.12
    Usage:
      top -hv | -bcHiOSs -d secs -n max -u|U user -p pid(s) -o field -w [cols]
    $ top -H
      PID USER      PR  NI    VIRT    RES    SHR S %CPU %MEM     TIME+ COMMAND
    7012 jerry     20   0 3492604  79492  27096 S  0.0  3.9   0:00.00 java
    7014 jerry     20   0 3492604  79492  27096 S  0.0  3.9   0:00.62 GC Thread#0
    7015 jerry     20   0 3492604  79492  27096 S  0.0  3.9   0:00.00 G1 Main Marker
    7017 jerry     20   0 3492604  79492  27096 S  0.0  3.9   0:00.00 G1 Refine#0
    7018 jerry     20   0 3492604  79492  27096 S  0.0  3.9   0:00.06 G1 Young RemSet
    7019 jerry     20   0 3492604  79492  27096 S  0.0  3.9   0:00.67 VM Thread
    7020 jerry     20   0 3492604  79492  27096 S  0.0  3.9   0:00.00 Reference Handl
    7021 jerry     20   0 3492604  79492  27096 S  0.0  3.9   0:00.00 Finalizer
    7022 jerry     20   0 3492604  79492  27096 S  0.0  3.9   0:00.00 Signal Dispatch
    7023 jerry     20   0 3492604  79492  27096 S  0.0  3.9   0:00.34 C2 CompilerThre
    7024 jerry     20   0 3492604  79492  27096 S  0.0  3.9   0:00.03 C1 CompilerThre
    7025 jerry     20   0 3492604  79492  27096 S  0.0  3.9   0:00.00 Sweeper thread
    7026 jerry     20   0 3492604  79492  27096 S  0.0  3.9   0:00.00 Service Thread
    7027 jerry     20   0 3492604  79492  27096 S  0.0  3.9   0:00.26 VM Periodic Tas
    7032 jerry     20   0 3492604  79492  27096 S  0.0  3.9   0:00.52 GC Thread#1
    ...
    

Improvements

• show-busy-java-threads:
  • improve self rerun command line in output
• show-duplicate-java-classes:
  • refactor: split function build_index__class_to_class_paths to 2 small functions:
    • collect_class_path_to_classes
    • invert_as_class_to_class_paths
• find-in-jars:
  • improve responsive output, output jars searching message 👓
  • extract searchJarFiles function
• fix Bash Traps and Pitfalls:
  • DO NOT combine var declaration and assignment which value supplied by sub-shell!
• improve help and docs
• code refactor/cleanup

Have Fun! 💕
2021-4-1

New Features

1. show-duplicate-java-classes:
   • support find jar files in lib sub-dir and jar file recursively(add -L/-J option) 🌀
   • skip java 9 module-info files 📦
   • ignore BadZipFile for jar files 🙅‍♀️

Improvements

• uq: make it standalone 🧩
• find-in-jars: improve output, display responsive message on stderr
• c: fix absence of redEcho function
• echo-args: change output color
• improve output format, more human readable 👓
  • show-duplicate-java-classes
  • tcp-connection-state-counter
• add MacOS and multiply linux distributions in travis-ci 👨‍🚒
• fix typo in document: buildin -> builtin

Have Fun! 💕
2021-3-25

New Features

1. add new script uq 🦄
   https://github.com/oldratlee/useful-scripts/blob/dev-2.x/docs/shell.md#-uq
2. show-busy-java-threads:
   • support: set count 0 to show all threads

Improvements

• bash strict mode ⛑
  • use set -eEuo pipefail
  • use $* instead of $@ in string
  • use if-else instead of &&/||
  • use $() instead of ``
• add travis-ci 👨‍🚒
• add/use shUnit2 lib for Unit Test #39 ☂️
• improve multiply var declaration/read
  • read multiply var instead array
  • simplify the multiply local var deceleration

Code Cleanup

• add .gitignore/.editorconfig

Have Fun! 💕
2021-2-28

Normalized directory structure, New beginning!

• normalize directory structure: bin, lib, doc, etc #87 🆕✨💖

Have Fun! 💕
2019-12-02

Code Cleanup

1. improve help message: one line contains less 80 chars 🎶
   • show-busy-java-threads
   • find-in-jars
2. improve docs 📚
3. fix typo: seperator -> separator 🤡
   • show-busy-java-threads
   • find-in-jars

Have Fun! 💕
2019-06-01

Improvements

1. show-busy-java-threads:
   • check before write file ✍️
2. find-in-jars:
   • check dirs
3. coat & a2l
   • reorder color, avoid first line is red

Code Cleanup

1. show-busy-java-threads:
   • extract util functions: logAndRun, logAndCat
   • use satisfy condition or die pattern
   • use printf instead of print in awk script.
   • use pipe instead <(), improve readability. 😋
   • reorder/extract functions/variables.
2. find-in-jars:
   • use arithmetic operation
   • use satisfy condition or die pattern
   • use pipe instead <(), improve readability.
3. documentation:
   • compress png files 🐾
   • improve docs of coat, find-in-jars
   • improve format of markdown

Have Fun! 💕
2019-01-28

New Features

1. show-busy-java-threads:
   • store all intermediate output for review/debug #74 🍭
   • support command name jsvc to find java process #72 🌀

Bug Fix

1. show-busy-java-threads:
   • fix bug for top v3.2 #71 🎩

Improvements

1. show-busy-java-threads:
   • check append file of -a option #70 ☔
   • ensure output blank line between thread stacks #68
2. find-in-jars:
   • reecho wc -l, ensure no extra whitespace for jar file total count.

Code Cleanup

1. show-busy-java-threads:
   • use printf instead of print in awk script.
   • use pipe instead <(), improve readability. 😋
   • reorder/extract functions/variables.
2. find-in-jars:
   • use pipe instead <(), improve readability.

Have Fun! 💕
2018-6-17

New Features

1. show-busy-java-threads:
   • use top command to get percent of thread cpu usage 🎩 🎉
     you can use -P, --use-ps option so as to use ps command to find busy thead(cpu usage) instead of top command.
   • support -S, --jstack-file-dir option to specify the dir for storing jstack output files, and keep files. 🛐
     default store jstack output files at tmp dir, and auto remove after run.
     use this option to keep files so as to review jstack output later.
   • support -d, --top-delay option to specifies the delay between top samples. 😋
     get thread cpu percentage during this delay interval.
2. xpf/xpl:
   • support mac, parse option by hand instead of getopt #66 🍡

Bug Fix

1. show-busy-java-threads:
   • should re-jstack when next update
   • option parse fail should exit

Improvements

• show-busy-java-threads:
  • improve show-busy-java-threads help format 📚
  • improve output color 🌈
  • improve docs

Code Cleanup

• show-busy-java-threads:
  • main function style 💅
  • reorder functions
  • use ARITHMETIC EVALUATION explicitly instead of -gt etc 🔢

Have Fun! 💕
2018-5-22