View on
MetaCPAN is shutting down
For details read Perl NOC. After June 25th this page will redirect to
Alessandro Ghedini > Git-Raw > Git::Raw::Reference



Annotate this POD


View/Report Bugs
Module Version: 0.33   Source   Latest Release: Git-Raw-0.79


Git::Raw::Reference - Git reference class


version 0.33


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).


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( [$new_target] )

Retrieve the target of the reference. If the $new_target parameter of type Git::Raw::Reference is passed, the reference will be changed to point to it.

Note that updating the target will invalidate all existing handles to 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.

reflog( )

Retrieve the Git::Raw::Reflog of the reference. Shortcur for Git::Raw::Reflog->open().

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.


Alessandro Ghedini <>


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 for more information.

syntax highlighting: