摘要：命令配置一個調(diào)用，使用在索引上的與兼容的頁來尋找和下載包。現(xiàn)在我們切回然后尋找我們的發(fā)行文件我們看到被包含在兩個索引中，讓我們移除的發(fā)行版如果你沒有指定選項(xiàng)，你將被詢問確認(rèn)刪除的交互式操作。

  
注：該文的原文是 Quickstart: uploading, testing, pushing releases，來自于 devpi 的官方文檔。

該快速入門文檔將引導(dǎo)你為你的 Python 包設(shè)置完成一個獨(dú)立的 pypi 發(fā)布上傳，測試和 staging 系統(tǒng)。

我想在我的筆記本上運(yùn)行完整的 devpi 系統(tǒng)：

pip install -U devpi

這將安裝 devpi-client 和 devpi-server 這兩個 pypi 包。

devpi quickstart 命令在你本地機(jī)器上執(zhí)行一些基礎(chǔ)的初始化步驟：

啟動一個后臺的 devpi-server，通過 http://localhost:3141 訪問

配置客戶端工具 devpi 來連接最新啟動的 devpi 服務(wù)

創(chuàng)建和登陸一個用戶，使用你當(dāng)前默認(rèn)的登陸名和一個空的密碼

創(chuàng)建一個索引然后直接使用它

讓我們運(yùn)行 quickstart 命令來觸發(fā)一系列的其他 devpi 命令：

$ devpi quickstart
--> $ devpi-server --start
2014-09-04 15:12:19,311 INFO  NOCTX DB: Creating schema
2014-09-04 15:12:19,353 INFO  [Wtx-1] setting password for user u"root"
2014-09-04 15:12:19,353 INFO  [Wtx-1] created user u"root" with email None
2014-09-04 15:12:19,353 INFO  [Wtx-1] created root user
2014-09-04 15:12:19,353 INFO  [Wtx-1] created root/pypi index
2014-09-04 15:12:19,367 INFO  [Wtx-1] fswriter0: committed: keys: u".config",u"root/.config"
starting background devpi-server at http://localhost:3141
/tmp/home/.devpi/server/.xproc/devpi-server$ /home/hpk/venv/0/bin/devpi-server
process u"devpi-server" started pid=841
devpi-server process startup detected
logfile is at /tmp/home/.devpi/server/.xproc/devpi-server/xprocess.log
--> $ devpi use http://localhost:3141
using server: http://localhost:3141/ (not logged in)
no current index: type "devpi use -l" to discover indices
~/.pydistutils.cfg     : no config file exists
~/.pip/pip.conf        : no config file exists
~/.buildout/default.cfg: no config file exists
always-set-cfg: no

--> $ devpi user -c testuser password=
user created: testuser

--> $ devpi login testuser --password=
logged in "testuser", credentials valid for 10.00 hours

--> $ devpi index -c dev
http://localhost:3141/testuser/dev:
  type=stage
  bases=root/pypi
  volatile=True
  uploadtrigger_jenkins=None
  acl_upload=testuser
  pypi_whitelist=

--> $ devpi use dev
current devpi index: http://localhost:3141/testuser/dev (logged in as testuser)
~/.pydistutils.cfg     : no config file exists
~/.pip/pip.conf        : no config file exists
~/.buildout/default.cfg: no config file exists
always-set-cfg: no
COMPLETED!  you can now work with your "dev" index
  devpi install PKG   # install a pkg from pypi
  devpi upload        # upload a setup.py based project
  devpi test PKG      # download and test a tox-based project
  devpi PUSH ...      # to copy releases between indexes
  devpi index ...     # to manipulate/create indexes
  devpi use ...       # to change current index
  devpi user ...      # to manipulate/create users
  devpi CMD -h        # help for a specific command
  devpi -h            # general help
docs at http://doc.devpi.net

顯示版本：

$ devpi --version
2.0.2

