The London Perl and Raku Workshop takes place on 26th Oct 2024. If your company depends on Perl, please consider sponsoring and/or attending.


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


    use Git::Repository 'AUTOLOAD';

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

    $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 );


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



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.


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


Philippe Bruhat (BooK) <>.


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


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