latest 0.2.0 → 0.3.0

data/README.md

@@ -2,7 +2,7 @@
 
 ### Latest keeps us up to speed by querying rubygems.org for a gem's most recent version number. Yep, that's all it does.
 
-Basically I was tired of visiting `https://rubygems.org/gems/whatever-gem` to find out a gem's most recent version number.
+Basically I was tired of visiting `https://rubygems.org/gems/whatever-gem` to find out a gem's most recent version.
 
 
 ------------------------------------------------------------------------------
@@ -14,18 +14,24 @@ After installing, use latest from your command line like so:
 
 ```bash
 latest rails
-# rails 3.2.1
+# rails 3.2.2 (41013 downloads)
 
 latest rails spree haml
-# rails 3.2.1
-# spree 1.0.0
-# haml 3.1.4
-```
+# rails 3.2.2 (41014 downloads)
+# spree 1.0.1 (279 downloads)
+# haml 3.1.4 (289029 downloads)
 
 latest rails spree --pre haml
-# rails 3.2.1
-# spree --pre 1.0.0.rc4
-# haml 3.1.4
+# rails 3.2.2 (41015 downloads)
+# spree --pre 1.0.0.rc4 (134 downloads)
+# haml 3.1.4 (289029 downloads)
+```
+
+You can print latest's version like so:
+
+```bash
+latest -v
+# Latest v0.3.0
 ```
 
 
@@ -46,7 +52,7 @@ sudo gem install latest
 Testing
 ------------------------------------------------------------------------------
 
-Testing is done with minitest. Run the tests with:
+Testing is done with minitest/spec. Run the specs with:
 
 ```bash
 bundle exec rake

data/Rakefile

@@ -1,6 +1,8 @@
 require "bundler/gem_tasks"
 require "rake/testtask"
 
-Rake::TestTask.new
+Rake::TestTask.new do |t|
+  t.test_files = FileList["spec/**/*_spec.rb"]
+end
 
 task :default => [ :test ]

data/bin/latest

@@ -2,25 +2,25 @@
 # encoding: UTF-8
 
 $:.push File.expand_path("../../lib", __FILE__)
-
 require "latest"
 
-if ARGV.first =~ /^-(v|-version)$/
+if ARGV.empty?
+  puts Latest.usage
+elsif ARGV.first =~ /^-(v|-version)$/
   puts "Latest v" + Latest::VERSION
 else
   ARGV.each_with_index do |name, index|
-    print name + " "
+    print name + " "    
     begin
-      gem = Latest.lookup(name)
+      gem = Latest::Gem.new(name)    
       if ARGV[index + 1] == "--pre"
         ARGV.slice!(index + 1, 1)
+        gem.pre = true
         print "--pre "
-        puts gem.last_prerelease_version
-      else
-        puts gem.last_stable_version
       end
-    rescue Latest::GemNotFoundError => e
-      print "<- "
+      puts "#{gem.version} (#{gem.downloads} downloads)"    
+    rescue StandardError => e
+      print "[Error] "
       puts e.message
     end
   end

data/latest.gemspec

@@ -9,7 +9,7 @@ Gem::Specification.new do |s|
   s.authors     = ["Spencer Steffen"]
   s.email       = ["spencer@citrusme.com"]
   s.homepage    = "https://github.com/citrus/latest"
-  s.summary     = %q{Latest keeps us up to speed by querying rubygems.org for a gem's most recent version number. Yep, that's all it does.}
+  s.summary     = %q{Latest queries rubygems.org for the latest version of a gem.}
   s.description = %q{Latest keeps us up to speed by querying rubygems.org for a gem's most recent version number. Yep, that's all it does.}
 
   s.rubyforge_project = "latest"

data/lib/latest/gem.rb

@@ -5,49 +5,85 @@ require "json"
 module Latest
   class Gem
     
-    attr_reader :name, :versions
+    class NameParseError   < StandardError; end
+    class GemNotFoundError < StandardError; end
+    class RequestError     < StandardError; end
+    
+    attr_reader :name, :pre, :response, :downloads
     
     def initialize(name)
