摘要：安全，廣泛地使用校驗(yàn)，能夠自動(dòng)曝露安全漏洞。部分用來(lái)設(shè)置倉(cāng)庫(kù)地址，部分用來(lái)指定項(xiàng)目依賴(lài)的包，部分用來(lái)指定開(kāi)發(fā)環(huán)境需要的包，這樣分開(kāi)便于管理。參考鏈接新款虛擬環(huán)境工具詳解筆記使用指南官方推薦的包管理工具

pipenv 是 python 官方推薦的包管理工具，集成了 virtualenv、pyenv 和 pip 三者的功能于一身，類(lèi)似于 php 中的 composer。

我們知道，為了方便管理 python 的虛擬環(huán)境和庫(kù)，通常使用較多的是 virtualenv 、pyenv 和 pip，但是他們不夠好用或者說(shuō)不夠偷懶。于是 requests 的作者 Kenneth Reitz 開(kāi)發(fā)了用于創(chuàng)建和管理 python 虛擬環(huán)境的工具 —- pipenv。

它能夠自動(dòng)為項(xiàng)目創(chuàng)建和管理虛擬環(huán)境，從 Pipfile 文件中添加或者刪除包，同時(shí)生成 Pipfile.lock 文件來(lái)鎖定安裝包的版本和依賴(lài)信息，避免構(gòu)建錯(cuò)誤。

pipenv 主要解決了以下問(wèn)題：

不用再多帶帶使用 virtualenv、pyenv 和 pip 了，現(xiàn)在它們結(jié)合到了一起。

不用再維護(hù) requirement.txt 了，使用 Pipfile 和 Pipfile.lock 來(lái)代替。

可以在開(kāi)發(fā)環(huán)境使用多個(gè) python 版本。

在安裝的 pyenv 條件下，可以自動(dòng)安裝需要的 python 版本。

安全，廣泛地使用 Hash 校驗(yàn)，能夠自動(dòng)曝露安全漏洞。

隨時(shí)查看圖形化的依賴(lài)關(guān)系。

由于我的開(kāi)發(fā)環(huán)境一直都是 Mac 筆記本，所以這里只介紹在 Mac 環(huán)境如何安裝好了。

$ pip install --user pipenv

這個(gè)命令在用戶級(jí)別（非系統(tǒng)全局）下安裝 pipenv。如果安裝后 shell 提示找不到 pipenv 命令，你需要添加當(dāng)前 Python 用戶主目錄的 bin 目錄到 PATH 環(huán)境變量。如果你不知道 Python 用戶主目錄在哪里，用下面的命令來(lái)查看：

$ python -m site --user-base

你會(huì)看到類(lèi)似下面的輸出

/Users/liyafeng/Library/Python/3.6

Mac 下使用 brew 安裝軟件應(yīng)該是最方便的了，推薦使用：

brew install pipenv

升級(jí) pipenv：

brew upgrade pipenv

Linux or Mac 環(huán)境下，bash下如果能自動(dòng)命令補(bǔ)全豈不是更好？請(qǐng)把如下語(yǔ)句追加到.bashrc或者.zshrc即可：

eval "$(pipenv --completion)"

pipenv 具有的選項(xiàng)：

$ pipenv
Usage: pipenv [OPTIONS] COMMAND [ARGS]...

Options:
  --where          顯示項(xiàng)目文件所在路徑
  --venv           顯示虛擬環(huán)境實(shí)際文件所在路徑
  --py             顯示虛擬環(huán)境Python解釋器所在路徑
  --envs           顯示虛擬環(huán)境的選項(xiàng)變量
  --rm             刪除虛擬環(huán)境
  --bare           最小化輸出
  --completion     完整輸出
  --man            顯示幫助頁(yè)面
  --three / --two  使用Python 3/2創(chuàng)建虛擬環(huán)境（注意本機(jī)已安裝的Python版本）
  --python TEXT    指定某個(gè)Python版本作為虛擬環(huán)境的安裝源
  --site-packages  附帶安裝原Python解釋器中的第三方庫(kù)
  --jumbotron      An easter egg, effectively.
  --version        版本信息
  -h, --help       幫助信息

pipenv 可使用的命令參數(shù)：

Commands:
  check      檢查安全漏洞
  graph      顯示當(dāng)前依賴(lài)關(guān)系圖信息
  install    安裝虛擬環(huán)境或者第三方庫(kù)
  lock       鎖定并生成Pipfile.lock文件
  open       在編輯器中查看一個(gè)庫(kù)
  run        在虛擬環(huán)境中運(yùn)行命令
  shell      進(jìn)入虛擬環(huán)境
  uninstall  卸載一個(gè)庫(kù)
  update     卸載當(dāng)前所有的包，并安裝它們的最新版本

一些例子：

Usage Examples:
   Create a new project using Python 3.6, specifically:
   $ pipenv --python 3.6

   Install all dependencies for a project (including dev):
   $ pipenv install --dev

   Create a lockfile containing pre-releases:
   $ pipenv lock --pre

   Show a graph of your installed dependencies:
   $ pipenv graph

   Check your installed dependencies for security vulnerabilities:
   $ pipenv check

   Install a local setup.py into your virtual environment/Pipfile:
   $ pipenv install -e .

   Use a lower-level pip command:
   $ pipenv run pip freeze

mkdir new_env & cd new_env
pipenv install     // pipenv install --three

如果指定了 --two 或者 --three 選項(xiàng)參數(shù)，則會(huì)使用 python2 或者 python3 的版本安裝，否則將使用默認(rèn)的 python 版本來(lái)安裝。當(dāng)然也可以指定準(zhǔn)確的版本信息：

$ pipenv install --python 3
$ pipenv install --python 3.6
$ pipenv install --python 2.7.14