我們現(xiàn)在可以使用 devpi 命令行客戶端來觸發(fā)一個從已經(jīng)運(yùn)行的服務(wù)器上使用索引的 pypi 包的 pip install。

$ devpi install pytest
--> $ /tmp/docenv/bin/pip install -U -i http://localhost:3141/testuser/dev/+simple/ pytest  [PIP_USE_WHEEL=1,PIP_PRE=1]
Downloading/unpacking pytest
  http://localhost:3141/testuser/dev/+simple/pytest/ uses an insecure transport scheme (http). Consider using https if localhost:3141 has it available
  Running setup.py (path:/tmp/docenv/build/pytest/setup.py) egg_info for package pytest

http://localhost:3141/testuser/dev/+simple/py/ uses an insecure transport scheme (http). Consider using https if localhost:3141 has it available
Requirement already up-to-date: py>=1.4.22 in /tmp/docenv/lib/python2.7/site-packages (from pytest)
Installing collected packages: pytest
  Running setup.py install for pytest

    Installing py.test-2.7 script to /tmp/docenv/bin
    Installing py.test script to /tmp/docenv/bin
Successfully installed pytest
Cleaning up...

devpi install 命令配置一個 pip 調(diào)用，使用在 testuser/dev 索引上的與 pypi 兼容的 +simple/ 頁來尋找和下載包。pip 執(zhí)行的是在 PATH 搜索和在 docenv/bin/pip 尋找。

讓我們檢查 pytest 是否被正確安裝：

$ py.test --version
This is pytest version 2.6.1, imported from /tmp/docenv/local/lib/python2.7/site-packages/pytest.pyc

你可以第二次調(diào)用 devpi install 命令，即使在沒有網(wǎng)絡(luò)的情況下，它也能正常工作。

我們將使用 devpi 命令行工具來執(zhí)行上傳（你也可以使用 plain setup.py）。

讓我們檢查我們已經(jīng)登錄進(jìn)了正確的索引：

$ devpi use
current devpi index: http://localhost:3141/testuser/dev (logged in as testuser)
~/.pydistutils.cfg     : no config file exists
~/.pip/pip.conf        : no config file exists
~/.buildout/default.cfg: no config file exists
always-set-cfg: no

現(xiàn)在進(jìn)入你其中一個項(xiàng)目的 setup.py 文件的目錄（我們假設(shè)名字為 example） 來構(gòu)建和上傳你的包到 testuser/dev 索引。

example $ devpi upload
using workdir /tmp/devpi0
--> $ /usr/bin/hg st -nmac .
hg-exported project to /tmp/devpi0/upload/example -> new CWD
--> $ /tmp/docenv/bin/python setup.py sdist --formats gztar
built: /home/hpk/p/devpi/doc/example/dist/example-1.0.tar.gz [SDIST.TGZ] 0kb
register example-1.0 to http://localhost:3141/testuser/dev/
file_upload of example-1.0.tar.gz to http://localhost:3141/testuser/dev/

這里有三個觸發(fā)動作：

檢測到一個 mercurial 庫，導(dǎo)致拷貝所有的文件版本到一個臨時工作目錄。如果你沒有使用 mercurial，拷貝動作會跳過，會直接在你的源碼樹上做上傳操作。

如我們在 setup.py 中定義的，把 example 版本注冊進(jìn)我們當(dāng)前的索引

從工作目錄，構(gòu)建和上傳一個 gztar 格式的文件到當(dāng)前索引（使用一個在鉤子下面的 setup.py 調(diào)用）

我們現(xiàn)在可以安裝剛上傳好的包：

$ devpi install example
--> $ /tmp/docenv/bin/pip install -U -i http://localhost:3141/testuser/dev/+simple/ example  [PIP_USE_WHEEL=1,PIP_PRE=1]
Downloading/unpacking example
  http://localhost:3141/testuser/dev/+simple/example/ uses an insecure transport scheme (http). Consider using https if localhost:3141 has it available
  Downloading example-1.0.tar.gz
  Running setup.py (path:/tmp/docenv/build/example/setup.py) egg_info for package example

