hash-utils 0.18.0 → 0.18.1

data/CHANGES.txt

@@ -0,0 +1,117 @@
+
+0.18.1 (2011-08-22)
+* String: #interlace, #interlace!
+* Object#instance_of_any? and #kind_of_any? receives both class or 
+  array of classes
+* bug fix in String#unshift
+
+0.18.0 (2011-07-13)
+* Object: #proc?
+* Proc: #proc?
+* String: #swap_with, #cut!
+* minor optimizations
+
+0.17.1 (2011-06-24)
+* Gem: #available?, #require_available
+
+0.17.0 (2011-06-24)
+* Numeric: #number?
+* String: #string?
+* Object: #string?, #symbol?, #number?, #boolean?, #array?, #hash?
+* Symbol: #strip
+* TrueClass: #boolean?, #false?, #true?
+* FalseClass: #boolean?, #false?, #true?
+* Hash: #hash?
+* Array: #array?
+
+0.16.0 (2011-06-23)
+* Numeric: #compare, #positive?, #negative?, #negative!, #positive!
+* Object: #instance_of_any?, #kind_of_any?
+
+0.15.0 (2011-05-30)
+* Hash#keys_to_sym now converts only strings
+* Hash#to_h bug correction
+* Hash#all? removed in favour built-in one
+* Hash: #get, #get_items, #get_values
+* Symbol: #split
+* Array: #first, #second, #third, #fourth, #fifth, #sixth, 
+  #seventh, #eigtht
+* String: #ucfirst, #ucfirst!, #lcfirst, #lcfirst!, #first, #second, 
+  #third, #fourth, #fifth, #sixth, #seventh, #eigtht
+* Object: #true?, #false?
+
+0.14.0 (2011-03-25)
+* Object: #io?
+* IO: #io?
+* StringIO: #io?
+
+0.13.1 (2011-03-24)
+* Symbol: #append, #prepend
+* Module: #get_module
+* bug in Hash#deep_merge corrected
+
+0.12.0 (2011-03-20)
+* String: #first_lines, #first_line, #last_lines, #last_line, 
+  #shift_lines, #shift_line, #unshift_lines, #unshift_line, #pop_lines,
+  #pop_line, #push_lines, #push_line, #push, #pop, #shift, #unshift
+* Hash: #deep_merge, #deep_merge!, #compact, #compact!
+* Object: #**
+* Symbol: #*, #+, #[], #start_with?, #end_with?
+
+0.11.1 (2011-03-09)
+* binary mode support for File#write
+
+0.11.0 (2011-03-01)
+* File: #write, #touch
+* String: #first, #last
+* Hash: #map_values, #map_values!
+
+0.10.0 (2011-02-22)
+* overimplemented built-in methods removed
+* Array: #merge!
+* Hash: #combine
+
+0.9.0 (2011-02-21)
+* minor documentation corrections
+* Hash: #has_all?, #has_some?
+
+0.8.0 (2011-02-13)
+* #in? method moved to Object class
+* more efficient strigng to array conversion
+* minor bug in central includer corrected
+* String: #gsub_f, #gsub_f!
+
+0.7.0 (2011-02-10)
+* more efficient String#map
+* Object: #to_b
+
+0.6.0 (2011-02-09)
+* String: #to_a, #map, #map!
+
+0.5.0 (2011-02-08)
+* Hash: #sort!, #ksort, #ksort!, #asort, #asort!, #reverse, #reverse!
+
+0.4.1 (2011-01-27)
+* String#tr -> String#strtr
+
+0.4.0 (2011-01-27)
+* String: #tr, #tr!
+* Array: #to_h
+* Hash: #to_h
+* documentation typo changes
+
+0.3.1 (2011-01-20)
+* minor documentation corrections
+
+0.3.0 (2011-01-12)
+* extensions splitted to standalone files
+* Hash: #define, #create, #recreate, #remove!
+* Array: #remove!
+* String: #numeric?
+
+0.2.0 (2011-01-04)
+* Hash: #some?, #all?
+* Array: #some?, #all?
+
+0.1.0 (2011-01-02) 
+* initial version

data/Gemfile.lock

@@ -2,14 +2,14 @@ GEM
   remote: http://rubygems.org/
   specs:
     git (1.2.5)
-    jeweler (1.6.3)
+    jeweler (1.6.4)
       bundler (~> 1.0)
       git (>= 1.2.5)
       rake
     rake (0.9.2)
     riot (0.12.4)
       rr
-    rr (1.0.2)
+    rr (1.0.3)
 
 PLATFORMS
   ruby

data/LICENSE.txt

@@ -1,4 +1,4 @@
-Copyright (c) 2011 Martin Kozák
+Copyright (c) 2011 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/TODO.txt

@@ -1,4 +1,2 @@
 * add examples to each call
-* puts list of methods directly to readme for each class
-* changes list
 * write riot tests

data/VERSION

@@ -1 +1 @@
-0.18.0
+0.18.1

data/hash-utils.gemspec

@@ -5,11 +5,11 @@
 
 Gem::Specification.new do |s|
   s.name = %q{hash-utils}
-  s.version = "0.18.0"
+  s.version = "0.18.1"
 
   s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
   s.authors = [%q{Martin Kozák}]
-  s.date = %q{2011-07-14}
+  s.date = %q{2011-08-22}
   s.email = %q{martinkozak@martinkozak.net}
   s.extra_rdoc_files = [
     "LICENSE.txt",
@@ -17,6 +17,7 @@ Gem::Specification.new do |s|
   ]
   s.files = [
     ".document",
+    "CHANGES.txt",
     "Gemfile",
     "Gemfile.lock",
     "LICENSE.txt",
@@ -48,7 +49,7 @@ HASH UTILS: Some methods are optimized at Ruby 1.8.7 and 1.9 or higher, but this
 
 }
   s.require_paths = [%q{lib}]
