buzztools 0.0.3

checksums.yaml

@@ -0,0 +1,15 @@
+---
+!binary "U0hBMQ==":
+  metadata.gz: !binary |-
+    NTI2MDkwZmY0Mjc1NTllMzk0NzgyMGY3YzBlNTAwNDlkNWRlOTJkNA==
+  data.tar.gz: !binary |-
+    OTg3MWE5YTQ3ODU3NGU1YmU4YjdkNGVjYzA1NGU0M2VjZDRhMDgxNA==
+SHA512:
+  metadata.gz: !binary |-
+    MDhiZTMwNmQyYWVjNmIwZDE2NjY5OTMwZmQ5NjNmNTcxZmEyOTg0YTYxZDE3
+    NzA4MDY3MDJiMDM0ZjkzMDYzNGVhYzhhYmM1MzlhOTlhNzQ1N2FjN2RlZjI2
+    ODQxYTVkMzQwMDI2YTg3ZTAxZTBkYTU1YTFkNmQ4Y2MzMDY4YzM=
+  data.tar.gz: !binary |-
+    OGZmYjZiMDllNmVkMDlmMTY0YzQ3YTFlNmJhYTQyOGU1NDYxZTZiOGZhYTJk
+    MDlmNDNmNjVmOTdiMzY0NjI0ZDA2ZmVmYTM1NTg2ZDM1ZDM0MTJjZTEwOTZh
+    YTM0MjFmMjY3ODkwYjU0NjY1OTUzMTgzNDFkMjVkZGY5ZTk2MTY=

data/.gitignore

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

data/Gemfile

@@ -0,0 +1,4 @@
+source 'https://rubygems.org'
+
+# Specify your gem's dependencies in underscore_plus.gemspec
+gemspec

data/LICENSE.txt

@@ -0,0 +1,22 @@
+Copyright (c) 2013 Gary McGhee
+
+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,6 @@
+buzztools
+===============
+
+
+Ruby reusable function library
+

data/Rakefile

@@ -0,0 +1 @@
+require "bundler/gem_tasks"

data/buzztools.gemspec

@@ -0,0 +1,22 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'buzztools/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = "buzztools"
+  spec.version       = Buzztools::VERSION
+  spec.authors       = ["Gary McGhee"]
+  spec.email         = ["contact@buzzware.com.au"]
+  spec.description   = "reusable function library"
+  spec.summary       = "reusable function library"
+  spec.homepage      = "https://github.com/buzzware/buzztools"
+  spec.license       = "MIT"
+
+  spec.files         = `git ls-files`.split($/)
+  spec.executables   = spec.files.grep(%r{^bin/}) { |f| File.basename(f) }
+  spec.test_files    = spec.files.grep(%r{^(test|spec|features)/})
+  spec.require_paths = ["lib"]
+  spec.add_development_dependency "bundler", ">= 1.3"
+  spec.add_development_dependency "rake"
+end

data/lib/buzztools.rb

@@ -0,0 +1,9 @@
+#require "buzztools/version"
+Dir.chdir(File.dirname(__FILE__)) { Dir['buzztools/*.rb'] }.each {|f| require f }
+
+#module Buzztools
+#  module Rails
+#    class Engine < ::Rails::Engine
+#    end
+#  end
+#end

data/lib/buzztools/extend_array.rb

@@ -0,0 +1,53 @@
+module ExtendArray
+
+	module_function # this makes the methods accessible on the module as well as instances when the module is included into a class
+
+	public
+
+	def filter_include!(aValues,aArray=nil)
+		aArray ||= self
+		if aValues.is_a? Array
+			return aArray if aValues.empty?
+			return aArray.delete_if {|v| not aValues.include? v }
+		elsif aValues.is_a? Regexp
+			return aArray.delete_if {|v| not v =~ aValues }
+		else
+			return filter_include!([aValues],aArray)
+		end
+	end
+
+	def filter_include(aValues,aArray=nil)
+		aArray ||= self
+		filter_include!(aValues,aArray.clone)
+	end
+
+	def filter_exclude!(aValues,aArray=nil)
+		aArray ||= self
+		if aValues.is_a? Array
+			return aArray if aValues.empty?
+			return aArray.delete_if {|v| aValues.include? v }
+		elsif aValues.is_a? Regexp
+			return aArray.delete_if {|v| v =~ aValues }
+		else
+			return filter_exclude!([aValues],aArray)
+		end
+	end
+
+	def filter_exclude(aValues,aArray=nil)
+		aArray ||= self
+		filter_exclude!(aValues,aArray.clone)
+	end
+
+	def to_nil
+		self.empty? ? nil : self
+	end
+end
+
+Array.class_eval do
+	include ExtendArray
+	# fixes a memory leak in shift in Ruby 1.8 - should be fixed in 1.9
+	# see http://blade.nagaokaut.ac.jp/cgi-bin/scat.rb/ruby/ruby-talk/216055
+	#def shift()
+	#	delete_at(0)
+	#end
+end

