瞭解 Mercurial 的基礎知識，它是一個用 Python 寫的分散式版本控制系統。
Mercurial 是一個用 Python 編寫的分散式版本控制系統。因為它是用高階語言編寫的，所以你可以用 Python 函式編寫一個 Mercurial 擴充套件。
在官方文件中說明了幾種安裝 Mercurial 的方法。我最喜歡的一種方法不在裡面：使用 pip。這是開發本地擴充套件的最合適方式！
目前，Mercurial 僅支援 Python 2.7，因此你需要建立一個 Python 2.7 虛擬環境：
python2 -m virtualenv mercurial-env
./mercurial-env/bin/pip install mercurial
複製程式碼為了讓命令簡短一些，以及滿足人們對化學幽默的渴望，該命令稱之為 hg。
$ source mercurial-env/bin/activate
(mercurial-env)$ mkdir test-dir
(mercurial-env)$ cd test-dir
(mercurial-env)$ hg init
(mercurial-env)$ hg status
(mercurial-env)$
複製程式碼由於還沒有任何檔案，因此狀態為空。新增幾個檔案：
(mercurial-env)$ echo 1 > one
(mercurial-env)$ echo 2 > two
(mercurial-env)$ hg status
? one
? two
(mercurial-env)$ hg addremove
adding one
adding two
(mercurial-env)$ hg commit -m 'Adding stuff'
(mercurial-env)$ hg log
changeset: 0:1f1befb5d1e9
tag: tip
user: Moshe Zadka <[moshez@zadka.club][4]>
date: Fri Mar 29 12:42:43 2019 -0700
summary: Adding stuff
複製程式碼addremove 命令很有用：它將任何未被忽略的新檔案新增到託管檔案列表中，並移除任何已刪除的檔案。
如我所說，Mercurial 擴充套件用 Python 寫成，它們只是常規的 Python 模組。
這是一個簡短的 Mercurial 擴充套件示例：
from mercurial import registrar
from mercurial.i18n import _
cmdtable = {}
command = registrar.command(cmdtable)
@command('say-hello',
[('w', 'whom', '', _('Whom to greet'))])
def say_hello(ui, repo, `opts):
ui.write("hello ", opts['whom'], "\n")
複製程式碼簡單的測試方法是將它手動加入虛擬環境中的檔案中：
`$ vi ../mercurial-env/lib/python2.7/site-packages/hello_ext.py`
複製程式碼然後你需要啟用擴充套件。你可以僅在當前倉庫中啟用它：
$ cat >> .hg/hgrc
[extensions]
hello_ext =
複製程式碼現在，問候有了：
(mercurial-env)$ hg say-hello --whom world
hello world
複製程式碼大多數擴充套件會做更多有用的東西，甚至可能與 Mercurial 有關。 repo 物件是 mercurial.hg.repository 的物件。
有關 Mercurial API 的更多資訊，請參閱官方文件。並訪問官方倉庫獲取更多示例和靈感。
via: opensource.com/article/19/…
作者：Moshe Zadka 選題：lujun9972 譯者：geekpi 校對：wxy