ruff-odoo

ruff-odoo is Vauxoo's fork of Ruff, shipping every upstream linter and formatter rule plus the OD and OAPP rule groups, ported from pylint-odoo and odoo-pre-commit-hooks.

The Odoo rules, how to enable them, and how to migrate from pylint-odoo: https://vauxoo.github.io/ruff-odoo/
Everything else — configuration, the formatter, editor integrations, the upstream rules — behaves exactly as upstream and is documented at https://docs.astral.sh/ruff/.

This file covers what differs from upstream Ruff for anyone installing or building the fork: the command name, the packaging, and the version scheme.

The `ruff-odoo` command

The published command is ruff-odoo, not ruff. It is the exact same CLI, only under a name that cannot collide with an upstream ruff installation, so both can live in the same environment:

$ ruff-odoo check   # Lint all files in the current directory.
$ ruff-odoo format  # Format all files in the current directory.

The Python module is ruff_odoo, so the CLI is also reachable without the console script:

$ python -m ruff_odoo check

Installation

The package is published to PyPI as ruff-odoo. It is not distributed through Homebrew, conda, Docker, or the standalone astral.sh installers — those channels ship upstream Ruff only.

$ # Run it without installing.
$ uvx ruff-odoo check

$ # Install it globally.
$ uv tool install ruff-odoo@latest

$ # Or add it to your project.
$ uv add --dev ruff-odoo

$ # With pip.
$ pip install ruff-odoo

Installing ruff-odoo alongside the upstream ruff package is supported, even in the same environment: ruff-odoo owns the ruff-odoo entry point and never touches ruff.

pre-commit

Use the mirror repository, which installs the prebuilt wheels:

repos:
  - repo: https://github.com/vauxoo/ruff-pre-commit
    # Use the latest release tag; see the version scheme below.
    rev: 0.16.3.21
    hooks:
      - id: ruff-check
      - id: ruff-format

The hook ids match astral-sh/ruff-pre-commit, so switching between upstream and this fork means changing only repo and rev.

This repository also defines the hooks directly (see .pre-commit-hooks.yaml), but pointing repo at it builds Ruff from source with maturin on every environment creation, which is slow and requires a Rust toolchain. Prefer the mirror.

Version scheme

Fork releases use four components, x.y.z.w:

x.y.z is the upstream Ruff release this fork is based on (for example 0.16.2).
w counts the fork's own releases, independently of that upstream base.

So 0.16.2.4 is the fourth Vauxoo release, built on upstream Ruff 0.16.2. When the fork is synced onto a newer upstream, x.y.z follows it and w carries over untouched: syncing 0.16.2.4 onto upstream 0.16.3 gives 0.16.3.4, and the next release is 0.16.3.5. The counter never restarts, so a fork version is never reused and never goes backwards.

The version lives in [project] version of the root pyproject.toml and is bumped by bump2version (see .bumpversion.cfg), which also creates the release tag. Tags are the bare version with no prefix (0.16.2.4, not v0.16.2.4); pushing one triggers the PyPI release workflow. Because every fork tag has four components, it can never be confused with one of upstream's three-component tags.

Cargo cannot express a four-component version, so crates/ruff_odoo/Cargo.toml keeps the three-component x.y.z and crates/ruff/build.rs reads the real version out of pyproject.toml at build time, exposing it as RUFF_ODOO_VERSION. A build made outside a checkout of this repository falls back to the Cargo version.

Reporting the version

--version prints the bare version and nothing else:

$ ruff-odoo --version
ruff-odoo 0.16.3.21

It stays bare on purpose: tools that shell out to the binary (ruff-lsp, for one) parse that output as a PEP 440 version and fail on anything appended to it.

The version subcommand is the verbose one. It adds the number of commits since the release tag and the commit the binary was built from:

$ ruff-odoo version
ruff-odoo 0.16.3.21+3 (b45cfcb38 2026-08-15)

The leading name is the binary that was actually invoked, so a locally built ruff dev binary introduces itself as ruff. A release build sitting exactly on its tag has no +N suffix.

