yard-link_stdlib 0.1.3 → 0.1.7

checksums.yaml

@@ -1,7 +1,7 @@
 ---
-SHA1:
-  metadata.gz: 3334c95ebde62bc497aaab158361d28cb88bcb3e
-  data.tar.gz: 04117641eaf696120948d32d3e23354308e33d77
+SHA256:
+  metadata.gz: f5e7356071edda1c5ce9bf616147e40f02069f92c35da1e33c450b502884718b
+  data.tar.gz: 29b1b6d8cd736cdfb76935e9ec94cd8645b956219d42bcd70954f69edab47658
 SHA512:
-  metadata.gz: f5c660eb08a0a7656e305771d7603788b8396bec4221ee2c3030137e7ad7cfbef4682ee3a481fe62b84b3a0cd8b6972abfdc82d0fda9f39ea9ed778f161eb113
-  data.tar.gz: 227aa9d466ab557c835d84c581d205b79dbe993dd62fea51c868e03b0b9a8f60418944257ea20003717b060fb2fd56e2ad2dcd4e5a14a2764c0012a72275d8cd
+  metadata.gz: ae3626b5e848ce86406ac0c75f85cc4d417f58c73733e0ce4091e6ae943f086853736c511f7e77799a641a2e7ed6734f85a3f8f2e331fc91a40a3bb63561a075
+  data.tar.gz: 6510319602c33029c50afe71adca2fc80cd20ea55b1d70f5b52909626e179ed6c6d39917e44144af1de9c7b83b44f3007bb41458fb747cdd451725ab931bc2a1

data/VERSION

@@ -1 +1 @@
-0.1.3
+0.1.7

data/bin/make_map.rb

@@ -90,6 +90,45 @@ class RDoc::RDoc
 end # class RDoc::RDoc
 
 
+def load_pry
+  require 'pry'
+  # In most project you probably *don't* want to load the RC file,
+  # as it may have dependencies
+  Pry.config.should_load_rc = false
+end
+
+
+# Add pre-defined global variables and constants, which are hand-documented in
+#     RUBY_SRC/doc/globals.rdoc
+# 
+# and available on the site at
+# 
+#     https://docs.ruby-lang.org/en/<MAJOR.MINOR.0>/globals_rdoc.html
+# 
+# like https://docs.ruby-lang.org/en/2.3.0/globals_rdoc.html
+# 
+# 
+def add_globals_and_constants map
+  rdoc_path = './doc/globals.rdoc'
+  html_path = 'globals_rdoc.html'
+  
+  unless File.file? rdoc_path
+    warn  "Can't find globals and constants RDoc file at " +
+          "#{ File.expand_path rdoc_path }"
+    warn  "Pre-defined global variables and constants will NOT be available" +
+          "in this map!"
+    return
+  end
+  
+  contents = File.read rdoc_path
+  
+  contents.scan /^(\S+)::\s/ do |(name)|
+    map[ name ] = html_path
+    # puts "Added #{ name.inspect } => #{ html_path }"
+  end
+end
+
+
 def main args
   src = Pathname.new( args.shift ).expand_path
   dest = Pathname.new( args.shift ).expand_path
@@ -112,8 +151,12 @@ def main args
   rd.almost_document args
 
   map = {}
-
+  
+  add_globals_and_constants map
+  
+  # Add all classes and modules
   rd.store.all_classes_and_modules.each do |mod|
+    # Example of how to stop and inspect a particular module when debugging
     # if mod.full_name == 'Gem::Specification'
     #   require 'pry'
     #   Pry.config.should_load_rc = false
@@ -126,9 +169,10 @@ def main args
       mod.class_attributes,
       mod.class_method_list,
       mod.instance_attributes,
-      mod.instance_method_list,
+      mod.instance_methods,
     ].flatten.each { |entry|
       map[ entry.full_name ] = entry.path
+      # puts "Added #{ entry.full_name.inspect } => #{ entry.path }"
     }
     
   end

data/lib/yard/cli/link_stdlib.rb

@@ -15,7 +15,12 @@ require 'yard'
 
 ### Project / Package ###
 
