igist 0.0.1

data/.gitignore

@@ -0,0 +1,19 @@
+*.gem
+*.rbc
+.bundle
+.config
+.yardoc
+.tags
+.tags_sorted_by_file
+Gemfile.lock
+InstalledFiles
+_yardoc
+coverage
+doc/
+lib/bundler/man
+pkg
+rdoc
+spec/reports
+test/tmp
+test/version_tmp
+tmp

data/Gemfile

@@ -0,0 +1,4 @@
+source 'https://rubygems.org'
+
+# Specify your gem's dependencies in igist.gemspec
+gemspec

data/LICENSE.txt

@@ -0,0 +1,22 @@
+Copyright (c) 2013 Yu Wang <wangyuhere@gmail.com>
+
+MIT License
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README.md

@@ -0,0 +1,31 @@
+# IGist
+
+IGist is a command line tool used to search your gists and starred gists by keyword of gist description. All your gists will be indexed using simple inversed index algorithm. And the index data is saved locally (~/.igist).
+
+## Installation
+
+    $ gem install igist
+
+## Usage
+
+Before search your gists, authorize and index first:
+
+    $ igist -i
+
+Search by keywords in description
+
+    $ igist -s ruby
+    $ igist -s "ruby rails"
+
+For other options
+
+    $ igist -h
+
+
+## Contributing
+
+1. Fork it
+2. Create your feature branch (`git checkout -b my-new-feature`)
+3. Commit your changes (`git commit -am 'Add some feature'`)
+4. Push to the branch (`git push origin my-new-feature`)
+5. Create new Pull Request

data/Rakefile

@@ -0,0 +1,7 @@
+require "bundler/gem_tasks"
+require "rspec/core/rake_task"
+
+RSpec::Core::RakeTask.new
+
+task default: :spec
+task test: :spec

data/bin/igist

@@ -0,0 +1,5 @@
+#!/usr/bin/env ruby
+
+require 'igist'
+
+IGist::CLI.new.run

data/igist.gemspec

@@ -0,0 +1,24 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'igist/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = "igist"
+  spec.version       = IGist::VERSION
+  spec.authors       = ["Yu Wang"]
+  spec.email         = ["wangyuhere@gmail.com"]
+  spec.description   = %q{IGist is a command line tool used to search your gists and starred gists by keyword of gist description.}
+  spec.summary       = %q{Search your gists and starred gists by keyword of gist description}
+  spec.homepage      = "https://github.com/wangyuhere/igist"
+  spec.license       = "MIT"
+
+  spec.files         = `git ls-files`.split($/)
+  spec.executables   = spec.files.grep(%r{^bin/}) { |f| File.basename(f) }
+  spec.test_files    = spec.files.grep(%r{^(test|spec|features)/})
+  spec.require_paths = ["lib"]
+
+  spec.add_development_dependency "bundler", "~> 1.3"
+  spec.add_development_dependency "rake"
+  spec.add_development_dependency "rspec"
+end

data/lib/igist/api.rb

