Sixeight-giic 0.0.1

data/README.rdoc

@@ -0,0 +1,43 @@
+= Giic
+
+== DESCRIPTION:
+
+Giic is a client of the github-issues API interface.
+
+== FEATURES:
+
+search, list, show, open, clone, reopen, edit, label, comment
+
+== USAGE:
+
+  require 'giic'
+
+  giic = Giic.new('Sixeight', 'giic')
+  giic.list.each do |issue|
+    puts issue.title
+  end
+
+  giic.login!('login name', 'api token')
+
+  res = giic.login.open('awsome idea', 'I found that an awsome idea ...')
+  p res.number
+
+  giic.login.with_project(onother) do |user|
+    p user.add_label('bug', 5)
+  end
+
+== REQUIREMENTS:
+
+* Typhoeus
+
+Install:
+
+ gem install pauldix-typhoeus -s http://gems.github.com
+
+== TODO:
+
+* Write a test
+* Write a document
+* Error handling
+* and more more more
+

data/Rakefile

@@ -0,0 +1,52 @@
+require 'spec/rake/spectask'
+
+Spec::Rake::SpecTask.new do |t|
+  t.spec_files = FileList['spec/*_spec.rb']
+  t.spec_opts = ['-c']
+end
+
+desc 'Run specs(default)'
+task :default => :spec
+
+namespace :gem do
+  desc 'Generate gemspec'
+  task :gemspec do |t|
+    require 'lib/giic'
+    File.open('giic.gemspec', "wb" ) do |file|
+      file << <<-EOS.gsub(/^ {8}/, '')
+
+        Gem::Specification.new do |s|
+          s.name = 'giic'
+          s.version = '#{Giic::VERSION}'
+
+          s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
+          s.authors = ['Tomohiro Nishimura']
+          s.date = #{Time.now.strftime('%Y-%m-%d')}
+          s.email = 'tomohiro68@gmail.com'
+          s.files = %w( #{FileList['lib/**/*.rb'].join(' ')}
+                        #{FileList['bin/*'].join(' ')}
+                        #{FileList['spec/**/*.rb'].join(' ')}
+                        README.rdoc
+                        Rakefile )
+          s.executable = 'giic'
+          s.add_dependency('pauldix-typhoeus', '>= 0.0.8')
+          s.homepage = 'http://wiki.github.com/Sixeigh/giic'
+          s.has_rdoc = true
+          s.rdoc_options = ['--main', 'README.rdoc', '--exclude', 'spec']
+          s.extra_rdoc_files = ['README.rdoc']
+          s.summary = 'A github-issues API interface client.'
+          s.description = 'Giic is a client of github-issues API interface'
+          s.rubygems_version = '#{`gem --version`.chomp}'
+        end
+
+      EOS
+    end
+    puts "Generate gemspec"
+  end
+
+  desc 'Build the gem'
+  task :build => :gemspec do |t|
+    system 'gem', 'build', 'giic.gemspec'
+  end
+end
+

data/bin/giic

@@ -0,0 +1,66 @@
+#! /usr/bin/env ruby
+# -*- coding: utf-8 -*-
+
+$KCODE = 'utf-8' unless ''.respond_to? :chr
+
+require File.dirname(__FILE__) + '/../lib/giic'
+require 'pp'
+
+puts "iGiic version 0.0.1 (Giic #{Giic::VERSION})"
+loop do
+  begin
+    print '> '
+    case command = gets.chomp
+    when /^set/
+      _, user, repo = command.split
+      user or (print('user = '); user = gets.chomp)
+      repo or (print('repo = '); repo = gets.chomp)
+      @giic = Giic.new(user, repo)
+      puts 'done'
+    when /^login/
+      unless @giic
+        warn 'you have to call "set"'
+        next
+      end
+      _, login, token = command.split
+      login or (print('login = '); login = gets.chomp)
+      token or (print('token = '); token = gets.chomp)
+      @giic.login!(login, token)
+      @__login = true
+      puts 'done'
+    when 'exit', 'e', 'quit', 'q'
+      break
+    when /^list/, /^show/, /^search/
+      unless @giic
+        warn 'you have to call "set"'
+        next
+      end
+      action, *args = command.split
+      pp @giic.__send__(action, *args)
+    when 'help'
+      @help ||= %w[
+        set login help exit quit
+        search list show open close
+        reopen edit label add_label
+        remove_label comment
+      ]
+      puts @help
+    when /^open/, /^close/, /^reopen/, /^edit/, /^label/, /^add_label/, /^remove_label/, /^comment/
+      unless @__login
+        warn 'you have to call "set"' unless @giic
+        warn 'you have to call "login"'
+        next
+      end
+      action, *args = command.split
+      pp @giic.login.__send__(action, *args)
+    else
+      warn "no such command: #{command}"
+    end
+  rescue Giic::APIError => e
+    warn e
+  rescue => e
+    warn e
+  end
+end
+puts 'bye'
+

data/lib/giic.rb

@@ -0,0 +1,206 @@
+#! /usr/bin/env ruby
+# -*- coding: utf-8 -*-
+
+require 'rubygems'
+require 'typhoeus'
+require 'yaml'
+
+# TODO: must find a better way to get same result
+class Hash # :nodoc:
+  module CoreExt # :nodoc
+    def method_missing(meth, *args)
+      if value = self[meth] || self[meth.to_s]
+        return value
+      end
+      super
+    end
+  end
+  include CoreExt
+end
+
+#
+# == Giic
+#
+# Giic is a client of the github-issues API interface.
+#
+class Giic
+
+  VERSION = '0.0.1'
+
+  attr_reader :user, :repo
+
+  class APIError < Exception
+    attr_reader :responce, :backtrace
+    def initialize(responce, backtrace)
+      @responce, @backtrace = responce, backtrace
+      super responce['error'].first['error']
+    end
+    def inspect; message end
+  end
+
+  def initialize(user, repo)
+    @user, @repo = user, repo
+  end
+
+  # search issue
+  # #=> issues
+  def search(query, state = 'open')
+    back :issues, Core.search(:user => @user, :repo => @repo, :state => state, :search_term => query)
+  end
+
+  # list issues
+  # #=> issues
+  def list(state = 'open')
+    back :issues, Core.list(:user => @user, :repo => @repo, :state => state)
+  end
+
+  # show specific issue
+  # #=> issue
+  def show(number)
+    back :issue, Core.show(:user => @user, :repo => @repo, :number => number)
+  end
+
+  # get user instance for POST request
+  # #=> Instance of Giic::User
+  def login(login = nil, token = nil)
+    unless [login, token].all?
+      raise 'You must login at least onece' unless @login_user
+      return @login_user
+    end
+    User.new login, token, self
+  end
+
+  # login github
+  def login!(login, token)
+    @login_user = login(login, token)
+  end
+
+  def back(default, result) # :nodoc:
+    if result.has_key? 'error'
+      raise APIError.new(result, caller)
+    end
+    result[default.to_s]
+  end
+
+  class User
+    def initialize(login, token, project)
+      @login, @token = login, token
+      @project = project
+    end
+
+    # open new issue
+    # #=> issue
+    def open(title, body)
+      back :issue, Giic::Core.open(:user => @project.user, :repo => @project.repo,
+                                   :params => { :title => title, :body => body }.merge(authentication_data))
+    end
+
+    # close issue
+    # #=> issue
+    def close(number)
+      back :issue, Giic::Core.close(:user => @project.user, :repo => @project.repo, :number => number,
+                                    :params => authentication_data)
+    end
+
+    # reopen issue
+    # #=> issue
+    def reopen(number)
+      back :issue, Giic::Core.reopen(:user => @project.user, :repo => @project.repo, :number => number,
+                                     :params => authentication_data)
+    end
+
+    # edit issue
+    # #=> issue
+    def edit(number, body, title = nil)
+      edit_data = { :body => body }
+      edit_data.merge!(:title => title) if title
+      back :issue, Giic::Core.edit(:user => @project.user, :repo => @project.repo, :number => number,
+                                   :params => edit_data.merge(authentication_data))
+    end
+
+    # to operate label for issue
+    # #=> labels
+    def label(operate, label, number)
+      back :labels, Giic::Core.label(:user => @project.user, :repo => @project.repo, :number => number,
+                                     :operate => operate, :label => label,
+                                     :params => authentication_data)
+    end
+
+    # add label to issue
+    # #=> labels
+    def add_label(label, number)
+      label 'add', label, number
+    end
+
+    # remove label from issue
+    # #=> labels
+    def remove_label(label, number)
+      label 'remove', label, number
+    end
+
+    # post comment to issue
+    # #=> comment
+    def comment(number, comment)
+      back :comment, Giic::Core.comment(:user => @project.user, :repo => @project.repo, :number => number,
+                                         :params => { :comment => comment }.merge(authentication_data))
+    end
+
+    def change_project!(project)
+      raise 'project must be instance of Giic'  unless project.instance_of? Giic
+      @project = project
+    end
+
+    # swap using project temporarily. e.g.)
+    #
+    #  proj.login.with_project({:repo => 'other'}) do |user|
+    #    user.open('new issue', 'I have a lot of bugs')
+    #  end
+    def with_project(project)
+      original = @project
+      @project = case project
+        when Giic
+          project
+        when Hash
+          user = project[:user] || original.user
+          repo = project[:repo] || original.repo
+          Giic.new user, repo
+        else
+          raise 'project must be instance of Giic or Hash'
+        end
+      yield self
+    ensure
+      @project = original
+    end
+
+    private
+
+    def authentication_data # :nodoc:
+      { :login => @login, :token => @token }
+    end
+
+    def back(default, result) # :nodoc:
+      @project.back default, result
+    end
+  end
+
+  # Core class is the Giic core that using Typhoeus library
+  class Core
+    include Typhoeus
+    remote_defaults :base_uri   => 'http://github.com/api/v2/yaml/issues',
+                    :on_success => lambda {|responce| YAML.load(responce.body) },
+                    :on_failure => lambda {|responce| { 'error' => { 'error'    => 'connection error',
+                                                                     'responce' => responce,
+                                                                     'code'     => responce.code }}}
+
+    define_remote_method :search,  :path => '/search/:user/:repo/:state/:search_term'
+    define_remote_method :list,    :path => '/list/:user/:repo/:state'
+    define_remote_method :show,    :path => '/show/:user/:repo/:number'
+    define_remote_method :open,    :path => '/open/:user/:repo',                          :method => 'post'
+    define_remote_method :close,   :path => '/close/:user/:repo/:number',                 :method => 'post'
+    define_remote_method :reopen,  :path => '/reopen/:user/:repo/:number',                :method => 'post'
+    define_remote_method :edit,    :path => '/edit/:user/:repo/:number',                  :method => 'post'
+    define_remote_method :label,   :path => '/label/:operate/:user/:repo/:label/:number', :method => 'post'
+    define_remote_method :comment, :path => '/comment/:user/:repo/:number',               :method => 'post'
+  end
+end
+

data/spec/giic_spec.rb

@@ -0,0 +1,42 @@
+require File.dirname(__FILE__) + '/spec_helper'
+
+# TODO: need more test code
+class Giic
+
+  describe Giic do
+    %w[ search list show ].each do |meth|
+      instance_eval <<-EOS
+        it "has #{meth} method" do
+          Giic.instance_methods.should be_include('#{meth}')
+        end
+      EOS
+    end
+
+    describe User do
+      %w[
+        open close reopen edit label
+        comment add_label remove_label
+      ].each do |meth|
+        instance_eval <<-EOS
+          it "has #{meth} method" do
+            User.instance_methods.should be_include('#{meth}')
+          end
+        EOS
+      end
+    end
+
+    describe Core do
+      %w[
+        search list show open close
+        reopen edit label comment
+      ].each do |meth|
+        instance_eval <<-EOS
+          it "ihas #{meth} method" do
+            Core.should respond_to :#{meth}
+          end
+        EOS
+      end
+    end
+  end
+end
+

data/spec/spec_helper.rb

@@ -0,0 +1,2 @@
+require File.dirname(__FILE__) + '/../giic'
+

metadata

@@ -0,0 +1,70 @@
+--- !ruby/object:Gem::Specification 
+name: Sixeight-giic
+version: !ruby/object:Gem::Version 
+  version: 0.0.1
+platform: ruby
+authors: 
+- Tomohiro Nishimura
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2009-04-08 00:00:00 -07:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: pauldix-typhoeus
+  type: :runtime
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: 0.0.8
+    version: 
+description: Giic is a client of github-issues API interface
+email: tomohiro68@gmail.com
+executables: 
+- giic
+extensions: []
+
+extra_rdoc_files: 
+- README.rdoc
+files: 
+- lib/giic.rb
+- bin/giic
+- spec/giic_spec.rb
+- spec/spec_helper.rb
+- README.rdoc
+- Rakefile
+has_rdoc: true
+homepage: http://wiki.github.com/Sixeigh/giic
+post_install_message: 
+rdoc_options: 
+- --main
+- README.rdoc
+- --exclude
+- spec
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+requirements: []
+
+rubyforge_project: 
+rubygems_version: 1.2.0
+signing_key: 
+specification_version: 2
+summary: A github-issues API interface client.
+test_files: []
+