DRAFT: Adds web command

Manifest.txt

@@ -305,6 +305,7 @@ lib/rubygems/commands/stale_command.rb
 lib/rubygems/commands/uninstall_command.rb
 lib/rubygems/commands/unpack_command.rb
 lib/rubygems/commands/update_command.rb
+lib/rubygems/commands/web_command.rb
 lib/rubygems/commands/which_command.rb
 lib/rubygems/commands/yank_command.rb
 lib/rubygems/compatibility.rb
@@ -320,6 +321,7 @@ lib/rubygems/deprecate.rb
 lib/rubygems/doctor.rb
 lib/rubygems/errors.rb
 lib/rubygems/exceptions.rb
+lib/rubygems/executor.rb
 lib/rubygems/ext.rb
 lib/rubygems/ext/build_error.rb
 lib/rubygems/ext/builder.rb
@@ -544,6 +546,7 @@ test/rubygems/test_gem_commands_stale_command.rb
 test/rubygems/test_gem_commands_uninstall_command.rb
 test/rubygems/test_gem_commands_unpack_command.rb
 test/rubygems/test_gem_commands_update_command.rb
+test/rubygems/test_gem_commands_web_command.rb
 test/rubygems/test_gem_commands_which_command.rb
 test/rubygems/test_gem_commands_yank_command.rb
 test/rubygems/test_gem_config_file.rb

lib/rubygems/command_manager.rb

@@ -69,6 +69,7 @@ class Gem::CommandManager
     :uninstall,
     :unpack,
     :update,
+    :web,
     :which,
     :yank,
   ].freeze

lib/rubygems/commands/web_command.rb

@@ -0,0 +1,51 @@
+# frozen_string_literal: true
+require 'rubygems/command'
+require 'rubygems/executor'
+require 'rubygems/version_option'
+
+class Gem::Commands::WebCommand < Gem::Command
+
+  include Gem::VersionOption
+  attr_reader :executor
+
+  def initialize
+    super 'web', "Open the gem's homepage",
+      :command => nil,
+      :version => Gem::Requirement.default,
+      :latest => false
+
+    add_option("-g", "--github", "Open GitHub page of gem, this searches all urls for a GitHub page. This is the default.") do |v|
+      options[:github] = v
+    end
+    add_option("-c", "--sourcecode", "Open sourcecode gem") do |v|
+      options[:sourcecode] = v
+    end
+    add_option("-d", "--doc", "Open documentation of gem") do |v|
+      options[:doc] = v
+    end
+    add_option("-w", "--webpage", "Open webpage of gem") do |v|
+      options[:webpage] = v
+    end
+    add_option("-r", "--rubygems", "Open the rubygems page of a gem") do |v|
+      options[:rubygems] = v
+    end
+    add_option("-t", "--rubytoolbox", "Open the ruby toolbox page of a gem") do |v|
+      options[:rubytoolbox] = v
+    end
+
+    @executor = Gem::Web::Executor.new
+  end
+
+  def arguments
+    "GEMNAME       gem to open the webpage for"
+  end
+
+  def usage
+    "[GEMNAME]"
+  end
+
+  def execute
+    @executor.open_page(get_one_optional_argument, options)
+  end
+
+end

lib/rubygems/executor.rb

@@ -0,0 +1,73 @@
+# frozen_string_literal: true
+require 'open-uri'
+require 'json'
+
+module Gem
+  module Web
+    class Executor
+
+      def open_page(gem, options)
+        if options[:sourcecode]
+          find_page(gem, "source_code_uri")
+        elsif options[:doc]
+          find_page(gem, "documentation_uri")
+        elsif options[:webpage]
+          find_page(gem, "homepage_uri")
+        elsif options[:rubygems]
+          open_rubygems(gem)
+        elsif options[:rubytoolbox]
+          open_rubytoolbox(gem)
+        else
+          find_github(gem)
+        end
+      end
+
+      def find_page(gem, page)
+        meta = get_api_metadata(gem)
+        launch_browser(gem, meta[page]) unless meta.nil?
+      end
+
+      def find_github(gem)
+        unless (meta = get_api_metadata(gem)).nil?
+          links = [meta["source_code_uri"], meta["documentation_uri"], meta["homepage_uri"]]
+          uri = links.find do |link|
+            !link.nil? && link.match(/http(s?):\/\/(www\.)?github.com\/.*/i)
+          end
+          launch_browser(gem, uri)
+        end
+      end
+
+      def get_api_metadata(gem)
+        begin
+          JSON.parse(open("https://rubygems.org/api/v1/gems/#{gem}.json").read)
+        rescue OpenURI::HTTPError
+          puts "Did not find #{gem} on rubygems.org"
+          nil
+        end
+      end
+
+      def launch_browser(gem, uri)
+        if uri.nil? || uri.empty?
+          puts "Did not find page for #{gem}, opening RubyGems page instead."
+          uri = "https://rubygems.org/gems/#{gem}"
+        end
+
+        open_default_browser(uri)
+      end
+
+      def open_rubygems(gem)
+        open_default_browser("https://rubygems.org/gems/#{gem}")
+      end
+
+      def open_rubytoolbox(gem)
+        open_default_browser("https://www.ruby-toolbox.com/projects/#{gem}")
+      end
+
+      # TODO: Make this cross-platform
+      def open_default_browser(uri)
+        system("xdg-open", uri)
+      end
+
+    end
+  end
+end