data/lib/buzztools/extend_bignum.rb

@@ -0,0 +1,19 @@
+Bignum.class_eval do
+
+	def to_nil
+		self==0 ? nil : self
+	end
+
+	def to_b(aDefault=false)
+		self==0 ? false : true
+	end
+
+end
+
+Float.class_eval do
+
+	def to_nil
+		(self==0 || self.nan?) ? nil : self
+	end
+
+end

data/lib/buzztools/extend_fixnum.rb

@@ -0,0 +1,15 @@
+Fixnum.class_eval do
+
+	def to_nil
+		self==0 ? nil : self
+	end
+
+	def to_b(aDefault=false)
+		self==0 ? false : true
+	end
+
+	def to_range(aMin,aMax=nil,aDefault=nil)
+		(!aMin || (self >= aMin)) && (!aMax || (self <= aMax)) ? self : aDefault
+	end
+
+end

data/lib/buzztools/extend_hash.rb

@@ -0,0 +1,86 @@
+module HashUtils
+
+	public
+
+	def filter_include!(aKeys,aHash=nil)
+		aHash ||= self
+
+		if aKeys.is_a? Regexp
+			return aHash.delete_if {|k,v| not k =~ aKeys }
+		else
+			aKeys = [aKeys] unless aKeys.is_a? Array
+			return aHash.clear if aKeys.empty?
+			return aHash.delete_if {|key, value| !((aKeys.include?(key)) || (key.is_a?(Symbol) and aKeys.include?(key.to_s)) || (key.is_a?(String) and aKeys.include?(key.to_sym)))}
+			return aHash	# last resort
+		end
+	end
+
+	def filter_include(aKeys,aHash=nil)
+		aHash ||= self
+		filter_include!(aKeys,aHash.clone)
+	end
+
+	def filter_exclude!(aKeys,aHash=nil)
+		aHash ||= self
+
+		if aKeys.is_a? Regexp
+			return aHash.delete_if {|k,v| k =~ aKeys }
+		else
+			aKeys = [aKeys] unless aKeys.is_a? Array
+			return aHash if aKeys.empty?
+			return aHash.delete_if {|key, value| ((aKeys.include?(key)) || (key.is_a?(Symbol) and aKeys.include?(key.to_s)) || (key.is_a?(String) and aKeys.include?(key.to_sym)))}
+		end
+	end
+
+	def filter_exclude(aKeys,aHash=nil)
+		aHash ||= self
+		filter_exclude!(aKeys,aHash.clone)
+	end
+
+	def has_values_for?(aKeys,aHash=nil)
+		aHash ||= self
+		# check all keys exist in aHash and their values are not nil
+		aKeys.all? { |k,v| aHash[k] }
+	end
+
+	# give a block to execute without the given key in this hash
+	# It will be replaced after the block (guaranteed by ensure)
+	# eg.
+	# hash.without_key(:blah) do |aHash|
+	#		puts aHash.inspect
+	# end
+	def without_key(aKey)
+		temp = nil
+		h = self
+		begin
+			if h.include?(aKey)
+				temp = [aKey,h.delete(aKey)]
+			end
+			result = yield(h)
+		ensure
+			h[temp[0]] = temp[1] if temp
+		end
+		return result
+	end
+
+	def symbolize_keys
+		result = {}
+		self.each { |k,v| k.is_a?(String) ? result[k.to_sym] = v : result[k] = v  }
+		return result
+	end
+
+	def to_nil
+		self.empty? ? nil : self
+	end
+
+end
+
+Hash.class_eval do
+	include HashUtils
+end
+
+if defined? HashWithIndifferentAccess
+	HashWithIndifferentAccess.class_eval do
+		include HashUtils
+	end
+end

data/lib/buzztools/extend_more.rb

