codeowners

README

go-codeowners

A package that finds and parses CODEOWNERS files.

Features:

• operates on local repos
• doesn't require a cloned repo (i.e. doesn't need a .git directory to be present at the repo's root)
• can be called from within a repo (doesn't have to be at the root)
• will find CODEOWNERS files in all documented locations: the repo's root, docs/, and .github/ (or .gitlab/ for GitLab repos)

Usage

go get -u github.com/hairyhenderson/go-codeowners

To find the owner of the README.md file:

import "github.com/hairyhenderson/go-codeowners"

func main() {
	c, _ := NewCodeowners(cwd())
	owners := c.Owners("README.md")
	for i, o := range owners {
		fmt.Printf("Owner #%d is %s\n", i, o)
	}
}

License

The MIT License

Copyright (c) 2018 Dave Henderson

Documentation

Index

• type Codeowner
  • func NewCodeowner(pattern string, owners []string) (Codeowner, error)
  • func (c Codeowner) String() string
• type Codeowners
  • func NewCodeowners(path string) (*Codeowners, error)
  • func (c *Codeowners) Owners(path string) []string

Examples

• Codeowners.Owners
• NewCodeowners

Types

type Codeowner

type Codeowner struct {
	// contains filtered or unexported fields
}

Codeowner - owners for a given pattern

func NewCodeowner

func NewCodeowner(pattern string, owners []string) (Codeowner, error)

NewCodeowner -

func (Codeowner) String

func (c Codeowner) String() string

type Codeowners

type Codeowners struct {
	// contains filtered or unexported fields
}

Codeowners - patterns/owners mappings for the given repo

func NewCodeowners

func NewCodeowners(path string) (*Codeowners, error)

NewCodeowners -

Example

c, _ := NewCodeowners(cwd())
fmt.Println(c.patterns[0])

Output:
*	@hairyhenderson

func (*Codeowners) Owners

func (c *Codeowners) Owners(path string) []string

Owners - return the list of code owners for the given path (within the repo root)

Example

c, _ := NewCodeowners(cwd())
owners := c.Owners("README.md")
for i, o := range owners {
	fmt.Printf("Owner #%d is %s\n", i, o)
}

Output:
Owner #0 is @hairyhenderson