ruby_core_extensions 0.0.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 73d409278a49f15845c54d39663e24a0942bd004
+  data.tar.gz: 61a669479de59c7b8e9105d674cc44d28824151a
+SHA512:
+  metadata.gz: addb261d51cdd07ced187a5efefa83d474d712875133108585a255be62168add46445b532a7816292466110c8766720394f91012c2b38db2e584a70830b700de
+  data.tar.gz: 3e37676250b767f9d97808b353e25e187c386de97f99ec457ff8a6823a7c25fbb8c74195e3488e0ed367de7db71aabb5b18ed9e600d10b558b5d839a908cbe47

data/.gitignore

@@ -0,0 +1,4 @@
+pkg
+coverage
+Gemfile.lock
+tmp

data/.rspec

@@ -0,0 +1,2 @@
+--color
+--format progress

data/.travis.yml

@@ -0,0 +1,14 @@
+language: ruby
+rvm:
+  - 2.3.0
+script: bundle exec rake spec
+gemfile:
+  - gemfiles/rails3.gemfile
+  - gemfiles/rails4.gemfile
+notifications:
+  email:
+    - support@travellink.com.au
+  flowdock:
+    secure: IK3CyMRa++LNdooemZJBZSNdwUiKpVdXZUz9exYIkj3La/EJDOy+kqV2NzYdqRht2BGHHiRsVn3hVqySDDuv9jxBHTZgM0v/pQ4kT8JZqi7fDb36axf3M6Y2VJyrJ0S/9BbHqLE95B4NXQ30ctLCSfQNbp9sOn2EwP3DZS9KJks=
+sudo: false
+cache: bundler

data/Gemfile

@@ -0,0 +1,2 @@
+source 'https://rubygems.org'
+gemspec

data/LICENSE

