Mqskit 和其它相關工具

by thinker

關鍵字:

linkname:mqskit http://bit.ly/zww8Vh 是個 hg extension，
補強 linkname:mq http://bit.ly/wPtNjh 的功能。
最近因為工作，大量使用 mq，而且同時需使用多個 patch queue。
因為 queue 之間的相依性，必需常在不同的 queue 之間同步、更新 queue 裡面
的 patch。
例如: B queue 相依於 A queue，於是每次 A queue 有更動時，就必需在適當的時
侯把 A queue 裡面的 patch 更新到 B queue 裡。
經常如此更新，是一件浪費生命的事，於是做了這個 mqskit。

另外，我常在不同的電腦上工作，因而必需在各台電腦之間，同步所有的 patch queue。
而 mq 原本提供的方案是為每一個 queue 建一個 repository，你可以在不同的
機器上，同步這些 repository。
這意思是，如果你為一個 project 開了十個 queue，你就必需在你的 server 上
分別建立十個 repository，以同步這些 queue。
這做法實在麻煩。
於是 mqskit 另外提供指令，讓你使用一個 repository ，容納所有的 patch queue。
如此你就可以使用單一個 repository，同步所有的 queue。

== 複制一個 queue ==
最近需要開多個 queue，同時解決多個 issue。
有些 issue 之間有相依性，因此 queue 也相依。
因此，在前一個 queue 完成到一定程度時，就需要開下一個 queue，並把目前的
queue 裡面的 patch 複制過去。
這時侯能用
{{{
hg qqueue --create --copy NEW-QUEUE

}}}

hg qqueue 是原來 mq 提供的功能， mqskit 多加了一個 --copy option，
順便在 create queue 之後，在新的 queue 裡 import 目前所有的 patch。

== 更新 patch ==
如果目前的 queue 相依於另一個 queue，我們可能需要同步被相依者的更新。
這時可以使用 hg qimpo 指令，將之前透過 qqueue copy 過來的 patch 全部移除，
並重新從被相依的 queue 裡，重新 import。
而新加入，非從被相依 queue 複制過來的 patch，則不受影嚮。
{{{
hg qimpo ORIGIN-QUEUE

}}}

== 初始化 Q1 ==
Q1 是指 manage all patch Queues with One repository，用一個 repository
管理所有 patch queue。
在使用之前，先使用 hg q1init 初始化該 repository。
{{{
hg q1init

}}}

使用 Q1 可以很輕鬆的使用單一個 repository，交換、分享和傳送所有的 patch queue。

== 將所有的 patch queue 更新到 Q1 repository ==
{{{
hg q1commit

}}}

這個指今自動將所的新的和更新的 patch 加入到 Q1 repository，並移除已被從
patch queue 移除的 patch。相同於 hg commit --addremove

== 和其它 Q1 repository 同步 ==
{{{
hg q1push
hg q2pull

}}}

使用方式和 hg push/pull 差不多。
而 default 的 repository 必需設定於 .hg/.hg/hgrc 裡，而非 .hg/hgrc。
設定方法如下
{{{
[paths]
default = /path/to/default/repository

}}}

和 hg 原本的設定方法一樣。

== 從 Q1 repository 更新 patch queue ==
{{{
hg q1update

}}}

== hgbztk ==
linkname:hgbztk http://bit.ly/xsGh8h 則是另一個因工作上需要而寫的
hg extension。
用來上傳和同步 bugzilla 上，某個 bug 的 patch file。
起因在於，在 review 的過程，patch 可能來來回回被要求更改。
你必需不斷的重新上傳。
加上 $mozilla$ 的 bugzilla service 很慢，實在讓我受不了。
於是寫了 hgbztk 解決這個問題。

== 設定 hgbztk ==
{{{
[bzexport]
username = username@on.bugzilla
password = secret
bugzilla = https://api-dev.bugzilla.$mozilla$.org/latest/

}}}

hgbztk 是從 bzexport 改過來的，雖然目前主要功能都不是 bzexport 所有的，
但暫時還沒有更新設定的 section 名稱。

== 將目前的 patch queue 對應到 bugzilla 上的 bug ==
使用 hg bzbug 將對應目前的 patch queue 和 bugzilla 上的 bug。
並且會將 bug 上已有的 patch 資訊，更新到本地端。
{{{
hg bzbug 1234

}}}

此例將目前的 patch queue 對應到 bugzilla 上，編號 1234 的 bug。

== bzmap ==
這個指令是用來檢示目前 patch 的狀態和對應的方式。
也可使用 bzmap 來加入新的 patch，或指定 bugzilla 上的 patch 和本地 patch
的對應方式。
{{{
$mozilla$$$ hg bzmap
 networkinterface.patch -> networkinterface.patch
$mozilla$$$ hg bzmap -v
 networkinterface.patch -> networkinterface.patch
    Descr: Network interface

}}}

hg bzmap 會列出目前所有的 bugzilla 上的 patch ，和對應狀態。
箭頭左邊是 bugzilla 上的 patch，而右邊是對應的 local patch。
hg bzmap -v 則例出更詳細的內容。
例如 Descr 是指 bugzilla 上，該 patch 的 description 欄位。

下面指令，改變 patch 的對應方式。
{{{
hg bzmap networkinterface.patch new-local-patch

}}}

networkinterface.patch 會重新對應到 local 的 new-local-patch。
下次上傳 patch 時， hgbztk 就會傳新上傳這個 patch，以 new-local-patch
的內容取代。

下面指令用來新增一個 bugzilla 上沒有的 patch。
{{{
hg bzmap -n new-local-patch

}}}

同當的，下次上傳時， hgbztk 會自動把這個 patch 傳送到 bugzilla。

如果需要移除一個 patch，請用下面指令
{{{
hg bzmap -r name-being-removed-patch

}}}

== 使用 $Python$ 制作自己的工具 ==
前幾天和幾個朋友聊到，很少工程師會為自己制作工具。
我不確定這是不是$台灣$特有的現象，但我覺的再怎麼忙，還是得抽空為自己
寫工具。
一個工具可能花掉你一些時間，但這工具可以不斷被重複使用，
可以省下的時間，應該遠大於你所花的時間。
(如果這個工具會時常被用到)
為了自已長期的幸福，就不該貪圖一時的輕鬆，而預支未來的時間。

為何大家不寫自己的工具? 我覺的有一個可能。
不知道有什麼合適的工具，能幫助自己輕鬆完成新的工具。
特別是在 $GUI$ 環境下長大的 programmer，可能覺的開發個工具都要花很多時間。
事實上，在 text mode 環境下，整個問題就單純的多，工具也好寫的多。
而且 text mode 環境下，工具之間也容易組合使用和修改。
因此，試著使用 $command line$ 的工具吧!
決對比你用 $GUI$ 有效率多了。

雖然很武斷，但我還是要說， $GUI$ 是給外行人用的 XD
怎麼說呢?
你去看看在證券業，或其它講求使用效率的工作環境，即使在 $GUI$ 環境下，
使用者會直接使用 hot-key 或 command，而非用 mouse 來那移來移去，點點點...的。
這才叫效率。
如果不願意多花時間學習這些指令或 hot-key，又怎麼說自己專業呢?
必竟這些都是吃飯的工具。

另外，實作工具時，如果你只會 $C$/$C++$、$C$# 或 Java 之類工作上正式使用到的語言，
那你必定覺的很花時間，會使你更不願意寫工具。
如果你能學會 $Python$ 或其它的 script language，那事情就簡單多了。
這些 script language 雖然執行效能較低，但開發速度卻很快。
對於工具類的程式，效能的要求通常不高。
因此使用 $Python$ 之類的 script language 最合適了。
如果你還不會任何這類的 script language，建議你從 $Python$ 下手吧!
一來簡單，二來 library 很多。
大部分時侯，你只需使用這些 library 來兜一兜就可以了。
雖然學習語言需要花點時間，但對於有其它語言經驗的人，
應該只需要一兩個星期就能上手了。
而像 $Python$ 這類語言，不需要全學完，就可以開始做一些東西了。
對於專業的 programmer 而言，一定值回票價。

以前面兩組工具而言，因為使用 $Python$ ，我各自花了幾個小時就完成第一個
prototype。
很適合假日在家花一個早上進行 hacking。
當然，一方面我對 $Python$ 已經很熟了，再者 $Python$ 的動態語言特性，
真的能省下很多開發時間。
希望各位還沒有機會為自己寫工具的 programmer，都有機會開始自己的 hacking!

最後更新時間: 2012-01-09 10:35:55 CST | 引用

查詢:

COMMENTS:

on 2012-01-10 09:09:22 CST

jserv said ..

Great work! 我比較好奇名稱是怎麼來的 :) 恰好以前從事的某個專案也叫這個名，真巧

on 2012-01-10 11:33:19 CST

yungyuc said ..

PyHUG 下個月的時間確定到二月十五號。你的 talk 要不要就用 mqskit 當 topic，還是要另外取一個？另外取的話請用英文喔！ Thanks