facets 2.9.2 → 2.9.3

data/lib/core/facets/process.rb

@@ -1,8 +1,4 @@
-# Require all Process core extensions.
+require 'facets/kernel/require_relative'
 
-if RUBY_VERSION < '1.9'
-  require "facets/process/daemon.rb"
-else
-  require_relative "process/daemon.rb"
-end
+require_relative 'process/daemon.rb'
 

data/lib/core/facets/range.rb

@@ -1,16 +1,9 @@
-# Require all Range core extensions.
+require 'facets/kernel/require_relative'
 
-if RUBY_VERSION < '1.9'
-  require "facets/range/combine.rb"
-  require "facets/range/overlap.rb"
-  require "facets/range/to_r.rb"
-  require "facets/range/umbrella.rb"
-  require "facets/range/within.rb"
-else
-  require_relative "range/combine.rb"
-  require_relative "range/overlap.rb"
-  require_relative "range/to_r.rb"
-  require_relative "range/umbrella.rb"
-  require_relative "range/within.rb"
-end
+require_relative 'range/combine.rb'
+require_relative 'range/overlap.rb'
+#require_relative 'range/quantile.rb'    # uncommon
+require_relative 'range/to_r.rb'
+require_relative 'range/umbrella.rb'
+require_relative 'range/within.rb'
 

data/lib/core/facets/range/quantile.rb

@@ -0,0 +1,18 @@
+class Range
+
+  # Calculate the kth n-tile in a range.
+  #
+  # If n=4 the quantity is called a quartile, and if n=100
+  # it is called a percentile.
+  #
+  # @uncommon
+  #   require 'facets/range/quantile'
+  #
+  # @return [Integer] the kth n-tile
+  def quantile(k, n=100)
+    return 1 if k < first
+    return n if k >= last
+    ((k - first) / ((last - first) / n.to_f)).to_i + 1
+  end
+
+end

data/lib/core/facets/regexp.rb

@@ -1,16 +1,8 @@
-# Require all Regexp core extensions.
+require 'facets/kernel/require_relative'
 
-if RUBY_VERSION < '1.9'
-  require "facets/regexp/arity.rb"
-  require "facets/regexp/multiline.rb"
-  require "facets/regexp/op_add.rb"
-  require "facets/regexp/op_or.rb"
-  require "facets/regexp/to_re.rb"
-else
-  require_relative "regexp/arity.rb"
-  require_relative "regexp/multiline.rb"
-  require_relative "regexp/op_add.rb"
-  require_relative "regexp/op_or.rb"
-  require_relative "regexp/to_re.rb"
-end
+require_relative 'regexp/arity.rb'
+require_relative 'regexp/multiline.rb'
+require_relative 'regexp/op_add.rb'
+require_relative 'regexp/op_or.rb'
+require_relative 'regexp/to_re.rb'
 

data/lib/core/facets/regexp/op_or.rb

@@ -1,17 +1,14 @@
 class Regexp
 
-  # Add regular expressions.
+  # Operator form of `Regexp.union`.
   #
-  #   /a/ | /b/ == /(?-mix:a)(?-mix:b)/
+  #   /a/ | /b/  #=> /(?-mix:a)|(?-mix:b)/
   #
-  # Functionally equivalent to:
+  # If +other+ is not a Regexp it is passed to Regexp.escape.
   #
-  #   /ab/
-  #
-  # CREDIT:
   def |(other)
-    other = Regexp.escape(other) if other.is_a?(String)
-    /#{self}|#{other}/
+    other = Regexp.escape(other) unless Regexp === other
+    Regexp.union(self, other)
   end
 
 end

data/lib/{core-uncommon/facets/integer → core/facets}/roman.rb

@@ -22,8 +22,12 @@ class Integer
 
   # Converts this integer to a roman numeral.
   #
-  # NOTE: This is not (presently) a common core extension and is not
+  # NOTE: This method is not a common core extension and is not
   # loaded automatically when using <code>require 'facets'</code>.
+  #
+  # @uncommon
+  #   require 'facets/integer/roman'
+  #
   def roman
     int = self
     #return nil if integer > ROMAN_MAX
@@ -49,8 +53,12 @@ class String
   # Considers string a Roman numeral numeral,
   # and converts it to the corresponding integer.
   #
-  # NOTE: This is not (presently) a common core extension and is not
+  # NOTE: This method is not a common core extension and is not
   # loaded automatically when using <code>require 'facets'</code>.
+  #
+  # @uncommon
+  #   require 'facets/string/roman'
+  #
   def roman
     roman = upcase
     raise unless roman?
@@ -67,8 +75,12 @@ class String
 
   # Returns true iif the subject is a valid Roman numeral.
   #
-  # NOTE: This is not (presently) a common core extension and is not
+  # NOTE: This method is not a common core extension and is not
   # loaded automatically when using <code>require 'facets'</code>.
+  #
+  # @uncommon
+  #   require 'facets/string/roman'
+  #
   def roman?
     ROMAN =~ upcase
   end

data/lib/core/facets/string.rb

@@ -1,136 +1,71 @@
-# Require all String core extensions.
+require 'facets/kernel/require_relative'
 
-if RUBY_VERSION < '1.9'
-  require "facets/string/align.rb"
-  require "facets/string/bracket.rb"
-  require "facets/string/bytes.rb"
-  require "facets/string/camelcase.rb"
-  require "facets/string/capitalized.rb"
-  require "facets/string/characters.rb"
-  require "facets/string/cleanlines.rb"
-  require "facets/string/cleave.rb"
-  require "facets/string/cmp.rb"
-  require "facets/string/compress_lines.rb"
-  require "facets/string/divide.rb"
-  require "facets/string/each_char.rb"
-  require "facets/string/each_word.rb"
-  require "facets/string/edit_distance.rb"
-  require "facets/string/end_with.rb"
-  require "facets/string/exclude.rb"
-  require "facets/string/expand_tab.rb"
-  require "facets/string/file.rb"
-  require "facets/string/fold.rb"
-  require "facets/string/indent.rb"
-  require "facets/string/index_all.rb"
-  require "facets/string/interpolate.rb"
-  require "facets/string/lchomp.rb"
-  require "facets/string/line_wrap.rb"
-  require "facets/string/lines.rb"
-  require "facets/string/lowercase.rb"
-  require "facets/string/margin.rb"
-  require "facets/string/methodize.rb"
-  require "facets/string/modulize.rb"
-  require "facets/string/mscan.rb"
-  require "facets/string/natcmp.rb"
-  require "facets/string/nchar.rb"
-  require "facets/string/newlines.rb"
-  require "facets/string/op_div.rb"
-  require "facets/string/op_sub.rb"
-  require "facets/string/outdent.rb"
-  require "facets/string/pathize.rb"
-  require "facets/string/quote.rb"
-  require "facets/string/random_binary.rb"
-  require "facets/string/range.rb"
-  require "facets/string/range_all.rb"
-  require "facets/string/range_of_line.rb"
-  require "facets/string/rewrite.rb"
-  require "facets/string/shatter.rb"
-  require "facets/string/similarity.rb"
-  require "facets/string/snakecase.rb"
-  require "facets/string/splice.rb"
-  require "facets/string/squish.rb"
-  require "facets/string/start_with.rb"
-  require "facets/string/store.rb"
-  require "facets/string/subtract.rb"
-  require "facets/string/tab.rb"
-  require "facets/string/tabto.rb"
-  require "facets/string/titlecase.rb"
-  require "facets/string/to_re.rb"
-  require "facets/string/unbracket.rb"
-  require "facets/string/underscore.rb"
-  require "facets/string/unfold.rb"
-  require "facets/string/unindent.rb"
-  require "facets/string/unquote.rb"
-  require "facets/string/uppercase.rb"
-  require "facets/string/variablize.rb"
-  require "facets/string/word_wrap.rb"
-  require "facets/string/words.rb"
-  require "facets/string/xor.rb"
-else
-  require_relative "string/align.rb"
-  require_relative "string/bracket.rb"
-  require_relative "string/bytes.rb"
-  require_relative "string/camelcase.rb"
-  require_relative "string/capitalized.rb"
-  require_relative "string/characters.rb"
-  require_relative "string/cleanlines.rb"
-  require_relative "string/cleave.rb"
-  require_relative "string/cmp.rb"
-  require_relative "string/compress_lines.rb"
-  require_relative "string/divide.rb"
-  require_relative "string/each_char.rb"
-  require_relative "string/each_word.rb"
-  require_relative "string/edit_distance.rb"
-  require_relative "string/end_with.rb"
-  require_relative "string/exclude.rb"
-  require_relative "string/expand_tab.rb"
-  require_relative "string/file.rb"
-  require_relative "string/fold.rb"
-  require_relative "string/indent.rb"
-  require_relative "string/index_all.rb"
-  require_relative "string/interpolate.rb"
-  require_relative "string/lchomp.rb"
-  require_relative "string/line_wrap.rb"
-  require_relative "string/lines.rb"
-  require_relative "string/lowercase.rb"
-  require_relative "string/margin.rb"
-  require_relative "string/methodize.rb"
-  require_relative "string/modulize.rb"
-  require_relative "string/mscan.rb"
-  require_relative "string/natcmp.rb"
-  require_relative "string/nchar.rb"
-  require_relative "string/newlines.rb"
-  require_relative "string/op_div.rb"
-  require_relative "string/op_sub.rb"
-  require_relative "string/outdent.rb"
-  require_relative "string/pathize.rb"
-  require_relative "string/quote.rb"
-  require_relative "string/random_binary.rb"
-  require_relative "string/range.rb"
-  require_relative "string/range_all.rb"
-  require_relative "string/range_of_line.rb"
-  require_relative "string/rewrite.rb"
-  require_relative "string/shatter.rb"
-  require_relative "string/similarity.rb"
-  require_relative "string/snakecase.rb"
-  require_relative "string/splice.rb"
-  require_relative "string/squish.rb"
-  require_relative "string/start_with.rb"
-  require_relative "string/store.rb"
-  require_relative "string/subtract.rb"
-  require_relative "string/tab.rb"
-  require_relative "string/tabto.rb"
-  require_relative "string/titlecase.rb"
-  require_relative "string/to_re.rb"
-  require_relative "string/unbracket.rb"
-  require_relative "string/underscore.rb"
-  require_relative "string/unfold.rb"
-  require_relative "string/unindent.rb"
-  require_relative "string/unquote.rb"
-  require_relative "string/uppercase.rb"
-  require_relative "string/variablize.rb"
-  require_relative "string/word_wrap.rb"
-  require_relative "string/words.rb"
-  require_relative "string/xor.rb"
-end
+require_relative 'string/acronym.rb'
+require_relative 'string/align.rb'
+require_relative 'string/bracket.rb'
+require_relative 'string/bytes.rb'
+require_relative 'string/camelcase.rb'
+require_relative 'string/capitalized.rb'
+require_relative 'string/characters.rb'
+require_relative 'string/cleanlines.rb'
+require_relative 'string/cleave.rb'
+require_relative 'string/cmp.rb'
+require_relative 'string/compress_lines.rb'
+#require_relative 'string/crypt.rb'          # uncommon
+require_relative 'string/divide.rb'
+require_relative 'string/each_char.rb'
+require_relative 'string/each_word.rb'
+require_relative 'string/edit_distance.rb'
+require_relative 'string/end_with.rb'
+require_relative 'string/exclude.rb'
+require_relative 'string/expand_tab.rb'
+require_relative 'string/file.rb'
+require_relative 'string/fold.rb'
+require_relative 'string/indent.rb'
+require_relative 'string/index_all.rb'
+require_relative 'string/interpolate.rb'
+require_relative 'string/lchomp.rb'
+require_relative 'string/lines.rb'
+require_relative 'string/line_wrap.rb'
+require_relative 'string/lowercase.rb'
+require_relative 'string/margin.rb'
+require_relative 'string/methodize.rb'
+require_relative 'string/modulize.rb'
+require_relative 'string/mscan.rb'
+require_relative 'string/natcmp.rb'
+require_relative 'string/nchar.rb'
+require_relative 'string/newlines.rb'
+require_relative 'string/op_div.rb'
+require_relative 'string/op_sub.rb'
+require_relative 'string/outdent.rb'
+require_relative 'string/pathize.rb'
+require_relative 'string/quote.rb'
+require_relative 'string/random_binary.rb'
+require_relative 'string/range.rb'
+require_relative 'string/range_all.rb'
+require_relative 'string/range_of_line.rb'
+require_relative 'string/rewrite.rb'
+#require_relative 'integer/roman.rb'         # uncommon
+require_relative 'string/shatter.rb'
+require_relative 'string/similarity.rb'
+require_relative 'string/snakecase.rb'
+require_relative 'string/splice.rb'
+require_relative 'string/squish.rb'
+require_relative 'string/start_with.rb'
+require_relative 'string/store.rb'
+require_relative 'string/subtract.rb'
+require_relative 'string/tab.rb'
+require_relative 'string/tabto.rb'
+require_relative 'string/titlecase.rb'
+require_relative 'string/to_re.rb'
+require_relative 'string/unbracket.rb'
+require_relative 'string/underscore.rb'
+require_relative 'string/unfold.rb'
+require_relative 'string/unindent.rb'
+require_relative 'string/unquote.rb'
+require_relative 'string/uppercase.rb'
+require_relative 'string/variablize.rb'
+require_relative 'string/words.rb'
+require_relative 'string/word_wrap.rb'
+require_relative 'string/xor.rb'
 