-      @name       = name
-      @versions   = fetch
-      if @versions.nil? || @versions.empty?
-        raise ::Latest::GemNotFoundError, "`#{name}` could not be found on rubygems.org!"
-      end
+      @name, @pre = parse_name(name)
       self
     end
     
-    def last_prerelease_version
-      return @last_prerelease_version if @last_prerelease_version
-      @last_prerelease_version = find_latest_version(true)
+    def fetch
+      @response = send_request
+      parse_response
     end
     
-    def last_stable_version
-      return @last_stable_version if @last_stable_version
-      @last_stable_version = find_latest_version
+    def versions
+      @versions ||= fetch
     end
-
+    
+    def version
+      @version ||= parse_versions
+    end
+    
+    def pre=(value)
+      @pre = !!value
+      @version = parse_versions
+    end
+    
   private
-  
-    def find_latest_version(prerelease=false)
-      version = "(not found)"
-      @versions.each do |v|
-        next unless v["prerelease"] == prerelease
-        version = v["number"]
-        break
-      end
-      version
+    
+    def url
+      @url ||= "https://rubygems.org/api/v1/versions/#{name}.json"
     end
-  
-    def fetch
-      uri = URI("https://rubygems.org/api/v1/versions/#{@name}.json")
+    
+    def uri
+      @uri ||= URI.parse(url)
+    end
+    
+    def send_request
       Net::HTTP.start(uri.host, uri.port, :use_ssl => true) do |http|
         request = Net::HTTP::Get.new uri.request_uri      
-        response = http.request request
-        if response.is_a?(Net::HTTPSuccess)
-          return JSON.parse(response.body)
-        end
+        http.request(request)
+      end
+    end
+  
+    def parse_name(name)
+      names = name.split(" ")
+      case names.length
+        when 1; [ names.first, false ]
+        when 2
+          return [ names.first, true ] if names.last == "--pre"
+          raise Latest::Gem::NameParseError.new("Invalid prerelease flag. Try `latest #{names.first} --pre`")
+        else raise Latest::Gem::NameParseError.new("Argument error, #{names.length} for 1-2")
       end
     end
     
+    def parse_response
+      case @response
+        when Net::HTTPSuccess
+          @versions = JSON.parse(@response.body)
+        when Net::HTTPNotFound
+           raise Latest::Gem::GemNotFoundError.new("`#{name}` could not be found on rubygems.org")
+        else
+          raise Latest::Gem::RequestError.new("An error occured while fetching `#{name}. Rubygems.org responded with status #{@response.code}")
+      end
+      @versions
+    end
+   
+    def parse_versions
+      @version = "(not found)"
+      versions.each do |v|
+        next unless v["prerelease"] == pre
+        @version   = v["number"]
+        @downloads = v["downloads_count"]
+        break
+      end
+      @version
+    end
+      
   end
 end

data/lib/latest/version.rb

@@ -1,3 +1,3 @@
 module Latest
-  VERSION = "0.2.0"
+  VERSION = "0.3.0"
 end

data/lib/latest.rb

@@ -2,12 +2,9 @@ require "latest/version"
 require "latest/gem"
 
 module Latest
-  
-  class GemNotFoundError < StandardError; end
-  
-  def self.lookup(name)
-    gem = Gem.new(name)
-    gem
+
+  def self.usage
+    "Usage: latest [GEM [--pre]] [GEM2 [--pre]] etc"
   end
   
 end

data/spec/latest/gem_spec.rb

@@ -0,0 +1,118 @@
+require "latest"
+require "minitest/autorun"
+
+FAKE_VERSIONS = [
+  {"authors"=>"Bogus", "built_at"=>"2011-10-22T00:00:00Z", "description"=>"Bogus...", "downloads_count"=>10000, "number"=>"1.0.1",     "summary"=>"Bogus", "platform"=>"ruby", "prerelease"=>false},
+  {"authors"=>"Bogus", "built_at"=>"2011-06-05T00:00:00Z", "description"=>"Bogus...", "downloads_count"=>1000,  "number"=>"1.0.0",     "summary"=>"Bogus", "platform"=>"ruby", "prerelease"=>false},
+  {"authors"=>"Bogus", "built_at"=>"2011-06-01T00:00:00Z", "description"=>"Bogus...", "downloads_count"=>100,   "number"=>"1.0.0.rc1", "summary"=>"Bogus", "platform"=>"ruby", "prerelease"=>true},
+  {"authors"=>"Bogus", "built_at"=>"2011-05-20T00:00:00Z", "description"=>"Bogus...", "downloads_count"=>10,    "number"=>"0.9.9",     "summary"=>"Bogus", "platform"=>"ruby", "prerelease"=>false},
+  {"authors"=>"Bogus", "built_at"=>"2011-03-13T04:00:00Z", "description"=>"Bogus...", "downloads_count"=>1,     "number"=>"0.9.9.rc1", "summary"=>"Bogus", "platform"=>"ruby", "prerelease"=>true}
+]
+
+describe Latest::Gem do
+
+  describe "#initialize" do
+  
+    it "should initialize with a name" do
+      @gem = Latest::Gem.new("rake")
+      @gem.name.must_equal "rake"
+      @gem.pre.must_equal false
+    end
+    
+    it "should initialize with a name and pre" do
+      @gem = Latest::Gem.new("rake --pre")
+      @gem.name.must_equal "rake"
+      @gem.pre.must_equal true
+    end
+    
+    it "should raise a name parse error when an invalid pre flag is given" do
+      %w(pre -pre PRE --PRE a 0 ?).each do |i|
+        lambda {
+          Latest::Gem.new("rake #{i}")
+        }.must_raise Latest::Gem::NameParseError
+      end    
+    end
+    
+    it "should raise a name parse error when more than two arguments are given" do
+      lambda { 
+        Latest::Gem.new("rake --pre omg")
+      }.must_raise Latest::Gem::NameParseError
+    end
+  
+  end
+  
+  describe "#fetch" do
+    
+    before do
+      @gem = Latest::Gem.new("rake")
+    end
+    
+    it "should return it's url on rubygems" do
+      @gem.send(:url).must_equal "https://rubygems.org/api/v1/versions/rake.json"
+    end
+    
+    it "should parse it's url into a uri" do
+      @gem.send(:uri).must_equal URI.parse("https://rubygems.org/api/v1/versions/rake.json")
+    end
+    
+    it "should send a request and return an HTTP response" do
+      @gem.send(:send_request).class.ancestors.must_include Net::HTTPResponse
+    end
+    
+    it "should fetch and parse response into an array" do
+      @gem.fetch
+      @gem.versions.must_be_instance_of Array
+    end
+  
+    it "should raise GemNotFoundError when gem is not found" do
+      @gem.instance_variable_set("@response", Net::HTTPNotFound.new(1.0, 404, "NotFound"))
+      lambda {
+        @gem.send(:parse_response)
+      }.must_raise Latest::Gem::GemNotFoundError
+    end
+    
+    it "should throw a RequestError when rubygems responds with an unexpected status" do
+      @gem.instance_variable_set("@response", Net::HTTPBadRequest.new(1.0, 400, "BadRequest"))
+      lambda {
+        @gem.send(:parse_response)
+      }.must_raise Latest::Gem::RequestError
+    end
+    
+  end
+  
+  describe "#parse_versions" do
+  
+    before do
+      @gem = Latest::Gem.new("fake")        
+      @gem.instance_variable_set("@response", Net::HTTPOK.new(1.0, 200, "OK"))
+      @gem.instance_variable_set("@versions", FAKE_VERSIONS)
+    end
+    
+    it "should not find latest version if versions are empty" do
+      @gem.instance_variable_set("@versions", [])
+      @gem.version.must_equal "(not found)"
+    end
+    
+    it "should find latest version" do
+      @gem.version.must_equal "1.0.1"
+    end
+    
+    it "should find latest prerelease version" do
+      @gem.instance_variable_set("@pre", true)
+      @gem.version.must_equal "1.0.0.rc1"
+    end
+    
+    it "should set the total number of downloads when a version is found" do
+      @gem.version.must_equal "1.0.1"
+      @gem.downloads.must_equal 10000
+    end
+    
+    it "should find latest version, change to prerelease, then find the latest version again" do
+      @gem.version.must_equal "1.0.1"
+      @gem.pre = true
+      @gem.version.must_equal "1.0.0.rc1"    
+    end
+    
+  end
+  
+end

data/spec/latest_spec.rb

@@ -0,0 +1,77 @@
+require "latest"
+require "minitest/autorun"
+
+describe "Latest" do
+
+  BIN = File.expand_path("../../bin/latest", __FILE__)
+  
+  STABLE_VERSION_REGEX = /\d+(\.\d+)*/                        # 11.2.123
+  PRE_VERSION_REGEX    = /--pre \d+(\.\d+)*(.[a-z\.?\d]+)+/i  # 0.1.23.beta.1
+  DOWNLOADS_REGEX      = /\(\d+ downloads\)/                  # (10 downloads)
+
+  def assert_version_match(name, string, prerelease=false)
+    regex = Regexp.new("#{name} #{prerelease ? PRE_VERSION_REGEX : STABLE_VERSION_REGEX} #{DOWNLOADS_REGEX}")
+    string.strip.must_match regex 
+  end
+
+  it "should have a version constant" do
+    assert Latest.const_defined?(:VERSION)
+  end
+  
+  it "should have a latest executable" do
+    assert File.exists?(BIN)
+    assert File.executable?(BIN)
+  end
+  
+  it "should return usage string" do
+    Latest.usage.must_equal "Usage: latest [GEM [--pre]] [GEM2 [--pre]] etc"
+  end
+  
+  describe "#latest" do
+    
+    def cmd(params)
+      `#{BIN} #{params}`.strip
+    end
+    
+    it "should return usage when no arguments are given" do
+      cmd("").must_equal Latest.usage
+    end
+    
+    it "should return version with -v or --version" do
+      expected = "Latest v#{Latest::VERSION}"
+      cmd("-v").must_equal expected
+      cmd("--version").must_equal expected
+    end
+     
+    it "should fetch and print multiple gems" do
+      out = cmd("rake minitest latest").split("\n")
+      assert_version_match "rake",     out[0]
+      assert_version_match "minitest", out[1]
+      assert_version_match "latest",   out[2]
+    end
+    
+    it "should fetch and print prerelease version" do
+      out = cmd("rake --pre")
+      assert_version_match "rake", out, true
+    end
+    
+    it "should fetch and print mixed normal and prerelease versions" do
+      out = cmd("rake --pre shoulda --pre latest").split("\n")
+      assert_version_match "rake",    out[0], true
+      assert_version_match "shoulda", out[1], true
+      assert_version_match "latest",  out[2]
+    end
+    
+    it "should rescue GemNotFoundError and print it's error message" do
+      out = cmd("omg-non-existant-gem-2")
+      out.must_equal "omg-non-existant-gem-2 [Error] `omg-non-existant-gem-2` could not be found on rubygems.org"
+    end
+    
+    it "should rescue standard error and print it's error message" do
+      out = cmd("^")
+      out.must_equal "^ [Error] bad URI(is not URI?): https://rubygems.org/api/v1/versions/^.json"
+    end
+  
+  end
+  
+end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: latest
 version: !ruby/object:Gem::Version
-  version: 0.2.0
+  version: 0.3.0
   prerelease: 
 platform: ruby
 authors:
@@ -9,11 +9,11 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2012-02-14 00:00:00.000000000Z
+date: 2012-03-07 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rake
-  requirement: &70157104359200 !ruby/object:Gem::Requirement
+  requirement: &70325692439400 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>'
@@ -21,10 +21,10 @@ dependencies:
         version: '0'
   type: :development
   prerelease: false
-  version_requirements: *70157104359200
+  version_requirements: *70325692439400
 - !ruby/object:Gem::Dependency
   name: bundler
-  requirement: &70157104356100 !ruby/object:Gem::Requirement
+  requirement: &70325692438920 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>'
@@ -32,7 +32,7 @@ dependencies:
         version: '0'
   type: :development
   prerelease: false
