mirror of
https://github.com/astral-sh/ruff.git
synced 2025-09-26 20:09:22 +00:00
py-fuzzer: recommend using uvx
rather than uv run
to run the fuzzer (#14645)
This commit is contained in:
parent
6d61c8aa16
commit
f1b2e85339
5 changed files with 10 additions and 12 deletions
|
@ -3,6 +3,6 @@
|
|||
A fuzzer script to run Ruff executables on randomly generated
|
||||
(but syntactically valid) Python source-code files.
|
||||
|
||||
Run `uv run --no-project --with ./python/py-fuzzer fuzz -h` from the repository root
|
||||
Run `uvx --from ./python/py-fuzzer fuzz -h` from the repository root
|
||||
for more information and example invocations
|
||||
(requires [`uv`](https://github.com/astral-sh/uv) to be installed).
|
||||
|
|
|
@ -4,19 +4,19 @@ Python source-code files.
|
|||
|
||||
This script can be installed into a virtual environment using
|
||||
`uv pip install -e ./python/py-fuzzer` from the Ruff repository root,
|
||||
or can be run using `uv run --no-project --with ./python/py-fuzzer`
|
||||
or can be run using `uvx --from ./python/py-fuzzer fuzz`
|
||||
(in which case the virtual environment does not need to be activated).
|
||||
|
||||
Example invocations of the script using `uv`:
|
||||
- Run the fuzzer on Ruff's parser using seeds 0, 1, 2, 78 and 93 to generate the code:
|
||||
`uv run --no-project --with ./python/py-fuzzer fuzz --bin ruff 0-2 78 93`
|
||||
`uvx --from ./python/py-fuzzer fuzz --bin ruff 0-2 78 93`
|
||||
- Run the fuzzer concurrently using seeds in range 0-10 inclusive,
|
||||
but only reporting bugs that are new on your branch:
|
||||
`uv run --no-project --with ./python/py-fuzzer fuzz --bin ruff 0-10 --new-bugs-only`
|
||||
`uvx --from ./python/py-fuzzer fuzz --bin ruff 0-10 --new-bugs-only`
|
||||
- Run the fuzzer concurrently on 10,000 different Python source-code files,
|
||||
using a random selection of seeds, and only print a summary at the end
|
||||
(the `shuf` command is Unix-specific):
|
||||
`uv run --no-project --with ./python/py-fuzzer fuzz --bin ruff $(shuf -i 0-1000000 -n 10000) --quiet
|
||||
`uvx --from ./python/py-fuzzer fuzz --bin ruff $(shuf -i 0-1000000 -n 10000) --quiet
|
||||
"""
|
||||
|
||||
from __future__ import annotations
|
||||
|
|
Loading…
Add table
Add a link
Reference in a new issue