jakewendt-ruby_extension 1.0.6

data/README.rdoc

@@ -0,0 +1,71 @@
+= RubyExtension (Gem / Rails Plugin)
+
+
+== Usage
+
+ config.gem 'jakewendt-ruby_extension',
+   :source => 'http://rubygems.org'
+
+
+== ToDo
+
+* add legitimate text to Rakefile
+
+
+== Notes
+
+Minor additions to some Ruby core classes.
+(This may be better as a gem.)
+
+	Array
+		arrange(new_array_index=[])
+		drop_blanks
+		capitalize
+		capitalize!
+		downcase
+		average
+		median
+		first_index
+		to_boolean / to_b 
+		true? (explicitly so)
+		false? (explicitly so)
+		true_xor_false?
+
+	Hash
+		delete_keys_matching!(regex)
+		delete_keys!(*keys)
+		dig(*keys)
+
+	String
+		to_params_hash
+		uniq
+
+	NilClass
+		split(*args)
+		include?(*args)
+
+	Integer
+		factorial
+
+	Object
+		to_boolean
+		true? (explicitly so)
+		false? (explicitly so)
+
+
+
+== Gemified with Jeweler
+
+ vi Rakefile
+ rake version:write
+
+ rake version:bump:patch
+ rake version:bump:minor
+ rake version:bump:major
+
+ rake gemspec
+
+ rake install
+ rake release
+
+Copyright (c) 2010 [Jake Wendt], released under the MIT license

data/lib/jakewendt-ruby_extension.rb

@@ -0,0 +1 @@
+require 'ruby_extension'

data/lib/ruby_extension.rb

@@ -0,0 +1,8 @@
+#	I need to be more explicit about which files to require
+#	because I have files of the same name in RAILS_ROOT/lib
+require "ruby_extension/object"
+require "ruby_extension/integer"
+require "ruby_extension/array"
+require "ruby_extension/string"
+require "ruby_extension/hash"
+require "ruby_extension/nil_class"

data/lib/ruby_extension/array.rb

@@ -0,0 +1,142 @@
+module RubyExtension	#	:nodoc:
+module Array	#	:nodoc:
+	def self.included(base)
+#		base.extend(ClassMethods)
+		base.instance_eval do
+			include InstanceMethods
+		end
+	end
+
+#	module ClassMethods	#	:nodoc:
+#	end
+
+	module InstanceMethods
+
+		#	['a','b','c'].arrange([2,0,1]) => ['c','a','b']
+		def arrange(new_array_index=[])
+			new_array = self.dup
+			new_array_index.each_with_index do |index,new_index|
+				new_array[new_index] = self[index]
+			end
+			new_array
+		end 
+
+		#	Remove all "blank?" items for the array
+		def drop_blanks!
+			delete_if{|a|a.blank?}
+		end
+
+		#	Return capitlized versions of each item in the array
+		def capitalize
+			collect(&:capitalize)
+		end
+
+		#	Capitalize each item in the array and return it
+		def capitalize!
+			each_with_index do |element,index|
+				self[index] = element.capitalize
+			end
+			self
+		end
+
+		#	Return downcased versions of each item in the array
+		def downcase
+			collect(&:downcase)
+		end
+
+		#	Return the average digitized value of the array
+		def average
+			if self.length > 0
+				#	sum defined in activesupport/lib/active_support/core_ext/enumerable.rb
+				self.digitize.sum.to_f / self.length
+			else
+				nil
+			end
+		end
+
+		#	Return the median digitized value of the array
+		def median
+			if self.length > 0
+				sorted_values = self.digitize.sort
+				length = sorted_values.length
+				if length.odd?
+					sorted_values[length/2]
+				else
+					( sorted_values[length/2] + sorted_values[-1+length/2] ).to_f / 2
+				end
+			else
+				nil
+			end
+		end
+
+		#	Return a copy of the array with values at the
+		#	given indexes swapped.
+		def swap_indexes(i,j)
+			new_array = self.dup
+			new_array[i],new_array[j] = self[j],self[i]
+			new_array
+		end
+
+		#	Swap the values of an array at the given indexes
+		#	and return it
+		def swap_indexes!(i,j)
+			self[i],self[j] = self[j],self[i]
+			self
+		end
+
+		#	Convert all items in the array to_f
+		def numericize
+			collect(&:to_f)
+		end
+		alias_method :digitize, :numericize
+
+#		def first_index(value = nil)	#	either way works
+
+		#	return the first index of the array
+		#	with a value matching that given
+		def first_index(value = nil, &block)
+			using_block = block_given?
+			each_with_index do |element,index|
+				return index if (using_block && yield(element)) || (value == element)
+			end
+			return nil
+		end
+
+		def to_boolean
+			!empty? && all?{|v| v.to_boolean }
+		end
+#		alias_method :true?, :to_boolean
+		alias_method :to_b,  :to_boolean
+
+		#	[].true? 
+		#	=> false
+		#	[true].true? 
+		#	=> true
+		#	[true,false].true? 
+		#	=> true
+		#	[false].true? 
+		#	=> false
+		def true?
+			!empty? && any?{|v| v.true? }
+		end
+
+		def false?
+			!empty? && any?{|v| v.false? }
+		end
+
+		#	I need to work on this one ...
+		def true_xor_false?
+#			self.include?('true') ^ self.include?('false') ^
+#				self.include?(true) ^ self.include?(false)
+			contains_true = contains_false = false
+			each {|v|
+#				( v.to_boolean ) ? contains_true = true : contains_false = true
+				eval("contains_#{v.to_boolean}=true")
+			}
+			contains_true ^ contains_false
+		end
+
+	end
+end
+end
+Array.send(:include, RubyExtension::Array)