test/rubygems/test_gem_commands_web_command.rb

@@ -0,0 +1,111 @@
+# frozen_string_literal: true
+require 'rubygems/test_case'
+require 'rubygems/executor'
+require 'rubygems/commands/web_command'
+
+class TestGemCommandsWebCommand < Gem::TestCase
+
+  def setup
+    super
+    @cmd = Gem::Commands::WebCommand.new
+    @mock = MiniTest::Mock.new
+  end
+
+  def test_default_option
+    @mock.expect(:call, true, ["xdg-open", "http://github.com/rails/rails"])
+
+    @cmd.executor.stub :system, @mock do
+      @cmd.handle_options %w[rails]
+      @cmd.execute
+    end
+
+    @mock.verify
+  end
+
+  def test_open_the_documentation
+    @mock.expect(:call, true, ["xdg-open", "http://api.rubyonrails.org"])
+
+    @cmd.executor.stub :system, @mock do
+      @cmd.handle_options %w[-d rails]
+      @cmd.execute
+    end
+
+    @mock.verify
+  end
+
+  def test_open_the_homepage
+    @mock.expect(:call, true, ["xdg-open", "http://rubyonrails.org"])
+
+    @cmd.executor.stub :system, @mock do
+      @cmd.handle_options %w[-w rails]
+      @cmd.execute
+    end
+
+    @mock.verify
+  end
+
+  def test_open_the_source_code
+    @mock.expect(:call, true, ["xdg-open", "http://github.com/rails/rails"])
+
+    @cmd.executor.stub :system, @mock do
+      @cmd.handle_options %w[-c rails]
+      @cmd.execute
+    end
+
+    @mock.verify
+  end
+
+  def test_open_github
+    @mock.expect(:call, true, ["xdg-open", "http://github.com/rails/rails"])
+
+    @cmd.executor.stub :system, @mock do
+      @cmd.handle_options %w[-g rails]
+      @cmd.execute
+    end
+
+    @mock.verify
+  end
+
+  def test_open_rubygems
+    @mock.expect(:call, true, ["xdg-open", "https://rubygems.org/gems/rails"])
+
+    @cmd.executor.stub :system, @mock do
+      @cmd.handle_options %w[-r rails]
+      @cmd.execute
+    end
+
+    @mock.verify
+  end
+
+  def test_open_rubytoolbox
+    @mock.expect(:call, true, ["xdg-open", "https://www.ruby-toolbox.com/projects/rails"])
+
+    @cmd.executor.stub :system, @mock do
+      @cmd.handle_options %w[-t rails]
+      @cmd.execute
+    end
+
+    @mock.verify
+  end
+
+  def test_search_unexisting_gem
+    gem = "this-is-an-unexisting-gem"
+    assert_output(/Did not find #{gem} on rubygems.org\n/) do
+      @cmd.handle_options [gem]
+      @cmd.execute
+    end
+  end
+
+  def test_open_rubygems_if_it_could_not_find_page
+    @mock.expect(:call, true, ["xdg-open", "https://rubygems.org/gems/rails"])
+
+    @cmd.executor.stub :system, @mock do
+      assert_output("Did not find page for rails, opening RubyGems page instead.\n") do
+        @cmd.executor.launch_browser("rails", "")
+      end
+    end
+
+    @mock.verify
+  end
+
+end