Addition of Poetry to "Using virtualenvs..." section
まだ誰も着手していません。
評価
- 難易度
- 4/5
- 見積もり時間
- 3〜5日
- 初心者へのやさしさ
- 38/100
- issue の種類
- ドキュメント
- 明瞭さ
- おおむね明確
- 活発さ
- 停滞
- 技術スタック
- python
調査の方向性
この依頼はガイドの「Using virtualenvs...」セクションを対象としており、Poetryへのリンクがあります。まずこのセクションと、その周辺にある依存関係管理の説明を読んでください。対象範囲と互換性に関する注意点を明確にしたうえで、Poetryとその制限事項についての扱いが明示的になるようガイドを更新してください。
索引モデルが issue の本文から書いたものです。
説明
Hi there, thank you for all the work put into this guide so far!
Are there any discussions or plans to mention Poetry anywhere in this guide (I couldn't find any previous issues on this)?
Rationale
I think poetry solves a huge missing piece in the Python ecosystem. For any node.js developers, it is similar to npm and yarn. For many newcomers to the language, the way python does dependency management and virtual environments has a very high learning curve.
Poetry introduces (over traditional pip based package management):
- A unified project manifest
pyproject.tomlcontaining dependencies and build information - Introduces a
poetry.lockfile that pins dependency versions (a better alternative thanpip freezeIMO) - Avoids installing dependencies globally (poetry automatically creates a virtualenv and installs project dependencies there)
- Using
poetry runexecutes commands automatically in the proper virtualenv context (no more needing tosource venv/bin/activate)
And plenty more that I'm sure I am not listing here...
Limitations
As with any new technology, there are some limitations:
- Poetry is dropping support for Python 2.7 and 3.5 in the next release
- Lots of older tutorials and resources probably do not use it, which could confuse beginners even more
Thoughts on this? Would be happy to help contribute wherever I can.
- 主要言語
- Batchfile
- スター
- 29.8k
- フォーク
- 5.9k
- PR マージ指標
- 30日以内にマージされた PR はありません
コントリビューションガイド
はじめの一歩
- issue を最後まで読み、次にプロジェクトのコントリビューションガイドを読みます。
- 着手することを issue にコメントします — 二人が同じ作業をするのを防げます。
- リポジトリをフォークし、ブランチを切って変更します。
- issue 番号を参照したプルリクエストを送ります。
realpython/python-guide のほかの issue
-
Page 404 error オープン
難易度 1/5 1時間未満 初心者へのやさしさ 65/100
realpython/python-guide#1104 · コメント 2 件 ·
-
難易度 1/5 1〜3時間 初心者へのやさしさ 62/100
realpython/python-guide#327 ·
-
PyZMQ improvements オープン
難易度 2/5 1〜3時間 初心者へのやさしさ 62/100
realpython/python-guide#326 · コメント 5 件 ·
-
@alex オープン
難易度 5/5 1週間以上 初心者へのやさしさ 10/100
realpython/python-guide#1194 ·
-
Development Team SAP オープン
難易度 5/5 1週間以上 初心者へのやさしさ 10/100
realpython/python-guide#1192 ·
realpython/python-guide の issue をすべて見る
似ている issue
-
Link Checker Report オープンautomated issue report
難易度 2/5 1〜3時間 初心者へのやさしさ 78/100
felladrin/uo-is-not-dead#176 · コメント 1 件 ·
-
documentation
難易度 1/5 1時間未満 初心者へのやさしさ 78/100
Qiskit/qiskit-addon-sqd#376 ·
-
難易度 2/5 1〜3時間 初心者へのやさしさ 75/100
Seeed-Studio/wiki-documents#5655 · コメント 2 件 ·
-
難易度 2/5 1〜3時間 初心者へのやさしさ 82/100
-
難易度 2/5 1〜3時間 初心者へのやさしさ 70/100
MystenLabs/sui#28056 · コメント 1 件 ·