/ 
Git-Raw-0.37-TRIAL
River stage one • 3 direct dependents • 3 total dependents
/ Git::Raw::Commit

NAME

Git::Raw::Commit - Git commit class

VERSION

version 0.37

SYNOPSIS

use Git::Raw;

# open the Git repository at $path
my $repo = Git::Raw::Repository -> open($path);

# add a file to the repository default index
my $index = $repo -> index;
$index -> add('test');
$index -> write;

# create a new tree out of the repository index
my $tree_id = $index -> write_tree;
my $tree    = $repo -> lookup($tree_id);

# retrieve user's name and email from the Git configuration
my $config = $repo -> config;
my $name   = $config -> str('user.name');
my $email  = $config -> str('user.email');

# create a new Git signature
my $me = Git::Raw::Signature -> now($name, $email);

# create a new commit out of the above tree, with the repository HEAD as
# parent
my $commit = $repo -> commit(
  'some commit', $me, $me, [ $repo -> head -> target ], $tree
);

DESCRIPTION

A Git::Raw::Commit represents a Git commit.

WARNING: The API of this module is unstable and may change without warning (any change will be appropriately documented in the changelog).

METHODS

create( $repo, $msg, $author, $committer, [@parents], $tree [, $update_ref ] )

Create a new commit given a message, two Git::Raw::Signature (one is the commit author and the other the committer), a list of parent commits and a Git::Raw::Tree. If $update_ref is provided and is defined, the reference with the corresponding name is automatically updated or created. If $update_ref is undef, no reference is updated. If $update_ref is not provided, "HEAD" is updated.

lookup( $repo, $id )

Retrieve the commit corresponding to $id. This function is pretty much the same as $repo->lookup($id) except that it only returns commits.

id( )

Retrieve the id of the commit, as string.

message( )

Retrieve the message of the commit.

summary( )

Retrieve the summary of the commit.

author( )

Retrieve the Git::Raw::Signature representing the author of the commit.

committer( )

Retrieve the Git::Raw::Signature representing the committer.

time( )

Retrieve the committer time of the commit.

offset( )

Retrieve the committer time offset (in minutes) of the commit.

tree( )

Retrieve the Git::Raw::Tree the commit points to.

parents( )

Retrieve the list of parents of the commit.

merge( $commit, [ \%merge_opts ])

Merge $commit into this commit. See Git::Raw::Repository->merge() for valid %merge_opts values. Returns a Git::Raw::Index object containing the merge result.

ancestor( $gen )

Retrieve the Git::Raw::Commit object that is the $gen'th generation ancestor of this commit, following only the first parents.

AUTHOR

Alessandro Ghedini <alexbio@cpan.org>

Jacques Germishuys <jacquesg@striata.com>

LICENSE AND COPYRIGHT

Copyright 2012 Alessandro Ghedini.

This program is free software; you can redistribute it and/or modify it under the terms of either: the GNU General Public License as published by the Free Software Foundation; or the Artistic License.

See http://dev.perl.org/licenses/ for more information.