Skip to content
A Ruby interface to GitHub API v2
Branch: master
Clone or download
fcoury Merge pull request #76 from bitdeli-chef/master
Add a Bitdeli Badge to README
Latest commit 0c0655e Oct 30, 2013
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
contrib Use new .all_issues method. Apr 22, 2009
doc Begin documentation, namespace the *Set classes. Jul 31, 2009
examples
lib Bump to 0.4.5 Jul 6, 2011
real_world_test
test Add tree support, for finding lists of files at a specific revision Jul 6, 2011
.gitignore Ignore .rbc files Jul 6, 2011
.yardoc
CHANGELOG.md Changelogs make it easier to know what happened when. Dec 26, 2009
Gemfile Add Gemfile for easier development May 12, 2011
Gemfile.lock fixing authentication with yml file Jun 2, 2011
LICENSE
README.markdown Add a Bitdeli badge to README Oct 30, 2013
Rakefile Switch to using Bundler for total gem management May 13, 2011
octopi.gemspec Switch to using Bundler for total gem management May 13, 2011
test_auth.rb Send auth parameters along with the request. Aug 24, 2009

README.markdown

octopi

Octopi is a Ruby interface to GitHub API v2 (http://develop.github.com).

To install it as a Gem, just run:

gem install octopi

To include it in your modules or in irb use:

include Octopi

Get notifications via Twitter, following @octopi_gem: http://twitter.com/octopi_gem

Authenticated Usage

Seamless authentication using .gitconfig defaults

If you have your ~/.gitconfig file in place, and you have a [github] section (if you don't, take a look at this GitHub Guides entry, you can use seamless authentication using this method:

authenticated do
  repo = Repository.find(:name => "api-labrat", :user => "fcoury")
end

Explicit authentication

Sometimes, you may not want to get authentication data from ~/.gitconfig. You want to use GitHub API authenticated as a third party. For this use case, you have a couple of options too.

1. Providing login and token inline:

authenticated_with :login => "mylogin", :token => "mytoken" do
  repo = Repository.find(:name => "api-labrat", :user => "fcoury")
  issue = Issue.open :repo => repo, :params => {
    :title => "Sample issue", :body => "This issue was opened using GitHub API and Octopi" }
  puts issue.number
end

2. Providing login and password inline:

authenticated_with :login => "mylogin", :password => "password" do
  repo = Repository.find(:name => "api-labrat", :user => "fcoury")
  issue = Issue.open :repo => repo, :params => {
    :title => "Sample issue", :body => "This issue was opened using GitHub API and Octopi" }
  puts issue.number
end

3. Providing a YAML file with authentication information:

Use the following format:

#
# Octopi GitHub API configuration file
#

# GitHub user login and token
github:
  user: github-username
  token: github-token

# Trace level
# Possible values:
#   false - no tracing, same as if the param is ommited
#   true  - will output each POST or GET operation to the stdout
#   curl  - same as true, but in addition will output the curl equivalent of each command (for debugging)
trace: curl

And change the way you connect to:

authenticated :config => "github.yml") do
  (...)
end

Anonymous Usage

This reflects the usage of the API to retrieve information on a read-only fashion, where the user doesn't have to be authenticated.

Users API

Getting user information

user = User.find("fcoury")
puts "#{user.name} is being followed by #{user.followers.join(", ")} and following #{user.following.join(", ")}"

The bang methods followers! and following! retrieves a full User object for each user login returned, so it has to be used carefully.

user.followers!.each do |u|
  puts "  - #{u.name} (#{u.login}) has #{u.public_repo_count} repo(s)"
end

Searching for user

users = User.find_all("silva")
puts "#{users.size} users found for 'silva':"
users.each do |u|
  puts "  - #{u.name}"
end

Repositories API

repo = user.repository("octopi") # same as: Repository.find("fcoury", "octopi")
puts "Repository: #{repo.name} - #{repo.description} (by #{repo.owner}) - #{repo.url}"
puts "      Tags: #{repo.tags and repo.tags.map {|t| t.name}.join(", ")}"

Search:

repos = Repository.find_all("ruby", "git")
puts "#{repos.size} repository(ies) with 'ruby' and 'git':"
repos.each do |r|
  puts "  - #{r.name}"
end

Issues API integrated into the Repository object:

issue = repo.issues.first
puts "First open issue: #{issue.number} - #{issue.title} - Created at: #{issue.created_at}"

Single issue information:

issue = repo.issue(11)

Commits API information from a Repository object:

first_commit = Commit.find(:user => repo.user, :repo => repo.name, :sha => repo.commits.first.id)
puts "First commit: #{first_commit.id} - #{first_commit.message} - by #{first_commit.author['name']}"

Single commit information:

puts "Diff:"
first_commit.details.modified.each {|m| puts "#{m['filename']} DIFF: #{m['diff']}" }

Author

Contributors

In alphabetical order:

Thanks guys!

Copyright

Copyright (c) 2009 Felipe Coury. See LICENSE for details.

Bitdeli Badge

You can’t perform that action at this time.