view release on metacpan or  search on metacpan

bin/git-codeowners  view on Meta::CPAN

=item *

C<json:pretty> - Pretty JSON (requires L<JSON::MaybeXS>)

=item *

C<json> - JSON (requires L<JSON::MaybeXS>)

=item *

C<table> - Table (requires L<Text::Table::Any>)

=item *

C<tsv> - Tab-separated values (requires L<Text::CSV>)

=item *

C<yaml> - YAML (requires L<YAML>)

=item *

C<FORMAT> - Custom format (see below)

=back

=head2 Format string

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

=over 4

=item *

C<%F> - Filename

=item *

C<%O> - Owner or owners

=item *

C<%P> - Project

=item *

C<%T> - Pattern

=item *

C<%n> - newline

=item *

C<%t> - tab

=item *

C<%%> - percent sign

=back

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:

=over 4

=item *

C<quote> - Quote the replacement string.

=item *

C<color:FFFFFF> - Colorize the replacement string (if color is ON).

=item *

C<nocolor> - Do not colorize replacement string.

=back

=head2 Format table

Table formatting can be done by one of several different modules, each with its own features and
bugs. The default module is L<Text::Table::Tiny>, but this can be overridden using the
C<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 L<Text::Table::Any/@BACKENDS>.

=head1 ENVIRONMENT

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

=head1 CAVEATS

=over 4

=item *

Some commands require F<git> (at least version 1.8.5).

=back

=head1 BUGS

Please report any bugs or feature requests on the bugtracker website
L<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.