NAME

Git::Raw::Reference - Git reference class

VERSION

version 0.28

DESCRIPTION

A Git::Raw::Reference represents a Git reference.

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

METHODS

lookup( $name, $repo )

Retrieve the reference with name $name in $repo.

create( $name, $repo, $object [, $force] )

Creates and returns a new direct reference named $name in $repo pointing to $object. $object can be a Git::Raw::Blob, Git::Raw::Commit, or a Git::Raw::Tree object. If $force is a truthy value, any existing reference is overwritten. If $force is falsy (the default) and a reference named $name already exists, an error is thrown.

delete( )

Delete the reference. The Git::Raw::Reference object must not be accessed afterwards.

name( )

Retrieve the name of the reference.

type( )

Retrieve the type of the reference. Can be either "direct" or "symbolic".

target( )

Retrieve the target of the reference. This function returns either an object (Git::Raw::Blob, Git::Raw::Commit, Git::Raw::Tag or Git::Raw::Tree) for direct references, or another reference for symbolic references.

owner( )

Retrieve the Git::Raw::Repository owning the reference.

is_branch( )

Check if the reference is a branch.

is_remote( )

Check if the reference is remote.

AUTHOR

Alessandro Ghedini <alexbio@cpan.org>

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.