data/lib/ruby_extension/hash.rb

@@ -0,0 +1,55 @@
+module RubyExtension	#	:nodoc:
+module Hash	#	:nodoc:
+	def self.included(base)
+#		base.extend(ClassMethods)
+		base.instance_eval do
+			include InstanceMethods
+		end
+	end
+
+#	module ClassMethods	#	:nodoc:
+#	end
+
+	module InstanceMethods
+
+		#	delete all keys matching the given regex
+		#	and return the new hash
+		def delete_keys_matching!(regex)
+			self.keys.each do |k| 
+				if k.to_s =~ Regexp.new(regex)
+					self.delete(k)
+				end 
+			end 
+			self
+		end 
+
+		#	delete all keys in the given array
+		#	and return the new hash
+		def delete_keys!(*keys)
+			keys.each do |k| 
+				self.delete(k)
+			end 
+			self
+		end 
+
+		#	params.dig('study_events',se.id.to_s,'eligible')
+		def dig(*args)
+			if args.length > 0 && self.keys.include?(args.first)
+				key = args.shift
+				if args.length > 0 
+					if self[key].is_a?(Hash)
+						self[key].dig(*args)
+					else
+						nil
+					end
+				else
+					self[key]
+				end
+			end
+		end
+
+	end
+
+end
+end
+Hash.send( :include, RubyExtension::Hash )

data/lib/ruby_extension/integer.rb

@@ -0,0 +1,26 @@
+module RubyExtension	#	:nodoc:
+module Integer	#	:nodoc:
+	def self.included(base)
+#		base.extend(ClassMethods)
+		base.instance_eval do
+			include InstanceMethods
+		end
+	end
+
+#	module ClassMethods	#	:nodoc:
+#	end
+
+	module InstanceMethods
+
+		#	Return n!
+		def factorial
+			f = n = self
+			f *= n -= 1 while( n > 1 )
+			return f
+		end
+
+	end
+
+end
+end
+Integer.send( :include, RubyExtension::Integer )

data/lib/ruby_extension/nil_class.rb

@@ -0,0 +1,28 @@
+module RubyExtension	#	:nodoc:
+module NilClass	#	:nodoc:
+	def self.included(base)
+#		base.extend(ClassMethods)
+		base.instance_eval do
+			include InstanceMethods
+		end
+	end
+
+#	module ClassMethods	#	:nodoc:
+#	end
+
+	module InstanceMethods
+
+		#	Return an empty array when attempting to split nil
+		def split(*args)
+			[]
+		end
+
+		def include?(*args)
+			false
+		end
+
+	end
+
+end
+end
+NilClass.send( :include, RubyExtension::NilClass )

data/lib/ruby_extension/object.rb

