sixarm_ruby_array_slice 2.1.2

data/CHANGELOG.txt

@@ -0,0 +1,4 @@
+CHANGELOG
+
+2012-02-01 1.0.0 Publish
+

data/INSTALL.txt

@@ -0,0 +1,32 @@
+
+= SixArm.com Ruby Gem Install
+
+
+First-time users: add our gem certificate and source.
+When you do this once, it works for all our gems.
+
+  sudo wget http://sixarm.com/sixarm.pem
+  sudo gem cert --add sixarm.pem   
+  sudo gem sources --add http://sixarm.com
+
+Install the gem with advanced options.
+
+  sudo gem install sixarm_ruby_array_slice --test --trust-policy HighSecurity
+
+
+== Notes
+
+Do you have any questions, comments, suggestions, or feedback?
+Let us know, we're happy to help. Our email is sixarm@sixarm.com
+
+Do you want to create your own high security gems?
+Learn how at http://www.rubygems.org/read/chapter/21
+
+To see your current gem certificate list:
+
+  sudo gem cert --list
+
+Our cert looks like this:
+
+  /C=US/ST=California/L=San Francisco/O=SixArm/CN=sixarm.com
+

data/LICENSE.txt

@@ -0,0 +1,25 @@
+LICENSE
+
+You may choose any of these open source licenses:
+
+  - Apache License
+  - BSD License
+  - CreativeCommons License, Non-commercial Share Alike
+  - GNU General Public License Version 2 (GPL 2)
+  - GNU Lesser General Public License (LGPL)
+  - MIT License
+  - Perl Artistic License
+  - Ruby License
+
+The software is provided "as is", without warranty of any kind, 
+express or implied, including but not limited to the warranties of 
+merchantability, fitness for a particular purpose and noninfringement. 
+
+In no event shall the authors or copyright holders be liable for any 
+claim, damages or other liability, whether in an action of contract, 
+tort or otherwise, arising from, out of or in connection with the 
+software or the use or other dealings in the software.
+
+This license is for the included software that is created by SixArm;
+some of the included software may have its own licenses, copyrights, 
+authors, etc. and these do take precedence over the SixArm license.

data/README.rdoc

@@ -0,0 +1,15 @@
+= SixArm.com » Ruby » Array slices by size and count
+
+Author:: Joel Parker Henderson, joel@joelparkerhenderson.com
+Copyright:: Copyright (c) 2006-2012 Joel Parker Henderson
+License:: See LICENSE.txt file
+
+Array slice methods:
+
+* #slice_by_share: divides an array into a given number of slices
+* #slice_by_size: divides an array into a slices of a given size
+
+These methods are extraced from the sixarm_ruby_ramp gem.
+
+
+

data/Rakefile

@@ -0,0 +1,8 @@
+# -*- coding: utf-8 -*-
+require 'rake'
+require 'rake/testtask'
+
+Rake::TestTask.new(:test) do |t|
+  t.libs << 'lib' << 'test'
+  t.pattern = 'test/*.rb'
+end

data/VERSION

@@ -0,0 +1 @@
+2.1.2

data/lib/sixarm_ruby_array_slice.rb

@@ -0,0 +1,70 @@
+# -*- coding: utf-8 -*-
+=begin rdoc
+Please see README.rdoc
+=end
+
+
+class Array
+
+
+  # Slice the array into sub-arrays of size _n_.
+  #
+  # @return [Array<Array<Object>>] slices where each slice has approximately _n_ items
+  #
+  # If the array divides evenly then each slice has _n_ items:
+  #
+  #    [1,2,3,4,5,6,7,8].slice_by_size(2) => [[1,2],[3,4],[5,6],[7,8]]
+  #    [1,2,3,4,5,6,7,8].slice_by_size(4) => [[1,2,3,4],[5,6,7,8]]
+  #
+  # If the array does not divide evenly then the last slice will be smaller:
+  #
+  #    [1,2,3,4,5,6,7,8].slice_by_size(3) => [[1,2,3],[4,5,6],[7,8]]
+  #
+  # If the array size is small compared to _n_ then the results will be best-attempt:
+  #
+  #    [1,2,3,4,5,6,7,8].slice_by_size(7) => [[1,2,3,4,5,6,7],[8]]
+  #
+  # Compare #slice_by_share
+
+  def slice_by_size(size)
+    (size.is_a? Integer) or (raise ArgumentError, "size must be an integer")
+    (size > 0) or (raise ArgumentError, "size must be > 0")
+    arr=[]
+    index=0
+    while index<length
+      arr.push self[index...(index+size)]
+      index+=size
+    end
+    return arr
+  end
+
+
+  # Slice the array into _n_ sub-arrays of the same size.
+  #
+  # @return [Array<Array<Object>>] _n_ slices where each slice is approximately the same size.
+  #
+  # If the array divides evenly, then each slice has size/n items:
+  #
+  #     [1,2,3,4,5,6,7,8].slice_by_share(2) => [[1,2,3,4],[5,6,7,8]]
+  #     [1,2,3,4,5,6,7,8].slice_by_share(4) => [[1,2],[3,4],[5,6],[7,8]]
+  #
+  # If the array does not divide evenly then the latter slices will be smaller:
+  #
+  #     [1,2,3,4,5,6,7,8].slice_by_share(3) => [[1,2,3],[4,5,6],[7,8]] 
+  #
+  # If the array size is small compared to _n_ then the results will be best-attempt:
+  #
+  #     [1,2,3,4,5,6,7,8].slice_by_share(7) => [[1,2],[3,4],[5,6],[7,8],[],[],[]]
+  #
+  # Compare #slice_by_size
+
+  def slice_by_share(share)
+    (share.is_a? Integer) or (raise ArgumentError, "share must be an integer")
+    (share > 0) or (raise ArgumentError, "share must be > 0")
+    arr = slice_by_size((length.to_f/share.to_f).ceil)
+    while arr.size < share do arr << [] end
+    return arr
+  end
+
+
+end

