6 script Bash tiện lợi đơn giản hóa quy trình Git

Tác giả viết một đống script Bash làm cho cuộc sống dễ dàng hơn khi làm việc với Git repository. Nhiều đồng nghiệp nói không cần; mọi thứ tác giả cần làm có thể làm với lệnh Git. Mặc dù đó có thể là thật, tác giả thấy các script vô cùng tiện lợi hơn so với cố gắng tìm ra lệnh Git thích hợp để làm điều tác giả muốn.

1. gitlog

gitlog in danh sách tóm tắt các patch hiện tại so với phiên bản master. Nó in từ cũ đến mới và hiển thị tác giả và mô tả, với H cho HEAD, ^ cho HEAD^, 2 cho HEAD~2, và cứ thế. Ví dụ:

$ gitlog
 -----------------------[ recovery25 ]-----------------------
 (snip)
 11 340d27a33895 Bob Peterson gfs2: drain the ail2 list after io errors
 10 9b3c4e6efb10 Bob Peterson gfs2: clean up iopen glock mess in gfs2_create_inode 
 9 d2e8c22be39b Bob Peterson gfs2: Do proper error checking for go_sync family of glops
 8 9563e31f8bfd Christoph Hellwig gfs2: use page_offset in gfs2_page_mkwrite 
 7 ebac7a38036c Christoph Hellwig gfs2: don't use buffer_heads in gfs2_allocate_page_backing 
 6 f703a3c27874 Andreas Gruenbacher gfs2: Improve mmap write vs. punch_hole consistency 
 5 a3e86d2ef30e Andreas Gruenbacher gfs2: Multi-block allocations in gfs2_page_mkwrite 
 4 da3c604755b0 Andreas Gruenbacher gfs2: Fix end-of-file handling in gfs2_page_mkwrite 
 3 4525c2f5b46f Bob Peterson Rafael Aquini's slab instrumentation 
 2 a06a5b7dea02 Bob Peterson GFS2: Add go_get_holdtime to gl_ops 
 ^ 8ba93c796d5c Bob Peterson gfs2: introduce new function remaining_hold_time and use it in dq 
 H e8b5ff851bb9 Bob Peterson gfs2: Allow rgrps to have a minimum hold time 

Nếu tôi muốn xem patch trên branch khác, tôi có thể chỉ định branch thay thế:

$ gitlog recovery24

2. gitlog.id

gitlog.id chỉ in các SHA1 ID của patch:

$ gitlog.id
 -----------------------[ recovery25 ]-----------------------
 56908eeb6940 2ca4a6b628a1 fc64ad5d99fe 02031a00a251 f6f38da7dd18 d8546e8f0023 fc3cc1f98f6b 12c3e0cb3523 76cce178b134 6fc1dce3ab9c 1b681ab074ca 26fed8de719b 802ff51a5670 49f67a512d8c f04f20193bbb 5f6afe809d23 2030521dc70e dada79b3be94 9b19a1e08161 78a035041d3e f03da011cae2 0d2b2e068fcd 2449976aa133 57dfb5e12ccd 53abedfdcf72 6fbdda3474b3 49544a547188 187032f7a63c 6f75dae23d93 95fc2a261b00 ebfb14ded191 f653ee9e414a 0e2911cb8111 73968b76e2e3 8a3e4cb5e92c a5f2da803b5b 7c9ef68388ed 71ca19d0cba8 340d27a33895 9b3c4e6efb10 d2e8c22be39b 9563e31f8bfd ebac7a38036c f703a3c27874 a3e86d2ef30e da3c604755b0 4525c2f5b46f a06a5b7dea02 8ba93c796d5c e8b5ff851bb9

Lại giả định branch hiện tại, nhưng tôi có thể chỉ định branch khác nếu muốn.

3. gitlog.id2

gitlog.id2 giống gitlog.id nhưng không có dòng branch ở đầu. Điều này tiện cho cherry-pick tất cả patch từ branch này sang branch hiện tại:

$ # tạo branch mới
 $ git branch --track origin/master
 $ # checkout branch mới vừa tạo
 $ git checkout recovery26
 $ # cherry-pick tất cả patch từ branch cũ sang branch mới
 $ for i in `gitlog.id2 recovery25` ; do git cherry-pick $i ;done

4. gitlog.grep

gitlog.grep grep chuỗi trong tập hợp patch đó. Ví dụ, nếu tôi tìm bug và muốn sửa patch có tham chiếu hàm inode_go_sync, tôi đơn giản làm:

$ gitlog.grep inode_go_sync
 -----------------------[ recovery25 - 50 patches ]-----------------------
 (snip)
 11 340d27a33895 Bob Peterson gfs2: drain the ail2 list after io errors
 10 9b3c4e6efb10 Bob Peterson gfs2: clean up iopen glock mess in gfs2_create_inode
 9 d2e8c22be39b Bob Peterson gfs2: Do proper error checking for go_sync family of glops
 152:-static void inode_go_sync(struct gfs2_glock *gl)
 153:+static int inode_go_sync(struct gfs2_glock *gl)
 163:@@ -296,6 +302,7 @@ static void inode_go_sync(struct gfs2_glock *gl)
 8 9563e31f8bfd Christoph Hellwig gfs2: use page_offset in gfs2_page_mkwrite
 7 ebac7a38036c Christoph Hellwig gfs2: don't use buffer_heads in gfs2_allocate_page_backing
 6 f703a3c27874 Andreas Gruenbacher gfs2: Improve mmap write vs. punch_hole consistency
 5 a3e86d2ef30e Andreas Gruenbacher gfs2: Multi-block allocations in gfs2_page_mkwrite
 4 da3c604755b0 Andreas Gruenbacher gfs2: Fix end-of-file handling in gfs2_page_mkwrite
 3 4525c2f5b46f Bob Peterson Rafael Aquini's slab instrumentation
 2 a06a5b7dea02 Bob Peterson GFS2: Add go_get_holdtime to gl_ops
 ^ 8ba93c796d5c Bob Peterson gfs2: introduce new function remaining_hold_time and use it in dq
 H e8b5ff851bb9 Bob Peterson gfs2: Allow rgrps to have a minimum hold time

Vậy, giờ tôi biết patch HEAD~9 là cái cần sửa. Tôi dùng git rebase -i HEAD~10 để edit patch 9, git commit -a --amend, rồi git rebase --continue để làm điều chỉnh cần thiết.

5. gitbranchcmp3

gitbranchcmp3 cho phép tôi so sánh branch hiện tại với branch khác, để tôi so sánh phiên bản cũ của patch với phiên bản mới và nhanh chóng thấy gì thay đổi và gì không. Nó tạo script so sánh (dùng công cụ KDE Kompare, hoạt động trên GNOME3) để so sánh patch không hoàn toàn giống. Nếu không khác biệt ngoài số dòng, in [SAME]. Nếu chỉ khác comment, in [same] (chữ thường). Ví dụ:

$ gitbranchcmp3 recovery24
 Branch recovery24 has 47 patches
 Branch recovery25 has 50 patches
 
 (snip)
 38 87eb6901607a 340d27a33895 [same] gfs2: drain the ail2 list after io errors
 39 90fefb577a26 9b3c4e6efb10 [same] gfs2: clean up iopen glock mess in gfs2_create_inode
 40 ba3ae06b8b0e d2e8c22be39b [same] gfs2: Do proper error checking for go_sync family of glops
 41 2ab662294329 9563e31f8bfd [SAME] gfs2: use page_offset in gfs2_page_mkwrite
 42 0adc6d817b7a ebac7a38036c [SAME] gfs2: don't use buffer_heads in gfs2_allocate_page_backing
 43 55ef1f8d0be8 f703a3c27874 [SAME] gfs2: Improve mmap write vs. punch_hole consistency
 44 de57c2f72570 a3e86d2ef30e [SAME] gfs2: Multi-block allocations in gfs2_page_mkwrite
 45 7c5305fbd68a da3c604755b0 [SAME] gfs2: Fix end-of-file handling in gfs2_page_mkwrite
 46 162524005151 4525c2f5b46f [SAME] Rafael Aquini's slab instrumentation
 47 a06a5b7dea02 [ ] GFS2: Add go_get_holdtime to gl_ops
 48 8ba93c796d5c [ ] gfs2: introduce new function remaining_hold_time and use it in dq
 49 e8b5ff851bb9 [ ] gfs2: Allow rgrps to have a minimum hold time
 
 Missing from recovery25:
 The missing: 
 Compare script generated at: /tmp/compare_mismatches.sh

6. gitlog.find

Cuối cùng, tôi có gitlog.find, script giúp tôi xác định nơi phiên bản upstream của patch là và trạng thái hiện tại của mỗi patch. Nó làm bằng cách khớp mô tả patch. Nó cũng tạo script so sánh (lại dùng Kompare) để so sánh patch hiện tại với đối ứng upstream:

$ gitlog.find
 -----------------------[ recovery25 - 50 patches ]-----------------------
 (snip)
 11 340d27a33895 Bob Peterson gfs2: drain the ail2 list after io errors
 lo 5bcb9be74b2a Bob Peterson gfs2: drain the ail2 list after io errors
 10 9b3c4e6efb10 Bob Peterson gfs2: clean up iopen glock mess in gfs2_create_inode
 fn 2c47c1be51fb Bob Peterson gfs2: clean up iopen glock mess in gfs2_create_inode
 9 d2e8c22be39b Bob Peterson gfs2: Do proper error checking for go_sync family of glops
 lo feb7ea639472 Bob Peterson gfs2: Do proper error checking for go_sync family of glops
 8 9563e31f8bfd Christoph Hellwig gfs2: use page_offset in gfs2_page_mkwrite
 ms f3915f83e84c Christoph Hellwig gfs2: use page_offset in gfs2_page_mkwrite
 7 ebac7a38036c Christoph Hellwig gfs2: don't use buffer_heads in gfs2_allocate_page_backing
 ms 35af80aef99b Christoph Hellwig gfs2: don't use buffer_heads in gfs2_allocate_page_backing
 6 f703a3c27874 Andreas Gruenbacher gfs2: Improve mmap write vs. punch_hole consistency
 fn 39c3a948ecf6 Andreas Gruenbacher gfs2: Improve mmap write vs. punch_hole consistency
 5 a3e86d2ef30e Andreas Gruenbacher gfs2: Multi-block allocations in gfs2_page_mkwrite
 fn f53056c43063 Andreas Gruenbacher gfs2: Multi-block allocations in gfs2_page_mkwrite
 4 da3c604755b0 Andreas Gruenbacher gfs2: Fix end-of-file handling in gfs2_page_mkwrite
 fn 184b4e60853d Andreas Gruenbacher gfs2: Fix end-of-file handling in gfs2_page_mkwrite
 3 4525c2f5b46f Bob Peterson Rafael Aquini's slab instrumentation
 Not found upstream
 2 a06a5b7dea02 Bob Peterson GFS2: Add go_get_holdtime to gl_ops
 Not found upstream
 ^ 8ba93c796d5c Bob Peterson gfs2: introduce new function remaining_hold_time and use it in dq
 Not found upstream
 H e8b5ff851bb9 Bob Peterson gfs2: Allow rgrps to have a minimum hold time
 Not found upstream
 Compare script generated: /tmp/compare_upstream.sh

Các patch được hiển thị trên hai dòng, dòng đầu là patch hiện tại của bạn, theo sau là patch upstream tương ứng, và viết tắt 2 ký tự chỉ trạng thái upstream:

• lo nghĩa là patch chỉ ở local upstream Git repo (chưa push upstream).
• ms nghĩa là patch ở master branch của Linus Torvald.
• fn nghĩa là patch được push đến branch "for-next" phát triển, dự định cho cửa sổ merge upstream tiếp theo.

Một số script của tôi làm giả định dựa trên cách tôi thường làm việc với Git. Ví dụ, khi tìm upstream patch, nó dùng vị trí Git tree nổi tiếng của tôi. Vì vậy, bạn sẽ cần điều chỉnh hoặc cải tiến chúng cho điều kiện của bạn. Script gitlog.find được thiết kế để định vị patch GFS2 và DLM, nên trừ khi bạn là developer GFS2, bạn sẽ muốn tùy chỉnh nó cho component bạn quan tâm.

Mã nguồn (Source code)

Đây là nguồn cho các script này.

1. gitlog

#!/bin/bash
 branch=$1
 
 if test "x$branch" = x; then
 branch=`git branch -a | grep "*" | cut -d ' ' -f2`
 fi
 
 patches=0
 tracking=`git rev-parse --abbrev-ref --symbolic-full-name @{u}`
 
 LIST=`git log --reverse --abbrev-commit --pretty=oneline $tracking..$branch | cut -d ' ' -f1 |paste -s -d ' '`
 for i in $LIST; do patches=$(echo $patches + 1 | bc);done
 
 if [[ $branch =~ .*for-next.* ]]
 then
 start=HEAD
 # start=origin/for-next
 else
 start=origin/master
 fi
 
 tracking=`git rev-parse --abbrev-ref --symbolic-full-name @{u}`
 
 /usr/bin/echo "-----------------------[" $branch "]-----------------------"
 patches=$(echo $patches - 1 | bc);
 for i in $LIST; do
 if [ $patches -eq 1 ]; then
 cnt=" ^"
 elif [ $patches -eq 0 ]; then
 cnt=" H"
 else
 if [ $patches -lt 10 ]; then
 cnt=" $patches"
 else
 cnt="$patches"
 fi
 fi
 /usr/bin/git show --abbrev-commit -s --pretty=format:"$cnt %h %<|(32)%an %s %n" $i
 patches=$(echo $patches - 1 | bc)
 done
 #git log --reverse --abbrev-commit --pretty=format:"%h %<|(32)%an %s" $tracking..$branch
 #git log --reverse --abbrev-commit --pretty=format:"%h %<|(32)%an %s" ^origin/master ^linux-gfs2/for-next $branch

2. gitlog.id

#!/bin/bash
 branch=$1
 
 if test "x$branch" = x; then
 branch=`git branch -a | grep "*" | cut -d ' ' -f2`
 fi
 
 tracking=`git rev-parse --abbrev-ref --symbolic-full-name @{u}`
 
 /usr/bin/echo "-----------------------[" $branch "]-----------------------"
 git log --reverse --abbrev-commit --pretty=oneline $tracking..$branch | cut -d ' ' -f1 |paste -s -d ' '

3. gitlog.id2

#!/bin/bash
 branch=$1
 
 if test "x$branch" = x; then
 branch=`git branch -a | grep "*" | cut -d ' ' -f2`
 fi
 
 tracking=`git rev-parse --abbrev-ref --symbolic-full-name @{u}`
 git log --reverse --abbrev-commit --pretty=oneline $tracking..$branch | cut -d ' ' -f1 |paste -s -d ' '

4. gitlog.grep

#!/bin/bash
 param1=$1
 param2=$2
 
 if test "x$param2" = x; then
 branch=`git branch -a | grep "*" | cut -d ' ' -f2"
 string=$param1
 else
 branch=$param1
 string=$param2
 fi
 
 patches=0
 tracking=`git rev-parse --abbrev-ref --symbolic-full-name @{u}`
 
 LIST=`git log --reverse --abbrev-commit --pretty=oneline $tracking..$branch | cut -d ' ' -f1 |paste -s -d ' '`
 for i in $LIST; do patches=$(echo $patches + 1 | bc);done
 /usr/bin/echo "-----------------------[" $branch "-" $patches "patches ]-----------------------"
 patches=$(echo $patches - 1 | bc);
 for i in $LIST; do
 if [ $patches -eq 1 ]; then
 cnt=" ^"
 elif [ $patches -eq 0 ]; then
 cnt=" H"
 else
 if [ $patches -lt 10 ]; then
 cnt=" $patches"
 else
 cnt="$patches"
 fi
 fi
 /usr/bin/git show --abbrev-commit -s --pretty=format:"$cnt %h %<|(32)%an %s" $i
 /usr/bin/git show --pretty=email --patch-with-stat $i | grep -n "$string"
 patches=$(echo $patches - 1 | bc)
 done

5. gitbranchcmp3

#!/bin/bash
 #
 # gitbranchcmp3 <old branch> [<new_branch>]
 #
 oldbranch=$1
 newbranch=$2
 script=/tmp/compare_mismatches.sh
 
 /usr/bin/rm -f $script
 echo "#!/bin/bash" > $script
 /usr/bin/chmod 755 $script
 echo "# Generated by gitbranchcmp3.sh" >> $script
 echo "# Run this script to compare the mismatched patches" >> $script
 echo " " >> $script
 echo "function compare_them()" >> $script
 echo "{" >> $script
 echo " git show --pretty=email --patch-with-stat \$1 > /tmp/gronk1" >> $script
 echo " git show --pretty=email --patch-with-stat \$2 > /tmp/gronk2" >> $script
 echo " kompare /tmp/gronk1 /tmp/gronk2" >> $script
 echo "}" >> $script
 echo " " >> $script
 
 if test "x$newbranch" = x; then
 newbranch=`git branch -a | grep "*" | cut -d ' ' -f2`
 fi
 
 tracking=`git rev-parse --abbrev-ref --symbolic-full-name @{u}`
 
 declare -a oldsha1s=(`git log --reverse --abbrev-commit --pretty=oneline $tracking..$oldbranch | cut -d ' ' -f1 |paste -s -d ' '`)
 declare -a newsha1s=(`git log --reverse --abbrev-commit --pretty=oneline $tracking..$newbranch | cut -d ' ' -f1 |paste -s -d ' '`)
 
 #echo "old: " $oldsha1s
 oldcount=${#oldsha1s[@]}
 echo "Branch $oldbranch has $oldcount patches"
 oldcount=$(echo $oldcount - 1 | bc)
 #for o in `seq 0 ${#oldsha1s[@]}`; do
 # echo -n ${oldsha1s[$o]} " "
 # desc=`git show $i | head -5 | tail -1|cut -b5-`
 #done
 
 #echo "new: " $newsha1s
 newcount=${#newsha1s[@]}
 echo "Branch $newbranch has $newcount patches"
 newcount=$(echo $newcount - 1 | bc)
 #for o in `seq 0 ${#newsha1s[@]}`; do
 # echo -n ${newsha1s[$o]} " "
 # desc=`git show $i | head -5 | tail -1|cut -b5-`
 #done
 echo
 
 for new in `seq 0 $newcount`; do
 newsha=${newsha1s[$new]}
 newdesc=`git show $newsha | head -5 | tail -1|cut -b5-`
 oldsha=" "
 same="[ ]"
 for old in `seq 0 $oldcount`; do
 if test "${oldsha1s[$old]}" = "match"; then
 continue;
 fi
 olddesc=`git show ${oldsha1s[$old]} | head -5 | tail -1|cut -b5-`
 if test "$olddesc" = "$newdesc" ; then
 oldsha=${oldsha1s[$old]}
 #echo $oldsha
 git show $oldsha |tail -n +2 |grep -v "index.*\.\." |grep -v "@@" > /tmp/gronk1
 git show $newsha |tail -n +2 |grep -v "index.*\.\." |grep -v "@@" > /tmp/gronk2
 diff /tmp/gronk1 /tmp/gronk2 &> /dev/null
 if [ $? -eq 0 ] ;then
 # No differences
 same="[SAME]"
 oldsha1s[$old]="match"
 break
 fi
 git show $oldsha |sed -n '/diff/,$p' |grep -v "index.*\.\." |grep -v "@@" > /tmp/gronk1
 git show $newsha |sed -n '/diff/,$p' |grep -v "index.*\.\." |grep -v "@@" > /tmp/gronk2
 diff /tmp/gronk1 /tmp/gronk2 &> /dev/null
 if [ $? -eq 0 ] ;then
 # Differences in comments only
 same="[same]"
 oldsha1s[$old]="match"
 break
 fi
 oldsha1s[$old]="match"
 echo "compare_them $oldsha $newsha" >> $script
 fi
 done
 echo "$new $oldsha $newsha $same $newdesc"
 done
 
 echo
 echo "Missing from $newbranch:"
 the_missing=""
 # Now run through the olds we haven't matched up
 for old in `seq 0 $oldcount`; do
 if test ${oldsha1s[$old]} != "match"; then
 olddesc=`git show ${oldsha1s[$old]} | head -5 | tail -1|cut -b5-`
 echo "${oldsha1s[$old]} $olddesc"
 the_missing=`echo "$the_missing ${oldsha1s[$old]}"`
 fi
 done
 
 echo "The missing: " $the_missing
 echo "Compare script generated at: $script"
 #git log --reverse --abbrev-commit --pretty=oneline $tracking..$branch | cut -d ' ' -f1 |paste -s -d ' '

6. gitlog.find

#!/bin/bash
 #
 # Find the upstream equivalent patch
 #
 # gitlog.find
 #
 cwd=$PWD
 param1=$1
 ubranch=$2
 patches=0
 script=/tmp/compare_upstream.sh
 echo "#!/bin/bash" > $script
 /usr/bin/chmod 755 $script
 echo "# Generated by gitbranchcmp3.sh" >> $script
 echo "# Run this script to compare the mismatched patches" >> $script
 echo " " >> $script
 echo "function compare_them()" >> $script
 echo "{" >> $script
 echo " cwd=$PWD" >> $script
 echo " git show --pretty=email --patch-with-stat \$2 > /tmp/gronk2" >> $script
 echo " cd ~/linux.git/fs/gfs2" >> $script
 echo " git show --pretty=email --patch-with-stat \$1 > /tmp/gronk1" >> $script
 echo " cd $cwd" >> $script
 echo " kompare /tmp/gronk1 /tmp/gronk2" >> $script
 echo "}" >> $script
 echo " " >> $script
 
 #echo "Gathering upstream patch info. Please wait."
 branch=`git branch -a | grep "*" | cut -d ' ' -f2`
 tracking=`git rev-parse --abbrev-ref --symbolic-full-name @{u}`
 
 cd ~/linux.git
 if test "X${ubranch}" = "X"; then
 ubranch=`git branch -a | grep "*" | cut -d ' ' -f2`
 fi
 utracking=`git rev-parse --abbrev-ref --symbolic-full-name @{u}`
 #
 # gather a list of gfs2 patches from master just in case we can't find it
 #
 #git log --abbrev-commit --pretty=format:" %h %<|(32)%an %s" master |grep -i -e "gfs2" -e "dlm" > /tmp/gronk
 git log --reverse --abbrev-commit --pretty=format:"ms %h %<|(32)%an %s" master fs/gfs2/ > /tmp/gronk.gfs2
 # ms = in Linus's master
 git log --reverse --abbrev-commit --pretty=format:"ms %h %<|(32)%an %s" master fs/dlm/ > /tmp/gronk.dlm
 
 cd $cwd
 LIST=`git log --reverse --abbrev-commit --pretty=oneline $tracking..$branch | cut -d ' ' -f1 |paste -s -d ' '`
 for i in $LIST; do patches=$(echo $patches + 1 | bc);done
 /usr/bin/echo "-----------------------[" $branch "-" $patches "patches ]-----------------------"
 patches=$(echo $patches - 1 | bc);
 for i in $LIST; do
 if [ $patches -eq 1 ]; then
 cnt=" ^"
 elif [ $patches -eq 0 ]; then
 cnt=" H"
 else
 if [ $patches -lt 10 ]; then
 cnt=" $patches"
 else
 cnt="$patches"
 fi
 fi
 /usr/bin/git show --abbrev-commit -s --pretty=format:"$cnt %h %<|(32)%an %s" $i
 desc=`/usr/bin/git show --abbrev-commit -s --pretty=format:"%s" $i`
 cd ~/linux.git
 cmp=1
 up_eq=`git log --reverse --abbrev-commit --pretty=format:"lo %h %<|(32)%an %s" $utracking..$ubranch | grep "$desc"`
 # lo = in local for-next
 if test "X$up_eq" = "X"; then
 up_eq=`git log --reverse --abbrev-commit --pretty=format:"fn %h %<|(32)%an %s" master..$utracking | grep "$desc"`
 # fn = in for-next for next merge window
 if test "X$up_eq" = "X"; then
 up_eq=`grep "$desc" /tmp/gronk.gfs2`
 if test "X$up_eq" = "X"; then
 up_eq=`grep "$desc" /tmp/gronk.dlm`
 if test "X$up_eq" = "X"; then
 up_eq=" Not found upstream"
 cmp=0
 fi
 fi
 fi
 fi
 echo "$up_eq"
 if [ $cmp -eq 1 ] ; then
 UP_SHA1=`echo $up_eq|cut -d' ' -f2`
 echo "compare_them $UP_SHA1 $i" >> $script
 fi
 cd $cwd
 patches=$(echo $patches - 1 | bc)
 done
 echo "Compare script generated: $script"