yard-link_stdlib 0.1.2 → 0.1.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 35b7b23700c4d77f2a017aa1881974617980d255
-  data.tar.gz: 475ee0d06dfc6d358398e59eb6a80bccc09b8e8c
+  metadata.gz: 3334c95ebde62bc497aaab158361d28cb88bcb3e
+  data.tar.gz: 04117641eaf696120948d32d3e23354308e33d77
 SHA512:
-  metadata.gz: 9b2b26d8c1f3facd41e9b171d48138672a2cd8db0b166faf099ebafb3fffb2cae93150b9947f2a8660e195285b3d10e7fb86f062fc4a221fcf18ff51a5086809
-  data.tar.gz: ea374fb3df62ffcac1e5af88277bd7f96af1b0d8c9df342e801a84f67862a0895671f2e53f309c13f112a4944e3f9883f5a1f784afd4052ef0206bf36ded7fe5
+  metadata.gz: f5c660eb08a0a7656e305771d7603788b8396bec4221ee2c3030137e7ad7cfbef4682ee3a481fe62b84b3a0cd8b6972abfdc82d0fda9f39ea9ed778f161eb113
+  data.tar.gz: 227aa9d466ab557c835d84c581d205b79dbe993dd62fea51c868e03b0b9a8f60418944257ea20003717b060fb2fd56e2ad2dcd4e5a14a2764c0012a72275d8cd

data/VERSION

@@ -1 +1 @@
-0.1.2
+0.1.3

data/lib/yard/cli/link_stdlib.rb

@@ -294,7 +294,14 @@ class LinkStdlib < Command
         exit true
       end
       
-      terms = args.map { |arg| Regexp.new arg }
+      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  " )
       

data/lib/yard/link_stdlib.rb

@@ -64,6 +64,31 @@ module  LinkStdlib
   }.freeze
   
   
+  # Names of valid Ruby operator methods. Used to form 
+  # {OPERATOR_METHOD_NAME_REGEXP_FRAGMENT}.
+  # 
+  # @return [::Array<::String>]
+  # 
+  OPERATOR_METHOD_NAMES = \
+    (
+      %w([] []= ** ~ ~ @+ @- * / % + - >> << & ^ |) +
+      %w(<= < > >= <=> == === != =~ !~)
+    ).map( &:freeze )
+  
+  
+  # {Regexp} source fragment that matches a Ruby operator method name.
+  # 
+  # Used in {.normalize_name} to swap out '.' separators for '::' in operator
+  # methods.
+  # 
+  # @return [::String]
+  # 
+  OPERATOR_METHOD_NAME_REGEXP_FRAGMENT = \
+    OPERATOR_METHOD_NAMES.
+      map { |op_name| "(?:#{ Regexp.escape op_name })" }
+      .join '|'
+  
+  
   # Singleton Methods
   # ==========================================================================
   
@@ -267,6 +292,10 @@ module  LinkStdlib
   #   YARD::LinkStdlib.normalize_name 123
   #   #=> raise TypeError, %(`name` must be a String, given Fixnum: 123)
   # 
+  # @example Handle operator singleton methods separated by '.'
+  #   YARD::LinkStdlib.normalize_name 'Dir.[]'
+  #   #=> 'Dir::[]'
+  # 
   # @param [::String] name
   #   Code object name, as it may appear in YARD.
   # 
@@ -278,14 +307,15 @@ module  LinkStdlib
         "`name` must be a String, given #{ name.class }: #{ name.inspect }"
     end
     
-    # Strip off any leading `::`
-    if name.start_with? '::'
-      name = name[ 2..-1 ]
-    end
-    
     # Stdlib rdoc uses `ClassOrModule::class_method` format for class methods,
-    # so we want to convert to that
-    name.sub /\.(\w+[\?\!]?)\z/, '::\1'
+    # so we want to convert to that, and strip off any leading '::'
+    name.
+      # Strip off any leading '::'
+      sub( /\A::/, '' ).
+      # Convert most singleton methods using '.' to '::' (except operators)
+      sub( /\.(\w+[\?\!]?)\z/, '::\1' ).
+      # Convert operator singleton methods using '.' to '::'
+      sub( /\.(#{ OPERATOR_METHOD_NAME_REGEXP_FRAGMENT })\z/, '::\1' )
   end # .normalize_name
   
   

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: yard-link_stdlib
 version: !ruby/object:Gem::Version
-  version: 0.1.2
+  version: 0.1.3
 platform: ruby
 authors:
 - nrser
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2019-03-13 00:00:00.000000000 Z
+date: 2019-03-20 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: yard