Metadata-Version: 2.4
Name: whoowns
Version: 0.8.1
Summary: Print the GitHub owner of a file or folder based on CODEOWNERS
Keywords: codeowners,github,cli,ownership
Author: Markus Hofbauer, Chris Bachhuber
License-Expression: MIT
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Classifier: Topic :: Software Development :: Version Control :: Git
Requires-Python: >=3.10
Project-URL: Homepage, https://github.com/hofbi/dev-tools
Project-URL: Repository, https://github.com/hofbi/dev-tools
Project-URL: Issues, https://github.com/hofbi/dev-tools/issues
Description-Content-Type: text/markdown

# whoowns

[![PyPI](https://img.shields.io/pypi/v/whoowns)](https://pypi.org/project/whoowns/)
[![PyPI - Python Version](https://img.shields.io/pypi/pyversions/whoowns)](https://pypi.org/project/whoowns/)
[![PyPI - License](https://img.shields.io/pypi/l/whoowns)](https://pypi.org/project/whoowns/)

`whoowns` is a tool to print the GitHub codeowner of a folder or file by parsing the `CODEOWNERS` file.
With this tool, you can easily find out who is responsible for a specific part of the codebase from the terminal.
To find the owners of a file or folder, run

```shell
uvx whoowns path/to/your/file/or/folder

# example output
# path/to/your/file/or/folder -> @owner1
```

Specify the `--level N` to see the owners of child items in the N-th directory level below your provided folder.

Currently, this supports `CODEOWNERS` file format for GitHub, GitLab, and Bitbucket.
See their docs for more details on where to place the `CODEOWNERS` file.

- GitHub: <https://docs.github.com/en/repositories/managing-your-repositorys-settings-and-features/customizing-your-repository/about-code-owners#codeowners-file-location>
- GitLab: <https://docs.gitlab.com/user/project/codeowners/#codeowners-file>
- Bitbucket: <https://support.atlassian.com/bitbucket-cloud/docs/set-up-and-use-code-owners/>
