hash-utils 2.0.0 → 2.0.1

data/CHANGES.txt

@@ -1,4 +1,9 @@
 
+2.0.1 (2012-08-26)
+* Object: #enumerable?
+* Hash: #flip, #flip!
+* readme correction
+
 2.0.0 (2012-03-15)
 * defensive (safe) class patching
 * Array: #to_set

data/README.md

@@ -1,7 +1,7 @@
 Hash Utils
 ==========
 
-**hash-utils** adds more than 125 useful and frequently rather 
+**hash-utils** adds more than 135 useful and frequently rather 
 fundamental methods which are missing in Ruby programming language, 
 to several core classes. It tries to be similar project to 
 [Ruby Facets][1] on principle, but less complex, more practical, 
@@ -11,12 +11,12 @@ non-atomic and organized by better way.
 - `FalseClass` – 3 methods,
 - `File` – 2 methods,
 - `Gem` – 2 methods,
-- `Hash` – 40 methods,
+- `Hash` – 42 methods,
 - `IO` – 1 method,
 - `Module` – 1 method,
 - `NilClass` – 1 method,
 - `Numeric` – 5 method,
-- `Object` – 14 methods,
+- `Object` – 15 methods,
 - `Proc` – 1 method,
 - `TrueClass` – 3 methods,
 - `String` – 37 methods,
@@ -32,11 +32,7 @@ to appropriate type only by including the:
 
     require "hash-utils/<lowercase-data-type-name>"
     
-### Special Requirements
-
-Some methods are optimized at Ruby 1.8.7 and 1.9 and higher. These 
-optimizations requires the [`ruby-version`][2] gem available.
-
+    
 Contributing
 ------------
 

data/Rakefile

@@ -18,8 +18,8 @@ Jeweler::Tasks.new do |gem|
   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. 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.summary = 'Adds more than 135 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/TODO.txt

@@ -1,2 +1,3 @@
 * add examples to each call
 * write riot tests
+* integrate functions from http://rubydoc.info/gems/sane/0.25.5/frames

data/VERSION

@@ -1 +1 @@
-2.0.0
+2.0.1

data/hash-utils.gemspec

@@ -5,11 +5,11 @@
 
 Gem::Specification.new do |s|
   s.name = "hash-utils"
-  s.version = "2.0.0"
+  s.version = "2.0.1"
 
   s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
   s.authors = ["Martin Koz\u{e1}k"]
-  s.date = "2012-03-15"
+  s.date = "2012-08-26"
   s.email = "martinkozak@martinkozak.net"
   s.extra_rdoc_files = [
     "LICENSE.txt",
@@ -45,10 +45,9 @@ Gem::Specification.new do |s|
   ]
   s.homepage = "http://github.com/martinkozak/hash-utils"
   s.licenses = ["MIT"]
-  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.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."
+  s.rubygems_version = "1.8.24"
+  s.summary = "Adds more than 135 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

data/lib/hash-utils/hash.rb

@@ -824,5 +824,31 @@ class Hash
             true
         end
     end
-        
+
+    ##
+    # Flips keys and values.
+    #
+    # @return [Hash] new flipped hash
+    # @see http://www.php.net/array_flip
+    # @since 2.0.1
+    #
+    if not self.__hash_utils_instance_respond_to? :flip     
+        def flip
+            self.map_pairs { |k, v| [v, k] }
+        end
+    end
+
+    ##
+    # Flips keys and values and replaces the original hash in place.
+    #
+    # @return [Hash] new flipped hash
+    # @see http://www.php.net/array_flip
+    # @since 2.0.1
+    #
+    if not self.__hash_utils_instance_respond_to? :flip!     
+        def flip!
+            self.map_pairs! { |k, v| [v, k] }
+        end
+    end
+       
 end

data/lib/hash-utils/object.rb

@@ -301,6 +301,19 @@ class Object
             self.kind_of? Hash
         end
     end
+
+    ##
+    # Indicates, object is implementing +Enumerable+.
+    #
+    # @return [Boolean] +true+ if yes, +false+ in otherwise
+    # @since 2.0.1
+    #
+    
+    if not __hash_utils_object_respond_to? :enumerable?
+        def enumerable?
+            self.kind_of? Enumerable
+        end
+    end
     
     ##
     # Converts object to +Symbol+. In fact, converts it to +String+

data/test

@@ -150,6 +150,16 @@ context "Hash" do
         t.compact!
         t == { :a => 1 }
     end
+    asserts("#flip") do
+        t = { :a => 1, :b => 2, :c => 2 }
+        result = t.flip
+        result == { 1 => :a, 2 => :c }
+    end
+    asserts("#flip!") do
+        t = { :a => 1, :b => 2, :c => 2 }
+        t.flip!
+        t == { 1 => :a, 2 => :c }
+    end
     asserts("#get_pairs") do
         h = { :a => 1, :b => 2, :c => 3 }
         result = [ ]
@@ -281,6 +291,9 @@ context "Object" do
     asserts("#boolean?") do
         true.boolean? and false.boolean? and not "".boolean?
     end
+    asserts("#enumerable?") do
+        [].enumerable? and not 5.enumerable?
+    end
     asserts("#false?") do
         (false.false? == true) and ("string".false? == false)
     end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: hash-utils
 version: !ruby/object:Gem::Version
-  version: 2.0.0
+  version: 2.0.1
   prerelease: 
 platform: ruby
 authors:
@@ -9,11 +9,11 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2012-03-15 00:00:00.000000000 Z
+date: 2012-08-26 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: ruby-version
-  requirement: &22439060 !ruby/object:Gem::Requirement
+  requirement: !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -21,10 +21,15 @@ dependencies:
         version: '0'
   type: :runtime
   prerelease: false
-  version_requirements: *22439060
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
 - !ruby/object:Gem::Dependency
   name: bundler
-  requirement: &22434460 !ruby/object:Gem::Requirement
+  requirement: !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -32,10 +37,15 @@ dependencies:
         version: 1.0.0
   type: :development
   prerelease: false
-  version_requirements: *22434460
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: 1.0.0
 - !ruby/object:Gem::Dependency
   name: jeweler2
-  requirement: &22431720 !ruby/object:Gem::Requirement
+  requirement: !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -43,10 +53,15 @@ dependencies:
         version: 2.0.0
   type: :development
   prerelease: false
-  version_requirements: *22431720
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: 2.0.0
 - !ruby/object:Gem::Dependency
   name: riot
-  requirement: &22448700 !ruby/object:Gem::Requirement
+  requirement: !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -54,7 +69,12 @@ dependencies:
         version: 0.12.3
   type: :development
   prerelease: false
-  version_requirements: *22448700
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: 0.12.3
 description: 
 email: martinkozak@martinkozak.net
 executables: []
@@ -92,10 +112,7 @@ files:
 homepage: http://github.com/martinkozak/hash-utils
 licenses:
 - MIT
-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"
+post_install_message: 
 rdoc_options: []
 require_paths:
 - lib
@@ -107,7 +124,7 @@ required_ruby_version: !ruby/object:Gem::Requirement
       version: '0'
       segments:
       - 0
-      hash: -641600196593062307
+      hash: -4026465352187069690
 required_rubygems_version: !ruby/object:Gem::Requirement
   none: false
   requirements:
@@ -116,10 +133,10 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: '0'
 requirements: []
 rubyforge_project: 
-rubygems_version: 1.8.17
+rubygems_version: 1.8.24
 signing_key: 
 specification_version: 3
-summary: Adds more than 125 useful and frequently rather fundamental methods which
+summary: Adds more than 135 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