github-migration
/
mongo-ruby-driver
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

Added Cursor#to_a and more tests and docs.

This commit is contained in:
Jim Menard 2009-01-07 14:07:17 -05:00
parent 8cf55d27bc
commit 169a96ad5b
2 changed files with 75 additions and 36 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

40
lib/mongo/cursor.rb
View File

@ -31,8 +31,7 @@ module XGen
def initialize(db, collection, num_to_return=0)
@db, @collection, @num_to_return = db, collection, num_to_return
@objects_returned = 0
@objects = []
@cache = []
@closed = false
read_all
end
@ -46,7 +45,7 @@ module XGen
# Return the next object. Raises an error if necessary.
def next_object
refill_via_get_more if num_remaining == 0
o = @objects.shift
o = @cache.shift
raise o['$err'] if o['$err']
o
end
@ -54,18 +53,43 @@ module XGen
# Iterate over each object, yielding it to the given block. At most
# @num_to_return records are returned (or all of them, if
# @num_to_return is 0).
#
# If #to_a has already been called then this method uses the array
# that we store internally. In that case, #each can be called multiple
# times because it re-uses that array.
def each
if @rows # Already turned into an array
@rows.each { |row| yield row }
else
num_returned = 0
while more? && (@num_to_return <= 0 || num_returned < @num_to_return)
yield next_object()
num_returned += 1
end
end
end
# Return all of the rows as an array. Calling this multiple times will
# work fine; it always returns the same array.
#
# You can call #each after calling #to_a (multiple times even, because
# it will use the internally-stored array), but you can't call #to_a
# after calling #ach.
def to_a
return @rows if @rows
@rows = []
num_returned = 0
while more? && (@num_to_return <= 0 || num_returned < @num_to_return)
yield next_object()
@rows << next_object()
num_returned += 1
end
@rows
end
# Close the cursor.
def close
@db.send_to_db(KillCursorMessage(@cursor_id)) if @cursor_id
@objects = []
@cache = []
@cursor_id = 0
@closed = true
end
@ -80,7 +104,7 @@ module XGen
def read_objects_off_wire
while doc = next_object_on_wire
@objects << doc
@cache << doc
end
end
@ -101,8 +125,8 @@ module XGen
end
def num_remaining
refill_via_get_more if @objects.length == 0
@objects.length
refill_via_get_more if @cache.length == 0
@cache.length
end
private

71
tests/test_db_api.rb
View File

@ -32,14 +32,14 @@ class DBAPITest < Test::Unit::TestCase
@coll.insert('b' => 3)
assert_equal 3, @coll.count
docs = @coll.find().map{ |x| x }
docs = @coll.find().to_a
assert_equal 3, docs.length
assert docs.detect { |row| row['a'] == 1 }
assert docs.detect { |row| row['a'] == 2 }
assert docs.detect { |row| row['b'] == 3 }
@coll << {'b' => 4}
docs = @coll.find().map{ |x| x }
docs = @coll.find().to_a
assert_equal 4, docs.length
assert docs.detect { |row| row['b'] == 4 }
end
@ -48,12 +48,12 @@ class DBAPITest < Test::Unit::TestCase
@r2 = @coll.insert('a' => 2)
@r3 = @coll.insert('b' => 3)
# Check sizes
docs = @coll.find().map{ |x| x }
docs = @coll.find().to_a
assert_equal 3, docs.size
assert_equal 3, @coll.count
# Find by other value
docs = @coll.find('a' => @r1['a']).map{ |x| x }
docs = @coll.find('a' => @r1['a']).to_a
assert_equal 1, docs.size
doc = docs.first
assert_equal doc['_id'], @r1['_id']
@ -65,40 +65,40 @@ class DBAPITest < Test::Unit::TestCase
@coll.insert('b' => 3)
# Find by advanced query (less than)
docs = @coll.find('a' => { '$lt' => 10 }).map{ |x| x }
docs = @coll.find('a' => { '$lt' => 10 }).to_a
assert_equal 2, docs.size
assert docs.detect { |row| row['a'] == 1 }
assert docs.detect { |row| row['a'] == 2 }
# Find by advanced query (greater than)
docs = @coll.find('a' => { '$gt' => 1 }).map{ |x| x }
docs = @coll.find('a' => { '$gt' => 1 }).to_a
assert_equal 1, docs.size
assert docs.detect { |row| row['a'] == 2 }
# Find by advanced query (less than or equal to)
docs = @coll.find('a' => { '$lte' => 1 }).map{ |x| x }
docs = @coll.find('a' => { '$lte' => 1 }).to_a
assert_equal 1, docs.size
assert docs.detect { |row| row['a'] == 1 }
# Find by advanced query (greater than or equal to)
docs = @coll.find('a' => { '$gte' => 1 }).map{ |x| x }
docs = @coll.find('a' => { '$gte' => 1 }).to_a
assert_equal 2, docs.size
assert docs.detect { |row| row['a'] == 1 }
assert docs.detect { |row| row['a'] == 2 }
# Find by advanced query (between)
docs = @coll.find('a' => { '$gt' => 1, '$lt' => 3 }).map{ |x| x }
docs = @coll.find('a' => { '$gt' => 1, '$lt' => 3 }).to_a
assert_equal 1, docs.size
assert docs.detect { |row| row['a'] == 2 }
# Find by advanced query (in clause)
docs = @coll.find('a' => {'$in' => [1,2]}).map{ |x| x }
docs = @coll.find('a' => {'$in' => [1,2]}).to_a
assert_equal 2, docs.size
assert docs.detect { |row| row['a'] == 1 }
assert docs.detect { |row| row['a'] == 2 }
# Find by advanced query (regexp)
docs = @coll.find('a' => /[1|2]/).map{ |x| x }
docs = @coll.find('a' => /[1|2]/).to_a
assert_equal 2, docs.size
assert docs.detect { |row| row['a'] == 1 }
assert docs.detect { |row| row['a'] == 2 }
@ -112,7 +112,7 @@ class DBAPITest < Test::Unit::TestCase
@coll.insert('a' => 4, 'b' => 1)
# Sorting (ascending)
docs = @coll.find({'a' => { '$lt' => 10 }}, :sort => {'a' => 1}).map{ |x| x }
docs = @coll.find({'a' => { '$lt' => 10 }}, :sort => {'a' => 1}).to_a
assert_equal 4, docs.size
assert_equal 1, docs[0]['a']
assert_equal 2, docs[1]['a']
@ -120,7 +120,7 @@ class DBAPITest < Test::Unit::TestCase
assert_equal 4, docs[3]['a']
# Sorting (descending)
docs = @coll.find({'a' => { '$lt' => 10 }}, :sort => {'a' => -1}).map{ |x| x }
docs = @coll.find({'a' => { '$lt' => 10 }}, :sort => {'a' => -1}).to_a
assert_equal 4, docs.size
assert_equal 4, docs[0]['a']
assert_equal 3, docs[1]['a']
@ -128,7 +128,7 @@ class DBAPITest < Test::Unit::TestCase
assert_equal 1, docs[3]['a']
# Sorting using array of names; assumes ascending order.
docs = @coll.find({'a' => { '$lt' => 10 }}, :sort => ['a']).map{ |x| x }
docs = @coll.find({'a' => { '$lt' => 10 }}, :sort => ['a']).to_a
assert_equal 4, docs.size
assert_equal 1, docs[0]['a']
assert_equal 2, docs[1]['a']
@ -136,14 +136,14 @@ class DBAPITest < Test::Unit::TestCase
assert_equal 4, docs[3]['a']
# Sorting using single name; assumes ascending order.
docs = @coll.find({'a' => { '$lt' => 10 }}, :sort => 'a').map{ |x| x }
docs = @coll.find({'a' => { '$lt' => 10 }}, :sort => 'a').to_a
assert_equal 4, docs.size
assert_equal 1, docs[0]['a']
assert_equal 2, docs[1]['a']
assert_equal 3, docs[2]['a']
assert_equal 4, docs[3]['a']
docs = @coll.find({'a' => { '$lt' => 10 }}, :sort => ['b', 'a']).map{ |x| x }
docs = @coll.find({'a' => { '$lt' => 10 }}, :sort => ['b', 'a']).to_a
assert_equal 4, docs.size
assert_equal 2, docs[0]['a']
assert_equal 4, docs[1]['a']
@ -151,14 +151,14 @@ class DBAPITest < Test::Unit::TestCase
assert_equal 3, docs[3]['a']
# Sorting using empty array; no order guarantee but should not blow up.
docs = @coll.find({'a' => { '$lt' => 10 }}, :sort => []).map{ |x| x }
docs = @coll.find({'a' => { '$lt' => 10 }}, :sort => []).to_a
assert_equal 4, docs.size
# Sorting using ordered hash. You can use an unordered one, but then the
# order of the keys won't be guaranteed thus your sort won't make sense.
oh = OrderedHash.new
oh['a'] = -1
docs = @coll.find({'a' => { '$lt' => 10 }}, :sort => oh).map{ |x| x }
docs = @coll.find({'a' => { '$lt' => 10 }}, :sort => oh).to_a
assert_equal 4, docs.size
assert_equal 4, docs[0]['a']
assert_equal 3, docs[1]['a']
@ -169,7 +169,7 @@ class DBAPITest < Test::Unit::TestCase
# oh = OrderedHash.new
# oh['b'] = -1
# oh['a'] = 1
# docs = @coll.find({'a' => { '$lt' => 10 }}, :sort => oh).map{ |x| x }
# docs = @coll.find({'a' => { '$lt' => 10 }}, :sort => oh).to_a
# assert_equal 4, docs.size
# assert_equal 1, docs[0]['a']
# assert_equal 3, docs[1]['a']
@ -182,17 +182,17 @@ class DBAPITest < Test::Unit::TestCase
@coll.insert('c' => 3)
@coll.insert('d' => 4)
docs = @coll.find({}, :limit => 1).map{ |x| x }
docs = @coll.find({}, :limit => 1).to_a
assert_equal 1, docs.size
docs = @coll.find({}, :limit => 2).map{ |x| x }
docs = @coll.find({}, :limit => 2).to_a
assert_equal 2, docs.size
docs = @coll.find({}, :limit => 3).map{ |x| x }
docs = @coll.find({}, :limit => 3).to_a
assert_equal 3, docs.size
docs = @coll.find({}, :limit => 4).map{ |x| x }
docs = @coll.find({}, :limit => 4).to_a
assert_equal 4, docs.size
docs = @coll.find({}).map{ |x| x }
docs = @coll.find({}).to_a
assert_equal 4, docs.size
docs = @coll.find({}, :limit => 99).map{ |x| x }
docs = @coll.find({}, :limit => 99).to_a
assert_equal 4, docs.size
end
@ -230,7 +230,7 @@ class DBAPITest < Test::Unit::TestCase
def test_collections_info
cursor = @db.collections_info
rows = cursor.map{ |x| x }
rows = cursor.to_a
assert rows.length >= 1
row = rows.detect { |r| r['name'] == @coll_full_name }
assert_not_nil row
@ -269,7 +269,7 @@ class DBAPITest < Test::Unit::TestCase
def test_array
@coll << {'b' => [1, 2, 3]}
rows = @coll.find({}, {:fields => ['b']}).map{ |x| x }
rows = @coll.find({}, {:fields => ['b']}).to_a
assert_equal 1, rows.length
assert_equal [1, 2, 3], rows[0]['b']
end
@ -277,7 +277,7 @@ class DBAPITest < Test::Unit::TestCase
def test_regex
regex = /foobar/i
@coll << {'b' => regex}
rows = @coll.find({}, {:fields => ['b']}).map{ |x| x }
rows = @coll.find({}, {:fields => ['b']}).to_a
assert_equal 1, rows.length
assert_equal regex, rows[0]['b']
end
@ -324,6 +324,21 @@ class DBAPITest < Test::Unit::TestCase
end
end
def test_to_a
cursor = @coll.find()
rows = cursor.to_a
# Make sure we get back exactly the same array the next time we ask
rows2 = cursor.to_a
assert_same rows, rows2
# Make sure we can still iterate after calling to_a
rows_with_each = cursor.collect{|row| row}
assert_equal rows, rows_with_each
# Make sure we can iterate more than once after calling to_a
end
def test_ismaster
assert @db.master?
end