[![CircleCI](https://circleci.com/gh/hairyhenderson/go-codeowners/tree/master.svg?style=svg)](https://circleci.com/gh/hairyhenderson/go-codeowners/tree/master)

# go-codeowners

A package that finds and parses [`CODEOWNERS`](https://help.github.com/articles/about-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

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

To find the owner of the README.md file:

```go
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](http://opensource.org/licenses/MIT)

Copyright (c) 2018 Dave Henderson