tbpgr_utils 0.0.37 → 0.0.38

data/README.md

@@ -49,6 +49,7 @@ Or install it yourself as:
 |[TbpgrUtils Array#together_sample](#arraytogether_sampleor-tsample)                                                |together version of Array#sample. together_sample has alias :tsample                                                 |
 |[TbpgrUtils Array#together_select](#arraytogether_selector-tselect-together_find_all-tfindall)                     |together version of Enumerable#select. together_select has aliases [:tselect, :together_find_all, :tfindall]         |
 |[TbpgrUtils Array#together_shift](#arraytogether_shift)                                                            |together version of Array#shift. together_shift has alias :tshift                                                    |
+|[TbpgrUtils Array#together_shuffle](#arraytogether_shuffleor-tshuffle)                                             |together version of Array#shuffle. together_shuffle has alias :tshuffle                                              |
 |[TbpgrUtils Array#together_with_index](#arraytogether_with_index)                                                  |loop all arrays by block with index                                                                                  |
 |[AttributesHashable.to_hash](#attributeshashableto_hash)                                                           |define to_hash method for get instance_values                                                                        |
 |[AttributesInitializable::ClassMethods.attr_accessor_init](#attributesinitializableclassmethodsattr_accessor_init) |generate attr_accessor + initializer                                                                                 |
@@ -348,44 +349,56 @@ together_include? has alias :tinclude?
 
 both include single ret case
 ~~~ruby
-  lists = [[*1..5], [*5..9]]
-  ret = lists.together_include? 5
-  print ret # => true
+require 'tbpgr_utils'
+
+lists = [[*1..5], [*5..9]]
+ret = lists.together_include? 5
+print ret # => true
 ~~~
 
 one include single ret case
 ~~~ruby
-  lists = [[*1..5], [*5..9]]
-  ret = lists.together_include? 9
-  print ret # => true
+require 'tbpgr_utils'
+
+lists = [[*1..5], [*5..9]]
+ret = lists.together_include? 9
+print ret # => true
 ~~~
 
 both not include single ret case
 ~~~ruby
-  lists = [[*1..5], [*5..9]]
-  ret = lists.together_include? 10
-  print ret # => false
+require 'tbpgr_utils'
+
+lists = [[*1..5], [*5..9]]
+ret = lists.together_include? 10
+print ret # => false
 ~~~
 
 both include multi ret case
 ~~~ruby
-  lists = [[*1..5], [*5..9]]
-  ret = lists.together_include? 5, true
-  print ret # => [true, true]
+require 'tbpgr_utils'
+
+lists = [[*1..5], [*5..9]]
+ret = lists.together_include? 5, true
+print ret # => [true, true]
 ~~~
 
 one include multi ret case
 ~~~ruby
-  lists = [[*1..5], [*5..9]]
-  ret = lists.together_include? 9, true
-  print ret # => [false, true]
+require 'tbpgr_utils'
+
+lists = [[*1..5], [*5..9]]
+ret = lists.together_include? 9, true
+print ret # => [false, true]
 ~~~
 
 both not include multi ret case
 ~~~ruby
-  lists = [[*1..5], [*5..9]]
-  ret = lists.together_include? 10, true
-  print ret # => [false, false]
+require 'tbpgr_utils'
+
+lists = [[*1..5], [*5..9]]
+ret = lists.together_include? 10, true
+print ret # => [false, false]
 ~~~
 
 [back to list](#list)
@@ -395,6 +408,8 @@ together_index has alias :tindex
 
 both index exist case
 ~~~ruby
+require 'tbpgr_utils'
+
 lists = [[*1..5], [*5..9]]
 ret = lists.together_index 5
 print ret # => [4, 0]
@@ -402,6 +417,8 @@ print ret # => [4, 0]
 
 one include single ret case
 ~~~ruby
+require 'tbpgr_utils'
+
 lists = [[*1..5], [*5..9]]
 ret = lists.together_index 4
 print ret # => [3, nil]
@@ -409,6 +426,8 @@ print ret # => [3, nil]
 
 both not include single ret case
 ~~~ruby
+require 'tbpgr_utils'
+
 lists = [[*1..5], [*5..9]]
 ret = lists.together_index 10
 print ret # => [nil, nil]
@@ -421,6 +440,8 @@ together_insert has alias :tinsert
 
 both insert exist case
 ~~~ruby
+require 'tbpgr_utils'
+
 lists = [[*1..5], [*5..9]]
 ret = lists.together_insert(1, 55, 66)
 print ret # => [[1, 55, 66, 2, 3, 4, 5], [5, 55, 66, 6, 7, 8, 9]]
@@ -428,6 +449,8 @@ print ret # => [[1, 55, 66, 2, 3, 4, 5], [5, 55, 66, 6, 7, 8, 9]]
 
 both insert exist and minus index case
 ~~~ruby
+require 'tbpgr_utils'
+
 lists = [[*1..5], [*5..9]]
 ret = lists.together_insert(-2, 55, 66)
 print ret # => [[1, 2, 3, 4, 55, 66, 5], [5, 6, 7, 8, 55, 66, 9]]
@@ -435,6 +458,8 @@ print ret # => [[1, 2, 3, 4, 55, 66, 5], [5, 6, 7, 8, 55, 66, 9]]
 
 both insert exist case
 ~~~ruby
+require 'tbpgr_utils'
+
 lists = [[*1..5], [*5..9]]
 ret = lists.together_insert(6, 55, 66)
 print ret # => [[1, 2, 3, 4, 5, nil, 55, 66], [5, 6, 7, 8, 9, nil, 55, 66]],
@@ -447,6 +472,8 @@ together_last has alias :tlast
 
 no args case
 ~~~ruby
+require 'tbpgr_utils'
+
 lists = [[*1..5], [*6..10]]
 ret = lists.together_last
 print ret # => [5, 10]
@@ -454,6 +481,8 @@ print ret # => [5, 10]
 
 has args 2 case
 ~~~ruby
+require 'tbpgr_utils'
+
 lists = [[*1..5], [*6..10]]
 ret = lists.together_last 2
 print ret # => [[4, 5], [9, 10]]
@@ -461,6 +490,8 @@ print ret # => [[4, 5], [9, 10]]
 
 has args 0 case
 ~~~ruby
+require 'tbpgr_utils'
+
 lists = [[*1..5], [*6..10]]
 ret = lists.together_last 0
 print ret # => [[], []]
@@ -468,6 +499,8 @@ print ret # => [[], []]
 
 has args over size case
 ~~~ruby
+require 'tbpgr_utils'
+
 lists = [[*1..5], [*6..10]]
 ret = lists.together_last 6
 print ret # => [[*1..5], [*6..10]]
@@ -533,6 +566,8 @@ together_pop has alias :tpop
 
 not empty case
 ~~~ruby
+require 'tbpgr_utils'
+
 lists = [[1, 2], [5, 6]]
 ret = lists.together_pop
 print ret # => [2, 6]
@@ -541,6 +576,8 @@ print lists # => [1, 5]
 
 empty case
 ~~~ruby
+require 'tbpgr_utils'
+
 lists = [[], []]
 ret = lists.together_pop
 print ret # => [nil, nil]
@@ -548,6 +585,9 @@ print lists # => [[], []]
 ~~~
 
 not empty case with args
+~~~ruby
+require 'tbpgr_utils'
+
 lists = [[1, 2], [5, 6]]
 ret = lists.together_pop 2
 print ret # => [[1, 2], [5, 6]]
@@ -555,6 +595,9 @@ print lists # => [[], []]
 ~~~
 
 not empty case with args
+~~~ruby
+require 'tbpgr_utils'
+
 lists = [[], []]
 ret = lists.together_pop 2
 print ret # => [[], []]
@@ -567,6 +610,8 @@ print lists # => [[], []]
 * if you want to single return
 
 ~~~ruby
+require 'tbpgr_utils'
+
 firsts = [1, 2, 3, 4]
 seconds =  [4, 2, 3, 1]
 ret = [firsts, seconds].together_reduce{|memo, first, second|memo + first + second}
@@ -576,6 +621,8 @@ print ret # => output  20
 * if you want to single return with init value
 
 ~~~ruby
+require 'tbpgr_utils'
+
 firsts = [1, 2, 3, 4]
 seconds =  [4, 2, 3, 1]
 ret = [firsts, seconds].together_reduce(10){|memo, first, second|memo + first + second}
@@ -585,6 +632,8 @@ print ret # => output  30
 * if you want to single return with init string value
 
 ~~~ruby
+require 'tbpgr_utils'
+
 firsts = %w{a b c}
 seconds =  %w{1 2 3}
 ret = [firsts, seconds].together_reduce('start-'){|memo, first, second|memo + first + second}
@@ -594,6 +643,8 @@ print ret # => output 'start-a1b2c3'
 * if you want to single return with init Array value
 
 ~~~ruby
+require 'tbpgr_utils'
+
 firsts = [1, 2, 3, 4]
 seconds =  [4, 2, 3, 1]
 ret = [firsts, seconds].together_reduce([]){|memo, first, second|memo << first + second}
@@ -603,6 +654,8 @@ print ret # => output [5, 4, 6, 5]
 * if you want to single return with init Hash value
 
 ~~~ruby
+require 'tbpgr_utils'
+
 firsts = [1, 2, 3, 4]
 seconds =  [4, 2, 3, 1]
 ret = [firsts, seconds].together_reduce({}){|memo, first, second|memo[first] = second;memo}
@@ -616,6 +669,8 @@ together_reverse has alias :treverse
 
 not empty case
 ~~~ruby
+require 'tbpgr_utils'
+
 lists = [[1, 2], [5, 6]]
 ret = lists.together_reverse
 print ret # => [[2, 1], [6, 5]]
@@ -624,6 +679,8 @@ print lists # => [[1, 2], [5, 6]]
 
 one empty case
 ~~~ruby
+require 'tbpgr_utils'
+
 lists = [[1, 2], []]
 ret = lists.together_reverse
 print ret # => [[2, 1], []]
@@ -637,6 +694,8 @@ together_reverse! has alias :treverse!
 
 not empty case
 ~~~ruby
+require 'tbpgr_utils'
+
 lists = [[1, 2], [5, 6]]
 ret = lists.together_reverse!
 print ret # => [[2, 1], [6, 5]]
@@ -645,6 +704,8 @@ print lists # => [[2, 1], [6, 5]]
 
 one empty case
 ~~~ruby
+require 'tbpgr_utils'
+
 lists = [[1, 2], []]
 ret = lists.together_reverse!
 print ret # => [[2, 1], []]
@@ -658,6 +719,8 @@ together_sample has alias :tsample
 
 not empty case
 ~~~ruby
+require 'tbpgr_utils'
+
 lists = [[1, 2], [5, 6]]
 ret = lists.together_sample
 print ret # => [1 or 2, 5 or 6]
@@ -665,24 +728,35 @@ print ret # => [1 or 2, 5 or 6]
 
 empty case
 ~~~ruby
+require 'tbpgr_utils'
+
 lists = [[], []]
 ret = lists.together_sample
 print ret # => [nil, nil]
 ~~~
 
 not empty case with args
+~~~ruby
+require 'tbpgr_utils'
+
 lists = [[1, 2], [5, 6]]
 ret = lists.together_sample 2
 print ret # => [[1 or 2, 1 or 2], [5 or 6, 5 or 6]] 
 ~~~
 
 not empty case with args
+~~~ruby
+require 'tbpgr_utils'
+
 lists = [[], []]
 ret = lists.together_sample 2
 print ret # => [[], []]
 ~~~
 
 not empty, over size case with args
+~~~ruby
+require 'tbpgr_utils'
+
 lists = [[1, 2], [5, 6]]
 ret = lists.together_sample 3
 print ret # => [[1 or 2, 1 or 2], [5 or 6, 5 or 6]] 
@@ -717,6 +791,8 @@ together_shift has alias :tshift
 
 not empty case
 ~~~ruby
+require 'tbpgr_utils'
+
 lists = [[1, 2], [5, 6]]
 ret = lists.together_shift
 print ret # => [1, 5]
@@ -725,6 +801,8 @@ print lists # => [2, 6]
 
 empty case
 ~~~ruby
+require 'tbpgr_utils'
+
 lists = [[], []]
 ret = lists.together_shift
 print ret # => [nil, nil]
@@ -732,7 +810,9 @@ print lists # => [[], []]
 ~~~
 
 not empty case
-~~~ruby with args
+~~~ruby
+require 'tbpgr_utils'
+
 lists = [[1, 2], [5, 6]]
 ret = lists.together_shift 2
 print ret # => [[1, 2], [5, 6]]
@@ -740,7 +820,9 @@ print lists # => [[], []]
 ~~~
 
 not empty case
-~~~ruby with args
+~~~ruby
+require 'tbpgr_utils'
+
 lists = [[], []]
 ret = lists.together_shift 2
 print ret # => [[], []]
@@ -749,6 +831,19 @@ print lists # => [[], []]
 
 [back to list](#list)
 
+### Array#together_shuffle(or :tshuffle)
+together_shuffle has alias :tshuffle
+
+~~~ruby
+require 'tbpgr_utils'
+
+lists = [[1, 2], [5, 6]]
+ret = lists.together_shuffle
+print ret # => [[1 or 2, 1 or 2], [5 or 6, 5 or 6]]
+~~~
+
+[back to list](#list)
+
 ### Array#together_with_index
 ~~~ruby
 require 'tbpgr_utils'
@@ -1369,6 +1464,7 @@ if you are Sublime Text2 user, you can use snippet for TbpgrUtils.
 https://github.com/tbpgr/tbpgr_utils_snippets
 
 ## History
+* version 0.0.38 : add Array#together_shuffle(alias tshuffle).
 * version 0.0.37 : add Array#together_sample(alias tsample).
 * version 0.0.36 : add Array#together_reverse,Array#together_reverse!(alias treverse, alias treverse!).
 * version 0.0.35 : add Array#together_pop(alias tpop).

data/lib/open_classes/array/together_sample.rb

@@ -1,49 +1,49 @@
-# encoding: utf-8
-require 'open_classes/object'
-require 'open_classes/module'
-require 'open_classes/array/together_helper'
-
-# Array
-class Array
-  include TogetherHelper
-
-  # Arrays bulk sample.
-  #
-  # together_sample has alias :tsample
-  #
-  # not empty case
-  #   lists = [[1, 2], [5, 6]]
-  #   ret = lists.together_sample
-  #   print ret # => [1 or 2, 5 or 6]
-  #
-  # empty case
-  #   lists = [[], []]
-  #   ret = lists.together_sample
-  #   print ret # => [nil, nil]
-  #
-  # not empty case with args
-  #   lists = [[1, 2], [5, 6]]
-  #   ret = lists.together_sample 2
-  #   print ret # => [[1 or 2, 1 or 2], [5 or 6, 5 or 6]] 
-  #
-  # not empty case with args
-  #   lists = [[], []]
-  #   ret = lists.together_sample 2
-  #   print ret # => [[], []]
-  #
-  # not empty, over size case with args
-  #   lists = [[1, 2], [5, 6]]
-  #   ret = lists.together_sample 3
-  #   print ret # => [[1 or 2, 1 or 2], [5 or 6, 5 or 6]] 
-  #
-  def together_sample(count = nil)
-    if_not_contain_array_rails_type_error
-    if count.nil?
-      reduce([]) { |ret, list|ret << list.sample }
-    else
-      reduce([]) { |ret, list|ret << list.sample(count) }
-    end
-  end
-
-  alias_method :tsample, :together_sample
-end
+# encoding: utf-8
+require 'open_classes/object'
+require 'open_classes/module'
+require 'open_classes/array/together_helper'
+
+# Array
+class Array
+  include TogetherHelper
+
+  # Arrays bulk sample.
+  #
+  # together_sample has alias :tsample
+  #
+  # not empty case
+  #   lists = [[1, 2], [5, 6]]
+  #   ret = lists.together_sample
+  #   print ret # => [1 or 2, 5 or 6]
+  #
+  # empty case
+  #   lists = [[], []]
+  #   ret = lists.together_sample
+  #   print ret # => [nil, nil]
+  #
+  # not empty case with args
+  #   lists = [[1, 2], [5, 6]]
+  #   ret = lists.together_sample 2
+  #   print ret # => [[1 or 2, 1 or 2], [5 or 6, 5 or 6]]
+  #
+  # not empty case with args
+  #   lists = [[], []]
+  #   ret = lists.together_sample 2
+  #   print ret # => [[], []]
+  #
+  # not empty, over size case with args
+  #   lists = [[1, 2], [5, 6]]
+  #   ret = lists.together_sample 3
+  #   print ret # => [[1 or 2, 1 or 2], [5 or 6, 5 or 6]]
+  #
+  def together_sample(count = nil)
+    if_not_contain_array_rails_type_error
+    if count.nil?
+      reduce([]) { |ret, list|ret << list.sample }
+    else
+      reduce([]) { |ret, list|ret << list.sample(count) }
+    end
+  end
+
+  alias_method :tsample, :together_sample
+end

data/lib/open_classes/array/together_shuffle.rb

@@ -0,0 +1,23 @@
+# encoding: utf-8
+require 'open_classes/object'
+require 'open_classes/module'
+require 'open_classes/array/together_helper'
+
+# Array
+class Array
+  include TogetherHelper
+
+  # Arrays bulk shuffle.
+  #
+  # together_shuffle has alias :tshuffle
+  #
+  #   lists = [[1, 2], [5, 6]]
+  #   ret = lists.together_shuffle
+  #   print ret # => [[1 or 2, 1 or 2], [5 or 6, 5 or 6]]
+  def together_shuffle(count = nil)
+    if_not_contain_array_rails_type_error
+    reduce([]) { |ret, list|ret << list.shuffle }
+  end
+
+  alias_method :tshuffle, :together_shuffle
+end

data/lib/open_classes/array.rb

@@ -21,4 +21,5 @@ require 'open_classes/array/together_reverse'
 require 'open_classes/array/together_sample'
 require 'open_classes/array/together_select'
 require 'open_classes/array/together_shift'
+require 'open_classes/array/together_shuffle'
 require 'open_classes/array/together_with_index'

data/lib/tbpgr_utils/version.rb

@@ -2,5 +2,5 @@
 
 # Tbpgr Utilities
 module TbpgrUtils
-  VERSION = '0.0.37'
+  VERSION = '0.0.38'
 end

data/spec/open_classes/{together_sample_spec.rb → array/together_sample_spec.rb}

@@ -1,122 +1,122 @@
-# encoding: utf-8
-require 'spec_helper'
-require "active_support/core_ext/object/inclusion"
-require 'tbpgr_utils'
-
-describe Array do
-  context :together_sample do
-    cases = [
-      {
-        case_no: 1,
-        case_title: 'not empty case',
-        inputs: [[1, 2], [5, 6]],
-        method_name: 'together_sample',
-        expected_first: "actual[0].in? [1, 2]",
-        expected_second: "actual[1].in? [5, 6]",
-      },
-      {
-        case_no: 2,
-        case_title: 'one empty case',
-        inputs: [[1, 2], []],
-        method_name: 'together_sample',
-        expected_first: "actual[0].in? [1, 2]",
-        expected_second: "actual[1].nil?",
-      },
-      {
-        case_no: 3,
-        case_title: 'both empty case',
-        inputs: [[], []],
-        method_name: 'together_sample',
-        expected_first: "actual[0].nil?",
-        expected_second: "actual[1].nil?",
-      },
-      {
-        case_no: 4,
-        case_title: 'not empty, has args case',
-        inputs: [[1, 2], [5, 6]],
-        method_name: 'together_sample',
-        args: 2,
-        expected_size: 2,
-        expected_first: "f.in? [1, 2]",
-        expected_second: "s.in? [5, 6]",
-        has_args: true,
-      },
-      {
-        case_no: 5,
-        case_title: 'both empty, has args case',
-        inputs: [[], []],
-        method_name: 'together_sample',
-        args: 2,
-        expected_size: 0,
-        expected_ret: [[], []],
-        expected_self: [[], []],
-        has_args: true,
-      },
-      {
-        case_no: 6,
-        case_title: 'not empty, over size, has args case',
-        inputs: [[1, 2], [5, 6]],
-        method_name: 'together_sample',
-        args: 3,
-        expected_size: 2,
-        expected_first: "f.in? [1, 2]",
-        expected_second: "s.in? [5, 6]",
-        has_args: true,
-      },
-      {
-        case_no: 7,
-        case_title: 'not empty case',
-        inputs: [[1, 2], [5, 6]],
-        method_name: 'tsample',
-        expected_first: "actual[0].in? [1, 2]",
-        expected_second: "actual[1].in? [5, 6]",
-      },
-    ]
-
-    cases.each do |c|
-      it "|case_no=#{c[:case_no]}|case_title=#{c[:case_title]}" do
-        begin
-          case_before c
-
-          # -- given --
-          # nothing
-
-          # -- when --
-          if c[:has_args]
-            actual = c[:inputs].send c[:method_name], c[:args]
-            # -- then --
-            actual[0].each do |f|
-              first_ret = eval c[:expected_first], binding
-              expect(first_ret).to be_true
-            end
-            expect(actual[0].size).to eq(c[:expected_size])
-
-            actual[1].each do |s|
-              second_ret = eval c[:expected_second], binding
-              expect(second_ret).to be_true
-            end
-            expect(actual[1].size).to eq(c[:expected_size])
-          else
-            actual = c[:inputs].send c[:method_name]
-            # -- then --
-            first_ret = eval c[:expected_first], binding
-            expect(first_ret).to be_true
-            second_ret = eval c[:expected_second], binding
-            expect(second_ret).to be_true
-          end
-
-        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
+# encoding: utf-8
+require 'spec_helper'
+require 'active_support/core_ext/object/inclusion'
+require 'tbpgr_utils'
+
+describe Array do
+  context :together_sample do
+    cases = [
+      {
+        case_no: 1,
+        case_title: 'not empty case',
+        inputs: [[1, 2], [5, 6]],
+        method_name: 'together_sample',
+        expected_first: 'actual[0].in? [1, 2]',
+        expected_second: 'actual[1].in? [5, 6]',
+      },
+      {
+        case_no: 2,
+        case_title: 'one empty case',
+        inputs: [[1, 2], []],
+        method_name: 'together_sample',
+        expected_first: 'actual[0].in? [1, 2]',
+        expected_second: 'actual[1].nil?',
+      },
+      {
+        case_no: 3,
+        case_title: 'both empty case',
+        inputs: [[], []],
+        method_name: 'together_sample',
+        expected_first: 'actual[0].nil?',
+        expected_second: 'actual[1].nil?',
+      },
+      {
+        case_no: 4,
+        case_title: 'not empty, has args case',
+        inputs: [[1, 2], [5, 6]],
+        method_name: 'together_sample',
+        args: 2,
+        expected_size: 2,
+        expected_first: 'f.in? [1, 2]',
+        expected_second: 's.in? [5, 6]',
+        has_args: true,
+      },
+      {
+        case_no: 5,
+        case_title: 'both empty, has args case',
+        inputs: [[], []],
+        method_name: 'together_sample',
+        args: 2,
+        expected_size: 0,
+        expected_ret: [[], []],
+        expected_self: [[], []],
+        has_args: true,
+      },
+      {
+        case_no: 6,
+        case_title: 'not empty, over size, has args case',
+        inputs: [[1, 2], [5, 6]],
+        method_name: 'together_sample',
+        args: 3,
+        expected_size: 2,
+        expected_first: 'f.in? [1, 2]',
+        expected_second: 's.in? [5, 6]',
+        has_args: true,
+      },
+      {
+        case_no: 7,
+        case_title: 'not empty case',
+        inputs: [[1, 2], [5, 6]],
+        method_name: 'tsample',
+        expected_first: 'actual[0].in? [1, 2]',
+        expected_second: 'actual[1].in? [5, 6]',
+      },
+    ]
+
+    cases.each do |c|
+      it "|case_no=#{c[:case_no]}|case_title=#{c[:case_title]}" do
+        begin
+          case_before c
+
+          # -- given --
+          # nothing
+
+          # -- when --
+          if c[:has_args]
+            actual = c[:inputs].send c[:method_name], c[:args]
+            # -- then --
+            actual[0].each do |f|
+              first_ret = eval c[:expected_first], binding
+              expect(first_ret).to be_true
+            end
+            expect(actual[0].size).to eq(c[:expected_size])
+
+            actual[1].each do |s|
+              second_ret = eval c[:expected_second], binding
+              expect(second_ret).to be_true
+            end
+            expect(actual[1].size).to eq(c[:expected_size])
+          else
+            actual = c[:inputs].send c[:method_name]
+            # -- then --
+            first_ret = eval c[:expected_first], binding
+            expect(first_ret).to be_true
+            second_ret = eval c[:expected_second], binding
+            expect(second_ret).to be_true
+          end
+
+        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

data/spec/open_classes/array/together_shuffle_spec.rb

@@ -0,0 +1,55 @@
+# encoding: utf-8
+require 'spec_helper'
+require 'active_support/core_ext/object/inclusion'
+require 'tbpgr_utils'
+
+describe Array do
+  context :together_shuffle do
+    cases = [
+      {
+        case_no: 1,
+        case_title: 'not empty case',
+        inputs: [[1, 2], [5, 6]],
+        method_name: 'together_shuffle',
+        expected_first: 'actual[0].sort == c[:inputs][0]',
+        expected_second: 'actual[1].sort == c[:inputs][1]',
+      },
+      {
+        case_no: 2,
+        case_title: 'not empty case',
+        inputs: [[1, 2], [5, 6]],
+        method_name: 'tshuffle',
+        expected_first: 'actual[0].sort == c[:inputs][0]',
+        expected_second: 'actual[1].sort == c[:inputs][1]',
+      },
+    ]
+
+    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[0].sort).to eq(c[:inputs][0])
+          expect(actual[1].sort).to eq(c[:inputs][1])
+        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.37
+  version: 0.0.38
   prerelease: 
 platform: ruby
 authors:
@@ -9,11 +9,11 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2014-02-13 00:00:00.000000000 Z
+date: 2014-02-14 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activesupport
-  requirement: &21931512 !ruby/object:Gem::Requirement
+  requirement: &26179104 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ~>
@@ -21,10 +21,10 @@ dependencies:
         version: 4.0.1
   type: :runtime
   prerelease: false
-  version_requirements: *21931512
+  version_requirements: *26179104
 - !ruby/object:Gem::Dependency
   name: bundler
-  requirement: &21931224 !ruby/object:Gem::Requirement
+  requirement: &26178816 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ~>
@@ -32,10 +32,10 @@ dependencies:
         version: '1.3'
   type: :development
   prerelease: false
-  version_requirements: *21931224
+  version_requirements: *26178816
 - !ruby/object:Gem::Dependency
   name: rake
-  requirement: &21930996 !ruby/object:Gem::Requirement
+  requirement: &26178588 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -43,10 +43,10 @@ dependencies:
         version: '0'
   type: :development
   prerelease: false
-  version_requirements: *21930996
+  version_requirements: *26178588
 - !ruby/object:Gem::Dependency
   name: rspec
-  requirement: &21930672 !ruby/object:Gem::Requirement
+  requirement: &26178264 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ~>
@@ -54,10 +54,10 @@ dependencies:
         version: 2.14.1
   type: :development
   prerelease: false
-  version_requirements: *21930672
+  version_requirements: *26178264
 - !ruby/object:Gem::Dependency
   name: simplecov
-  requirement: &21930372 !ruby/object:Gem::Requirement
+  requirement: &26177964 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ~>
@@ -65,7 +65,7 @@ dependencies:
         version: 0.8.2
   type: :development
   prerelease: false
-  version_requirements: *21930372
+  version_requirements: *26177964
 description: Utilities
 email:
 - tbpgr@tbpgr.jp
@@ -109,6 +109,7 @@ files:
 - lib/open_classes/array/together_sample.rb
 - lib/open_classes/array/together_select.rb
 - lib/open_classes/array/together_shift.rb
+- lib/open_classes/array/together_shuffle.rb
 - lib/open_classes/array/together_with_index.rb
 - lib/open_classes/file.rb
 - lib/open_classes/kernel.rb
@@ -143,8 +144,10 @@ files:
 - spec/open_classes/array/together_pop_spec.rb
 - spec/open_classes/array/together_reduce_spec.rb
 - spec/open_classes/array/together_reverse_spec.rb
+- spec/open_classes/array/together_sample_spec.rb
 - spec/open_classes/array/together_select_spec.rb
 - spec/open_classes/array/together_shift_spec.rb
+- spec/open_classes/array/together_shuffle_spec.rb
 - spec/open_classes/array/together_spec.rb
 - spec/open_classes/array/together_with_index_spec.rb
 - spec/open_classes/file_spec.rb
@@ -152,7 +155,6 @@ files:
 - spec/open_classes/module_spec.rb
 - spec/open_classes/object_spec.rb
 - spec/open_classes/string_spec.rb
-- spec/open_classes/together_sample_spec.rb
 - spec/spec_helper.rb
 - spec/templatable_spec.rb
 - spec/template_methodable_spec.rb
@@ -205,8 +207,10 @@ test_files:
 - spec/open_classes/array/together_pop_spec.rb
 - spec/open_classes/array/together_reduce_spec.rb
 - spec/open_classes/array/together_reverse_spec.rb
+- spec/open_classes/array/together_sample_spec.rb
 - spec/open_classes/array/together_select_spec.rb
 - spec/open_classes/array/together_shift_spec.rb
+- spec/open_classes/array/together_shuffle_spec.rb
 - spec/open_classes/array/together_spec.rb
 - spec/open_classes/array/together_with_index_spec.rb
 - spec/open_classes/file_spec.rb
@@ -214,7 +218,6 @@ test_files:
 - spec/open_classes/module_spec.rb
 - spec/open_classes/object_spec.rb
 - spec/open_classes/string_spec.rb
-- spec/open_classes/together_sample_spec.rb
 - spec/spec_helper.rb
 - spec/templatable_spec.rb
 - spec/template_methodable_spec.rb