@@ -0,0 +1,50 @@
+NilClass.class_eval do
+
+	def to_nil
+		nil
+	end
+
+	def to_b(aDefault=false)
+		false
+	end
+
+	def g?(*args)
+		nil
+	end
+
+end
+
+TrueClass.class_eval do
+
+	def to_nil
+		self
+	end
+
+	def to_b(aDefault=false)
+		self
+	end
+
+end
+
+FalseClass.class_eval do
+
+	def to_nil
+		nil
+	end
+
+	def to_b(aDefault=false)
+		self
+	end
+
+end
+
+
+Math.module_eval do
+	def self.max(a, b)
+		a > b ? a : b
+	end
+
+	def self.min(a, b)
+		a < b ? a : b
+	end
+end

data/lib/buzztools/extend_object.rb

@@ -0,0 +1,54 @@
+# this pattern of declaring methods in a module and then including into a class means that the methods can be used directly from the module
+#   eg. ExtendObject::attr_from_json(json,object)
+# or on the class it is included into
+#   eg. model.attr_from_json(json)
+module ExtendObject
+
+	module_function # this makes the methods accessible on the module as well as instances when the module is included into a class
+
+	public
+
+	def attr_from_json(aJsonObject,aObject=nil)   # only give second argument when used like ExtendObject::attr_from_json
+		aObject ||= self
+		rubyObj = JSON.parse!(aJsonObject)
+		rubyObj.each do |k,v|
+			aObject.send k.to_sym,v
+		end
+		aObject
+	end
+
+	def g?(*args)
+		if args.length==1
+			path = args.first
+		else
+			path = args
+		end
+		if path.is_a?(String)
+			segments = path.split('.').map!(&:to_sym)
+			segment = segments.shift
+		elsif path.is_a?(Symbol)
+			segments = []
+			segment = path
+		elsif path.is_a?(Array)
+			segments = path
+			segment = segments.shift
+			segment = segment.to_sym if segment
+		end
+		return self unless segment.to_nil
+		value = if self.respond_to?(segment)
+			self.send(segment)
+		elsif self.respond_to?(:[])
+			(self[segment] || self[segment.to_s]) rescue nil
+		end
+		if segments.empty?
+			value
+		else
+			value.respond_to?(:g?) ? value.g?(segments) : nil
+		end
+	end
+
+end
+
+Object.class_eval do
+	include ExtendObject
+end

data/lib/buzztools/extend_string.rb

