前言

我們經常可以看到github上的python開源專案有pipy的選項，及下載量的統計，是不是很驚訝於他們的professional?

我們要如何打造自已的downloads統計?這個統計資訊其實來自於crate.io,一個pypi的映象站點，只要你上傳了包在pypi,crate.io就會自動儲存相關的包並統計相關資訊.

另外,這個包傳到pip上, 這樣就可以直接用 pip install yourproject,或者只在requirments.txt中寫個your-project就可以哦了;)

是不是也很想要在自已的開源專案加這個？那跟我來吧。

註冊賬號

   記住你的密碼（也可以用gmail登入)

專案修改

首先建立專案檔案和setup檔案。
目錄檔案結構如下：

project/
    simpletest/
        __init__.py
        test.py
    setup.py

使用者使用pip或easy_install安裝時會自動下載依賴的包。詳細的格式參考文件。

from setuptools import setup, find_packages

setup(
    name = 'simpletest',
    version = '0.0.1',
    keywords = ('simple', 'test'),
    description = 'just a simple test',
    license = 'MIT License',
    install_requires = ['simplejson>=1.1'],

    author = 'test',
    author_email = '
 
[email protected]',
    
    packages = find_packages(),
    platforms = 'any',
)

# 以下所有生成檔案將在當前路徑下 dist 目錄中
python setup.py bdist_egg # 生成easy_install支援的格式 
python setup.py sdist     # 生成pip支援的格式，下文以此為例

釋出到pypi首先需要註冊一個賬號，然後進行如下兩步：

上傳檔案。輸入python setup.py sdist upload。

安裝測試

上傳成功後，就可以使用pip來下載安裝了

另外，pypi還有一個測試伺服器，可以在這個測試伺服器上做測試，
測試的時候需要給命令指定額外的"-r"或"-i"選項，
如python setup.py register -r "https://testpypi.python.org/pypi", python setup.py sdist upload -r "https://testpypi.python.org/pypi", pip install -i "https://testpypi.python.org/pypi" simpletest

釋出到測試伺服器的時候，建議在linux或cygwin中釋出，如果是在windows中，參考文件，需要生成.pypirc檔案
在github你的專案中的README.rst中新增顯示圖片如cloudsafe改成你的專案名稱

.. image:: https://pypip.in/v/cloudsafe/badge.png
    :target: https://crate.io/packages/cloudsafe/
.. image:: https://pypip.in/d/cloudsafe/badge.png
    :target: https://crate.io/packages/cloudsafe/

https://crate.io/packages/cloudsafe/

最終效果如圖

reference

http://yejinxin.github.io/distribute-python-packages-to-pypi-server/

http://liluo.org/blog/2012/08/how-to-create-python-egg/
http://blog.jkey.lu/2013/04/11/create-python-egg/
http://docs.python.org/2/distutils/index.html