[catagits/Gitalist.git] / lib / Gitalist / Git / Project.pm

use MooseX::Declare;

=head1 NAME

Gitalist::Git::Project - Model of a git repository

=head1 SYNOPSIS

    my $gitrepo = dir('/repo/base/Gitalist');
    my $project = Gitalist::Git::Project->new($gitrepo);
     $project->name;        # 'Gitalist'
     $project->path;        # '/repo/base/Gitalist/.git'
     $project->description; # 'Unnamed repository.'

=head1 DESCRIPTION

This class models a git repository, referred to in Gitalist
as a "Project".

=cut

class Gitalist::Git::Project with Gitalist::Git::HasUtils {
    # FIXME, use Types::Path::Class and coerce
    use MooseX::Types::Common::String qw/NonEmptySimpleStr/;
    use MooseX::Types::Path::Class qw/Dir/;
    use MooseX::Types::Moose qw/Str Maybe Bool HashRef ArrayRef/;
    use List::MoreUtils qw/any zip/;
    use DateTime;
    use aliased 'Gitalist::Git::Object';

    our $SHA1RE = qr/[0-9a-fA-F]{40}/;

    around BUILDARGS (ClassName $class: Dir $dir) {
        # Allows us to be called as Project->new($dir)
        # Last path component becomes $self->name
        # Full path to git objects becomes $self->path
        my $name = $dir->dir_list(-1);
        $dir = $dir->subdir('.git') if (-f $dir->file('.git', 'HEAD'));
        confess("Can't find a git repository at " . $dir)
            unless ( -f $dir->file('HEAD') );
        return $class->$orig(name => $name,
                             path => $dir);
    }

=head1 ATTRIBUTES

=head2 name

The name of the Project.  By default, this is derived from the path to the git repository.

=cut
    has name => ( isa => NonEmptySimpleStr,
                  is => 'ro', required => 1 );

=head2 path

L<Path::Class:Dir> for the location of the git repository.

=cut
    has path => ( isa => Dir,
                  is => 'ro', required => 1);

=head2 description

String containing .git/description

=cut
    has description => ( isa => Str,
                         is => 'ro',
                         lazy_build => 1,
                     );

=head2 owner

Owner of the files on disk.

=cut
    has owner => ( isa => NonEmptySimpleStr,
                   is => 'ro',
                   lazy_build => 1,
               );

=head2 last_change

L<DateTime> for the time of the last update.
undef if the repository has never been used.

=cut
    has last_change => ( isa => Maybe['DateTime'],
                         is => 'ro',
                         lazy_build => 1,
                     );

=head2 is_bare

Bool indicating whether this Project is bare.

=cut
    has is_bare => ( isa => Bool,
                     is => 'ro',
                     lazy => 1,
                     default => sub {
                         -d $_[0]->path->parent->subdir->($_[0]->name)
                             ? 1 : 0
                         },
                     );

=head2 heads

ArrayRef of hashes containing the name and sha1 of all heads.

=cut
    has heads => ( isa => ArrayRef[HashRef],
                   is => 'ro',
                   lazy_build => 1);

=head2 references

Hashref of ArrayRefs for each reference.

=cut
    has references => ( isa => HashRef[ArrayRef[Str]],
                        is => 'ro',
                        lazy_build => 1 );

    method BUILD {
        $self->$_() for qw/last_change owner description/; # Ensure to build early.
    }

=head1 METHODS

=head2 head_hash ($head?)

Return the sha1 for HEAD, or any specified head.

=cut
    method head_hash (Str $head?) {
        my $output = $self->run_cmd(qw/rev-parse --verify/, $head || 'HEAD' );
        confess("No such head: " . $head) unless defined $output;

        my($sha1) = $output =~ /^($SHA1RE)$/;
        return $sha1;
    }

=head2 list_tree ($sha1?)

Return an array of contents for a given tree.
The tree is specified by sha1, and defaults to HEAD.
Each item is a L<Gitalist::Git::Object>.

=cut
    method list_tree (Str $sha1?) {
        $sha1 ||= $self->head_hash;

        my $output = $self->run_cmd(qw/ls-tree -z/, $sha1);
        return unless defined $output;

        my @ret;
        for my $line (split /\0/, $output) {
            my ($mode, $type, $object, $file) = split /\s+/, $line, 4;
            push @ret, Object->new( mode => oct $mode,
                                    type => $type,
                                    sha1 => $object,
                                    file => $file,
                                    project => $self,
                                  );
        }
        return @ret;
    }

=head2 get_object ($sha1)

Return a L<Gitalist::Git::Object> for the given sha1.

=cut
    method get_object (NonEmptySimpleStr $sha1) {
        unless ( $self->_is_valid_rev($sha1) ) {
            $sha1 = $self->head_hash($sha1);
        }
        return Object->new(
            project => $self,
            sha1 => $sha1,
        );
    }

=head2 hash_by_path($sha1, $path, $type?)

Returns the sha1 for a given path, optionally limited by type.

=cut
    method hash_by_path ($base, $path = '', $type?) {
        $path =~ s{/+$}();
        # FIXME should this really just take the first result?
        my @paths = $self->run_cmd('ls-tree', $base, '--', $path)
            or return;
        my $line = $paths[0];

        #'100644 blob 0fa3f3a66fb6a137f6ec2c19351ed4d807070ffa	panic.c'
        $line =~ m/^([0-9]+) (.+) ($SHA1RE)\t/;
        return defined $type && $type ne $2
            ? ()
                : $3;
    }

=head2 list_revs($sha1, $count?, $skip?, \%search?, $file?)

Returns a list of revs for the given head ($sha1).

=cut
    method list_revs ( NonEmptySimpleStr :$sha1!,
                       Int :$count?,
                       Int :$skip?,
                       HashRef :$search?,
                       NonEmptySimpleStr :$file? ) {
        $sha1 = $self->head_hash($sha1)
            if !$sha1 || $sha1 !~ $SHA1RE;

	my @search_opts;
        if ($search) {
            $search->{type} = 'grep'
                if $search->{type} eq 'commit';
            @search_opts = (
                # This seems a little fragile ...
                qq[--$search->{type}=$search->{text}],
                '--regexp-ignore-case',
                $search->{regexp} ? '--extended-regexp' : '--fixed-strings'
            );
        }

        my $output = $self->run_cmd(
            'rev-list',
            '--header',
            (defined $count ? "--max-count=$count" : ()),
            (defined $skip ? "--skip=$skip"       : ()),
            @search_opts,
            $sha1,
            '--',
            ($file ? $file : ()),
        );
        return unless $output;

        my @revs = $self->_parse_rev_list($output);

        return @revs;
    }

=head2 diff($commit, $patch?, $parent?, $file?)

Generate a diff from a given L<Gitalist::Git::Object>.

=cut

    method diff ( Gitalist::Git::Object :$commit!,
                  Bool :$patch?,
                  Maybe[NonEmptySimpleStr] :$parent?,
                  NonEmptySimpleStr :$file?
              ) {
              return $commit->diff( patch => $patch,
                                    parent => $parent,
                                    file => $file);
    }

=head2 reflog(@lorgargs)

Return a list of hashes representing each reflog entry.

FIXME Should this return objects?

=cut
    method reflog (@logargs) {
        my @entries
            =  $self->run_cmd(qw(log -g), @logargs)
                =~ /(^commit.+?(?:(?=^commit)|(?=\z)))/msg;

        #  commit 02526fc15beddf2c64798a947fecdd8d11bf993d
        #  Reflog: HEAD@{14} (The Git Server <git@git.dev.venda.com>)
        #  Reflog message: push
        #  Author: Foo Barsby <fbarsby@example.com>
        #  Date:   Thu Sep 17 12:26:05 2009 +0100
        #
        #      Merge branch 'abc123'

        return map {
            # XXX Stuff like this makes me want to switch to Git::PurePerl
            my($sha1, $type, $author, $date)
                = m{
                       ^ commit \s+ ($SHA1RE)$
                       .*?
                       Reflog[ ]message: \s+ (.+?)$ \s+
                     Author: \s+ ([^<]+) <.*?$ \s+
                   Date: \s+ (.+?)$
               }xms;

            pos($_) = index($_, $date) + length $date;

            # Yeah, I just did that.
            my($msg) = /\G\s+(\S.*)/sg;
            {
                hash    => $sha1,
                type    => $type,
                author  => $author,

                # XXX Add DateTime goodness.
                date    => $date,
                message => $msg,
            }
            ;
        } @entries;
    }

    ## BUILDERS
    method _build__util {
        Gitalist::Git::Util->new(
            project => $self,
        );
    }

    method _build_description {
        my $description = "";
        eval {
            $description = $self->path->file('description')->slurp;
            chomp $description;
        };
        return $description;
    }

    method _build_owner {
        my ($gecos, $name) = (getpwuid $self->path->stat->uid)[6,0];
        $gecos =~ s/,+$//;
        return length($gecos) ? $gecos : $name;
    }

    method _build_last_change {
        my $last_change;
        my $output = $self->run_cmd(
            qw{ for-each-ref --format=%(committer)
                --sort=-committerdate --count=1 refs/heads
          });
        if (my ($epoch, $tz) = $output =~ /\s(\d+)\s+([+-]\d+)$/) {
            my $dt = DateTime->from_epoch(epoch => $epoch);
            $dt->set_time_zone($tz);
            $last_change = $dt;
        }
        return $last_change;
    }

    method _build_heads {
        my @revlines = $self->run_cmd_list(qw/for-each-ref --sort=-committerdate /, '--format=%(objectname)%00%(refname)%00%(committer)', 'refs/heads');
        my @ret;
        for my $line (@revlines) {
            my ($rev, $head, $commiter) = split /\0/, $line, 3;
            $head =~ s!^refs/heads/!!;

            push @ret, { sha1 => $rev, name => $head };

            #FIXME: That isn't the time I'm looking for..
            if (my ($epoch, $tz) = $line =~ /\s(\d+)\s+([+-]\d+)$/) {
                my $dt = DateTime->from_epoch(epoch => $epoch);
                $dt->set_time_zone($tz);
                $ret[-1]->{last_change} = $dt;
            }
        }

        return \@ret;
    }

    method _build_references {
    	# 5dc01c595e6c6ec9ccda4f6f69c131c0dd945f8c refs/tags/v2.6.11
    	# c39ae07f393806ccf406ef966e9a15afc43cc36a refs/tags/v2.6.11^{}
    	my @reflist = $self->run_cmd_list(qw(show-ref --dereference))
            or return;
        my %refs;
        for (@reflist) {
            push @{$refs{$1}}, $2
                if m!^($SHA1RE)\srefs/(.*)$!;
        }

        return \%refs;
    }

    ## Private methods
    method _is_valid_rev (Str $rev) {
        return ($rev =~ /^($SHA1RE)$/);
    }

    method _parse_rev_list ($output) {
        return
            map  $self->get_gpp_object($_),
                grep $self->_is_valid_rev($_),
                    map  split(/\n/, $_, 6), split /\0/, $output;
    }

=head1 SEE ALSO

L<Gitalist::Git::Util> L<Gitalist::Git::Object>

=head1 AUTHORS AND COPYRIGHT

  Catalyst application:
    (C) 2009 Venda Ltd and Dan Brook <dbrook@venda.com>

  Original gitweb.cgi from which this was derived:
    (C) 2005-2006, Kay Sievers <kay.sievers@vrfy.org>
    (C) 2005, Christian Gierke

=head1 LICENSE

FIXME - Is this going to be GPLv2 as per gitweb? If so this is broken..

This library is free software. You can redistribute it and/or modify
it under the same terms as Perl itself.

=cut

} # end class
Commit	Line	Data
56b6dbe6	1	use MooseX::Declare;
56b6dbe6	2
b5b638f7	3	=head1 NAME
b5b638f7	4
894bff59	5	Gitalist::Git::Project - Model of a git repository
b5b638f7	6
	7	=head1 SYNOPSIS
	8
