git-owners

A git subcommand to query and validate CODEOWNERS.

List owners of files based on the CODEOWNERS of the current repository.

```

git owners src/main.rs src/main.rs @weyland ```

```

git owners git ls-files .gitignore (unowned) Cargo.lock @weyland Cargo.toml @weyland LICENSE (unowned) README.md @weyland src/main.rs @weyland ```

```

oops, did the last commit add some unowned files?

git diff --name-only --diff-filter=A | git owners .gitignore (unowned) LICENSE (unowned) ```

```

I need stats about my big monorepo

echo git ls-files | git owners | grep "(unowned)"| wc -l out of git ls-files | git owners | wc -l files in this repository do not have a corresponding CODEOWNERS entry 2 out of 6 files in this repository do not have a corresponding CODEOWNERS entry ```

Installation

• Via Cargo: cargo install git-owners

Usage

• Get owners of a file

  git owners some/file

• Get owners for a list of files

  git owners some/file some/other/file

• Get owners for every tracked file

  git ls-files | git owners

• Get owners for files modified in last five commits

  git diff --name-only HEAD~5 HEAD | git owners

• Congratulate the user if the current changeset does not add files without owner

  git diff --diff-filter=ACR --name-only | git owners && echo "Great job! No unowned files added!"

• Get an overview of your CODEOWNERS coverage echo `git ls-files | git owners | grep "(unowned)"| wc -l` out of `git ls-files | git owners | wc -l` files in this repository do not have a corresponding CODEOWNERS entry

Features

• Detects the right CODEOWNERS file of the current git repository
• Is composable & scripting friendly
• Works well as a pre-commit hook
• Is fast & written in Rust

Issues & Contributing

If you have any questions or problems, feel free to communicate using Github Issues.