@@ -0,0 +1,21 @@
+The MIT License
+
+Copyright (c) Tom Preston-Werner
+
+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,37 @@
+Ruby Core Extensions 
+====================
+
+[![Build Status](https://travis-ci.org/sealink/ruby_core_extensions.png?branch=master)](https://travis-ci.org/sealink/ruby_core_extensions)
+[![Coverage Status](https://coveralls.io/repos/sealink/ruby_core_extensions/badge.png)](https://coveralls.io/r/sealink/ruby_core_extensions)
+[![Dependency Status](https://gemnasium.com/sealink/ruby_core_extensions.png?travis)](https://gemnasium.com/sealink/ruby_core_extensions)
+[![Code Climate](https://codeclimate.com/github/sealink/ruby_core_extensions.png)](https://codeclimate.com/github/sealink/ruby_core_extensions)
+
+# DESCRIPTION
+
+Extends the core ruby classes with helpful functions
+
+# INSTALLATION
+
+Add to your Gemfile:
+gem 'ruby_core_extensions'
+
+# Extensions
+
+The following classes are extend in this gem:
+
+* Array
+* BigDecimal
+* Class
+* Date
+* DateTime
+* Enumerable
+* File
+* Fixnum
+* Hash
+* Kernel
+* Numeric
+* Object
+* Range
+* String
+* Time
+

data/Rakefile

@@ -0,0 +1,12 @@
+require "bundler/gem_tasks"
+
+desc 'Default: run specs.'
+task :default => :spec
+
+require 'rspec/core/rake_task'
+
+desc "Run specs"
+RSpec::Core::RakeTask.new do |t|
+  t.pattern = "./spec/**/*_spec.rb" # don't need this, it's default.
+  # Put spec opts in a file named .rspec in root
+end

data/gemfiles/rails3.gemfile

@@ -0,0 +1,11 @@
+source 'https://rubygems.org'
+gemspec :path => '../'
+
+group :development, :test do
+  gem 'rake'
+  gem 'rdoc'
+  gem 'rspec'
+  gem 'simplecov'
+  gem 'simplecov-rcov'
+  gem 'activesupport', '~> 3.2.0'
+end

data/gemfiles/rails4.gemfile

@@ -0,0 +1,11 @@
+source 'https://rubygems.org'
+gemspec :path => '../'
+
+group :development, :test do
+  gem 'rake'
+  gem 'rdoc'
+  gem 'rspec'
+  gem 'simplecov'
+  gem 'simplecov-rcov'
+  gem 'activesupport', '~> 4.0.0'
+end

data/lib/ruby_core_extensions.rb

@@ -0,0 +1,20 @@
+module RubyCoreExtensions
+  require 'active_support/version'
+  if ActiveSupport::VERSION::MAJOR > 2
+    require 'active_support/dependencies/autoload'
+  end
+  require 'active_support/core_ext'
+
+  require 'ruby_core_extensions/array'
+  require 'ruby_core_extensions/class'
+  require 'ruby_core_extensions/enumerable'
+  require 'ruby_core_extensions/file'
+  require 'ruby_core_extensions/hash'
+  require 'ruby_core_extensions/kernel'
+  require 'ruby_core_extensions/numeric'
+  require 'ruby_core_extensions/object'
+  require 'ruby_core_extensions/string'
+
+  require 'ruby_core_extensions/compact'
+  require 'ruby_core_extensions/recursive'
+end

data/lib/ruby_core_extensions/array.rb

@@ -0,0 +1,50 @@
+class Array
+
+  def to_param
+    self.collect { |element| element.respond_to?(:to_param) ? element.to_param : element }
+  end
+
+  def show_name
+    first.titleize
+  end
+
+  # Key should be unique, or latest element with that key will override previous ones.
+  def hash_by(key = nil, method = nil, &block)
+    self.inject({}) do |h, element|
+      if key
+        h[element.send(key)] = if block_given?
+          yield(element)
+        elsif method
+          element.send(method)
+        else
+          element
+        end
+      else # key is block and value is element
+        h[yield(element)] = element
+      end
+      h
+    end
+  end
+
+  def hash_by_id(method = nil, &block)
+    hash_by(:id, method, &block)
+  end
+
+  def intersects?(other)
+    self.any?{|i| other.include?(i)}
+  end
+
+  # Same effect as Array.wrap(object).first
+  # but no need to create new object in case of non-array
+  def self.first(object)
+    return object.first if object.is_a?(Array)
+    object
+  end
+
+  # Same effect as Array.wrap(object).last
+  # but no need to create new object in case of non-array
+  def self.last(object)
+    return object.last if object.is_a?(Array)
+    object
+  end
+end

data/lib/ruby_core_extensions/class.rb

@@ -0,0 +1,8 @@
+class Class
+  
+  def downcase_symbol
+    self.to_s.downcase.to_sym
+  end
+  
+end
+

data/lib/ruby_core_extensions/compact.rb

@@ -0,0 +1,2 @@
+require 'ruby_core_extensions/compact/array'
+require 'ruby_core_extensions/compact/hash'

data/lib/ruby_core_extensions/compact/array.rb

@@ -0,0 +1,20 @@
+class Array
+  def compact_blank!
+    delete_if{|v| v.blank?}
+  end
+
+  def recursive_compact_blank!
+    delete_if do |v|
+      if v.is_a?(Hash)
+        v.recursive_compact_blank!
+        v.recursive_blank?
+      elsif v.is_a?(Array)
+        v.recursive_compact_blank!
+        v.recursive_blank?
+      else
+        v.blank?
+      end
+    end
+  end
+end
+

data/lib/ruby_core_extensions/compact/hash.rb

@@ -0,0 +1,34 @@
+class Hash
+  # Remove nil values
+  def compact
+    self.dup.compact!
+  end
+
+  # Remove nil values - !desctructively!
+  def compact!
+    delete_if{|k,v| v.nil?}
+  end
+
+  def compact_blank
+    self.dup.compact_blank!
+  end
+
+  def compact_blank!
+    delete_if{|k,v| v.blank?}
+  end
+
+  def recursive_compact_blank!
+    delete_if do |k,v|
+      if v.is_a?(Hash)
+        v.recursive_compact_blank!
+        v.recursive_blank?
+      elsif v.is_a?(Array)
+        v.recursive_compact_blank!
+        v.recursive_blank?
+      else
+        v.blank?
+      end
+    end
+  end
+end
+

data/lib/ruby_core_extensions/enumerable.rb

@@ -0,0 +1,39 @@
+module Enumerable
+
+  def map_methods(*methods)
+    map do |object|
+      methods.inject({}) do |h, method|
+        h[method] = object.send(method)
+        h
+      end
+    end
+  end
+
+
+  def detect_and_return
+    detect do |e|
+      result = yield(e)
+      return result if result
+    end
+  end
+
+
+  def select_by_attr(attr, value)
+    select do |e|
+      e.send(attr) == value
+    end
+  end
+
+
+  if RUBY_VERSION < '1.9'
+    def with_object(obj, &block)
+      return to_enum :with_object, obj unless block_given?
+      each do |element|
+        yield element, obj
+      end
+      obj
+    end
+  end
+
+end
+

data/lib/ruby_core_extensions/file.rb

@@ -0,0 +1,12 @@
+class File
+  # http://pubs.opengroup.org/onlinepubs/9699919799/basedefs/V1_chap03.html#tag_03_276
+  SAFE_CHARS = /[^a-zA-Z0-9._\-]/
+
+  def self.safe_name(name)
+    name.gsub('&', 'and'). # prittify & to and
+      gsub(/\s/, '-'). # replace spaces with dashes
+      gsub(SAFE_CHARS, '-'). # replace with portable characters
+      gsub(/\-+/, '-') # limit - character to once
+  end
+end
+

data/lib/ruby_core_extensions/hash.rb

@@ -0,0 +1,34 @@
+class Hash
+
+  unless self.method_defined?(:extract!)
+    #Imported from Rails 3
+    def extract!(*keys)
+      result = {}
+      keys.each { |key| result[key] = delete(key) }
+      result
+    end
+  end
+
+
+  def map_key_value(key_method, value_method = nil)
+    value_method ||= key_method
+    each.with_object({}) do |(k,v), new_hash|
+      new_hash[k.send(key_method)] = v.send(value_method)
+    end
+  end
+
+
+  def map_key(method)
+    each.with_object({}) do |(k,v), new_hash|
+      new_hash[k.send(method)] = v
+    end
+  end
+
+
+  def map_value(method)
+    each.with_object({}) do |(k,v), new_hash|
+      new_hash[k] = v.send(method)
+    end
+  end
+
+end

data/lib/ruby_core_extensions/kernel.rb

@@ -0,0 +1,11 @@
+module Kernel
+
+  def require_dirs(dirs)
+    Array.wrap(dirs).each do |load_path|
+      Dir.glob("#{load_path}/**/*.rb").each do |file|
+        require file
+      end
+    end
+  end
+  
+end

data/lib/ruby_core_extensions/numeric.rb

@@ -0,0 +1,7 @@
+class Numeric
+  
+  def to_bool
+    !zero?
+  end
+  
+end

data/lib/ruby_core_extensions/object.rb

@@ -0,0 +1,72 @@
+class Object
+  # Does this object sound like another - phonetically?
+  def sounds_like?(other)
+    self.phonetic_code == other.phonetic_code
+  end
+  
+  # Convert this object into a string, then convert that to phonetic code
+  def phonetic_code
+    self.to_s.phonetic_code
+  end
+  
+  def to_long_s
+    to_s
+  end
+  
+  def virtual_belongs_to(*associations)
+    options = associations.extract_options!
+
+    for association in associations
+      class_eval <<-EVAL
+        attr_accessor :#{association}, :#{association}_id
+
+        def #{association}=(#{association})
+          @#{association}_id = #{association}.id if #{association}
+          @#{association} = #{association}
+        end
+
+        def #{association}_id=(#{association}_id)
+          @#{association} = nil
+          @#{association}_id = #{association}_id
+        end
+
+        def #{association}
+          @#{association} ||= #{(options[:class_name] || association.to_s).classify}.find_by_id(@#{association}_id)
+        end
+
+        def #{association}_id
+          @#{association}.id if #{association}
+        end
+      EVAL
+    end
+  end
+
+
+  def booleanize(name, options)
+    raise ArgumentError, ":rescue option is required" if options[:rescue].blank?
+    if !options[:rescue].is_a?(Array)
+      options[:rescue] = [options[:rescue]]
+    end
+
+    normal_name = name.to_s.gsub('!', '')
+
+    class_eval <<-EVAL
+      attr_accessor :reason_not_#{normal_name}
+      def #{normal_name}?(*args)
+        #{name}(*args)
+        @reason_not_#{normal_name} = nil
+        true
+      rescue #{options[:rescue].map(&:to_s).join(', ')} => e
+        @reason_not_#{normal_name} = e.message
+        false
+      end
+    EVAL
+  end
+  
+  
+  def to_bool
+    self.to_s.to_bool
+  end
+  
+end
+