了解 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 addremoveadding oneadding two(mercurial-env)$ hg commit -m 'Adding stuff'(mercurial-env)$ hg logchangeset: 0:1f1befb5d1e9tag: tipuser: Moshe Zadka <[[email protected]][4]>date: Fri Mar 29 12:42:43 2019 -0700summary: Adding stuff
addremove
命令很有用:它將任何未被忽略的新檔案新增到託管檔案列表中,並移除任何已刪除的檔案。
如我所說,Mercurial 擴充套件用 Python 寫成,它們只是常規的 Python 模組。
這是一個簡短的 Mercurial 擴充套件範例:
from mercurial import registrarfrom 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 worldhello world
大多數擴充套件會做更多有用的東西,甚至可能與 Mercurial 有關。 repo
物件是 mercurial.hg.repository
的物件。
有關 Mercurial API 的更多資訊,請參閱官方文件。並存取官方倉庫獲取更多範例和靈感。