NAME

Pithub - Github v3 API

VERSION

version 0.01005

SYNOPSIS

use Pithub;
use Data::Dumper;

my $p = Pithub->new;
my $result = $p->repos->get( user => 'plu', repo => 'Pithub' );

# $result->content is either an arrayref or an hashref
# depending on the API call that has been made
printf "%s\n", $result->content->{html_url};     # prints https://github.com/plu/Pithub
printf "%s\n", $result->content->{clone_url};    # prints https://github.com/plu/Pithub.git

# if the result is an arrayref, you can use the result iterator
my $result = $p->repos->list( user => 'plu' );
while ( my $row = $result->next ) {
    printf "%s\n", $row->{name};
}

DOCUMENTATION

Quite a lot of the Pithub documentation has been taken directly from the great API documentation at Github. Please also read the documentation there, since it might be more complete and more up-to-date.

WARNING

Pithub as well as the Github v3 API are still under development. So there might be things broken on both sides. Besides that it's possible that the API will change. This applies to Pithub itself as well as the Github v3 API.

MODULES

There are different ways of using the Pithub library. You can either use the main module Pithub to get access to all other modules, like Pithub::Repos for example. Or you can use Pithub::Repos directly and create an instance of it. All modules accept the same attributes, either in the constructor or later by calling the setters.

Besides that there are other modules involved. Every method call which maps directly to a Github API call returns a Pithub::Result object. This contains everything interesting about the response returned from the API call.

Pithub::Base might be interesting for two reasons:

• The list of attributes which all modules accept.