pipenv 會(huì)自動(dòng)掃描系統(tǒng)尋找合適的版本信息，如果找不到的話，同時(shí)又安裝了 pyenv 的話，則會(huì)自動(dòng)調(diào)用 pyenv 下載對(duì)應(yīng)版本的 python， 否則會(huì)報(bào)錯(cuò)。

這時(shí)候在當(dāng)前 new_env 環(huán)境下生成 Pipfile 和 Pipfile.lock 兩個(gè)環(huán)境初始化文件。

進(jìn)入環(huán)境：

pipenv shell 

退出環(huán)境：

exit //或者 ctrl+d

這里我們測(cè)試安裝 urllib3 包好了：

pipenv install urllib3

此時(shí)，Pipfile 里有最新安裝的包文件的信息，如名稱(chēng)、版本等。用來(lái)在重新安裝項(xiàng)目依賴(lài)或與他人共享項(xiàng)目時(shí)，你可以用 Pipfile 來(lái)跟蹤項(xiàng)目依賴(lài)。

Pipfile 是用來(lái)替代原來(lái)的 requirements.txt 的，內(nèi)容類(lèi)似下面這樣。source 部分用來(lái)設(shè)置倉(cāng)庫(kù)地址，packages 部分用來(lái)指定項(xiàng)目依賴(lài)的包，dev-packages 部分用來(lái)指定開(kāi)發(fā)環(huán)境需要的包，這樣分開(kāi)便于管理。

$ cat Pipfile
[[source]]
url = "https://pypi.org/simple"
verify_ssl = true
name = "pypi"

[packages]
"urllib3" = "*"

[dev-packages]

[requires]
python_version = "3.6"

Pipfile.lock 則包含你的系統(tǒng)信息，所有已安裝包的依賴(lài)包及其版本信息，以及所有安裝包及其依賴(lài)包的 Hash 校驗(yàn)信息。

$ Pipfile.lock
{
    "_meta": {
        "hash": {
            "sha256": "af58f3510cb613d4d9241128f9a0ceb9bb936ad907543e23ad8317011dcb6715"
        },
        "pipfile-spec": 6,
        "requires": {
            "python_version": "3.6"
        },
        "sources": [
            {
                "name": "pypi",
                "url": "https://pypi.org/simple",
                "verify_ssl": true
            }
        ]
    },
    "default": {                
         "urllib3": {
            "hashes": [
                "sha256:a68ac5e15e76e7e5dd2b8f94007233e01effe3e50e8daddf69acfd81cb686baf",
                "sha256:b5725a0bd4ba422ab0e66e89e030c806576753ea3ee08554382c14e685d117b5"
            ],
            "index": "pypi",
            "version": "==1.23"
        }
    },
    "develop": {}
}

現(xiàn)在安裝另一個(gè)包，再次查看這兩個(gè)文件的內(nèi)容。你會(huì)發(fā)現(xiàn) Pipfile 現(xiàn)在包含兩個(gè)安裝包了，Pipfile.lock 也包含了所有已安裝包的依賴(lài)包及其版本信息，以及所有安裝包及其依賴(lài)包的 Hash 校驗(yàn)信息。每次你安裝新的依賴(lài)包，這兩個(gè)文件都會(huì)自動(dòng)更新。

pipenv install urllib3==1.22

加 --dev 表示包括 Pipfile 的 dev-packages 中的依賴(lài)。

pipenv install httpie --dev

pipenv uninstall urllib3 //或者 pipenv uninstall --all

pipenv update urllib3

更新所有包：

pipenv update 

這個(gè)命令會(huì)刪除所有軟件包然后重新安裝最新的版本。

$ pipenv --venv
/Users/liyafeng/.local/share/virtualenvs/new_env-UVLdq9CB

最后的虛擬環(huán)境目錄是以當(dāng)前環(huán)境 new_env 作為目錄開(kāi)頭的。

$ pipenv --where
/Users/liyafeng/Documents/www/pythondemo/new_env

你是否擔(dān)心已安裝的軟件包有沒(méi)有安全漏洞？沒(méi)關(guān)系，pipenv 可以幫你檢查，運(yùn)行下面的命令：

$  pipenv check
Checking PEP 508 requirements…
Passed!
Checking installed package safety…
All good!

上面的命令根據(jù) Pipfile 里的 PEP 508 標(biāo)記檢查安全漏洞。

$ pipenv graph
httpie==0.9.9
  - Pygments [required: >=2.1.3, installed: 2.2.0]
  - requests [required: >=2.11.0, installed: 2.19.1]
    - certifi [required: >=2017.4.17, installed: 2018.4.16]
    - chardet [required: <3.1.0,>=3.0.2, installed: 3.0.4]
    - idna [required: <2.8,>=2.5, installed: 2.7]
    - urllib3 [required: >=1.21.1,<1.24, installed: 1.23]

更新 lock 文件鎖定當(dāng)前環(huán)境的依賴(lài)版本

pipenv lock

如果你開(kāi)發(fā)調(diào)試時(shí)需要配一堆環(huán)境變量，可以寫(xiě)到 .env 文件中，在 pipenv shell 進(jìn)入虛擬環(huán)境時(shí)，它會(huì)幫你把這些環(huán)境變量加載好，非常方便。

例如寫(xiě)一個(gè) .env 文件：

echo "FOO=hello foo" > .env

之后 pipenv shell 進(jìn)入虛擬環(huán)境，echo $FOO 就能看環(huán)境變量的值 hello foo 已經(jīng)設(shè)置好了。

https://docs.pipenv.org/

pipenv 新款 Python 虛擬環(huán)境工具詳解

pipenv 筆記

pipenv 使用指南

Pipenv – 官方推薦的 Python 包管理工具