Installing collected packages: example
  Running setup.py install for example

Successfully installed example
Cleaning up...

這個你剛剛從 testuser/dev 索引安裝的上傳包是我們開始上傳好的包。

  
注意：devpi upload 允許同時上傳你的發(fā)行文件的多個不同格式，比如：sdist.zip 或是 bdist_egg，默認(rèn)是 sdist.tgz。

如果你有一個包使用 tox 做測試，你或許要調(diào)用：

$ devpi test example  # package needs to contain tox.ini
received http://localhost:3141/testuser/dev/+f/5bc/44b5ac34ff65b/example-1.0.tar.gz#md5=5bc44b5ac34ff65b6b16b332f9ccc22c
unpacking /tmp/devpi-test0/downloads/example-1.0.tar.gz to /tmp/devpi-test0
/tmp/devpi-test0/example-1.0$ tox --installpkg /tmp/devpi-test0/downloads/example-1.0.tar.gz -i ALL=http://localhost:3141/testuser/dev/+simple/ --result-json /tmp/devpi-test0/toxreport.json -c /tmp/devpi-test0/example-1.0/tox.ini
python create: /tmp/devpi-test0/example-1.0/.tox/python
python installdeps: pytest
python inst: /tmp/devpi-test0/downloads/example-1.0.tar.gz
python runtests: PYTHONHASHSEED="2866296898"
python runtests: commands[0] | py.test
___________________________________ summary ____________________________________
  python: commands succeeded
  congratulations :)
wrote json report at: /tmp/devpi-test0/toxreport.json
posting tox result data to http://localhost:3141/testuser/dev/+f/5bc/44b5ac34ff65b/example-1.0.tar.gz
successfully posted tox result data

以上操作發(fā)生了這些事：

devpi 從當(dāng)前的索引中獲取 example 的最新可用版本

把它解壓到一個臨時目錄，發(fā)現(xiàn) tox.ini 并且調(diào)用 tox，把它指向我們的 example-1.0.tar.gz。強(qiáng)迫所有的安裝都通過我們當(dāng)前的 testuser/dev/+simple/ 索引和命令它創(chuàng)建一個 json 格式的報告

在所有的測試運(yùn)行完成后，我們發(fā)送 toxreport.json 到 devpi 服務(wù)器去，它將被精確的連接到我們的發(fā)行文件

我們可以校驗(yàn)測試狀態(tài)是否被記錄：

$ devpi list example
http://localhost:3141/testuser/dev/+f/5bc/44b5ac34ff65b/example-1.0.tar.gz
  cobra linux2 python 2.7.6 tests passed

一旦你覺得發(fā)行文件沒有問題，你可以把它推送到一個 devpi-managed 索引和一個外部的 pypi 索引服務(wù)器。

讓我們創(chuàng)建另外一個 staging 索引：

$ devpi index -c staging volatile=False
http://localhost:3141/testuser/staging:
  type=stage
  bases=root/pypi
  volatile=False
  uploadtrigger_jenkins=None
  acl_upload=testuser
  pypi_whitelist=

我們創(chuàng)建了一個非易失性的索引，這意味著不能覆蓋和刪除發(fā)行文件，看 Non Volatile Indexes 來獲取更多信息。

我們現(xiàn)在可以把 example-1.0.tar.gz 從上面的所有推送到 staging 索引：

$ devpi push example-1.0 testuser/staging
   200 register example 1.0 -> testuser/staging
   200 store_releasefile testuser/staging/+f/5bc/44b5ac34ff65b/example-1.0.tar.gz
   200 store_toxresult testuser/staging/+f/5bc/44b5ac34ff65b/example-1.0.tar.gz.toxresult0

這將決定所有在 testuser/dev 索引上的文件屬于指定的 example-1.0 發(fā)行版并且把它們拷貝進(jìn) testuser/staging 索引。

讓我們檢查我們當(dāng)前的索引：

