Official Python Planet@Taiwan

今天在 TWJUG 做的 Mercurial 簡報

http://linuxtoy.org/archives/sparkleshare-beta.html

DropBox是種結合了本地和雲端, 能改變使用者習慣的重要技術。

DropBox讓使用者可以用原本的形式來處理檔案和文件, 只要在各種作業系統上安裝DropBox提供的軟體，登入DropBox帳號後即會在本地建立一個資料夾。
這個資料夾中的所有檔案都會自動同步到DropBox伺服器。如果你有多台設備(電腦, iPad, 智慧手機)，並都登入了同一帳號，那麼當資料夾中的任一檔案被更新後，其他台設備很快就也能接收到這些檔案的更新。DropBox真正做到了隨處可得。

很方便的是，不管是對檔案、文件夾改名，或是刪除檔案都難不倒它。如果在其中一台刪除了檔案，其他台的檔案也會一併被刪除。為了解決客戶對誤操作的擔憂，DropBox還提供了類似蘋果電腦上的時光回溯(Time Machine)功能(技術上基本就是將檔案操作結合版本控制系統)，若是做了誤操作，可以登入到DropBox網站上將上次的誤操作回復到之前狀態，真是非常安心。

另外，放在DropBox檔案夾下的檔案，除了可以像以前的作法用網芳分享給在同個網域下的朋友外，還可以直接將一個資料夾分享給其他同樣有DropBox帳號的朋友，真正是天涯若彼鄰。

SparkleShare 則是它的 open source 替代品，後端使用GIT版本控制系統。

PS: 大家看了我上面的介紹，可以知道我真的很愛這種東西。因為研究所時我也花過一段時間研究，並發過一篇一樣為解決多台設備間資料同步問題的 paper，而人家真的做出來了 :D

傳統的版本控制系統(Version Control System, VCS)只有一台單一的版本庫（repository），所有的版本控制都必須經由這台版本庫主機才能管理。新一代的分散式版本控制系統(Distributed Version Control System, DVCS)如 git, Mercurial 則每份抓下來的 code 都可起到等同於版本庫的作用，使得在離線時做版本控制，並能容易地合併回主版本庫的工作模式成為可能。

因為分散的特性，也衍生出各種可能的合作模式。
git 有 A successful Git branching model，Mercurial有 Workflows: Branch As Needed, Stable & Default, Translation Branches 等方式。

實際上該採用哪種方式比較好？先看看其他人怎麼做，從中選擇，或是加點創意，找出適合自己團隊使用的方法吧。

Mercurial(Hg) 一直是我很愛用的版本控制工具。以前自己最常用的用途是拿來取代 svn，單純享受單機/離線使用版本控制系統開發的樂趣。

要單機使用版本控制系統開發，照著水銀分散式版本控制系統的使用概念做就行了。

最近看了Hg init和ProGit兩份分別講Hg和Git分散式版本控制的書，裡面都相當推崇「分支(Branch)開發」的概念。
所謂「分支開發」，就是將主幹(trunk)保持在穩定可運作的版本（雖然本來就該這麼做），在開發任何新功能時都另建新分支(branch)，開發到一段落之後再合併回主幹。能支援這樣的開發模式，是因為Hg或Git這些分散式版本控制系統做開分支、合併等動作的額外開銷都很低。

那麼要實際使用時該怎麼做呢？

開分支

我有一個名為「ZAKU」（薩克）的目錄，主幹版本代號為3, 現在要實作一個將綠色變成紅色的功能，這時我們可以建立一個新分支來繼續開發這個新功能。分支命令的格式為：

$ hg branch [branch name]

因此要建立一個名為「red」的分支，可以使用以下命令：

$ hg branch red
marked working directory as branch red

這麼一來，之後 commit 的 code 都會進入「red」這個分支了。

查看狀態

在 commit 進一些 code 之後（版本代號到13），輸入「hg branchs」命令可以列出所有版本

$ hg branches
default                       3:e2287f9031a1 (inactive)
red                           13:e590de4b0dc9

切換分支

在開發新功能的同時，也可能會碰上整個專案共通的bug，以前老派的作法是再 check out 一份主幹的程式碼，然後兩邊修正，現在有了hg, 只要先暫時切換回主幹，把bug修正了再合併回分支（或到時一次把分支合併回主幹）。

要切換回主幹，輸入「hg update default」即可。

$ hg up default
4 files 已更新, 0 files 已合併, 3 files 已移除, 0 files unresolved

合併

當我們把「red」分支中的新功能做好後，可以很容易地將這些修改合併回主幹。

首先，用上面的方法切換回主幹，然後輸入「hg merge red」，即可將「red」分支中的修改加進主幹。

$ hg merge red
5 files 已更新, 0 files 已合併, 0 files 已移除, 0 files unresolved
(branch merge, don't forget to commit)

合併命令的格式為

hg merge [branch name]

合併完後確認沒問題，就將程式碼再 commit 進版本庫吧！

如果只想 push 某 branch 的修改到版本庫，可以使用

hg push --rev [version]

命令，這樣只會將與指定版本相關的修改上傳到版本庫。

One more thing

同樣的方法，我們可以再建立一個分支「horn」來開發長角的功能，然後再將「horn」分支合併回主幹。

別忘了hg還有提供一個離線網頁瀏覽功能，輸入「hg serve -p 5000」，在瀏覽器上輸入「http://localhost:5000」就能看到類似 gitweb 的版本控制訊息網頁。點選左側的「graph」標籤，可以用視覺化的方式看到之前所有分支合併的圖形記錄囉！

學會分支與合併後，你的開發效率會不會也變成三倍速哩？

參考資料:
* http://stevelosh.com/blog/2009/08/a-guide-to-branching-in-mercurial/

在做完「hg clone」（就如同從 Server 端 Check Out 程式碼）後，除了可以對原 Server 做「hg pull」以更新程式碼之外，也可以多加別台 Server 進列表。

如原來從 Alice 處「hg clone」下來原始碼，而現在也想要從 Bob 處直接取得他的更新，可以使用

$ hg pull [bob server]

命令。

另一個好方法是可以在 .hg/hgrc 中定義額外的 Server 別名(alias)。

例如原來的 .hg/hgrc 長這樣:

[paths]
default = [Alice Server]/[project]

我們在其後加入 Bob Server 的別名如下:

[paths]
default = [Alice Server]/[project]
bob = [Bob server]/[project]

儲存後，要再從 Bob 處直接取得他的更新，可以使用

$ hg pull bob

命令來直接取得 bob 的原始碼。分散式版本控制是不是很方便呢 :)

今天在台北 GTUG 講「GoogleCode & Mercurial 版本控制介紹」。

讀到 DVCS Round-Up: One System to Rule Them All? 記錄一下。（還有Part II、Part III）這麼長的文章在一般狀況下實在沒什麼耐心看下去。還好 Mac 上的 Text-To-Speech 功能做的非常好用，把預設的語速調快，並設定快速鍵(我設成 Command+~)後，讀一篇長文其實花不了幾分鐘。

現在最常用的版本控制系統應該是 svn、hg、git 三種。
svn(Subversion)、hg(Mercurial) 是自己平時會使用的版本控制系統，由於 hg 跟 svn 的命令幾乎相同，轉換時的學習曲線相當平緩，都是相當方便的工具。google code 剛好也是支援這兩種。git 則是開發 linux 系統時的常用的工具。

剛剛發現開源的 Java 社群在版本控制系統(version control) 的選擇，正向著 Python mercurial 遷移。

證據是 Mercurial 的官方網站上列出了近期的幾個 Sun 的重要專案都採用了 Mercurial：

# 2007-12-12 NetBeans migrates to mercurial
# 2007-12-05 OpenJDK (aka Java) switches to Mercurial
# 2006-10-18 OpenSolaris announces ON Mercurial repository mirror

包含 Sun 官方的 Java、NetBeans 跟 OpenSolaris 都採用 mercurial 分散式版本控制系統。
這對社群有極佳的示範作用。

試想一下，就跟許多 Linux 發佈套件開始用 BT 來分流一樣。
既然都開放下載了，用分散式的版本控制系統有助 Sun 降低其公司的網路流量，應該能省下不少花費。

另外，在 Windows 上相當有名的 tortoise 系列圖形化版本控制工具也出了 Mercurial 版囉，名叫tortoisehg。(另外兩種是 tortoisecvs 跟 tortoisesvn)

最近 mozilla 宣佈要採用 水銀(mercurial, hg) 當作他們未來的版本控制系統.

我試了一下發現mercurial有用 twist 提供內建的 web server,
想用版本控制時再也不用先搞定 apache 設定了, Python 真是好呀

水銀分散式版本控制系統的使用概念如下:

0. 開個檔案夾([origin]), 開始 coding.
1. 告訴自己這個檔案夾裡放的是版本庫 (hg init).
2. 將原始版本中的所有檔案放進版本庫(hg commit *).
3. 怕接下來的修改把原始版本改糟了, 所以另外複製一份來改 (hg clone [origin] [dst]).
4. 在複製檔案夾上改一改, 覺得弄完一小階段了, 先大致查看一下修改了些甚麼(hg status), 然後儲存修改 (hg commit).
5. 重複修改的過程.
5.x 哇!遇到錯誤了怎麼辦? 沒關係, 用'快速鍵'將修改復原(hg revert [id]).
6. 改得滿意了, 將修改的東西存回原始檔案夾 (hg push [origin]).
7. 整理一下原始檔案夾(hg update), 確認修改沒衝突.

其他應用
* 開個 分享讓其他人也可以用(hg serve [-p port])
* 看看修改歷程(hg log)
* 看看修改的內容 (hg diff)
* 修改有衝突了, 進去檔案看看, 解決它 (hg merge)
* 接受其他人的修改 (hg pull)