dm_ruby_extensions 1.0.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 062e84718734bf691ec38ab67f2a9465178f3c80
+  data.tar.gz: 72ccb7dbc6f0e758b53ea5077a3f0132052de08f
+SHA512:
+  metadata.gz: 54a75c8ac9d30a8095178ce580d969f41f954face5835825ed1a730c2bbbc43a4a3b22e0ac20bf0ea237acc86fa0d5ee5b47a5122d05d418060afd4fc999dc5a
+  data.tar.gz: 3133f59828e0906e4060b4afeb21b9b1bd1469e7daec0a840c099451000d4d682025b1323cb118ce6489f6ca10752c7beb7926fdc088472897cf001590e71372

data/.gitignore

@@ -0,0 +1,20 @@
+*.gem
+*.rbc
+.bundle
+.config
+.yardoc
+Gemfile.lock
+InstalledFiles
+_yardoc
+coverage
+doc/
+lib/bundler/man
+pkg
+rdoc
+spec/reports
+test/tmp
+test/version_tmp
+tmp
+
+/.ruby-version
+/.ruby-gemset

data/.rspec

@@ -0,0 +1,3 @@
+--color
+--require spec_helper
+--format documentation

data/Gemfile

@@ -0,0 +1,7 @@
+source 'https://rubygems.org'
+
+gemspec
+
+gem 'rake'
+gem 'byebug'
+gem 'rspec'

data/LICENSE

@@ -0,0 +1,22 @@
+Copyright 2013 digitalMoksha LLC
+
+MIT License
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README.md

@@ -0,0 +1,89 @@
+# DmRubyExtensions
+
+Adds some simple convienence methods to some Ruby classes, for use in the digitalMoksha gems.  Although some of these can be found in other libraries, this includes a small handful and removes the dependency on another large library.
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+    gem 'dm_ruby_extensions'
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install dm_ruby_extensions
+
+## Usage
+
+#### Array
+
+* extract_options!
+* closest_max
+* xss_aware_join
+* css_join
+
+#### Date
+
+* to_age
+* localize
+
+#### DateTime
+
+* to_age
+* localize
+
+#### Fixnum
+
+* factorial
+* as_boolean
+
+#### Hash
+
+* convert_date
+* convert_datetime
+* url_query_string
+* rekey
+* rekey!
+
+#### Nil
+
+* to_s_default
+* as_boolean
+* to_age
+* sql_wildcard
+
+#### Numeric
+
+* percent_of
+
+#### String
+
+* to_s_default
+* as_boolean
+* as_css_size
+* sql_wildcard
+* replace_non_alphanumeric
+* expand_url
+* absolute_url?
+* smart_titlecase
+* smart_capitalize
+* smart_capitalize!
+* smart_truncate
+* name_case
+* name_case!
+
+#### Time
+
+* localize
+
+
+## Contributing
+
+1. Fork it
+2. Create your feature branch (`git checkout -b my-new-feature`)
+3. Commit your changes (`git commit -am 'Add some feature'`)
+4. Push to the branch (`git push origin my-new-feature`)
+5. Create new Pull Request

data/Rakefile

@@ -0,0 +1,7 @@
+require "bundler/gem_tasks"
+require "rspec/core/rake_task"
+
+RSpec::Core::RakeTask.new
+
+task :default => :spec
+task :test => :spec

data/dm_ruby_extensions.gemspec

@@ -0,0 +1,21 @@
+# -*- encoding: utf-8 -*-
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'dm_ruby_extensions/version'
+
+Gem::Specification.new do |gem|
+  gem.name          = "dm_ruby_extensions"
+  gem.version       = DmRubyExtensions::VERSION
+  gem.authors       = ["Brett Walker"]
+  gem.email         = ["github@digitalmoksha.com"]
+  gem.description   = %q{Ruby base class extensions}
+  gem.summary       = %q{Simple Ruby base class extensions}
+  gem.homepage      = "https://github.com/digitalmoksha/dm_ruby_extensions"
+  gem.licenses      = ['MIT']
+
+  gem.files         = `git ls-files`.split($/)
+  gem.test_files    = gem.files.grep(%r{^(test|spec|features)/})
+  gem.require_paths = ["lib"]
+  
+  gem.add_dependency 'activesupport', '~> 4.0'
+end

data/lib/dm_ruby_extensions.rb

@@ -0,0 +1,15 @@
+require "dm_ruby_extensions/version"
+require "dm_ruby_extensions/extend_array"
+require "dm_ruby_extensions/extend_date"
+require "dm_ruby_extensions/extend_datetime"
+require "dm_ruby_extensions/extend_hash"
+require "dm_ruby_extensions/extend_nil"
+require "dm_ruby_extensions/extend_string"
+require "dm_ruby_extensions/extend_time"
+require "dm_ruby_extensions/extend_fixnum"
+require "dm_ruby_extensions/extend_numeric"
+
+require 'active_support/core_ext/string'
+
+module DmRubyExtensions
+end

data/lib/dm_ruby_extensions/extend_array.rb

@@ -0,0 +1,46 @@
+#------------------------------------------------------------------------------
+class Array
+
+  # Extract options from a set of arguments. Removes and returns the last element in the array if it's a hash, otherwise returns a blank hash.
+  #
+  #   def options(*args)
+  #     args.extract_options!
+  #   end
+  #
+  #   options(1, 2)           # => {}
+  #   options(1, 2, :a => :b) # => {:a=>:b}
+  #------------------------------------------------------------------------------
+  def extract_options!
+    last.is_a?(::Hash) ? pop : {}
+  end
+
+  # Return the value that is closest to the value in the array, rounded down.
+  # [0,5,7,8,11,16].closest_max(6) => 5
+  # [0,5,7,8,11,16].closest_max(7) => 7
+  #------------------------------------------------------------------------------
+  def closest_max(value)
+    self.select{|item| item <= value}.max
+  end
+
+  # able to join safe and unsafe strings
+  #------------------------------------------------------------------------------
+  def xss_aware_join(delimiter = '')
+    ''.html_safe.tap do |str|
+      each_with_index do |element, i|
+        str << delimiter if i > 0
+        str << element
+      end
+    end
+  end
+
+  # given an array of css classes/styles, join them into one string.
+  # only join non-nil/non-empty strings, and return nil if the result
+  # is an empty string (rails tag methods will not include the 
+  # attribute if it is nil, which is desirable for cleaner html)
+  #------------------------------------------------------------------------------
+  def css_join(delimiter = '')
+    str = self.flatten.delete_if {|x| x.nil? || x == ''}.join(' ')
+    str == '' ? nil : str
+  end
+end
+

data/lib/dm_ruby_extensions/extend_date.rb

@@ -0,0 +1,23 @@
+class Date
+
+  # http://stackoverflow.com/questions/819263/get-persons-age-in-ruby
+  #------------------------------------------------------------------------------
+  def to_age
+    now = Time.now.utc.to_date
+    now.year - self.year - ((now.month > self.month || (now.month == self.month && now.day >= self.day)) ? 0 : 1)
+  end
+  
+  #------------------------------------------------------------------------------
+  def localize(options = {})
+    options = {:format => options} if options.class == String      
+    I18n.localize(self, options)
+  end
+
+  # Create a unique sortable index for this date
+  #------------------------------------------------------------------------------
+  def to_index
+    yday + (year-2000) * 1000
+  end
+
+end
+

data/lib/dm_ruby_extensions/extend_datetime.rb

@@ -0,0 +1,22 @@
+#------------------------------------------------------------------------------
+class DateTime
+
+  #------------------------------------------------------------------------------
+  def to_age
+    (DateTime.now - self).to_i / 365
+  end
+
+  #------------------------------------------------------------------------------
+  def localize(options = {})
+    options = {:format => options} if options.class == String      
+    I18n.localize(self, options)
+  end
+  
+  # Create a unique sortable index for this date
+  #------------------------------------------------------------------------------
+  def to_index
+    yday + (year-2000) * 1000
+  end
+
+end
+

data/lib/dm_ruby_extensions/extend_fixnum.rb

@@ -0,0 +1,16 @@
+class Fixnum
+  
+  # Factorial of number
+  # 5.factorial == 5 x 4 x 3 x 2 x 1 == 120
+  #------------------------------------------------------------------------------
+  def factorial
+    return 1 if self.zero?
+    (1..self).inject(:*)
+  end
+  
+  #------------------------------------------------------------------------------
+  def as_boolean
+    (self > 0) ? true : false
+  end
+
+end

data/lib/dm_ruby_extensions/extend_hash.rb

@@ -0,0 +1,109 @@
+#------------------------------------------------------------------------------
+class Hash
+  
+  # takes a Hash (like the params hash), and converts the Rails date attributes 
+  # to a real Date object.
+  # {'start_date(1i)' => 2012, 'start_date(2i)' => 11, 'start_date(3i)' => 23}.convert_date(:start_date)   
+  #------------------------------------------------------------------------------
+  def convert_date(date_symbol_or_string)
+    attribute = date_symbol_or_string.to_s
+    return nil if self[attribute + '(1i)'].nil? || self[attribute + '(2i)'].nil? || self[attribute + '(3i)'].nil? 
+    return Date.new(self[attribute + '(1i)'].to_i, self[attribute + '(2i)'].to_i, self[attribute + '(3i)'].to_i)   
+  end
+
+  # takes a Hash (like the params hash), and converts the Rails datetime attributes 
+  # to a real Date object.
+  #------------------------------------------------------------------------------
+  def convert_datetime(date_symbol_or_string)
+    attribute = date_symbol_or_string.to_s
+    return nil if self[attribute + '(1i)'].nil? || self[attribute + '(2i)'].nil? || self[attribute + '(3i)'].nil? || self[attribute + '(4i)'].nil? || self[attribute + '(5i)'].nil? 
+    return Time.local(self[attribute + '(1i)'].to_i, self[attribute + '(2i)'].to_i, self[attribute + '(3i)'].to_i, self[attribute + '(4i)'].to_i, self[attribute + '(5i)'].to_i)   
+  end
+
+  # Convert hash of parameters to a query string
+  #------------------------------------------------------------------------------
+  def url_query_string(leading_slash = true)
+    (leading_slash ? "/?" : "?") << URI.escape(self.collect{|k,v| "#{k}=#{v}"}.join('&'))
+  end
+
+  # Borrowed from https://github.com/rubyworks/facets
+  #------------------------------------------------------------------------------
+  # Rekey a hash:
+  #
+  #   rekey()
+  #   rekey(from_key => to_key, ...)
+  #   rekey{|from_key| to_key}
+  #   rekey{|from_key, value| to_key}
+  #
+  # If a key map is given, then the first key is changed to the second key.
+  #
+  #   foo = { :a=>1, :b=>2 }
+  #   foo.rekey(:a=>'a')       #=> { 'a'=>1, :b=>2 }
+  #   foo.rekey(:b=>:x)        #=> { :a =>1, :x=>2 }
+  #   foo.rekey('foo'=>'bar')  #=> { :a =>1, :b=>2 }
+  #
+  # If a block is given, converts all keys in the Hash accroding to the
+  # given block procedure.
+  #
+  #   foo = { :name=>'Gavin', :wife=>:Lisa }
+  #   foo.rekey{ |k| k.to_s }  #=>  { "name"=>"Gavin", "wife"=>:Lisa }
+  #   foo                      #=>  { :name =>"Gavin", :wife=>:Lisa }
+  #
+  # If no key map or block is given, then all keys are converted
+  # to Symbols.
+  #
+  # Raises an ArgumentError if both a +key_map+ and a block are given.
+  # If both are needed just call #rekey twice.
+  #
+  # TODO: If `nil` is returned by block should the key be set to `nil` or the orignal key?
+  #
+  # CREDIT: Trans, Gavin Kistner
+
+  def rekey(key_map=nil, &block)
+    raise ArgumentError, "argument or block" if key_map && block
+
+    if !(key_map or block)
+      block = lambda{|k| k.to_sym}
+    end
+
+    if block
+      hash = dup.clear
+      if block.arity.abs == 1
+        each_pair do |k, v|
+          hash[block[k]] = v     #hash[block[k] || k] = v
+        end
+      else
+        each_pair do |k, v|
+          hash[block[k,v]] = v   #hash[block[k,v] || k] = v
+        end
+      end
+    else
+      #hash = dup.clear  # to keep default_proc
+      #(keys - key_map.keys).each do |key|
+      #  hash[key] = self[key]
+      #end
+      #key_map.each do |from, to|
+      #  hash[to] = self[from] if key?(from)
+      #end
+      hash = dup  # to keep default_proc
+      key_map.each_pair do |from, to|
+        hash[to] = hash.delete(from) if hash.key?(from)
+      end
+    end
+
+    hash
+  end
+
+  # Synonym for Hash#rekey, but modifies the receiver in place (and returns it).
+  #
+  #   foo = { :name=>'Gavin', :wife=>:Lisa }
+  #   foo.rekey!{ |k| k.to_s }  #=>  { "name"=>"Gavin", "wife"=>:Lisa }
+  #   foo                       #=>  { "name"=>"Gavin", "wife"=>:Lisa }
+  #
+  # CREDIT: Trans, Gavin Kistner
+
+  def rekey!(key_map=nil, &block)
+    replace(rekey(key_map, &block))
+  end
+
+end