For machine-readable output, ask for JSON:

$ ruff-odoo version --output-format json
{
  "version": "0.16.3.21",
  "commit_info": {
    "short_commit_hash": "b45cfcb38",
    "commit_hash": "b45cfcb38d111d9f446b195125290a19e4cf8a4e",
    "commit_date": "2026-08-15",
    "last_tag": "0.16.3.21",
    "commits_since_last_tag": 3
  }
}

Building from source

The ruff-odoo binary is a thin wrapper crate (crates/ruff_odoo) around the untouched upstream ruff crate; the only differences are the displayed command name and the error prefix. Keeping the ruff crate and its binary unmodified is what keeps rebases onto upstream cheap.

Both binaries build from this checkout, and either one is fine for development:

cargo run --bin ruff-odoo -- check path/to/file.py
cargo run --bin ruff -- check path/to/file.py

See AGENTS.md for the full development workflow, and CONTRIBUTING.md for upstream's.

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

ruff_odoo-0.16.3.21.tar.gz (5.0 MB view details)

Uploaded Aug 17, 2026 Source

Built Distributions

If you're not sure about the file name format, learn more about wheel file names.

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

ruff_odoo-0.16.3.21-py3-none-win_arm64.whl (11.6 MB view details)

Uploaded Aug 17, 2026 Python 3Windows ARM64

ruff_odoo-0.16.3.21-py3-none-win_amd64.whl (11.6 MB view details)

Uploaded Aug 17, 2026 Python 3Windows x86-64

ruff_odoo-0.16.3.21-py3-none-win32.whl (11.2 MB view details)

Uploaded Aug 17, 2026 Python 3Windows x86

ruff_odoo-0.16.3.21-py3-none-musllinux_1_2_x86_64.whl (11.9 MB view details)

Uploaded Aug 17, 2026 Python 3musllinux: musl 1.2+ x86-64

ruff_odoo-0.16.3.21-py3-none-musllinux_1_2_i686.whl (11.4 MB view details)

Uploaded Aug 17, 2026 Python 3musllinux: musl 1.2+ i686

ruff_odoo-0.16.3.21-py3-none-musllinux_1_2_armv7l.whl (10.9 MB view details)

Uploaded Aug 17, 2026 Python 3musllinux: musl 1.2+ ARMv7l

ruff_odoo-0.16.3.21-py3-none-musllinux_1_2_aarch64.whl (11.2 MB view details)

Uploaded Aug 17, 2026 Python 3musllinux: musl 1.2+ ARM64

ruff_odoo-0.16.3.21-py3-none-manylinux_2_31_riscv64.whl (11.8 MB view details)

Uploaded Aug 17, 2026 Python 3manylinux: glibc 2.31+ riscv64

ruff_odoo-0.16.3.21-py3-none-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (11.3 MB view details)

Uploaded Aug 17, 2026 Python 3manylinux: glibc 2.17+ x86-64

ruff_odoo-0.16.3.21-py3-none-manylinux_2_17_s390x.manylinux2014_s390x.whl (11.9 MB view details)

Uploaded Aug 17, 2026 Python 3manylinux: glibc 2.17+ s390x

ruff_odoo-0.16.3.21-py3-none-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl (12.6 MB view details)

Uploaded Aug 17, 2026 Python 3manylinux: glibc 2.17+ ppc64le

ruff_odoo-0.16.3.21-py3-none-manylinux_2_17_i686.manylinux2014_i686.whl (11.7 MB view details)

Uploaded Aug 17, 2026 Python 3manylinux: glibc 2.17+ i686

ruff_odoo-0.16.3.21-py3-none-manylinux_2_17_armv7l.manylinux2014_armv7l.whl (10.9 MB view details)

Uploaded Aug 17, 2026 Python 3manylinux: glibc 2.17+ ARMv7l

ruff_odoo-0.16.3.21-py3-none-manylinux_2_17_aarch64.manylinux2014_aarch64.whl (10.9 MB view details)

Uploaded Aug 17, 2026 Python 3manylinux: glibc 2.17+ ARM64

