NitroCop

Fast Ruby linter in Rust targeting RuboCop compatibility.

Benchmark on the rubygems.org repo (1,227 files, Ruby 4.0), Apple Silicon:

Features

• 910 cops from 6 RuboCop gems (rubocop, rubocop-rails, rubocop-performance, rubocop-rspec, rubocop-rspec_rails, rubocop-factory_bot)
• 98.8% conformance against RuboCop across 1,017 open-source repos
• Autocorrect (-a/-A) is partial — work in progress
• Reads your existing .rubocop.yml — no migration needed
• Uses Prism (Ruby's official parser) via ruby-prism crate
• Parallel file processing with rayon

Requires Rust 1.85+ (edition 2024).

cargo install nitrocop   # not yet published — build from source for now

Then run it in your Ruby project:

nitrocop

nitrocop reads .rubocop.yml with full support for:

• inherit_from — local files, recursive
• inherit_gem — resolves gem paths via bundle info
• inherit_mode — merge/override for arrays
• Department-level config — RSpec:, Rails: Include/Exclude/Enabled
• AllCops — NewCops, DisabledByDefault, Exclude, Include
• Enabled: pending tri-state
• Per-cop options — EnforcedStyle, Max, AllowedMethods, AllowedPatterns, etc.

Config auto-discovery walks up from the target directory to find .rubocop.yml.

nitrocop supports 910 cops from 6 RuboCop gems.

Compared with RuboCop on 1,017 open-source repos (228k Ruby files).

98.8% of compared issue reports matched (11.8M of 11.9M). 720 of 910 cops matched exactly; 190 differed.

rubocop 1.84.2 (588 cops)

rubocop-rails 2.34.3 (138 cops)

rubocop-performance 1.26.1 (52 cops)

rubocop-rspec 3.9.0 (113 cops)

rubocop-rspec_rails 2.32.0 (8 cops)

rubocop-factory_bot 2.28.0 (11 cops)

"Matched exactly" means nitrocop produced no extra issues and missed no issues for that cop anywhere in the corpus. See docs/corpus.md for the full corpus breakdown.

Every cop reads its RuboCop YAML config options and has fixture-based test coverage.

Use --rubocop-only to run nitrocop alongside RuboCop for cops it doesn't cover yet:

#!/usr/bin/env bash
# bin/lint — fast hybrid linter
nitrocop "$@"

REMAINING=$(nitrocop --rubocop-only)
if [ -n "$REMAINING" ]; then
  bundle exec rubocop --only "$REMAINING" "$@"
fi

nitrocop [OPTIONS] [PATHS]...

Arguments:
  [PATHS]...    Files or directories to lint [default: .]

Options:
  -a, --autocorrect         Autocorrect offenses (safe cops only)
  -A, --autocorrect-all     Autocorrect offenses (all cops, including unsafe)
  -c, --config <PATH>       Path to .rubocop.yml
  -f, --format <FORMAT>     Output format: text, json [default: text]
      --only <COPS>         Run only specified cops (comma-separated)
      --except <COPS>       Skip specified cops (comma-separated)
      --rubocop-only        Print cops NOT covered by nitrocop
      --stdin <PATH>        Read source from stdin, use PATH for display
      --debug               Print timing and debug info
      --list-cops           List all registered cops
      --ignore-disable-comments  Ignore all # rubocop:disable inline comments
      --cache <true|false>  Enable/disable file-level result caching [default: true]
      --cache-clear         Clear the result cache and exit
      --init                Resolve gem paths and write lockfile to cache directory, then exit
      --fail-level <SEV>    Minimum severity for non-zero exit (convention/warning/error/fatal)
  -F, --fail-fast           Stop after first file with offenses
      --force-exclusion     Apply AllCops.Exclude to explicitly-passed files
  -L, --list-target-files   Print files that would be linted, then exit
      --force-default-config  Ignore all config files, use built-in defaults
  -h, --help                Print help

cargo check          # fast compile check
cargo test           # run all tests (2,700+)
cargo run -- .       # lint current directory

# Quality checks (must pass — zero tolerance)
cargo test config_audit     # all YAML config keys implemented
cargo test prism_pitfalls   # no missing node type handling

# Benchmarks
cargo run --release --bin bench_nitrocop          # full: setup + bench + conform
cargo run --release --bin bench_nitrocop -- bench # timing only

1. Config resolution — Walks up from target to find .rubocop.yml, resolves inherit_from/inherit_gem chains, merges layers
2. File discovery — Uses the ignore crate for .gitignore-aware traversal, applies AllCops.Exclude/Include patterns
3. Parallel linting — Each rayon worker thread parses files with Prism (ParseResult is !Send), runs all enabled cops per file
4. Cop execution — Three check phases per file: check_lines (raw text), check_source (bytes + CodeMap), check_node (AST walk via batched dispatch table)
5. Output — RuboCop-compatible text format or JSON

These cops are registered but cannot be exercised under current Ruby versions:

• Lint/ItWithoutArgumentsInBlock — it is a block parameter in Ruby 3.4+, making this cop obsolete
• Lint/NonDeterministicRequireOrder — Dir results are sorted since Ruby 3.0
• Lint/NumberedParameterAssignment — assigning to _1 is a syntax error in Ruby 3.4+
• Lint/UselessElseWithoutRescue — syntax error in Ruby 3.4+
• Security/YAMLLoad — YAML.load is safe since Ruby 3.1 (cop has max Ruby 3.0)

These cops are excluded from corpus reporting counts.