view release on metacpan or  search on metacpan

README  view on Meta::CPAN

        git-codeowners owners [--format FORMAT] [--pattern PATTERN]

    List all owners defined in the CODEOWNERS file.

 patterns

        git-codeowners patterns [--format FORMAT] [--owner OWNER]

    List all patterns defined in the CODEOWNERS file.

 create

        git-codeowners create [REPO_DIRPATH|CODEOWNERS_FILEPATH]

    Create a new CODEOWNERS file for a specified repo (or current
    directory).

 update

        git-codeowners update [REPO_DIRPATH|CODEOWNERS_FILEPATH]

    Update the "unowned" list of an existing CODEOWNERS file for a
    specified repo (or current directory).

FORMAT

    The --format argument can be one of:

      * csv - Comma-separated values (requires Text::CSV)

      * json:pretty - Pretty JSON (requires JSON::MaybeXS)

      * json - JSON (requires JSON::MaybeXS)

      * table - Table (requires Text::Table::Any)

      * tsv - Tab-separated values (requires Text::CSV)

      * yaml - YAML (requires YAML)

      * FORMAT - Custom format (see below)

 Format string

    You can specify a custom format using printf-like format sequences.
    These are the items that can be substituted:

      * %F - Filename

      * %O - Owner or owners

      * %P - Project

      * %T - Pattern

      * %n - newline

      * %t - tab

      * %% - percent sign

    The syntax also allows padding and some filters. Examples:

        git-codeowners show -f ' * %-50F %O'                # default for "show"
        git-codeowners show -f '%{quote}F,%{quote}O'        # ad hoc CSV
        git-codeowners patterns -f '--> %{color:0c0}T'      # whatever...

    Available filters:

      * quote - Quote the replacement string.

      * color:FFFFFF - Colorize the replacement string (if color is ON).

      * nocolor - Do not colorize replacement string.

 Format table

    Table formatting can be done by one of several different modules, each
    with its own features and bugs. The default module is
    Text::Table::Tiny, but this can be overridden using the PERL_TEXT_TABLE
    environment variable if desired, like this:

        PERL_TEXT_TABLE=Text::Table::HTML git-codeowners -f table

    The list of available modules is at "@BACKENDS" in Text::Table::Any.

ENVIRONMENT

    If you set GIT_CODEOWNERS_ALIASES in the environment to a true value,
    the parser will parse group aliases which are supported by some
    applications.

CAVEATS

      * Some commands require git (at least version 1.8.5).

BUGS

    Please report any bugs or feature requests on the bugtracker website
    https://github.com/chazmcgarvey/git-codeowners/issues

    When submitting a bug or request, please include a test-file or a patch
    to an existing test-file that illustrates the bug or desired feature.

AUTHOR

    Charles McGarvey <chazmcgarvey@brokenzipper.com>

COPYRIGHT AND LICENSE

    This software is copyright (c) 2021 by Charles McGarvey.

    This is free software; you can redistribute it and/or modify it under
    the same terms as the Perl 5 programming language system itself.