Use uv

Author: charliermarsh

README.md

@@ -118,30 +118,30 @@ For more, see the [documentation](https://docs.astral.sh/ruff/).
 
 Ruff is available as [`ruff`](https://pypi.org/project/ruff/) on PyPI:
 
-```shell
-# With uv.
-uv add --dev ruff     # to add ruff to your project
-uv tool install ruff  # to install ruff globally
+```console
+$ # With uv.
+$ uv tool install ruff  # Install Ruff globally.
+$ uv add --dev ruff     # Or add Ruff to your project.
 
-# With pip.
-pip install ruff
+$ # With pip.
+$ pip install ruff
 
-# With pipx.
-pipx install ruff
+$ # With pipx.
+$ pipx install ruff
 ```
 
 Starting with version `0.5.0`, Ruff can be installed with our standalone installers:
 
-```shell
-# On macOS and Linux.
-curl -LsSf https://astral.sh/ruff/install.sh | sh
+```console
+$ # On macOS and Linux.
+$ curl -LsSf https://astral.sh/ruff/install.sh | sh
 
-# On Windows.
-powershell -c "irm https://astral.sh/ruff/install.ps1 | iex"
+$ # On Windows.
+$ powershell -c "irm https://astral.sh/ruff/install.ps1 | iex"
 
-# For a specific version.
-curl -LsSf https://astral.sh/ruff/0.8.6/install.sh | sh
-powershell -c "irm https://astral.sh/ruff/0.8.6/install.ps1 | iex"
+$ # For a specific version.
+$ curl -LsSf https://astral.sh/ruff/0.8.6/install.sh | sh
+$ powershell -c "irm https://astral.sh/ruff/0.8.6/install.ps1 | iex"
 ```
 
 You can also install Ruff via [Homebrew](https://formulae.brew.sh/formula/ruff), [Conda](https://anaconda.org/conda-forge/ruff),
@@ -151,22 +151,22 @@ and with [a variety of other package managers](https://docs.astral.sh/ruff/insta
 
 To run Ruff as a linter, try any of the following:
 
-```shell
-ruff check                          # Lint all files in the current directory (and any subdirectories).
-ruff check path/to/code/            # Lint all files in `/path/to/code` (and any subdirectories).
-ruff check path/to/code/*.py        # Lint all `.py` files in `/path/to/code`.
-ruff check path/to/code/to/file.py  # Lint `file.py`.
-ruff check @arguments.txt           # Lint using an input file, treating its contents as newline-delimited command-line arguments.
+```console
+$ ruff check                          # Lint all files in the current directory (and any subdirectories).
+$ ruff check path/to/code/            # Lint all files in `/path/to/code` (and any subdirectories).
+$ ruff check path/to/code/*.py        # Lint all `.py` files in `/path/to/code`.
+$ ruff check path/to/code/to/file.py  # Lint `file.py`.
+$ ruff check @arguments.txt           # Lint using an input file, treating its contents as newline-delimited command-line arguments.
 ```
 
 Or, to run Ruff as a formatter:
 
-```shell
-ruff format                          # Format all files in the current directory (and any subdirectories).
-ruff format path/to/code/            # Format all files in `/path/to/code` (and any subdirectories).
-ruff format path/to/code/*.py        # Format all `.py` files in `/path/to/code`.
-ruff format path/to/code/to/file.py  # Format `file.py`.
-ruff format @arguments.txt           # Format using an input file, treating its contents as newline-delimited command-line arguments.
+```console
+$ ruff format                          # Format all files in the current directory (and any subdirectories).
+$ ruff format path/to/code/            # Format all files in `/path/to/code` (and any subdirectories).
+$ ruff format path/to/code/*.py        # Format all `.py` files in `/path/to/code`.
+$ ruff format path/to/code/to/file.py  # Format `file.py`.
+$ ruff format @arguments.txt           # Format using an input file, treating its contents as newline-delimited command-line arguments.
 ```
 
 Ruff can also be used as a [pre-commit](https://pre-commit.com/) hook via [`ruff-pre-commit`](https://github.com/astral-sh/ruff-pre-commit):
@@ -277,14 +277,14 @@ example, `[lint]` should be replaced with `[tool.ruff.lint]`.
 Some configuration options can be provided via dedicated command-line arguments, such as those
 related to rule enablement and disablement, file discovery, and logging level:
 
-```shell
-ruff check --select F401 --select F403 --quiet
+```console
+$ ruff check --select F401 --select F403 --quiet
 ```
 
 The remaining configuration options can be provided through a catch-all `--config` argument:
 
-```shell
-ruff check --config "lint.per-file-ignores = {'some_file.py' = ['F841']}"
+```console
+$ ruff check --config "lint.per-file-ignores = {'some_file.py' = ['F841']}"
 ```
 
 To opt in to the latest lint rules, formatter style changes, interface updates, and more, enable

docs/faq.md

@@ -220,15 +220,18 @@ Ruff is installable under any Python version from 3.7 onwards.
 
 ## Do I need to install Rust to use Ruff?
 
-Nope! Ruff is available as [`ruff`](https://pypi.org/project/ruff/) on PyPI:
+Nope! Ruff is available as [`ruff`](https://pypi.org/project/ruff/) on PyPI. We recommend installing Ruff with [uv](https://docs.astral.sh/uv/):
 
 ```console
-# With uv.
-$ uv add --dev ruff     # to add ruff to your project
-$ uv tool install ruff  # to install ruff globally
+$ # With uv.
+$ uv tool install ruff  # Install Ruff globally.
+$ uv add --dev ruff     # Or add Ruff to your project.
 
-# With pip
+$ # With pip.
 $ pip install ruff
+
+$ # With pipx.
+$ pipx install ruff
 ```
 
 Ruff ships with wheels for all major platforms, which enables `pip` to install Ruff without relying

docs/installation.md

@@ -1,9 +1,16 @@
 # Installing Ruff
 
-Ruff is available as [`ruff`](https://pypi.org/project/ruff/) on PyPI:
+Ruff is available as [`ruff`](https://pypi.org/project/ruff/) on PyPI. We recommend installing Ruff with [uv](https://docs.astral.sh/uv/):
 
 ```console
+$ # With uv.
+$ uv tool install ruff
+
+$ # With pip.
 $ pip install ruff
+
+$ # With pipx.
+$ pipx install ruff
 ```
 
 Once installed, you can run Ruff from the command line:
@@ -13,7 +20,7 @@ $ ruff check   # Lint all files in the current directory.
 $ ruff format  # Format all files in the current directory.
 ```
 
-Starting with version `0.5.0`, Ruff can be installed with our standalone installers:
+Starting with version `0.5.0`, Ruff can also be installed with our standalone installers:
 
 ```console
 $ # On macOS and Linux.

docs/tutorial.md

@@ -5,10 +5,18 @@ your project. For a more detailed overview, see [_Configuring Ruff_](configurati
 
 ## Getting Started
 
-To start, we'll install Ruff through PyPI (or with your [preferred package manager](installation.md)):
+To start, we'll install Ruff from PyPI. You can install Ruff with [uv](https://docs.astral.sh/uv/), or
+your [preferred package manager](installation.md):
 
 ```console
+$ # With uv.
+$ uv tool install ruff
+
+$ # With pip.
 $ pip install ruff
+
+$ # With pipx.
+$ pipx install ruff
 ```
 
 Let's then assume that our project structure looks like:

python/ruff-ecosystem/README.md

@@ -4,10 +4,10 @@ Compare lint and format results for two different ruff versions (e.g. main and a
 
 ## Installation
 
-From the Ruff project root, install with `pip`:
+From the Ruff project root, install with [uv](https://docs.astral.sh/uv/):
 
 ```shell
-pip install -e ./python/ruff-ecosystem
+uv tool install -e ./python/ruff-ecosystem
 ```
 
 ## Usage