view release on metacpan or  search on metacpan

README  view on Meta::CPAN

NAME

    git-codeowners - A tool for managing CODEOWNERS files

VERSION

    version 0.51

SYNOPSIS

        git-codeowners [--version|--help|--manual]
    
        git-codeowners [show] [--format FORMAT] [--owner OWNER]...
                       [--pattern PATTERN]... [--[no-]patterns]
                       [--project PROJECT]... [--[no-]projects] [PATH...]
    
        git-codeowners owners [--format FORMAT] [--pattern PATTERN]
    
        git-codeowners patterns [--format FORMAT] [--owner OWNER]
    
        git-codeowners create|update [REPO_DIRPATH|CODEOWNERS_FILEPATH]
    
        # enable bash shell completion
        eval "$(git-codeowners --shell-completion)"

DESCRIPTION

    git-codeowners is yet another CLI tool for managing CODEOWNERS files in
    git repos. In particular, it can be used to quickly find out who owns a
    particular file in a monorepo (or monolith).

    THIS IS EXPERIMENTAL! The interface of this tool and its modules will
    probably change as I field test some things. Feedback welcome.

INSTALL

    There are several ways to install git-codeowners to your system.

 from CPAN

    You can install git-codeowners using cpanm:

        cpanm App::Codeowners

 from GitHub

    You can also choose to download git-codeowners as a self-contained
    executable:

        curl -OL https://raw.githubusercontent.com/chazmcgarvey/git-codeowners/solo/git-codeowners
        chmod +x git-codeowners

    To hack on the code, clone the repo instead:

        git clone https://github.com/chazmcgarvey/git-codeowners.git
        cd git-codeowners
        make bootstrap      # installs dependencies; requires cpanm

OPTIONS

 --version

    Print the program name and version to STDOUT, and exit.

    Alias: -v

 --help

    Print the synopsis to STDOUT, and exit.

    Alias: -h

    You can also use --manual to print the full documentation.

 --color

    Enable colorized output.

    Color is ON by default on terminals; use --no-color to disable. Some
    environment variables may also alter the behavior of colorizing output:

      * NO_COLOR - Set to disable color (same as --no-color).

      * COLOR_DEPTH - Set the number of supportable colors (e.g. 0, 16,
      256, 16777216).

 --format

    Specify the output format to use. See "FORMAT".

    Alias: -f

 --shell-completion

        eval "$(git-codeowners --shell-completion)"

    Print shell code to enable completion to STDOUT, and exit.

    Does not yet support Zsh...

COMMANDS

 show

        git-codeowners [show] [--format FORMAT] [--owner OWNER]...
                       [--pattern PATTERN]... [--[no-]patterns]
                       [--project PROJECT]... [--[no-]projects] [PATH...]
                       [--[no-]expand-aliases]

    Show owners of one or more files in a repo.