hash-utils 1.0.0 → 2.0.0

data/CHANGES.txt

@@ -1,4 +1,12 @@
 
+2.0.0 (2012-03-15)
+* defensive (safe) class patching
+* Array: #to_set
+* Object: #to_sym
+* bug fix in Array#clean!
+* many subminor fixes
+* minor optimizations
+
 1.0.0 (2011-10-17)
 * Boolean: #convert, #to_i
 * String: #to_boolean

data/Gemfile

@@ -7,6 +7,6 @@ source "http://rubygems.org"
 # Include everything needed to run rake, tests, features, etc.
 group :development do
   gem "bundler", ">= 1.0.0"
-  gem "jeweler", ">= 1.5.2"
+  gem "jeweler2", ">= 2.0.0"
   gem "riot", ">= 0.12.3"
 end

data/Gemfile.lock

@@ -2,11 +2,8 @@ GEM
   remote: http://rubygems.org/
   specs:
     git (1.2.5)
-    jeweler (1.6.4)
-      bundler (~> 1.0)
+    jeweler2 (2.0.9)
       git (>= 1.2.5)
-      rake
-    rake (0.9.2)
     riot (0.12.5)
       rr
     rr (1.0.4)
@@ -17,6 +14,6 @@ PLATFORMS
 
 DEPENDENCIES
   bundler (>= 1.0.0)
-  jeweler (>= 1.5.2)
+  jeweler2 (>= 2.0.0)
   riot (>= 0.12.3)
   ruby-version

data/LICENSE.txt

