NAME

Git::Repository::Plugin::AUTOLOAD - Git subcommands as Git::Repository methods

SYNOPSIS

use Git::Repository 'AUTOLOAD';

my $r = Git::Repository->new();

$r->add($file);
$r->commit( '-m' => 'message' );

# NOTE: might be overridden by the 'Log' plugin
my $log = $r->log('-1');

# use "_" for "-" in command names
my $sha1 = $r->rev_parse('master');

# can be used as a class method
Git::Repository->clone( $url );

DESCRIPTION

This module adds an AUTOLOAD method to Git::Repository, enabling it to automagically call git commands as methods on Git::Repository objects.

METHODS

AUTOLOAD

Any method call caught by AUTOLOAD will simply turn all _ (underscore) into - (dash), and call run() on the invocant, with the transformed method name as the first parameter.

For example:

my $sha1 = $r->rev_parse('master');

does exactly the same thing as:

my $sha1 = $r->run( 'rev-parse', 'master' );

All parameters to the original method call are kept, so these autoloaded methods can take option hashes.

Note that AUTOLOAD does not install methods in the invocant class (but what's the cost of a Perl subroutine call compared to forking a git subprocess?), so that plugins adding new methods always take precedence.

SEE ALSO

Git::Repository, Git::Repository::Plugin.

AUTHOR

Philippe Bruhat (BooK) <book@cpan.org>.

COPYRIGHT

Copyright 2014-2016 Philippe Bruhat (BooK), all rights reserved.

LICENSE

This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.