@@ -0,0 +1,68 @@
+module RubyExtension	#	:nodoc:
+module Object	#	:nodoc:
+	def self.included(base)
+#		base.extend(ClassMethods)
+		base.instance_eval do
+			include InstanceMethods
+		end
+	end
+
+#	module ClassMethods	#	:nodoc:
+#	end
+
+	module InstanceMethods
+
+		#	originally from ActiveSupport::Callbacks::Callback
+#	needs modified to actually work the way I'd like
+#	needs tests
+#	x(:some_method)
+#	x(Proc.new(....))
+#	x(lambda{...})
+		#	def evaluate_method(method, *args, &block)
+		def evaluate_method(method, *args, &block)
+			case method
+				when Symbol
+#		I don't quite understand the shift (it fails)
+#					object = args.shift
+#					object.send(method, *args, &block)
+					send(method, *args, &block)
+				when String
+					eval(method, args.first.instance_eval { binding })
+				when Proc, Method
+#	fails
+					method.call(*args, &block)
+				else
+					if method.respond_to?(kind)
+						method.send(kind, *args, &block)
+					else
+						raise ArgumentError,
+							"Callbacks must be a symbol denoting the method to call, a string to be evaluated, " +
+							"a block to be invoked, or an object responding to the callback method."
+					end
+				end
+		end
+		alias_method :x, :evaluate_method
+
+		def to_boolean
+#			return [true, 'true', 1, '1', 't'].include?(
+			return ![nil, false, 'false', 0, '0', 'f'].include?(
+				( self.is_a?(String) ) ? self.downcase : self )
+		end
+
+		#	looking for an explicit true
+		def true?
+			return [true, 'true', 1, '1', 't'].include?(
+				( self.is_a?(String) ) ? self.downcase : self )
+		end
+
+		#	looking for an explicit false (not nil)
+		def false?
+			return [false, 'false', 0, '0', 'f'].include?(
+				( self.is_a?(String) ) ? self.downcase : self )
+		end
+
+	end
+
+end
+end
+Object.send(:include, RubyExtension::Object)

data/lib/ruby_extension/string.rb

@@ -0,0 +1,35 @@
+module RubyExtension	#	:nodoc:
+module String	#	:nodoc:
+  def self.included(base)
+#    base.extend(ClassMethods)
+    base.instance_eval do
+      include InstanceMethods
+    end
+  end
+
+#  module ClassMethods	#	:nodoc:
+#  end
+
+  module InstanceMethods
+
+		#	Convert a query string like that in a URL
+		#	to a Hash
+		def to_params_hash
+			h = HashWithIndifferentAccess.new
+			self.split('&').each do |p|
+				(k,v) = p.split('=',2)
+				h[k] = URI.decode(v)
+			end
+			return h
+		end
+
+		#	Return self
+		def uniq
+			self
+		end
+
+  end
+
+end
+end
+String.send( :include, RubyExtension::String )

data/rails/init.rb

@@ -0,0 +1 @@
+require 'jakewendt-ruby_extension'

metadata

@@ -0,0 +1,76 @@
+--- !ruby/object:Gem::Specification 
+name: jakewendt-ruby_extension
+version: !ruby/object:Gem::Version 
+  hash: 27
+  prerelease: 
+  segments: 
+  - 1
+  - 0
+  - 6
+  version: 1.0.6
+platform: ruby
+authors: 
+- Jake
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2011-08-10 00:00:00 -07:00
+default_executable: 
+dependencies: []
+
+description: longer description of your gem
+email: github@jake.otherinbox.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: 
+- README.rdoc
+files: 
+- lib/jakewendt-ruby_extension.rb
+- lib/ruby_extension.rb
+- lib/ruby_extension/array.rb
+- lib/ruby_extension/hash.rb
+- lib/ruby_extension/integer.rb
+- lib/ruby_extension/nil_class.rb
+- lib/ruby_extension/object.rb
+- lib/ruby_extension/string.rb
+- rails/init.rb
+- README.rdoc
+has_rdoc: true
+homepage: http://github.com/jakewendt/ruby_extension
+licenses: []
+
+post_install_message: 
+rdoc_options: []
+
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 3
+      segments: 
+      - 0
+      version: "0"
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 3
+      segments: 
+      - 0
+      version: "0"
+requirements: []
+
+rubyforge_project: 
+rubygems_version: 1.6.2
+signing_key: 
+specification_version: 3
+summary: one-line summary of your gem
+test_files: []
+