gem-search 0.0.2

data/.gitignore

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

data/Gemfile

@@ -0,0 +1,2 @@
+source 'https://rubygems.org'
+gemspec

data/LICENSE

@@ -0,0 +1,22 @@
+Copyright (c) 2012 rochefort
+
+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,84 @@
+# gem-search
+
+gem-search is a command line utitlity like rubygems('gem search').  
+You can see a download total gem and sort columns.
+
+
+## Installation
+
+install it yourself as:
+
+    $ gem install gem-search
+
+## Usage
+
+Use the gem-search as follows:
+
+### Sorted by gem name
+	gem-search `keyword'
+
+e.g.:
+
+```
+$ gem-search webkit
+NAME                                                DL(ver)   DL(all)
+-------------------------------------------------- -------- ---------
+capybara-webkit (0.12.1)                              24863    185214
+capybara-webkit-remote (0.0.4)                          209       838
+gtk-webkit-ruby (0.0.3)                                 289       289
+guard-jasmine-headless-webkit (0.3.2)                 11964     17872
+intentmedia-capybara-webkit (0.7.2.4)                   370      1362
+jasmine-headless-webkit (0.8.4)                       19444     46147
+otherinbox-capybara-webkit (0.12.0.1)                   594       740
+rspec-formatter-webkit (2.2.0)                          438      3549
+webkit-rspec-formatter (2.0.2)                          613      1573
+```
+
+### Sorted by DL(ver)
+	gem-search `keyword' -s v
+
+e.g.:
+
+```
+$ gem-search factory-girl -s v
+NAME                                                DL(ver)   DL(all)
+-------------------------------------------------- -------- ---------
+capybara-webkit (0.12.1)                              24863    185214
+jasmine-headless-webkit (0.8.4)                       19444     46147
+guard-jasmine-headless-webkit (0.3.2)                 11964     17872
+webkit-rspec-formatter (2.0.2)                          613      1573
+otherinbox-capybara-webkit (0.12.0.1)                   594       740
+rspec-formatter-webkit (2.2.0)                          438      3549
+intentmedia-capybara-webkit (0.7.2.4)                   370      1362
+gtk-webkit-ruby (0.0.3)                                 289       289
+capybara-webkit-remote (0.0.4)                          209       838
+```
+
+### Sorted by DL(all)
+
+	gem-search `keyword' -s a
+
+e.g.:
+
+```
+$ gem-search webkit -s a
+NAME                                                DL(ver)   DL(all)
+-------------------------------------------------- -------- ---------
+capybara-webkit (0.12.1)                              24863    185214
+jasmine-headless-webkit (0.8.4)                       19444     46147
+guard-jasmine-headless-webkit (0.3.2)                 11964     17872
+rspec-formatter-webkit (2.2.0)                          438      3549
+webkit-rspec-formatter (2.0.2)                          613      1573
+intentmedia-capybara-webkit (0.7.2.4)                   370      1362
+capybara-webkit-remote (0.0.4)                          209       838
+otherinbox-capybara-webkit (0.12.0.1)                   594       740
+gtk-webkit-ruby (0.0.3)                                 289       289
+```
+
+## Contributing
+
+1. Fork it
+2. Create your feature branch (`git checkout -b my-new-feature`)
+3. Commit your changes (`git commit -am 'Added some feature'`)
+4. Push to the branch (`git push origin my-new-feature`)
+5. Create new Pull Request

data/Rakefile

@@ -0,0 +1,2 @@
+#!/usr/bin/env rake
+require "bundler/gem_tasks"

data/bin/gem-search

@@ -0,0 +1,35 @@
+#!/usr/bin/env ruby
+require 'slop'
+
+def opt_description(msgs)
+  ind = ' ' * 22
+  msgs.inject { |rtn, msg| rtn << "\n#{ind}#{msg}" }
+end
+
+opts = Slop.parse(help: true) do
+  banner "Usage: gem-search gem_name [options]\n"
+  on :s, :sort, opt_description([
+      'Sort by name of item.',
+      '  [n]ame (default)',
+      '  [v]er  (displayed name: DL(ver))',
+      '  [a]ll  (displayed name: DL(all))'
+    ]), :argument => :optional
+  on :v, :version, 'Display the version.'
+end
+
+OPT_SORT = {
+  'v' => 'version_downloads',
+  'a' => 'downloads',
+}
+
+exit if opts['h']
+
+$:.unshift File.dirname(__FILE__) + '/../lib'
+require 'gem-search'
+if opts['v']
+  puts "gem-search #{Gem::Search::VERSION}"
+  exit
+end
+
+gs = Gem::Search::CLI.new
+gs.search(ARGV[0], OPT_SORT[opts['sort']])

data/gem-search.gemspec

@@ -0,0 +1,22 @@
+# -*- encoding: utf-8 -*-
+require File.expand_path('../lib/gem-search/version', __FILE__)
+
+Gem::Specification.new do |gem|
+  gem.authors       = ["rochefort"]
+  gem.email         = ["terasawan@gmail.com"]
+  gem.homepage      = "https://github.com/rochefort/gem-search"
+  gem.summary       = "search gems with using rubygems.org API"
+  gem.description   = gem.summary
+
+  gem.files         = `git ls-files`.split($\)
+  gem.executables   = gem.files.grep(%r{^bin/}).map{ |f| File.basename(f) }
+  gem.test_files    = gem.files.grep(%r{^(test|spec|features)/})
+  gem.name          = "gem-search"
+  gem.require_paths = ["lib"]
+  gem.version       = Gem::Search::VERSION
+
+  gem.add_dependency 'slop'
+  gem.add_dependency 'json'
+
+  gem.add_development_dependency 'webmock'
+end

data/lib/gem-search.rb

@@ -0,0 +1,2 @@
+require 'gem-search/version'
+require 'gem-search/cli'

data/lib/gem-search/cli.rb

@@ -0,0 +1,67 @@
+require 'json'
+require 'open-uri'
+
+module Gem::Search
+  class CLI
+    BASE_URL   = 'https://rubygems.org'
+    SEARCH_URL = "#{BASE_URL}/api/v1/search.json?query="
+    DEFAULT_RULED_LINE_SIZE = [50, 8, 9]
+
+    def search(query, opt_sort='name')
+      return unless query
+
+      opt_sort ||= 'name'
+      url = "#{SEARCH_URL}#{query}"
+      
+      begin  
+        open(url) do |f|
+          gems = JSON.parse(f.read)
+          if gems.size.zero?
+            puts 'We did not find results.'
+            return
+          end
+          fmt_size = ruled_line_size(gems)
+          gems_sort!(gems, opt_sort)
+          render_header(fmt_size)
+          render_body(gems, fmt_size)
+        end
+      rescue
+        puts 'An unexpected Network error has occurred.'
+      end
+    end
+
+    private
+      def ruled_line_size(gems)
+        line_size = DEFAULT_RULED_LINE_SIZE.dup
+        max_name_size = gems.map { |gem| "#{gem['name']} (#{gem['version']})".size }.max
+        line_size[0] =  max_name_size if max_name_size > line_size[0]
+        line_size
+      end
+
+      def gems_sort!(gems, opt_sort)
+        if opt_sort == 'name'
+          gems.sort!{ |x,y| x[opt_sort] <=> y[opt_sort] }
+        else
+          gems.sort!{ |x,y| y[opt_sort] <=> x[opt_sort] }
+        end
+      end
+
+      def render_header(f)
+        fmt = "%-#{f[0]}s %#{f[1]}s %#{f[2]}s"
+        puts fmt % ['NAME', 'DL(ver)', 'DL(all)']
+        puts fmt % ['-'*f[0], '-'*f[1], '-'*f[2]]
+      end
+
+      def render_body(gems, f)
+        fmt = "%-#{f[0]}s %#{f[1]}d %#{f[2]}d"
+        gems.each do |gem|
+          puts fmt % [
+            "#{gem['name']} (#{gem['version']})",
+            gem['version_downloads'],
+            gem['downloads']
+          ]
+        end
+      end
+
+  end
+end

data/lib/gem-search/version.rb

@@ -0,0 +1,3 @@
+module Gem::Search
+  VERSION = "0.0.2"
+end

data/spec/cli_spec.rb

@@ -0,0 +1,197 @@
+require 'spec_helper'
+
+describe Gem::Search::CLI do
+  describe '#search' do
+    before do
+      @cli = Gem::Search::CLI.new
+      stub_request(:get, build_search_uri('factory_girl')).
+        to_return(:status => 200, :body => dummy_search_result)
+    end
+
+    context 'when a network error occurred' do
+      before do
+        stub_request(:get, build_search_uri('network_error_orccurred')).
+          to_return(:status => 500, :body => '[]')
+      end
+      it 'should display a network error message' do
+        capture(:stdout) { @cli.search('network_error_orccurred') }.should == "An unexpected Network error has occurred.\n"
+      end
+    end
+
+    context 'with nonexistence gem' do
+      before do
+        stub_request(:get, build_search_uri('no_match_gem_name')).
+          to_return(:status => 200, :body => '[]')
+      end
+      it 'should display a nonexistence message' do
+        capture(:stdout) { @cli.search('no_match_gem_name') }.should == "We did not find results.\n"
+      end
+    end
+
+    context 'with existing gem' do
+      context 'with no sort option' do
+        it 'should display rubygems ordering by name' do
+          capture(:stdout) { @cli.search('factory_girl') }.should == <<-'EOS'
+NAME                                                DL(ver)   DL(all)
+-------------------------------------------------- -------- ---------
+factory_girl (3.6.0)                                    541   2042859
+factory_girl_generator (0.0.3)                         8015     15547
+factory_girl_rails (3.5.0)                            39724   1238780
+EOS
+        end
+      end
+
+      context 'with sort option: [vd]version_downloads' do
+        it "should display rubygems ordering by name" do
+          capture(:stdout) { @cli.search('factory_girl', 'version_downloads') }.should == <<'EOS'
+NAME                                                DL(ver)   DL(all)
+-------------------------------------------------- -------- ---------
+factory_girl_rails (3.5.0)                            39724   1238780
+factory_girl_generator (0.0.3)                         8015     15547
+factory_girl (3.6.0)                                    541   2042859
+EOS
+        end
+      end
+
+      context 'with sort option: [d]download' do
+        it "should display rubygems ordering by name" do
+          capture(:stdout) { @cli.search('factory_girl', 'download') }.should == <<'EOS'
+NAME                                                DL(ver)   DL(all)
+-------------------------------------------------- -------- ---------
+factory_girl (3.6.0)                                    541   2042859
+factory_girl_rails (3.5.0)                            39724   1238780
+factory_girl_generator (0.0.3)                         8015     15547
+EOS
+        end
+      end
+    end
+
+    describe 'ruled NAME line' do
+      context 'NAME size is 42' do
+        before do
+          stub_request(:get, build_search_uri('size_is_42_2345678901234567890123456789012')).
+            to_return(:status => 200, :body => dummy_search_result_name_size_is_42)
+        end
+        it "should be 50 characters" do
+          capture(:stdout) { @cli.search('size_is_42_2345678901234567890123456789012') }.should == <<'EOS'
+NAME                                                DL(ver)   DL(all)
+-------------------------------------------------- -------- ---------
+size_is_42_2345678901234567890123456789012 (0.0.1)      100      1000
+EOS
+        end
+      end
+
+      context 'NAME size is 43' do
+        before do
+          stub_request(:get, build_search_uri('size_is_42_2345678901234567890123456789012')).
+            to_return(:status => 200, :body => dummy_search_result_name_size_is_43)
+        end
+        it "should be 51 characters" do
+          capture(:stdout) { @cli.search('size_is_42_2345678901234567890123456789012') }.should == <<'EOS'
+NAME                                                 DL(ver)   DL(all)
+--------------------------------------------------- -------- ---------
+size_is_43_23456789012345678901234567890123 (0.0.2)      200      2000
+EOS
+        end
+      end
+    end
+  end
+
+  private
+    def build_search_uri(query)
+      "#{Gem::Search::CLI::SEARCH_URL}#{query}"
+    end
+    
+    def dummy_search_result
+      # top 3 gems searching with 'factory_girl'
+      # https://rubygems.org/api/v1/search.json?query=factory_girl
+      [{"name"=>"factory_girl",
+        "downloads"=>2042859,
+        "version"=>"3.6.0",
+        "version_downloads"=>541,
+        "platform"=>"ruby",
+        "authors"=>"Josh Clayton, Joe Ferris",
+        "info"=>
+         "factory_girl provides a framework and DSL for defining and\n                      using factories - less error-prone, more explicit, and\n                      all-around easier to work with than fixtures.",
+        "project_uri"=>"http://rubygems.org/gems/factory_girl",
+        "gem_uri"=>"http://rubygems.org/gems/factory_girl-3.6.0.gem",
+        "homepage_uri"=>"https://github.com/thoughtbot/factory_girl",
+        "wiki_uri"=>"",
+        "documentation_uri"=>"",
+        "mailing_list_uri"=>"",
+        "source_code_uri"=>"https://github.com/thoughtbot/factory_girl",
+        "bug_tracker_uri"=>"",
+        "dependencies"=>
+         {"development"=>
+           [{"name"=>"appraisal", "requirements"=>"~> 0.4"},
+            {"name"=>"aruba", "requirements"=>">= 0"},
+            {"name"=>"bourne", "requirements"=>">= 0"},
+            {"name"=>"cucumber", "requirements"=>"~> 1.1"},
+            {"name"=>"mocha", "requirements"=>">= 0"},
+            {"name"=>"rspec", "requirements"=>"~> 2.0"},
+            {"name"=>"simplecov", "requirements"=>">= 0"},
+            {"name"=>"sqlite3-ruby", "requirements"=>">= 0"},
+            {"name"=>"timecop", "requirements"=>">= 0"},
+            {"name"=>"yard", "requirements"=>">= 0"}],
+          "runtime"=>[{"name"=>"activesupport", "requirements"=>">= 3.0.0"}]}},
+       {"name"=>"factory_girl_rails",
+        "downloads"=>1238780,
+        "version"=>"3.5.0",
+        "version_downloads"=>39724,
+        "platform"=>"ruby",
+        "authors"=>"Joe Ferris",
+        "info"=>
+         "factory_girl_rails provides integration between\n    factory_girl and rails 3 (currently just automatic factory definition\n    loading)",
+        "project_uri"=>"http://rubygems.org/gems/factory_girl_rails",
+        "gem_uri"=>"http://rubygems.org/gems/factory_girl_rails-3.5.0.gem",
+        "homepage_uri"=>"http://github.com/thoughtbot/factory_girl_rails",
+        "wiki_uri"=>nil,
+        "documentation_uri"=>nil,
+        "mailing_list_uri"=>nil,
+        "source_code_uri"=>nil,
+        "bug_tracker_uri"=>nil,
+        "dependencies"=>
+         {"development"=>
+           [{"name"=>"aruba", "requirements"=>">= 0"},
+            {"name"=>"cucumber", "requirements"=>"~> 1.0.0"},
+            {"name"=>"rails", "requirements"=>"= 3.0.7"},
+            {"name"=>"rake", "requirements"=>">= 0"},
+            {"name"=>"rspec", "requirements"=>"~> 2.6.0"}],
+          "runtime"=>
+           [{"name"=>"factory_girl", "requirements"=>"~> 3.5.0"},
+            {"name"=>"railties", "requirements"=>">= 3.0.0"}]}},
+       {"name"=>"factory_girl_generator",
+        "downloads"=>15547,
+        "version"=>"0.0.3",
+        "version_downloads"=>8015,
+        "platform"=>"ruby",
+        "authors"=>"Les Hill",
+        "info"=>"Rails 3 generator for factory_girl",
+        "project_uri"=>"http://rubygems.org/gems/factory_girl_generator",
+        "gem_uri"=>"http://rubygems.org/gems/factory_girl_generator-0.0.3.gem",
+        "homepage_uri"=>"http://github.com/leshill/factory_girl_generator",
+        "wiki_uri"=>nil,
+        "documentation_uri"=>nil,
+        "mailing_list_uri"=>nil,
+        "source_code_uri"=>nil,
+        "bug_tracker_uri"=>nil,
+        "dependencies"=>{"development"=>[], "runtime"=>[]}}
+      ].to_json
+    end
+
+    def dummy_search_result_name_size_is_42
+      [{"name"=>"size_is_42_2345678901234567890123456789012",
+        "downloads"=>1000,
+        "version"=>"0.0.1",
+        "version_downloads"=>100}
+      ].to_json
+    end
+
+    def dummy_search_result_name_size_is_43
+      [{"name"=>"size_is_43_23456789012345678901234567890123",
+        "downloads"=>2000,
+        "version"=>"0.0.2",
+        "version_downloads"=>200}
+      ].to_json
+    end
+end

data/spec/spec_helper.rb

@@ -0,0 +1,19 @@
+# -*- encoding: utf-8 -*-
+require 'rubygems'
+require 'webmock/rspec'
+require 'gem-search'
+
+# http://d.hatena.ne.jp/POCHI_BLACK/20100324
+# this method is written by wycats
+def capture(stream)
+  begin
+    stream = stream.to_s
+    eval "$#{stream} = StringIO.new"
+    yield
+    result = eval("$#{stream}").string
+  ensure
+    eval("$#{stream} = #{stream.upcase}")
+  end
+
+  result
+end

metadata

@@ -0,0 +1,108 @@
+--- !ruby/object:Gem::Specification
+name: gem-search
+version: !ruby/object:Gem::Version
+  version: 0.0.2
+  prerelease: 
+platform: ruby
+authors:
+- rochefort
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2012-08-05 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: slop
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: json
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: webmock
+  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: search gems with using rubygems.org API
+email:
+- terasawan@gmail.com
+executables:
+- gem-search
+extensions: []
+extra_rdoc_files: []
+files:
+- .gitignore
+- Gemfile
+- LICENSE
+- README.md
+- Rakefile
+- bin/gem-search
+- gem-search.gemspec
+- lib/gem-search.rb
+- lib/gem-search/cli.rb
+- lib/gem-search/version.rb
+- spec/cli_spec.rb
+- spec/spec_helper.rb
+homepage: https://github.com/rochefort/gem-search
+licenses: []
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 1.8.23
+signing_key: 
+specification_version: 3
+summary: search gems with using rubygems.org API
+test_files:
+- spec/cli_spec.rb
+- spec/spec_helper.rb