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
Automate Python project setup and development tasks that are otherwise performed manually.
17
17
18
-
usethis knows about popular Python tools, workflows and frameworks, and knows how they
19
-
interact. It can add and remove tools, configure them, and set up the project for you
20
-
in a way that won't break your existing configuration and it will make the necessary
21
-
adjustments to your project configuration files.
18
+
`usethis` knows about popular Python tools, workflows and frameworks, and knows how they interact. It can add and remove tools, configure them, and set up the project for you in a way that won't break your existing configuration and it will make the necessary adjustments to your project configuration files.
22
19
23
-
usethis gives detailed messages about what it is doing (and what you need to do next).
20
+
`usethis` gives detailed messages about what it is doing (and what you need to do next).
24
21
25
22
- Output beginning with `✔` represents a task which usethis has automated.
26
23
- Output beginning with `☐` represents a task which you need to perform manually.
27
24
- Output beginning with `ℹ` gives hints and tips.
28
25
29
-
Inspired by an [**R** package of the same name](https://usethis.r-lib.org/index.html),
30
-
this package brings a similar experience to the Python ecosystem as a CLI tool.
26
+
Inspired by an [**R** package of the same name](https://usethis.r-lib.org/index.html), this package brings a similar experience to the Python ecosystem as a CLI tool.
31
27
32
28
## Highlights
33
29
34
-
- First-class support for state-of-the-practice tooling: `uv`, `ruff`, `pytest`, `pre-commit`, and many more.
35
-
- Automatically add and remove tools: declare, install, and configure in one step.
36
-
- Powerful knowledge of how different tools interact and sensible defaults.
37
-
- Get started on a new Python project or a new workflow in seconds.
30
+
-🧰 First-class support for state-of-the-practice tooling: `uv`, `ruff`, `pytest`, `pre-commit`, and many more.
31
+
-🤖 Automatically add and remove tools: declare, install, and configure in one step.
32
+
-🧠 Powerful knowledge of how different tools interact and sensible defaults.
33
+
-⚡ Get started on a new Python project or a new workflow in seconds.
38
34
39
-
## Getting Started
35
+
## 🧭 Getting Started
40
36
41
37
First, it is strongly recommended you [install the `uv` package manager](https://docs.astral.sh/uv/getting-started/installation/): this is a simple, documented process. If you're already using `uv`, make sure you're using at least
42
38
version v0.5.29 (run `uv version` to check, and `uv self update` to upgrade).
@@ -53,7 +49,7 @@ $ pip install usethis
53
49
54
50
Alternatively, run in isolation, using `uvx` or `pipx`.
55
51
56
-
## Command Line Interface
52
+
## 🖥️ Command Line Interface
57
53
58
54
### Main commands
59
55
@@ -73,7 +69,7 @@ Alternatively, run in isolation, using `uvx` or `pipx`.
This project is at the early stages of development. If you are interested in contributing,
242
-
please ensure you have a corresponding GitHub Issue open.
237
+
This project is at the early stages of development. If you are interested in contributing, please ensure you have a corresponding GitHub Issue open.
243
238
244
239
## License
245
240
246
241
usethis is licensed under the MIT license ([LICENSE](https://github.com/nathanjmcdougall/usethis-python/blob/main/LICENSE) or <https://opensource.org/licenses/MIT>)
247
242
248
-
Unless you explicitly state otherwise, any contribution intentionally submitted for
249
-
inclusion in usethis by you, as defined in the Apache License, Version 2.0,
250
-
(<https://www.apache.org/licenses/LICENSE-2.0>), shall be licensed under the
251
-
MIT license, without any additional terms or conditions.
243
+
Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in usethis by you, as defined in the Apache License, Version 2.0, (<https://www.apache.org/licenses/LICENSE-2.0>), shall be licensed under the MIT license, without any additional terms or conditions.
0 commit comments