一、困惑

作為一個(gè) Python 初學(xué)者，我在包管理上感到相當(dāng)疑惑（嗯，是困惑）。主要表現(xiàn)在下面幾個(gè)方面：

為了弄清這些問(wèn)題，我找了許多資料。最后發(fā)現(xiàn)最好的資料還是 python 的官方文檔。

下面是閱讀了所有我找到的資料后的一個(gè)總結(jié)，希望能幫到幾個(gè)月后又把這些全部忘光的那個(gè)自己。

二、python 包管理工具大亂斗

我用時(shí)間順序來(lái)描述亂斗過(guò)程。

1. distutils

distutils?是 python 標(biāo)準(zhǔn)庫(kù)的一部分，2000年發(fā)布。使用它能夠進(jìn)行 python 模塊的?安裝?和?發(fā)布。

setup.py 就是利用?distutils?的功能寫成，我們可以看一個(gè)簡(jiǎn)單的?setup.py?的例子。

在這里可以看到關(guān)于 setupt.py 格式的所有詳細(xì)描述：Writing the Setup Script。

要安裝一個(gè)模塊到當(dāng)前的 python 環(huán)境中，可以使用這個(gè)模塊提供的 setup.py 文件：

下面的代碼會(huì)發(fā)布一個(gè) python 模塊，將其打包成 tar.gz 或者 zip 壓縮包：

甚至能打包成 rpm 或者 exe 安裝包：

2. setuptools 和 distribute

setuptools?是一個(gè)為了增強(qiáng) distutils 而開發(fā)的集合，2004年發(fā)布。它包含了?easy_install?這個(gè)工具。

ez_setup.py?是 setuptools 的安裝工具。ez?就是?easy?的縮寫。

簡(jiǎn)單的說(shuō)，setuptools 是一個(gè)項(xiàng)目的名稱，是基礎(chǔ)組件。而?easy_install?是這個(gè)項(xiàng)目中提供的工具，它依賴基礎(chǔ)組件工作。

為了方便描述，下面文章中提到的 setuptools 被認(rèn)為與?easy_install?同義。

使用 setuptools 可以自動(dòng)?下載、構(gòu)建、安裝和管理?python 模塊。

例如，從 PyPI 上安裝一個(gè)包：

下載一個(gè)包文件，然后安裝它：

從一個(gè) .egg 格式安裝：

distribute?是 setuptools 的一個(gè)分支版本。分支的原因可能是有一部分開發(fā)者認(rèn)為 setuptools 開發(fā)太慢了。但現(xiàn)在，distribute 又合并回了 setuptools 中。因此，我們可以認(rèn)為它們是同一個(gè)東西。事實(shí)上，如果你查看一下?easy_install?的版本，會(huì)發(fā)現(xiàn)它本質(zhì)上就是 distribute 。

3. Eggs

Eggs?格式是 setuptools 引入的一種文件格式，它使用 .egg 擴(kuò)展名，用于 Python 模塊的安裝。

setuptools 可以識(shí)別這種格式。并解析它，安裝它。

想要詳細(xì)了解，可以看看這篇：The Quick Guide to Python Eggs。

Eggs are to Pythons as Jars are to Java..

4. pip

注意，從此處開始，easy_install?和?setuptools?不再同義。

pip?是目前 python 包管理的事實(shí)標(biāo)準(zhǔn)，2008年發(fā)布。它被用作?easy_install?的替代品，但是它仍有大量的功能建立在 setuptools 組件之上。

pip 希望不再使用?Eggs?格式（雖然它支持 Eggs），而更希望采用“源碼發(fā)行版”（使用?python setup.py sdist?創(chuàng)建）。這可以充分利用?Requirements File Format?提供的方便功能。

pip 可以利用 requirments.txt 來(lái)實(shí)現(xiàn)在依賴的安裝。在?setup.py?中，也存在一個(gè)?install_requires?表來(lái)指定依賴的安裝。它們的區(qū)別在哪里？可以看這篇文章：setup.py vs requirements.txt?（中文版）。

pip 支持?git/svn/hg 等流行的 VCS 系統(tǒng)，可以直接從 gz 或者 zip 壓縮包安裝，支持搜索包，以及指定服務(wù)器安裝等等功能。

pip vs easy_install?詳細(xì)介紹了兩者的不同。它們可以說(shuō)是各占勝場(chǎng)，但 pip 明顯優(yōu)勢(shì)更大。

5. wheel

wheel?本質(zhì)上是一個(gè) zip 包格式，它使用 .whl 擴(kuò)展名，用于 python 模塊的安裝，它的出現(xiàn)是為了替代 Eggs。

wheel 還提供了一個(gè)?bdist_wheel?作為 setuptools 的擴(kuò)展命令，這個(gè)命令可以用來(lái)生成 wheel 包。

pip 提供了一個(gè) wheel 子命令來(lái)安裝 wheel 包。當(dāng)然，需要先安裝 wheel 模塊。

setup.cfg?可以用來(lái)定義 wheel 打包時(shí)候的相關(guān)信息。

Wheel vs Egg?詳細(xì)介紹了 wheel 和 Eggs 格式的區(qū)別，很顯然，wheel 優(yōu)勢(shì)明顯。

Python Wheels?網(wǎng)站展示了使用 Wheels 發(fā)行的 python 模塊在 PyPI 上的占有率。

pypip.in?也支持 wheel。

6. distutils2 和 distlib

distutils2?被設(shè)計(jì)為?distutils?的替代品。從2009年開發(fā)到2012年。它包含更多的功能，并希望以?packaging?作為名稱進(jìn)入 python 3.3 成為標(biāo)準(zhǔn)庫(kù)的一部分。但這個(gè)計(jì)劃?后來(lái)停滯了?。

distlib?是?distutils2?的部分，它為?distutils2/packaging?提供的低級(jí)功能增加高級(jí) API，使其便于使用。

這里?介紹了 distlib 沒(méi)有進(jìn)入 python 3.3 標(biāo)準(zhǔn)庫(kù)的一些原因。

因此，可以暫時(shí)不必了解這兩個(gè)工具，靜觀其變即可。

三、工具選擇

如果仔細(xì)看過(guò)上面的亂斗內(nèi)容，我相信你已經(jīng)清楚當(dāng)前應(yīng)該如何選擇了。

對(duì)于我這樣剛剛開始的新手來(lái)說(shuō)，自然是使用 pip 而不使用?easy_install?了。

如果發(fā)布模塊，當(dāng)然是使用 wheel 格式。

四、發(fā)布自己的模塊

對(duì)于 python3 程序員來(lái)說(shuō)，當(dāng)然應(yīng)該先看這一篇：Distributing Python Modules。

另外，Tutorial on Packaging and Distributing Projects?也足夠詳細(xì)和官方。

而 Python2 程序員則應(yīng)該看這篇?Distributing Python Modules?。

當(dāng)然，setuptools 的官方文檔也是不錯(cuò)的教程：Building and Distributing Packages with Setuptools?。

這篇教程可以用來(lái)入門：Sharing Your Labor of Love: PyPI Quick and Dirty

至于如何發(fā)布自己的模塊到 PyPI 或者搭建自己的私有包管理服務(wù)器，上面的文章已經(jīng)講得非常清楚了。

五、引用

上面提到的大部分資料，都是在這里找到，或者是提到：Python Packaging User Guide。