$ devpi use
current devpi index: http://localhost:3141/testuser/dev (logged in as testuser)
~/.pydistutils.cfg     : no config file exists
~/.pip/pip.conf        : no config file exists
~/.buildout/default.cfg: no config file exists
always-set-cfg: no

讓我們使用 testuser/staging 索引：

$ devpi use testuser/staging
current devpi index: http://localhost:3141/testuser/staging (logged in as testuser)
~/.pydistutils.cfg     : no config file exists
~/.pip/pip.conf        : no config file exists
~/.buildout/default.cfg: no config file exists
always-set-cfg: no

并且再次檢查測試結(jié)果：

$ devpi list example
http://localhost:3141/testuser/staging/+f/5bc/44b5ac34ff65b/example-1.0.tar.gz
  cobra linux2 python 2.7.6 tests passed

從最后一步推送后，測試狀態(tài)依然是可用的。

我們現(xiàn)在可以決定推送這個發(fā)行版到外部的 pypi 索引，我們已經(jīng)在 .pypirc 文件中配置了：

$ devpi push example-1.0 pypi:testrun
no pypirc file found at: /tmp/home/.pypirc

這將推送 example-1.0 發(fā)行版的所有的文件到一個外部的 testrun 索引服務(wù)器。使用資格證書和 發(fā)現(xiàn)在 pypi 章節(jié) .pypirc 文件中的 URL。

現(xiàn)在，我們已經(jīng)有 example-1.0 發(fā)行版和發(fā)行版文件在 testuser/dev 和 testuser/staging 索引，如果我們想在我們的開發(fā)索引上一直使用 staging 包，我們可以重新配置 testuser/dev 的繼承基線。

$ devpi index testuser/dev bases=testuser/staging
/testuser/dev changing bases: ["testuser/staging"]
http://localhost:3141/testuser/dev:
  type=stage
  bases=testuser/staging
  volatile=True
  uploadtrigger_jenkins=None
  acl_upload=testuser
  pypi_whitelist=

現(xiàn)在我們切回 testuser/dev：

$ devpi use testuser/dev
current devpi index: http://localhost:3141/testuser/dev (logged in as testuser)
~/.pydistutils.cfg     : no config file exists
~/.pip/pip.conf        : no config file exists
~/.buildout/default.cfg: no config file exists
always-set-cfg: no

然后尋找我們的 example 發(fā)行文件：

$ devpi list example
http://localhost:3141/testuser/dev/+f/5bc/44b5ac34ff65b/example-1.0.tar.gz
  cobra linux2 python 2.7.6 tests passed
http://localhost:3141/testuser/staging/+f/5bc/44b5ac34ff65b/example-1.0.tar.gz
  cobra linux2 python 2.7.6 tests passed

我們看到 example-1.0.tar.gz 被包含在兩個索引中，讓我們移除 testuser/dev 的 example 發(fā)行版：

$ devpi remove -y example
About to remove the following releases and distributions
version: 1.0
  - http://localhost:3141/testuser/dev/+f/5bc/44b5ac34ff65b/example-1.0.tar.gz
  - http://localhost:3141/testuser/dev/+f/5bc/44b5ac34ff65b/example-1.0.tar.gz.toxresult0
Are you sure (yes/no)? yes (autoset from -y option)
deleting release 1.0 of example

如果你沒有指定 -y 選項(xiàng)，你將被詢問確認(rèn)刪除的交互式操作。

example-1.0 發(fā)行版本仍然可以通過 testuser/dev 訪問，因?yàn)樗麖?testuser/staging 基線繼承了所有的發(fā)行版。

$ devpi list example
http://localhost:3141/testuser/staging/+f/5bc/44b5ac34ff65b/example-1.0.tar.gz
  cobra linux2 python 2.7.6 tests passed

$ devpi-server --stop
killed server pid=841

如果你想配置安裝一個永久的 devpi-server。你也可以通過 Quickstart: permanent install on server/laptop 獲取一些幫助。