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.