“pygit是一個(gè)大約500行Python代碼工具，實(shí)現(xiàn)了一些git功能，包括創(chuàng)建庫(kù)、將文件添加到索引、提交、將自身推送到GitHub上去。 本文給出了一些代碼編寫過程，并詳細(xì)介紹了相關(guān)代碼?！?/p>

　　Git因其具有非常簡(jiǎn)單的對(duì)象模型而著稱。在學(xué)習(xí)git時(shí)，我發(fā)現(xiàn)本地對(duì)象數(shù)據(jù)庫(kù)只是.git目錄中的一堆普通文件。除了索引（.git/index）和打包文件（可有可無）外，這些文件的存放規(guī)則和格式相當(dāng)?shù)暮?jiǎn)單。

　　受Mary Rose Cook的程序啟發(fā)，我也想看看是否能夠編寫出創(chuàng)建倉(cāng)庫(kù)，執(zhí)行提交，并推送到服務(wù)器（比如GitHub）的git客戶端。

　　Mary的gitlet程序有著很多可供學(xué)習(xí)的地方，而我的程序需要把自身推送到GitHub上去，所以具有更多的創(chuàng)新功能。在某些方面，她實(shí)現(xiàn)了更多的Git功能（包括基本的合并），但在其他方面實(shí)現(xiàn)的功能就比較的少。例如，她使用了一個(gè)簡(jiǎn)單的基于文本的索引格式，而不是用git使用的二進(jìn)制格式。此外，雖然她的gitlet支持推送，但它只會(huì)推送到本地已經(jīng)存在的倉(cāng)庫(kù)中，而不是到遠(yuǎn)程服務(wù)器上。

　　對(duì)于本文涉及的這個(gè)練習(xí)，我打算編寫一個(gè)可以執(zhí)行所有步驟的版本，包括推送到一個(gè)真正的Git服務(wù)器上去。我也會(huì)使用與git相同的二進(jìn)制索引格式，這樣，我就可以在每一步驟上都使用git命令來檢查程序的功能。

　　我的程序叫pygit，用Python（3.5+）編寫，并且只使用了標(biāo)準(zhǔn)庫(kù)模塊。它只有500行代碼，包括空白行和注釋。我至少需要實(shí)現(xiàn)init、add、commit和push命令，但pygit還實(shí)現(xiàn)了status，diff，cat-file，ls-files和hash-object等命令。后面的命令，本身也非常有用，并且在調(diào)試pygit的時(shí)候，也起到了幫助作用。

　　下面，讓我們來看看代碼吧！您可以在GitHub上查看pygit.py的所有代碼，或者在下文中跟著我一起瀏覽各段代碼。

　　初始化倉(cāng)庫(kù)

　　初始化本地Git倉(cāng)庫(kù)只需要?jiǎng)?chuàng)建.git目錄以及目錄下的幾個(gè)文件和子目錄即可。在定義了read_file和write_file這兩個(gè)幫助函數(shù)之后，我們就可以編寫init（）了：

　　你可能注意到這段代碼里沒有進(jìn)行優(yōu)雅的錯(cuò)誤處理。畢竟這整個(gè)代碼只有500行啊。如果倉(cāng)庫(kù)目錄已經(jīng)存在，程序會(huì)終止，并拋出traceback。

　　取對(duì)象的散列值

　　hash_object函數(shù)用來獲取單個(gè)文件對(duì)象的散列值，并寫入.git/objects目錄下的“數(shù)據(jù)庫(kù)”中。在Git模型中，包含三種對(duì)象，分別是：普通文件（blob），提交（commit）和樹（tree，也就是目錄結(jié)構(gòu)）。

　　每個(gè)對(duì)象都有一個(gè)文件頭，包括文件類型和文件大小，大概幾個(gè)字節(jié)的長(zhǎng)度。之后是NUL字符，然后是文件的數(shù)據(jù)內(nèi)容。所有這些都使用zlib壓縮并寫入到文件.git/objects/ab/cd…中，其中ab是40個(gè)字符長(zhǎng)的SHA-1散列的前兩個(gè)字符，而cd…則是剩余的部分。

　　請(qǐng)注意，這里使用了Python標(biāo)準(zhǔn)庫(kù)（os和hashlib）。

　　還有個(gè)find_object（）函數(shù)，它通過散列（或散列前綴）找到某個(gè)文件對(duì)象，然后用read_object（）函數(shù)讀取這個(gè)對(duì)象及其類型。這實(shí)際上是hash_object（）的反向操作。最后，cat_file是一個(gè)與git cat-file具有相同功能的pygit函數(shù)：它將對(duì)象的內(nèi)容（或者大小和類型）進(jìn)行格式化并打印到標(biāo)準(zhǔn)輸出。