tbpgr_utils 0.0.20 → 0.0.21

data/README.md

@@ -22,6 +22,7 @@ Or install it yourself as:
 |:-----------                                                                                                       |:------------                                                                                                        |
 |[TbpgrUtils Array#together](#arraytogether)                                                                        |loop all arrays by block                                                                                             |
 |[TbpgrUtils Array#together_at](#arraytogether_at)                                                                  |together version of Array#at. together_at has alias :tat                                                             |
+|[TbpgrUtils Array#together_clear](#arraytogether_clear)                                                            |together version of Array#clear. together_clear has alias :tclear                                                    |
 |[TbpgrUtils Array#together_concat](#arraytogether_concat)                                                          |together version of Array#concat. together_concat has alias :tconcat                                                 |
 |[TbpgrUtils Array#together_map](#arraytogether_mapor-tmap-together_collect-tcollect)                               |together version of Enumerable#map. together_map has aliases [:tmap, :together_collect, :tcollect]                   |
 |[TbpgrUtils Array#together_reduce](#arraytogether_reduceor-treduce-together_inject-tinject)                        |together version of Enumerable#reduce. together_reduce has aliases [:treduce, :together_inject, :tinject]            |
@@ -77,6 +78,17 @@ print [alpha, numbers].together_at 2 # => output ['three', nil]
 
 [back to list](#list)
 
+### Array#together_clear
+~~~ruby
+require 'tbpgr_utils'
+
+alpha = %w{one two three}
+numbers = %w{1 2 3}
+[alpha, numbers].together_clear # => [[], []]
+~~~
+
+[back to list](#list)
+
 ### Array#together_concat
 ~~~ruby
 require 'tbpgr_utils'
@@ -784,6 +796,7 @@ if you are Sublime Text2 user, you can use snippet for TbpgrUtils.
 https://github.com/tbpgr/tbpgr_utils_snippets
 
 ## History
+* version 0.0.21 : add Array#together_clear. together_clear has alias :tclear
 * version 0.0.20 : add Array#together_at. together_at has alias :tat
 * version 0.0.19 : add AttributesHashable module.
 * version 0.0.18 : add Array#together_concat. together_concat has alias :tconcat

data/lib/open_classes/array.rb

@@ -1,218 +1,232 @@
-# encoding: utf-8
-require 'open_classes/object'
-require 'open_classes/module'
-
-# Array
-class Array
-  # Arrays loop together.
-  #
-  #   alpha = %w{one two three}
-  #   numbers = %w{1 2 3}
-  #   [alpha, numbers].together do |first, second|
-  #     print "#{first}:#{second}\n"  # => output one:1, two:2, three:3
-  #   end
-  def together
-    if_not_contain_array_rails_type_error
-    first.each_with_index do |i_v, i|
-      eval_each_str = get_args_str_for_together i
-      instance_eval "yield(#{eval_each_str})"
-    end
-  end
-
-  # Arrays loop together with index.
-  #
-  #   alpha = %w{one two three}
-  #   numbers = %w{1 2 3}
-  #   [alpha, numbers].together_with_index do |first, second, index|
-  #     print "#{index.to_s}:#{first}:#{second}\n"  # => output 0:one:1, 1:two:2, 2:three:3
-  #   end
-  def together_with_index
-    if_not_contain_array_rails_type_error
-    first.each_with_index do |i_v, i|
-      eval_each_str = get_args_str_for_together i, true
-      instance_eval "yield(#{eval_each_str})"
-    end
-  end
-
-  # Arrays together map.
-  #
-  # together_map has aliases [:tmap, :together_collect, :tcollect]
-  #
-  # if you want to single Array return
-  #   alpha = %w{one two three}
-  #   numbers = %w{1 2 3}
-  #   print [alpha, numbers].together_map do |first, second|
-  #     "#{first}:#{second}\n"
-  #   end # => output one:1, two:2, three:3
-  #
-  # if you want to multi Array return
-  #   alpha = %w{one two three}
-  #   numbers = %w{1 2 3}
-  #   print [alpha, numbers].together_map do |first, second|
-  #     ["#{first}:#{second}", "#{second}:#{first}"]
-  #   end # => output [['1:one', '2:two', '3:three'], ['one:1', 'two:2', 'three:3']]
-  def together_map
-    if_not_contain_array_rails_type_error
-    ret = []
-    first.each_with_index do |i_v, i|
-      eval_each_str = get_args_str_for_together i
-      each_ret = instance_eval "yield(#{eval_each_str})"
-      ret = set_together_each_return_map(ret, each_ret, i)
-    end
-    ret
-  end
-
-  # Arrays loop together select.
-  #
-  # together_select has aliases [:tselect, :together_find_all, :tfindall]
-  #
-  # if you want to single Array return
-  #   firsts = [1, 2, 3, 4]
-  #   seconds =  [4, 2, 3, 1]
-  #   ret = [firsts, seconds].together_select{|first, second|first == second}
-  #   print ret # => output  [[2, 3], [2, 3]]
-  #
-  # if you want to multi Array return
-  #   firsts = [1, 2, 3, 4]
-  #   seconds =  [4, 2, 3, 1]
-  #   ret = [firsts, seconds].together_select{|first, second|[first.odd?, second.even?]}
-  #   print ret # => output  [[1, 3], [4, 2]]
-  def together_select
-    if_not_contain_array_rails_type_error
-    ret = []
-    first.each_with_index do |i_v, i|
-      eval_each_str = get_args_str_for_together i
-      each_ret = instance_eval "yield(#{eval_each_str})"
-      ret = set_together_each_return_select(ret, each_ret, i)
-    end
-    ret
-  end
-
-  # Arrays loop together reduce.
-  #
-  # together_reduce has aliases [:treduce, :together_inject, :tinject]
-  #
-  # if you want to single return
-  #   firsts = [1, 2, 3, 4]
-  #   seconds =  [4, 2, 3, 1]
-  #   ret = [firsts, seconds].together_reduce{|memo, first, second|memo + first + second}
-  #   print ret # => output  20
-  #
-  # if you want to single return with init value
-  #   firsts = [1, 2, 3, 4]
-  #   seconds =  [4, 2, 3, 1]
-  #   ret = [firsts, seconds].together_reduce(10){|memo, first, second|memo + first + second}
-  #   print ret # => output  30
-  #
-  # if you want to single return with init string value
-  #   firsts = %w{a b c}
-  #   seconds =  %w{1 2 3}
-  #   ret = [firsts, seconds].together_reduce('start-'){|memo, first, second|memo + first + second}
-  #   print ret # => output 'start-a1b2c3'
-  #
-  # if you want to single return with init Array value
-  #   firsts = [1, 2, 3, 4]
-  #   seconds =  [4, 2, 3, 1]
-  #   ret = [firsts, seconds].together_reduce([]){|memo, first, second|memo << first + second}
-  #   print ret # => output [5, 4, 6, 5]
-  #
-  # if you want to single return with init Hash value
-  #   firsts = [1, 2, 3, 4]
-  #   seconds =  [4, 2, 3, 1]
-  #   ret = [firsts, seconds].together_reduce({}){|memo, first, second|memo[first] = second;memo}
-  #   print ret # => output {1=>4, 2=>2, 3=>3, 4=>1}
-  def together_reduce(init = nil)
-    if_not_contain_array_rails_type_error
-    memo = initial_memo init
-    first.each_with_index do |i_v, i|
-      eval_each_str = get_args_str_for_together i
-      memo = instance_eval "yield(memo, #{eval_each_str})"
-    end
-    memo
-  end
-
-  # Arrays bulk concat.
-  #
-  # together_concat has alias :tconcat
-  #
-  #   alpha = %w{one two three}
-  #   numbers = %w{1 2 3}
-  #   [alpha, numbers].together do |first, second|
-  #     print "#{first}:#{second}\n"  # => output one:1, two:2, three:3
-  #   end
-  def together_concat(other)
-    if_not_contain_array_rails_type_error
-    each { |list|list.concat other }
-  end
-
-  # Arrays bulk at.
-  #
-  # together_at has alias :tat
-  #
-  # same elements size case
-  #   alpha = %w{one two three}
-  #   numbers = %w{1 2 3}
-  #   [alpha, numbers].together_at 2 # => output ['three', 3]
-  #
-  # different elements size case
-  #   alpha = %w{one two three}
-  #   numbers = %w{1 2 nil}
-  #   [alpha, numbers].together_at 2 # => output ['three', nil]
-  def together_at(index)
-    if_not_contain_array_rails_type_error
-    reduce([]) { |ats, list|ats << list.at(index) }
-  end
-
-  private
-
-  def if_not_contain_array_rails_type_error
-    each { |f|fail TypeError, "you have to use [Array1, Array2, ...] | #{f.class} is invalid" unless f.class == Array }
-  end
-
-  def get_args_for_together(i)
-    eval_each = []
-    each_with_index { |j_v, j|eval_each << "self[#{j}][#{i}]" }
-    eval_each
-  end
-
-  def get_args_str_for_together(i, with_index = false)
-    each_eval = with_index ? get_args_for_together(i) << i : get_args_for_together(i)
-    each_eval.join(',')
-  end
-
-  def set_together_each_return_map(ret, each_ret, index)
-    if together_return_multi?(each_ret)
-      size.times { |i|ret << [] } if index == 0
-      (0..(size - 1)).each { |i|ret[i] << each_ret[i] }
-    else
-      ret << each_ret
-    end
-    ret
-  end
-
-  def set_together_each_return_select(ret, each_ret, index)
-    unless together_return_multi?(each_ret)
-      tmp_each_ret = []
-      size.times { tmp_each_ret << each_ret }
-      each_ret = tmp_each_ret
-    end
-    size.times { |i|ret << [] } if index == 0
-    (0..(size - 1)).each { |i|ret[i] << self[i][index] if each_ret[i] }
-    ret
-  end
-
-  def initial_memo(init)
-    return init unless init.nil?
-    first.first.is_a?(Numeric) ? 0 : first.first.is_a?(String) ? '' : nil
-  end
-
-  def together_return_multi?(list)
-    (list.class == Array && list.size == size).to_bool
-  end
-
-  alias_method :tconcat, :together_concat
-  alias_method :tat, :together_at
-  alias_methods [:together_collect, :tmap, :tcollect], :together_map
-  alias_methods [:together_find_all, :tselect, :tfindall], :together_select
-  alias_methods [:together_inject, :treduce, :tinject], :together_reduce
-end
+# encoding: utf-8
+require 'open_classes/object'
+require 'open_classes/module'
+
+# Array
+class Array
+  # Arrays loop together.
+  #
+  #   alpha = %w{one two three}
+  #   numbers = %w{1 2 3}
+  #   [alpha, numbers].together do |first, second|
+  #     print "#{first}:#{second}\n"  # => output one:1, two:2, three:3
+  #   end
+  def together
+    if_not_contain_array_rails_type_error
+    first.each_with_index do |i_v, i|
+      eval_each_str = get_args_str_for_together i
+      instance_eval "yield(#{eval_each_str})"
+    end
+  end
+
+  # Arrays loop together with index.
+  #
+  #   alpha = %w{one two three}
+  #   numbers = %w{1 2 3}
+  #   [alpha, numbers].together_with_index do |first, second, index|
+  #     print "#{index.to_s}:#{first}:#{second}\n"  # => output 0:one:1, 1:two:2, 2:three:3
+  #   end
+  def together_with_index
+    if_not_contain_array_rails_type_error
+    first.each_with_index do |i_v, i|
+      eval_each_str = get_args_str_for_together i, true
+      instance_eval "yield(#{eval_each_str})"
+    end
+  end
+
+  # Arrays together map.
+  #
+  # together_map has aliases [:tmap, :together_collect, :tcollect]
+  #
+  # if you want to single Array return
+  #   alpha = %w{one two three}
+  #   numbers = %w{1 2 3}
+  #   print [alpha, numbers].together_map do |first, second|
+  #     "#{first}:#{second}\n"
+  #   end # => output one:1, two:2, three:3
+  #
+  # if you want to multi Array return
+  #   alpha = %w{one two three}
+  #   numbers = %w{1 2 3}
+  #   print [alpha, numbers].together_map do |first, second|
+  #     ["#{first}:#{second}", "#{second}:#{first}"]
+  #   end # => output [['1:one', '2:two', '3:three'], ['one:1', 'two:2', 'three:3']]
+  def together_map
+    if_not_contain_array_rails_type_error
+    ret = []
+    first.each_with_index do |i_v, i|
+      eval_each_str = get_args_str_for_together i
+      each_ret = instance_eval "yield(#{eval_each_str})"
+      ret = set_together_each_return_map(ret, each_ret, i)
+    end
+    ret
+  end
+
+  # Arrays loop together select.
+  #
+  # together_select has aliases [:tselect, :together_find_all, :tfindall]
+  #
+  # if you want to single Array return
+  #   firsts = [1, 2, 3, 4]
+  #   seconds =  [4, 2, 3, 1]
+  #   ret = [firsts, seconds].together_select{|first, second|first == second}
+  #   print ret # => output  [[2, 3], [2, 3]]
+  #
+  # if you want to multi Array return
+  #   firsts = [1, 2, 3, 4]
+  #   seconds =  [4, 2, 3, 1]
+  #   ret = [firsts, seconds].together_select{|first, second|[first.odd?, second.even?]}
+  #   print ret # => output  [[1, 3], [4, 2]]
+  def together_select
+    if_not_contain_array_rails_type_error
+    ret = []
+    first.each_with_index do |i_v, i|
+      eval_each_str = get_args_str_for_together i
+      each_ret = instance_eval "yield(#{eval_each_str})"
+      ret = set_together_each_return_select(ret, each_ret, i)
+    end
+    ret
+  end
+
+  # Arrays loop together reduce.
+  #
+  # together_reduce has aliases [:treduce, :together_inject, :tinject]
+  #
+  # if you want to single return
+  #   firsts = [1, 2, 3, 4]
+  #   seconds =  [4, 2, 3, 1]
+  #   ret = [firsts, seconds].together_reduce{|memo, first, second|memo + first + second}
+  #   print ret # => output  20
+  #
+  # if you want to single return with init value
+  #   firsts = [1, 2, 3, 4]
+  #   seconds =  [4, 2, 3, 1]
+  #   ret = [firsts, seconds].together_reduce(10){|memo, first, second|memo + first + second}
+  #   print ret # => output  30
+  #
+  # if you want to single return with init string value
+  #   firsts = %w{a b c}
+  #   seconds =  %w{1 2 3}
+  #   ret = [firsts, seconds].together_reduce('start-'){|memo, first, second|memo + first + second}
+  #   print ret # => output 'start-a1b2c3'
+  #
+  # if you want to single return with init Array value
+  #   firsts = [1, 2, 3, 4]
+  #   seconds =  [4, 2, 3, 1]
+  #   ret = [firsts, seconds].together_reduce([]){|memo, first, second|memo << first + second}
+  #   print ret # => output [5, 4, 6, 5]
+  #
+  # if you want to single return with init Hash value
+  #   firsts = [1, 2, 3, 4]
+  #   seconds =  [4, 2, 3, 1]
+  #   ret = [firsts, seconds].together_reduce({}){|memo, first, second|memo[first] = second;memo}
+  #   print ret # => output {1=>4, 2=>2, 3=>3, 4=>1}
+  def together_reduce(init = nil)
+    if_not_contain_array_rails_type_error
+    memo = initial_memo init
+    first.each_with_index do |i_v, i|
+      eval_each_str = get_args_str_for_together i
+      memo = instance_eval "yield(memo, #{eval_each_str})"
+    end
+    memo
+  end
+
+  # Arrays bulk concat.
+  #
+  # together_concat has alias :tconcat
+  #
+  #   alpha = %w{one two three}
+  #   numbers = %w{1 2 3}
+  #   [alpha, numbers].together do |first, second|
+  #     print "#{first}:#{second}\n"  # => output one:1, two:2, three:3
+  #   end
+  def together_concat(other)
+    if_not_contain_array_rails_type_error
+    each { |list|list.concat other }
+  end
+
+  # Arrays bulk at.
+  #
+  # together_at has alias :tat
+  #
+  # same elements size case
+  #   alpha = %w{one two three}
+  #   numbers = %w{1 2 3}
+  #   [alpha, numbers].together_at 2 # => output ['three', 3]
+  #
+  # different elements size case
+  #   alpha = %w{one two three}
+  #   numbers = %w{1 2}
+  #   [alpha, numbers].together_at 2 # => output ['three', nil]
+  def together_at(index)
+    if_not_contain_array_rails_type_error
+    reduce([]) { |ats, list|ats << list.at(index) }
+  end
+
+  # Arrays bulk clear.
+  #
+  # together_clear has alias :tclear
+  #
+  # same elements size case
+  #   alpha = %w{one two three}
+  #   numbers = %w{1 2 3}
+  #   [alpha, numbers].together_clear # => output [[],[]]
+  def together_clear
+    if_not_contain_array_rails_type_error
+    each { |list|list.clear }
+  end
+
+  private
+
+  def if_not_contain_array_rails_type_error
+    each { |f|fail TypeError, "you have to use [Array1, Array2, ...] | #{f.class} is invalid" unless f.class == Array }
+  end
+
+  def get_args_for_together(i)
+    eval_each = []
+    each_with_index { |j_v, j|eval_each << "self[#{j}][#{i}]" }
+    eval_each
+  end
+
+  def get_args_str_for_together(i, with_index = false)
+    each_eval = with_index ? get_args_for_together(i) << i : get_args_for_together(i)
+    each_eval.join(',')
+  end
+
+  def set_together_each_return_map(ret, each_ret, index)
+    if together_return_multi?(each_ret)
+      size.times { |i|ret << [] } if index == 0
+      (0..(size - 1)).each { |i|ret[i] << each_ret[i] }
+    else
+      ret << each_ret
+    end
+    ret
+  end
+
+  def set_together_each_return_select(ret, each_ret, index)
+    unless together_return_multi?(each_ret)
+      tmp_each_ret = []
+      size.times { tmp_each_ret << each_ret }
+      each_ret = tmp_each_ret
+    end
+    size.times { |i|ret << [] } if index == 0
+    (0..(size - 1)).each { |i|ret[i] << self[i][index] if each_ret[i] }
+    ret
+  end
+
+  def initial_memo(init)
+    return init unless init.nil?
+    first.first.is_a?(Numeric) ? 0 : first.first.is_a?(String) ? '' : nil
+  end
+
+  def together_return_multi?(list)
+    (list.class == Array && list.size == size).to_bool
+  end
+
+  alias_method :tconcat, :together_concat
+  alias_method :tat, :together_at
+  alias_method :tclear, :together_clear
+  alias_methods [:together_collect, :tmap, :tcollect], :together_map
+  alias_methods [:together_find_all, :tselect, :tfindall], :together_select
+  alias_methods [:together_inject, :treduce, :tinject], :together_reduce
+end

data/lib/tbpgr_utils/version.rb

@@ -2,5 +2,5 @@
 
 # Tbpgr Utilities
 module TbpgrUtils
-  VERSION = '0.0.20'
+  VERSION = '0.0.21'
 end

data/spec/open_classes/array_spec.rb

@@ -442,4 +442,50 @@ describe Array do
       end
     end
   end
+
+  context :together_clear do
+    cases = [
+      {
+        case_no: 1,
+        case_title: 'valid case',
+        inputs: [[1, 2, 3], %w{one two three}],
+        method_name: :together_clear,
+        expected: [[], []],
+      },
+      {
+        case_no: 2,
+        case_title: 'valid case',
+        inputs: [[1, 2, 3], %w{one two three}],
+        method_name: :tclear,
+        expected: [[], []],
+      },
+    ]
+
+    cases.each do |c|
+      it "|case_no=#{c[:case_no]}|case_title=#{c[:case_title]}" do
+        begin
+          case_before c
+
+          # -- given --
+          # nothing
+
+          # -- when --
+          actual = c[:inputs].send c[:method_name]
+
+          # -- then --
+          expect(actual).to eq(c[:expected])
+        ensure
+          case_after c
+        end
+      end
+
+      def case_before(c)
+        # implement each case before
+      end
+
+      def case_after(c)
+        # implement each case after
+      end
+    end
+  end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: tbpgr_utils
 version: !ruby/object:Gem::Version
-  version: 0.0.20
+  version: 0.0.21
   prerelease: 
 platform: ruby
 authors:
@@ -9,11 +9,11 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2014-01-27 00:00:00.000000000 Z
+date: 2014-01-28 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activesupport
-  requirement: &28991616 !ruby/object:Gem::Requirement
+  requirement: &20610228 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ~>
@@ -21,10 +21,10 @@ dependencies:
         version: 4.0.1
   type: :runtime
   prerelease: false
-  version_requirements: *28991616
+  version_requirements: *20610228
 - !ruby/object:Gem::Dependency
   name: bundler
-  requirement: &28991088 !ruby/object:Gem::Requirement
+  requirement: &20609928 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ~>
@@ -32,10 +32,10 @@ dependencies:
         version: '1.3'
   type: :development
   prerelease: false
-  version_requirements: *28991088
+  version_requirements: *20609928
 - !ruby/object:Gem::Dependency
   name: rake
-  requirement: &28990692 !ruby/object:Gem::Requirement
+  requirement: &20609700 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -43,10 +43,10 @@ dependencies:
         version: '0'
   type: :development
   prerelease: false
-  version_requirements: *28990692
+  version_requirements: *20609700
 - !ruby/object:Gem::Dependency
   name: rspec
-  requirement: &28989852 !ruby/object:Gem::Requirement
+  requirement: &20609364 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ~>
@@ -54,10 +54,10 @@ dependencies:
         version: 2.14.1
   type: :development
   prerelease: false
-  version_requirements: *28989852
+  version_requirements: *20609364
 - !ruby/object:Gem::Dependency
   name: simplecov
-  requirement: &29005188 !ruby/object:Gem::Requirement
+  requirement: &20609064 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ~>
@@ -65,7 +65,7 @@ dependencies:
         version: 0.8.2
   type: :development
   prerelease: false
-  version_requirements: *29005188
+  version_requirements: *20609064
 description: Utilities
 email:
 - tbpgr@tbpgr.jp