Git::Repository::Plugin::AUTOLOAD(3)

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.