rubhub

rubhub - Ruby Gem for the Github API

A minimal Ruby Gem created for making interaction with the Github API(v3) easy and predictable.

http://developer.github.com/v3/

Installation

gem install rubhub

Basic Authentication

Use a username and password associated with a Github account.

Example:

require 'rubhub'
g = Github.new( username, password )

Making Requests

Use the API documentation as a reference. The library is structured exactly like the API v3 documentation.

Example Request for Authenticated User's Data

response = g.users.getUser()

The response...

{
    "type": "User",
    "url": "https://api.github.com/users/username",
    "private_gists": 2,
    "created_at": "2011-07-07T22:20:48Z",
    "email": "[e-mail]",
    "html_url": "https://github.com/username",
    "gravatar_id": "123123123123123123123123123",
    "collaborators": 1,
    "hireable": false,
    "disk_usage": 13348,
    "total_private_repos": 3,
    "following": 4,
    "blog": "http://www.yoursitename.com/",
    "bio": null,
    "avatar_url": "https://www.avatar.com/pathtoyouravatar.png",
    "login": "username",
    "owned_private_repos": 3,
    "followers": 1,
    "name": "Your Name",
    "plan": {
        "private_repos": 10,
        "collaborators": 3,
        "space": 614400,
        "name": "micro"
    },
    "location": "Your City, NY",
    "id": 902312,
    "public_repos": 0,
    "public_gists": 17,
    "company": "Your Company Name, LLC"
}

Example Request Creating a New Repository

# Using just the new Repo name
response = g.repos.createUserRepo( "MyNewRepo" )

# Using some other parameters
name = 'MyNewRepo'
desc = 'Some description.'
page = 'www.homepage.com'
private = TRUE
has_issues = TRUE
has_wiki = TRUE
has_downloads = TRUE
response = g.repos.createUserRepo( name, desc, page, private, has_issues, has_wiki, has_downloads )

The response...

{
    "url": "https://api.github.com/repos/username/MyNewRepo",
    "watchers": 1,
    "has_issues": true,
    "created_at": "2012-02-14T03:40:49Z",
    "html_url": "https://github.com/username/MyNewRepo",
    "has_downloads": true,
    "ssh_url": "[e-mail]:username/MyNewRepo.git",
    "svn_url": "https://github.com/username/MyNewRepo",
    "description": "Some description.",
    "mirror_url": null,
    "clone_url": "https://github.com/username/MyNewRepo.git",
    "forks": 1,
    "fork": false,
    "has_wiki": true,
    "private": True,
    "homepage": "www.homepage.com",
    "size": 0,
    "updated_at": "2012-02-14T03:40:49Z",
    "owner": {
        "url": "https://api.github.com/users/username",
        "avatar_url": "https://secure.gravatar.com/avatar/someimage.png",
        "gravatar_id": "948f18791231231231231231231",
        "login": "username",
        "id": 901650
    },
    "name": "MyNewRepo",
    "open_issues": 0,
    "master_branch": null,
    "pushed_at": null,
    "id": 3436770,
    "git_url": "git://github.com/username/MyNewRepo.git",
    "language": null
}