data/lib/dm_ruby_extensions/extend_nil.rb

@@ -0,0 +1,36 @@
+# If nil, then return a default string
+#------------------------------------------------------------------------------
+class NilClass #:nodoc:
+
+  #------------------------------------------------------------------------------
+  def to_s_default(default_str = 'n/a')
+    default_str
+  end
+
+  #------------------------------------------------------------------------------
+  def as_boolean
+    false
+  end
+  
+  #------------------------------------------------------------------------------
+  def to_age
+    0
+  end
+
+  #------------------------------------------------------------------------------
+  def sql_wildcard
+    "%"	  
+  end
+  
+  #------------------------------------------------------------------------------
+  def utc
+    ""
+  end
+  
+  # if nil + something, just return something
+  #------------------------------------------------------------------------------
+  def +(y)
+    y
+  end
+
+end

data/lib/dm_ruby_extensions/extend_numeric.rb

@@ -0,0 +1,8 @@
+class Numeric
+  
+  #------------------------------------------------------------------------------
+  def percent_of(n, precision = 0)
+    n == 0 ? 0 : (self.to_f / n.to_f * 100.0).round(precision)
+  end
+
+end

data/lib/dm_ruby_extensions/extend_string.rb

@@ -0,0 +1,193 @@
+# If the string is empty, then return a default string
+#------------------------------------------------------------------------------
+class String  #:nodoc:
+
+  # If the string is empty, return a default value, otherwise the string
+  #------------------------------------------------------------------------------
+  def to_s_default(default_str = 'n/a')
+    (empty? || strip.empty?) ? default_str : self.to_s
+  end
+  
+  #------------------------------------------------------------------------------
+  def as_boolean
+    (self == 'true' || self == 'yes' || self == '1') ? true : false
+  end
+
+  # given a css type of size (like a width), make it into a valid css value
+  #------------------------------------------------------------------------------
+  def as_css_size
+    size = self
+    size += 'px' unless size.blank? || size.end_with?('px', '%', 'em') || size == 'auto' || size == 'inherit'
+    return size
+  end
+
+  # Adds SQL wildcard cahracters to begin/end of string for use in LIKE statements
+  #------------------------------------------------------------------------------
+  def sql_wildcard
+    "%#{self}%"	  
+  end
+  
+  # Replace non-alphanumbic character
+  #------------------------------------------------------------------------------
+  def replace_non_alphanumeric(replacement = '')
+    self.gsub /[^\w\.\-]/, replacement
+  end
+  
+  # Santize the string
+  #   Note: File.basename doesn't work right with Windows paths on Unix
+  #------------------------------------------------------------------------------
+  def sanitize_filename
+    name = self.strip
+    #--- get only the filename, not the whole path
+    name.gsub! /^.*(\\|\/)/, ''
+    
+    #--- Finally, replace all non alphanumeric, underscore or periods with underscore
+    name.gsub! /[^\w\.\-]/, '_'
+    return name
+  end
+
+  # if a relative url path is given, then expand it by prepending the supplied 
+  # path.
+  #------------------------------------------------------------------------------
+  def expand_url(path = '')
+    if self.blank? || self.absolute_url?
+      return self
+    else
+      return path + self
+    end
+  end
+
+  # Test if a url is absolute
+  #------------------------------------------------------------------------------
+  def absolute_url?
+    (self.include?('://') || self.start_with?('/')) ? true : false
+  end
+
+  #------------------------------------------------------------------------------
+
+  # Ruby version of John Gruber's TitleCase.pl, from http://github.com/samsouder/titlecase
+  # Used for better capitalizing titles and sentences
+  #------------------------------------------------------------------------------
+  def smart_titlecase
+    small_words = %w(a an and as at but by en for if in of on or the to v v. via vs vs. von)
+    
+    x = split(" ").map do |word|
+      # note: word could contain non-word characters!
+      # downcase all small_words, capitalize the rest
+      small_words.include?(word.gsub(/\W/, "").downcase) ? word.downcase! : word.smart_capitalize!
+      word
+    end
+    # capitalize first and last words
+    x.first.smart_capitalize!
+    x.last.smart_capitalize!
+    # small words after colons are capitalized
+    x.join(" ").gsub(/:\s?(\W*#{small_words.join("|")}\W*)\s/) { ": #{$1.smart_capitalize} " }
+  end
+  
+  #------------------------------------------------------------------------------
+  def smart_capitalize
+    # ignore any leading crazy characters and capitalize the first real character
+    if self =~ /^['"\(\[']*([a-z])/
+      i = index($1)
+      x = self[i,self.length]
+      # word with capitals and periods mid-word are left alone
+      self[i,1] = self[i,1].upcase unless x =~ /[A-Z]/ or x =~ /\.\w+/
+    end
+    self
+  end
+  
+  #------------------------------------------------------------------------------
+  def smart_capitalize!
+    replace(smart_capitalize)
+  end
+
+  # Truncate the string to a set or words, or sentences.
+  # string.smart_truncate(:sentences => 3)
+  # string.smart_truncate(:words => 12)
+  # From http://stackoverflow.com/questions/1293573/rails-smart-text-truncation
+  #------------------------------------------------------------------------------
+  def smart_truncate(opts = {})
+    opts = {:words => 12}.merge(opts)
+    if opts[:sentences]
+      return self.split(/\.(\s|$)+/).reject{ |s| s.strip.empty? }[0, opts[:sentences]].map{|s| s.strip}.join('. ') + '...'
+    end
+    a = self.split(/\s/) # or /[ ]+/ to only split on spaces
+    n = opts[:words]
+    a[0...n].join(' ') + (a.size > n ? '...' : '')    
+  end
+  #------------------------------------------------------------------------------
+  
+  # http://github.com/tenderlove/namecase
+  # NameCase is a Ruby implementation of Lingua::EN::NameCase, a library for
+  # converting strings/names to be properly cased. This is good for converting
+  # denormalized data to human friendly data.
+  #------------------------------------------------------------------------------
+  def name_case(options = {})
+    options = { :lazy => true, :irish => true }.merge options
+
+    # Skip if string is mixed case
+    if options[:lazy]
+      first_letter_lower = self[0] == self.downcase[0]
+      all_lower_or_upper = (self.downcase == self || self.upcase == self)
+
+      return self unless first_letter_lower || all_lower_or_upper
+    end
+
+    localstring = downcase
+    localstring.gsub!(/\b\w/) { |first| first.upcase }
+    localstring.gsub!(/\'\w\b/) { |c| c.downcase } # Lowercase 's
+
+    if options[:irish]
+      if localstring =~ /\bMac[A-Za-z]{2,}[^aciozj]\b/ or localstring =~ /\bMc/
+        match = localstring.match(/\b(Ma?c)([A-Za-z]+)/)
+        localstring.gsub!(/\bMa?c[A-Za-z]+/) { match[1] + match[2].capitalize }
+
+        # Now fix "Mac" exceptions
+        localstring.gsub!(/\bMacEdo/, 'Macedo')
+        localstring.gsub!(/\bMacEvicius/, 'Macevicius')
+        localstring.gsub!(/\bMacHado/, 'Machado')
+        localstring.gsub!(/\bMacHar/, 'Machar')
+        localstring.gsub!(/\bMacHin/, 'Machin')
+        localstring.gsub!(/\bMacHlin/, 'Machlin')
+        localstring.gsub!(/\bMacIas/, 'Macias')
+        localstring.gsub!(/\bMacIulis/, 'Maciulis')
+        localstring.gsub!(/\bMacKie/, 'Mackie')
+        localstring.gsub!(/\bMacKle/, 'Mackle')
+        localstring.gsub!(/\bMacKlin/, 'Macklin')
+        localstring.gsub!(/\bMacKmin/, 'Mackmin')
+        localstring.gsub!(/\bMacQuarie/, 'Macquarie')
+      end
+      localstring.gsub!('Macmurdo','MacMurdo')
+    end
+
+    # Fixes for "son (daughter) of" etc
+    localstring.gsub!(/\bAl(?=\s+\w)/, 'al')  # al Arabic or forename Al.
+    localstring.gsub!(/\bAp\b/, 'ap')         # ap Welsh.
+    localstring.gsub!(/\bBen(?=\s+\w)/,'ben') # ben Hebrew or forename Ben.
+    localstring.gsub!(/\bDell([ae])\b/,'dell\1')  # della and delle Italian.
+    localstring.gsub!(/\bD([aeiou])\b/,'d\1')   # da, de, di Italian; du French; do Brasil
+    localstring.gsub!(/\bD([ao]s)\b/,'d\1')   # das, dos Brasileiros
+    localstring.gsub!(/\bDe([lr])\b/,'de\1')   # del Italian; der Dutch/Flemish.
+    localstring.gsub!(/\bEl\b/,'el')   # el Greek or El Spanish.
+    localstring.gsub!(/\bLa\b/,'la')   # la French or La Spanish.
+    localstring.gsub!(/\bL([eo])\b/,'l\1')      # lo Italian; le French.
+    localstring.gsub!(/\bVan(?=\s+\w)/,'van')  # van German or forename Van.
+    localstring.gsub!(/\bVon\b/,'von')  # von Dutch/Flemish
+
+    # Fix roman numeral names
+    localstring.gsub!(
+      / \b ( (?: [Xx]{1,3} | [Xx][Ll]   | [Ll][Xx]{0,3} )?
+             (?: [Ii]{1,3} | [Ii][VvXx] | [Vv][Ii]{0,3} )? ) \b /x
+    ) { |match| match.upcase }
+
+    localstring
+  end
+  
+  # Modifies _str_ in place and properly namecases the string.
+  #------------------------------------------------------------------------------
+  def name_case!
+    self.gsub!(self, self.name_case)
+  end
+  
+end
+

data/lib/dm_ruby_extensions/extend_time.rb

@@ -0,0 +1,11 @@
+#------------------------------------------------------------------------------
+class Time
+
+  #------------------------------------------------------------------------------
+  def localize(options = {})
+    options = {:format => options} if options.class == String      
+    I18n.localize(self, options)
+  end
+
+end
+

data/lib/dm_ruby_extensions/version.rb

@@ -0,0 +1,3 @@
+module DmRubyExtensions
+  VERSION = "1.0.0"
+end

data/spec/extensions/array_spec.rb

@@ -0,0 +1,39 @@
+require 'spec_helper'
+require 'dm_ruby_extensions'
+
+describe Array do
+
+  describe 'closest_max' do
+    #------------------------------------------------------------------------------
+    it 'return the value that is closest to the value in the array, rounded down' do
+      expect([0,5,7,8,11,16].closest_max(6)).to eq 5
+      expect([0,5,7,8,11,16].closest_max(7)).to eq 7
+    end
+  end
+
+  describe 'extract_options!' do
+    #------------------------------------------------------------------------------
+    it "Removes and returns the last element in the array if it's a hash, otherwise returns a blank hash" do
+      args = [1, 2, {:a => :b}]
+      expect(args.extract_options!).to eq ({:a => :b})
+      expect(args).to eq [1, 2]
+      expect(args.extract_options!).to eq ({})
+    end
+  end
+  
+  describe 'xss_aware_join' do
+    it 'safely join safe and unsafe strings' do
+      safe    = "<p>Safe</p>".html_safe
+      unsafe  = "<script></script>"
+      expect([safe, unsafe].xss_aware_join).to eq "<p>Safe</p>&lt;script&gt;&lt;/script&gt;"
+      expect([safe, unsafe].xss_aware_join.class).to eq ActiveSupport::SafeBuffer
+    end
+  end
+  
+  describe 'css_join' do
+    it 'given an array of css classes/styles, join them into one string' do
+      classes = ['panel', '', 'panel-body', nil, 'red']
+      expect(classes.css_join(' ')).to eq 'panel panel-body red'
+    end
+  end
+end

data/spec/extensions/date_spec.rb

@@ -0,0 +1,29 @@
+require 'spec_helper'
+require 'dm_ruby_extensions'
+
+describe Date do
+
+  describe 'to_age' do
+    it 'return number of years since now', pending: 'not sure how to test' do
+      expect(Date.new(1967, 1, 23).to_age).to eq 0
+    end
+  end
+  
+  describe 'localize' do
+    it 'localize the date based on the format' do
+      I18n.enforce_available_locales = false
+      I18n.locale = :en
+      date = Date.new(2012, 11, 23)
+      expect(date.localize).to eq '2012-11-23'
+      expect(date.localize(format: :short)).to eq 'Nov 23'
+      expect(date.localize('%b %Y')).to eq 'Nov 2012'
+    end
+  end
+  
+  describe 'to_index' do
+    it 'creates unique sortable index for a date' do
+      date = Date.new(2012, 11, 23)
+      expect(date.to_index).to eq 12328
+    end
+  end
+end

data/spec/extensions/datetime_spec.rb

@@ -0,0 +1,29 @@
+require 'spec_helper'
+require 'dm_ruby_extensions'
+
+describe DateTime do
+
+  describe 'to_age' do
+    it 'return number of years since now', pending: 'not sure how to test' do
+      expect(DateTime.new(1967, 1, 23).to_age).to eq 0
+    end
+  end
+  
+  describe 'localize' do
+    it 'localize the date based on the format' do
+      I18n.enforce_available_locales = false
+      I18n.locale = :en
+      date = DateTime.new(2012, 11, 23, 8, 35)
+      expect(date.localize).to eq 'Fri, 23 Nov 2012 08:35:00 +0000'
+      expect(date.localize(format: :short)).to eq '23 Nov 08:35'
+      expect(date.localize('%b %Y')).to eq 'Nov 2012'
+    end
+  end
+  
+  describe 'to_index' do
+    it 'creates unique sortable index for a date' do
+      date = Date.new(2012, 11, 23)
+      expect(date.to_index).to eq 12328
+    end
+  end
+end

data/spec/extensions/fixnum_spec.rb

@@ -0,0 +1,20 @@
+require 'spec_helper'
+require 'dm_ruby_extensions'
+
+describe Fixnum do
+
+  describe 'factorial' do
+    #------------------------------------------------------------------------------
+    it 'return the factorial of the number' do
+      expect(5.factorial).to eq 120
+      expect(1.factorial).to eq 1
+    end
+  end
+
+  describe 'as_boolean' do
+    specify { expect(1.as_boolean).to be_truthy }
+    specify { expect(0.as_boolean).to be_falsey }
+    specify { expect(20.as_boolean).to be_truthy }
+  end
+
+end

data/spec/extensions/hash_spec.rb

@@ -0,0 +1,55 @@
+require 'spec_helper'
+require 'dm_ruby_extensions'
+
+describe Hash do
+
+  describe 'convert_date' do
+    #------------------------------------------------------------------------------
+    it 'converts a rails date hash' do
+      datehash = {'start_date(1i)' => 2012, 'start_date(2i)' => 11, 'start_date(3i)' => 23}
+      expect(datehash.convert_date(:start_date)).to eq Date.new(2012, 11, 23)
+      expect(datehash.convert_date(:end_date)).to eq nil
+    end
+  end
+
+  describe 'convert_datetime' do
+    #------------------------------------------------------------------------------
+    it 'converts a rails datetime hash' do
+      datehash = {'start_date(1i)' => 2012, 'start_date(2i)' => 11, 'start_date(3i)' => 23, 'start_date(4i)' => 8, 'start_date(5i)' => 35}
+      expect(datehash.convert_datetime(:start_date)).to eq Time.local(2012, 11, 23, 8, 35)
+      expect(datehash.convert_datetime(:end_date)).to eq nil
+    end
+  end
+
+  describe 'url_query_string' do
+    #------------------------------------------------------------------------------
+    it 'converts hash of parameters to a query string' do
+      params = {tag: 'shoe', as_admin: '1'}
+      expect(params.url_query_string).to eq '/?tag=shoe&as_admin=1'
+      expect(params.url_query_string(false)).to eq '?tag=shoe&as_admin=1'
+    end
+  end
+
+  describe 'rekey' do
+    #------------------------------------------------------------------------------
+    it 'if a key map is given, then the first key is changed to the second key.' do
+      foo = { :a => 1, :b => 2 }
+      expect(foo.rekey(:a=>'a')).to eq({ 'a' => 1, :b => 2 })
+      expect(foo.rekey(:b=>:x)).to eq({ :a => 1, :x => 2 })
+      expect(foo.rekey('foo'=>'bar')).to eq({ :a => 1, :b => 2 })
+    end
+    
+    #------------------------------------------------------------------------------
+    it 'converts all keys in the Hash accroding to the given block procedure' do
+      foo = { :name=>'Gavin', :wife=>:Lisa }
+      expect(foo.rekey{ |k| k.to_s }).to eq({ "name" => "Gavin", "wife" => :Lisa })
+    end
+    
+    #------------------------------------------------------------------------------
+    it 'converts all keys to symbols' do
+      foo = { 'name' => 'Gavin', 'wife' => :Lisa }
+      expect(foo.rekey).to eq({ :name => "Gavin", :wife => :Lisa })
+    end
+  end
+
+end

data/spec/extensions/nil_spec.rb

@@ -0,0 +1,34 @@
+require 'spec_helper'
+require 'dm_ruby_extensions'
+
+describe NilClass do
+
+  describe 'to_s_default' do
+    it 'returns default string' do
+      expect(nil.to_s_default).to eq 'n/a'
+      expect(nil.to_s_default('--')).to eq '--'
+    end
+  end
+
+  describe 'as_boolean' do
+    specify { expect(nil.as_boolean).to eq false }
+  end
+  
+  describe 'to_age' do
+    specify { expect(nil.to_age).to eq 0}
+  end
+
+  describe 'sql_wildcard' do
+    specify { expect(nil.sql_wildcard).to eq '%' }
+  end
+
+  describe 'utc' do
+    specify { expect(nil.utc).to eq '' }
+  end
+  
+  describe '+(y)' do
+    specify { expect(nil + 12).to eq 12 }
+    specify { expect(nil + 'foo').to eq 'foo' }
+  end
+
+end

data/spec/extensions/numeric_spec.rb

@@ -0,0 +1,14 @@
+require 'spec_helper'
+require 'dm_ruby_extensions'
+
+describe Numeric do
+
+  describe 'percent_of' do
+    it 'returns percentage of number' do
+      expect(25.percent_of(100)).to eq 25
+      expect(25.percent_of(80)).to eq 31
+      expect(25.percent_of(80, 2)).to eq 31.25
+    end
+  end
+
+end

data/spec/extensions/string_spec.rb

@@ -0,0 +1,113 @@
+require 'spec_helper'
+require 'dm_ruby_extensions'
+
+describe String do
+
+  describe 'to_s_default' do
+    specify { expect('foobar'.to_s_default).to eq 'foobar'}
+    specify { expect(''.to_s_default).to eq 'n/a'}
+    specify { expect(''.to_s_default('--')).to eq '--'}
+  end
+
+  describe 'as_boolean' do
+    specify { expect('true'.as_boolean).to be_truthy }
+    specify { expect('yes'.as_boolean).to be_truthy }
+    specify { expect('1'.as_boolean).to be_truthy }
+    specify { expect('false'.as_boolean).to be_falsey }
+    specify { expect('foo'.as_boolean).to be_falsey }
+  end
+
+  describe 'as_css_size' do
+    specify { expect('50'.as_css_size).to eq '50px'}
+    specify { expect(''.as_css_size).to eq ''}
+    specify { expect('50px'.as_css_size).to eq '50px'}
+    specify { expect('50%'.as_css_size).to eq '50%'}
+    specify { expect('50em'.as_css_size).to eq '50em'}
+    specify { expect('auto'.as_css_size).to eq 'auto'}
+    specify { expect('inherit'.as_css_size).to eq 'inherit'}
+  end
+  
+  describe 'sql_wildcard' do
+    specify { expect('foobar'.sql_wildcard).to eq '%foobar%'}
+  end
+
+  describe 'replace_non_alphanumeric' do
+    specify { expect('fo9o^()b  ar'.replace_non_alphanumeric).to eq 'fo9obar' }
+    specify { expect('fo9o^()b  ar'.replace_non_alphanumeric('*')).to eq 'fo9o***b**ar' }
+  end
+
+  describe 'sanitize_filename' do
+    specify { expect('foobar.doc'.sanitize_filename).to eq 'foobar.doc'}
+    specify { expect('/user/home/foobar.doc'.sanitize_filename).to eq 'foobar.doc'}
+    specify { expect('/user/home/f9o o(b+a^r.d*c'.sanitize_filename).to eq 'f9o_o_b_a_r.d_c'}
+  end
+
+  describe 'expand_url' do
+    specify { expect('/home/foobar.doc'.expand_url).to eq '/home/foobar.doc' }
+    specify { expect('foobar.doc'.expand_url).to eq 'foobar.doc' }
+    specify { expect('foobar.doc'.expand_url('/home/')).to eq '/home/foobar.doc' }
+    specify { expect('/foobar.doc'.expand_url('/home/')).to eq '/foobar.doc' }
+  end
+
+  describe 'absolute_url?' do
+    specify { expect('/home/foo'.absolute_url?).to be_truthy }
+    specify { expect('://home/foo'.absolute_url?).to be_truthy }
+    specify { expect('home/foo'.absolute_url?).to be_falsey }
+  end
+
+  describe 'smart_titlecase' do
+    specify { expect('a sample title and text: a treatsie'.smart_titlecase).to eq 'A Sample Title and Text: A Treatsie'}
+  end
+
+  describe 'smart_capitalize' do
+    specify { expect('foobar'.smart_capitalize).to eq 'Foobar' }
+    specify { expect('fooBar'.smart_capitalize).to eq 'fooBar' }
+    specify { expect('(foobar)'.smart_capitalize).to eq '(Foobar)' }
+  end
+
+  describe 'smart_truncate' do
+    specify { expect('One time. Two times. 3 times. 4 times.'.smart_truncate(sentences: 3)).to eq 'One time. Two times. 3 times...' }
+    specify { expect('one two three and four five six and seven and yet another eight'.smart_truncate(words: 6)).to eq 'one two three and four five...' }
+    specify { expect('one two three and four five six and seven and yet another eight'.smart_truncate).to eq 'one two three and four five six and seven and yet another...' }
+  end
+
+  describe 'name_case' do
+    before :each do
+      @proper_names = [
+        "Keith",            "Leigh-Williams",       "McCarthy",
+        "O'Callaghan",      "St. John",             "von Streit",
+        "van Dyke",         "Van",                  "ap Llwyd Dafydd",
+        "al Fahd",          "Al",
+        "el Grecco",
+        "ben Gurion",       "Ben",
+        "da Vinci",
+        "di Caprio",        "du Pont",              "de Legate",
+        "del Crond",        "der Sind",             "van der Post",
+        "von Trapp",        "la Poisson",           "le Figaro",
+        "Mack Knife",       "Dougal MacDonald",
+        # Mac exceptions
+        "Machin",           "Machlin",              "Machar",
+        "Mackle",           "Macklin",              "Mackie",
+        "Macquarie",        "Machado",              "Macevicius",
+        "Maciulis",         "Macias",               "MacMurdo",
+        # Roman numerals
+        "Henry VIII",       "Louis III",            "Louis XIV",
+        "Charles II",       "Fred XLIX",
+      ]
+    end
+
+    it 'handles each proper name' do
+      @proper_names.each do |name|
+        expect(name.downcase.name_case).to eq name
+        expect(name.name_case).to eq name
+        # assert_equal(name, NameCase(name))
+      end
+    end
+
+    it 'handles multibyte' do
+      proper_cased = 'Iñtërnâtiônàlizætiøn'
+      expect(proper_cased.downcase.name_case).to eq proper_cased
+    end
+
+  end
+end

data/spec/extensions/time_spec.rb

@@ -0,0 +1,16 @@
+require 'spec_helper'
+require 'dm_ruby_extensions'
+
+describe Time do
+
+  describe 'localize' do
+    it 'localize the date based on the format' do
+      I18n.enforce_available_locales = false
+      I18n.locale = :en
+      time = Time.parse("2012-11-23 08:35 utc")
+      expect(time.localize).to eq 'Fri, 23 Nov 2012 08:35:00 +0000'
+      expect(time.localize(format: :short)).to eq '23 Nov 08:35'
+      expect(time.localize('%b %Y')).to eq 'Nov 2012'
+    end
+  end
+end

data/spec/spec_helper.rb

@@ -0,0 +1,85 @@
+# This file was generated by the `rails generate rspec:install` command. Conventionally, all
+# specs live under a `spec` directory, which RSpec adds to the `$LOAD_PATH`.
+# The generated `.rspec` file contains `--require spec_helper` which will cause this
+# file to always be loaded, without a need to explicitly require it in any files.
+#
+# Given that it is always loaded, you are encouraged to keep this file as
+# light-weight as possible. Requiring heavyweight dependencies from this file
+# will add to the boot time of your test suite on EVERY test run, even for an
+# individual file that may not need all of that loaded. Instead, consider making
+# a separate helper file that requires the additional dependencies and performs
+# the additional setup, and require it from the spec files that actually need it.
+#
+# The `.rspec` file also contains a few flags that are not defaults but that
+# users commonly want.
+#
+# See http://rubydoc.info/gems/rspec-core/RSpec/Core/Configuration
+RSpec.configure do |config|
+  # rspec-expectations config goes here. You can use an alternate
+  # assertion/expectation library such as wrong or the stdlib/minitest
+  # assertions if you prefer.
+  config.expect_with :rspec do |expectations|
+    # This option will default to `true` in RSpec 4. It makes the `description`
+    # and `failure_message` of custom matchers include text for helper methods
+    # defined using `chain`, e.g.:
+    # be_bigger_than(2).and_smaller_than(4).description
+    #   # => "be bigger than 2 and smaller than 4"
+    # ...rather than:
+    #   # => "be bigger than 2"
+    expectations.include_chain_clauses_in_custom_matcher_descriptions = true
+  end
+
+  # rspec-mocks config goes here. You can use an alternate test double
+  # library (such as bogus or mocha) by changing the `mock_with` option here.
+  config.mock_with :rspec do |mocks|
+    # Prevents you from mocking or stubbing a method that does not exist on
+    # a real object. This is generally recommended, and will default to
+    # `true` in RSpec 4.
+    mocks.verify_partial_doubles = true
+  end
+
+# The settings below are suggested to provide a good initial experience
+# with RSpec, but feel free to customize to your heart's content.
+=begin
+  # These two settings work together to allow you to limit a spec run
+  # to individual examples or groups you care about by tagging them with
+  # `:focus` metadata. When nothing is tagged with `:focus`, all examples
+  # get run.
+  config.filter_run :focus
+  config.run_all_when_everything_filtered = true
+
+  # Limits the available syntax to the non-monkey patched syntax that is recommended.
+  # For more details, see:
+  #   - http://myronmars.to/n/dev-blog/2012/06/rspecs-new-expectation-syntax
+  #   - http://teaisaweso.me/blog/2013/05/27/rspecs-new-message-expectation-syntax/
+  #   - http://myronmars.to/n/dev-blog/2014/05/notable-changes-in-rspec-3#new__config_option_to_disable_rspeccore_monkey_patching
+  config.disable_monkey_patching!
+
+  # Many RSpec users commonly either run the entire suite or an individual
+  # file, and it's useful to allow more verbose output when running an
+  # individual spec file.
+  if config.files_to_run.one?
+    # Use the documentation formatter for detailed output,
+    # unless a formatter has already been configured
+    # (e.g. via a command-line flag).
+    config.default_formatter = 'doc'
+  end
+
+  # Print the 10 slowest examples and example groups at the
+  # end of the spec run, to help surface which specs are running
+  # particularly slow.
+  config.profile_examples = 10
+
+  # Run specs in random order to surface order dependencies. If you find an
+  # order dependency and want to debug it, you can fix the order by providing
+  # the seed, which is printed after each run.
+  #     --seed 1234
+  config.order = :random
+
+  # Seed global randomization in this process using the `--seed` CLI option.
+  # Setting this allows you to use `--seed` to deterministically reproduce
+  # test failures related to randomization by passing the same `--seed` value
+  # as the one that triggered the failure.
+  Kernel.srand config.seed
+=end
+end

metadata

@@ -0,0 +1,96 @@
+--- !ruby/object:Gem::Specification
+name: dm_ruby_extensions
+version: !ruby/object:Gem::Version
+  version: 1.0.0
+platform: ruby
+authors:
+- Brett Walker
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2015-06-18 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: activesupport
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '4.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '4.0'
+description: Ruby base class extensions
+email:
+- github@digitalmoksha.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- ".rspec"
+- Gemfile
+- LICENSE
+- README.md
+- Rakefile
+- dm_ruby_extensions.gemspec
+- lib/dm_ruby_extensions.rb
+- lib/dm_ruby_extensions/extend_array.rb
+- lib/dm_ruby_extensions/extend_date.rb
+- lib/dm_ruby_extensions/extend_datetime.rb
+- lib/dm_ruby_extensions/extend_fixnum.rb
+- lib/dm_ruby_extensions/extend_hash.rb
+- lib/dm_ruby_extensions/extend_nil.rb
+- lib/dm_ruby_extensions/extend_numeric.rb
+- lib/dm_ruby_extensions/extend_string.rb
+- lib/dm_ruby_extensions/extend_time.rb
+- lib/dm_ruby_extensions/version.rb
+- spec/extensions/array_spec.rb
+- spec/extensions/date_spec.rb
+- spec/extensions/datetime_spec.rb
+- spec/extensions/fixnum_spec.rb
+- spec/extensions/hash_spec.rb
+- spec/extensions/nil_spec.rb
+- spec/extensions/numeric_spec.rb
+- spec/extensions/string_spec.rb
+- spec/extensions/time_spec.rb
+- spec/spec_helper.rb
+homepage: https://github.com/digitalmoksha/dm_ruby_extensions
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.4.5
+signing_key: 
+specification_version: 4
+summary: Simple Ruby base class extensions
+test_files:
+- spec/extensions/array_spec.rb
+- spec/extensions/date_spec.rb
+- spec/extensions/datetime_spec.rb
+- spec/extensions/fixnum_spec.rb
+- spec/extensions/hash_spec.rb
+- spec/extensions/nil_spec.rb
+- spec/extensions/numeric_spec.rb
+- spec/extensions/string_spec.rb
+- spec/extensions/time_spec.rb
+- spec/spec_helper.rb