timoschinkel/codeowners

A parser and matcher for the codeowners file as used by Github, Gitlab and Bitbucket.

2.3.0 2024-10-02 12:41 UTC

Requires

• php: ^8.0

Requires (Dev)

• phpunit/phpunit: ^9.4
• squizlabs/php_codesniffer: ^3.5
• vimeo/psalm: ^5.23

Apache-2.0

README

Code Owners allows you to parse code owners files and apply the outcome to all kinds of different result sets ranging from code coverage to static analysis results.

Code Owners files are supported by Github, Gitlab and Bitbucket.

Installation

Use Composer for installation:

composer require timoschinkel/codeowners

Usage

Parse CODEOWNERS file:

<?php

use CodeOwners\Parser;
use CodeOwners\PatternMatcher;

try {
    $patterns = (new Parser())->parseFile($filename);
    $pattern = (new PatternMatcher(...$patterns))->match($filename);
} catch (\CodeOwners\Exception\UnableToParseException $exception) {
    // unable to read or parse file
} catch (\CodeOwners\Exception\NoMatchFoundException $exception) {
    // no match found
}

Alternatively, parsing a string directly is also supported:

<?php

use CodeOwners\Parser;
use CodeOwners\PatternMatcher;

try {
    $patterns = (new Parser())->parseString($contents);
    $pattern = (new PatternMatcher(...$patterns))->match($filename);
} catch (\CodeOwners\Exception\UnableToParseException $exception) {
    // unable to read or parse file
} catch (\CodeOwners\Exception\NoMatchFoundException $exception) {
    // no match found
}

Known limitations

Currently the library does not handle spaces in file paths.