561a3f14	9	my $gitrepo = dir('/repo/base/Gitalist');
	10	my $project = Gitalist::Git::Project->new($gitrepo);
	11	$project->name; # 'Gitalist'
	12	$project->path; # '/repo/base/Gitalist/.git'
	13	$project->description; # 'Unnamed repository.'
b5b638f7	14
	15	=head1 DESCRIPTION
	16
	17	This class models a git repository, referred to in Gitalist
	18	as a "Project".
	19
	20	=cut
	21
38b9e5c8	22	class Gitalist::Git::Project with Gitalist::Git::HasUtils {
56b6dbe6	23	# FIXME, use Types::Path::Class and coerce
56b6dbe6	24	use MooseX::Types::Common::String qw/NonEmptySimpleStr/;
84f31a44	25	use MooseX::Types::Path::Class qw/Dir/;
829d41ed	26	use MooseX::Types::Moose qw/Str Maybe Bool HashRef ArrayRef/;
77edf882	27	use List::MoreUtils qw/any zip/;
b5b638f7	28	use DateTime;
a8a8f8f9	29	use aliased 'Gitalist::Git::Object';
56b6dbe6	30
32a371cc	31	our $SHA1RE = qr/[0-9a-fA-F]{40}/;
	32
	33	around BUILDARGS (ClassName $class: Dir $dir) {
4b6bcf44	34	# Allows us to be called as Project->new($dir)
	35	# Last path component becomes $self->name
	36	# Full path to git objects becomes $self->path
32a371cc	37	my $name = $dir->dir_list(-1);
	38	$dir = $dir->subdir('.git') if (-f $dir->file('.git', 'HEAD'));
	39	confess("Can't find a git repository at " . $dir)
	40	unless ( -f $dir->file('HEAD') );
	41	return $class->$orig(name => $name,
	42	path => $dir);
	43	}
	44
b5b638f7	45	=head1 ATTRIBUTES
	46
	47	=head2 name
	48
cc88eca5	49	The name of the Project. By default, this is derived from the path to the git repository.
29debefd	50
cc88eca5	51	=cut
56b6dbe6	52	has name => ( isa => NonEmptySimpleStr,
01ced85b	53	is => 'ro', required => 1 );
b5b638f7	54
	55	=head2 path
	56
	57	L<Path::Class:Dir> for the location of the git repository.
	58
	59	=cut
84f31a44	60	has path => ( isa => Dir,
01ced85b	61	is => 'ro', required => 1);
56b6dbe6	62
b5b638f7	63	=head2 description
	64
	65	String containing .git/description
	66
	67	=cut
0617cbd0	68	has description => ( isa => Str,
56b6dbe6	69	is => 'ro',
	70	lazy_build => 1,
	71	);
b5b638f7	72
	73	=head2 owner
	74
	75	Owner of the files on disk.
	76
	77	=cut
56b6dbe6	78	has owner => ( isa => NonEmptySimpleStr,
	79	is => 'ro',
	80	lazy_build => 1,
	81	);
b5b638f7	82
	83	=head2 last_change
	84
	85	L<DateTime> for the time of the last update.
	86	undef if the repository has never been used.
	87
	88	=cut
0617cbd0	89	has last_change => ( isa => Maybe['DateTime'],
56b6dbe6	90	is => 'ro',
	91	lazy_build => 1,
	92	);
	93
b5b638f7	94	=head2 is_bare
	95
	96	Bool indicating whether this Project is bare.
	97
	98	=cut
b5b638f7	99	has is_bare => ( isa => Bool,
	100	is => 'ro',
	101	lazy => 1,
	102	default => sub {
	103	-d $_[0]->path->parent->subdir->($_[0]->name)
	104	? 1 : 0
	105	},
	106	);
84f31a44	107
cc88eca5	108	=head2 heads
	109
	110	ArrayRef of hashes containing the name and sha1 of all heads.
	111
	112	=cut
	113	has heads => ( isa => ArrayRef[HashRef],
	114	is => 'ro',
	115	lazy_build => 1);
	116
	117	=head2 references
	118
	119	Hashref of ArrayRefs for each reference.
	120
	121	=cut
	122	has references => ( isa => HashRef[ArrayRef[Str]],
	123	is => 'ro',
	124	lazy_build => 1 );
	125
01ced85b	126	method BUILD {
38b9e5c8	127	$self->$_() for qw/last_change owner description/; # Ensure to build early.
01ced85b	128	}
01ced85b	129
32a371cc	130	=head1 METHODS
8dbe8024	131
cc88eca5	132	=head2 head_hash ($head?)
894bff59	133
32a371cc	134	Return the sha1 for HEAD, or any specified head.
894bff59	135
32a371cc	136	=cut
32a371cc	137	method head_hash (Str $head?) {
	138	my $output = $self->run_cmd(qw/rev-parse --verify/, $head \|\| 'HEAD' );
	139	confess("No such head: " . $head) unless defined $output;
29debefd	140
32a371cc	141	my($sha1) = $output =~ /^($SHA1RE)$/;
32a371cc	142	return $sha1;
56b6dbe6	143	}
56b6dbe6	144
cc88eca5	145	=head2 list_tree ($sha1?)
a8a8f8f9	146
	147	Return an array of contents for a given tree.
	148	The tree is specified by sha1, and defaults to HEAD.
cc88eca5	149	Each item is a L<Gitalist::Git::Object>.
a8a8f8f9	150
a8a8f8f9	151	=cut
a8a8f8f9	152	method list_tree (Str $sha1?) {
	153	$sha1 \|\|= $self->head_hash;
	154
	155	my $output = $self->run_cmd(qw/ls-tree -z/, $sha1);
	156	return unless defined $output;
	157
	158	my @ret;
	159	for my $line (split /\0/, $output) {
	160	my ($mode, $type, $object, $file) = split /\s+/, $line, 4;
	161	push @ret, Object->new( mode => oct $mode,
	162	type => $type,
	163	sha1 => $object,
	164	file => $file,
50394a3e	165	project => $self,
a8a8f8f9	166	);
	167	}
	168	return @ret;
	169	}
	170
cc88eca5	171	=head2 get_object ($sha1)
	172
	173	Return a L<Gitalist::Git::Object> for the given sha1.
	174
	175	=cut
8bb7649b	176	method get_object (NonEmptySimpleStr $sha1) {
894bff59	177	unless ( $self->_is_valid_rev($sha1) ) {
8bb7649b	178	$sha1 = $self->head_hash($sha1);
8bb7649b	179	}
77edf882	180	return Object->new(
54368e9d	181	project => $self,
	182	sha1 => $sha1,
	183	);
	184	}
8bb7649b	185
cc88eca5	186	=head2 hash_by_path($sha1, $path, $type?)
894bff59	187
cc88eca5	188	Returns the sha1 for a given path, optionally limited by type.
	189
	190	=cut
fc11c7f1	191	method hash_by_path ($base, $path = '', $type?) {
54368e9d	192	$path =~ s{/+$}();
32a371cc	193	# FIXME should this really just take the first result?
32a371cc	194	my @paths = $self->run_cmd('ls-tree', $base, '--', $path)
54368e9d	195	or return;
32a371cc	196	my $line = $paths[0];
54368e9d	197
	198	#'100644 blob 0fa3f3a66fb6a137f6ec2c19351ed4d807070ffa panic.c'
	199	$line =~ m/^([0-9]+) (.+) ($SHA1RE)\t/;
	200	return defined $type && $type ne $2
	201	? ()
	202	: $3;
	203	}
	204
cc88eca5	205	=head2 list_revs($sha1, $count?, $skip?, \%search?, $file?)
	206
	207	Returns a list of revs for the given head ($sha1).
	208
	209	=cut
4111e151	210	method list_revs ( NonEmptySimpleStr :$sha1!,
	211	Int :$count?,
	212	Int :$skip?,
	213	HashRef :$search?,
05e8b4d0	214	NonEmptySimpleStr :$file? ) {
4111e151	215	$sha1 = $self->head_hash($sha1)
	216	if !$sha1 \|\| $sha1 !~ $SHA1RE;
	217
	218	my @search_opts;
05e8b4d0	219	if ($search) {
4111e151	220	$search->{type} = 'grep'
	221	if $search->{type} eq 'commit';
	222	@search_opts = (
	223	# This seems a little fragile ...
	224	qq[--$search->{type}=$search->{text}],
	225	'--regexp-ignore-case',
	226	$search->{regexp} ? '--extended-regexp' : '--fixed-strings'
	227	);
	228	}
	229
	230	my $output = $self->run_cmd(
	231	'rev-list',
	232	'--header',
	233	(defined $count ? "--max-count=$count" : ()),
	234	(defined $skip ? "--skip=$skip" : ()),
	235	@search_opts,
	236	$sha1,
	237	'--',
	238	($file ? $file : ()),
	239	);
	240	return unless $output;
	241
cc88eca5	242	my @revs = $self->_parse_rev_list($output);
4111e151	243
	244	return @revs;
	245	}
	246
cc88eca5	247	=head2 diff($commit, $patch?, $parent?, $file?)
cc88eca5	248
1501cb4e	249	Generate a diff from a given L<Gitalist::Git::Object>.
cc88eca5	250
cc88eca5	251	=cut
54368e9d	252
cc88eca5	253	method diff ( Gitalist::Git::Object :$commit!,
77edf882	254	Bool :$patch?,
fc948aee	255	Maybe[NonEmptySimpleStr] :$parent?,
1501cb4e	256	NonEmptySimpleStr :$file?
	257	) {
	258	return $commit->diff( patch => $patch,
	259	parent => $parent,
	260	file => $file);
77edf882	261	}
77edf882	262
cc88eca5	263	=head2 reflog(@lorgargs)
77edf882	264
cc88eca5	265	Return a list of hashes representing each reflog entry.
77edf882	266
cc88eca5	267	FIXME Should this return objects?
54368e9d	268
cc88eca5	269	=cut
d8abdf1c	270	method reflog (@logargs) {
	271	my @entries
	272	= $self->run_cmd(qw(log -g), @logargs)
	273	=~ /(^commit.+?(?:(?=^commit)\|(?=\z)))/msg;
	274
05e8b4d0	275	# commit 02526fc15beddf2c64798a947fecdd8d11bf993d
	276	# Reflog: HEAD@{14} (The Git Server <git@git.dev.venda.com>)
	277	# Reflog message: push
	278	# Author: Foo Barsby <fbarsby@example.com>
	279	# Date: Thu Sep 17 12:26:05 2009 +0100
	280	#
	281	# Merge branch 'abc123'
d8abdf1c	282
	283	return map {
	284	# XXX Stuff like this makes me want to switch to Git::PurePerl
	285	my($sha1, $type, $author, $date)
	286	= m{
	287	^ commit \s+ ($SHA1RE)$
	288	.*?
	289	Reflog[ ]message: \s+ (.+?)$ \s+
	290	Author: \s+ ([^<]+) <.*?$ \s+
	291	Date: \s+ (.+?)$
	292	}xms;
	293
	294	pos($_) = index($_, $date) + length $date;
	295
	296	# Yeah, I just did that.
	297	my($msg) = /\G\s+(\S.*)/sg;
	298	{
	299	hash => $sha1,
	300	type => $type,
	301	author => $author,
	302
	303	# XXX Add DateTime goodness.
	304	date => $date,
	305	message => $msg,
	306	}
	307	;
	308	} @entries;
	309	}
	310
cc88eca5	311	## BUILDERS
32a371cc	312	method _build__util {
	313	Gitalist::Git::Util->new(
	314	project => $self,
	315	);
	316	}
	317
	318	method _build_description {
76c97bf6	319	my $description = "";
5d8568c6	320	eval {
76c97bf6	321	$description = $self->path->file('description')->slurp;
76c97bf6	322	chomp $description;
5d8568c6	323	};
76c97bf6	324	return $description;
32a371cc	325	}
	326
	327	method _build_owner {
	328	my ($gecos, $name) = (getpwuid $self->path->stat->uid)[6,0];
	329	$gecos =~ s/,+$//;
	330	return length($gecos) ? $gecos : $name;
	331	}
	332
	333	method _build_last_change {
	334	my $last_change;
	335	my $output = $self->run_cmd(
	336	qw{ for-each-ref --format=%(committer)
	337	--sort=-committerdate --count=1 refs/heads
	338	});
	339	if (my ($epoch, $tz) = $output =~ /\s(\d+)\s+([+-]\d+)$/) {
	340	my $dt = DateTime->from_epoch(epoch => $epoch);
	341	$dt->set_time_zone($tz);
	342	$last_change = $dt;
	343	}
	344	return $last_change;
	345	}
	346
cc88eca5	347	method _build_heads {
	348	my @revlines = $self->run_cmd_list(qw/for-each-ref --sort=-committerdate /, '--format=%(objectname)%00%(refname)%00%(committer)', 'refs/heads');
	349	my @ret;
	350	for my $line (@revlines) {
	351	my ($rev, $head, $commiter) = split /\0/, $line, 3;
	352	$head =~ s!^refs/heads/!!;
	353
	354	push @ret, { sha1 => $rev, name => $head };
	355
	356	#FIXME: That isn't the time I'm looking for..
	357	if (my ($epoch, $tz) = $line =~ /\s(\d+)\s+([+-]\d+)$/) {
	358	my $dt = DateTime->from_epoch(epoch => $epoch);
	359	$dt->set_time_zone($tz);
	360	$ret[-1]->{last_change} = $dt;
	361	}
	362	}
	363
	364	return \@ret;
	365	}
	366
	367	method _build_references {
	368	# 5dc01c595e6c6ec9ccda4f6f69c131c0dd945f8c refs/tags/v2.6.11
	369	# c39ae07f393806ccf406ef966e9a15afc43cc36a refs/tags/v2.6.11^{}
	370	my @reflist = $self->run_cmd_list(qw(show-ref --dereference))
05e8b4d0	371	or return;
cc88eca5	372	my %refs;
05e8b4d0	373	for (@reflist) {
	374	push @{$refs{$1}}, $2
	375	if m!^($SHA1RE)\srefs/(.*)$!;
	376	}
cc88eca5	377
05e8b4d0	378	return \%refs;
cc88eca5	379	}
	380
	381	## Private methods
	382	method _is_valid_rev (Str $rev) {
	383	return ($rev =~ /^($SHA1RE)$/);
	384	}
	385
	386	method _parse_rev_list ($output) {
	387	return
	388	map $self->get_gpp_object($_),
	389	grep $self->_is_valid_rev($_),
	390	map split(/\n/, $_, 6), split /\0/, $output;
	391	}
	392
b5b638f7	393	=head1 SEE ALSO
	394
	395	L<Gitalist::Git::Util> L<Gitalist::Git::Object>
	396
	397	=head1 AUTHORS AND COPYRIGHT
	398
	399	Catalyst application:
	400	(C) 2009 Venda Ltd and Dan Brook <dbrook@venda.com>
	401
	402	Original gitweb.cgi from which this was derived:
	403	(C) 2005-2006, Kay Sievers <kay.sievers@vrfy.org>
	404	(C) 2005, Christian Gierke
	405
	406	=head1 LICENSE
	407
	408	FIXME - Is this going to be GPLv2 as per gitweb? If so this is broken..
	409
	410	This library is free software. You can redistribute it and/or modify
	411	it under the same terms as Perl itself.
	412
	413	=cut
	414
56b6dbe6	415	} # end class