Struct CodeOwners 

pub struct CodeOwners { /* private fields */ }

Parsed CODEOWNERS file for ownership lookup.

Implementations

impl CodeOwners

pub fn from_file(path: &Path) -> Result<Self, String>

Load and parse a CODEOWNERS file from the given path.

pub fn discover(root: &Path) -> Result<Self, String>

Auto-probe standard CODEOWNERS locations relative to the project root.

Tries CODEOWNERS, .github/CODEOWNERS, .gitlab/CODEOWNERS, docs/CODEOWNERS.

pub fn load(root: &Path, config_path: Option<&str>) -> Result<Self, String>

Load from a config-specified path, or auto-discover.

pub fn owner_of(&self, relative_path: &Path) -> Option<&str>

Look up the primary owner of a file path (relative to project root).

Returns the first owner from the last matching CODEOWNERS rule, or None if no rule matches or the last matching rule is a GitLab-style exclusion (!path).

pub fn owner_and_rule_of(&self, relative_path: &Path) -> Option<(&str, &str)>

Look up the primary owner and the original CODEOWNERS pattern for a path.

Returns (owner, pattern) from the last matching rule, or None if no rule matches or the last matching rule is a GitLab-style exclusion. The pattern is the raw string from the CODEOWNERS file (e.g. /src/ or *.ts).

pub fn section_of(&self, relative_path: &Path) -> Option<Option<&str>>

Look up the GitLab CODEOWNERS section that owns a file.

Returns Some(Some(name)) when the last matching rule is inside a named section, Some(None) when the rule appears before any section header, or None when no rule matches or the last match is a GitLab-style exclusion.

pub fn section_and_owners_of( &self, relative_path: &Path, ) -> Option<(Option<&str>, &[String])>

Look up the section name plus the section’s default owners for a file.

Used by --group-by section to attach owner metadata to each group. Returns None when no rule matches or the last match is a negation. The returned owner slice is empty for rules declared outside any section or for sections that declare no default owners.

pub fn section_owners_and_rule_of( &self, relative_path: &Path, ) -> Option<(Option<&str>, &[String], &str)>

Look up section, section owners, and the raw CODEOWNERS pattern in one glob pass.

Used by --group-by section display paths that need both the section key and the matching rule text without walking the GlobSet twice.

pub fn has_sections(&self) -> bool

Whether the parsed file contains at least one GitLab section header.

--group-by section errors out when this is false, since every file would collapse into the (no section) bucket.

Trait Implementations

impl Debug for CodeOwners

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.