You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardexpand all lines: why-poetry.qmd
+6-6
Original file line number
Diff line number
Diff line change
@@ -15,7 +15,7 @@ Managing the packages we depend on (e.g. Django) in Python isn't "simply" instal
15
15
16
16
The solution to this problem is by using "virtual environments" in Python. These are environments that are separate from the rest of the system and can install any packages without impacting other environments.
17
17
18
-
The problem is that there multiple ways of creating these virtual environments and managing package dependencies.
18
+
There multiple ways of creating these virtual environments and managing package dependencies, and the optional solution depends on the project.
19
19
20
20
## Decision Drivers
21
21
@@ -24,7 +24,7 @@ The problem is that there multiple ways of creating these virtual environments a
24
24
25
25
## Considered Options
26
26
27
-
There are (unfortunately) multiple tools to manage package dependencies in Python, for example, listed [here](https://packaging.python.org/en/latest/tutorials/managing-dependencies/#other-tools-for-application-dependency-management) and [here](https://python.libhunt.com/poetry-alternatives). There are also comparison sites like [this](https://ritza.co/articles/gen-articles/pipenv-vs-virtualenv-vs-poetry-vs-pyenv-vs-pip/), [this](https://www.warp.dev/blog/prose-about-poetry), [this](https://dev.to/adamghill/python-package-manager-comparison-1g98), and [this](https://dev.to/frostming/a-review-pipenv-vs-poetry-vs-pdm-39b4) that go into more detail about many of these tools, as well as some descriptive statistics of the popularities of each [here](https://python.libhunt.com/poetry-alternatives).
27
+
There are (unfortunately) multiple tools to manage package dependencies in Python, for example, listed at [Python Packaging User Guide](https://packaging.python.org/en/latest/tutorials/managing-dependencies/#other-tools-for-application-dependency-management) and at [Awesome Python](https://python.libhunt.com/poetry-alternatives). There are also comparison sites like [Ritza Articles](https://ritza.co/articles/gen-articles/pipenv-vs-virtualenv-vs-poetry-vs-pyenv-vs-pip/), [warp](https://www.warp.dev/blog/prose-about-poetry), and [this](https://dev.to/adamghill/python-package-manager-comparison-1g98), and [this](https://dev.to/frostming/a-review-pipenv-vs-poetry-vs-pdm-39b4)at [dev.to](https://dev.to/)that go into more detail about many of these tools.
28
28
29
29
We'll only cover:
30
30
@@ -35,7 +35,7 @@ We'll only cover:
35
35
36
36
### Pipenv
37
37
38
-
Was designed to combine the functionality of `pip` and `virtualenv`.
38
+
[Pipenv](https://pipenv.pypa.io/en/latest/index.html) was designed to combine the functionality of `pip` and `virtualenv`.
39
39
40
40
-**Pros**:
41
41
- Fairly popular
@@ -89,9 +89,9 @@ Was designed to combine the functionality of `pip` and `virtualenv`.
89
89
90
90
## Decision Outcome
91
91
92
-
We decided on Poetry because it has amazing documentation, is welldesigned, and is very popular and widely used.
92
+
We decided on Poetry because it has amazing documentation, is well-designed, and is very popular and widely used.
93
93
94
94
### Consequences
95
95
96
-
- Because it isn't fully PEP compliant, we might encounter some issues
97
-
- Doesn't have the "official" support that Hatch has, so we might reconsider the decision to use Poetry at a future date
96
+
- Because Poetry isn't fully PEP compliant, we might encounter some issues
97
+
- Doesn't have the "official" support (maintenance by PyPA) that Hatch has, so we might reconsider the decision to use Poetry at a future date
0 commit comments