data/{src/core-uncommon → lib/core}/facets/string/acronym.rb

@@ -1,7 +1,10 @@
 class String
 
+  # Transform a string into an acronym.
+  #
   # CREDIT: Robert Fey
-  def acronymize
+  #
+  def acronym
 	  gsub(/(([a-zA-Z0-9])([a-zA-Z0-9])*)./,"\\2")
   end
 

data/lib/core/facets/string/briefcase.rb

@@ -0,0 +1 @@
+require 'facets/string/titlecase'

data/lib/core/facets/string/camelcase.rb

@@ -1,61 +1,72 @@
 class String
 
-  # Converts a string to camelcase.
-  #
-  # By default camelcase upcases the first character of the string.
-  # If +first_letter+ is set to +:lower+ or +true+, then +#camelcase+ will
-  # produce lowerCamelCase. If it is set to +:upper+ or +nil+ it will
-  # produce UpperCamelCase. If it is set to :inter or +false+ it will
-  # leave the first character as given.
-  #
-  # +#camelcase+ also converts '/' to '::' which is useful for converting
-  # paths to namespaces.
-  #
-  #   "camel_case".camelcase           #=> "CamelCase"
-  #   "camel/case".camelcase(:upper)   #=> "Camel::Case"
-  #   "Camel_case".camelcase(:lower)   #=> "camelCase"
-  #   "camel_case".camelcase(:inter)   #=> "camelCase"
-  #   "Camel/case".camelcase(:inter)   #=> "Camel::Case"
-  #
-  unless method_defined?(:camelcase)
-    def camelcase(first_letter=nil)
-      case first_letter
-      when :lower, true
-        lower_camelcase
-      when :inter, false
-        inter_camelcase
-      else
-        upper_camelcase
-        #str = dup
-        #str.gsub!(/\/(.?)/){ "::#{$1.upcase}" }  # NOT SO SURE ABOUT THIS
-        #str.gsub!(/(?:_+|-+)([a-z])/){ $1.upcase }
-        #str.gsub!(/(\A|\s)([a-z])/){ $1 + $2.upcase }
-        #str
-      end
+  # Converts a string to camelcase. This method leaves the first character
+  # as given. This allows other methods to be used first, such as #uppercase
+  # and #lowercase.
+  #
+  #   "camel_case".camelcase          #=> "camelCase"
+  #   "Camel_case".camelcase          #=> "CamelCase"
+  #
+  # Custom +separators+ can be used to specify the patterns used to determine
+  # where capitalization should occur. By default these are underscores (`_`)
+  # and space characters (`\s`).
+  #
+  #   "camel/case".camelcase('/')     #=> "camelCase"
+  #
+  # If the first separator is a symbol, either `:lower` or `:upper`, then
+  # the first characters of the string will be downcased or upcased respectively.
+  #
+  #   "camel_case".camelcase(:upper)  #=> "CamelCase"
+  #
+  # Note that this implementation is different from ActiveSupport's.
+  # If that is what you are looking for you may want {#modulize}.
+  #
+  def camelcase(*separators)
+    case separators.first
+    when Symbol, TrueClass, FalseClass, NilClass
+      first_letter = separators.shift
+    end
+
+    separators = ['_', '\s'] if separators.empty?
+
+    str = self.dup
+
+    separators.each do |s|
+      str = str.gsub(/(?:#{s}+)([a-z])/){ $1.upcase }
+    end
+
+    case first_letter
+    when :upper, true
+      str = str.gsub(/(\A|\s)([a-z])/){ $1 + $2.upcase }
+    when :lower, false
+      str = str.gsub(/(\A|\s)([A-Z])/){ $1 + $2.downcase }
     end
-  end
 
-  def inter_camelcase
-    str = dup
-    str.gsub!(/\/(.?)/){ "::#{$1.upcase}" }  # NOT SO SURE ABOUT THIS
-    str.gsub!(/(?:_+|-+)([a-z])/){ $1.upcase }
-    #str.gsub!(/(\A|\s)([a-z])/){ $1 + $2.upcase }
     str
   end
 
-  def upper_camelcase
-    #str = dup
-    #str.gsub!(/\/(.?)/){ "::#{$1.upcase}" }  # NOT SO SURE ABOUT THIS
-    #str.gsub!(/(?:_+|-+)([a-z])/){ $1.upcase }
-    inter_camelcase.gsub(/(\A|\s)([a-z])/){ $1 + $2.upcase }
+  # Same as +#camelcase+ but converts first letter to uppercase.
+  #
+  #   "camel_case".upper_camelcase   #=> "CamelCase"
+  #   "Camel_case".upper_camelcase   #=> "CamelCase"
+  #
+  # @deprecated
+  #   Use `#camelcase(:upper)` instead.
+  #
+  def upper_camelcase(*separators)
+    camelcase(:upper, *separators)
   end
 
-  def lower_camelcase
-    #str = dup
-    #str = dup
-    #str.gsub!(/\/(.?)/){ "::#{$1.upcase}" }  # NOT SO SURE ABOUT THIS
-    #str.gsub!(/(?:_+|-+)([a-z])/){ $1.upcase }
-    inter_camelcase.gsub(/(\A|\s)([A-Z])/){ $1 + $2.downcase }
+  # Same as +#camelcase+ but converts first letter to lowercase.
+  #
+  #   "camel_case".lower_camelcase   #=> "camelCase"
+  #   "Camel_case".lower_camelcase   #=> "camelCase"
+  #
+  # @deprecated
+  #   Use `#camelcase(:lower)` instead.
+  #
+  def lower_camelcase(*separators)
+    camelcase(:lower, *separators)
   end
 
 end