data/test/sixarm_ruby_array_slice_test.rb

@@ -0,0 +1,105 @@
+# -*- coding: utf-8 -*-
+require 'test/unit'
+require 'simplecov'
+SimpleCov.start
+require 'sixarm_ruby_array_slice'
+
+class SliceTest < Test::Unit::TestCase
+
+ A=[1,2,3,4,5,6,7,8]
+
+ ### #slice_by_size typical use
+
+ def test_slice_by_size_with_1_count
+   assert_equal([[1],[2],[3],[4],[5],[6],[7],[8]], A.slice_by_size(1))
+ end
+
+ def test_slice_by_size_with_balanced_results
+   assert_equal([[1,2],[3,4],[5,6],[7,8]], A.slice_by_size(2))
+   assert_equal([[1,2,3,4],[5,6,7,8]], A.slice_by_size(4))
+ end
+
+ def test_slice_by_size_with_unbalanced_results
+   assert_equal([[1,2,3],[4,5,6],[7,8]], A.slice_by_size(3))
+ end
+
+ def test_slice_by_size_with_very_unbalanced_results
+   assert_equal([[1,2,3,4,5,6,7],[8]], A.slice_by_size(7))
+ end
+
+ ### ... atypical
+
+ def test_slice_by_size_with_empty_input
+   assert_equal([],[].slice_by_size(1))
+ end
+
+ def test_slice_by_size_with_0_count
+   assert_raise ArgumentError do
+     A.slice_by_size(0)
+   end
+ end
+
+ def test_slice_by_size_with_negative_count
+   assert_raise ArgumentError do
+     A.slice_by_size(-1)
+   end
+ end
+
+ def test_slice_by_size_with_float_count
+   assert_raise ArgumentError do
+     A.slice_by_size(1.234)
+   end
+ end
+
+ def test_slice_by_size_with_non_numeric_count
+   assert_raise ArgumentError do
+     A.slice_by_size(1.234)
+   end
+ end
+
+ ### #slice_by_share typical use
+
+ def test_slice_by_share_with_1_count
+   assert_equal([[1,2,3,4,5,6,7,8]],A.slice_by_share(1))
+ end
+
+ def test_slice_by_share_with_balanced_results
+   assert_equal([[1,2,3,4],[5,6,7,8]], A.slice_by_share(2))
+   assert_equal([[1,2],[3,4],[5,6],[7,8]], A.slice_by_share(4))
+ end
+
+ def test_slice_by_share_with_unbalanced_results
+   assert_equal([[1,2,3],[4,5,6],[7,8]], A.slice_by_share(3))
+ end
+
+ def test_slice_by_share_with_very_unbalanced_results
+   assert_equal([[1,2],[3,4],[5,6],[7,8],[],[],[]], A.slice_by_share(7))
+ end
+
+ ### ...atypical
+
+ def test_slice_by_share_with_zero_count
+   assert_raise ArgumentError do
+     A.slice_by_share(0)
+   end
+ end
+
+ def test_slice_by_share_with_negative_count
+   assert_raise ArgumentError do
+     A.slice_by_share(-1)
+   end
+ end
+
+ def test_slice_by_share_with_float_count
+   assert_raise ArgumentError do
+     A.slice_by_share(1.234)
+   end
+ end
+
+ def test_slice_by_share_with_non_numeric_count
+   assert_raise ArgumentError do
+     A.slice_by_share("")
+   end
+ end
+
+end

data.tar.gz.sig

@@ -0,0 +1 @@
+Su{"�4��b�ۈ�Z��K�[_x�,� �l�������8r�G�ѵ?=V�q�Ńu4O�[�0�g������ͨ�f��P�+S���k��y�@܀�җ��=�=�e�yZ9sN��(h2/�D��{�����

metadata

@@ -0,0 +1,81 @@
+--- !ruby/object:Gem::Specification
+name: sixarm_ruby_array_slice
+version: !ruby/object:Gem::Version
+  version: 2.1.2
+  prerelease: 
+platform: ruby
+authors:
+- SixArm
+autorequire: 
+bindir: bin
+cert_chain:
+- !binary |-
+  LS0tLS1CRUdJTiBDRVJUSUZJQ0FURS0tLS0tCk1JSURCRENDQW0yZ0F3SUJB
+  Z0lKQUtQd0VFVFU1YkhvTUEwR0NTcUdTSWIzRFFFQkJRVUFNR0F4Q3pBSkJn
+  TlYKQkFZVEFsVlRNUk13RVFZRFZRUUlFd3BEWVd4cFptOXlibWxoTVJZd0ZB
+  WURWUVFIRXcxVFlXNGdSbkpoYm1OcApjMk52TVE4d0RRWURWUVFLRXdaVGFY
+  aEJjbTB4RXpBUkJnTlZCQU1UQ25OcGVHRnliUzVqYjIwd0hoY05NVEF4Ck1q
+  RXpNak15TnpFeldoY05NVE13T1RBNE1qTXlOekV6V2pCZ01Rc3dDUVlEVlFR
+  R0V3SlZVekVUTUJFR0ExVUUKQ0JNS1EyRnNhV1p2Y201cFlURVdNQlFHQTFV
+  RUJ4TU5VMkZ1SUVaeVlXNWphWE5qYnpFUE1BMEdBMVVFQ2hNRwpVMmw0UVhK
+  dE1STXdFUVlEVlFRREV3cHphWGhoY20wdVkyOXRNSUdmTUEwR0NTcUdTSWIz
+  RFFFQkFRVUFBNEdOCkFEQ0JpUUtCZ1FDOTRtRDlKRHdCc3Vuc09JMFZSM0NY
+  WGJPV2c5Y1dhV2Npd0Z5Sk5GaU03QTlJOEtQTGZYVXcKUUM0Y3pVZTVadUc0
+  V0h2aW5yV2hrckNLKzFkV0Jxb0VDbHhkRi9Gb0tPNWErdG9uR0Nqam1meTgx
+  Sm1Gamp5eAplVHNqc0h5dncrUWlrOWtwZjlhajYrcG5rTnJWc3dnTkhWZWEy
+  bzl5YWJiRWlTNlZTZUpXb1FJREFRQUJvNEhGCk1JSENNQjBHQTFVZERnUVdC
+  QlF6UEp0cW1TZ2M1M2VETjdhU3pEUXdyOVRBTERDQmtnWURWUjBqQklHS01J
+  R0gKZ0JRelBKdHFtU2djNTNlRE43YVN6RFF3cjlUQUxLRmtwR0l3WURFTE1B
+  a0dBMVVFQmhNQ1ZWTXhFekFSQmdOVgpCQWdUQ2tOaGJHbG1iM0p1YVdFeEZq
+  QVVCZ05WQkFjVERWTmhiaUJHY21GdVkybHpZMjh4RHpBTkJnTlZCQW9UCkJs
+  TnBlRUZ5YlRFVE1CRUdBMVVFQXhNS2MybDRZWEp0TG1OdmJZSUpBS1B3RUVU
+  VTViSG9NQXdHQTFVZEV3UUYKTUFNQkFmOHdEUVlKS29aSWh2Y05BUUVGQlFB
+  RGdZRUFvb0VleFAvb1BhbTFUUDcxU3l1aHhNYit1VHJaYlNRZQpqVkIrRXhS
+  d1dhZEd3YU5QVUE1NmQzOXF3YXZ3UCtpdSszSnBlb25OTVZ2YldYRjVuYUNY
+  L2RORkllUkVIekVSClpEUlFZTXFydTlURU1uYTZIRDl6cGNzdEY3dndUaEdv
+  dmxPUSszWTZwbFE0bk16aXBYY1o5VEhxczY1UElMMHEKZWFid3BDYkFvcG89
+  Ci0tLS0tRU5EIENFUlRJRklDQVRFLS0tLS0K
+date: 2012-02-03 00:00:00.000000000 Z
+dependencies: []
+description: 
+email: sixarm@sixarm.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- .gemtest
+- CHANGELOG.txt
+- INSTALL.txt
+- LICENSE.txt
+- Rakefile
+- README.rdoc
+- VERSION
+- lib/sixarm_ruby_array_slice.rb
+- test/sixarm_ruby_array_slice_test.rb
+homepage: http://sixarm.com/
+licenses: []
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 1.8.15
+signing_key: 
+specification_version: 3
+summary: SixArm.com » Ruby » Array slice methods
+test_files:
+- test/sixarm_ruby_array_slice_test.rb
+has_rdoc: true

metadata.gz.sig

@@ -0,0 +1 @@
+q�+JV���u���(xCj�k�����؄h