gorillib 0.1.9 → 0.1.11

data/VERSION

@@ -1 +1 @@
-0.1.9
+0.1.11

data/gorillib.gemspec

@@ -5,11 +5,11 @@
 
 Gem::Specification.new do |s|
   s.name = "gorillib"
-  s.version = "0.1.9"
+  s.version = "0.1.11"
 
   s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
   s.authors = ["Infochimps"]
-  s.date = "2012-02-28"
+  s.date = "2012-06-22"
   s.description = "Gorillib: infochimps lightweight subset of ruby convenience methods"
   s.email = "coders@infochimps.org"
   s.extra_rdoc_files = [
@@ -27,10 +27,14 @@ Gem::Specification.new do |s|
     "VERSION",
     "gorillib.gemspec",
     "lib/gorillib.rb",
+    "lib/gorillib/array/average.rb",
     "lib/gorillib/array/compact_blank.rb",
     "lib/gorillib/array/deep_compact.rb",
     "lib/gorillib/array/extract_options.rb",
     "lib/gorillib/array/random.rb",
+    "lib/gorillib/array/sorted_median.rb",
+    "lib/gorillib/array/sorted_percentile.rb",
+    "lib/gorillib/array/sorted_sample.rb",
     "lib/gorillib/base.rb",
     "lib/gorillib/datetime/flat.rb",
     "lib/gorillib/datetime/parse.rb",
@@ -87,8 +91,12 @@ Gem::Specification.new do |s|
     "lib/gorillib/struct/hashlike_iteration.rb",
     "notes/fancy_hashes_and_receivers.textile",
     "notes/hash_rdocs.textile",
+    "spec/array/average_spec.rb",
     "spec/array/compact_blank_spec.rb",
     "spec/array/extract_options_spec.rb",
+    "spec/array/sorted_median_spec.rb",
+    "spec/array/sorted_percentile_spec.rb",
+    "spec/array/sorted_sample_spec.rb",
     "spec/datetime/flat_spec.rb",
     "spec/datetime/parse_spec.rb",
     "spec/dsl_object_spec.rb",
@@ -142,7 +150,7 @@ Gem::Specification.new do |s|
   s.require_paths = ["lib"]
   s.rubygems_version = "1.8.15"
   s.summary = "include only what you need. No dependencies, no creep"
-  s.test_files = ["spec/array/compact_blank_spec.rb", "spec/array/extract_options_spec.rb", "spec/datetime/flat_spec.rb", "spec/datetime/parse_spec.rb", "spec/dsl_object_spec.rb", "spec/enumerable/sum_spec.rb", "spec/hash/compact_spec.rb", "spec/hash/deep_compact_spec.rb", "spec/hash/deep_merge_spec.rb", "spec/hash/indifferent_access_spec.rb", "spec/hash/keys_spec.rb", "spec/hash/reverse_merge_spec.rb", "spec/hash/slice_spec.rb", "spec/hash/zip_spec.rb", "spec/hashlike/behave_same_as_hash_spec.rb", "spec/hashlike/deep_hash_spec.rb", "spec/hashlike/hashlike_behavior_spec.rb", "spec/hashlike/hashlike_via_accessors_spec.rb", "spec/hashlike_spec.rb", "spec/logger/log_spec.rb", "spec/metaprogramming/aliasing_spec.rb", "spec/metaprogramming/cattr_accessor_spec.rb", "spec/metaprogramming/class_attribute_spec.rb", "spec/metaprogramming/delegation_spec.rb", "spec/metaprogramming/mattr_accessor_spec.rb", "spec/metaprogramming/singleton_class_spec.rb", "spec/numeric/clamp_spec.rb", "spec/object/blank_spec.rb", "spec/object/try_dup_spec.rb", "spec/object/try_spec.rb", "spec/receiver/acts_as_hash_spec.rb", "spec/receiver_spec.rb", "spec/spec_helper.rb", "spec/string/constantize_spec.rb", "spec/string/human_spec.rb", "spec/string/inflections_spec.rb", "spec/string/inflector_test_cases.rb", "spec/string/truncate_spec.rb", "spec/struct/acts_as_hash_fuzz_spec.rb", "spec/struct/acts_as_hash_spec.rb", "spec/support/hashlike_fuzzing_helper.rb", "spec/support/hashlike_helper.rb", "spec/support/hashlike_struct_helper.rb", "spec/support/hashlike_via_delegation.rb", "spec/support/kcode_test_helper.rb", "spec/support/matchers/be_array_eql.rb", "spec/support/matchers/be_hash_eql.rb", "spec/support/matchers/enumerate_method.rb", "spec/support/matchers/evaluate_to_true.rb"]
+  s.test_files = ["spec/array/average_spec.rb", "spec/array/compact_blank_spec.rb", "spec/array/extract_options_spec.rb", "spec/array/sorted_median_spec.rb", "spec/array/sorted_percentile_spec.rb", "spec/array/sorted_sample_spec.rb", "spec/datetime/flat_spec.rb", "spec/datetime/parse_spec.rb", "spec/dsl_object_spec.rb", "spec/enumerable/sum_spec.rb", "spec/hash/compact_spec.rb", "spec/hash/deep_compact_spec.rb", "spec/hash/deep_merge_spec.rb", "spec/hash/indifferent_access_spec.rb", "spec/hash/keys_spec.rb", "spec/hash/reverse_merge_spec.rb", "spec/hash/slice_spec.rb", "spec/hash/zip_spec.rb", "spec/hashlike/behave_same_as_hash_spec.rb", "spec/hashlike/deep_hash_spec.rb", "spec/hashlike/hashlike_behavior_spec.rb", "spec/hashlike/hashlike_via_accessors_spec.rb", "spec/hashlike_spec.rb", "spec/logger/log_spec.rb", "spec/metaprogramming/aliasing_spec.rb", "spec/metaprogramming/cattr_accessor_spec.rb", "spec/metaprogramming/class_attribute_spec.rb", "spec/metaprogramming/delegation_spec.rb", "spec/metaprogramming/mattr_accessor_spec.rb", "spec/metaprogramming/singleton_class_spec.rb", "spec/numeric/clamp_spec.rb", "spec/object/blank_spec.rb", "spec/object/try_dup_spec.rb", "spec/object/try_spec.rb", "spec/receiver/acts_as_hash_spec.rb", "spec/receiver_spec.rb", "spec/spec_helper.rb", "spec/string/constantize_spec.rb", "spec/string/human_spec.rb", "spec/string/inflections_spec.rb", "spec/string/inflector_test_cases.rb", "spec/string/truncate_spec.rb", "spec/struct/acts_as_hash_fuzz_spec.rb", "spec/struct/acts_as_hash_spec.rb", "spec/support/hashlike_fuzzing_helper.rb", "spec/support/hashlike_helper.rb", "spec/support/hashlike_struct_helper.rb", "spec/support/hashlike_via_delegation.rb", "spec/support/kcode_test_helper.rb", "spec/support/matchers/be_array_eql.rb", "spec/support/matchers/be_hash_eql.rb", "spec/support/matchers/enumerate_method.rb", "spec/support/matchers/evaluate_to_true.rb"]
 
   if s.respond_to? :specification_version then
     s.specification_version = 3

data/lib/gorillib/array/average.rb

@@ -0,0 +1,13 @@
+class Array
+  #
+  # Return the average of my elements.
+  #
+  # precondition: Each element must be convertible to a float.
+  #
+  def average
+    return nil if empty?
+    raise ArgumentError, "Couldn't convert all elements to float!" unless
+      all?{|e| e.methods.index :to_f}
+    return map(&:to_f).inject(:+) / size
+  end
+end

data/lib/gorillib/array/sorted_median.rb

@@ -0,0 +1,11 @@
+class Array
+  #
+  # Returns the middle element of odd-sized arrays. For even arrays,
+  # it will return one of the two middle elements. Precisely which is
+  # undefined, except that it will consistently return one or the
+  # other.
+  #
+  def sorted_median
+    return self[(size - 1) * 0.5]
+  end
+end

data/lib/gorillib/array/sorted_percentile.rb

@@ -0,0 +1,11 @@
+class Array
+  #
+  # Returns the element at the position closest to the given
+  # percentile. For example, sorted_percentile 0.0 will return the
+  # first element and sorted_percentile 100.0 will return the last
+  # element.
+  #
+  def sorted_percentile percentile
+    return self[(size - 1) * percentile / 100.0]
+  end
+end

data/lib/gorillib/array/sorted_sample.rb

@@ -0,0 +1,12 @@
+class Array
+  #
+  # Returns the middle element of odd-sized arrays. For even arrays,
+  # it will return one of the two middle elements. Precisely which is
+  # undefined, except that it will consistently return one or the
+  # other.
+  #
+  def sorted_sample num
+    return [] if empty?
+    (1..num).map{|i| self[(size - 1) * i / (num)]}.uniq
+  end
+end

data/spec/array/average_spec.rb

@@ -0,0 +1,24 @@
+require File.expand_path('../spec_helper', File.dirname(__FILE__))
+require 'gorillib/array/average'
+
+describe Array do
+  describe '#average' do
+    context 'on non-float array element' do
+      it 'raises error' do
+        expect { [0.0, :b, 1.0].average }.should raise_error(ArgumentError)
+      end
+    end
+
+    context 'with empty' do
+      it 'returns nil' do
+        [].average.should be_nil
+      end
+    end
+
+    context 'given a numerical array' do
+      it 'returns the average of the elements' do
+        (1..10).to_a.average.should == 5.5
+      end
+    end
+  end
+end

data/spec/array/sorted_median_spec.rb

@@ -0,0 +1,18 @@
+require File.expand_path('../spec_helper', File.dirname(__FILE__))
+require 'gorillib/array/sorted_median'
+
+describe Array do
+  describe '#sorted_median' do
+    context 'with empty' do
+      it 'returns nil' do
+        [].sorted_median.should be_nil
+      end
+    end
+
+    context 'given any array' do
+      it 'returns the middle element of odd-sized arrays' do
+        ("a".."y").to_a.sorted_median.should == "m"
+      end
+    end
+  end
+end

data/spec/array/sorted_percentile_spec.rb

@@ -0,0 +1,24 @@
+require File.expand_path('../spec_helper', File.dirname(__FILE__))
+require 'gorillib/array/sorted_percentile'
+
+describe Array do
+  describe '#sorted_percentile' do
+    context 'with empty' do
+      it 'returns nil' do
+        [].sorted_percentile(0.0).should be_nil
+      end
+    end
+
+    context 'given any array' do
+      it 'returns the element closest to the given percentile' do
+        ("a".."y").to_a.sorted_percentile(  0.0).should == "a"
+        ("a".."y").to_a.sorted_percentile( 50.0).should == "m"
+        ("a".."y").to_a.sorted_percentile(100.0).should == "y"
+      end
+    end
+
+    # (Please do not define behavior for two elements equally close to
+    # a given percentile.)
+
+  end
+end

data/spec/array/sorted_sample_spec.rb

@@ -0,0 +1,28 @@
+require File.expand_path('../spec_helper', File.dirname(__FILE__))
+require 'gorillib/array/sorted_sample'
+
+describe Array do
+  describe '#sorted_median' do
+    context 'with empty' do
+      it 'returns an empty array' do
+        [].sorted_sample(1).should be_empty
+      end
+    end
+
+    context 'given an undersized array' do
+      it 'does not return the same element more than once' do
+        ("a".."z").to_a.sorted_sample(27).should == ("a".."z").to_a
+      end
+    end
+
+    context 'given any array' do
+      it ('returns a sample of the given size as close to evenly ' \
+          'distributed over the array as possible') do
+        sample = (1..100).to_a.sorted_sample(26)
+        deltas = sample[0..-2].zip(sample[1..-1]).map{|a,b| b-a}
+        deltas.max.should <= 4
+        deltas.min.should >= 3
+      end
+    end
+  end
+end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: gorillib
 version: !ruby/object:Gem::Version
-  version: 0.1.9
+  version: 0.1.11
   prerelease: 
 platform: ruby
 authors:
@@ -9,11 +9,11 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2012-02-28 00:00:00.000000000Z
+date: 2012-06-22 00:00:00.000000000Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: json
-  requirement: &2185903920 !ruby/object:Gem::Requirement
+  requirement: &2165912900 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -21,10 +21,10 @@ dependencies:
         version: '0'
   type: :runtime
   prerelease: false
-  version_requirements: *2185903920
+  version_requirements: *2165912900
 - !ruby/object:Gem::Dependency
   name: bundler
-  requirement: &2185903440 !ruby/object:Gem::Requirement
+  requirement: &2165912000 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ~>
@@ -32,10 +32,10 @@ dependencies:
         version: '1'
   type: :development
   prerelease: false
-  version_requirements: *2185903440
+  version_requirements: *2165912000
 - !ruby/object:Gem::Dependency
   name: jeweler
-  requirement: &2185902960 !ruby/object:Gem::Requirement
+  requirement: &2165911060 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ~>
@@ -43,10 +43,10 @@ dependencies:
         version: '1.6'
   type: :development
   prerelease: false
-  version_requirements: *2185902960
+  version_requirements: *2165911060
 - !ruby/object:Gem::Dependency
   name: rspec
-  requirement: &2185902460 !ruby/object:Gem::Requirement
+  requirement: &2165910200 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ~>
@@ -54,10 +54,10 @@ dependencies:
         version: '2.5'
   type: :development
   prerelease: false
-  version_requirements: *2185902460
+  version_requirements: *2165910200
 - !ruby/object:Gem::Dependency
   name: yard
-  requirement: &2185901980 !ruby/object:Gem::Requirement
+  requirement: &2165909260 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ~>
@@ -65,10 +65,10 @@ dependencies:
         version: '0.6'
   type: :development
   prerelease: false
-  version_requirements: *2185901980
+  version_requirements: *2165909260
 - !ruby/object:Gem::Dependency
   name: cucumber
-  requirement: &2185901500 !ruby/object:Gem::Requirement
+  requirement: &2165908340 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ~>
@@ -76,10 +76,10 @@ dependencies:
         version: '1'
   type: :development
   prerelease: false
-  version_requirements: *2185901500
+  version_requirements: *2165908340
 - !ruby/object:Gem::Dependency
   name: aruba
-  requirement: &2185901020 !ruby/object:Gem::Requirement
+  requirement: &2165907460 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ~>
@@ -87,7 +87,7 @@ dependencies:
         version: '0.4'
   type: :development
   prerelease: false
-  version_requirements: *2185901020
+  version_requirements: *2165907460
 description: ! 'Gorillib: infochimps lightweight subset of ruby convenience methods'
 email: coders@infochimps.org
 executables: []
@@ -106,10 +106,14 @@ files:
 - VERSION
 - gorillib.gemspec
 - lib/gorillib.rb
+- lib/gorillib/array/average.rb
 - lib/gorillib/array/compact_blank.rb
 - lib/gorillib/array/deep_compact.rb
 - lib/gorillib/array/extract_options.rb
 - lib/gorillib/array/random.rb
+- lib/gorillib/array/sorted_median.rb
+- lib/gorillib/array/sorted_percentile.rb
+- lib/gorillib/array/sorted_sample.rb
 - lib/gorillib/base.rb
 - lib/gorillib/datetime/flat.rb
 - lib/gorillib/datetime/parse.rb
@@ -166,8 +170,12 @@ files:
 - lib/gorillib/struct/hashlike_iteration.rb
 - notes/fancy_hashes_and_receivers.textile
 - notes/hash_rdocs.textile
+- spec/array/average_spec.rb
 - spec/array/compact_blank_spec.rb
 - spec/array/extract_options_spec.rb
+- spec/array/sorted_median_spec.rb
+- spec/array/sorted_percentile_spec.rb
+- spec/array/sorted_sample_spec.rb
 - spec/datetime/flat_spec.rb
 - spec/datetime/parse_spec.rb
 - spec/dsl_object_spec.rb
@@ -230,7 +238,7 @@ required_ruby_version: !ruby/object:Gem::Requirement
       version: '0'
       segments:
       - 0
-      hash: 387201475316777610
+      hash: 4215957582273212195
 required_rubygems_version: !ruby/object:Gem::Requirement
   none: false
   requirements:
@@ -244,8 +252,12 @@ signing_key:
 specification_version: 3
 summary: include only what you need. No dependencies, no creep
 test_files:
+- spec/array/average_spec.rb
 - spec/array/compact_blank_spec.rb
 - spec/array/extract_options_spec.rb
+- spec/array/sorted_median_spec.rb
+- spec/array/sorted_percentile_spec.rb
+- spec/array/sorted_sample_spec.rb
 - spec/datetime/flat_spec.rb
 - spec/datetime/parse_spec.rb
 - spec/dsl_object_spec.rb