Status.pm

package Group::Git::Cmd::Status;

# Created on: 2013-05-06 21:57:07
# Create by:  Ivan Wills
# $Id$
# $Revision$, $HeadURL$, $Date$
# $Revision$, $Source$, $Date$

use Moo::Role;
use strict;
use warnings;
use version;
use Carp;
use English qw/ -no_match_vars /;
use File::chdir;
use Getopt::Alt;

our $VERSION = version->new('0.6.5');

requires 'repos';
requires 'verbose';

my $opt = Getopt::Alt->new(
    { help => __PACKAGE__, },
    [
        'quiet|q',
    ]
);

sub status_start {
    $opt->process;

    return;
}

sub status {
    my ($self, $name) = @_;
    return unless -d $name;

    my $repo = $self->repos->{$name};
    my $cmd;

    local $CWD = $name;
    $cmd = join ' ', 'git', 'status', map { $self->shell_quote } @ARGV;

    my $out = `$cmd 2>&1`;

    return $out if $self->verbose;

    return if $out =~ /nothing \s+ to \s+ commit/xms && $opt->opt->quiet;

    return $out;
}

1;

__END__

=head1 NAME

Group::Git::Cmd::Status - Runs git status on a git project

=head1 VERSION

This documentation refers to Group::Git::Cmd::Status version 0.6.5.


=head1 SYNOPSIS

   use Group::Git::Cmd::Status;

   # Brief but working code example(s) here showing the most common usage(s)
   # This section will be as far as many users bother reading, so make it as
   # educational and exemplary as possible.


=head1 DESCRIPTION

=head1 SUBROUTINES/METHODS

=over 4

=item C<status ($name)>

Runs git status on each directory if the status message includes:

 "nothing to commit"

The status is suppressed to keep the output clean. This can be overridden
if verbose is set.

=item C<status_start ()>

Process the command line arguments for status

=back

=head1 DIAGNOSTICS

=head1 CONFIGURATION AND ENVIRONMENT

=head1 DEPENDENCIES

=head1 INCOMPATIBILITIES

=head1 BUGS AND LIMITATIONS

There are no known bugs in this module.

Please report problems to Ivan Wills (ivan.wills@gmail.com).

Patches are welcome.

=head1 AUTHOR

Ivan Wills - (ivan.wills@gmail.com)

=head1 LICENSE AND COPYRIGHT

Copyright (c) 2013 Ivan Wills (14 Mullion Close, Hornsby Heights, NSW Australia 2077).
All rights reserved.

This module is free software; you can redistribute it and/or modify it under
the same terms as Perl itself. See L<perlartistic>.  This program is
distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY;
without even the implied warranty of MERCHANTABILITY or FITNESS FOR A
PARTICULAR PURPOSE.

=cut