-  s.rubygems_version = %q{1.8.5}
+  s.rubygems_version = %q{1.8.8}
   s.summary = %q{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.}
 
   if s.respond_to? :specification_version then

data/lib/hash-utils/object.rb

@@ -16,9 +16,9 @@ class Object
     # @since 0.16.0
     #
     
-    def instance_of_any?(classes)
-        if not classes.kind_of? Array
-            raise Exception::new("Array expected.")
+    def instance_of_any?(*classes)
+        if classes.first.array?
+            classes = classes.first
         end
         
         classes.each do |cls|
@@ -40,9 +40,9 @@ class Object
     # @since 0.16.0
     #
     
-    def kind_of_any?(classes)
-        if not classes.kind_of? Array
-            raise Exception::new("Array expected.")
+    def kind_of_any?(*classes)
+        if classes.first.array?
+            classes = classes.first
         end
         
         classes.each do |cls|

data/lib/hash-utils/string.rb

@@ -17,6 +17,12 @@ class String
     
     NUMERIC = /^\s*-?\d+(?:\.\d+)?\s*$/
     
+    ##
+    # Holds character interlacing matcher.
+    #
+    
+    INTERLACING = /(.)([^$])/
+    
     ##
     # Indicates, string is numeric, so consists of numbers only.
     #
@@ -515,7 +521,7 @@ class String
     #
     
     def unshift(string)
-        self.replace(string << self)
+        self.replace(string + self)
     end    
     
     alias :prepend :unshift
@@ -600,7 +606,7 @@ class String
     alias :"swap_with!" :swap_with
     
     ##
-    # Cuts string on place. Sets the content of #[] on place of 
+    # Cuts string in place. Sets the content of #[] on place of 
     # the string.
     #
     # @param [Range] range range with from and to limits
@@ -611,6 +617,38 @@ class String
     def cut!(range)
         self.replace(self[range])
     end
+
+    ##
+    # Performs string interlacing. It means, it inserts given string
+    # between characters of the string.
+    #
+    # @example
+    #   "abc".interlace("123")    # will return "a123b123c"
+    #
+    # @param [String] string string which will interlaced to
+    # @return [String] new interlaced string
+    # @since 0.19.0
+    # 
+    
+    public
+    def interlace(string)
+        self.gsub(self.class::INTERLACING, '\1' << string << '\2' << string)
+    end
+    
+    ##
+    # Performs string interlacing in place. 
+    #
+    # @param [String] string string which will interlaced to
+    # @return [String] itself
+    # @see #interlace
+    # @since 0.19.0
+    # 
+    
+    public
+    def interlace!(string)
+        self.gsub!(self.class::INTERLACING, '\1' << string << '\2' << string)
+        self
+    end
     
     
     private

data/test

@@ -254,13 +254,17 @@ context "Object" do
         5.in? 1..7 and not 9.in? 1..7
     end
     asserts("#instance_of_any?") do
-        "".instance_of_any? [String, Symbol] and not "".instance_of_any? [Integer, Float]
+        "".instance_of_any? [String, Symbol] \
+            and not "".instance_of_any? [Integer, Float] \
+            and "".instance_of_any? String, Symbol
     end
     asserts("#io?") do
         not "".io?
     end
     asserts("#kind_of_any?") do
-        "".kind_of_any? [String, Symbol] and not "".kind_of_any? [Integer, Float]
+        "".kind_of_any? [String, Symbol] \
+            and not "".kind_of_any? [Integer, Float] \
+            and "".kind_of_any? String, Symbol
     end
     asserts("#number?") do
         not :abcd.number? and 5.number?
@@ -325,6 +329,14 @@ context "String" do
         res &= "a\nb".first_lines(2) == ["a\n", "b"]
         res &= "a\nb\nc\n".first_lines(4) == ["a\n", "b\n", "c\n"]
     end
+    asserts("#interlace") do
+        "abc".interlace("123") == "a123b123c"
+    end
+    asserts("#interlace!") do
+        foo = "abc"
+        foo.interlace! "123"
+        foo == "a123b123c"
+    end
     asserts("#last") do
         "abc".last == ?c
     end

metadata

@@ -2,7 +2,7 @@
 name: hash-utils
 version: !ruby/object:Gem::Version 
   prerelease: 
-  version: 0.18.0
+  version: 0.18.1
 platform: ruby
 authors: 
 - "Martin Koz\xC3\xA1k"
@@ -10,7 +10,7 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2011-07-14 00:00:00 Z
+date: 2011-08-22 00:00:00 Z
 dependencies: 
 - !ruby/object:Gem::Dependency 
   name: bundler
@@ -56,6 +56,7 @@ extra_rdoc_files:
 - README.md
 files: 
 - .document
+- CHANGES.txt
 - Gemfile
 - Gemfile.lock
 - LICENSE.txt
@@ -93,7 +94,7 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements: 
   - - ">="
     - !ruby/object:Gem::Version 
-      hash: -1491975354394754334
+      hash: 1233012443660528982
       segments: 
       - 0
       version: "0"
@@ -106,7 +107,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
 requirements: []
 
 rubyforge_project: 
-rubygems_version: 1.8.5
+rubygems_version: 1.8.8
 signing_key: 
 specification_version: 3
 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.