NAME

Dist::Zilla::Plugin::GitObtain - obtain files from a git repository before building a distribution

VERSION

version 0.02

SYNOPSIS

In your dist.ini:

[GitObtain]
  --git_dir       = some_dir
  --keep_git_dirs = 1
  ;package    = url                                           tag
  rakudo      = git://github.com/rakudo/rakudo.git            2010.06
  http-daemon = git://gitorious.org/http-daemon/mainline.git

DESCRIPTION

This module uses Git::Wrapper to obtain files from git repositories before building a distribution.

You may specify the directory the git repositories will be placed into by using the --git_dir option. This directory path will be created if it does not already exist (including intermediate directories). After the build is complete, this directory will be removed. If you do not specify --git_dir, a default value of "src" will be used. If you don't want the directories that are created to be removed after the completion of the build, set --keep_git_dirs to be a true value.

Each repository has a name that will be used as the directory within the --git_dir directory to place a clone of the git repository specified by the URL. Optionally, each URL may be followed by a "tag" name that will be checked out of the git repository. (Anything that may be passed to git checkout may be used for the "tag".)

AUTHOR

Jonathan Scott Duff <duff@pobox.com>

COPYRIGHT

This software is copyright (c) 2010 by Jonathan Scott Duff

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