-require 'yard/link_stdlib/ruby_source'
+#### Sub-Commands ####
+require_relative './link_stdlib/add'
+require_relative './link_stdlib/help'
+require_relative './link_stdlib/list'
+require_relative './link_stdlib/search'
+require_relative './link_stdlib/url'
 
 
 # Namespace
@@ -28,357 +33,29 @@ module  CLI
 # Definitions
 # =======================================================================
 
-
-class OptionParser < ::OptionParser
-  def after_parse_block
-    @after_parse_block ||= []
-  end
-  
-  def after_parse &block
-    after_parse_block << block
-  end
-
-  def parse! *args
-    super( *args ).tap { after_parse_block.each &:call }
-  end
-end
-
-
-module CommandHelper
-  
-  def description
-    self.class::DESCRIPTION
-  end
-  
-  
-  def usage
-    self.class::USAGE
-  end
-  
-  
-  def check_args! args, count
-    if args.length < count
-      log.error "Too few args! Expected #{ count }, given #{ args.length }"
-      exit false
-    elsif args.length > count
-      log.error "Too many args! Expected #{ count }, given #{ args.length }"
-      exit false
-    end
-    
-    if args.length == 1 then args[ 0 ] else args end
-  end
-
-  
-  def opts
-    @opts ||= {}
-  end
-  
-
-  def add_header op, text = nil
-    op.banner = description
-    op.separator ''
-    op.separator 'Usage:'
-    op.separator ''
-    op.separator "    #{ usage }"
-    op.separator ''
-    unless text.nil?
-      text.lines.each { |line| op.separator line }
-    end
-    op.separator ''
-    op.separator 'Options:'
-    
-    op.on_tail( '-q', '--quiet', 'Show no warnings.' ) {
-      log.level = Logger::ERROR
-    }
-    
-    op.on_tail( '--verbose', 'Show more information.') {
-      log.level = Logger::INFO
-    }
-    
-    op.on_tail( '--debug', 'Show debugging information.' ) {
-      log.level = Logger::DEBUG
-    }
-    
-    op.on_tail( '--backtrace', 'Show stack traces' ) {
-      log.show_backtraces = true
-    }
-    
-    op.on_tail( '-h', '--help', %(You're looking at it!) ) {
-      log.puts op
-      exit true
-    }
-  end
-  
-  def add_version_opt op
-    # **DON'T** make missing versions by default here!
-    YARD::LinkStdlib::RubySource.make_missing = false
-    
-    op.on(
-      '-v VERSION',
-      '--ruby-version=VERSION',
-      %(Set Ruby version)
-    ) { |ruby_version|
-      YARD::LinkStdlib::RubyVersion.set ruby_version
-      # opts[ :ruby_version ] = ruby_version
-    }
-    
-    op.on(
-      '--make-missing',
-      %(Download and make an object map if the Ruby version is not present)
-    ) { |make_missing|
-      YARD::LinkStdlib::RubySource.make_missing = make_missing
-      # opts[ :make_missing ] = make_missing
-    }
-  end
-  
-end # CommandHelper
-
-
-# @todo document LinkStdlib class.
+# Top-level {YARD::CLI::Command} for the `yard-link_stdlib` plugin. Added under 
+# the name `stdlib` (see {YARD::LinkStdlib.install!}).
+# 
+# Simply a router to the sub-commands. Like {YARD::CLI::CommandParser}, which
+# handles routing for `yard`, but is not really re-usable. In addition, this 
+# class handles "-" → "_" conversion in sub-command names, since we have 
+# multi-word commands.
+# 
 class LinkStdlib < Command
-
-  # Sub-commands
-  # ============================================================================
-
-  class List < Command
-    include CommandHelper
-    
-    DESCRIPTION = "List Ruby versions"
-    USAGE = "yard stdlib list"
-
-    def run *args
-      
-      
-      log.puts \
-        YARD::LinkStdlib::ObjectMap.
-          all.
-          map { |om| om.version.to_s }.
-          join( "\n" )
-    end
-  end # class List
-
-
-  class Add < Command
-    
-    include CommandHelper
-    
-    DESCRIPTION = "Download version source and build object map"
-    USAGE = "yard stdlib add [OPTIONS] RUBY_VERSION"
-
-    def run *args
-      # Want to see what's going on by default here...
-      log.level = Logger::INFO
-      
-      opts[ :force ] = false
-    
-      OptionParser.new { |op|
-        add_header op
-        
-        op.on( '-f', '--force',
-                %(Force building of map data when already present)
-        ) { |force| opts[ :force ] = force }
-        
-      }.parse! args
-      
-      args.each do |version|    
-        log.info "Adding object map for Ruby #{ version }..."
-        YARD::LinkStdlib::ObjectMap.add version, force: opts[ :force ]
-      end
-      
-      exit true
-    end
-    
-  end # class Add
-  
-  
-  class URL < Command
-    
-    include CommandHelper
-    
-    DESCRIPTION = "Print the online doc URL for a stdlib name"
-    USAGE = "yard stdlib url [OPTIONS] NAME"
-    
-    def run *args
-      OptionParser.new { |op|
-        add_header op
-        add_version_opt op
-      }.parse! args
-      
-      name = check_args! args, 1
-      
-      url = YARD::LinkStdlib::ObjectMap.current.url_for name
-      
-      if url.nil?
-        $stderr.puts "Name not found: #{ name.inspect }"
-        exit false
-      end
-      
-      puts url
-      exit true
-    end
-  end
-  
-  
-  # Hooks into {YARD::LinkStdlib::ObjectMap#grep} to search for names using 
-  # regular expressions.
-  # 
-  class Search < Command
-    
-    include CommandHelper
-    
-    DESCRIPTION = "Find stdlib names that match Regexp patterns"
-    USAGE = "yard stdlib search [OPTIONS] TERMS..."
-    
-    def run *args
-      # Default format is `:plain`
-      opts[ :format ] = :plain
-      
-      OptionParser.new { |op|
-        add_header op, <<~END
-          Examples:
-          
-            1.  {Pathname} instance methods
-                
-                    $ yard stdlib search '^Pathname#'
-          
-            2.  All `#to_s` methods
-                
-                    $ yard stdlib search '#to_s$'
-            
-            3.  Print results in serialized formats.
-                
-                All `#to_s` instance methods in JSON:
-                
-                    $ yard stdlib search --format=json '#to_s$'
-                
-                Supports a short `-f` flag and first-letter formats too.
-                
-                Instance methods of {Array} in YAML:
-                
-                    $ yard stdlib search -f y '^Array#'
-        END
-        
-        add_version_opt op
-        
-        op.on(  '-u', '--urls',
-                %(Print doc URLs along with names)
-        ) { |urls| opts[ :urls ] = !!urls }
-        
-        op.on(  '-f FORMAT', '--format=FORMAT',
-                %(Specify print format: (p)lain, (j)son or (y)aml)
-        ) { |format|
-          opts[ :format ] = \
-            case format.downcase
-            when 'p', 'plain'
-              :plain
-            when 'j', 'json'
-              :json
-            when 'y', 'yaml'
-              :yaml
-            else
-              log.fatal \
-                %(Unknown format - expected "plain", "json" or "yaml"; ) +
-                %(given #{ format.inspect })
-              exit false
-            end
-        }
-        
-      }.parse! args
-      
-      if args.empty?
-        YARD::LinkStdlib::ObjectMap.
-          current.
-          names.
-          sort_by( &:downcase ).
-          each { |key| log.puts key }
-        exit true
-      end
-      
-      terms = args.map { |arg|
-        begin
-          Regexp.new arg
-        rescue RegexpError => error
-          Regexp.new \
-            Regexp.escape( YARD::LinkStdlib.normalize_name( arg ) )
-        end
-      }
-      
-      log.debug "Terms:\n  " + terms.map( &:to_s ).join( "\n  " )
-      
-      names = YARD::LinkStdlib.grep *terms
-      
-      results = \
-        if opts[ :urls ]
-          names.each_with_object( {} ) { |name, hash|
-            hash[ name ] = YARD::LinkStdlib::ObjectMap.current.url_for name
-          }
-        else
-          names
-        end
-      
-      case opts[ :format ]
-      when :plain
-        results.each do |entry|
-          if entry.is_a? ::Array
-            log.puts "#{ entry[0] } <#{ entry[ 1 ]}>"
-          else
-            log.puts entry
-          end
-        end
-      when :json
-        require 'json'
-        log.puts JSON.pretty_generate( results )
-      when :yaml
-        require 'yaml'
-        log.puts YAML.dump( results )
-      end
-      
-      exit true
-    end
-  end # class Search
-
-
-  class Help < Command
-    
-    include CommandHelper
-    
-    DESCRIPTION = "Show this message"
-
-    def run
-      commands = LinkStdlib.commands
-      log.puts <<~END
-        yard-link_stdlib provides linking to online Ruby docs for standard 
-        library code objects.
-        
-        Usage:
-        
-            yard stdlib COMMAND... [OPTIONS] [ARGS]
-        
-        Commands:
-        
-      END
-      commands.keys.sort_by(&:to_s).each do |command_name|
-        command_class = commands[command_name]
-        next unless command_class < Command
-        command = command_class.new
-        log.puts "%-8s %s" % [command_name, command.description]
-      end
-      log.puts
-    end
-  end
   
+  @commands = SymbolHash[
+    help: Help,
+    list: List,
+    add: Add,
+    url: URL,
+    search: Search,
+  ]
   
   # Singleton Methods
   # ==========================================================================
   
   def self.commands
-    {
-      help: Help,
-      list: List,
-      add: Add,
-      url: URL,
-      search: Search,
-    }
+    @commands
   end
   
   

data/lib/yard/cli/link_stdlib/add.rb

@@ -0,0 +1,70 @@
+# encoding: UTF-8
+# frozen_string_literal: true
+
+# Requirements
+# =======================================================================
+
+### Stdlib ###
+
+require 'optparse'
+
+### Deps ###
+
+# We need {YARD::CLI::Command}
+require 'yard'
+
+### Project / Package ###
+
+require_relative './command_helper'
+
+
+# Namespace
+# =======================================================================
+
+module  YARD
+module  CLI
+class   LinkStdlib < Command
+
+
+# Definitions
+# =======================================================================
+
+class Add < Command
+  
+  include CommandHelper
+  
+  DESCRIPTION = "Download version source and build object map"
+  USAGE = "yard stdlib add [OPTIONS] RUBY_VERSION"
+
+  def run *args
+    # Want to see what's going on by default here...
+    log.level = Logger::INFO
+    
+    opts[ :force ] = false
+  
+    OptionParser.new { |op|
+      add_header op
+      
+      op.on( '-f', '--force',
+              %(Force building of map data when already present)
+      ) { |force| opts[ :force ] = force }
+      
+    }.parse! args
+    
+    args.each do |version|    
+      log.info "Adding object map for Ruby #{ version }..."
+      YARD::LinkStdlib::ObjectMap.add version, force: opts[ :force ]
+    end
+    
+    exit true
+  end
+  
+end # class Add
+
+
+# /Namespace
+# =======================================================================
+
+end # class  LinkStdlib
+end # module CLI
+end # module YARD

data/lib/yard/cli/link_stdlib/command_helper.rb

@@ -0,0 +1,103 @@
+# encoding: UTF-8
+# frozen_string_literal: true
+
+# Requirements
+# =======================================================================
+
+### Deps ###
+
+# We need {YARD::CLI::Command}
+require 'yard'
+
+### Project / Package ###
+
+# `.make_missing`, `.set` from {YARD::LinkStdlib::RubySource}
+require 'yard/link_stdlib/ruby_source'
+
+
+# Namespace
+# =======================================================================
+
+module  YARD
+module  CLI
+class   LinkStdlib < Command
+
+
+# Definitions
+# =======================================================================
+
+module CommandHelper
+  
+  def description
+    self.class::DESCRIPTION
+  end
+  
+  
+  def usage
+    self.class::USAGE
+  end
+  
+  
+  def check_args! args, count
+    if args.length < count
+      log.error "Too few args! Expected #{ count }, given #{ args.length }"
+      exit false
+    elsif args.length > count
+      log.error "Too many args! Expected #{ count }, given #{ args.length }"
+      exit false
+    end
+    
+    if args.length == 1 then args[ 0 ] else args end
+  end
+
+  
+  def opts
+    @opts ||= {}
+  end
+  
+
+  def add_header op, text = nil
+    op.banner = description
+    op.separator ''
+    op.separator 'Usage:'
+    op.separator ''
+    op.separator "    #{ usage }"
+    op.separator ''
+    unless text.nil?
+      text.lines.each { |line| op.separator line }
+    end
+    
+    # Call {YARD::CLI::Command#common_options}, which adds file loading, plugin
+    # loading, logging, YARD version and help options
+    common_options( op )
+  end
+  
+  def add_version_opt op
+    # **DON'T** make missing versions by default here!
+    YARD::LinkStdlib::RubySource.make_missing = false
+    
+    op.on(
+      '-R VERSION',
+      '--ruby-version=VERSION',
+      %(Set Ruby version)
+    ) { |ruby_version|
+      YARD::LinkStdlib::RubyVersion.set ruby_version
+    }
+    
+    op.on(
+      '--make-missing',
+      %(Download and make an object map if the Ruby version is not present)
+    ) { |make_missing|
+      YARD::LinkStdlib::RubySource.make_missing = make_missing
+    }
+  end
+  
+end # CommandHelper
+
+
+# /Namespace
+# =======================================================================
+
+end # class  LinkStdlib
+end # module CLI
+end # module YARD

data/lib/yard/cli/link_stdlib/help.rb

@@ -0,0 +1,72 @@
+# encoding: UTF-8
+# frozen_string_literal: true
+
+# Requirements
+# =======================================================================
+
+### Stdlib ###
+
+require 'optparse'
+
+### Deps ###
+
+# We need {YARD::CLI::Command}
+require 'yard'
+
+### Project / Package ###
+
+require_relative './command_helper'
+
+
+# Namespace
+# =======================================================================
+
+module  YARD
+module  CLI
+class   LinkStdlib < Command
+
+
+# Definitions
+# =======================================================================
+
+class Help < Command
+    
+    include CommandHelper
+    
+    USAGE = "yard stdlib help [OTHER_OPTIONS]"
+    DESCRIPTION = "Show this message"
+
+    def run *args
+      OptionParser.new { |op|
+        add_header op
+      }.parse! args
+      
+      commands = LinkStdlib.commands
+      log.puts <<~END
+        yard-link_stdlib provides linking to online Ruby docs for standard 
+        library code objects.
+        
+        Usage:
+        
+            yard stdlib COMMAND... [OPTIONS] [ARGS]
+        
+        Commands:
+        
+      END
+      commands.keys.sort_by(&:to_s).each do |command_name|
+        command_class = commands[command_name]
+        next unless command_class < Command
+        command = command_class.new
+        log.puts "%-8s %s" % [command_name, command.description]
+      end
+      log.puts
+    end
+  end
+
+
+# /Namespace
+# =======================================================================
+
+end # class  LinkStdlib
+end # module CLI
+end # module YARD

data/lib/yard/cli/link_stdlib/list.rb

@@ -0,0 +1,59 @@
+# encoding: UTF-8
+# frozen_string_literal: true
+
+# Requirements
+# =======================================================================
+
+### Stdlib ###
+
+require 'optparse'
+
+### Deps ###
+
+# We need {YARD::CLI::Command}
+require 'yard'
+
+### Project / Package ###
+
+require_relative './command_helper'
+
+
+# Namespace
+# =======================================================================
+
+module  YARD
+module  CLI
+class   LinkStdlib < Command
+
+
+# Definitions
+# =======================================================================
+
+class List < Command
+  include CommandHelper
+  
+  DESCRIPTION = "List Ruby versions"
+  USAGE = "yard stdlib list"
+
+  def run *args
+    OptionParser.new { |op|
+      add_header op
+    }.parse! args
+    
+    check_args! args, 0
+    
+    log.puts \
+      YARD::LinkStdlib::ObjectMap.
+        all.
+        map { |om| om.version.to_s }.
+        join( "\n" )
+  end
+end # class List
+
+
+# /Namespace
+# =======================================================================
+
+end # class  LinkStdlib
+end # module CLI
+end # module YARD

data/lib/yard/cli/link_stdlib/search.rb

@@ -0,0 +1,156 @@
+# encoding: UTF-8
+# frozen_string_literal: true
+
+# Requirements
+# =======================================================================
+
+### Stdlib ###
+
+require 'optparse'
+
+### Deps ###
+
+# We need {YARD::CLI::Command}
+require 'yard'
+
+### Project / Package ###
+
+require_relative './command_helper'
+
+
+# Namespace
+# =======================================================================
+
+module  YARD
+module  CLI
+class   LinkStdlib < Command
+
+
+# Definitions
+# =======================================================================
+
+# Hooks into {YARD::LinkStdlib::ObjectMap#grep} to search for names using 
+# regular expressions.
+# 
+class Search < Command
+  
+  include CommandHelper
+  
+  DESCRIPTION = "Find stdlib names that match Regexp patterns"
+  USAGE = "yard stdlib search [OPTIONS] TERMS..."
+  
+  def run *args
+    # Default format is `:plain`
+    opts[ :format ] = :plain
+    
+    OptionParser.new { |op|
+      add_header op, <<~END
+        Examples:
+        
+          1.  {Pathname} instance methods
+              
+                  $ yard stdlib search '^Pathname#'
+        
+          2.  All `#to_s` methods
+              
+                  $ yard stdlib search '#to_s$'
+          
+          3.  Print results in serialized formats.
+              
+              All `#to_s` instance methods in JSON:
+              
+                  $ yard stdlib search --format=json '#to_s$'
+              
+              Supports a short `-f` flag and first-letter formats too.
+              
+              Instance methods of {Array} in YAML:
+              
+                  $ yard stdlib search -f y '^Array#'
+      END
+      
+      add_version_opt op
+      
+      op.on(  '-u', '--urls',
+              %(Print doc URLs along with names)
+      ) { |urls| opts[ :urls ] = !!urls }
+      
+      op.on(  '-f FORMAT', '--format=FORMAT',
+              %(Specify print format: (p)lain, (j)son or (y)aml)
+      ) { |format|
+        opts[ :format ] = \
+          case format.downcase
+          when 'p', 'plain'
+            :plain
+          when 'j', 'json'
+            :json
+          when 'y', 'yaml'
+            :yaml
+          else
+            log.fatal \
+              %(Unknown format - expected "plain", "json" or "yaml"; ) +
+              %(given #{ format.inspect })
+            exit false
+          end
+      }
+      
+    }.parse! args
+    
+    if args.empty?
+      YARD::LinkStdlib::ObjectMap.
+        current.
+        names.
+        sort_by( &:downcase ).
+        each { |key| log.puts key }
+      exit true
+    end
+    
+    terms = args.map { |arg|
+      begin
+        Regexp.new arg
+      rescue RegexpError => error
+        Regexp.new \
+          Regexp.escape( YARD::LinkStdlib.normalize_name( arg ) )
+      end
+    }
+    
+    log.debug "Terms:\n  " + terms.map( &:to_s ).join( "\n  " )
+    
+    names = YARD::LinkStdlib.grep *terms
+    
+    results = \
+      if opts[ :urls ]
+        names.each_with_object( {} ) { |name, hash|
+          hash[ name ] = YARD::LinkStdlib::ObjectMap.current.url_for name
+        }
+      else
+        names
+      end
+    
+    case opts[ :format ]
+    when :plain
+      results.each do |entry|
+        if entry.is_a? ::Array
+          log.puts "#{ entry[0] } <#{ entry[ 1 ]}>"
+        else
+          log.puts entry
+        end
+      end
+    when :json
+      require 'json'
+      log.puts JSON.pretty_generate( results )
+    when :yaml
+      require 'yaml'
+      log.puts YAML.dump( results )
+    end
+    
+    exit true
+  end
+end # class Search
+
+
+# /Namespace
+# =======================================================================
+
+end # class  LinkStdlib
+end # module CLI
+end # module YARD

data/lib/yard/cli/link_stdlib/url.rb

@@ -0,0 +1,65 @@
+# encoding: UTF-8
+# frozen_string_literal: true
+
+# Requirements
+# =======================================================================
+
+### Stdlib ###
+
+require 'optparse'
+
+### Deps ###
+
+# We need {YARD::CLI::Command}
+require 'yard'
+
+### Project / Package ###
+
+require_relative './command_helper'
+
+
+# Namespace
+# =======================================================================
+
+module  YARD
+module  CLI
+class   LinkStdlib < Command
+
+
+# Definitions
+# =======================================================================
+
+class URL < Command
+  
+  include CommandHelper
+  
+  DESCRIPTION = "Print the online doc URL for a stdlib name"
+  USAGE = "yard stdlib url [OPTIONS] NAME"
+  
+  def run *args
+    OptionParser.new { |op|
+      add_header op
+      add_version_opt op
+    }.parse! args
+    
+    name = check_args! args, 1
+    
+    url = YARD::LinkStdlib::ObjectMap.current.url_for name
+    
+    if url.nil?
+      $stderr.puts "Name not found: #{ name.inspect }"
+      exit false
+    end
+    
+    puts url
+    exit true
+  end
+end
+
+
+# /Namespace
+# =======================================================================
+
+end # class  LinkStdlib
+end # module CLI
+end # module YARD

data/lib/yard/link_stdlib.rb

@@ -290,7 +290,7 @@ module  LinkStdlib
   # 
   # @example Puke if it's not a {String}
   #   YARD::LinkStdlib.normalize_name 123
-  #   #=> raise TypeError, %(`name` must be a String, given Fixnum: 123)
+  #   #=> raise TypeError, %(`name` must be a String, given Integer: 123)
   # 
   # @example Handle operator singleton methods separated by '.'
   #   YARD::LinkStdlib.normalize_name 'Dir.[]'

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: yard-link_stdlib
 version: !ruby/object:Gem::Version
-  version: 0.1.3
+  version: 0.1.7
 platform: ruby
 authors:
 - nrser
-autorequire: 
+autorequire:
 bindir: exe
 cert_chain: []
-date: 2019-03-20 00:00:00.000000000 Z
+date: 2021-04-06 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: yard
@@ -44,70 +44,56 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '12.3'
+        version: '13.0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '12.3'
-- !ruby/object:Gem::Dependency
-  name: rspec
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '3.7'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '3.7'
+        version: '13.0'
 - !ruby/object:Gem::Dependency
   name: pry
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.11.3
+        version: 0.14.0
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.11.3
+        version: 0.14.0
 - !ruby/object:Gem::Dependency
   name: pry-rescue
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 1.4.5
+        version: 1.5.2
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 1.4.5
+        version: 1.5.2
 - !ruby/object:Gem::Dependency
   name: pry-stack_explorer
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.4.9
+        version: 0.6.1
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.4.9
+        version: 0.6.1
 - !ruby/object:Gem::Dependency
   name: yard-commonmarker
   requirement: !ruby/object:Gem::Requirement
@@ -167,6 +153,12 @@ files:
 - bin/make_map.rb
 - lib/yard-link_stdlib.rb
 - lib/yard/cli/link_stdlib.rb
+- lib/yard/cli/link_stdlib/add.rb
+- lib/yard/cli/link_stdlib/command_helper.rb
+- lib/yard/cli/link_stdlib/help.rb
+- lib/yard/cli/link_stdlib/list.rb
+- lib/yard/cli/link_stdlib/search.rb
+- lib/yard/cli/link_stdlib/url.rb
 - lib/yard/link_stdlib.rb
 - lib/yard/link_stdlib/html_helper.rb
 - lib/yard/link_stdlib/object_map.rb
@@ -176,11 +168,14 @@ files:
 - maps/ruby-2.3.0.json.gz
 - maps/ruby-2.4.0.json.gz
 - maps/ruby-2.5.0.json.gz
+- maps/ruby-2.6.0.json.gz
+- maps/ruby-2.7.0.json.gz
+- maps/ruby-3.0.0.json.gz
 homepage: https://github.com/nrser/yard-link_stdlib
 licenses:
 - BSD
 metadata: {}
-post_install_message: 
+post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -195,9 +190,8 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubyforge_project: 
-rubygems_version: 2.5.2.3
-signing_key: 
+rubygems_version: 3.2.3
+signing_key:
 specification_version: 4
 summary: A YARD plugin & patch to link Ruby stdlib references.
 test_files: []