@@ -1,4 +1,4 @@
-Copyright (c) 2011 Martin Kozák (martinkozak@martinkozak.net)
+Copyright (c) 2011-2012 Martin Kozák (martinkozak@martinkozak.net)
 
 Permission is hereby granted, free of charge, to any person obtaining
 a copy of this software and associated documentation files (the

data/README.md

@@ -7,7 +7,7 @@ to several core classes. It tries to be similar project to
 [Ruby Facets][1] on principle, but less complex, more practical, 
 non-atomic and organized by better way.
 
-- `Array` – 14 methods,
+- `Array` – 15 methods,
 - `FalseClass` – 3 methods,
 - `File` – 2 methods,
 - `Gem` – 2 methods,
@@ -16,7 +16,7 @@ non-atomic and organized by better way.
 - `Module` – 1 method,
 - `NilClass` – 1 method,
 - `Numeric` – 5 method,
-- `Object` – 13 methods,
+- `Object` – 14 methods,
 - `Proc` – 1 method,
 - `TrueClass` – 3 methods,
 - `String` – 37 methods,
@@ -51,7 +51,7 @@ Contributing
 Copyright
 ---------
 
-Copyright © 2011 [Martin Kozák][10]. See `LICENSE.txt` for
+Copyright © 2011 – 2012 [Martin Kozák][10]. See `LICENSE.txt` for
 further details.
 
 [1]: http://rubyworks.github.com/facets/

data/Rakefile

@@ -11,16 +11,15 @@ rescue Bundler::BundlerError => e
 end
 
 require 'rake'
-require 'jeweler'
+require 'jeweler2'
 
 Jeweler::Tasks.new do |gem|
   # gem is a Gem::Specification... see http://docs.rubygems.org/read/chapter/20 for more options
   gem.name = "hash-utils"
   gem.homepage = "http://github.com/martinkozak/hash-utils"
   gem.license = "MIT"
-  gem.summary = 'Adds more than 125 useful and frequently rather fundamental methods which are missing in Ruby programming language, to Array, File, Hash, Module, Object, String and Symbol classes. It tries to be similar project to Ruby Facets on principle, but less complex, more practical, non-atomic and organized by better way.'
-  #gem.post_install_message = "\nHASH UTILS: Be warn, Hash#all? has been removed since version 0.15.0 because of\nconflict with built-in one with in fact equivalent functionallity. Please, check\nyour code if you can and switch to Ruby's one.\n\n"
-  gem.post_install_message = "\nHASH UTILS: File#write now works non-binary again. Binary writing were moved to File#binwrite.\n\n"
+  gem.summary = 'Adds more than 125 useful and frequently rather fundamental methods which are missing in Ruby programming language, to Array, File, Hash, Module, Object, String and Symbol classes. It tries to be similar project to Ruby Facets on principle, but less complex, more practical, non-atomic and organized by better way. Thanks to defensive and careful patching it should be compatible with all other libraries.'
+  gem.post_install_message = "\nHASH UTILS: The 2.0 version avoids the method overwriting conflicts by not performing overwriting of already implemented methods. By this way, it can damage your existing applications based on older versions although it's very improbable. \n\n"
   gem.email = "martinkozak@martinkozak.net"
   gem.authors = ["Martin Kozák"]
   # Include your dependencies below. Runtime dependencies are required when using your gem,

data/VERSION

@@ -1 +1 @@
-1.0.0
+2.0.0

data/hash-utils.gemspec

@@ -5,11 +5,11 @@
 
 Gem::Specification.new do |s|
   s.name = "hash-utils"
-  s.version = "1.0.0"
+  s.version = "2.0.0"
 
   s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
   s.authors = ["Martin Koz\u{e1}k"]
-  s.date = "2011-10-17"
+  s.date = "2012-03-15"
   s.email = "martinkozak@martinkozak.net"
   s.extra_rdoc_files = [
     "LICENSE.txt",
@@ -45,10 +45,10 @@ Gem::Specification.new do |s|
   ]
   s.homepage = "http://github.com/martinkozak/hash-utils"
   s.licenses = ["MIT"]
-  s.post_install_message = "\nHASH UTILS: File#write now works non-binary again. Binary writing were moved to File#binwrite.\n\n"
+  s.post_install_message = "\nHASH UTILS: The 2.0 version avoids the method overwriting conflicts by not performing overwriting of already implemented methods. By this way, it can damage your existing applications based on older versions although it's very improbable. \n\n"
   s.require_paths = ["lib"]
-  s.rubygems_version = "1.8.11"
-  s.summary = "Adds more than 125 useful and frequently rather fundamental methods which are missing in Ruby programming language, to Array, File, Hash, Module, Object, String and Symbol classes. It tries to be similar project to Ruby Facets on principle, but less complex, more practical, non-atomic and organized by better way."
+  s.rubygems_version = "1.8.17"
+  s.summary = "Adds more than 125 useful and frequently rather fundamental methods which are missing in Ruby programming language, to Array, File, Hash, Module, Object, String and Symbol classes. It tries to be similar project to Ruby Facets on principle, but less complex, more practical, non-atomic and organized by better way. Thanks to defensive and careful patching it should be compatible with all other libraries."
 
   if s.respond_to? :specification_version then
     s.specification_version = 3
@@ -56,18 +56,18 @@ Gem::Specification.new do |s|
     if Gem::Version.new(Gem::VERSION) >= Gem::Version.new('1.2.0') then
       s.add_runtime_dependency(%q<ruby-version>, [">= 0"])
       s.add_development_dependency(%q<bundler>, [">= 1.0.0"])
-      s.add_development_dependency(%q<jeweler>, [">= 1.5.2"])
+      s.add_development_dependency(%q<jeweler2>, [">= 2.0.0"])
       s.add_development_dependency(%q<riot>, [">= 0.12.3"])
     else
       s.add_dependency(%q<ruby-version>, [">= 0"])
       s.add_dependency(%q<bundler>, [">= 1.0.0"])
-      s.add_dependency(%q<jeweler>, [">= 1.5.2"])
+      s.add_dependency(%q<jeweler2>, [">= 2.0.0"])
       s.add_dependency(%q<riot>, [">= 0.12.3"])
     end
   else
     s.add_dependency(%q<ruby-version>, [">= 0"])
     s.add_dependency(%q<bundler>, [">= 1.0.0"])
-    s.add_dependency(%q<jeweler>, [">= 1.5.2"])
+    s.add_dependency(%q<jeweler2>, [">= 2.0.0"])
     s.add_dependency(%q<riot>, [">= 0.12.3"])
   end
 end

data/lib/hash-utils/array.rb

@@ -1,6 +1,7 @@
 # encoding: utf-8
-# (c) 2011 Martin Kozák (martinkozak@martinkozak.net)
+# (c) 2011-2012 Martin Kozák (martinkozak@martinkozak.net)
 
+require "hash-utils/object"
 require "ruby-version"
 
 ##
@@ -9,8 +10,6 @@ require "ruby-version"
 
 class Array
 
-    @__sum_check_done
-
     ##
     # Moves selected values outside the array, so returns them.
     #
@@ -22,18 +21,20 @@ class Array
     # @since 0.3.0
     #
     
-    def remove!(&block)
-        result = [ ]
-        self.reject! do |v|
-            if block.call(v)
-                result << v
-                true
-            else
-                false
+    if not self.__hash_utils_instance_respond_to? :remove!
+        def remove!(&block)
+            result = [ ]
+            self.reject! do |v|
+                if block.call(v)
+                    result << v
+                    true
+                else
+                    false
+                end
             end
+            
+            return result
         end
-        
-        return result
     end
     
     ##
@@ -45,7 +46,9 @@ class Array
     # @since 0.2.0
     #
     
-    alias :"some?" :"one?"
+    if not self.__hash_utils_instance_respond_to? :some?
+        alias :"some?" :"one?"
+    end
     
     ##
     # Converts array to +Hash+.
@@ -68,11 +71,13 @@ class Array
     # @since 0.4.0
     #
     
-    def to_h(mode = nil)
-        if mode == :flat
-            Hash[*self]
-        else
-            Hash[self]
+    if not self.__hash_utils_instance_respond_to? :to_h
+        def to_h(mode = nil)
+            if mode == :flat
+                Hash[*self]
+            else
+                Hash[self]
+            end
         end
     end
     
@@ -92,10 +97,12 @@ class Array
     # @since 0.10.0
     #
     
-    def merge!(*arrays)
-        arrays.flatten! 1
-        arrays.each { |i| self << i }
-        self
+    if not self.__hash_utils_instance_respond_to? :merge!
+        def merge!(*arrays)
+            arrays.flatten! 1
+            arrays.each { |i| self << i }
+            self
+        end
     end
     
     ##
@@ -105,8 +112,10 @@ class Array
     # @since 0.15.0
     #
     
-    def second
-        self[1]
+    if not self.__hash_utils_instance_respond_to? :second
+        def second
+            self[1]
+        end
     end
     
     ##
@@ -116,8 +125,10 @@ class Array
     # @since 0.15.0
     #
 
-    def third
-        self[2]
+    if not self.__hash_utils_instance_respond_to? :third
+        def third
+            self[2]
+        end
     end
     
     ##
@@ -126,9 +137,11 @@ class Array
     # @return [Object] item of the array
     # @since 0.15.0
     #
-
-    def fourth
-        self[3]
+    
+    if not self.__hash_utils_instance_respond_to? :fourth
+        def fourth
+            self[3]
+        end
     end
     
     ##
@@ -138,8 +151,10 @@ class Array
     # @since 0.15.0
     #
 
-    def fifth
-        self[4]
+    if not self.__hash_utils_instance_respond_to? :fifth
+        def fifth
+            self[4]
+        end
     end
     
     ##
@@ -148,9 +163,11 @@ class Array
     # @return [Object] item of the array
     # @since 0.15.0
     #
-
-    def sixth
-        self[5]
+    
+    if not self.__hash_utils_instance_respond_to? :sixth
+        def sixth
+            self[5]
+        end
     end
     
     ##
@@ -160,8 +177,10 @@ class Array
     # @since 0.15.0
     #
 
-    def seventh
-        self[6]
+    if not self.__hash_utils_instance_respond_to? :seventh
+        def seventh
+            self[6]
+        end
     end
     
     ##
@@ -171,54 +190,41 @@ class Array
     # @since 0.15.0
     #
 
-    def eighth
-        self[7]
-    end
-        
-    if Ruby::Version >= [1, 8, 7]
-      
-        ##
-        # Returns sum of items in the array. If other than numeric type found,
-        # it will be normally conacenated if it's possible. 
-        #
-        # @example
-        #   array = [1, 2, 3]
-        #   array.sum                           # will return 6
-        #   array = ["a", "b", "c"]
-        #   array.sum                           # will return "abc"
-        #
-        # @return [Object] result of summing
-        # @since 0.16.0
-        #
-
-        def sum
-            self.inject(:+)
+    if not self.__hash_utils_instance_respond_to? :eight
+        def eighth
+            self[7]
         end
-        
-    else
+    end
+          
+    ##
+    # Returns sum of items in the array. If other than numeric type found,
+    # it will be normally conacenated if it's possible. 
+    #
+    # @example
+    #   array = [1, 2, 3]
+    #   array.sum                           # will return 6
+    #   array = ["a", "b", "c"]
+    #   array.sum                           # will return "abc"
+    #
+    # @return [Object] result of summing
+    # @since 0.16.0
+    #
     
-        ##
-        # Returns sum of items in the array. If other than numeric type found,
-        # it will be normally conacenated if it's possible. 
-        #
-        # @example
-        #   array = [1, 2, 3]
-        #   array.sum                           # will return 6
-        #   array = ["a", "b", "c"]
-        #   array.sum                           # will return "abc"
-        #
-        # @return [Object] result of summing
-        # @since 0.16.0
-        #
-
-        def sum
-            first = true
-            self.inject(self.first) do |sum, i|
-                if first
-                    first = false
-                    sum
-                else
-                    sum += i
+    if not self.__hash_utils_instance_respond_to? :sum 
+        if Ruby::Version >= [1, 8, 7]
+            def sum
+                self.inject(:+)
+            end
+        else
+            def sum
+                first = true
+                self.inject(self.first) do |sum, i|
+                    if first
+                        first = false
+                        sum
+                    else
+                        sum += i
+                    end
                 end
             end
         end
@@ -236,11 +242,15 @@ class Array
     # @since 0.16.0
     #
     
-    def avg
-        self.sum.to_f / self.length
+    if not self.__hash_utils_instance_respond_to? :avg
+        def avg
+            self.sum.to_f / self.length
+        end
     end
     
-    alias :average :avg
+    if not self.__hash_utils_instance_respond_to? :average
+        alias :average :avg
+    end
     
     ##
     # Indicates, object is +Array+.
@@ -249,8 +259,10 @@ class Array
     # @since 0.17.0
     #
     
-    def array?
-        true
+    if not self.__hash_utils_instance_respond_to? :array?
+        def array?
+            true
+        end
     end
 
     ##
@@ -262,8 +274,10 @@ class Array
     # @since 0.19.0
     #
     
-    def clean(value = nil)
-        self.reject! { |v| v === value }
+    if not self.__hash_utils_instance_respond_to? :clean
+        def clean(value = nil)
+            self.reject { |v| v === value }
+        end
     end
     
     ##
@@ -275,9 +289,23 @@ class Array
     # @since 0.19.0
     #
     
-    def clean!(value = nil)
-        self.reject! { |v| v === value }
+    if not self.__hash_utils_instance_respond_to? :clean!
+        def clean!(value = nil)
+            self.reject! { |v| v === value }
+        end
     end
     
+    ##
+    # Converts array to set. Include sets before calling.
+    #
+    # @return [Set] new set
+    # @since 2.0.0
+    #
+    
+    if not self.__hash_utils_instance_respond_to? :to_set
+        def to_set
+            Set::new(self)
+        end
+    end
 end