View on
MetaCPAN is shutting down
For details read Perl NOC. After June 25th this page will redirect to
Jacob Helwig > Bot-BasicBot-Pluggable-Module-Gitbot-1.00.01 > Bot::BasicBot::Pluggable::Module::Gitbot



Annotate this POD



New  3
Open  0
View/Report Bugs
Module Version: 1.00.01   Source  


Bot::BasicBot::Pluggable::Module::Gitbot - A Bot::BasicBot::Pluggable Module to give out Gitweb links for commits.




    use Bot::BasicBot::Pluggable;

    my $bot = Bot::BasicBot::Pluggable->new();



    !load Gitbot

Once the module is loaded, you'll need to configure the module. Using admin commands.

    !git gitweb_url
    !git repo_root /path/to/where/your/bare/git/repositories/are/

Any time someone says a SHA1 (full, or abbreviated with a minimum of 7 characters) where the bot can hear it, it will try to find a repository under repo_root, and provide a GitWeb url to the commitdiff of that SHA1.

    <me> gitbot: 1a2b3c4
    <gitbot> me: [repo.git 1a2b3c4];a=commitdiff;hb=1a2b3c4

You can also specify things in the form <sha>:<file>, and the module will reply with a link to the blob of that file, in the commit specified by the SHA.

    <me> Hey, you should check out 1a2b3c4:README
    <gitbot> [repo.git 1a2b3c4:README];a=blob;hb=1a2b3c4;f=README [blob]

If you wish you reference a ref from a specific repository, you can do that, too. Just say something in the form of <repo>/<ref>, where <repo> is the name of the repository on disk (optionally without the .git at the end), and <ref> is something parsable by git rev-parse.

    <me> Anyone seen the latest commits on gitbot/master ?
    <gitbot> [gitbot.git master];a=log;hb=master

    <me> Could someone code review project/refs/personal/my-topic-branch ?
    <gitbot> [project.git refs/personal/my-topic-branch];a=log;hb=refs/personal/my-topic-branch

You can also directly link to a file this way using <repo>/<ref>:<file>.

    <me> You should check out project/master:README
    <gitbot> [project.git master:README];a=blob;hb=master;f=README [blob]


Jacob Helwig, <jhelwig at>


Please report any bugs or feature requests to bug-bot-basicbot-pluggable-module-gitbot at, or through the web interface at I will be notified, and then you'll automatically be notified of progress on your bug as I make changes.


You can find documentation for this module with the perldoc command.

    perldoc Bot::BasicBot::Pluggable::Module::Gitbot

You can also look for information at:


Copyright 2010 Jacob Helwig, all rights reserved.

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

syntax highlighting: