itamae-sonar 1.0.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 7bc4c6d62ea536ac994831d60c796dc7d84d788b
+  data.tar.gz: cc5c5557064b26eb063fa9c1d06d2d594de8b6a1
+SHA512:
+  metadata.gz: b61ab93155c1bf54a8f2233afb11c623d8f810dfa1f701d895469c81bf2149d26496851b2262f5b348223875a3cce5727ff04576c26ebf04a1c4bbeeaace10b6
+  data.tar.gz: c2071784bba7ca336ce57bcde1bbad6caa5af2eea2d427fdb9d316ba923e1eac786118cd23733e5f1637257a9a2c4b731c9be2c0fb6025edf528f13b64b33e1b

data/.gitignore

@@ -0,0 +1,14 @@
+/.bundle/
+/.yardoc
+/Gemfile.lock
+/_yardoc/
+/coverage/
+/doc/
+/pkg/
+/spec/reports/
+/tmp/
+*.bundle
+*.so
+*.o
+*.a
+mkmf.log

data/.rspec

@@ -0,0 +1,2 @@
+--color
+--require spec_helper

data/.rubocop.yml

@@ -0,0 +1,24 @@
+Style/Blocks:
+  Enabled: false
+
+# Offense count: 1
+Style/Documentation:
+  Enabled: false
+
+# Offense count: 3
+# Configuration parameters: Exclude.
+Style/FileName:
+  Enabled: false
+
+# Offense count: 2
+# Configuration parameters: CountComments.
+Style/MethodLength:
+  Max: 13
+
+# Offense count: 2
+Style/MultilineBlockChain:
+  Enabled: false
+
+# Offense count: 2
+Style/RegexpLiteral:
+  MaxSlashes: 0

data/.travis.yml

@@ -0,0 +1,7 @@
+language: ruby
+before_install:
+  - gem update --system 2.1.11
+  - gem --version
+rvm:
+  - 2.0.0
+  - 2.1.0

data/Gemfile

@@ -0,0 +1,11 @@
+source 'https://rubygems.org'
+
+gemspec
+gem 'rspec', '~> 2.14.1'
+gem 'thor', '~> 0.18.1'
+gem 'simplecov', '~> 0.8.2'
+gem 'gems', '~> 0.0.4'
+
+group :test do
+  gem 'coveralls', require: false
+end

data/LICENSE.txt

@@ -0,0 +1,22 @@
+Copyright (c) 2014 tbpgr
+
+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,201 @@
+# ItamaeSonar
+
+ItamaeSonar search itamae plugin gems.
+
+[Itamae](https://github.com/ryotarai/itamae) is Simple and lightweight configuration management tool inspired by Chef.
+
+[![Build Status](https://travis-ci.org/tbpgr/itamae-sonar.png?branch=master)](https://travis-ci.org/tbpgr/itamae-sonar)
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+```ruby
+gem 'itamae-sonar'
+```
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install itamae-sonar
+
+## Usage
+
+### info
+~~~ruby
+require 'pp'
+require 'itamae-sonar'
+pp ItamaeSonar.info 'itamae'
+__END__
+{:name=>"itamae",
+ :desc=>"Simple Configuration Management Tool",
+ :downloads=>6894,
+ :rubygems_uri=>"http://rubygems.org/gems/itamae",
+ :homepage_uri=>"https://github.com/ryotarai/itamae"}
+~~~
+
+### random
+~~~ruby
+require 'pp'
+require 'itamae-sonar'
+pp ItamaeSonar.random
+pp ItamaeSonar.random
+__END__
+# randome result
+{:name=>"itamae-plugin-recipe-selinux",
+ :desc=>"Itamae selinux recipe plugin",
+ :downloads=>1065,
+ :rubygems_uri=>"http://rubygems.org/gems/itamae-plugin-recipe-selinux",
+ :homepage_uri=>""}
+{:name=>"itamae-plugin-resource-ghq",
+ :desc=>"Itamae resource plugin to manage repositories with ghq.",
+ :downloads=>165,
+ :rubygems_uri=>"http://rubygems.org/gems/itamae-plugin-resource-ghq",
+ :homepage_uri=>"https://github.com/k0kubun/itamae-plugin-resource-ghq"}
+~~~
+
+### ranking
+~~~ruby
+require 'pp'
+require 'itamae-sonar'
+pp ItamaeSonar.ranking
+__END__
+[{:name=>"itamae-plugin-resource-mail_alias",
+  :downloads=>1069,
+  :authors=>"Gosuke Miyashita"},
+ {:name=>"itamae-plugin-recipe-selinux",
+  :downloads=>1065,
+  :authors=>"Gosuke Miyashita"},
+ {:name=>"itamae-plugin-resource-cask",
+  :downloads=>628,
+  :authors=>"Takashi Kokubun"},
+ {:name=>"itamae-plugin-recipe-rtn_rbenv",
+  :downloads=>308,
+  :authors=>"Ru/MuckRu"},
+ {:name=>"itamae-plugin-resource-ghq",
+  :downloads=>165,
+  :authors=>"Takashi Kokubun"}]
+~~~
+
+~~~ruby
+require 'pp'
+require 'itamae-sonar'
+pp ItamaeSonar.ranking(3)
+__END__
+[{:name=>"itamae-plugin-resource-mail_alias",
+  :downloads=>1069,
+  :authors=>"Gosuke Miyashita"},
+ {:name=>"itamae-plugin-recipe-selinux",
+  :downloads=>1065,
+  :authors=>"Gosuke Miyashita"},
+ {:name=>"itamae-plugin-resource-cask",
+  :downloads=>628,
+  :authors=>"Takashi Kokubun"}]
+~~~
+
+###  author_ranking
+~~~ruby
+require 'pp'
+require 'itamae-sonar'
+pp ItamaeSonar.author_ranking
+__END__
+[{:authors=>"Gosuke Miyashita", :downloads=>2134},
+ {:authors=>"Takashi Kokubun", :downloads=>915},
+ {:authors=>"Ru/MuckRu", :downloads=>308},
+ {:authors=>"Takatoshi Maeda", :downloads=>96}]
+~~~
+
+~~~bash
+require 'itamae-sonar'
+print ItamaeSonar.author_ranking(3)
+__END__
+[{:authors=>"Gosuke Miyashita", :downloads=>2134},
+ {:authors=>"Takashi Kokubun", :downloads=>915},
+ {:authors=>"Ru/MuckRu", :downloads=>308}]
+~~~
+
+## Usage (Command Line)
+### Commands (Command Line)
+|name|args|memo|
+|:--|:--|:--|
+|[info](#itamae-sonar-info)|gem name|Show target gem info. gem_name, descriptions, downloads, rubygems_url, homepage_url|
+|[random](#itamae-sonar-random)|--|Show random gem info. gem_name, descriptions, downloads, rubygems_url, homepage_url|
+|[ranking](#itamae-sonar-ranking)|limit|Show gem donloads ranking. default = 5|
+|[author_ranking](#itamae-sonar-author_ranking)|limit|Show gem's authers donloads ranking. default = 5|
+
+### itamae-sonar info
+~~~bash
+$ itamae-sonar info itamae
+name:itamae
+desc:Simple Configuration Management Tool
+downloads:6894
+rubygems_uri:http://rubygems.org/gems/itamae
+homepage_uri:https://github.com/ryotarai/itamae
+~~~
+
+### itamae-sonar random
+~~~bash
+$ itamae-sonar random
+name:itamae-plugin-recipe-rtn_rbenv
+desc:Itamae Recipe 'rbenv'
+downloads:308
+rubygems_uri:http://rubygems.org/gems/itamae-plugin-recipe-rtn_rbenv
+homepage_uri:https://github.com/rutan/itamae-plugin-recipe-rtn_rbenv
+
+$ itamae-sonar random
+name:itamae-plugin-recipe-rtn_rbenv
+desc:Itamae Recipe 'rbenv'
+downloads:308
+rubygems_uri:http://rubygems.org/gems/itamae-plugin-recipe-rtn_rbenv
+homepage_uri:https://github.com/rutan/itamae-plugin-recipe-rtn_rbenv
+
+$ itamae-sonar random
+name:itamae-plugin-recipe-rbenv
+desc:Itamae plugin to install ruby with rbenv
+downloads:122
+rubygems_uri:http://rubygems.org/gems/itamae-plugin-recipe-rbenv
+homepage_uri:https://github.com/k0kubun/itamae-plugin-recipe-rbenv
+~~~
+
+### itamae-sonar ranking
+~~~bash
+$ itamae-sonar ranking
+no:1,name:itamae-plugin-resource-mail_alias,downloads:1069
+no:2,name:itamae-plugin-recipe-selinux,downloads:1065
+no:3,name:itamae-plugin-resource-cask,downloads:628
+no:4,name:itamae-plugin-recipe-rtn_rbenv,downloads:308
+no:5,name:itamae-plugin-resource-ghq,downloads:165
+
+$ itamae-sonar ranking 3
+no:1,name:itamae-plugin-resource-mail_alias,downloads:1069
+no:2,name:itamae-plugin-recipe-selinux,downloads:1065
+no:3,name:itamae-plugin-resource-cask,downloads:628
+~~~
+
+### itamae-sonar author_ranking
+~~~bash
+$ itamae-sonar author_ranking
+no:1,author:Gosuke Miyashita,downloads:2134
+no:2,author:Takashi Kokubun,downloads:915
+no:3,author:Ru/MuckRu,downloads:308
+no:4,author:Takatoshi Maeda,downloads:96
+
+$ itamae-sonar author_ranking 3
+no:1,author:Gosuke Miyashita,downloads:2134
+no:2,author:Takashi Kokubun,downloads:915
+no:3,author:Ru/MuckRu,downloads:308
+~~~
+
+## Dependency
+* itamae-sonar depend on [gems gem](https://github.com/rubygems/gems)
+
+## Contributing
+
+1. Fork it ( https://github.com/[my-github-username]/itamae-sonar/fork )
+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 a new Pull Request

data/Rakefile

@@ -0,0 +1,8 @@
+require 'bundler/gem_tasks'
+require 'rspec/core'
+require 'rspec/core/rake_task'
+task default: [:spec]
+
+RSpec::Core::RakeTask.new(:spec) do |spec|
+  spec.pattern = 'spec/**/*_spec.rb'
+end

data/bin/itamae-sonar

@@ -0,0 +1,95 @@
+#!/usr/bin/env ruby
+# encoding: utf-8
+
+require 'itamae-sonar'
+require 'itamae-sonar/version'
+require 'thor'
+
+# rubocop :disable LineLength
+module ItamaeSonar
+  # = ItamaeSonar CLI
+  class CLI < Thor
+    class_option :help, type: :boolean, aliases: '-h', desc: 'help message.'
+    class_option :version, type: :boolean, desc: 'version'
+    class_option :debug, type: :boolean, aliases: '-d', desc: 'debug mode'
+
+    desc 'info [GEM_NAME]', 'get gem info'
+    def info(gem_name)
+      setting_debug_mode
+      gem_info = ItamaeSonar.info(gem_name)
+      msg = <<-EOS
+name:#{gem_info[:name]}
+desc:#{gem_info[:desc]}
+downloads:#{gem_info[:downloads]}
+rubygems_uri:#{gem_info[:rubygems_uri]}
+homepage_uri:#{gem_info[:homepage_uri]}
+      EOS
+      puts msg
+      rescue => e
+        output_error_if_debug_mode(e)
+        exit(false)
+    end
+
+    desc 'random', 'get gem info at random'
+    def random
+      setting_debug_mode
+      gem_info = ItamaeSonar.random
+      msg = <<-EOS
+name:#{gem_info[:name]}
+desc:#{gem_info[:desc]}
+downloads:#{gem_info[:downloads]}
+rubygems_uri:#{gem_info[:rubygems_uri]}
+homepage_uri:#{gem_info[:homepage_uri]}
+      EOS
+      puts msg
+      rescue => e
+        output_error_if_debug_mode(e)
+        exit(false)
+    end
+
+    desc 'ranking [limit]', 'Show gem downloads ranking. default = 5'
+    def ranking(limit = 5)
+      limit = Integer(limit)
+      setting_debug_mode
+      gems_info = ItamaeSonar.ranking(limit).map.with_index(1) { |gem_info, i|
+        "no:#{i},name:#{gem_info[:name]},downloads:#{gem_info[:downloads]}"
+      }
+      puts gems_info
+      rescue => e
+        output_error_if_debug_mode(e)
+        exit(false)
+    end
+
+    desc 'author_ranking [limit]', "Show gem's authers downloads ranking. default = 5"
+    def author_ranking(limit = 5)
+      limit = Integer(limit)
+      setting_debug_mode
+      gems_info = ItamaeSonar.author_ranking(limit).map.with_index(1) { |gem_info, i|
+        "no:#{i},author:#{gem_info[:authors]},downloads:#{gem_info[:downloads]}"
+      }
+      puts gems_info
+      rescue => e
+        output_error_if_debug_mode(e)
+        exit(false)
+    end
+
+    desc 'version', 'version'
+    def version
+      p ItamaeSonar::VERSION
+    end
+
+    private
+
+    def setting_debug_mode
+      $DEBUG = options[:debug]
+    end
+
+    def output_error_if_debug_mode(e)
+      return unless options[:debug]
+      STDERR.puts(e.backtrace)
+    end
+  end
+end
+
+ItamaeSonar::CLI.start(ARGV)
+# rubocop :enable LineLength

data/itamae-sonar.gemspec

@@ -0,0 +1,26 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'itamae-sonar/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = 'itamae-sonar'
+  spec.version       = ItamaeSonar::VERSION
+  spec.authors       = ['tbpgr']
+  spec.email         = ['tbpgr@tbpgr.jp']
+  spec.summary       = 'Search itamae plugin gems.'
+  spec.description   = 'Search itamae plugin gems.'
+  spec.homepage      = 'https://github.com/tbpgr/itamae-sonar'
+  spec.license       = 'MIT'
+
+  spec.files         = `git ls-files -z`.split("\x0")
+  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_runtime_dependency 'thor'
+  spec.add_runtime_dependency 'gems'
+
+  spec.add_development_dependency 'bundler', '~> 1.6'
+  spec.add_development_dependency 'rake', '~> 10.0'
+end

data/lib/itamae-sonar/version.rb

@@ -0,0 +1,4 @@
+# ItamaeSonar
+module ItamaeSonar
+  VERSION = '1.0.0'
+end

data/lib/itamae-sonar.rb

@@ -0,0 +1,55 @@
+# encoding: utf-8
+require 'gems'
+
+module ItamaeSonar
+  module_function
+
+  RUBOTY_SEARCH_CONDITION = 'itamae-'
+
+  def self.info(gem_name)
+    gem_info = Gems.info(gem_name)
+    {
+      name: gem_info['name'],
+      desc: gem_info['info'],
+      downloads: gem_info['downloads'],
+      rubygems_uri: gem_info['project_uri'],
+      homepage_uri: gem_info['homepage_uri']
+    }
+  end
+
+  def self.random
+    gem_info = Gems.search(RUBOTY_SEARCH_CONDITION).sample
+    {
+      name: gem_info['name'],
+      desc: gem_info['info'],
+      downloads: gem_info['downloads'],
+      rubygems_uri: gem_info['project_uri'],
+      homepage_uri: gem_info['homepage_uri']
+    }
+  end
+
+  def self.ranking(limit = 5)
+    Gems.search(RUBOTY_SEARCH_CONDITION)
+        .map { |e|
+          {
+            name: e['name'],
+            downloads: e['downloads'].to_i,
+            authors: e['authors']
+          }
+        }.sort_by { |e|-e[:downloads] }
+        .take(limit)
+  end
+
+  def self.author_ranking(limit = 5)
+    Gems.search(RUBOTY_SEARCH_CONDITION)
+        .map { |e|{ authors: e['authors'], downloads: e['downloads'] } }
+        .group_by { |e| e[:authors] }
+        .map { |key, values|
+          {
+            authors: key,
+            downloads: values.reduce(0) { |a, e|a + e[:downloads] }
+          }
+        }.sort_by { |e| -e[:downloads] }
+        .take(limit)
+  end
+end

data/spec/itamae-sonar_spec.rb

@@ -0,0 +1,334 @@
+# encoding: utf-8
+require 'spec_helper'
+require 'itamae-sonar'
+require 'gems'
+
+# rubocop :disable LineLength
+describe ItamaeSonar do
+  context :info do
+    let(:itamae_mock) do
+      {
+        'name' => 'itamae-megen',
+        'downloads' => 364,
+        'version' => '1.0.1',
+        'version_downloads' => 121,
+        'platform' => 'ruby',
+        'authors' => 'tbpgr',
+        'info' => 'itamae-megen generate itamae README.md template.',
+        'licenses' => ['MIT'],
+        'project_uri' => 'http://rubygems.org/gems/itamae-megen',
+        'gem_uri' => 'http://rubygems.org/gems/itamae-megen-1.0.1.gem',
+        'homepage_uri' => 'https://github.com/tbpgr/itamae-megen',
+        'wiki_uri' => nil,
+        'documentation_uri' => nil,
+        'mailing_list_uri' => nil,
+        'source_code_uri' => nil,
+        'bug_tracker_uri' => nil,
+        'dependencies' =>         { 'development' =>            [{ 'name' => 'bundler', 'requirements' => '~> 1.6' },
+                                                                 { 'name' => 'rake', 'requirements' => '~> 10.0' },
+                                                                 { 'name' => 'rspec', 'requirements' => '>= 0' },
+                                                                 { 'name' => 'simplecov', 'requirements' => '>= 0' }],
+                                    'runtime' => [{ 'name' => 'thor', 'requirements' => '~> 0.18.1' }]
+        }
+      }
+    end
+    cases = [
+      {
+        case_no: 1,
+        case_title: 'valid case',
+        gem_name: 'itamae-megen',
+        expected: {
+          name: 'itamae-megen',
+          desc: 'itamae-megen generate itamae README.md template.',
+          downloads: 364,
+          rubygems_uri: 'http://rubygems.org/gems/itamae-megen',
+          homepage_uri: 'https://github.com/tbpgr/itamae-megen'
+        }
+      }
+    ]
+
+    cases.each do |c|
+      it "|case_no=#{c[:case_no]}|case_title=#{c[:case_title]}" do
+        begin
+          case_before c
+
+          # -- given --
+          allow(Gems).to receive(:info).and_return(itamae_mock)
+
+          # -- when --
+          actual = ItamaeSonar.info(c[:gem_name])
+
+          # -- then --
+          expect(actual).to eq(c[:expected])
+        ensure
+          case_after c
+        end
+      end
+
+      def case_before(_c)
+        # implement each case before
+      end
+
+      def case_after(_c)
+        # implement each case after
+      end
+    end
+  end
+
+  context :random do
+    let(:itamae_mock) do
+      [
+        {
+          'name' => 'itamae-megen',
+          'downloads' => 364,
+          'version' => '1.0.1',
+          'version_downloads' => 121,
+          'platform' => 'ruby',
+          'authors' => 'tbpgr',
+          'info' => 'itamae-megen generate itamae README.md template.',
+          'licenses' => ['MIT'],
+          'project_uri' => 'http://rubygems.org/gems/itamae-megen',
+          'gem_uri' => 'http://rubygems.org/gems/itamae-megen-1.0.1.gem',
+          'homepage_uri' => 'https://github.com/tbpgr/itamae-megen',
+          'wiki_uri' => nil,
+          'documentation_uri' => nil,
+          'mailing_list_uri' => nil,
+          'source_code_uri' => nil,
+          'bug_tracker_uri' => nil,
+          'dependencies' =>           { 'development' =>              [{ 'name' => 'bundler', 'requirements' => '~> 1.6' },
+                                                                       { 'name' => 'rake', 'requirements' => '~> 10.0' },
+                                                                       { 'name' => 'rspec', 'requirements' => '>= 0' },
+                                                                       { 'name' => 'simplecov', 'requirements' => '>= 0' }],
+                                        'runtime' => [{ 'name' => 'thor', 'requirements' => '~> 0.18.1' }]
+          }
+        }
+      ]
+    end
+
+    cases = [
+      {
+        case_no: 1,
+        case_title: 'valid case',
+        expected: {
+          name: 'itamae-megen',
+          desc: 'itamae-megen generate itamae README.md template.',
+          downloads: 364,
+          rubygems_uri: 'http://rubygems.org/gems/itamae-megen',
+          homepage_uri: 'https://github.com/tbpgr/itamae-megen'
+        }
+      }
+    ]
+
+    cases.each do |c|
+      it "|case_no=#{c[:case_no]}|case_title=#{c[:case_title]}" do
+        begin
+          case_before c
+
+          # -- given --
+          allow(Gems).to receive(:search).and_return(itamae_mock)
+
+          # -- when --
+          actual = ItamaeSonar.random
+
+          # -- then --
+          expect(actual).to eq(c[:expected])
+        ensure
+          case_after c
+        end
+      end
+
+      def case_before(_c)
+        # implement each case before
+      end
+
+      def case_after(_c)
+        # implement each case after
+      end
+    end
+  end
+
+  context :ranking do
+    let(:itamae_mock) do
+      [
+        {
+          'name' => 'itamae-megen1',
+          'downloads' => 364,
+          'authors' => 'tbpgr1'
+        },
+        {
+          'name' => 'itamae-megen2',
+          'downloads' => 363,
+          'authors' => 'tbpgr2'
+        },
+        {
+          'name' => 'itamae-megen3',
+          'downloads' => 365,
+          'authors' => 'tbpgr4'
+        },
+        {
+          'name' => 'itamae-megen3',
+          'downloads' => 360,
+          'authors' => 'tbpgr2'
+        },
+        {
+          'name' => 'itamae-megen3',
+          'downloads' => 362,
+          'authors' => 'tbpgr6'
+        }
+      ]
+    end
+
+    cases = [
+      {
+        case_no: 1,
+        case_title: 'valid case',
+        limit: 3,
+        expected: [
+          { name: 'itamae-megen3', downloads: 365, authors: 'tbpgr4' },
+          { name: 'itamae-megen1', downloads: 364, authors: 'tbpgr1' },
+          { name: 'itamae-megen2', downloads: 363, authors: 'tbpgr2' }
+        ]
+      },
+      {
+        case_no: 2,
+        case_title: 'valid case (default limit)',
+        expected: [
+          { name: 'itamae-megen3', downloads: 365, authors: 'tbpgr4' },
+          { name: 'itamae-megen1', downloads: 364, authors: 'tbpgr1' },
+          { name: 'itamae-megen2', downloads: 363, authors: 'tbpgr2' },
+          { name: 'itamae-megen3', downloads: 362, authors: 'tbpgr6' },
+          { name: 'itamae-megen3', downloads: 360, authors: 'tbpgr2' }
+        ]
+      }
+    ]
+
+    cases.each do |c|
+      it "|case_no=#{c[:case_no]}|case_title=#{c[:case_title]}" do
+        begin
+          case_before c
+
+          # -- given --
+          allow(Gems).to receive(:search).and_return(itamae_mock)
+
+          # -- when --
+          if c[:limit]
+            actual = ItamaeSonar.ranking(c[:limit])
+          else
+            actual = ItamaeSonar.ranking
+          end
+
+          # -- then --
+          expect(actual).to eq(c[:expected])
+        ensure
+          case_after c
+        end
+      end
+
+      def case_before(_c)
+        # implement each case before
+      end
+
+      def case_after(_c)
+        # implement each case after
+      end
+    end
+  end
+
+  context :author_ranking do
+    let(:itamae_mock) do
+      [
+        {
+          'name' => 'itamae-megen1',
+          'downloads' => 364,
+          'authors' => 'tbpgr1'
+        },
+        {
+          'name' => 'itamae-megen2',
+          'downloads' => 363,
+          'authors' => 'tbpgr1'
+        },
+        {
+          'name' => 'itamae-megen3',
+          'downloads' => 365,
+          'authors' => 'tbpgr2'
+        },
+        {
+          'name' => 'itamae-megen3',
+          'downloads' => 360,
+          'authors' => 'tbpgr2'
+        },
+        {
+          'name' => 'itamae-megen3',
+          'downloads' => 362,
+          'authors' => 'tbpgr3'
+        },
+        {
+          'name' => 'itamae-megen4',
+          'downloads' => 462,
+          'authors' => 'tbpgr4'
+        },
+        {
+          'name' => 'itamae-megen5',
+          'downloads' => 562,
+          'authors' => 'tbpgr5'
+        }
+      ]
+    end
+
+    cases = [
+      {
+        case_no: 1,
+        case_title: 'valid case',
+        limit: 3,
+        expected: [
+          { authors: 'tbpgr1', downloads: 727 },
+          { authors: 'tbpgr2', downloads: 725 },
+          { authors: 'tbpgr5', downloads: 562 }
+        ]
+      },
+      {
+        case_no: 2,
+        case_title: 'valid case (default limit)',
+        expected: [
+          { authors: 'tbpgr1', downloads: 727 },
+          { authors: 'tbpgr2', downloads: 725 },
+          { authors: 'tbpgr5', downloads: 562 },
+          { authors: 'tbpgr4', downloads: 462 },
+          { authors: 'tbpgr3', downloads: 362 }
+        ]
+      }
+    ]
+
+    cases.each do |c|
+      it "|case_no=#{c[:case_no]}|case_title=#{c[:case_title]}" do
+        begin
+          case_before c
+
+          # -- given --
+          allow(Gems).to receive(:search).and_return(itamae_mock)
+
+          # -- when --
+          if c[:limit]
+            actual = ItamaeSonar.author_ranking(c[:limit])
+          else
+            actual = ItamaeSonar.author_ranking
+          end
+
+          # -- then --
+          expect(actual).to eq(c[:expected])
+        ensure
+          case_after c
+        end
+      end
+
+      def case_before(_c)
+        # implement each case before
+      end
+
+      def case_after(_c)
+        # implement each case after
+      end
+    end
+  end
+end
+# rubocop :enable LineLength

data/spec/spec_helper.rb

@@ -0,0 +1,16 @@
+# encoding: utf-8
+require 'simplecov'
+require 'coveralls'
+Coveralls.wear!
+SimpleCov.formatter = SimpleCov::Formatter::MultiFormatter[
+  SimpleCov::Formatter::HTMLFormatter,
+  Coveralls::SimpleCov::Formatter
+]
+SimpleCov.start do
+  add_filter '/spec/'
+end
+RSpec.configure do |config|
+  config.treat_symbols_as_metadata_keys_with_true_values = true
+  config.run_all_when_everything_filtered = true
+  config.filter_run :focus
+end

metadata

@@ -0,0 +1,117 @@
+--- !ruby/object:Gem::Specification
+name: itamae-sonar
+version: !ruby/object:Gem::Version
+  version: 1.0.0
+platform: ruby
+authors:
+- tbpgr
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2014-12-04 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: thor
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: gems
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.6'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.6'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '10.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '10.0'
+description: Search itamae plugin gems.
+email:
+- tbpgr@tbpgr.jp
+executables:
+- itamae-sonar
+extensions: []
+extra_rdoc_files: []
+files:
+- .gitignore
+- .rspec
+- .rubocop.yml
+- .travis.yml
+- Gemfile
+- LICENSE.txt
+- README.md
+- Rakefile
+- bin/itamae-sonar
+- itamae-sonar.gemspec
+- lib/itamae-sonar.rb
+- lib/itamae-sonar/version.rb
+- spec/itamae-sonar_spec.rb
+- spec/spec_helper.rb
+homepage: https://github.com/tbpgr/itamae-sonar
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.3.0
+signing_key: 
+specification_version: 4
+summary: Search itamae plugin gems.
+test_files:
+- spec/itamae-sonar_spec.rb
+- spec/spec_helper.rb