leaderboard 2.0.5 → 2.0.6

data/.rspec

@@ -0,0 +1,2 @@
+--color
+--format nested

data/CHANGELOG.markdown

@@ -1,5 +1,9 @@
 # CHANGELOG
 
+## leaderboard 2.0.6 (2012-04-26)
+
+* Added accessor for +reverse+ option so that you can set reverse after creating a leaderboard to see results in either highest-to-lowest or lowest-to-highest order.
+
 ## leaderboard 2.0.5 (2012-03-14)
 
 * Added `rank_members(members_and_scores)` and `rank_members_in(leaderboard_name, members_and_scores)` allowing you to pass in some variable number of `member_name, score` and so on or an actual array of those data items. Use this method to do bulk insert of data, but be mindful of the amount of data you are inserting since a single transaction can get quite large.

data/README.markdown

@@ -26,16 +26,16 @@ The gem has been built and tested under Ruby 1.8.7, Ruby 1.9.2 and Ruby 1.9.3
 Create a new leaderboard or attach to an existing leaderboard named 'highscores':
 
 ```ruby
-  ruby-1.9.2-p180 :002 > highscore_lb = Leaderboard.new('highscores')
+  highscore_lb = Leaderboard.new('highscores')
    => #<Leaderboard:0x0000010307b530 @leaderboard_name="highscores", @page_size=25, @redis_connection=#<Redis client v2.2.2 connected to redis://localhost:6379/0 (Redis v2.2.5)>>
 ```
     
 If you need to pass in options for Redis, you can do this in the initializer:
 
 ```ruby
-  ruby-1.9.2-p180 :007 > redis_options = {:host => 'localhost', :port => 6379, :db => 1}
+  redis_options = {:host => 'localhost', :port => 6379, :db => 1}
    => {:host=>"localhost", :port=>6379, :db=>1} 
-  ruby-1.9.2-p180 :008 > highscore_lb = Leaderboard.new('highscores', Leaderboard::DEFAULT_OPTIONS, redis_options)
+  highscore_lb = Leaderboard.new('highscores', Leaderboard::DEFAULT_OPTIONS, redis_options)
    => #<Leaderboard:0x00000103095200 @leaderboard_name="highscores", @page_size=25, @redis_connection=#<Redis client v2.2.2 connected to redis://localhost:6379/1 (Redis v2.2.5)>> 
 ```
 
@@ -48,63 +48,66 @@ DEFAULT_OPTIONS = {
 }
 ```
 
-You would use the option, `:reverse => true`, if you wanted a leaderboard sorted from lowest to highest score.
+The `DEFAULT_PAGE_SIZE` is 25. 
 
-You can pass in an existing connection to Redis using :redis_connection in the Redis options hash:
+You would use the option, `:reverse => true`, if you wanted a leaderboard sorted from lowest-to-highest score. You 
+may also set the `reverse` option on a leaderboard after you have created a new instance of a leaderboard.
+
+You can pass in an existing connection to Redis using `:redis_connection` in the Redis options hash:
 
 ```ruby
-  ruby-1.9.2-p180 :009 > redis = Redis.new
+  redis = Redis.new
    => #<Redis client v2.2.2 connected to redis://127.0.0.1:6379/0 (Redis v2.2.5)> 
