NAME Dist::Zilla::Util::Git::Tags - Extract all tags from a repository VERSION version 0.002000 SYNOPSIS This tool basically gives a more useful interface around git tag Namely, each tag returned is a tag object, and you can view tag properties with it. use Dist::Zilla::Util::Git::Tags; my $tags_finder = Dist::Zilla::Util::Git::Tags->new( zilla => $self->zilla ); for my $tag ( $tags_finder->tags ) { printf "%s - %s\n", $tag->name, $tag->sha1; } METHODS "tags" A "List" of "::Tags::Tag" objects my @tags = $tag_finder->tags(); "get_tag" my ($first_matching) = $tags->get_tag('1.000'); my (@all_matching) = $tags->get_tag('1.*'); Note: This can easily return multiple values. For instance, "tags" is implemented as my ( @tags ) = $branches->get_tag('*'); Mostly, because the underlying mechanism is implemented in terms of fnmatch(3) If the tag does not exist, or no tag match the expression, "get_tag" will return an empty list. So in the top example, "match" is "undef" if 1.000 does not exist. "tag_sha1_map" A "HashRef" of "sha1 => [ tag, tag ]" entries. my $hash = $tag_finder->tag_sha1_map(); "tags_for_rev" A "List" of "::Tags::Tag" objects that point to the given "SHA1". $tag_finder->tags_for_rev( $sha1_or_commitish_etc ); ATTRIBUTES "git" A Git::Wrapper ( or compatible ) repository. Auto-Built from "zilla" with "::Util::Git::Wrapper" "zilla" A Dist::Zilla instance. Mandatory unless you passed "git" 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.