-  version_requirements: *70157104356100
+  version_requirements: *70325692438920
 description: Latest keeps us up to speed by querying rubygems.org for a gem's most
   recent version number. Yep, that's all it does.
 email:
@@ -53,8 +53,8 @@ files:
 - lib/latest.rb
 - lib/latest/gem.rb
 - lib/latest/version.rb
-- test/test_gem.rb
-- test/test_latest.rb
+- spec/latest/gem_spec.rb
+- spec/latest_spec.rb
 homepage: https://github.com/citrus/latest
 licenses: []
 post_install_message: 
@@ -73,13 +73,15 @@ required_rubygems_version: !ruby/object:Gem::Requirement
   - - ! '>='
     - !ruby/object:Gem::Version
       version: '0'
+      segments:
+      - 0
+      hash: -2568820004086336079
 requirements: []
 rubyforge_project: latest
-rubygems_version: 1.8.10
+rubygems_version: 1.8.11
 signing_key: 
 specification_version: 3
-summary: Latest keeps us up to speed by querying rubygems.org for a gem's most recent
-  version number. Yep, that's all it does.
+summary: Latest queries rubygems.org for the latest version of a gem.
 test_files:
-- test/test_gem.rb
-- test/test_latest.rb
+- spec/latest/gem_spec.rb
+- spec/latest_spec.rb

data/test/test_gem.rb

@@ -1,18 +0,0 @@
-require "minitest/autorun"
-require "latest"
-
-class TestGem < MiniTest::Unit::TestCase
-  
-  def test_should_fetch_on_initialize
-    gem = ::Latest::Gem.new("rake")
-    assert_equal Array, gem.versions.class
-    assert_equal "rake", gem.name
-  end
-    
-  def test_raise_error_when_gem_is_not_found
-    assert_raises Latest::GemNotFoundError do
-      ::Latest::Gem.new("some-gem-that-probably-wont-exist-2")
-    end
-  end
-  
-end

data/test/test_latest.rb

@@ -1,56 +0,0 @@
-require "minitest/autorun"
-require "latest"
-
-class TestLatest < MiniTest::Unit::TestCase
-  
-  BIN = File.expand_path("../../bin/latest", __FILE__)
-  
-  STABLE_VERSION_REGEX     = /\d+(\.\d+)*$/                       # 11.2.123
-  PRERELEASE_VERSION_REGEX = /--pre \d+(\.\d+)*(.[a-z\.\d]+)+$/i  # 0.1.23.beta.1
-
-  def assert_version_match(name, string, prerelease=false)
-    assert_match Regexp.new("#{name} #{prerelease ? PRERELEASE_VERSION_REGEX : STABLE_VERSION_REGEX}"), string.strip
-  end
-
-  def test_has_version
-    assert_equal String, Latest::VERSION.class
-  end
-
-  def test_executable_exists
-    assert File.exists?(BIN)
-  end
-  
-  def test_executable_is_executable
-    assert File.executable?(BIN)
-  end
-  
-  def test_executable_returns_version
-    out = `#{BIN} -v`
-    assert_match "Latest v#{Latest::VERSION}", out
-  end
-  
-  def test_executable_fetches_and_prints_version
-    out = `#{BIN} rake`
-    assert_version_match "rake", out
-  end
-  
-  def test_executable_fetches_and_prints_multiple_versions
-    out = `#{BIN} rake rails spree`.split("\n")
-    assert_version_match "rake",  out[0]
-    assert_version_match "rails", out[1]
-    assert_version_match "spree", out[2]
-  end
-  
-  def test_executable_fetches_and_prints_prerelease_version
-    out = `#{BIN} rake --pre`
-    assert_version_match "rake", out, true
-  end
-  
-  def test_executable_fetches_and_prints_multiple_prerelease_versions
-    out = `#{BIN} rake --pre rails --pre spree`.split("\n")
-    assert_version_match "rake",  out[0], true
-    assert_version_match "rails", out[1], true
-    assert_version_match "spree", out[2]
-  end
-  
-end