#github #codeowners #parser #matching #rules #ruleset #path

codeowners-rs

A library for parsing and matching CODEOWNERS files

2 releases

0.1.1 Apr 1, 2023
0.1.0 Apr 1, 2023

#3 in #codeowners

Download history 15/week @ 2024-06-02 42/week @ 2024-06-09 5/week @ 2024-06-16 9/week @ 2024-07-07 4/week @ 2024-07-21 13/week @ 2024-07-28 5/week @ 2024-08-04 11/week @ 2024-08-11 1/week @ 2024-08-18 8/week @ 2024-08-25 42/week @ 2024-09-01 2/week @ 2024-09-08 13/week @ 2024-09-15

65 downloads per month

Apache-2.0

50KB
1K SLoC

codeowners-rs

A fast Rust library and CLI for GitHub's CODEOWNERS file.

crates.io docs.rs CI

Includes a fast, hand-written parser for CODEOWNERS files. The resulting parse tree includes comments and byte offsets for all syntax components, making it suitable for writing syntax highlighters or providing syntax-aware diagnostic information.

The matcher works by building an NFA from the rules, which makes this library highly performant for large rulesets and matching large numbers of paths.

Example usage

use codeowners_rs::{parse, RuleSet};

let ruleset = parse("
*.rs @github/rustaceans
/docs/**/*.md @github/docs-team
").into_ruleset();

for path in &["src/main.rs", "docs/README.md", "README.md"] {
   let owners = ruleset.owners(path);
   println!("{}: {:?}", path, owners);
}

See the full documentation on docs.rs.

CLI usage

$ codeowners --help
Usage: codeowners [OPTIONS] [PATHS]...

Arguments:
  [PATHS]...

Options:
  -f, --file <CODEOWNERS_FILE>
          Path to a CODEOWNERS file. If omitted, the following locations will be tried: ./CODEOWNERS, ./.github/CODEOWNERS
  -p, --paths-from <PATHS_FROM_FILE>
          Match paths from this file rather than walking the directory tree
  -o, --owners <OWNERS>
          Filter results to files owned by this owner. May be used multiple times to match multiple owners
  -u, --unowned
          Filter results to show unowned files. May be used with -o
  -t, --threads <THREADS>
          Concurrency. If set to 0, a sensible value based on CPU count will be used [default: 0]
  -h, --help
          Print help information
  -V, --version
          Print version information

Dependencies

~2.3–3.5MB
~58K SLoC