-  ruby-1.9.2-p180 :010 > redis_options = {:redis_connection => redis}
+  redis_options = {:redis_connection => redis}
    => {:redis_connection=>#<Redis client v2.2.2 connected to redis://127.0.0.1:6379/0 (Redis v2.2.5)>} 
-  ruby-1.9.2-p180 :011 > highscore_lb = Leaderboard.new('highscores', Leaderboard::DEFAULT_OPTIONS, redis_options)
+  highscore_lb = Leaderboard.new('highscores', Leaderboard::DEFAULT_OPTIONS, redis_options)
    => #<Leaderboard:0x000001028791e8 @leaderboard_name="highscores", @page_size=25, @redis_connection=#<Redis client v2.2.2 connected to redis://127.0.0.1:6379/0 (Redis v2.2.5)>> 
 ```
  
 You can set the page size to something other than the default page size (25):
 
 ```ruby
-  ruby-1.9.2-p180 :012 > highscore_lb.page_size = 5
+  highscore_lb.page_size = 5
    => 5 
-  ruby-1.9.2-p180 :013 > highscore_lb
+  highscore_lb
    => #<Leaderboard:0x000001028791e8 @leaderboard_name="highscores", @page_size=5, @redis_connection=#<Redis client v2.2.2 connected to redis://127.0.0.1:6379/0 (Redis v2.2.5)>> 
 ```
   
-Add members to your leaderboard using rank_member:
+Add members to your leaderboard using `rank_member`:
 
 ```ruby
-  ruby-1.9.2-p180 :014 > 1.upto(10) do |index|
-  ruby-1.9.2-p180 :015 >     highscore_lb.rank_member("member_#{index}", index)
-  ruby-1.9.2-p180 :016?>   end
+  1.upto(10) do |index|
+    highscore_lb.rank_member("member_#{index}", index)
+  end
    => 1 
 ```
 
-You can call rank_member with the same member and the leaderboard will be updated automatically.
+You can call `rank_member` with the same member and the leaderboard will be updated automatically.
 
 Get some information about your leaderboard:
 
 ```ruby
-  ruby-1.9.2-p180 :020 > highscore_lb.total_members
+  highscore_lb.total_members
    => 10 
-  ruby-1.9.2-p180 :021 > highscore_lb.total_pages
+  highscore_lb.total_pages
    => 1 
 ```
   
 Get some information about a specific member(s) in the leaderboard:
 
 ```ruby
-  ruby-1.9.2-p180 :022 > highscore_lb.score_for('member_4')
+  highscore_lb.score_for('member_4')
    => 4.0 
-  ruby-1.9.2-p180 :023 > highscore_lb.rank_for('member_4')
+  highscore_lb.rank_for('member_4')
    => 7 
-  ruby-1.9.2-p180 :024 > highscore_lb.rank_for('member_10')
+  highscore_lb.rank_for('member_10')
    => 1 
 ```
   
 Get page 1 in the leaderboard:
 
 ```ruby
-  ruby-1.9.2-p180 :025 > highscore_lb.leaders(1)
+  highscore_lb.leaders(1)
    => [{:member=>"member_10", :rank=>1, :score=>10.0}, {:member=>"member_9", :rank=>2, :score=>9.0}, {:member=>"member_8", :rank=>3, :score=>8.0}, {:member=>"member_7", :rank=>4, :score=>7.0}, {:member=>"member_6", :rank=>5, :score=>6.0}, {:member=>"member_5", :rank=>6, :score=>5.0}, {:member=>"member_4", :rank=>7, :score=>4.0}, {:member=>"member_3", :rank=>8, :score=>3.0}, {:member=>"member_2", :rank=>9, :score=>2.0}, {:member=>"member_1", :rank=>10, :score=>1.0}] 
 ```
 	
@@ -112,39 +115,39 @@ You can pass various options to the calls `leaders`, `around_me` and `ranked_in_
 Below is an example of retrieving the first page in the leaderboard without ranks:
 
 ```ruby
-  ruby-1.9.2-p180 :026 > highscore_lb.leaders(1, :with_rank => false)
+  highscore_lb.leaders(1, :with_rank => false)
    => [{:member=>"member_10", :score=>9.0}, {:member=>"member_9", :score=>7.0}, {:member=>"member_8", :score=>5.0}, {:member=>"member_7", :score=>3.0}, {:member=>"member_6", :score=>1.0}, {:member=>"member_5", :score=>0.0}, {:member=>"member_4", :score=>0.0}, {:member=>"member_3", :score=>0.0}, {:member=>"member_2", :score=>0.0}, {:member=>"member_1", :score=>0.0}] 
 ```
 
 Below is an example of retrieving the first page in the leaderboard without scores or ranks:
 
 ```ruby
-  ruby-1.9.2-p180 :028 > highscore_lb.leaders(1, :with_scores => false, :with_rank => false)
+  highscore_lb.leaders(1, :with_scores => false, :with_rank => false)
    => [{:member=>"member_10"}, {:member=>"member_9"}, {:member=>"member_8"}, {:member=>"member_7"}, {:member=>"member_6"}, {:member=>"member_5"}, {:member=>"member_4"}, {:member=>"member_3"}, {:member=>"member_2"}, {:member=>"member_1"}] 
 ```
 
 Add more members to your leaderboard:
 
 ```ruby
-  ruby-1.9.2-p180 :029 > 50.upto(95) do |index|
-  ruby-1.9.2-p180 :030 >     highscore_lb.rank_member("member_#{index}", index)
-  ruby-1.9.2-p180 :031?>   end
+  50.upto(95) do |index|
+    highscore_lb.rank_member("member_#{index}", index)
+  end
    => 50 
-  ruby-1.9.2-p180 :032 > highscore_lb.total_pages
+  highscore_lb.total_pages
    => 3 
 ```
   
-Get an "Around Me" leaderboard for a member:
+Get an "Around Me" leaderboard page for a given member, which pulls members above and below the given member:
 
 ```ruby
-  ruby-1.9.2-p180 :033 > highscore_lb.around_me('member_53')
+  highscore_lb.around_me('member_53')
    => [{:member=>"member_65", :rank=>31, :score=>65.0}, {:member=>"member_64", :rank=>32, :score=>64.0}, {:member=>"member_63", :rank=>33, :score=>63.0}, {:member=>"member_62", :rank=>34, :score=>62.0}, {:member=>"member_61", :rank=>35, :score=>61.0}, {:member=>"member_60", :rank=>36, :score=>60.0}, {:member=>"member_59", :rank=>37, :score=>59.0}, {:member=>"member_58", :rank=>38, :score=>58.0}, {:member=>"member_57", :rank=>39, :score=>57.0}, {:member=>"member_56", :rank=>40, :score=>56.0}, {:member=>"member_55", :rank=>41, :score=>55.0}, {:member=>"member_54", :rank=>42, :score=>54.0}, {:member=>"member_53", :rank=>43, :score=>53.0}, {:member=>"member_52", :rank=>44, :score=>52.0}, {:member=>"member_51", :rank=>45, :score=>51.0}, {:member=>"member_50", :rank=>46, :score=>50.0}, {:member=>"member_10", :rank=>47, :score=>10.0}, {:member=>"member_9", :rank=>48, :score=>9.0}, {:member=>"member_8", :rank=>49, :score=>8.0}, {:member=>"member_7", :rank=>50, :score=>7.0}, {:member=>"member_6", :rank=>51, :score=>6.0}, {:member=>"member_5", :rank=>52, :score=>5.0}, {:member=>"member_4", :rank=>53, :score=>4.0}, {:member=>"member_3", :rank=>54, :score=>3.0}, {:member=>"member_2", :rank=>55, :score=>2.0}] 
 ```
 	
-Get rank and score for an arbitrary list of members (e.g. friends):
+Get rank and score for an arbitrary list of members (e.g. friends) from the leaderboard:
 
 ```ruby
-  ruby-1.9.2-p180 :034 > highscore_lb.ranked_in_list(['member_1', 'member_62', 'member_67'])
+  highscore_lb.ranked_in_list(['member_1', 'member_62', 'member_67'])
    => [{:member=>"member_1", :rank=>56, :score=>1.0}, {:member=>"member_62", :rank=>34, :score=>62.0}, {:member=>"member_67", :rank=>29, :score=>67.0}]
 ```
 
@@ -192,30 +195,31 @@ Check the [online documentation](http://rubydoc.info/github/agoragames/leaderboa
 10 million sequential scores insert:
 
 ```ruby
-  ruby-1.9.2-p180 :003 > highscore_lb = Leaderboard.new('highscores')
+  highscore_lb = Leaderboard.new('highscores')
    => #<Leaderboard:0x0000010205fc50 @leaderboard_name="highscores", @page_size=25, @redis_connection=#<Redis client v2.2.2 connected to redis://localhost:6379/0 (Redis v2.2.5)>> 
-  ruby-1.9.2-p180 :004 > insert_time = Benchmark.measure do
-  ruby-1.9.2-p180 :005 >     1.upto(10000000) do |index|
-  ruby-1.9.2-p180 :006 >       highscore_lb.rank_member("member_#{index}", index)
-  ruby-1.9.2-p180 :007?>     end
-  ruby-1.9.2-p180 :008?>   end
+
+  insert_time = Benchmark.measure do
+    1.upto(10000000) do |index|
+      highscore_lb.rank_member("member_#{index}", index)
+    end
+  end
    => 323.070000 148.560000 471.630000 (942.068307)
 ```
   
 Average time to request an arbitrary page from the leaderboard:
 
 ```ruby
-  ruby-1.9.2-p180 :009 > requests_to_make = 50000
+  requests_to_make = 50000
    => 50000 
-  ruby-1.9.2-p180 :010 > lb_request_time = 0
+  lb_request_time = 0
    => 0 
-  ruby-1.9.2-p180 :011 > 1.upto(requests_to_make) do
-  ruby-1.9.2-p180 :012 >     lb_request_time += Benchmark.measure do
-  ruby-1.9.2-p180 :013 >       highscore_lb.leaders(rand(highscore_lb.total_pages))
-  ruby-1.9.2-p180 :014?>     end.total
-  ruby-1.9.2-p180 :015?>   end
+  1.upto(requests_to_make) do
+    lb_request_time += Benchmark.measure do
+      highscore_lb.leaders(rand(highscore_lb.total_pages))
+    end.total
+  end
    => 1 
-  ruby-1.9.2-p180 :016 > p lb_request_time / requests_to_make
+  p lb_request_time / requests_to_make
   0.001513999999999998
    => 0.001513999999999998 
 ```
@@ -223,24 +227,24 @@ Average time to request an arbitrary page from the leaderboard:
 10 million random scores insert:
 
 ```ruby
-  ruby-1.9.2-p180 :018 > insert_time = Benchmark.measure do
-  ruby-1.9.2-p180 :019 >     1.upto(10000000) do |index|
-  ruby-1.9.2-p180 :020 >       highscore_lb.rank_member("member_#{index}", rand(50000000))
-  ruby-1.9.2-p180 :021?>     end
-  ruby-1.9.2-p180 :022?>   end
+  insert_time = Benchmark.measure do
+    1.upto(10000000) do |index|
+      highscore_lb.rank_member("member_#{index}", rand(50000000))
+    end
+  end
    => 338.480000 155.200000 493.680000 (2188.702475)
 ```
   
 Average time to request an arbitrary page from the leaderboard:
 
 ```ruby
-  ruby-1.9.2-p180 :007 > 1.upto(requests_to_make) do
-  ruby-1.9.2-p180 :008 >     lb_request_time += Benchmark.measure do
-  ruby-1.9.2-p180 :009 >       highscore_lb.leaders(rand(highscore_lb.total_pages))
-  ruby-1.9.2-p180 :010?>     end.total
-  ruby-1.9.2-p180 :011?>   end
+  1.upto(requests_to_make) do
+    lb_request_time += Benchmark.measure do
+      highscore_lb.leaders(rand(highscore_lb.total_pages))
+    end.total
+  end
    => 1 
-  ruby-1.9.2-p180 :012 > p lb_request_time / requests_to_make
+  p lb_request_time / requests_to_make
   0.0014615999999999531
    => 0.0014615999999999531 
 ```
@@ -250,27 +254,27 @@ Bulk insert performance:
 Ranking individual members:
 
 ```ruby
-1.9.3p0 :015 > insert_time = Benchmark.measure do
-1.9.3p0 :016 >     1.upto(1000000) do |index|
-1.9.3p0 :017 >       highscore_lb.rank_member("member_#{index}", index)
-1.9.3p0 :018?>     end
-1.9.3p0 :019?>   end
+insert_time = Benchmark.measure do
+  1.upto(1000000) do |index|
+    highscore_lb.rank_member("member_#{index}", index)
+  end
+end
  =>  29.340000  15.050000  44.390000 ( 81.673507)
 ```
 
 Ranking multiple members at once:
 
 ```ruby
-1.9.3p0 :020 > member_data = []
+member_data = []
  => [] 
-1.9.3p0 :021 > 1.upto(1000000) do |index|
-1.9.3p0 :022 >   member_data << "member_#{index}"
-1.9.3p0 :023?>   member_data << index
-1.9.3p0 :024?> end
+1.upto(1000000) do |index|
+  member_data << "member_#{index}"
+  member_data << index
+end
  => 1 
-1.9.3p0 :025 > insert_time = Benchmark.measure do
-1.9.3p0 :026 >   highscore_lb.rank_members(member_data)
-1.9.3p0 :027?> end
+insert_time = Benchmark.measure do
+  highscore_lb.rank_members(member_data)
+end
  =>  22.390000   6.380000  28.770000 ( 31.144027)
 ```
 

data/Rakefile

@@ -1,15 +1,15 @@
-require 'bundler/gem_tasks'
-require 'rake'
-require 'rake/testtask'
-
-Rake::TestTask.new(:test) do |test|
-  test.libs << 'lib' << 'test'
-  test.pattern = 'test/**/test_*.rb'
-  test.verbose = true
-  # test.warning = true
+require 'bundler'
+Bundler::GemHelper.install_tasks
+
+require 'rspec/core/rake_task'
+
+RSpec::Core::RakeTask.new(:spec) do |spec|
+  spec.pattern = 'spec/**/*_spec.rb'
+  spec.rspec_opts = ['--backtrace']
+  # spec.ruby_opts = ['-w']
 end
 
-REDIS_DIR = File.expand_path(File.join("..", "test"), __FILE__)
+REDIS_DIR = File.expand_path(File.join("..", "spec"), __FILE__)
 REDIS_CNF = File.join(REDIS_DIR, "test.conf")
 REDIS_PID = File.join(REDIS_DIR, "db", "redis.pid")
 REDIS_LOCATION = ENV['REDIS_LOCATION']
@@ -17,7 +17,7 @@ REDIS_LOCATION = ENV['REDIS_LOCATION']
 task :default => :run
 
 desc "Run tests and manage server start/stop"
-task :run => [:start, :test, :stop]
+task :run => [:start, :spec, :stop]
 
 desc "Start the Redis server"
 task :start do
@@ -46,6 +46,6 @@ end
 
 task :test_rubies do
   Rake::Task['start'].execute
-  system "rvm 1.8.7@leaderboard_gem,1.9.2@leaderboard_gem,1.9.3@leaderboard_gem do rake test"
+  system "rvm 1.8.7@leaderboard_gem,1.9.2@leaderboard_gem,1.9.3@leaderboard_gem do rake spec"
   Rake::Task['stop'].execute
 end

data/leaderboard.gemspec

@@ -24,4 +24,5 @@ Gem::Specification.new do |s|
   if '1.8.7'.eql?(RUBY_VERSION)
     s.add_development_dependency('SystemTimer')
   end
+  s.add_development_dependency('rspec')
 end

data/lib/leaderboard.rb

@@ -1,23 +1,36 @@
 require 'redis'
 require 'leaderboard/version'
 
-class Leaderboard
+class Leaderboard 
+  # Default page size: 25
   DEFAULT_PAGE_SIZE = 25
   
+  # Default options when creating a leaderboard. Page size is 25 and reverse
+  # is set to false, meaning various methods will return results in
+  # highest-to-lowest order.
   DEFAULT_OPTIONS = {
     :page_size => DEFAULT_PAGE_SIZE,
     :reverse => false
   }
 
+  # Default Redis host: localhost
   DEFAULT_REDIS_HOST = 'localhost'
   
+  # Default Redis post: 6379
   DEFAULT_REDIS_PORT = 6379  
   
+  # Default Redis options when creating a connection to Redis. The
+  # +DEFAULT_REDIS_HOST+ and +DEFAULT_REDIS_PORT+ will be passed.
   DEFAULT_REDIS_OPTIONS = {
     :host => DEFAULT_REDIS_HOST,
     :port => DEFAULT_REDIS_PORT
   }
   
+  # Default options when requesting data from a leaderboard.
+  # +:with_scores+ true: Return scores along with the member names.
+  # +:with_rank+ true: Return ranks along with the member names.
+  # +:use_zero_index_for_rank+ false: If you want to 0-index ranks.
+  # +:page_size+ nil: The default page size will be used.
   DEFAULT_LEADERBOARD_REQUEST_OPTIONS = {
     :with_scores => true, 
     :with_rank => true, 
@@ -30,6 +43,11 @@ class Leaderboard
 
   # Page size to be used when paging through the leaderboard. 
   attr_reader :page_size
+
+  # Determines whether or not various leaderboard methods return their
+  # data in highest-to-lowest (+:reverse+ false) or 
+  # lowest-to-highest (+:reverse+ true)
+  attr_accessor :reverse
   
   # Create a new instance of a leaderboard.
   # 

data/lib/leaderboard/version.rb

@@ -1,3 +1,4 @@
 class Leaderboard
-  VERSION = '2.0.5'.freeze
+  # Leaderboard version
+  VERSION = '2.0.6'.freeze
 end

data/spec/leaderboard_spec.rb

@@ -0,0 +1,503 @@
+require 'spec_helper'
+
+describe 'Leaderboard' do
+  before(:each) do
+    @redis_connection = Redis.new(:host => "127.0.0.1", :db => 15)
+    @leaderboard = Leaderboard.new('name', Leaderboard::DEFAULT_LEADERBOARD_REQUEST_OPTIONS, :host => "127.0.0.1", :db => 15)
+  end
+
+  after(:each) do
+    @redis_connection.flushdb
+    @leaderboard.disconnect
+    @redis_connection.client.disconnect
+  end
+
+  it 'should be initialized with defaults' do
+    @leaderboard.leaderboard_name.should == 'name'
+    @leaderboard.page_size.should == Leaderboard::DEFAULT_PAGE_SIZE 
+  end
+
+  it 'should be able to disconnect its connection to Redis' do
+    @leaderboard.disconnect.should be_nil
+  end
+
+  it 'should automatically reconnect to Redis after a disconnect' do
+    @leaderboard.total_members.should be(0)
+    rank_members_in_leaderboard(5)
+    @leaderboard.total_members.should be(5)
+    @leaderboard.disconnect.should be_nil
+    @leaderboard.total_members.should be(5)
+  end
+
+  it 'should set the page size to the default page size if passed an invalid value' do
+    some_leaderboard = Leaderboard.new('name', {:page_size => 0})
+    
+    some_leaderboard.page_size.should be(Leaderboard::DEFAULT_PAGE_SIZE)
+    some_leaderboard.disconnect
+  end
+
+  it 'should allow you to delete a leaderboard' do
+    rank_members_in_leaderboard
+    
+    @redis_connection.exists('name').should be_true
+    @leaderboard.delete_leaderboard
+    @redis_connection.exists('name').should be_false
+  end
+
+  it 'should allow you to pass in an existing redis connection in the initializer' do
+    @leaderboard = Leaderboard.new('name', Leaderboard::DEFAULT_OPTIONS, {:redis_connection => @redis_connection})
+    rank_members_in_leaderboard
+    
+    @redis_connection.info["connected_clients"].to_i.should be(1)
+  end
+
+  it 'should allow you to rank a member and see that reflected in total members' do
+    @leaderboard.rank_member('member', 1)
+
+    @leaderboard.total_members.should be(1)
+  end
+
+  it 'should return the correct number of members in a given score range' do
+    rank_members_in_leaderboard(5)
+    
+    @leaderboard.total_members_in_score_range(2, 4).should be(3)
+  end
+
+  it 'should return the correct rank when calling rank_for' do
+    rank_members_in_leaderboard(5)
+
+    @leaderboard.rank_for('member_4').should be(2)
+    @leaderboard.rank_for('member_4', true).should be(1)
+  end
+
+  it 'should return the correct score when calling score_for' do
+    rank_members_in_leaderboard(5)
+    
+    @leaderboard.score_for('member_4').should == 4
+  end
+
+  it 'should return the correct total pages' do
+    rank_members_in_leaderboard(10)
+    
+    @leaderboard.total_pages.should be(1)
+    
+    @redis_connection.flushdb
+    
+    rank_members_in_leaderboard(Leaderboard::DEFAULT_PAGE_SIZE + 1)
+    
+    @leaderboard.total_pages.should be(2)
+  end
+
+  it 'should return the correct list when calling leaders' do
+    rank_members_in_leaderboard(25)
+    
+    @leaderboard.total_members.should be(25)
+
+    leaders = @leaderboard.leaders(1)
+        
+    leaders.size.should be(25)
+    leaders[0][:member].should == 'member_25'
+    leaders[-2][:member].should == 'member_2'
+    leaders[-1][:member].should == 'member_1'
+    leaders[-1][:score].to_i.should be(1)
+  end
+
+  it 'should return the correct number of members when calling leaders with multiple pages' do
+    rank_members_in_leaderboard(Leaderboard::DEFAULT_PAGE_SIZE * 3 + 1)
+    
+    @leaderboard.total_members.should be(Leaderboard::DEFAULT_PAGE_SIZE * 3 + 1)
+
+    leaders = @leaderboard.leaders(1)
+    leaders.size.should be(@leaderboard.page_size)
+    
+    leaders = @leaderboard.leaders(2)
+    leaders.size.should be(@leaderboard.page_size)
+
+    leaders = @leaderboard.leaders(3)
+    leaders.size.should be(@leaderboard.page_size)
+
+    leaders = @leaderboard.leaders(4)
+    leaders.size.should be(1)
+    
+    leaders = @leaderboard.leaders(-5)
+    leaders.size.should be(@leaderboard.page_size)
+    
+    leaders = @leaderboard.leaders(10)
+    leaders.size.should be(1)
+  end
+
+  it 'should allow you to retrieve leaders without scores and ranks' do
+    rank_members_in_leaderboard(Leaderboard::DEFAULT_PAGE_SIZE)
+    
+    @leaderboard.total_members.should be(Leaderboard::DEFAULT_PAGE_SIZE)
+    leaders = @leaderboard.leaders(1, {:with_scores => false, :with_rank => false})
+
+    member_25 = {:member => 'member_25'}
+    leaders[0].should == member_25
+    
+    member_1 = {:member => 'member_1'}
+    leaders[24].should == member_1
+  end
+
+  it 'should allow you to call leaders with various options that respect the defaults for the options not passed in' do
+    rank_members_in_leaderboard(Leaderboard::DEFAULT_PAGE_SIZE + 1)
+
+    leaders = @leaderboard.leaders(1, :page_size => 1)
+    leaders.size.should be(1)
+    
+    leaders = @leaderboard.leaders(1, :with_rank => false)
+    leaders.size.should be(Leaderboard::DEFAULT_PAGE_SIZE)
+    member_26 = {:member => 'member_26', :score => 26}
+    member_25 = {:member => 'member_25', :score => 25}
+    member_24 = {:member => 'member_24', :score => 24}
+    leaders[0].should == member_26
+    leaders[1].should == member_25
+    leaders[2].should == member_24
+
+    leaders = @leaderboard.leaders(1, :with_scores => false)
+    leaders.size.should be(Leaderboard::DEFAULT_PAGE_SIZE)
+    member_26 = {:member => 'member_26', :rank => 1}
+    member_25 = {:member => 'member_25', :rank => 2}
+    leaders[0].should == member_26
+    leaders[1].should == member_25
+
+    leaders = @leaderboard.leaders(1, :with_scores => false, :with_rank => false)
+    leaders.size.should be(Leaderboard::DEFAULT_PAGE_SIZE)
+    member_26 = {:member => 'member_26'}
+    member_25 = {:member => 'member_25'}
+    leaders[0].should == member_26
+    leaders[1].should == member_25
+
+    leaders = @leaderboard.leaders(1, :with_rank => false, :page_size => 1)
+    leaders.size.should be(1)
+    member_26 = {:member => 'member_26', :score => 26}
+    leaders[0].should == member_26
+  end
+
+  it 'should return the correct information when calling around_me' do
+    rank_members_in_leaderboard(Leaderboard::DEFAULT_PAGE_SIZE * 3 + 1)
+
+    @leaderboard.total_members.should be(Leaderboard::DEFAULT_PAGE_SIZE * 3 + 1)
+    
+    leaders_around_me = @leaderboard.around_me('member_30')
+    (leaders_around_me.size / 2).should be(@leaderboard.page_size / 2)
+    
+    leaders_around_me = @leaderboard.around_me('member_1')
+    leaders_around_me.size.should be(@leaderboard.page_size / 2 + 1)
+    
+    leaders_around_me = @leaderboard.around_me('member_76')
+    (leaders_around_me.size / 2).should be(@leaderboard.page_size / 2)
+  end
+
+  it 'should return the correct information when calling ranked_in_list' do
+    rank_members_in_leaderboard(Leaderboard::DEFAULT_PAGE_SIZE)
+    
+    @leaderboard.total_members.should be(Leaderboard::DEFAULT_PAGE_SIZE)
+    
+    members = ['member_1', 'member_5', 'member_10']
+    ranked_members = @leaderboard.ranked_in_list(members, Leaderboard::DEFAULT_LEADERBOARD_REQUEST_OPTIONS)
+    
+    ranked_members.size.should be(3)
+
+    ranked_members[0][:rank].should be(25)
+    ranked_members[0][:score].should == 1
+
+    ranked_members[1][:rank].should be(21)
+    ranked_members[1][:score].should == 5
+
+    ranked_members[2][:rank].should be(16)
+    ranked_members[2][:score].should == 10
+  end
+
+  it 'should return the correct information when calling ranked_in_list without scores' do
+    rank_members_in_leaderboard(Leaderboard::DEFAULT_PAGE_SIZE)
+    
+    @leaderboard.total_members.should be(Leaderboard::DEFAULT_PAGE_SIZE)
+    
+    members = ['member_1', 'member_5', 'member_10']
+    ranked_members = @leaderboard.ranked_in_list(members, {:with_scores => false, :with_rank => true, :use_zero_index_for_rank => false})
+    
+    ranked_members.size.should be(3)
+    ranked_members[0][:rank].should be(25)
+    ranked_members[1][:rank].should be(21)
+    ranked_members[2][:rank].should be(16)
+  end
+
+  it 'should allow you to remove members' do
+    rank_members_in_leaderboard(Leaderboard::DEFAULT_PAGE_SIZE)
+    
+    @leaderboard.total_members.should be(Leaderboard::DEFAULT_PAGE_SIZE)
+    
+    @leaderboard.remove_member('member_1')
+    
+    @leaderboard.total_members.should be(Leaderboard::DEFAULT_PAGE_SIZE - 1)
+    @leaderboard.rank_for('member_1').should be_nil
+  end
+
+  it 'should allow you to change the score for a member' do
+    @leaderboard.rank_member('member_1', 5)    
+    @leaderboard.score_for('member_1').should == 5
+
+    @leaderboard.change_score_for('member_1', 5)    
+    @leaderboard.score_for('member_1').should == 10
+
+    @leaderboard.change_score_for('member_1', -5)    
+    @leaderboard.score_for('member_1').should == 5
+  end
+
+  it 'should allow you to check if a member exists' do
+    @leaderboard.rank_member('member_1', 10)
+    
+    @leaderboard.check_member?('member_1').should be_true
+    @leaderboard.check_member?('member_2').should be_false
+  end
+
+  it 'should allow you to change the page size and have that reflected in the size of the result set' do
+    rank_members_in_leaderboard(Leaderboard::DEFAULT_PAGE_SIZE)
+    
+    @leaderboard.page_size = 5
+    
+    @leaderboard.total_pages.should be(5)
+    @leaderboard.leaders(1).size.should be(5)
+  end
+
+  it 'should not allow you to set the page size to an invalid page size' do
+    rank_members_in_leaderboard(Leaderboard::DEFAULT_PAGE_SIZE)
+    
+    @leaderboard.page_size = 0
+    @leaderboard.total_pages.should be(1)
+    @leaderboard.leaders(1).size.should be(Leaderboard::DEFAULT_PAGE_SIZE)
+  end
+
+  it 'should return the correct information when calling score_and_rank_for' do
+    rank_members_in_leaderboard
+    
+    data = @leaderboard.score_and_rank_for('member_1')
+    data[:member].should == 'member_1' 
+    data[:score].should == 1
+    data[:rank].should == 5
+  end
+
+  it 'should allow you to remove members in a given score range' do
+    rank_members_in_leaderboard
+    
+    @leaderboard.total_members.should be(5)
+    
+    @leaderboard.rank_member('cheater_1', 100)
+    @leaderboard.rank_member('cheater_2', 101)
+    @leaderboard.rank_member('cheater_3', 102)
+
+    @leaderboard.total_members.should be(8)
+
+    @leaderboard.remove_members_in_score_range(100, 102)
+    
+    @leaderboard.total_members.should be(5)
+    
+    leaders = @leaderboard.leaders(1)
+    leaders.each do |leader|
+      leader[:score].should be < 100
+    end
+  end
+
+  it 'should allow you to merge leaderboards' do
+    foo = Leaderboard.new('foo', Leaderboard::DEFAULT_LEADERBOARD_REQUEST_OPTIONS, :host => "127.0.0.1", :db => 15)
+    bar = Leaderboard.new('bar', Leaderboard::DEFAULT_LEADERBOARD_REQUEST_OPTIONS, :host => "127.0.0.1", :db => 15)
+    
+    foo.rank_member('foo_1', 1)
+    foo.rank_member('foo_2', 2)
+    bar.rank_member('bar_1', 3)
+    bar.rank_member('bar_2', 4)
+    bar.rank_member('bar_3', 5)
+    
+    foobar_keys = foo.merge_leaderboards('foobar', ['bar'])
+    foobar_keys.should be(5)
+    
+    foobar = Leaderboard.new('foobar', Leaderboard::DEFAULT_LEADERBOARD_REQUEST_OPTIONS, :host => "127.0.0.1", :db => 15)
+    foobar.total_members.should be(5)
+    
+    first_leader_in_foobar = foobar.leaders(1).first
+    first_leader_in_foobar[:rank].should == 1
+    first_leader_in_foobar[:member].should == 'bar_3'
+    first_leader_in_foobar[:score].should == 5
+    
+    foo.disconnect
+    bar.disconnect
+    foobar.disconnect
+  end
+
+  it 'should allow you to intersect leaderboards' do
+    foo = Leaderboard.new('foo', Leaderboard::DEFAULT_LEADERBOARD_REQUEST_OPTIONS, :host => "127.0.0.1", :db => 15)
+    bar = Leaderboard.new('bar', Leaderboard::DEFAULT_LEADERBOARD_REQUEST_OPTIONS, :host => "127.0.0.1", :db => 15)
+    
+    foo.rank_member('foo_1', 1)
+    foo.rank_member('foo_2', 2)
+    foo.rank_member('bar_3', 6)
+    bar.rank_member('bar_1', 3)
+    bar.rank_member('foo_1', 4)
+    bar.rank_member('bar_3', 5)
+    
+    foobar_keys = foo.intersect_leaderboards('foobar', ['bar'], {:aggregate => :max})    
+    foobar_keys.should be(2)
+    
+    foobar = Leaderboard.new('foobar', Leaderboard::DEFAULT_LEADERBOARD_REQUEST_OPTIONS, :host => "127.0.0.1", :db => 15)
+    foobar.total_members.should be(2)
+    
+    first_leader_in_foobar = foobar.leaders(1).first
+    first_leader_in_foobar[:rank].should == 1
+    first_leader_in_foobar[:member].should == 'bar_3'
+    first_leader_in_foobar[:score].should == 6
+    
+    foo.disconnect
+    bar.disconnect
+    foobar.disconnect
+  end
+
+  it 'should respect the with_scores option in the massage_leader_data method' do
+    rank_members_in_leaderboard(25)
+    
+    @leaderboard.total_members.should be(25)
+
+    leaders = @leaderboard.leaders(1, {:with_scores => false, :with_rank => false})
+    leaders[0][:member].should_not be_nil
+    leaders[0][:score].should be_nil
+    leaders[0][:rank].should be_nil
+    
+    @leaderboard.page_size = 25
+    leaders = @leaderboard.leaders(1, {:with_scores => false, :with_rank => false})
+    leaders.size.should be(25)
+
+    @leaderboard.page_size = Leaderboard::DEFAULT_PAGE_SIZE
+    leaders = @leaderboard.leaders(1, Leaderboard::DEFAULT_LEADERBOARD_REQUEST_OPTIONS)
+    leaders[0][:member].should_not be_nil
+    leaders[0][:score].should_not be_nil
+    leaders[0][:rank].should_not be_nil
+    
+    @leaderboard.page_size = 25
+    leaders = @leaderboard.leaders(1, Leaderboard::DEFAULT_LEADERBOARD_REQUEST_OPTIONS)
+    leaders.size.should be(25)
+  end
+
+  it 'should return the correct number of pages when calling total_pages_in page size option' do
+    rank_members_in_leaderboard(25)
+    
+    @leaderboard.total_pages_in(@leaderboard.leaderboard_name).should be(1)
+    @leaderboard.total_pages_in(@leaderboard.leaderboard_name, 5).should be(5)
+  end
+
+  it 'should return the correct number of members when calling leaders with a page_size option' do
+    rank_members_in_leaderboard(25)
+    
+    @leaderboard.leaders(1, Leaderboard::DEFAULT_LEADERBOARD_REQUEST_OPTIONS.merge({:page_size => 5})).size.should be(5)
+    @leaderboard.leaders(1, Leaderboard::DEFAULT_LEADERBOARD_REQUEST_OPTIONS.merge({:page_size => 10})).size.should be(10)
+    @leaderboard.leaders(2, Leaderboard::DEFAULT_LEADERBOARD_REQUEST_OPTIONS.merge({:page_size => 10})).size.should be(10)
+    @leaderboard.leaders(3, Leaderboard::DEFAULT_LEADERBOARD_REQUEST_OPTIONS.merge({:page_size => 10})).size.should be(5)
+  end
+
+  it 'should return the correct number of members when calling around_me with a page_size options' do
+    rank_members_in_leaderboard(Leaderboard::DEFAULT_PAGE_SIZE * 3 + 1)
+    
+    leaders_around_me = @leaderboard.around_me('member_30', Leaderboard::DEFAULT_LEADERBOARD_REQUEST_OPTIONS.merge({:page_size => 3}))
+    leaders_around_me.size.should be(3)
+    leaders_around_me[0][:member].should == 'member_31'
+    leaders_around_me[2][:member].should == 'member_29'
+  end
+
+  it 'should return the correct information when calling percentile_for' do
+    rank_members_in_leaderboard(12)
+    
+    @leaderboard.percentile_for('member_1').should == 0
+    @leaderboard.percentile_for('member_2').should == 9
+    @leaderboard.percentile_for('member_3').should == 17
+    @leaderboard.percentile_for('member_4').should == 25
+    @leaderboard.percentile_for('member_12').should == 92
+  end
+
+  it 'should not throw an exception when calling around_me with a member not in the leaderboard' do
+    rank_members_in_leaderboard(Leaderboard::DEFAULT_PAGE_SIZE * 3 + 1)
+    
+    leaders_around_me = @leaderboard.around_me('jones', Leaderboard::DEFAULT_LEADERBOARD_REQUEST_OPTIONS.merge({:page_size => 3}))
+    leaders_around_me.size.should be(0)
+  end
+
+  it 'should not throw an exception when calling score_and_rank_for with a member not in the leaderboard' do
+    score_and_rank_for_member = @leaderboard.score_and_rank_for('jones')
+  
+    score_and_rank_for_member[:member].should == 'jones'
+    score_and_rank_for_member[:score].should == 0.0
+    score_and_rank_for_member[:rank].should be_nil
+  end
+
+  it 'should not throw an exception when calling ranked_in_list with a member not in the leaderboard' do
+    rank_members_in_leaderboard
+
+    members = ['member_1', 'member_5', 'jones']
+    ranked_members = @leaderboard.ranked_in_list(members)
+
+    ranked_members.size.should be(3)
+    ranked_members[2][:rank].should be_nil
+  end
+
+  it 'should not throw an exception when calling percentile_for with a member not in the leaderboard' do
+    percentile = @leaderboard.percentile_for('jones')
+
+    percentile.should be_nil
+  end
+
+  it 'should allow you to change the score for a member not in the leaderboard' do
+    @leaderboard.score_for('jones').should == 0.0
+    @leaderboard.change_score_for('jones', 5)
+    @leaderboard.score_for('jones').should == 5.0
+  end
+
+  it 'should return the correct page when calling page_for a given member in the leaderboard' do
+    @leaderboard.page_for('jones').should be(0)
+
+    rank_members_in_leaderboard(20)
+
+    @leaderboard.page_for('member_17').should be(1)
+    @leaderboard.page_for('member_11').should be(1)
+    @leaderboard.page_for('member_10').should be(1)
+    @leaderboard.page_for('member_1').should be(1)
+
+    @leaderboard.page_for('member_17', 10).should be(1)
+    @leaderboard.page_for('member_11', 10).should be(1)
+    @leaderboard.page_for('member_10', 10).should be(2)
+    @leaderboard.page_for('member_1', 10).should be(2)
+  end
+
+  it 'should allow you to rank multiple members with a variable number of arguments' do
+    @leaderboard.total_members.should be(0)
+    @leaderboard.rank_members('member_1', 1, 'member_10', 10)
+    @leaderboard.total_members.should be(2)
+    @leaderboard.leaders(1).first[:member].should == 'member_10'
+  end
+
+  it 'should allow you to rank multiple members with an array' do
+    @leaderboard.total_members.should be(0)
+    @leaderboard.rank_members(['member_1', 1, 'member_10', 10])
+    @leaderboard.total_members.should be(2)
+    @leaderboard.leaders(1).first[:member].should == 'member_10'
+  end
+
+  it 'should allow you to set reverse after creating a leaderboard to see results in highest-to-lowest or lowest-to-highest order' do
+    rank_members_in_leaderboard(25)
+
+    leaders = @leaderboard.leaders(1)
+        
+    leaders.size.should be(25)
+    leaders[0][:member].should == 'member_25'
+    leaders[-2][:member].should == 'member_2'
+    leaders[-1][:member].should == 'member_1'
+    leaders[-1][:score].to_i.should be(1)
+
+    @leaderboard.reverse = true
+
+    leaders = @leaderboard.leaders(1)
+        
+    leaders.size.should be(25)
+    leaders[0][:member].should == 'member_1'
+    leaders[-2][:member].should == 'member_24'
+    leaders[-1][:member].should == 'member_25'
+    leaders[-1][:score].to_i.should be(25)
+  end
+end