• The request method: In case Github adds a new API call which is not supported yet by Pithub the request method can be used directly to perform this new API call, there's some documentation on how to use it.

  • Pithub::Gists

    See also: http://developer.github.com/v3/gists/

    my $gists = Pithub->new->gists;
    my $gists = Pithub::Gists->new;

    • Pithub::Gists::Comments

      See also: http://developer.github.com/v3/gists/comments/

      my $comments = Pithub->new->gists->comments;
      my $comments = Pithub::Gists->new->comments;
      my $comments = Pithub::Gists::Comments->new;

  • Pithub::GitData

    See also: http://developer.github.com/v3/git/

    my $git_data = Pithub->new->git_data;
    my $git_data = Pithub::GitData->new;

    • Pithub::GitData::Blobs

      See also: http://developer.github.com/v3/git/blobs/

      my $blobs = Pithub->new->git_data->blobs;
      my $blobs = Pithub::GitData->new->blobs;
      my $blobs = Pithub::GitData::Blobs->new;

    • Pithub::GitData::Commits

      See also: http://developer.github.com/v3/git/commits/

      my $commits = Pithub->new->git_data->commits;
      my $commits = Pithub::GitData->new->commits;
      my $commits = Pithub::GitData::Commits->new;

    • Pithub::GitData::References

      See also: http://developer.github.com/v3/git/refs/

      my $references = Pithub->new->git_data->references;
      my $references = Pithub::GitData->new->references;
      my $references = Pithub::GitData::References->new;

    • Pithub::GitData::Tags

      See also: http://developer.github.com/v3/git/tags/

      my $tags = Pithub->new->git_data->tags;
      my $tags = Pithub::GitData->new->tags;
      my $tags = Pithub::GitData::Tags->new;

    • Pithub::GitData::Trees

      See also: http://developer.github.com/v3/git/trees/

      my $trees = Pithub->new->git_data->trees;
      my $trees = Pithub::GitData->new->trees;
      my $trees = Pithub::GitData::Trees->new;

  • Pithub::Issues

    See also: http://developer.github.com/v3/issues/

    my $issues = Pithub->new->issues;
    my $issues = Pithub::Issues->new;

    • Pithub::Issues::Comments

      See also: http://developer.github.com/v3/issues/comments/

      my $comments = Pithub->new->issues->comments;
      my $comments = Pithub::Issues->new->comments;
      my $comments = Pithub::Issues::Comments->new;

    • Pithub::Issues::Events

      See also: http://developer.github.com/v3/issues/events/

      my $events = Pithub->new->issues->events;
      my $events = Pithub::Issues->new->events;
      my $events = Pithub::Issues::Events->new;

    • Pithub::Issues::Labels

      See also: http://developer.github.com/v3/issues/labels/

      my $labels = Pithub->new->issues->labels;
      my $labels = Pithub::Issues->new->labels;
      my $labels = Pithub::Issues::Labels->new;

    • Pithub::Issues::Milestones

      See also: http://developer.github.com/v3/issues/milestones/

      my $milestones = Pithub->new->issues->milestones;
      my $milestones = Pithub::Issues->new->milestones;
      my $milestones = Pithub::Issues::Milestones->new;

  • Pithub::Orgs

    See also: http://developer.github.com/v3/orgs/

    my $orgs = Pithub->new->orgs;
    my $orgs = Pithub::Orgs->new;

    • Pithub::Orgs::Members

      See also: http://developer.github.com/v3/orgs/members/

      my $members = Pithub->new->orgs->members;
      my $members = Pithub::Orgs->new->members;
      my $members = Pithub::Orgs::Members->new;

    • Pithub::Orgs::Teams

      See also: http://developer.github.com/v3/orgs/teams/

      my $teams = Pithub->new->orgs->teams;
      my $teams = Pithub::Orgs->new->teams;
      my $teams = Pithub::Orgs::Teams->new;

  • Pithub::PullRequests

    See also: http://developer.github.com/v3/pulls/

    my $pull_requests = Pithub->new->pull_requests;
    my $pull_requests = Pithub::PullRequests->new;

    • Pithub::PullRequests::Comments

      See also: http://developer.github.com/v3/pulls/comments/

      my $comments = Pithub->new->pull_requests->comments;
      my $comments = Pithub::PullRequests->new->comments;
      my $comments = Pithub::PullRequests::Comments->new;

  • Pithub::Repos

    See also: http://developer.github.com/v3/repos/

    my $repos = Pithub->new->repos;
    my $repos = Pithub::Repos->new;

    • Pithub::Repos::Collaborators

      See also: http://developer.github.com/v3/repos/collaborators/

      my $collaborators = Pithub->new->repos->collaborators;
      my $collaborators = Pithub::Repos->new->collaborators;
      my $collaborators = Pithub::Repos::Collaborators->new;

    • Pithub::Repos::Commits

      See also: http://developer.github.com/v3/repos/commits/

      my $commits = Pithub->new->repos->commits;
      my $commits = Pithub::Repos->new->commits;
      my $commits = Pithub::Repos::Commits->new;

    • Pithub::Repos::Downloads

      See also: http://developer.github.com/v3/repos/downloads/

      my $downloads = Pithub->new->repos->downloads;
      my $downloads = Pithub::Repos->new->downloads;
      my $downloads = Pithub::Repos::Downloads->new;

    • Pithub::Repos::Forks

      See also: http://developer.github.com/v3/repos/forks/

      my $forks = Pithub->new->repos->forks;
      my $forks = Pithub::Repos->new->forks;
      my $forks = Pithub::Repos::Forks->new;

    • Pithub::Repos::Keys

      See also: http://developer.github.com/v3/repos/keys/

      my $keys = Pithub->new->repos->keys;
      my $keys = Pithub::Repos->new->keys;
      my $keys = Pithub::Repos::Keys->new;

    • Pithub::Repos::Watching

      See also: http://developer.github.com/v3/repos/watching/

      my $watching = Pithub->new->repos->watching;
      my $watching = Pithub::Repos->new->watching;
      my $watching = Pithub::Repos::Watching->new;

  • Pithub::Users

    See also: http://developer.github.com/v3/users/

    my $users = Pithub->new->users;
    my $users = Pithub::Users->new;

    • Pithub::Users::Emails

      See also: http://developer.github.com/v3/users/emails/

      my $emails = Pithub->new->users->emails;
      my $emails = Pithub::Users->new->emails;
      my $emails = Pithub::Users::Emails->new;

    • Pithub::Users::Followers

      See also: http://developer.github.com/v3/users/followers/

      my $followers = Pithub->new->users->followers;
      my $followers = Pithub::Users->new->followers;
      my $followers = Pithub::Users::Followers->new;

    • Pithub::Users::Keys

      See also: http://developer.github.com/v3/users/keys/

      my $keys = Pithub->new->users->keys;
      my $keys = Pithub::Users->new->keys;
      my $keys = Pithub::Users::Keys->new;

AUTHOR

Johannes Plunien <plu@cpan.org>

COPYRIGHT AND LICENSE

This software is copyright (c) 2011 by Johannes Plunien.

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