|Project Name||Stars||Downloads||Repos Using This||Packages Using This||Most Recent Commit||Total Releases||Latest Release||Open Issues||License||Language|
|Ruff||17,867||842||21 hours ago||256||August 01, 2023||571||mit||Rust|
|An extremely fast Python linter, written in Rust.|
|Flake8||3,008||35,645||9,331||2 days ago||88||July 29, 2023||27||other||Python|
|flake8 is a python tool that glues together pycodestyle, pyflakes, mccabe, and third-party plugins to check the style and quality of some python code.|
|Codelyzer||2,450||121,832||15,756||a month ago||77||May 03, 2021||83||mit||TypeScript|
|Static analysis for Angular projects.|
|Pep8speaks||589||a day ago||33||mit||Python|
|A GitHub :octocat: app to automatically review Python code style over Pull Requests|
|Tryceratops||392||2||4 months ago||26||April 30, 2022||5||mit||Python|
|A linter to prevent exception handling antipatterns in Python (limited only for those who like dinosaurs).|
|Sonar Css Plugin||38||2||1||4 years ago||21||December 06, 2017||10||lgpl-3.0||Java|
|SonarQube CSS / SCSS / Less Analyzer|
|Sonar Gherkin Plugin||28||1||3 years ago||8||December 12, 2017||7||lgpl-3.0||Java|
|SonarQube Cucumber Gherkin Analyzer|
|Sonar Jproperties Plugin||8||1||4 years ago||6||November 21, 2017||6||lgpl-3.0||Java|
|SonarQube Java Properties Analyzer|
|Sonar Json Plugin||6||4 years ago||8||lgpl-3.0||Java|
|SonarQube JSON Analyzer|
|Linters||6||3 years ago||other||Elixir|
|Linters and static analysis configuration files|
An extremely fast Python linter, written in Rust.
Linting the CPython codebase from scratch.
Ruff aims to be orders of magnitude faster than alternative tools while integrating more functionality behind a single, common interface.
Ruff can be used to replace Flake8 (plus dozens of plugins), isort, pydocstyle, yesqa, eradicate, pyupgrade, and autoflake, all while executing tens or hundreds of times faster than any individual tool.
Ruff is extremely actively developed and used in major open-source projects like:
...and many more.
Ruff is so fast that sometimes I add an intentional bug in the code just to confirm it's actually running and checking the code.
Why is Ruff a gamechanger? Primarily because it is nearly 1000x faster. Literally. Not a typo. On our largest module (dagster itself, 250k LOC) pylint takes about 2.5 minutes, parallelized across 4 cores on my M1. Running ruff against our entire codebase takes .4 seconds.
Ruff is ~150-200x faster than flake8 on my machine, scanning the whole repo takes ~0.2s instead of ~20s. This is an enormous quality of life improvement for local dev. It's fast enough that I added it as an actual commit hook, which is terrific.
Just switched my first project to Ruff. Only one downside so far: it's so fast I couldn't believe it was working till I intentionally introduced some errors.
This is just ridiculously fast...
For more, see the documentation.
For more, see the documentation.
Ruff is available as
ruff on PyPI:
pip install ruff
To run Ruff, try any of the following:
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 can also be used as a pre-commit hook:
- repo: https://github.com/astral-sh/ruff-pre-commit # Ruff version. rev: v0.0.291 hooks: - id: ruff
name: Ruff on: [ push, pull_request ] jobs: ruff: runs-on: ubuntu-latest steps: - uses: actions/checkout@v3 - uses: chartboost/ruff-action@v1
If left unspecified, the default configuration is equivalent to:
[tool.ruff] # Enable pycodestyle (`E`) and Pyflakes (`F`) codes by default. select = ["E", "F"] ignore =  # Allow autofix for all enabled rules (when `--fix`) is provided. fixable = ["A", "B", "C", "D", "E", "F", "G", "I", "N", "Q", "S", "T", "W", "ANN", "ARG", "BLE", "COM", "DJ", "DTZ", "EM", "ERA", "EXE", "FBT", "ICN", "INP", "ISC", "NPY", "PD", "PGH", "PIE", "PL", "PT", "PTH", "PYI", "RET", "RSE", "RUF", "SIM", "SLF", "TCH", "TID", "TRY", "UP", "YTT"] unfixable =  # Exclude a variety of commonly ignored directories. exclude = [ ".bzr", ".direnv", ".eggs", ".git", ".git-rewrite", ".hg", ".mypy_cache", ".nox", ".pants.d", ".pytype", ".ruff_cache", ".svn", ".tox", ".venv", "__pypackages__", "_build", "buck-out", "build", "dist", "node_modules", "venv", ] # Same as Black. line-length = 88 # Allow unused variables when underscore-prefixed. dummy-variable-rgx = "^(_+|(_+[a-zA-Z0-9_]*[a-zA-Z0-9]+?))$" # Assume Python 3.8 target-version = "py38" [tool.ruff.mccabe] # Unlike Flake8, default to a complexity level of 10. max-complexity = 10
Some configuration options can be provided via the command-line, such as those related to rule enablement and disablement, file discovery, logging level, and more:
ruff check path/to/code/ --select F401 --select F403 --quiet
ruff help for more on Ruff's top-level commands, or
ruff help check for more on the
Ruff supports over 700 lint rules, many of which are inspired by popular tools like Flake8, isort, pyupgrade, and others. Regardless of the rule's origin, Ruff re-implements every rule in Rust as a first-party feature.
By default, Ruff enables Flake8's
F rules. Ruff supports all rules from the
and a subset of the
E category, omitting those
stylistic rules made obsolete by the use of an autoformatter, like
If you're just getting started with Ruff, the default rule set is a great place to start: it catches a wide variety of common errors (like unused imports) with zero configuration.
Beyond the defaults, Ruff re-implements some of the most popular Flake8 plugins and related code quality tools, including:
For a complete enumeration of the supported rules, see Rules.
Contributions are welcome and highly appreciated. To get started, check out the contributing guidelines.
You can also join us on Discord.
You can also ask for help on Discord.
In some cases, Ruff includes a "direct" Rust port of the corresponding tool. We're grateful to the maintainers of these tools for their work, and for all the value they've provided to the Python community.
Ruff's import resolver is based on the import resolution algorithm from Pyright.
Ruff is the beneficiary of a large number of contributors.
Ruff is released under the MIT license.
Ruff is used by a number of major open-source projects and companies, including:
If you're using Ruff, consider adding the Ruff badge to project's
.. image:: https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/ruff/main/assets/badge/v2.json :target: https://github.com/astral-sh/ruff :alt: Ruff
...or, as HTML:
<a href="https://github.com/astral-sh/ruff"><img src="https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/ruff/main/assets/badge/v2.json" alt="Ruff" style="max-width:100%;"></a>