讓代碼整潔、過程清晰的BASH Shell編程技巧
這是我寫B(tài)ASH程序的招式。這里本沒有什么新的內(nèi)容，但是從我的經(jīng)驗來看，人們愛濫用BASH。他們忽略了計算機(jī)科學(xué)，而從他們的程序中創(chuàng)造的是“大泥球”（譯注：指架構(gòu)不清晰的軟件系統(tǒng)）。
在此我告訴你方法，以保護(hù)你的程序免于障礙，并保持代碼的整潔。
一、不可改變的全局變量
1.盡量少用全局變量
2.以大寫命名
3.只讀聲明
4.用全局變量來代替隱晦的$0，$1等
在我的程序中常使用的全局變量：
readonly PROGNAME=$(basename $0)
readonly PROGDIR=$(readlink -m $(dirname $0))
readonly ARGS="$@"
二、一切皆是局部的
所有變量都應(yīng)為局部的。
change_owner_of_file() {
local filename=$1
local user=$2
local group=$3
chown $user:$group $filename
}
change_owner_of_files() {
local user=$1; shift
local group=$1; shift
local files=$@
local i
for i in $files
do
chown $user:$group $i
done
}
1.自注釋（self documenting）的參數(shù)
2.通常作為循環(huán)用的變量i，把它聲明為局部變量是很重要的。
3.局部變量不作用于全局域。
kfir@goofy ~ $ local a
bash: local: can only be used in a function
三、main()
1.有助于保持所有變量的局部性
2.直觀的函數(shù)式編程
3.代碼中唯一的全局命令是：main
main() {
local files="/tmp/a /tmp/b"
local i
for i in $files
do
change_owner_of_file kfir users $i
done
}
main
四、一切皆是函數(shù)
唯一全局性運行的代碼是：
- 不可變的全局變量聲明
- main()函數(shù)
1.保持代碼整潔
2.過程變得清晰
main() {
local files=$(ls /tmp | grep pid | grep -v daemon)
}
temporary_files() {
local dir=$1
ls $dir \
| grep pid \
| grep -v daemon
}
main() {
local files=$(temporary_files /tmp)
}
1.第二個例子好得多。查找文件是temporary_files()的問題而非main()的。這段代碼用temporary_files()的單元測試也是可測試的。
2.如果你一定要嘗試第一個例子，你會得到查找臨時文件以和main算法的大雜燴。
test_temporary_files() {
local dir=/tmp
touch $dir/a-pid1232.tmp
touch $dir/a-pid1232-daemon.tmp
returns "$dir/a-pid1232.tmp" temporary_files $dir
touch $dir/b-pid1534.tmp
returns "$dir/a-pid1232.tmp $dir/b-pid1534.tmp" temporary_files $dir
}
如你所見，這個測試不關(guān)心main()。
五、調(diào)試函數(shù)
帶-x標(biāo)志運行程序：
bash -x my_prog.sh
只調(diào)試一小段代碼，使用set-x和set+x，會只對被set -x和set +x包含的當(dāng)前代碼打印調(diào)試信息。
temporary_files() {
local dir=$1
set -x
ls $dir \
| grep pid \
| grep -v daemon
set +x
}
打印函數(shù)名和它的參數(shù)：
temporary_files() {
echo $FUNCNAME $@
local dir=$1
ls $dir \
| grep pid \
| grep -v daemon
}
調(diào)用函數(shù)：
temporary_files /tmp
會打印到標(biāo)準(zhǔn)輸出：
六、代碼的清晰度
這段代碼做了什么？
main() {
local dir=/tmp
[[ -z $dir ]] \
&& do_something...
[[ -n $dir ]] \
&& do_something...
[[ -f $dir ]] \
&& do_something...
[[ -d $dir ]] \
&& do_something...
}
main
讓你的代碼說話：
is_empty() {
local var=$1
[[ -z $var ]]
}
is_not_empty() {
local var=$1
[[ -n $var ]]
}
is_file() {
local file=$1
[[ -f $file ]]
}
is_dir() {
local dir=$1
[[ -d $dir ]]
}
main() {
local dir=/tmp
is_empty $dir \
&& do_something...
is_not_empty $dir \
&& do_something...
is_file $dir \
&& do_something...
is_dir $dir \
&& do_something...
}
main
七、每一行只做一件事
用反斜杠\來作分隔符。例如：
temporary_files() {
local dir=$1
ls $dir | grep pid | grep -v daemon
}
可以寫得簡潔得多：
temporary_files() {
local dir=$1
ls $dir \
| grep pid \
| grep -v daemon
}
符號在縮進(jìn)行的開始
符號在行末的壞例子：（譯注：原文在此例中用了temporary_files()代碼段，疑似是貼錯了。結(jié)合上下文，應(yīng)為print_dir_if_not_empty()）
print_dir_if_not_empty() {
local dir=$1
is_empty $dir && \
echo "dir is empty" || \
echo "dir=$dir"
}
好的例子：我們可以清晰看到行和連接符號之間的聯(lián)系。
print_dir_if_not_empty() {
local dir=$1
is_empty $dir \
&& echo "dir is empty" \
|| echo "dir=$dir"
}
八、打印用法
不要這樣做：
echo "this prog does:..."
echo "flags:"
echo "-h print help"
它應(yīng)該是個函數(shù)：
usage() {
echo "this prog does:..."
echo "flags:"
echo "-h print help"
}
echo在每一行重復(fù)。因此我們得到了這個文檔：
usage() {
cat <<- EOF
usage: $PROGNAME options
Program deletes files from filesystems to release space.
It gets config file that define fileystem paths to work on, and whitelist rules to
keep certain files.
OPTIONS:
-c --config configuration file containing the rules. use --help-config to see the syntax.
-n --pretend do not really delete, just how what you are going to do.
-t --test run unit test to check the program
-v --verbose Verbose. You can specify more then one -v to have more verbose
-x --debug debug
-h --help show this help
--help-config configuration help
Examples:
Run all tests:
$PROGNAME --test all
Run specific test:
$PROGNAME --test test_string.sh
Run:
$PROGNAME --config /path/to/config/$PROGNAME.conf
Just show what you are going to do:
$PROGNAME -vn -c /path/to/config/$PROGNAME.conf
EOF
}
注意在每一行的行首應(yīng)該有一個真正的制表符‘\t'。
在vim里，如果你的tab是4個空格，你可以用這個替換命令：
:s/^ /\t/
九、命令行參數(shù)
這里是一個例子，完成了上面usage函數(shù)的用法。我從http://kirk.webfinish.com/2009/10/bash-shell-script-to-use-getopts-with-gnu-style-long-positional-parameters/ 得到這段代碼
cmdline() {
# got this idea from here:
# http://kirk.webfinish.com/2009/10/bash-shell-script-to-use-getopts-with-gnu-style-long-positional-parameters/
local arg=
for arg
do
local delim=""
case "$arg" in
#translate --gnu-long-options to -g (short options)
--config) args="${args}-c ";;
--pretend) args="${args}-n ";;
--test) args="${args}-t ";;
--help-config) usage_config && exit 0;;
--help) args="${args}-h ";;
--verbose) args="${args}-v ";;
--debug) args="${args}-x ";;
#pass through anything else
*) [[ "${arg:0:1}" == "-" ]] || delim="\""
args="${args}${delim}${arg}${delim} ";;
esac
done
#Reset the positional parameters to the short options
eval set -- $args
while getopts "nvhxt:c:" OPTION
do
case $OPTION in
v)
readonly VERBOSE=1
;;
h)
usage
exit 0
;;
x)
readonly DEBUG='-x'
set -x
;;
t)
RUN_TESTS=$OPTARG
verbose VINFO "Running tests"
;;
c)
readonly CONFIG_FILE=$OPTARG
;;
n)
readonly PRETEND=1
;;
esac
done
if [[ $recursive_testing || -z $RUN_TESTS ]]; then
[[ ! -f $CONFIG_FILE ]] \
&& eexit "You must provide --config file"
fi
return 0
}
你像這樣，使用我們在頭上定義的不可變的ARGS變量：
main() {
cmdline $ARGS
}
main
十、單元測試
1.在更高級的語言中很重要。
2.使用shunit2做單元測試
test_config_line_paths() {
local s='partition cpm-all, 80-90,'
returns "/a" "config_line_paths '$s /a, '"
returns "/a /b/c" "config_line_paths '$s /a:/b/c, '"
returns "/a /b /c" "config_line_paths '$s /a : /b : /c, '"
}
config_line_paths() {
local partition_line="$@"
echo $partition_line \
| csv_column 3 \
| delete_spaces \
| column 1 \
| colons_to_spaces
}
source /usr/bin/shunit2
這里是另一個使用df命令的例子：
DF=df
mock_df_with_eols() {
cat <<- EOF
Filesystem 1K-blocks Used Available Use% Mounted on
/very/long/device/path
124628916 23063572 100299192 19% /
EOF
}
test_disk_size() {
returns 1000 "disk_size /dev/sda1"
DF=mock_df_with_eols
returns 124628916 "disk_size /very/long/device/path"
}
df_column() {
local disk_device=$1
local column=$2
$DF $disk_device \
| grep -v 'Use%' \
| tr '\n' ' ' \
| awk "{print \$$column}"
}
disk_size() {
local disk_device=$1
df_column $disk_device 2
}
這里我有個例外，為了測試，我在全局域中聲明了DF為非只讀。這是因為shunit2不允許改變?nèi)钟蚝瘮?shù)。
相關(guān)文章
解決linux?shell中傳遞包含空格的參數(shù)問題
這篇文章主要介紹了如何解決linux?shell中傳遞包含空格的參數(shù)問題,具有很好的參考價值,希望對大家有所幫助,如有錯誤或未考慮完全的地方,望不吝賜教2023-09-09
Linux 服務(wù)管理兩種方式service和systemctl,systemd是Linux系統(tǒng)最新的初始化系統(tǒng)(init),作用是提高系統(tǒng)的啟動速度,盡可能啟動較少的進(jìn)程,盡可能更多進(jìn)程并發(fā)啟動,本文給大家詳細(xì)講解了Linux systemctl命令用法,需要的朋友可以參考下2024-03-03
這篇文章主要介紹了shell 函數(shù)定義與調(diào)用的相關(guān)資料，幫助大家更好的理解和學(xué)習(xí)shell，感興趣的朋友可以了解下2020-09-09
Linux下Tomcat啟動正常,但瀏覽器無法訪問的解決方法
下面小編就為大家?guī)硪黄狶inux下Tomcat啟動正常,但瀏覽器無法訪問的解決方法。小編覺得挺不錯的，現(xiàn)在就分享給大家，也給大家做個參考。一起跟隨小編過來看看吧2017-02-02
Linux?下?find?命令在目錄結(jié)構(gòu)中搜索文件，并執(zhí)行指定的操作，Linux?下?find?命令提供了相當(dāng)多的查找條件，功能很強(qiáng)大，這篇文章主要介紹了find?命令的?7?種用法,需要的朋友可以參考下2022-12-12
這篇文章主要介紹了Linux Shell腳本的編程之正則表達(dá)式的相關(guān)資料,非常不錯，具有參考借鑒價值，需要的朋友可以參考下2016-11-11
這篇文章主要介紹了一個簡單的linux命令cat,cat命令用來顯示文件內(nèi)容，具有一定的參考價值，感興趣的小伙伴們可以參考一下2016-12-12
用expect實現(xiàn)ssh自動登錄服務(wù)器并進(jìn)行批量管理的實現(xiàn)方法
這篇文章主要介紹用expect實現(xiàn)ssh自動登錄服務(wù)器并進(jìn)行批量管理的實現(xiàn)方法，需要的朋友可以參考下2013-02-02
用shell腳本實現(xiàn)自動切換內(nèi)網(wǎng)和外網(wǎng)實現(xiàn)高可用
因為公司的服務(wù)器這段時間內(nèi)網(wǎng)網(wǎng)卡老是出現(xiàn)問題，然后就導(dǎo)致了網(wǎng)站的各種問題，因為我們的數(shù)據(jù)庫鏈接，redis還有sphinx鏈接都是走的內(nèi)網(wǎng)，，所以就寫了這個腳本，在線上也跑了一段時間了，，也沒出過什么問題2013-06-06
這篇文章主要為大家介紹了Shell腳本中的echo命令使用介紹，有需要的朋友可以借鑒參考下，希望能夠有所幫助，祝大家多多進(jìn)步，早日升職加薪2023-05-05