Skip to content

Commit 36c35f8

Browse files
committed
docs: Add comparison with Poe the Poet
Issue-36: #36
1 parent 04ebe22 commit 36c35f8

File tree

1 file changed

+18
-0
lines changed

1 file changed

+18
-0
lines changed

docs/index.md

Lines changed: 18 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -74,3 +74,21 @@ when you have complex things to run.
7474

7575
Also Task is written in Go so you won't be able to specify
7676
it in your Python dev-dependencies.
77+
78+
### [Poe the Poet](https://github.com/nat-n/poethepoet)
79+
80+
Poe the Poet, or `poe`, lets you declare tasks in pyproject.toml.
81+
The comparison is similar to [Task's](#task): declarative language only gets you so far.
82+
duty is fully based on Python, and provides you with batteries to control
83+
the output, the exit code, etc. While Poe the Poet lets you call Python functions,
84+
the user would have to re-implement these batteries themselves.
85+
86+
Poe the Poet and duty can be used together though, with Poe tasks calling duty.
87+
But that feels like an additional complexity layer for the single benefit
88+
of declaring your task directly in pyproject.toml.
89+
90+
```toml
91+
[tool.poe.tasks]
92+
test = "duty test"
93+
docs = "duty docs"
94+
```

0 commit comments

Comments
 (0)