ruff_odoo-0.16.3.21-py3-none-macosx_11_0_arm64.whl (10.6 MB view details)

Uploaded Aug 17, 2026 Python 3macOS 11.0+ ARM64

ruff_odoo-0.16.3.21-py3-none-macosx_10_12_x86_64.whl (11.4 MB view details)

Uploaded Aug 17, 2026 Python 3macOS 10.12+ x86-64

ruff_odoo-0.16.3.21-py3-none-linux_armv6l.whl (11.1 MB view details)

Uploaded Aug 17, 2026 Python 3

File details

Details for the file ruff_odoo-0.16.3.21.tar.gz.

File metadata

Download URL: ruff_odoo-0.16.3.21.tar.gz
Upload date: Aug 17, 2026
Size: 5.0 MB
Tags: Source
Uploaded using Trusted Publishing? Yes
Uploaded via: uv/0.12.3 {"installer":{"name":"uv","version":"0.12.3","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

File hashes

Hashes for ruff_odoo-0.16.3.21.tar.gz
Algorithm	Hash digest
SHA256	`aaf0e30284171638921a5d3c433f40b4f71fdb34b73fcd217b47adff1aff369c`
MD5	`3f0d1d5725ebf02f46d44b0fd8cd47c0`
BLAKE2b-256	`4be0032ea66a77a1fba1c44a1aff3f05345a55e84d0286afb6add9cc68d25437`

Algorithm	Hash digest
SHA256	`9a785c95726b375b80c2bd50b57c4c4ddb2d734d1cfa386c415c924251f4a762`
MD5	`c9ffc4a8235bbc26f75a30b8d6882907`
BLAKE2b-256	`feac844557e30b84e4c8574ac0573f11d612e55b65b87d770f7c180b4fe72449`

Algorithm	Hash digest
SHA256	`a6b768da3c5ca3c85628a18720cff9c026db94335ac7b25285ed46de76630a4e`
MD5	`0b786caf0e582b52c81796b4e48f26fe`
BLAKE2b-256	`7a8cd424d854f07255a914681c039fd398b798fe9972cf78a3ef5b35e6d4f585`

Algorithm	Hash digest
SHA256	`7cb3c1031eaa8d0e320767e1f2d9bfc11dc034a6a3dd830caff6f4b07e06fe3a`
MD5	`6a6ac1badf0ddd589ce1ec4e5f47e1ac`
BLAKE2b-256	`957136669c7b8aee44abcebd333984d18c86cb8f61ec0629e9fde1e8e7b1bd4f`

Algorithm	Hash digest
SHA256	`85fb8f7627febc9e4ebacbde797ace128ce44b5b1f3f10996b6b78edf2846c9b`
MD5	`9d41a79969b827fc3d5b9d5667bc1c51`
BLAKE2b-256	`1a95ec66baf2f9dfcf37e60f97a012876f4780b3b3ff85d31f4bb3bfd54cf16b`

Algorithm	Hash digest
SHA256	`96cadfae9ff5ee2e3cbc1505cbe35f6cd9b65303166d2a3418fc49e591b445dd`
MD5	`5b30bd49752849ef2525f8df96d7ec40`
BLAKE2b-256	`67b717b38e6313128f881390034a0d0772f53eb57bd7df3e00bcdac9a2133108`

Algorithm	Hash digest
SHA256	`333c3e0cb4b09e673b0ffd29bfd1c7c48889425eab59b48b0e7cb7efd5e68369`
MD5	`e97ae569b8541b6b79273f142047e346`
BLAKE2b-256	`012b260ce08e47eb58b55887f9e08cb7f2b992a3b1914ed377892dc1fc46f2e5`

Algorithm	Hash digest
SHA256	`ac269f7291f4120309a6a587f596025408cca3fde8a431a10009b21b59a83149`
MD5	`d9679ab351b09a0fc5441a7361507277`
BLAKE2b-256	`d74a9b4ef98290e09a373c0f300696fc9b52a7e1ec3bc89de918dc856a98a46b`

Algorithm	Hash digest
SHA256	`e10ec5b2d86389281332e3b9c37644ab27536b34425b9296068cf47d1093186e`
MD5	`694c06a1e6d866eefcef5ff9e3e15251`
BLAKE2b-256	`395bc7c2ba38e97d290572ba8a18859d75261b72f5964eb45f49d87cd8ae5389`

Algorithm	Hash digest
SHA256	`ddfdf4297a6b9e21dc897f52f1d69b770ec5505a732deb2954b5ed31026f9d1b`
MD5	`3217b1b3b4afc1730ebb2187882eeef9`
BLAKE2b-256	`2a0c6eca0d56851c384e528fd2d7776ea442e83089dfd4ae7e74c851b730cdf2`

Algorithm	Hash digest
SHA256	`dfdca83559d97c24aba8f2d6e454b3bc06e4099977d4b4820d70cc518a7e0155`
MD5	`2787554a4045649d5a66e356a494da59`
BLAKE2b-256	`80d3ee151a2a640d8bac1e6a2acbdacec76aed49aacec885510e83e04d3f9439`

Algorithm	Hash digest
SHA256	`f20a976bb3f3072acc6bbd15034d2423d2260301b49a0df04983683daa0cabe8`
MD5	`79d8ec99888bc4b3ddb63c54d88a55d2`
BLAKE2b-256	`6c273d3fdc01831f1b72e0345099b9e268b2cffc94550bd588c7e37fbb6bc5d0`

Algorithm	Hash digest
SHA256	`99f48f255f5aa130daedb7a0280c9f14aa1399493acf13949b6fb3e97152df28`
MD5	`b9aecc8c8de5b6c74d4668314f8af3a2`
BLAKE2b-256	`9819db8f9325e964a9285a4edafcd50ebc39444f9468a9d0ac8857c255cb1bfd`

Algorithm	Hash digest
SHA256	`a49b234c5d12101550e47f0604800a8352fdc909e1c4cc92a605077f06e30f36`
MD5	`9fd30d6689deb3452736ce6d424af635`
BLAKE2b-256	`f3d7da739d7e9c784ead33ff821b2dcbbd4e9a3cad7d1788d278b77ecfee30fd`

Algorithm	Hash digest
SHA256	`eb5cacbdaa8b0d57dce768f88bf64babf6701c6aaee14cbda4e633ccfc82f8e4`
MD5	`26b3a5ae63f1a7144dabfcaf2bae2a4b`
BLAKE2b-256	`4ee11e6039f18f78823bc35725403f7c7906aae9a7e4746230d8b4faceae69bc`

Algorithm	Hash digest
SHA256	`9836c2e6452e4888b985d810aaebdb5b7b330beef347f4b3957b356617b1d1fb`
MD5	`1885e1b01b5596b8f177cd4c10d3e280`
BLAKE2b-256	`f0cf04e90aaaaad9b90eaca284e3d08e99e32acfeda380b882bead05e6aadde6`

Algorithm	Hash digest
SHA256	`bc30641ec85ac9b66c3b69ed62f30227bf6e4a893ddd1d441c8d3941574ed673`
MD5	`1376b503d6673965deaa7128dc336937`
BLAKE2b-256	`5b5121f3f510396a71f1e905862f08ca2f1eab39dcb4798f71d0a86823992735`

Algorithm	Hash digest
SHA256	`1c5e06c7920747aa6ab9522decf7f6dab488731469121257cd505e92b2be5fde`
MD5	`c9e6a39a3a95a47d56b6d3739732d4d9`
BLAKE2b-256	`f34f80199963d565a2464541657bac8375cac6a7b0673e1105d6220197173f41`

ruff-odoo 0.16.3.21

ruff-odoo

The ruff-odoo command

Installation

pre-commit

Version scheme

Reporting the version

Building from source

Project links

Key dates

2 maintainers

Credits

GitHub Statistics

License expression

Requires

Tags

Classifiers

Download files

Source Distribution

Built Distributions

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

Release history Release notifications | RSS feed

The `ruff-odoo` command