@@ -0,0 +1,225 @@
+String.class_eval do
+
+	def self.random_word(min=4,max=8)
+		len = min + rand(max-min+1)
+		result = ' '*len
+		(len-1).downto(0) {|i| result[i] = (?a.ord + rand(?z.ord-?a.ord+1)).chr}
+		return result
+	end
+
+	def pad_left(value)
+		increase = value-self.length
+		return self if increase==0
+		if increase > 0
+			return self + ' '*increase
+		else
+			return self[0,value]
+		end
+	end
+
+	def pad_right(value)
+		increase = value-self.length
+		return self if increase==0
+		if increase > 0
+			return ' '*increase + self
+		else
+			return self[0,value]
+		end
+	end
+
+	# Like bite, but returns the first match instead of the subject, and removes the match from the subject, modifying it
+	def extract!(aValue=$/,aString=self)
+		if aValue.is_a? String
+			if i = aString.index(aValue)
+				aString[i,aValue.length] = ''
+				return aValue
+			else
+				return nil
+			end
+		elsif aValue.is_a? Regexp
+			if md = aValue.match(aString)
+				aString[md.begin(0),md.end(0)-md.begin(0)] = ''
+				return md.to_s
+			else
+				return nil
+			end
+		else
+			return aString
+		end
+	end
+
+	def extract(aValue=$/)
+		extract!(aValue,self.clone)
+	end
+
+	# Like chomp! but operates on the leading characters instead.
+	# The aString parameter would not normally be used.
+	def bite!(aValue=$/,aString=self)
+		if aValue.is_a? String
+			if aString[0,aValue.length] == aValue
+				aString[0,aValue.length] = ''
+				return aString
+			else
+				return aString
+			end
+		elsif aValue.is_a? Regexp
+			return aString.sub!(aValue,'') if aString.index(aValue)==0
+		else
+			return aString
+		end
+	end
+
+	def bite(aValue=$/)
+		bite!(aValue,self.clone)
+	end
+
+	def deprefix!(aPrefix=$/,aString=self)
+		if aString[0,aPrefix.length] == aPrefix
+			aString[0,aPrefix.length] = ''
+			return aString
+		else
+			return aString
+		end
+	end
+
+	def deprefix(aValue=$/)
+		deprefix!(aValue,self.clone)
+	end
+
+	def desuffix!(aString,aSuffix)
+		if aString[-aSuffix.length,aSuffix.length] == aSuffix
+			aString[-aSuffix.length,aSuffix.length] = ''
+			return aString
+		else
+			return aString
+		end
+	end
+
+	def desuffix(aValue=$/)
+		desuffix!(aValue,self.clone)
+	end
+
+	def begins_with?(aString)
+		self[0,aString.length]==aString
+	end
+
+	def ends_with?(aString)
+		self[-aString.length,aString.length]==aString
+	end
+
+	def ensure_prefix!(aPrefix=$/,aString=self)
+		aString[0,0]=aPrefix unless aString.begins_with?(aPrefix)
+		aString
+	end
+
+	def ensure_prefix(aValue=$/)
+		ensure_prefix!(aValue,self.clone)
+	end
+
+	def ensure_suffix!(aSuffix=$/,aString=self)
+		aString.insert(-1,aSuffix) unless aString.ends_with?(aSuffix)
+		aString
+	end
+
+	def ensure_suffix(aValue=$/)
+		ensure_suffix!(aValue,self.clone)
+	end
+
+	def to_integer(aDefault=nil)
+		t = self.strip
+		return aDefault if t.empty? || !t.index(/^-{0,1}[0-9]+$/)
+		return t.to_i
+	end
+
+	def is_i?
+		self.to_integer(false) and true
+	end
+
+	def to_float(aDefault=nil)
+		t = self.strip
+		return aDefault if !t =~ /(\+|-)?([0-9]+\.?[0-9]*|\.[0-9]+)([eE](\+|-)?[0-9]+)?/
+		return t.to_f
+	end
+
+	def is_f?
+		self.to_float(false) and true
+	end
+
+	# like scan but returns array of MatchData's.
+	# doesn't yet support blocks
+	def scan_md(aPattern)
+		result = []
+		self.scan(aPattern) {|s| result << $~ }
+		result
+	end
+
+	def to_nil(aPattern=nil)
+		return nil if self.empty?
+		if aPattern
+			return nil if (aPattern.is_a? Regexp) && (self =~ aPattern)
+			return nil if aPattern.to_s == self
+		end
+		self
+	end
+
+	def to_b(aDefault=false)
+		return true if ['1','yes','y','true','on'].include?(self.downcase)
+		return false if ['0','no','n','false','off'].include?(self.downcase)
+		aDefault
+	end
+
+	# "...Only alphanumerics [0-9a-zA-Z], the special characters "$-_.+!*'()," [not including the quotes - ed], and reserved characters used for their reserved purposes may be used unencoded within a URL."
+
+	URLIZE_SEPARATORS = /[ \\\(\)\[\]\.*,]/	# was /[ \\\(\)\[\]\.*,]/
+	URLIZE_EXTENSIONS = %w(html htm jpg jpeg png gif bmp mov avi mp3 zip pdf css js doc xdoc)
+	URLIZE_REMOVE = /[^a-z0-9\_\-+~\/]/ # was 'a-z0-9_-+~/'
+	# aKeepExtensions may be an array of extensions to keep, or :none (will remove periods) or :all (any extension <= 4 chars)
+	def urlize(aSlashChar='+',aRemove=nil,aKeepExtensions=nil)
+		aKeepExtensions=URLIZE_EXTENSIONS if !aKeepExtensions
+		aRemove=URLIZE_REMOVE if !aRemove
+		return self if self.empty?
+		result = self.downcase
+		ext = nil
+		if (aKeepExtensions!=:none) && last_dot = result.rindex('.')
+			if (ext_len = result.length-last_dot-1) <= 4	# preserve extension without dot if <= 4 chars long
+				ext = result[last_dot+1..-1]
+				ext = nil unless aKeepExtensions==:all || (aKeepExtensions.is_a?(Array) && aKeepExtensions.include?(ext))
+				result = result[0,last_dot] if ext
+			end
+		end
+
+		result = result.gsub(URLIZE_SEPARATORS,'-')
+		result = result.gsub(aRemove,'').sub(/-+$/,'').sub(/^-+/,'')
+		result.gsub!('/',aSlashChar) unless aSlashChar=='/'
+		result.gsub!(/-{2,}/,'-')
+		result += '.'+ext if ext
+		result
+	end
+
+	def has_tags?
+		index(/<[a-zA-Z\-:0-9]+(\b|>)/) && (index('/>') || index('</'))		# contains an opening and closing tag
+	end
+
+	def snake_case
+		underscore.tr(' ','_')
+	end
+
+	def relative_url?
+		!begins_with?('http') || !begins_with?('/')
+	end
+
+	def to_file(aFilename)
+		File.open(aFilename,'wb') {|file| file.write self }
+	end
+
+	def self.from_file(aFilename)
+		File.open(aFilename, "rb") { |f| f.read }
+	end
+end
+
+
+Symbol.class_eval do
+	def to_nil
+		self
+	end
+end

