NAME
Group::Git - Base module for group of git repository operations.
VERSION
This documentation refers to Group::Git version 0.7.7.
SYNOPSIS
use Group::Git;
my $group = Group::Git->new( conf => {...} );
# pull remote versions for all repositories
$group->pull();
# any other arbitary command
$group->log;
DESCRIPTION
This is the base module it will try to use all roles in the Group::Git::Cmd::*
namespace. This allows the creation of new command by just putting a role in that namespace. Classes may extend this class to implement their own methods for finding repositories (eg Group::Git::Github, Group::Git::Bitbucket, Group::Git::Gitosis and Group::Git::Stash)
Group-Git vs Git Submodule
It has been pointed out that something similar could be achieved using the git submodule command so here are some reasons for using Group-Git
:
No git repository needed to manage all the repositories in fact no configuration is required at all.
Group-Git just cares about repositories not their commits as submodule does.
When using one of github.com / bitbucket.com or gitosis configurations when new repositories are added the next
group-git pull
will get those new repositories.You can add your own commands to
group-git
currently via perl modules but in the future in the same fashion asgit
does (eg adding a program calledgroup-git-command
somewhere on your path will result in you being able to rungroup-git command
)
SUBROUTINES/METHODS
cmd ($name)
-
Run the git command
$name
for each repository. shell_quote ()
-
Returns the shell quoted string for $_
DIAGNOSTICS
CONFIGURATION AND ENVIRONMENT
DEPENDENCIES
INCOMPATIBILITIES
BUGS AND LIMITATIONS
There are no known bugs in this module.
Please report problems to Ivan Wills (ivan.wills@gmail.com).
Patches are welcome.
AUTHOR
Ivan Wills - (ivan.wills@gmail.com)
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 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.