The Perl Toolchain Summit needs more sponsors. If your company depends on Perl, please support this very important event.

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 as git does (eg adding a program called group-git-command somewhere on your path will result in you being able to run group-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.