data/lib/buzztools/extend_time.rb

@@ -0,0 +1,84 @@
+Time.class_eval do
+
+	if !respond_to?(:change)  # no activesupport loaded
+		def change(options)
+			::Time.send(
+				self.utc? ? :utc : :local,
+				options[:year]  || self.year,
+				options[:month] || self.month,
+				options[:day]   || self.day,
+				options[:hour]  || self.hour,
+				options[:min]   || (options[:hour] ? 0 : self.min),
+				options[:sec]   || ((options[:hour] || options[:min]) ? 0 : self.sec),
+				options[:usec]  || ((options[:hour] || options[:min] || options[:sec]) ? 0 : self.usec)
+			)
+		end
+
+		def seconds_since_midnight
+			self.to_i - self.change(:hour => 0).to_i + (self.usec/1.0e+6)
+		end
+
+		def beginning_of_day
+			(self - self.seconds_since_midnight).change(:usec => 0)
+		end
+
+		alias :midnight :beginning_of_day
+		alias :at_midnight :beginning_of_day
+		alias :at_beginning_of_day :beginning_of_day
+
+	end
+
+	# offset of local machine from UTC, in seconds eg +9.hours
+	def self.local_offset
+		local(2000).utc_offset
+	end
+
+	def date
+		self.at_beginning_of_day
+	end
+
+	# index number of this day, from Time.at(0) + utc_offset
+	def day_number
+		(self.to_i+self.utc_offset) / 86400
+	end
+
+	# index number of this utc day
+	def day_number_utc
+		self.to_i / 86400
+	end
+
+	# the last microsecond of the day
+	def day_end
+		self.at_beginning_of_day + 86399.999999
+	end
+
+	def date_numeric
+		self.strftime('%Y%m%d')
+	end
+
+	def to_universal
+		self.strftime("%d %b %Y")
+	end
+
+	# create a new Time from eg. "20081231"
+	def self.from_date_numeric(aString)
+		return nil unless aString
+		local(aString[0,4].to_i,aString[4,2].to_i,aString[6,2].to_i)
+	end
+
+	def time_numeric
+		self.strftime('%H%M%S')
+	end
+
+	def datetime_numeric
+		self.strftime('%Y%m%d-%H%M%S')
+	end
+
+	def to_sql_format # was to_sql, but clashed with Rails 3
+		self.strftime('%Y-%m-%d %H:%M:%S')
+	end
+
+	def to_w3c
+		utc.strftime("%Y-%m-%dT%H:%M:%S+00:00")
+	end
+end

data/lib/buzztools/version.rb

@@ -0,0 +1,3 @@
+module Buzztools
+  VERSION = "0.0.3"
+end

metadata

@@ -0,0 +1,88 @@
+--- !ruby/object:Gem::Specification
+name: buzztools
+version: !ruby/object:Gem::Version
+  version: 0.0.3
+platform: ruby
+authors:
+- Gary McGhee
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2013-12-12 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '1.3'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '1.3'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+description: reusable function library
+email:
+- contact@buzzware.com.au
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- .gitignore
+- Gemfile
+- LICENSE.txt
+- README.md
+- Rakefile
+- buzztools.gemspec
+- lib/buzztools.rb
+- lib/buzztools/extend_array.rb
+- lib/buzztools/extend_bignum.rb
+- lib/buzztools/extend_fixnum.rb
+- lib/buzztools/extend_hash.rb
+- lib/buzztools/extend_more.rb
+- lib/buzztools/extend_object.rb
+- lib/buzztools/extend_string.rb
+- lib/buzztools/extend_time.rb
+- lib/buzztools/version.rb
+homepage: https://github.com/buzzware/buzztools
+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.1.11
+signing_key: 
+specification_version: 4
+summary: reusable function library
+test_files: []