hash-utils 0.1.0 → 0.2.0

data/README.md

@@ -2,7 +2,7 @@ Hash Utils
 ==========
 
 **Hash Utils** adds some utility methods well known from [Array][1]
-class to [Hash][2] class. Extends it with following methods:
+class to [Hash][2] class. Extends them with following methods:
 
 * [`#compact`][3] – rejects elements with `nil` values,
 * [`#compact!`][4]
@@ -11,9 +11,9 @@ class to [Hash][2] class. Extends it with following methods:
 * `#map_keys` – works as [Array#map][5], but for *keys only*,
 * `#map_keys!`
 * `#keys_to_sym` – converts all keys to [Symbols][6],
-* `#keys_to_sym`
+* `#keys_to_sym!`
 
-All methods with `!` emulates work *in place*, but in fact they will 
+All methods with `!` emulates work *in place*, but in fact they 
 replace old hash with new one. An example of use: 
 
     foo = {"a" => 1, "b" => 2}
@@ -22,7 +22,19 @@ replace old hash with new one. An example of use:
     # result will be
     #   {:a => 1, :b => 2}
     
-This is the same as `#keys_to_sym!` for example.
+This is the same as `#keys_to_sym!` for example. And also introduces
+some methods known from Python to both [Array][1] and [Hash][2] class:
+
+* `some?` –  returns `true` if *some* element follows condition in block,
+* `some_pairs?`
+* `all?` –  returns `true` if *all* element follows condition in block,
+* `all_pairs?`
+
+For example:
+
+    foo = [:alfa, :beta, 5, :gama]
+    foo.some? { |i| i.kind_of? Integer }    # returns true
+    foo.all? { |i| i.kind_of? Symbol }      # returns false
 
 Contributing
 ------------
@@ -38,7 +50,7 @@ Contributing
 Copyright
 ---------
 
-Copyright (c) 2011 [Martin Kozák][8]. See `LICENSE.txt` for
+Copyright © 2011 [Martin Kozák][8]. See `LICENSE.txt` for
 further details.
 
 [1]: http://www.ruby-doc.org/core/classes/Array.html

data/Rakefile

@@ -16,7 +16,7 @@ Jeweler::Tasks.new do |gem|
   gem.name = "hash-utils"
   gem.homepage = "http://github.com/martinkozak/hash-utils"
   gem.license = "MIT"
-  gem.summary = 'Adds some useful well known methods similar to appropriate Array methods to Hash.'
+  gem.summary = 'Adds some useful well known methods similar to appropriate Array methods to Hash and some useful methods known from Python to both of them.'
   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 @@
-0.1.0
+0.2.0

data/hash-utils.gemspec

@@ -5,11 +5,11 @@
 
 Gem::Specification.new do |s|
   s.name = %q{hash-utils}
-  s.version = "0.1.0"
+  s.version = "0.2.0"
 
   s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
   s.authors = ["Martin Kozák"]
-  s.date = %q{2011-01-02}
+  s.date = %q{2011-01-04}
   s.email = %q{martinkozak@martinkozak.net}
   s.extra_rdoc_files = [
     "LICENSE.txt",
@@ -30,7 +30,7 @@ Gem::Specification.new do |s|
   s.licenses = ["MIT"]
   s.require_paths = ["lib"]
   s.rubygems_version = %q{1.3.7}
-  s.summary = %q{Adds some useful well known methods similar to appropriate Array methods to Hash.}
+  s.summary = %q{Adds some useful well known methods similar to appropriate Array methods to Hash and some useful methods known from Python to both of them.}
 
   if s.respond_to? :specification_version then
     current_version = Gem::Specification::CURRENT_SPECIFICATION_VERSION

data/lib/hash-utils.rb

@@ -24,7 +24,7 @@ class Hash
     ##
     # Returns a new hash with the results of running block once for 
     # every pair in <tt>self</tt>.
-    #
+    # 
     
     def map_pairs(&block)
         new = Hash::new(&self.default_proc)
@@ -91,4 +91,116 @@ class Hash
     def keys_to_sym!
         self.replace(self.keys_to_sym)
     end
+    
+    ##
+    # Checks, all elements values follow condition expressed in block.
+    # Block must return Boolean.
+    #
+    # If it's empty, returns <tt>true</tt>.
+    #
+    
+    def all?(&block)
+        if self.empty?
+            return true
+        end
+        
+        self.each_value do |v|
+            if block.call(v) == false
+                return false
+            end
+        end
+        
+        return true
+    end
+        
+    ##
+    # Checks, all elements follow condition expressed in block.
+    # Block must return Boolean.
+    #
+    # If it's empty, returns <tt>true</tt>.
+    #
+    
+    def all_pairs?(&block)
+        if self.empty?
+            return true
+        end
+        
+        self.each_pair do |k, v|
+            if block.call(k, v) == false
+                return false
+            end
+        end
+        
+        return true
+    end
+    
+    ##
+    # Checks, at least one element value follows condition expressed in 
+    # block. Block must return Boolean.
+    #
+    
+    def some?(&block)
+        self.each_value do |v|
+            if block.call(v) == true
+                return true
+            end
+        end
+        
+        return false
+    end
+
+    ##
+    # Checks, at least one element follows condition expressed in 
+    # block. Block must return Boolean.
+    #
+        
+    def some_pairs?(&block)
+        self.each_pair do |k, v|
+            if block.call(k, v) == true
+                return true
+            end
+        end
+        
+        return false
+    end
+end
+
+class Array
+
+    ##
+    # Checks, all values follow condition expressed in block.
+    # Block must return Boolean.
+    #
+    # If it's empty, returns <tt>true</tt>.
+    #
+    
+    def all?(&block)
+        if self.empty?
+            return true
+        end
+        
+        self.each do |v|
+            if block.call(v) == false
+                return false
+            end
+        end
+        
+        return true
+    end
+
+    ##
+    # Checks, at least one value follows condition expressed in 
+    # block. Block must return Boolean.
+    #
+    
+    def some?(&block)
+        self.each do |v|
+            if block.call(v) == true
+                return true
+            end
+        end
+        
+        return false
+    end
+
 end

metadata

@@ -4,9 +4,9 @@ version: !ruby/object:Gem::Version
   prerelease: false
   segments: 
   - 0
-  - 1
+  - 2
   - 0
-  version: 0.1.0
+  version: 0.2.0
 platform: ruby
 authors: 
 - "Martin Koz\xC3\xA1k"
@@ -14,7 +14,7 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2011-01-02 00:00:00 +01:00
+date: 2011-01-04 00:00:00 +01:00
 default_executable: 
 dependencies: 
 - !ruby/object:Gem::Dependency 
@@ -80,7 +80,7 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements: 
   - - ">="
     - !ruby/object:Gem::Version 
-      hash: 3564167343409950295
+      hash: 3013449918055684649
       segments: 
       - 0
       version: "0"
@@ -98,6 +98,6 @@ rubyforge_project:
 rubygems_version: 1.3.7
 signing_key: 
 specification_version: 3
-summary: Adds some useful well known methods similar to appropriate Array methods to Hash.
+summary: Adds some useful well known methods similar to appropriate Array methods to Hash and some useful methods known from Python to both of them.
 test_files: []