realpython / realpython/python-guide

Clarification on pipenv and virtualenv

未關閉
#981 3 則留言 0 個 reaction 已指派 0 人 在 GitHub 檢視

還沒有人認領這個 Issue。

主要語言
Batchfile
星號
29.8k
分支
5.9k
PR 合併指標
30 天內沒有已合併 PR

描述

In the Virtual Environments document (dev/virtualenvs/) we start off by learning about pipenv but then move on to the lower level virtualenv. It is a little unclear under what circumstances we would be using virtualenv? I mean, I know it can practically be used, but for folks approaching Python for the first time it can be confusing.

I'm not suggesting the virtualenv section should go away, but maybe some additional clarification would be helpful. Something along the lines of:

"pipenv wraps a lower-level virtual environment utility - virtualenv. If you want to learn about using virtualenv, read on. Otherwise you can skip to the next chapter."

Where I personally really started getting confused is under Other Notes. Without scrolling back up the page it is not clear if this section is a part of the virtualenv discussion or if it is meant to be top-level and thus applicable to both pipenv and virtualenv.

Things become murkier when we start throwing additional utilities into the mix - as someone without experience with these utilities it seems to me that together they run somewhat parallel to pipenv.

Thanks for your hard work on this guide!

貢獻指南

開啟貢獻指南

從這裡開始

  1. 先讀完整個 Issue,再讀專案的貢獻指南。
  2. 在 Issue 下留言說明你要接手 —— 這能避免兩個人做同樣的事。
  3. Fork 儲存庫,在一個分支上完成修改。
  4. 送出 Pull Request,並在描述裡引用這個 Issue 編號。

研究方向

從 dev/virtualenvs/ 中的 Virtual Environments 文件開始,並一起閱讀 pipenv、virtualenv 和 Other Notes 區段。釐清 pipenv 與 virtualenv 的關係,指出讀者何時可以略過 virtualenv 的相關內容,並清楚說明哪些備註適用於各個工具;當第一次接觸 Python 的讀者能夠不感到困惑地讀懂此區段時,即表示完成。

由索引模型根據 Issue 內容生成。

評估

技術堆疊
python
領域
documentation
Issue 類型
文件
難度
2/5
預估耗時
1-3 小時
活躍度
停滯
描述清晰度
基本清楚
新手友好度
35/100

把新 issue 寄到你的電子郵件信箱

精選適合新手參與的 GitHub issue 摘要。