nrser 0.3.6 → 0.3.7

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: c4c0b136095e4afd7f800b70365fef71ab0d6aa8
-  data.tar.gz: 0e7ae07d35167aef235790e048469175e278678d
+  metadata.gz: ea96a298163ec6b20a0437bc7ab7c8ea9200fd99
+  data.tar.gz: c6aabc018e890bfa791e20925b2c32240c4110d7
 SHA512:
-  metadata.gz: dca7159d865ba58bb26a0fe3a24f4cdab90c09416509cc7f7d466aad6c5a23dd5fa6f5f0d35b4adb9a6d2e93c9ea52f03f8f63b03f237e5e3cabc3374f258d5f
-  data.tar.gz: 4de1a2e02822d68a529f37ce1bcf53f25c4f8100284fb841c3bf254509d0f0a85adacdc823c1a857da5de7f0d8c9911214bc3e1ab4984d576a468aaba3646d75
+  metadata.gz: 29d05d08cc6d63ee707ad4ce1bf34b4b148a132ee669749ad1a01eb392ba1ef6d842c1be240cbf0ec2d514e3acd320c70e2f84e86376d93ad54a688ffa428244
+  data.tar.gz: 4dc97cdc270fc79692b1a7ffcba3c569ae3649247f78e16b128603933c40ebb05c925fe934b53a5c082f23788cde3444ba4cf7f082143b27274c53104647cac5

data/lib/nrser/core_ext/pathname.rb

@@ -11,7 +11,13 @@ class Pathname
   #   true if the Pathname starts with any of the prefixes.
   # 
   def start_with? *prefixes
-    to_s.start_with? *prefixes.map(&:to_s)
+    to_s.start_with? *prefixes.map { |prefix|
+      if Pathname === prefix
+        prefix.to_s
+      else
+        prefix
+      end
+    }
   end
   
   
@@ -49,29 +55,52 @@ class Pathname
   end
   
   
-  # @todo Document find_root method.
-  # 
-  # @param [type] arg_name
-  #   @todo Add name param description.
-  # 
-  # @return [return_type]
-  #   @todo Document return value.
+  # See {NRSER.find_up}.
   # 
   def find_up rel_path, **kwds
     NRSER.find_up rel_path, **kwds, from: self
   end # #find_root
   
   
-  # @todo Document find_root method.
-  # 
-  # @param [type] arg_name
-  #   @todo Add name param description.
-  # 
-  # @return [return_type]
-  #   @todo Document return value.
+  # See {NRSER.find_up!}.
   # 
   def find_up! rel_path, **kwds
     NRSER.find_up! rel_path, **kwds, from: self
   end # #find_root
   
+  
+  # Shortcut to convert into a relative pathname, by default from the working
+  # directory, with option to `./` prefix.
+  # 
+  # @param [Pathname] base_dir:
+  #   Directory you want the result to be relative to.
+  # 
+  # @param [Boolean] dot_slash:
+  #   When `true` will prepend `./` to the resulting path, unless it already
+  #   starts with `../`.
+  # 
+  # @return [Pathname]
+  # 
+  def to_rel base_dir: Pathname.getwd, dot_slash: false
+    rel = relative_path_from base_dir
+    
+    if dot_slash && !rel.start_with?( /\.\.?\// )
+      File.join( '.', rel ).to_pn
+    else
+      rel
+    end
+  end
+  
+  
+  # Just a quick cut for `.to_rel.to_s`, since I seem to use that sort of form
+  # a lot.
+  # 
+  # @param (see #to_rel)
+  # 
+  # @return [String]
+  # 
+  def to_rel_s *args
+    to_rel( *args ).to_s
+  end
+  
 end # class Pathname

data/lib/nrser/core_ext/string.rb

@@ -56,6 +56,56 @@ class String
   end
   
   
+  # Alias the stdlib {#start_with?} 'cause we'll need to use it when
+  # redefining the method below.
+  # 
+  alias_method :stdlib_start_with?, :start_with?
+  
+  
+  # Augment {#start_with?} to accept {Regexp} prefixes.
+  # 
+  # I guess I always *just felt* like this should work... so now it does
+  # (kinda, at least).
+  # 
+  # Everything should work the exact same for {String} prefixes.
+  # 
+  # Use {Regexp} ones at your own pleasure and peril.
+  # 
+  # @param [String | Regexp] *prefixes
+  #   Strings behave as usual per the standard lib.
+  #   
+  #   Regexp sources are used to create a new Regexp with `\A` at the start -
+  #   unless their source already starts with `\A` or `^` - and those Regexp
+  #   are tested against the string.
+  #   
+  #   Regexp options are also copied over if a new Regexp is created. I can
+  #   def imagine things getting weird with some exotic regular expression
+  #   or another, but this feature is really indented for very simple patterns,
+  #   for which it should suffice.
+  #   
+  # @return [Boolean]
+  #   `true` if `self` starts with *any* of the `prefixes`.
+  # 
+  def start_with? *prefixes
+    unless prefixes.any? { |x| Regexp === x }
+      return stdlib_start_with? *prefixes
+    end
+  
+    prefixes.any? { |prefix|
+      case prefix
+      when Regexp
+        unless prefix.source.start_with? '\A', '^'
+          prefix = Regexp.new( "\\A#{ prefix.source }", prefix.options )
+        end
+        
+        prefix =~ self
+      else
+        stdlib_start_with? prefix
+      end
+    }
+  end
+  
+  
   # @!group Unicode Stylization
   # ==========================================================================
   

data/lib/nrser/version.rb

@@ -18,7 +18,7 @@ module NRSER
   # 
   # @return [String]
   # 
-  VERSION = '0.3.6'
+  VERSION = '0.3.7'
   
   
   module Version

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: nrser
 version: !ruby/object:Gem::Version
-  version: 0.3.6
+  version: 0.3.7
 platform: ruby
 authors:
 - nrser
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2018-05-27 00:00:00.000000000 Z
+date: 2018-06-23 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: hamster