Mercurial 版本控制入門 | Linux 中國

Mercurial[1] 是一個用 Python 編寫的分散式版本控制系統。因為它是用高階語言編寫的，所以你可以用 Python 函式編寫一個 Mercurial 擴充套件。

在官方檔案中[2]說明瞭幾種安裝 Mercurial 的方法。我最喜歡的一種方法不在裡面：使用 pip。這是開發本地擴充套件的最合適方式！

目前，Mercurial 僅支援 Python 2.7，因此你需要建立一個 Python 2.7 虛擬環境：

1. python2 -m virtualenv mercurial-env
2. ./mercurial-env/bin/pip install mercurial

為了讓命令簡短一些，以及滿足人們對化學幽默的渴望，該命令稱之為 hg。

1. $ source mercurial-env/bin/activate
2. (mercurial-env)$ mkdir test-dir
3. (mercurial-env)$ cd test-dir
4. (mercurial-env)$ hg init
5. (mercurial-env)$ hg status
6. (mercurial-env)$

由於還沒有任何檔案，因此狀態為空。新增幾個檔案：

1. (mercurial-env)$ echo 1 > one
2. (mercurial-env)$ echo 2 > two
3. (mercurial-env)$ hg status
4. ? one
5. ? two
6. (mercurial-env)$ hg addremove
7. adding one
8. adding two
9. (mercurial-env)$ hg commit -m 'Adding stuff'
10. (mercurial-env)$ hg log
11. changeset: 0:1f1befb5d1e9
12. tag: tip
13. user: Moshe Zadka moshez@zadka.club][4]>
14. date: Fri Mar 29 12:42:43 2019 -0700
15. summary: Adding stuff

addremove 命令很有用：它將任何未被忽略的新檔案新增到託管檔案串列中，並移除任何已刪除的檔案。

如我所說，Mercurial 擴充套件用 Python 寫成，它們只是常規的 Python 模組。

這是一個簡短的 Mercurial 擴充套件示例：

1. from mercurial import registrar
2. from mercurial.i18n import _
4. cmdtable = {}
5. command = registrar.command(cmdtable)
7. @command('say-hello',
8. [('w', 'whom', '', _('Whom to greet'))])
9. def say_hello(ui, repo, `opts):
10. ui.write("hello ", opts['whom'], "\n")

簡單的測試方法是將它手動加入虛擬環境中的檔案中：

1. `$ vi ../mercurial-env/lib/python2.7/site-packages/hello_ext.py`

然後你需要啟用擴充套件。你可以僅在當前倉庫中啟用它：

1. $ cat >> .hg/hgrc
2. [extensions]
3. hello_ext =

現在，問候有了：

1. (mercurial-env)$ hg say-hello --whom world
2. hello world

大多數擴充套件會做更多有用的東西，甚至可能與 Mercurial 有關。repo 物件是 mercurial.hg.repository 的物件。

有關 Mercurial API 的更多資訊，請參閱官方檔案[3]。並訪問官方倉庫[4]獲取更多示例和靈感。