@@ -0,0 +1,106 @@
+module IGist
+  class API
+
+    def initialize(options={})
+      @username = options[:username]
+      @token = options[:token]
+      @api_uri = URI("https://api.github.com")
+    end
+
+    def has_token?
+      !@token.nil?
+    end
+
+    def create_authorization(username, password)
+      request = Net::HTTP::Post.new(authorization_url)
+      request.body = JSON.dump({
+        scopes: [:gist],
+        note: "The igist gem",
+        note_url: ""
+      })
+      request.content_type = "application/json"
+      request.basic_auth(username, password)
+      response = send_request(request)
+
+      if response.is_a?(Net::HTTPUnauthorized) && response["X-GitHub-OTP"]
+        print "two factor authentication code: "
+        otp = $stdin.gets.strip
+        puts ""
+        request["X-GitHub-OTP"] = otp
+        response = send_request(request)
+      end
+
+      if response.is_a?(Net::HTTPCreated)
+        result = JSON.parse(response.body)
+        @token = result["token"]
+        @username = username
+        yield result if block_given?
+      else
+        raise "Can not authorize because: #{response.body}"
+      end
+    end
+
+    def each_my_gist(&block)
+      each_gist(gists_url, &block)
+    end
+
+    def each_starred_gist(&block)
+      each_gist(starred_gists_url, &block)
+    end
+
+    private
+
+    def each_gist(url, &block)
+      request = Net::HTTP::Get.new(url)
+      connection.start do |http|
+        while true
+          response = http.request(request)
+          gists = JSON.parse(response.body)
+          gists.each { |g| block.call(g) }
+          break if response["Links"].nil?
+          if match = response["Links"].match(/<(.*)>;\s*rel=\"next\"/)
+            request = Net::HTTP::Get.new(match.captures[0])
+          else
+            raise "Invalid Links format: #{response['Links']}"
+          end
+        end
+      end
+    end
+
+    def connection
+      connection = Net::HTTP.new(@api_uri.host, @api_uri.port)
+      connection.use_ssl = true
+      connection.verify_mode = OpenSSL::SSL::VERIFY_NONE
+      connection.open_timeout = 10
+      connection.read_timeout = 10
+      connection
+    end
+
+    def send_request(request)
+      connection.start do |http|
+        http.request(request)
+      end
+    end
+
+    def api_url
+      "https://api.github.com"
+    end
+
+    def authorization_url
+      "#{api_url}/authorizations"
+    end
+
+    def gists_url
+      append_token "#{api_url}/users/#{@username}/gists"
+    end
+
+    def starred_gists_url
+      append_token "#{api_url}/gists/starred"
+    end
+
+    def append_token(url)
+      "#{url}?access_token=#{@token}"
+    end
+
+  end
+end

data/lib/igist/cli.rb

@@ -0,0 +1,118 @@
+require "io/console"
+require "optparse"
+require "igist/version"
+require "igist/igist"
+
+module IGist
+
+  class CLI
+
+    def initialize(igist=nil)
+      @igist = igist || IGist.new
+    end
+
+    def run
+      options = {}
+      opts = OptionParser.new do |opt|
+
+        opt.banner = <<-EOS
+Index and search your gists on github.
+
+Note: Run "igist -i" before your first search or if your gists are changed.
+You can also "igist -i -s KEYWORD" to first index and then search.
+
+Usage: igist [-i|-u|-v]
+       igist [-t|-a] -s KEYWORD
+
+Options:
+        EOS
+
+        opt.on("-v", "--version", "Show version") do
+          puts VERSION
+        end
+
+        opt.on("-i", "--index", "Index your gists") do
+          index
+        end
+
+        opt.on("-u", "--auth", "Authorize igist") do
+          authorize
+        end
+
+        opt.on("-s", "--search KEYWORD", "Search your own gists by keyword in description") do |keyword|
+          options[:search] = keyword
+        end
+
+        opt.on("-t", "--starred", "Only your starred gists") do
+          options[:starred] = true
+        end
+
+        opt.on("-a", "--all", "Both your gists and starred gists") do
+          options[:all] = true
+        end
+
+        opt.on("--clear", "Remove your gists index data locally") do
+          clear
+        end
+
+      end
+
+      opts.parse!
+
+      if options[:search]
+        search(options)
+      end
+
+    end
+
+    def authorize
+      puts "Authorize igist and fetch access token from Github."
+      print "Github username: "
+      username = $stdin.gets.strip
+      print "Github password: "
+      password = $stdin.noecho(&:gets).strip
+      puts ""
+
+      @igist.authorize(username, password)
+      puts "Authorized!"
+    end
+
+    def index
+      authorize unless @igist.has_token?
+      puts "Fetching and indexing your gists ..."
+      @igist.index
+      puts "Indexed #{@igist.my_gists.size} gists and #{@igist.starred_gists.size} starred gists!"
+    end
+
+    def search(options)
+      keyword = options[:search]
+
+      unless options[:starred]
+        print_result("My Own Gists", @igist.search(keyword))
+      end
+
+      if options[:all] or options[:starred]
+        print_result("My Starred Gists", @igist.search_starred(keyword))
+      end
+    end
+
+    def clear
+      @igist.clear
+      puts "Your local index files are deleted!"
+    end
+
+    private
+
+    def print_result(title, result)
+      puts "#{title}: "
+      if result.empty?
+        puts "Nothing found."
+      else
+        result.each { |gist| puts "#{gist[:id]} \t #{gist[:description]}" }
+      end
+      puts ""
+    end
+
+  end
+
+end

data/lib/igist/igist.rb

@@ -0,0 +1,107 @@
+require "json"
+require "net/https"
+require "uri"
+require "igist/api"
+require "igist/search"
+
+module IGist
+
+  class IGist
+    include Search
+
+    attr_reader :path, :token_file, :my_gists_file, :my_gists_index_file, :starred_gists_file, :starred_gists_index_file
+
+    def initialize(options={})
+      @path = options[:path] || File.expand_path("~/.igist")
+      @token_file = options[:token_file] || File.join(@path, "token")
+      @my_gists_file = options[:my_gists_file] || File.join(@path, "my_gists")
+      @my_gists_index_file = options[:my_gists_index_file] || File.join(@path, "my_gists_index")
+      @starred_gists_file = options[:starred_gists_file] || File.join(@path, "starred_gists")
+      @starred_gists_index_file = options[:starred_gists_index_file] || File.join(@path, "starred_gists_index")
+      Dir.mkdir(@path) unless File.exists?(@path)
+      @api = options[:api]
+    end
+
+    # igist is authorized or not
+    def has_token?
+      api.has_token?
+    end
+
+    def api
+      if @api.nil?
+        token_json = read_json_file(token_file)
+        @api = API.new({username: token_json['username'], token: token_json['token']})
+      end
+      @api
+    end
+
+    def my_gists
+      @my_gists ||= read_json_file(my_gists_file)
+    end
+
+    def starred_gists
+      @starred_gists ||= read_json_file(starred_gists_file)
+    end
+
+    def my_gists_index
+      @my_gists_index ||= read_json_file(my_gists_index_file)
+    end
+
+    def starred_gists_index
+      @starred_gists_index ||= read_json_file(starred_gists_index_file)
+    end
+
+    # authorize igist and save username and token in token file
+    def authorize(username, password)
+      api.create_authorization(username, password) do |res|
+        write_json_file({username: username, token: res["token"]}, token_file)
+      end
+    end
+
+    # fetch all gists data from api and write data and index files
+    def index
+      @my_gists = {}
+      @starred_gists = {}
+
+      api.each_my_gist { |g| @my_gists[g["id"]] = g["description"]}
+      api.each_starred_gist { |g| @starred_gists[g["id"]] = g["description"]}
+      write_json_file(my_gists, my_gists_file)
+      write_json_file(starred_gists, starred_gists_file)
+
+      @my_gists_index = build_index(my_gists)
+      @starred_gists_index = build_index(starred_gists)
+      write_json_file(my_gists_index, my_gists_index_file)
+      write_json_file(starred_gists_index, starred_gists_index_file)
+    end
+
+    def search(keyword)
+      search_index(my_gists_index, keyword).map { |id| {id: id, description: my_gists[id]} }
+    end
+
+    def search_starred(keyword)
+      search_index(starred_gists_index, keyword).map { |id| {id: id, description: starred_gists[id]} }
+    end
+
+    def clear
+      File.delete(my_gists_file, my_gists_index_file, starred_gists_file, starred_gists_index_file)
+    end
+
+    private
+
+    def read_json_file(file)
+      if File.exists?(file)
+        JSON.parse(File.read(file))
+      else
+        {}
+      end
+    end
+
+    def write_json_file(data, file)
+      File.open(file, 'w', 0600) do |f|
+        f.write(data.to_json)
+      end
+    end
+
+  end
+
+end

data/lib/igist/search.rb

@@ -0,0 +1,35 @@
+require "set"
+
+module IGist
+  module Search
+    def build_index(data)
+      index = {}
+      data.each { |id, desc| add_to_index(index, id, desc) }
+      index.each { |key, value| index[key].uniq! }
+      index
+    end
+
+    def search_index(index, keyword)
+      result = []
+      split_words(keyword).each { |p| result.concat(index[p]) if index.has_key?(p)}
+      result.uniq
+    end
+
+    private
+
+    def add_to_index(index, id, desc)
+      split_words(desc).each do |w|
+        if index.has_key? w
+          index[w] << id
+        else
+          index[w] = [id]
+        end
+      end
+    end
+
+    def split_words(str)
+      str.downcase.split(/\W/).reject { |s| s.empty? }
+    end
+
+  end
+end

data/lib/igist/version.rb

@@ -0,0 +1,3 @@
+module IGist
+  VERSION = "0.0.1"
+end

data/lib/igist.rb

@@ -0,0 +1,3 @@
+require "igist/version"
+require "igist/igist"
+require "igist/cli"

data/spec/fixtures/gists.json

@@ -0,0 +1,170 @@
+[
+  {
+    "url": "https://api.github.com/gists/3976350",
+    "forks_url": "https://api.github.com/gists/3976350/forks",
+    "commits_url": "https://api.github.com/gists/3976350/commits",
+    "id": "3976350",
+    "git_pull_url": "https://gist.github.com/3976350.git",
+    "git_push_url": "https://gist.github.com/3976350.git",
+    "html_url": "https://gist.github.com/3976350",
+    "files": {
+      "gistfile1.py": {
+        "filename": "gistfile1.py",
+        "type": "application/python",
+        "language": "Python",
+        "raw_url": "https://gist.github.com/raw/3976350/34d9d2aaee91d9a9143920520978a7af8aa7cf38/gistfile1.py",
+        "size": 996
+      }
+    },
+    "public": true,
+    "created_at": "2012-10-29T20:34:15Z",
+    "updated_at": "2012-10-29T20:34:15Z",
+    "description": "Python: decorator example",
+    "comments": 0,
+    "user": {
+      "login": "wangyuhere",
+      "id": 507117,
+      "avatar_url": "https://1.gravatar.com/avatar/6180782d31832757305473d48edf3b17?d=https%3A%2F%2Fidenticons.github.com%2F0c8d010a6fd398b2b1c4ef3c635922c6.png",
+      "gravatar_id": "6180782d31832757305473d48edf3b17",
+      "url": "https://api.github.com/users/wangyuhere",
+      "html_url": "https://github.com/wangyuhere",
+      "followers_url": "https://api.github.com/users/wangyuhere/followers",
+      "following_url": "https://api.github.com/users/wangyuhere/following{/other_user}",
+      "gists_url": "https://api.github.com/users/wangyuhere/gists{/gist_id}",
+      "starred_url": "https://api.github.com/users/wangyuhere/starred{/owner}{/repo}",
+      "subscriptions_url": "https://api.github.com/users/wangyuhere/subscriptions",
+      "organizations_url": "https://api.github.com/users/wangyuhere/orgs",
+      "repos_url": "https://api.github.com/users/wangyuhere/repos",
+      "events_url": "https://api.github.com/users/wangyuhere/events{/privacy}",
+      "received_events_url": "https://api.github.com/users/wangyuhere/received_events",
+      "type": "User"
+    },
+    "comments_url": "https://api.github.com/gists/3976350/comments"
+  },
+  {
+    "url": "https://api.github.com/gists/2926498",
+    "forks_url": "https://api.github.com/gists/2926498/forks",
+    "commits_url": "https://api.github.com/gists/2926498/commits",
+    "id": "2926498",
+    "git_pull_url": "https://gist.github.com/2926498.git",
+    "git_push_url": "https://gist.github.com/2926498.git",
+    "html_url": "https://gist.github.com/2926498",
+    "files": {
+      "ubuntu_install.sh": {
+        "filename": "ubuntu_install.sh",
+        "type": "application/sh",
+        "language": "Shell",
+        "raw_url": "https://gist.github.com/raw/2926498/323ee03f4386492a575a913c4a0c1d073727f914/ubuntu_install.sh",
+        "size": 855
+      }
+    },
+    "public": true,
+    "created_at": "2012-06-13T21:04:04Z",
+    "updated_at": "2012-10-07T20:46:24Z",
+    "description": "sh: Install LAMP/nginx/ssh/java on ubuntu server",
+    "comments": 0,
+    "user": {
+      "login": "wangyuhere",
+      "id": 507117,
+      "avatar_url": "https://1.gravatar.com/avatar/6180782d31832757305473d48edf3b17?d=https%3A%2F%2Fidenticons.github.com%2F0c8d010a6fd398b2b1c4ef3c635922c6.png",
+      "gravatar_id": "6180782d31832757305473d48edf3b17",
+      "url": "https://api.github.com/users/wangyuhere",
+      "html_url": "https://github.com/wangyuhere",
+      "followers_url": "https://api.github.com/users/wangyuhere/followers",
+      "following_url": "https://api.github.com/users/wangyuhere/following{/other_user}",
+      "gists_url": "https://api.github.com/users/wangyuhere/gists{/gist_id}",
+      "starred_url": "https://api.github.com/users/wangyuhere/starred{/owner}{/repo}",
+      "subscriptions_url": "https://api.github.com/users/wangyuhere/subscriptions",
+      "organizations_url": "https://api.github.com/users/wangyuhere/orgs",
+      "repos_url": "https://api.github.com/users/wangyuhere/repos",
+      "events_url": "https://api.github.com/users/wangyuhere/events{/privacy}",
+      "received_events_url": "https://api.github.com/users/wangyuhere/received_events",
+      "type": "User"
+    },
+    "comments_url": "https://api.github.com/gists/2926498/comments"
+  },
+  {
+    "url": "https://api.github.com/gists/2926422",
+    "forks_url": "https://api.github.com/gists/2926422/forks",
+    "commits_url": "https://api.github.com/gists/2926422/commits",
+    "id": "2926422",
+    "git_pull_url": "https://gist.github.com/2926422.git",
+    "git_push_url": "https://gist.github.com/2926422.git",
+    "html_url": "https://gist.github.com/2926422",
+    "files": {
+      "install_vmware_tools.sh": {
+        "filename": "install_vmware_tools.sh",
+        "type": "application/sh",
+        "language": "Shell",
+        "raw_url": "https://gist.github.com/raw/2926422/0a446cb5b96fb553cc624f7bc87ccd1cb40d5499/install_vmware_tools.sh",
+        "size": 722
+      }
+    },
+    "public": true,
+    "created_at": "2012-06-13T20:46:03Z",
+    "updated_at": "2012-10-07T20:44:58Z",
+    "description": "sh: Install VMWare Tools Ubuntu Server",
+    "comments": 0,
+    "user": {
+      "login": "wangyuhere",
+      "id": 507117,
+      "avatar_url": "https://1.gravatar.com/avatar/6180782d31832757305473d48edf3b17?d=https%3A%2F%2Fidenticons.github.com%2F0c8d010a6fd398b2b1c4ef3c635922c6.png",
+      "gravatar_id": "6180782d31832757305473d48edf3b17",
+      "url": "https://api.github.com/users/wangyuhere",
+      "html_url": "https://github.com/wangyuhere",
+      "followers_url": "https://api.github.com/users/wangyuhere/followers",
+      "following_url": "https://api.github.com/users/wangyuhere/following{/other_user}",
+      "gists_url": "https://api.github.com/users/wangyuhere/gists{/gist_id}",
+      "starred_url": "https://api.github.com/users/wangyuhere/starred{/owner}{/repo}",
+      "subscriptions_url": "https://api.github.com/users/wangyuhere/subscriptions",
+      "organizations_url": "https://api.github.com/users/wangyuhere/orgs",
+      "repos_url": "https://api.github.com/users/wangyuhere/repos",
+      "events_url": "https://api.github.com/users/wangyuhere/events{/privacy}",
+      "received_events_url": "https://api.github.com/users/wangyuhere/received_events",
+      "type": "User"
+    },
+    "comments_url": "https://api.github.com/gists/2926422/comments"
+  },
+  {
+    "url": "https://api.github.com/gists/2414378",
+    "forks_url": "https://api.github.com/gists/2414378/forks",
+    "commits_url": "https://api.github.com/gists/2414378/commits",
+    "id": "2414378",
+    "git_pull_url": "https://gist.github.com/2414378.git",
+    "git_push_url": "https://gist.github.com/2414378.git",
+    "html_url": "https://gist.github.com/2414378",
+    "files": {
+      "git_commands.sh": {
+        "filename": "git_commands.sh",
+        "type": "application/sh",
+        "language": "Shell",
+        "raw_url": "https://gist.github.com/raw/2414378/048a659535b0595a427a3bed21a71d8e61b0eac5/git_commands.sh",
+        "size": 688
+      }
+    },
+    "public": true,
+    "created_at": "2012-04-18T15:34:11Z",
+    "updated_at": "2013-05-04T09:40:35Z",
+    "description": "git: basic git command",
+    "comments": 0,
+    "user": {
+      "login": "wangyuhere",
+      "id": 507117,
+      "avatar_url": "https://1.gravatar.com/avatar/6180782d31832757305473d48edf3b17?d=https%3A%2F%2Fidenticons.github.com%2F0c8d010a6fd398b2b1c4ef3c635922c6.png",
+      "gravatar_id": "6180782d31832757305473d48edf3b17",
+      "url": "https://api.github.com/users/wangyuhere",
+      "html_url": "https://github.com/wangyuhere",
+      "followers_url": "https://api.github.com/users/wangyuhere/followers",
+      "following_url": "https://api.github.com/users/wangyuhere/following{/other_user}",
+      "gists_url": "https://api.github.com/users/wangyuhere/gists{/gist_id}",
+      "starred_url": "https://api.github.com/users/wangyuhere/starred{/owner}{/repo}",
+      "subscriptions_url": "https://api.github.com/users/wangyuhere/subscriptions",
+      "organizations_url": "https://api.github.com/users/wangyuhere/orgs",
+      "repos_url": "https://api.github.com/users/wangyuhere/repos",
+      "events_url": "https://api.github.com/users/wangyuhere/events{/privacy}",
+      "received_events_url": "https://api.github.com/users/wangyuhere/received_events",
+      "type": "User"
+    },
+    "comments_url": "https://api.github.com/gists/2414378/comments"
+  }
+]

data/spec/fixtures/starred_gists.json

@@ -0,0 +1,170 @@
+[
+  {
+    "url": "https://api.github.com/gists/3976350",
+    "forks_url": "https://api.github.com/gists/3976350/forks",
+    "commits_url": "https://api.github.com/gists/3976350/commits",
+    "id": "3976350",
+    "git_pull_url": "https://gist.github.com/3976350.git",
+    "git_push_url": "https://gist.github.com/3976350.git",
+    "html_url": "https://gist.github.com/3976350",
+    "files": {
+      "gistfile1.py": {
+        "filename": "gistfile1.py",
+        "type": "application/python",
+        "language": "Python",
+        "raw_url": "https://gist.github.com/raw/3976350/34d9d2aaee91d9a9143920520978a7af8aa7cf38/gistfile1.py",
+        "size": 996
+      }
+    },
+    "public": true,
+    "created_at": "2012-10-29T20:34:15Z",
+    "updated_at": "2012-10-29T20:34:15Z",
+    "description": "Python: decorator example",
+    "comments": 0,
+    "user": {
+      "login": "wangyuhere",
+      "id": 507117,
+      "avatar_url": "https://1.gravatar.com/avatar/6180782d31832757305473d48edf3b17?d=https%3A%2F%2Fidenticons.github.com%2F0c8d010a6fd398b2b1c4ef3c635922c6.png",
+      "gravatar_id": "6180782d31832757305473d48edf3b17",
+      "url": "https://api.github.com/users/wangyuhere",
+      "html_url": "https://github.com/wangyuhere",
+      "followers_url": "https://api.github.com/users/wangyuhere/followers",
+      "following_url": "https://api.github.com/users/wangyuhere/following{/other_user}",
+      "gists_url": "https://api.github.com/users/wangyuhere/gists{/gist_id}",
+      "starred_url": "https://api.github.com/users/wangyuhere/starred{/owner}{/repo}",
+      "subscriptions_url": "https://api.github.com/users/wangyuhere/subscriptions",
+      "organizations_url": "https://api.github.com/users/wangyuhere/orgs",
+      "repos_url": "https://api.github.com/users/wangyuhere/repos",
+      "events_url": "https://api.github.com/users/wangyuhere/events{/privacy}",
+      "received_events_url": "https://api.github.com/users/wangyuhere/received_events",
+      "type": "User"
+    },
+    "comments_url": "https://api.github.com/gists/3976350/comments"
+  },
+  {
+    "url": "https://api.github.com/gists/2926498",
+    "forks_url": "https://api.github.com/gists/2926498/forks",
+    "commits_url": "https://api.github.com/gists/2926498/commits",
+    "id": "2926498",
+    "git_pull_url": "https://gist.github.com/2926498.git",
+    "git_push_url": "https://gist.github.com/2926498.git",
+    "html_url": "https://gist.github.com/2926498",
+    "files": {
+      "ubuntu_install.sh": {
+        "filename": "ubuntu_install.sh",
+        "type": "application/sh",
+        "language": "Shell",
+        "raw_url": "https://gist.github.com/raw/2926498/323ee03f4386492a575a913c4a0c1d073727f914/ubuntu_install.sh",
+        "size": 855
+      }
+    },
+    "public": true,
+    "created_at": "2012-06-13T21:04:04Z",
+    "updated_at": "2012-10-07T20:46:24Z",
+    "description": "sh: Install LAMP/nginx/ssh/java on ubuntu server",
+    "comments": 0,
+    "user": {
+      "login": "wangyuhere",
+      "id": 507117,
+      "avatar_url": "https://1.gravatar.com/avatar/6180782d31832757305473d48edf3b17?d=https%3A%2F%2Fidenticons.github.com%2F0c8d010a6fd398b2b1c4ef3c635922c6.png",
+      "gravatar_id": "6180782d31832757305473d48edf3b17",
+      "url": "https://api.github.com/users/wangyuhere",
+      "html_url": "https://github.com/wangyuhere",
+      "followers_url": "https://api.github.com/users/wangyuhere/followers",
+      "following_url": "https://api.github.com/users/wangyuhere/following{/other_user}",
+      "gists_url": "https://api.github.com/users/wangyuhere/gists{/gist_id}",
+      "starred_url": "https://api.github.com/users/wangyuhere/starred{/owner}{/repo}",
+      "subscriptions_url": "https://api.github.com/users/wangyuhere/subscriptions",
+      "organizations_url": "https://api.github.com/users/wangyuhere/orgs",
+      "repos_url": "https://api.github.com/users/wangyuhere/repos",
+      "events_url": "https://api.github.com/users/wangyuhere/events{/privacy}",
+      "received_events_url": "https://api.github.com/users/wangyuhere/received_events",
+      "type": "User"
+    },
+    "comments_url": "https://api.github.com/gists/2926498/comments"
+  },
+  {
+    "url": "https://api.github.com/gists/2926422",
+    "forks_url": "https://api.github.com/gists/2926422/forks",
+    "commits_url": "https://api.github.com/gists/2926422/commits",
+    "id": "2926422",
+    "git_pull_url": "https://gist.github.com/2926422.git",
+    "git_push_url": "https://gist.github.com/2926422.git",
+    "html_url": "https://gist.github.com/2926422",
+    "files": {
+      "install_vmware_tools.sh": {
+        "filename": "install_vmware_tools.sh",
+        "type": "application/sh",
+        "language": "Shell",
+        "raw_url": "https://gist.github.com/raw/2926422/0a446cb5b96fb553cc624f7bc87ccd1cb40d5499/install_vmware_tools.sh",
+        "size": 722
+      }
+    },
+    "public": true,
+    "created_at": "2012-06-13T20:46:03Z",
+    "updated_at": "2012-10-07T20:44:58Z",
+    "description": "sh: Install VMWare Tools Ubuntu Server",
+    "comments": 0,
+    "user": {
+      "login": "wangyuhere",
+      "id": 507117,
+      "avatar_url": "https://1.gravatar.com/avatar/6180782d31832757305473d48edf3b17?d=https%3A%2F%2Fidenticons.github.com%2F0c8d010a6fd398b2b1c4ef3c635922c6.png",
+      "gravatar_id": "6180782d31832757305473d48edf3b17",
+      "url": "https://api.github.com/users/wangyuhere",
+      "html_url": "https://github.com/wangyuhere",
+      "followers_url": "https://api.github.com/users/wangyuhere/followers",
+      "following_url": "https://api.github.com/users/wangyuhere/following{/other_user}",
+      "gists_url": "https://api.github.com/users/wangyuhere/gists{/gist_id}",
+      "starred_url": "https://api.github.com/users/wangyuhere/starred{/owner}{/repo}",
+      "subscriptions_url": "https://api.github.com/users/wangyuhere/subscriptions",
+      "organizations_url": "https://api.github.com/users/wangyuhere/orgs",
+      "repos_url": "https://api.github.com/users/wangyuhere/repos",
+      "events_url": "https://api.github.com/users/wangyuhere/events{/privacy}",
+      "received_events_url": "https://api.github.com/users/wangyuhere/received_events",
+      "type": "User"
+    },
+    "comments_url": "https://api.github.com/gists/2926422/comments"
+  },
+  {
+    "url": "https://api.github.com/gists/2414378",
+    "forks_url": "https://api.github.com/gists/2414378/forks",
+    "commits_url": "https://api.github.com/gists/2414378/commits",
+    "id": "2414378",
+    "git_pull_url": "https://gist.github.com/2414378.git",
+    "git_push_url": "https://gist.github.com/2414378.git",
+    "html_url": "https://gist.github.com/2414378",
+    "files": {
+      "git_commands.sh": {
+        "filename": "git_commands.sh",
+        "type": "application/sh",
+        "language": "Shell",
+        "raw_url": "https://gist.github.com/raw/2414378/048a659535b0595a427a3bed21a71d8e61b0eac5/git_commands.sh",
+        "size": 688
+      }
+    },
+    "public": true,
+    "created_at": "2012-04-18T15:34:11Z",
+    "updated_at": "2013-05-04T09:40:35Z",
+    "description": "git: basic git command",
+    "comments": 0,
+    "user": {
+      "login": "wangyuhere",
+      "id": 507117,
+      "avatar_url": "https://1.gravatar.com/avatar/6180782d31832757305473d48edf3b17?d=https%3A%2F%2Fidenticons.github.com%2F0c8d010a6fd398b2b1c4ef3c635922c6.png",
+      "gravatar_id": "6180782d31832757305473d48edf3b17",
+      "url": "https://api.github.com/users/wangyuhere",
+      "html_url": "https://github.com/wangyuhere",
+      "followers_url": "https://api.github.com/users/wangyuhere/followers",
+      "following_url": "https://api.github.com/users/wangyuhere/following{/other_user}",
+      "gists_url": "https://api.github.com/users/wangyuhere/gists{/gist_id}",
+      "starred_url": "https://api.github.com/users/wangyuhere/starred{/owner}{/repo}",
+      "subscriptions_url": "https://api.github.com/users/wangyuhere/subscriptions",
+      "organizations_url": "https://api.github.com/users/wangyuhere/orgs",
+      "repos_url": "https://api.github.com/users/wangyuhere/repos",
+      "events_url": "https://api.github.com/users/wangyuhere/events{/privacy}",
+      "received_events_url": "https://api.github.com/users/wangyuhere/received_events",
+      "type": "User"
+    },
+    "comments_url": "https://api.github.com/gists/2414378/comments"
+  }
+]

data/spec/igist/igist_spec.rb

@@ -0,0 +1,75 @@
+require "spec_helper"
+require "fileutils"
+
+describe "IGist" do
+
+  let(:igist) {
+    path = File.expand_path("tmp", File.dirname(__FILE__))
+    FileUtils.rm_rf(path)
+    IGist::IGist.new(path: path, api: double("api"))
+  }
+
+  after(:each) do
+    FileUtils.rm_rf(igist.path)
+  end
+
+  shared_context "index" do
+    let(:gists) { load_json_fixture :gists }
+    let(:starred_gists) { load_json_fixture :starred_gists }
+
+    def add_index
+      each_my_gist = receive(:each_my_gist)
+      gists.each { |g| each_my_gist.and_yield(g) }
+      allow(igist.api).to each_my_gist
+
+      each_starred_gist = receive(:each_starred_gist)
+      starred_gists.each { |g| each_starred_gist.and_yield(g) }
+      allow(igist.api).to each_starred_gist
+
+      igist.index
+    end
+  end
+
+  describe "authorize" do
+    it "should call api authorize, save username and token to json file" do
+      token_data = {username: "test", token: "token"}
+      password = "password"
+
+      allow(igist.api).to receive(:create_authorization).with(token_data[:username], password).and_yield("token" => token_data[:token])
+      igist.authorize(token_data[:username], password)
+      expect(File.read(igist.token_file)).to eql(token_data.to_json)
+    end
+  end
+
+  describe "index" do
+    include_context "index"
+    it "should write gists and starred gists data and index files" do
+      add_index
+      expect(File.exists?(igist.my_gists_index_file)).to be_true
+      expect(File.exists?(igist.starred_gists_index_file)).to be_true
+      expect(igist.my_gists.size).to eql(gists.size)
+    end
+  end
+
+  describe "search" do
+    include_context "index"
+    it "should search the gists description based on keyword" do
+      add_index
+      result = igist.search("sh")
+      expect(result.size).to eql(2)
+      expect(result.first[:id]).to eql("2926498")
+      expect(result.last[:id]).to eql("2926422")
+      expect(igist.search_starred("sh").size).to eql(2)
+    end
+  end
+
+  describe "clear" do
+    include_context "index"
+    it "should delete data and index files" do
+      add_index
+      igist.clear
+      files = [:my_gists_file, :my_gists_index_file, :starred_gists_file, :starred_gists_index_file]
+      files.each { |f| expect(File.exists?(igist.send(f))).to be_false }
+    end
+  end
+end

data/spec/igist/search_spec.rb

@@ -0,0 +1,35 @@
+require "spec_helper"
+
+describe "Search" do
+  include IGist::Search
+
+  let(:data) {
+    {
+      "1" => "a b a",
+      "2" => "b c b",
+      "3" => "c"
+    }
+  }
+
+  let(:index) {
+    {
+      "a" => ["1"],
+      "b" => ["1", "2"],
+      "c" => ["2", "3"]
+    }
+  }
+
+  describe "build_index" do
+    it "should build inverse index" do
+      expect(build_index(data)).to eql(index)
+    end
+  end
+
+  describe "search_index" do
+    it "should return correct search result" do
+      expect(search_index(index, "a")).to eql(["1"])
+      expect(search_index(index, "a b")).to eql(["1", "2"])
+      expect(search_index(index, "xxx")).to eql([])
+    end
+  end
+end

data/spec/spec_helper.rb

@@ -0,0 +1,7 @@
+require "igist"
+
+def load_json_fixture(name)
+  path = File.expand_path("fixtures", File.dirname(__FILE__))
+  file = File.join(path, "#{name.to_s}.json")
+  JSON.parse(File.read(file))
+end

metadata

@@ -0,0 +1,125 @@
+--- !ruby/object:Gem::Specification
+name: igist
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+  prerelease: 
+platform: ruby
+authors:
+- Yu Wang
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2013-09-15 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.3'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.3'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+description: IGist is a command line tool used to search your gists and starred gists
+  by keyword of gist description.
+email:
+- wangyuhere@gmail.com
+executables:
+- igist
+extensions: []
+extra_rdoc_files: []
+files:
+- .gitignore
+- Gemfile
+- LICENSE.txt
+- README.md
+- Rakefile
+- bin/igist
+- igist.gemspec
+- lib/igist.rb
+- lib/igist/api.rb
+- lib/igist/cli.rb
+- lib/igist/igist.rb
+- lib/igist/search.rb
+- lib/igist/version.rb
+- spec/fixtures/gists.json
+- spec/fixtures/starred_gists.json
+- spec/igist/igist_spec.rb
+- spec/igist/search_spec.rb
+- spec/spec_helper.rb
+homepage: https://github.com/wangyuhere/igist
+licenses:
+- MIT
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+      segments:
+      - 0
+      hash: -1414565074206882299
+required_rubygems_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+      segments:
+      - 0
+      hash: -1414565074206882299
+requirements: []
+rubyforge_project: 
+rubygems_version: 1.8.25
+signing_key: 
+specification_version: 3
+summary: Search your gists and starred gists by keyword of gist description
+test_files:
+- spec/fixtures/gists.json
+- spec/fixtures/starred_gists.json
+- spec/igist/igist_spec.rb
+- spec/igist/search_spec.rb
+- spec/spec_helper.rb