latest_ruby 0.0.1

checksums.yaml

@@ -0,0 +1,15 @@
+---
+!binary "U0hBMQ==":
+  metadata.gz: !binary |-
+    ZDA2MGExOTViMTA2YTU0MGEyMzBjYTRmZDRkYjVhZTZjZmQ5MDNkOA==
+  data.tar.gz: !binary |-
+    ZGFkMDM1N2U5MGFjNDRjZWNmMDlkYzliZGYzMzQ0MjJlYzcyNzJmOA==
+!binary "U0hBNTEy":
+  metadata.gz: !binary |-
+    YmQzMTE0YzBjZTA4M2I5YTIxNWQ0YjE1YmE2NjM5NWNmZTNiZDBmZWMzYmYy
+    YmE4OWI2Njk1MDVjNjU2MDM2YTMzZmYyNzUyNmUxZDM4NTc5ZjA0MDU2NmJh
+    NTYwYjViNWQxMTU0MmRmMmZkNjg3MDVmOTBlOTRiMDBjN2VhYWQ=
+  data.tar.gz: !binary |-
+    MWQ4ZGJlYjkxN2E3NDZiMWRkMDUyNTQ1MjJiM2I0MjVmMzliOWZmMDI2MWNl
+    OTc3YTViZmI0NGVhODQ3NzE0ZTE0YzJjNDJjMWUyNGE5ZDdhYjUwZDZhMjg0
+    NTJkOGM3NTVhZGEzMTJlMjBiNjdlNmE5OTU4YTRhMzE2NmI4M2I=

data/.gitignore

@@ -0,0 +1,4 @@
+*~
+*.gem
+Gemfile.lock
+.rbx

data/CHANGELOG.md

@@ -0,0 +1,6 @@
+Latest Ruby changelog
+=====================
+
+### v0.0.1 (April 16, 2013)
+
+* Initial release

data/Gemfile

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

data/LICENCE

@@ -0,0 +1,19 @@
+Copyright (C) 2013 Kyrylo Silin
+
+This software is provided 'as-is', without any express or implied
+warranty. In no event will the authors be held liable for any damages
+arising from the use of this software.
+
+Permission is granted to anyone to use this software for any purpose,
+including commercial applications, and to alter it and redistribute it
+freely, subject to the following restrictions:
+
+1. The origin of this software must not be misrepresented; you must not
+   claim that you wrote the original software. If you use this software
+   in a product, an acknowledgment in the product documentation would be
+   appreciated but is not required.
+
+2. Altered source versions must be plainly marked as such, and must not be
+   misrepresented as being the original software.
+
+3. This notice may not be removed or altered from any source distribution.

data/README.md

@@ -0,0 +1,88 @@
+Latest Ruby
+===========
+
+* Repository: [https://github.com/kyrylo/latest_ruby][repo]
+
+Description
+-----------
+
+The purpose of this library is to answer a simple but capacious question: “What
+is the latest version of Ruby now?”. It can also be asked for the latest
+versions of Rubinius, JRuby, MagLev, MacRuby.
+
+Installation
+------------
+
+    gem install latest_ruby
+
+Synopsis
+--------
+
+I find this library useful for the [`pry-doc` Pry plugin][prydoc]. Namely, for
+automation of generation the latest documentation for Rubies.
+
+### Usage
+
+Let's find out the latest versions of Rubies.
+
+```ruby
+# MRI 2.0
+Latest.ruby.version.to_s #=> "2.0.0-p0"
+# The same.
+Latest.ruby20.version.to_s
+
+# MRI 1.9
+Latest.ruby19.version.to_s #=> "1.9.3-p392"
+
+# MRI 1.8
+Latest.ruby18.version.to_s #=> "1.8.7-p371"
+
+# JRuby.
+Latest.jruby.version.to_s #=> "1.7.3"
+
+# Rubinius.
+Latest.rubinius.version.to_s #=> "1.2.4"
+# The same.
+Latest.rbx.version.to_s
+
+# MagLev
+Latest.maglev.version.to_s #=> "1.0.0"
+
+# MacRuby
+Latest.macruby.version.to_s #=> "0.12"
+```
+
+Latest Ruby also provides one useful (well, it's useful for me, at least) way to
+retrieve a download link for a Ruby.
+
+```ruby
+Latest.ruby.link #=> "http://ftp.ruby-lang.org/pub/ruby/2.0/ruby-2.0.0-p0.tar.gz"
+# The same.
+Latest.ruby.link('.tar.gz') #=> "http://ftp.ruby-lang.org/pub/ruby/2.0/ruby-2.0.0-p0.tar.gz"
+
+Latest.ruby.link('.tar.bz2') #=> "http://ftp.ruby-lang.org/pub/ruby/2.0/ruby-2.0.0-p0.tar.bz2"
+Latest.ruby.link('.zip') #=> "http://ftp.ruby-lang.org/pub/ruby/2.0/ruby-2.0.0-p0.zip"
+```
+
+Limitations
+-----------
+
+### OS support
+
+Latest Ruby is a cross-platform library.
+
+### Rubies
+
+* Ruby 1.9.3 and higher
+
+Please, ping me, if you need support for other Ruby implementations. Or, if you
+prefer, send a pull request. Currently, the library is unbelievably simple.
+Ideas and suggestions are welcome (just file issues).
+
+Licence
+-------
+
+The project uses Zlib licence. See LICENCE file for more information.
+
+[repo]: https://github.com/kyrylo/latest_ruby
+[prydoc]: https://github.com/pry/pry-doc

data/Rakefile

@@ -0,0 +1,15 @@
+def quiet
+  ENV['VERBOSE'] ? '' : '-q'
+end
+
+def test_files
+  paths = FileList['spec/**/*_spec.rb']
+  paths.shuffle!.join(' ')
+end
+
+desc "Run tests"
+task :test do
+  exec "bacon -Ispec #{ quiet } #{ test_files }"
+end
+
+task :default => :test

data/VERSION

@@ -0,0 +1 @@
+0.0.1

data/latest_ruby.gemspec

@@ -0,0 +1,20 @@
+Gem::Specification.new do |s|
+  s.name         = 'latest_ruby'
+  s.version      = File.read('VERSION')
+  s.date         = Time.now.strftime('%Y-%m-%d')
+  s.summary      = 'Answers the question of what the latest Ruby version is'
+  s.description  = 'Knows about MRI, Rubinius, JRuby, MagLev and MacRuby.'
+  s.author       = 'Kyrylo Silin'
+  s.email        = 'kyrylosilin@gmail.com'
+  s.homepage     = 'https://github.com/kyrylo/latest_ruby'
+  s.licenses     = 'zlib'
+
+  s.require_path = 'lib'
+  s.files        = `git ls-files`.split("\n")
+
+  s.add_runtime_dependency 'versionomy'
+
+  s.add_development_dependency 'bacon'
+  s.add_development_dependency 'rake'
+  s.add_development_dependency 'pry'
+end

data/lib/latest_ruby.rb

@@ -0,0 +1,56 @@
+require_relative 'latest_ruby/ruby'
+require_relative 'latest_ruby/ruby_version'
+require_relative 'latest_ruby/rubies/mri'
+require_relative 'latest_ruby/rubies/jruby'
+require_relative 'latest_ruby/rubies/rubinius'
+require_relative 'latest_ruby/rubies/maglev'
+require_relative 'latest_ruby/rubies/macruby'
+require_relative 'latest_ruby/retrievers/mri_retriever'
+require_relative 'latest_ruby/retrievers/jruby_retriever'
+require_relative 'latest_ruby/retrievers/rubinius_retriever'
+require_relative 'latest_ruby/retrievers/maglev_retriever'
+require_relative 'latest_ruby/retrievers/macruby_retriever'
+
+module Latest
+
+  # The VERSION file must be in the root directory of the library.
+  VERSION_FILE = File.expand_path('../../VERSION', __FILE__)
+
+  VERSION = File.exist?(VERSION_FILE) ?
+    File.read(VERSION_FILE).chomp : '(could not find VERSION file)'
+
+  class << self
+    def ruby20
+      Ruby.new(MRI.new('2.0', MRIRetriever.new))
+    end
+
+    # The latest Ruby version by default.
+    alias_method :ruby, :ruby20
+
+    def ruby19
+      Ruby.new(MRI.new('1.9', MRIRetriever.new))
+    end
+
+    def ruby18
+      Ruby.new(MRI.new('1.8', MRIRetriever.new))
+    end
+
+    def jruby
+      Ruby.new(JRuby.new(JRubyRetriever.new))
+    end
+
+    def rubinius
+      Ruby.new(Rubinius.new(RubiniusRetriever.new))
+    end
+    alias_method :rbx, :rubinius
+
+    def maglev
+      Ruby.new(MagLev.new(MagLevRetriever.new))
+    end
+
+    def macruby
+      Ruby.new(MacRuby.new(MacRubyRetriever.new))
+    end
+  end
+
+end

data/lib/latest_ruby/retrievers/jruby_retriever.rb

@@ -0,0 +1,13 @@
+require 'net/http'
+
+module Latest
+  class JRubyRetriever
+
+    def retrieve(jruby)
+      page = Net::HTTP.get(URI(jruby.source))
+      ver  = page.scan(/Current Release: JRuby (.+)<\/h2>/).flatten.first
+      RubyVersion.new(ver)
+    end
+
+  end
+end

data/lib/latest_ruby/retrievers/macruby_retriever.rb

@@ -0,0 +1,11 @@
+module Latest
+  class MacRubyRetriever
+
+    def retrieve(macruby)
+      page = Net::HTTP.get(URI(macruby.source))
+      page.scan(/MacRuby (.+)\.zip/).
+        uniq.flatten.map { |v| RubyVersion.new(v) }.max
+    end
+
+  end
+end

data/lib/latest_ruby/retrievers/maglev_retriever.rb

@@ -0,0 +1,11 @@
+module Latest
+  class MagLevRetriever
+
+    def retrieve(maglev)
+      page = Net::HTTP.get(URI(maglev.source))
+      page.scan(/MagLev-(\d\.\d\.\d)\.tar\.gz/).
+        uniq.flatten.map { |v| RubyVersion.new(v) }.max
+    end
+
+  end
+end

data/lib/latest_ruby/retrievers/mri_retriever.rb

@@ -0,0 +1,13 @@
+require 'net/http'
+
+module Latest
+  class MRIRetriever
+
+    def retrieve(mri)
+      page = Net::HTTP.get(URI(mri.source + mri.short_ver + '/'))
+      page.scan(/(#{ Regexp.escape(mri.short_ver) }\.\d-[a-z0-9]+)\.zip/x).
+        uniq.flatten.map { |v| RubyVersion.new(v) }.max
+    end
+
+  end
+end

data/lib/latest_ruby/retrievers/rubinius_retriever.rb

@@ -0,0 +1,19 @@
+require 'net/http'
+require 'rexml/document'
+
+module Latest
+  class RubiniusRetriever
+
+    include REXML
+
+    def retrieve(rbx)
+      page = Net::HTTP.get(URI(rbx.source))
+      xml  = Document.new(page)
+      all_versions = XPath.match(xml, '//Contents//Key').map(&:text)
+      candidates = all_versions.find_all { |v| v =~ /\Arubinius-/ }
+      stables = candidates.flat_map { |v| v.scan(/-(\d\.\d\.\d)\.tar/) }.flatten
+      stables.map { |v| RubyVersion.new(v) }.max
+    end
+
+  end
+end

data/lib/latest_ruby/rubies/jruby.rb

@@ -0,0 +1,26 @@
+module Latest
+  class JRuby
+
+    SOURCE = 'http://jruby.org.s3.amazonaws.com/downloads/'
+    WEB_SOURCE = 'http://jruby.org/download'
+    AVAILABLE_EXTS = ['.tar.gz', '.zip']
+
+    attr_reader :source, :web_source
+
+    def initialize(retriever)
+      @retriever = retriever
+      @source = WEB_SOURCE
+    end
+
+    def version
+      @version ||= @retriever.retrieve(self)
+    end
+
+    def link(ext = '.tar.gz')
+      if AVAILABLE_EXTS.include?(ext)
+        SOURCE + '/' + version.to_s + '/jruby-bin-' + version.to_s + ext
+      end
+    end
+
+  end
+end

data/lib/latest_ruby/rubies/macruby.rb

@@ -0,0 +1,25 @@
+module Latest
+  class MacRuby
+
+    SOURCE = 'http://macruby.jp/files/'
+    AVAILABLE_EXTS = ['.zip']
+
+    attr_reader :source
+
+    def initialize(retriever)
+      @retriever = retriever
+      @source = SOURCE
+    end
+
+    def version
+      @version ||= @retriever.retrieve(self)
+    end
+
+    def link(ext = '.zip')
+      if AVAILABLE_EXTS.include?(ext)
+        source + 'MacRuby ' + version.to_s + ext
+      end
+    end
+
+  end
+end

data/lib/latest_ruby/rubies/maglev.rb

@@ -0,0 +1,25 @@
+module Latest
+  class MagLev
+
+    SOURCE = 'http://glass-downloads.gemstone.com/maglev/'
+    AVAILABLE_EXTS = ['.tar.gz']
+
+    attr_reader :source
+
+    def initialize(retriever)
+      @retriever = retriever
+      @source = SOURCE
+    end
+
+    def version
+      @version ||= @retriever.retrieve(self)
+    end
+
+    def link(ext = '.tar.gz')
+      if AVAILABLE_EXTS.include?(ext)
+        source + 'MagLev-' + version.to_s + ext
+      end
+    end
+
+  end
+end

data/lib/latest_ruby/rubies/mri.rb

@@ -0,0 +1,26 @@
+module Latest
+  class MRI
+
+    SOURCE = 'http://ftp.ruby-lang.org/pub/ruby/'
+    AVAILABLE_EXTS = ['.tar.gz', '.zip', '.tar.bz2']
+
+    attr_reader :short_ver, :source
+
+    def initialize(short_ver, retriever)
+      @short_ver = short_ver
+      @retriever = retriever
+      @source = SOURCE
+    end
+
+    def version
+      @version ||= @retriever.retrieve(self)
+    end
+
+    def link(ext = '.tar.gz')
+      if AVAILABLE_EXTS.include?(ext)
+        source + short_ver + '/ruby-' + version.to_s + ext
+      end
+    end
+
+  end
+end

data/lib/latest_ruby/rubies/rubinius.rb

@@ -0,0 +1,25 @@
+module Latest
+  class Rubinius
+
+    SOURCE = 'http://asset.rubini.us/'
+    AVAILABLE_EXTS = ['.tar.gz']
+
+    attr_reader :source
+
+    def initialize(retriever)
+      @retriever = retriever
+      @source = SOURCE
+    end
+
+    def version
+      @version ||= @retriever.retrieve(self)
+    end
+
+    def link(ext = '.tar.gz')
+      if AVAILABLE_EXTS.include?(ext)
+        source + 'rubinius-' + version.to_s + ext
+      end
+    end
+
+  end
+end

data/lib/latest_ruby/ruby.rb

@@ -0,0 +1,15 @@
+require 'forwardable'
+
+module Latest
+  class Ruby
+
+    extend Forwardable
+
+    def initialize(ruby)
+      @ruby = ruby
+    end
+
+    def_delegators :@ruby, :link, :version
+
+  end
+end

data/lib/latest_ruby/ruby_version.rb

@@ -0,0 +1,26 @@
+require 'forwardable'
+require 'versionomy'
+
+module Latest
+  class RubyVersion
+
+    extend Forwardable
+
+    def initialize(version)
+      @version = get_version(version)
+    end
+
+    def <=>(other)
+      @version <=> other.instance_variable_get(:@version)
+    end
+
+    def_delegators :@version, :to_s
+
+    private
+
+    def get_version(ver)
+      Versionomy.parse(ver)
+    end
+
+  end
+end

data/spec/helper.rb

@@ -0,0 +1,6 @@
+require 'bacon'
+require 'pry'
+
+require_relative '../lib/latest_ruby'
+
+puts "Ruby: #{ RUBY_VERSION }; Latest Ruby version: #{ Latest::VERSION }"

data/spec/latest_ruby_spec.rb

@@ -0,0 +1,7 @@
+require_relative 'helper'
+
+describe Latest do
+  it "works" do
+    true.should == true
+  end
+end

metadata

@@ -0,0 +1,123 @@
+--- !ruby/object:Gem::Specification
+name: latest_ruby
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+platform: ruby
+authors:
+- Kyrylo Silin
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2013-04-16 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: versionomy
+  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: bacon
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: pry
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+description: Knows about MRI, Rubinius, JRuby, MagLev and MacRuby.
+email: kyrylosilin@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- .gitignore
+- CHANGELOG.md
+- Gemfile
+- LICENCE
+- README.md
+- Rakefile
+- VERSION
+- latest_ruby.gemspec
+- lib/latest_ruby.rb
+- lib/latest_ruby/retrievers/jruby_retriever.rb
+- lib/latest_ruby/retrievers/macruby_retriever.rb
+- lib/latest_ruby/retrievers/maglev_retriever.rb
+- lib/latest_ruby/retrievers/mri_retriever.rb
+- lib/latest_ruby/retrievers/rubinius_retriever.rb
+- lib/latest_ruby/rubies/jruby.rb
+- lib/latest_ruby/rubies/macruby.rb
+- lib/latest_ruby/rubies/maglev.rb
+- lib/latest_ruby/rubies/mri.rb
+- lib/latest_ruby/rubies/rubinius.rb
+- lib/latest_ruby/ruby.rb
+- lib/latest_ruby/ruby_version.rb
+- spec/helper.rb
+- spec/latest_ruby_spec.rb
+homepage: https://github.com/kyrylo/latest_ruby
+licenses:
+- zlib
+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.0.3
+signing_key: 
+specification_version: 4
+summary: Answers the question of what the latest Ruby version is
+test_files: []
+has_rdoc: