Skip to content

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

License

Notifications You must be signed in to change notification settings

timoschinkel/codeowners

Repository files navigation

Code owners

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.

About

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

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages