top_n 1.0.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: a5fc5435e211281c5d59fa26d155260a0359a216
+  data.tar.gz: f3cd1bf16b9c9c11ad87793a7c0741e1fe7f314a
+SHA512:
+  metadata.gz: 471670b61a3b91ff867fab94bcd414a9f766fb7367579122ea57d5f4d58e7b964e4551d77bb4ce35a4b2523df7282dce8a845791c0c8c7677ff4ec46c82b4071
+  data.tar.gz: 24330b140e01c80493d4434720672bef428825bbb8a6133ab234443c77bf498583f4c91360e2a33524da9d4e02a20814ec450a33ed14498a3dbe1c6b435eb08b

data/.travis.yml

@@ -0,0 +1,12 @@
+rvm:
+  - 2.0.0
+  - 1.9.3
+  - rbx
+  - rbx-2
+  - jruby-19mode
+
+before_script:
+
+notifications:
+  email:
+    - explorer@flame.org

data/Gemfile

@@ -0,0 +1,21 @@
+source "http://rubygems.org"
+# Add dependencies required to use your gem here.
+# Example:
+#   gem "activesupport", ">= 2.3.5"
+
+# Add dependencies to develop your gem here.
+# Include everything needed to run rake, tests, features, etc.
+group :development do
+  gem "minitest", ">= 0"
+  gem "yard", "~> 0.7"
+  gem "rdoc", "~> 3.12"
+  gem "bundler", "~> 1.0"
+  gem "jeweler", "~> 1.8.7"
+  gem "guard"
+  gem 'guard-minitest'
+
+  platforms :rbx do
+#    gem 'racc'
+    gem 'rubysl'
+  end
+end

data/Guardfile

@@ -0,0 +1,28 @@
+# A sample Guardfile
+# More info at https://github.com/guard/guard#readme
+
+guard :minitest do
+  # with Minitest::Unit
+  watch(%r{^test/(.*)\/?test_(.*)\.rb})
+  watch(%r{^lib/(.*/)?([^/]+)\.rb})     { |m| "test/#{m[1]}test_#{m[2]}.rb" }
+  watch(%r{^test/test_helper\.rb})      { 'test' }
+
+  # with Minitest::Spec
+  # watch(%r{^spec/(.*)_spec\.rb})
+  # watch(%r{^lib/(.+)\.rb})         { |m| "spec/#{m[1]}_spec.rb" }
+  # watch(%r{^spec/spec_helper\.rb}) { 'spec' }
+
+  # Rails 4
+  # watch(%r{^app/(.+)\.rb})                               { |m| "test/#{m[1]}_test.rb" }
+  # watch(%r{^app/controllers/application_controller\.rb}) { 'test/controllers' }
+  # watch(%r{^app/controllers/(.+)_controller\.rb})        { |m| "test/integration/#{m[1]}_test.rb" }
+  # watch(%r{^app/views/(.+)_mailer/.+})                   { |m| "test/mailers/#{m[1]}_mailer_test.rb" }
+  # watch(%r{^lib/(.+)\.rb})                               { |m| "test/lib/#{m[1]}_test.rb" }
+  # watch(%r{^test/.+_test\.rb})
+  # watch(%r{^test/test_helper\.rb}) { 'test' }
+
+  # Rails < 4
+  # watch(%r{^app/controllers/(.*)\.rb}) { |m| "test/functional/#{m[1]}_test.rb" }
+  # watch(%r{^app/helpers/(.*)\.rb})     { |m| "test/helpers/#{m[1]}_test.rb" }
+  # watch(%r{^app/models/(.*)\.rb})      { |m| "test/unit/#{m[1]}_test.rb" }
+end

data/LICENSE.txt

@@ -0,0 +1,20 @@
+Copyright (c) 2013 Michael Graff
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+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.

data/README.rdoc

@@ -0,0 +1,30 @@
+= top_n
+
+{<img src="https://travis-ci.org/skandragon/top_n.png?branch=master" alt="Build Status" />}[https://travis-ci.org/skandragon/top_n]
+
+This gem allows tracking of the top N (or bottom N) keys added to a list.
+Each key can have an optional value, which is then added to a list of values for that key.
+
+Key types must respond to the usual comparison operators: <, <=, >, >=, and <=>.  Values may be any object type, and need not be unique.  Values are not examined in any way, simply added to an internal list.
+
+If a <key, value> pair is added twice, it will store the value twice for that key, and return it twice in the list for that key, when that key is retrieved.
+
+Once the top N keys are added, adding smaller keys will be ignored.  Adding a larger key will drop the then-smallest value.  Adding another value at an existing key will simply result in
+
+For example, track the top 1,000 EverQuest 2 characters with the highest strenth, the most quests completed, or items crafted, out of the roughly 2.4 million characters which currently exist.
+
+== Contributing to this project
+
+* Check out the latest master to make sure the feature hasn't been implemented or the bug hasn't been fixed yet.
+* Check out the issue tracker to make sure someone already hasn't requested it and/or contributed it.
+* Fork the project.
+* Start a feature/bugfix branch.
+* Commit and push until you are happy with your contribution.
+* Make sure to add tests for it. This is important so I don't break it in a future version unintentionally.
+* Please try not to mess with the Rakefile, version, or history. If you want to have your own version, or is otherwise necessary, that is fine, but please isolate to its own commit so I can cherry-pick around it.
+
+== Copyright
+
+Copyright (c) 2013 Michael Graff. See LICENSE.txt for
+further details.
+

data/Rakefile

@@ -0,0 +1,38 @@
+# encoding: utf-8
+
+require 'rubygems'
+require 'bundler'
+begin
+  Bundler.setup(:default, :development)
+rescue Bundler::BundlerError => e
+  $stderr.puts e.message
+  $stderr.puts "Run `bundle install` to install missing gems"
+  exit e.status_code
+end
+require 'rake'
+
+require 'jeweler'
+Jeweler::Tasks.new do |gem|
+  # gem is a Gem::Specification... see http://docs.rubygems.org/read/chapter/20 for more options
+  gem.name = "top_n"
+  gem.homepage = "http://github.com/skandragon/top_n"
+  gem.license = "MIT"
+  gem.summary = %Q{Track the top (or bottom) N keys added to a list}
+  gem.description = %Q{Track the top (or bottom) N keys added to a list, and discard the remainder.}
+  gem.email = "explorer@flame.org"
+  gem.authors = ["Michael Graff"]
+  # dependencies defined in Gemfile
+end
+Jeweler::RubygemsDotOrgTasks.new
+
+require 'rake/testtask'
+Rake::TestTask.new(:test) do |test|
+  test.libs << 'lib' << 'test'
+  test.pattern = 'test/**/test_*.rb'
+  test.verbose = true
+end
+
+task :default => :test
+
+require 'yard'
+YARD::Rake::YardocTask.new

data/VERSION

@@ -0,0 +1 @@
+1.0.0

data/lib/top_n.rb

@@ -0,0 +1,178 @@
+##
+# This class tracks the top (or bottom) N values for a set of keys.
+#
+# As keys and values are added, only the largest (or smallest) keys will
+# be recorded.  As larger (or smaller) keys are added, unneeded items are
+# removed.
+#
+# Keys may be any object that is comparable with < and >.  Values may be
+# any object, and are not processed beyond appending them to an internal
+# list.
+#
+# @note
+#   Note that while the number of keys is restricted, the values are not.
+#   This can cause memory issues if many values are added to the same key.
+#   If this is the type of data you are tracking, you may need a different
+#   solution.
+class TopN
+  # The maxinum number of keys which will be tracked.
+  # @return [Fixnum] the configured maximum number of keys to be tracked.
+  attr_reader :maxsize
+
+  # The configured direction.
+  # @return [Symbol] either :top or :bottom.
+  attr_reader :direction
+
+  # The current number of keys we are tracking.
+  # @return [FixNum] the count, which will be 0 up to :maxsize.
+  attr_reader :size
+
+  # The current value of the minimum (:top) or maximum (:bottom) key.
+  # @return [Object] the threshold key.
+  attr_reader :threshold_key
+
+  # The currently tracked data as one blob.  This is tied to the
+  # current implementation, so its use is not recommended.
+  # @return [Hash] the internal data structure containing the keys and
+  #  values.  The keys to the returned Hash are the tracked keys, and
+  #  the values at those keys is the list of values.
+  attr_reader :data
+
+  ##
+  # Create a new TopN object.  Options available:
+  #
+  # @param [Hash] options the options used to configure the TopN object.
+  #
+  # @option options [Fixnum] :maxsize The maximum number of keys to track.
+  #  Must be a positive Fixnum.  Defaults to 100.
+  #
+  # @option options [Symbol] :direction Configure the direction.
+  #  If this is :top, the largest keys will be maintained.  If :bottom,
+  #  the smallest keys will be maintained.  Any other value throws an
+  #  exception.
+  #  Defaults to :top.
+  #
+  # @raise [ArgumentError] if an invalid value is detected for any option.
+  #
+  # @example Create with default options
+  #   topn = TopN.new
+  #
+  # @example Create with a maximum size of 10, and track smaller values
+  #   topn = TopN.new(maxsize: 10, direction: :bottom)
+  #
+  def initialize(options = {})
+    options = {
+      maxsize: 100,
+      direction: :top,
+    }.merge(options)
+
+    @maxsize = options[:maxsize]
+    @direction = options[:direction]
+    @data = {}
+    @size = 0
+    @threshold_key = nil
+
+    unless [:top, :bottom].include?(@direction)
+      raise ArgumentError.new("direction must be :top or :bottom")
+    end
+
+    unless @maxsize.is_a?Fixnum
+      raise ArgumentError.new("maxsize must be a Fixnum")
+    end
+
+    if @maxsize <= 0
+      raise ArgumentError.new("maxsize must be >= 1")
+    end
+  end
+
+  ##
+  # Add a key, value pair.
+  #
+  # @param [Object] key the key, which must be compariable with < and >.
+  # @param [Object] value the value, which is added to the key's list of
+  #  values.  Adding the same value to a key multiple times results in
+  #  duplicate values being recorded.
+  #
+  # If the key already exists, the value will be appended to the existing list
+  # of values at that key.
+  #
+  # If an existing (key, value) is permitted, and will result in the list of
+  # values at that key having the same value multiple times.
+  #
+  # @return [Array] if the value was added to the key's list.
+  #
+  # @return [nil] if the value was not added because the key is too small or
+  # large to be tracked.
+  def add(key, value)
+    if @direction == :top
+      add_top(key, value)
+    else
+      add_bottom(key, value)
+    end
+  end
+
+  ##
+  # Find and return the list of values for a key.
+  #
+  # @return [Array<Object>] the list of values for 'key'.
+  #
+  # @return [nil] if the key does not exist.
+  def find(key)
+    @data[key]
+  end
+
+  ##
+  # Return the list of currently tracked keys.
+  #
+  # @return [Array<Object>] the list of values for this key.
+  #  Order is not guaranteed to match the oder which they were added.
+  def keys
+    @data.keys
+  end
+
+  private
+
+  ##
+  # Add a (key, value) when the direction is :top.
+  def add_top(key, value)
+    @threshold_key ||= key
+
+    if @size >= @maxsize
+      return nil if key < @threshold_key
+      @data.delete(@threshold_key)
+    end
+
+    unless @data.has_key?key
+      @data[key] = []
+      @size += 1 if @size < @maxsize
+    end
+
+    @data[key] << value
+
+    @threshold_key = key if key < @threshold_key
+
+    @data[key]
+  end
+
+  ##
+  # Add a (key, value) when the direction is :bottom.
+  def add_bottom(key, value)
+    @threshold_key ||= key
+
+    if @size >= @maxsize
+      return nil if key > @threshold_key
+      @data.delete(@threshold_key)
+    end
+
+    unless @data.has_key?key
+      @data[key] = []
+      @size += 1 if @size < @maxsize
+    end
+
+    @data[key] << value
+
+    @threshold_key = key if key > @threshold_key
+
+    @data[key]
+  end
+end

data/test/helper.rb

@@ -0,0 +1,19 @@
+require 'rubygems'
+require 'bundler'
+begin
+  Bundler.setup(:default, :development)
+rescue Bundler::BundlerError => e
+  $stderr.puts e.message
+  $stderr.puts "Run `bundle install` to install missing gems"
+  exit e.status_code
+end
+require 'minitest/autorun'
+
+$LOAD_PATH.unshift(File.dirname(__FILE__))
+$LOAD_PATH.unshift(File.join(File.dirname(__FILE__), '..', 'lib'))
+require 'top_n'
+
+class MiniTest::Unit::TestCase
+end
+
+MiniTest.autorun

data/test/test_adding_bottom.rb

@@ -0,0 +1,88 @@
+require 'helper'
+
+class TestAddingBottom < Minitest::Test
+  def test_threshold_key_is_nil_on_create
+    topn = TopN.new(direction: :bottom)
+    assert_nil topn.threshold_key
+  end
+
+  def test_adding_updates_threshold_key
+    topn = TopN.new(direction: :bottom)
+    assert topn.add(5, 5), "add(5, 5) failed"
+    assert_equal 5, topn.threshold_key
+  end
+
+  def test_adding_increments_size
+    topn = TopN.new(direction: :bottom)
+    assert topn.add(1, 1), "add(1, 1) failed"
+    assert topn.size == 1, "size == 1 failed"
+  end
+
+  def test_adding_without_exceeding_adds
+    topn = TopN.new(direction: :bottom, maxsize: 10)
+    assert topn.add(5, 5), "add(5, 5) failed"
+    assert topn.find(5) == [5], "find(5) failed"
+    assert_equal 5, topn.threshold_key
+  end
+
+  def test_adding_sets_threshold_key
+    topn = TopN.new(direction: :bottom, maxsize: 10)
+    assert topn.add(5, 5), "add(5, 5) failed"
+    assert topn.find(5) == [5], "find(5) failed"
+    assert_equal 5, topn.threshold_key
+  end
+
+  def test_adding_without_exceeding
+    topn = TopN.new(direction: :bottom, maxsize: 10)
+    assert topn.add(5, 5), "add(5, 5) failed"
+    assert topn.add(10, 10), "add(10, 10) failed"
+    assert topn.find(5) == [5], "find(5) failed"
+    assert topn.find(10) == [10], "find(5) failed"
+    assert_equal 10, topn.threshold_key
+  end
+
+  def test_adding_larger_without_exceeding_sets_threshold_key
+    topn = TopN.new(direction: :bottom, maxsize: 10)
+    assert topn.add(5, 5), "add(5, 5) failed"
+    assert_equal 5, topn.threshold_key
+    assert topn.add(10, 10), "add(10, 10) failed"
+    assert_equal 10, topn.threshold_key
+  end
+
+  def test_adding_smaller_without_exceeding_sets_threshold_key
+    topn = TopN.new(direction: :bottom, maxsize: 10)
+    assert topn.add(10, 10), "add(10, 10) failed"
+    assert_equal 10, topn.threshold_key
+    assert topn.add(5, 5), "add(5, 5) failed"
+    assert_equal 10, topn.threshold_key
+  end
+
+  def test_adding_two_values_to_the_same_key
+    topn = TopN.new(direction: :bottom, maxsize: 10)
+    assert topn.add(1, 1), "add(1, 1) failed"
+    assert topn.add(1, 2), "add(1, 2) failed"
+    assert_equal [1, 2], topn.find(1).sort
+  end
+
+  def test_adding_smaller_key_when_limit_will_exceed
+    topn = TopN.new(direction: :bottom, maxsize: 2)
+    assert topn.add(3, 3), "add(3, 3) failed"
+    assert topn.add(2, 2), "add(2, 2) failed"
+    assert topn.add(1, 1), "add(1, 1) failed"
+    assert_equal 2, topn.size
+    assert_equal [1], topn.find(1)
+    assert_equal [2], topn.find(2)
+    assert_nil topn.find(3)
+  end
+
+  def test_adding_larger_key_when_limit_will_exceed
+    topn = TopN.new(direction: :bottom, maxsize: 2)
+    assert topn.add(1, 1), "add(1, 1) failed"
+    assert topn.add(2, 2), "add(2, 2) failed"
+    assert_nil topn.add(3, 3)
+    assert_equal 2, topn.size
+    assert_equal [1], topn.find(1)
+    assert_equal [2], topn.find(2)
+    assert_nil topn.find(3)
+  end
+end

data/test/test_adding_top.rb

@@ -0,0 +1,88 @@
+require 'helper'
+
+class TestAddingTop < Minitest::Test
+  def test_threshold_key_is_nil_on_create
+    topn = TopN.new
+    assert_nil topn.threshold_key
+  end
+
+  def test_adding_updates_threshold_key
+    topn = TopN.new
+    assert topn.add(5, 5), "add(5, 5) failed"
+    assert_equal 5, topn.threshold_key
+  end
+
+  def test_adding_increments_size
+    topn = TopN.new
+    assert topn.add(1, 1), "add(1, 1) failed"
+    assert topn.size == 1, "size == 1 failed"
+  end
+
+  def test_adding_without_exceeding_adds
+    topn = TopN.new(maxsize: 10)
+    assert topn.add(5, 5), "add(5, 5) failed"
+    assert topn.find(5) == [5], "find(5) failed"
+    assert_equal 5, topn.threshold_key
+  end
+
+  def test_adding_sets_threshold_key
+    topn = TopN.new(maxsize: 10)
+    assert topn.add(5, 5), "add(5, 5) failed"
+    assert topn.find(5) == [5], "find(5) failed"
+    assert_equal 5, topn.threshold_key
+  end
+
+  def test_adding_without_exceeding
+    topn = TopN.new(maxsize: 10)
+    assert topn.add(5, 5), "add(5, 5) failed"
+    assert topn.add(10, 10), "add(10, 10) failed"
+    assert topn.find(5) == [5], "find(5) failed"
+    assert topn.find(10) == [10], "find(5) failed"
+    assert_equal 5, topn.threshold_key
+  end
+
+  def test_adding_larger_without_exceeding_sets_threshold_key
+    topn = TopN.new(maxsize: 10)
+    assert topn.add(5, 5), "add(5, 5) failed"
+    assert_equal 5, topn.threshold_key
+    assert topn.add(10, 10), "add(10, 10) failed"
+    assert_equal 5, topn.threshold_key
+  end
+
+  def test_adding_smaller_without_exceeding_sets_threshold_key
+    topn = TopN.new(maxsize: 10)
+    assert topn.add(10, 10), "add(10, 10) failed"
+    assert_equal 10, topn.threshold_key
+    assert topn.add(5, 5), "add(5, 5) failed"
+    assert_equal 5, topn.threshold_key
+  end
+
+  def test_adding_two_values_to_the_same_key
+    topn = TopN.new(maxsize: 10)
+    assert topn.add(1, 1), "add(1, 1) failed"
+    assert topn.add(1, 2), "add(1, 2) failed"
+    assert_equal [1, 2], topn.find(1).sort
+  end
+
+  def test_adding_larger_key_when_limit_will_exceed
+    topn = TopN.new(maxsize: 2)
+    assert topn.add(1, 1), "add(1, 1) failed"
+    assert topn.add(2, 2), "add(1, 1) failed"
+    assert topn.add(3, 3), "add(1, 1) failed"
+    assert_equal 2, topn.size
+    assert_nil topn.find(1)
+    assert_equal [2], topn.find(2)
+    assert_equal [3], topn.find(3)
+  end
+
+  def test_adding_smaller_key_when_limit_will_exceed
+    topn = TopN.new(maxsize: 2)
+    assert topn.add(3, 3), "add(1, 1) failed"
+    assert topn.add(2, 2), "add(1, 1) failed"
+    assert_nil topn.add(1, 1)
+    assert_equal 2, topn.size
+    assert_nil topn.find(1)
+    assert_equal [2], topn.find(2)
+    assert_equal [3], topn.find(3)
+  end
+end

data/test/test_creation.rb

@@ -0,0 +1,47 @@
+require 'helper'
+
+class TestTopN < Minitest::Test
+  def test_creation_without_arguments
+    topn = TopN.new
+    assert topn
+  end
+
+  def test_creation_without_arguments_sets_maxsize_to_some_positive_default
+    topn = TopN.new
+    assert topn.maxsize > 0
+  end
+
+  def test_creation_with_maxsize
+    topn = TopN.new(maxsize: 100)
+    assert topn.maxsize == 100
+  end
+
+  def test_creation_with_direction
+    topn = TopN.new(direction: :bottom)
+    assert topn.direction == :bottom
+  end
+
+  def test_creation_raises_assertion_with_bad_direction
+    assert_raises(ArgumentError) {
+      TopN.new(direction: :flarg)
+    }
+  end
+
+  def test_creation_raises_assertion_with_zero_maxsize
+    assert_raises(ArgumentError) {
+      TopN.new(maxsize: 0)
+    }
+  end
+
+  def test_creation_raises_assertion_with_negative_maxsize
+    assert_raises(ArgumentError) {
+      TopN.new(maxsize: -1)
+    }
+  end
+
+  def test_creation_raises_assertion_with_non_fixnum_maxsize
+    assert_raises(ArgumentError) {
+      TopN.new(maxsize: 'foo')
+    }
+  end
+end

data/test/test_data.rb

@@ -0,0 +1,24 @@
+require 'helper'
+
+class TestData < Minitest::Test
+  def test_data_is_empty_on_create
+    topn = TopN.new(maxsize: 2)
+    assert_equal({}, topn.data)
+  end
+
+  def test_data_has_keys
+    topn = TopN.new(maxsize: 2)
+    assert topn.add(1, 1), "add(1, 1) failed"
+    assert topn.add(2, 2), "add(1, 1) failed"
+    assert topn.add(3, 3), "add(1, 1) failed"
+    assert_equal [2, 3], topn.data.keys.sort
+  end
+
+  def test_keys
+    topn = TopN.new(maxsize: 2)
+    assert topn.add(1, 1), "add(1, 1) failed"
+    assert topn.add(2, 2), "add(1, 1) failed"
+    assert topn.add(3, 3), "add(1, 1) failed"
+    assert_equal [2, 3], topn.keys.sort
+  end
+end

data/top_n.gemspec

@@ -0,0 +1,74 @@
+# Generated by jeweler
+# DO NOT EDIT THIS FILE DIRECTLY
+# Instead, edit Jeweler::Tasks in Rakefile, and run 'rake gemspec'
+# -*- encoding: utf-8 -*-
+
+Gem::Specification.new do |s|
+  s.name = "top_n"
+  s.version = "1.0.0"
+
+  s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
+  s.authors = ["Michael Graff"]
+  s.date = "2013-12-15"
+  s.description = "Track the top (or bottom) N keys added to a list, and discard the remainder."
+  s.email = "explorer@flame.org"
+  s.extra_rdoc_files = [
+    "LICENSE.txt",
+    "README.rdoc"
+  ]
+  s.files = [
+    ".travis.yml",
+    "Gemfile",
+    "Guardfile",
+    "LICENSE.txt",
+    "README.rdoc",
+    "Rakefile",
+    "VERSION",
+    "lib/top_n.rb",
+    "test/helper.rb",
+    "test/test_adding_bottom.rb",
+    "test/test_adding_top.rb",
+    "test/test_creation.rb",
+    "test/test_data.rb",
+    "top_n.gemspec"
+  ]
+  s.homepage = "http://github.com/skandragon/top_n"
+  s.licenses = ["MIT"]
+  s.require_paths = ["lib"]
+  s.rubygems_version = "2.0.14"
+  s.summary = "Track the top (or bottom) N keys added to a list"
+
+  if s.respond_to? :specification_version then
+    s.specification_version = 4
+
+    if Gem::Version.new(Gem::VERSION) >= Gem::Version.new('1.2.0') then
+      s.add_development_dependency(%q<minitest>, [">= 0"])
+      s.add_development_dependency(%q<yard>, ["~> 0.7"])
+      s.add_development_dependency(%q<rdoc>, ["~> 3.12"])
+      s.add_development_dependency(%q<bundler>, ["~> 1.0"])
+      s.add_development_dependency(%q<jeweler>, ["~> 1.8.7"])
+      s.add_development_dependency(%q<guard>, [">= 0"])
+      s.add_development_dependency(%q<guard-minitest>, [">= 0"])
+      s.add_development_dependency(%q<rubysl>, [">= 0"])
+    else
+      s.add_dependency(%q<minitest>, [">= 0"])
+      s.add_dependency(%q<yard>, ["~> 0.7"])
+      s.add_dependency(%q<rdoc>, ["~> 3.12"])
+      s.add_dependency(%q<bundler>, ["~> 1.0"])
+      s.add_dependency(%q<jeweler>, ["~> 1.8.7"])
+      s.add_dependency(%q<guard>, [">= 0"])
+      s.add_dependency(%q<guard-minitest>, [">= 0"])
+      s.add_dependency(%q<rubysl>, [">= 0"])
+    end
+  else
+    s.add_dependency(%q<minitest>, [">= 0"])
+    s.add_dependency(%q<yard>, ["~> 0.7"])
+    s.add_dependency(%q<rdoc>, ["~> 3.12"])
+    s.add_dependency(%q<bundler>, ["~> 1.0"])
+    s.add_dependency(%q<jeweler>, ["~> 1.8.7"])
+    s.add_dependency(%q<guard>, [">= 0"])
+    s.add_dependency(%q<guard-minitest>, [">= 0"])
+    s.add_dependency(%q<rubysl>, [">= 0"])
+  end
+end
+

metadata

@@ -0,0 +1,171 @@
+--- !ruby/object:Gem::Specification
+name: top_n
+version: !ruby/object:Gem::Version
+  version: 1.0.0
+platform: ruby
+authors:
+- Michael Graff
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2013-12-15 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: minitest
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: yard
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '0.7'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '0.7'
+- !ruby/object:Gem::Dependency
+  name: rdoc
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '3.12'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '3.12'
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.0'
+- !ruby/object:Gem::Dependency
+  name: jeweler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 1.8.7
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 1.8.7
+- !ruby/object:Gem::Dependency
+  name: guard
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: guard-minitest
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rubysl
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+description: Track the top (or bottom) N keys added to a list, and discard the remainder.
+email: explorer@flame.org
+executables: []
+extensions: []
+extra_rdoc_files:
+- LICENSE.txt
+- README.rdoc
+files:
+- .travis.yml
+- Gemfile
+- Guardfile
+- LICENSE.txt
+- README.rdoc
+- Rakefile
+- VERSION
+- lib/top_n.rb
+- test/helper.rb
+- test/test_adding_bottom.rb
+- test/test_adding_top.rb
+- test/test_creation.rb
+- test/test_data.rb
+- top_n.gemspec
+homepage: http://github.com/skandragon/top_n
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.0.14
+signing_key: 
+specification_version: 4
+summary: Track the top (or bottom) N keys added to a list
+test_files: []