NAME
Dist::Zilla::Util::Git::Refs - Work with refs
VERSION
version 0.002000
SYNOPSIS
After doing lots of work with Git::Wrapper, I found there's quite a few
ways to work with refs, and those ways aren't exactly all equal, or
supported on all versions of git.
This abstracts it so things can just use them.
my $refs = Dist::Zilla::Util::Git::Refs->new( zilla => $self->zilla );
$refs->refs(); # A ::Ref object for each entry from `git ls-remote .`
my ( @results ) = $refs->get_ref('refs/**'); # the same thing
my ( @results ) = $refs->get_ref('refs/heads/**'); # all branches
my ( @results ) = $refs->get_ref('refs/tags/**'); # all tags
my ( @results ) = $refs->get_ref('refs/remotes/**'); # all remote branches
Note: You probably shouldn't use this module directly, and should
instead use one of the "::Util::Git" family.
METHODS
"refs"
Lists all "refs" in the "refs/" "namespace".
my (@refs) = $reffer->refs();
Shorthand for
my (@refs) = $reffer->get_ref('refs/**');
"get_ref"
Fetch a given "ref", or collection of "ref"s, matching a specification.
my ($ref) = $reffer->get_ref('refs/heads/master');
my (@branches) = $reffer->get_ref('refs/heads/**');
my (@tags) = $reffer->get_ref('refs/tags/**');
Though reminder, if you're working with branches or tags, use the
relevant modules =).
AUTHOR
Kent Fredric
COPYRIGHT AND LICENSE
This software is copyright (c) 2013 by Kent Fredric
.
This is free software; you can redistribute it and/or modify it under
the same terms as the Perl 5 programming language system itself.