mongo 1.7.1 → 1.8.0

data/VERSION

@@ -0,0 +1 @@
+1.8.0

data/bin/mongo_console

@@ -10,12 +10,12 @@ require 'mongo'
 include Mongo
 
 host = org_argv[0] || ENV['MONGO_RUBY_DRIVER_HOST'] || 'localhost'
-port = org_argv[1] || ENV['MONGO_RUBY_DRIVER_PORT'] || Connection::DEFAULT_PORT
+port = org_argv[1] || ENV['MONGO_RUBY_DRIVER_PORT'] || MongoClient::DEFAULT_PORT
 dbnm = org_argv[2] || ENV['MONGO_RUBY_DRIVER_DB']   || 'ruby-mongo-console'
 
-puts "Connecting to #{host}:#{port} (CONN) on with database #{dbnm} (DB)"
-CONN = Connection.new(host, port)
-DB = CONN.db(dbnm)
+puts "Connecting to #{host}:#{port} (CLIENT) on with database #{dbnm} (DB)"
+CLIENT = MongoClient.new(host, port)
+DB = CLIENT.db(dbnm)
 
 puts "Starting IRB session..."
 IRB.start(__FILE__)

data/examples/admin.rb

@@ -0,0 +1,43 @@
+$:.unshift(File.join(File.dirname(__FILE__), '..', 'lib'))
+
+require 'mongo'
+require 'pp'
+
+include Mongo
+
+host = ENV['MONGO_RUBY_DRIVER_HOST'] || 'localhost'
+port = ENV['MONGO_RUBY_DRIVER_PORT'] || MongoClient::DEFAULT_PORT
+
+puts "Connecting to #{host}:#{port}"
+client  = MongoClient.new(host, port)
+db   = client.db('ruby-mongo-examples')
+coll = db.create_collection('test')
+
+# Erase all records from collection, if any
+coll.remove
+
+admin = client['admin']
+
+# Profiling level set/get
+puts "Profiling level: #{admin.profiling_level}"
+
+# Start profiling everything
+admin.profiling_level = :all
+
+# Read records, creating a profiling event
+coll.find().to_a
+
+# Stop profiling
+admin.profiling_level = :off
+
+# Print all profiling info
+pp admin.profiling_info
+
+# Validate returns a hash if all is well and
+# raises an exception if there is a problem.
+info = db.validate_collection(coll.name)
+puts "valid = #{info['ok']}"
+puts info['result']
+
+# Destroy the collection
+coll.drop

data/examples/capped.rb

@@ -0,0 +1,22 @@
+$:.unshift(File.join(File.dirname(__FILE__), '..', 'lib'))
+require 'mongo'
+
+include Mongo
+
+host = ENV['MONGO_RUBY_DRIVER_HOST'] || 'localhost'
+port = ENV['MONGO_RUBY_DRIVER_PORT'] || MongoClient::DEFAULT_PORT
+
+puts "Connecting to #{host}:#{port}"
+db = MongoClient.new(host, port).db('ruby-mongo-examples')
+db.drop_collection('test')
+
+# A capped collection has a max size and, optionally, a max number of records.
+# Old records get pushed out by new ones once the size or max num records is reached.
+coll = db.create_collection('test', :capped => true, :size => 1024, :max => 12)
+
+100.times { |i| coll.insert('a' => i+1) }
+
+# We will only see the last 12 records
+coll.find().each { |row| p row }
+
+coll.drop

data/examples/cursor.rb

@@ -0,0 +1,48 @@
+$:.unshift(File.join(File.dirname(__FILE__), '..', 'lib'))
+
+require 'mongo'
+require 'pp'
+
+include Mongo
+
+host = ENV['MONGO_RUBY_DRIVER_HOST'] || 'localhost'
+port = ENV['MONGO_RUBY_DRIVER_PORT'] || MongoClient::DEFAULT_PORT
+
+puts "Connecting to #{host}:#{port}"
+db = MongoClient.new(host, port).db('ruby-mongo-examples')
+coll = db.collection('test')
+
+# Erase all records from collection, if any
+coll.remove
+
+# Insert 3 records
+3.times { |i| coll.insert({'a' => i+1}) }
+
+# Cursors don't run their queries until you actually attempt to retrieve data
+# from them.
+
+# Find returns a Cursor, which is Enumerable. You can iterate:
+coll.find().each { |row| pp row }
+
+# You can turn it into an array:
+array = coll.find().to_a
+
+# You can iterate after turning it into an array (the cursor will iterate over
+# the copy of the array that it saves internally.)
+cursor = coll.find()
+array = cursor.to_a
+cursor.each { |row| pp row }
+
+# You can get the next object
+first_object = coll.find().next_document
+
+# next_document returns nil if there are no more objects that match
+cursor = coll.find()
+obj = cursor.next_document
+while obj
+  pp obj
+  obj = cursor.next_document
+end
+
+# Destroy the collection
+coll.drop

data/examples/gridfs.rb

@@ -0,0 +1,44 @@
+$:.unshift(File.join(File.dirname(__FILE__), '..', 'lib'))
+def assert
+  raise "Failed!" unless yield
+end
+
+require 'mongo'
+include Mongo
+
+host = ENV['MONGO_RUBY_DRIVER_HOST'] || 'localhost'
+port = ENV['MONGO_RUBY_DRIVER_PORT'] || MongoClient::DEFAULT_PORT
+
+puts "Connecting to #{host}:#{port}"
+db = MongoClient.new(host, port).db('ruby-mongo-examples')
+
+data = "hello, world!"
+
+grid = Grid.new(db)
+
+# Write a new file. data can be a string or an io object responding to #read.
+id = grid.put(data, :filename => 'hello.txt')
+
+# Read it and print out the contents
+file = grid.get(id)
+puts file.read
+
+# Delete the file
+grid.delete(id)
+
+begin
+grid.get(id)
+rescue => e
+  assert {e.class == Mongo::GridError}
+end
+
+# Metadata
+id = grid.put(data, :filename => 'hello.txt', :content_type => 'text/plain', :metadata => {'name' => 'hello'})
+file = grid.get(id)
+
+p file.content_type
+p file.metadata.inspect
+p file.chunk_size
+p file.file_length
+p file.filename
+p file.data

data/examples/index_test.rb

@@ -0,0 +1,126 @@
+$:.unshift(File.join(File.dirname(__FILE__), '..', 'lib'))
+
+require 'mongo'
+
+include Mongo
+
+host = ENV['MONGO_RUBY_DRIVER_HOST'] || 'localhost'
+port = ENV['MONGO_RUBY_DRIVER_PORT'] || MongoClient::DEFAULT_PORT
+
+puts ">> Connecting to #{host}:#{port}"
+db = MongoClient.new(host, port).db('ruby-mongo-index_test')
+
+class Exception
+  def errmsg
+    "%s: %s\n%s" % [self.class, message, (backtrace || []).join("\n") << "\n"]
+  end
+end
+
+puts ">> Dropping collection test"
+begin
+  res = db.drop_collection('test')
+  puts "dropped : #{res.inspect}"
+rescue => e
+  puts "Error: #{e.errmsg}"
+end
+
+puts ">> Creating collection test"
+begin
+  coll = db.collection('test')
+  puts "created : #{coll.inspect}"
+rescue => e
+  puts "Error: #{e.errmsg}"
+end
+
+OBJS_COUNT = 100
+
+puts ">> Generating test data"
+msgs = %w{hola hello aloha ciao}
+arr = (0...OBJS_COUNT).collect {|x| { :number => x, :rndm => (rand(5)+1), :msg => msgs[rand(4)] }}
+puts "generated"
+
+puts ">> Inserting data (#{arr.size})"
+coll.insert(arr)
+puts "inserted"
+
+puts ">> Creating index"
+#res = coll.create_index "all", :_id => 1, :number => 1, :rndm => 1, :msg => 1
+res = coll.create_index [[:number, 1], [:rndm, 1], [:msg, 1]]
+puts "created index: #{res.inspect}"
+# ============================ Mongo Log ============================
+# Fri Dec  5 14:45:02 Adding all existing records for ruby-mongo-console.test to new index
+# ***
+# Bad data or size in BSONElement::size()
+# bad type:30
+# totalsize:11 fieldnamesize:4
+# lastrec:
+# Fri Dec  5 14:45:02 ruby-mongo-console.system.indexes Assertion failure false jsobj.cpp a0
+# Fri Dec  5 14:45:02  database: ruby-mongo-console op:7d2 0
+# Fri Dec  5 14:45:02  ns: ruby-mongo-console.system.indexes
+
+puts ">> Gathering index information"
+begin
+  res = coll.index_information
+  puts "index_information : #{res.inspect}"
+rescue => e
+  puts "Error: #{e.errmsg}"
+end
+# ============================ Console Output ============================
+# RuntimeError: Keys for index on return from db was nil. Coll = ruby-mongo-console.test
+#         from ./bin/../lib/mongo/db.rb:135:in `index_information'
+#         from (irb):11:in `collect'
+#         from ./bin/../lib/mongo/cursor.rb:47:in `each'
+#         from ./bin/../lib/mongo/db.rb:130:in `collect'
+#         from ./bin/../lib/mongo/db.rb:130:in `index_information'
+#         from ./bin/../lib/mongo/collection.rb:74:in `index_information'
+#         from (irb):11
+
+puts ">> Dropping index"
+begin
+  res = coll.drop_index "number_1_rndm_1_msg_1"
+  puts "dropped : #{res.inspect}"
+rescue => e
+  puts "Error: #{e.errmsg}"
+end
+
+# ============================ Console Output ============================
+# => {"nIndexesWas"=>2.0, "ok"=>1.0}
+# ============================ Mongo Log ============================
+# 0x41802a 0x411549 0x42bac6 0x42c1f6 0x42c55b 0x42e6f7 0x41631e 0x41a89d 0x41ade2 0x41b448 0x4650d2 0x4695ad
+#  db/db(_Z12sayDbContextPKc+0x17a) [0x41802a]
+#  db/db(_Z8assertedPKcS0_j+0x9) [0x411549]
+#  db/db(_ZNK11BSONElement4sizeEv+0x1f6) [0x42bac6]
+#  db/db(_ZN7BSONObj8getFieldEPKc+0xa6) [0x42c1f6]
+#  db/db(_ZN7BSONObj14getFieldDottedEPKc+0x11b) [0x42c55b]
+#  db/db(_ZN7BSONObj19extractFieldsDottedES_R14BSONObjBuilder+0x87) [0x42e6f7]
+#  db/db(_ZN12IndexDetails17getKeysFromObjectER7BSONObjRSt3setIS0_St4lessIS0_ESaIS0_EE+0x24e) [0x41631e]
+#  db/db(_Z12_indexRecordR12IndexDetailsR7BSONObj7DiskLoc+0x5d) [0x41a89d]
+#  db/db(_Z18addExistingToIndexPKcR12IndexDetails+0xb2) [0x41ade2]
+#  db/db(_ZN11DataFileMgr6insertEPKcPKvib+0x508) [0x41b448]
+#  db/db(_Z14receivedInsertR7MessageRSt18basic_stringstreamIcSt11char_traitsIcESaIcEE+0x112) [0x4650d2]
+#  db/db(_Z10connThreadv+0xb4d) [0x4695ad]
+# Fri Dec  5 14:45:02 ruby-mongo-console.system.indexes  Caught Assertion insert, continuing
+# Fri Dec  5 14:47:59 CMD: deleteIndexes ruby-mongo-console.test
+#   d->nIndexes was 2
+#   alpha implementation, space not reclaimed
+
+puts ">> Gathering index information"
+begin
+  res = coll.index_information
+  puts "index_information : #{res.inspect}"
+rescue => e
+  puts "Error: #{e.errmsg}"
+end
+# ============================ Console Output ============================
+# RuntimeError: Keys for index on return from db was nil. Coll = ruby-mongo-console.test
+#         from ./bin/../lib/mongo/db.rb:135:in `index_information'
+#         from (irb):15:in `collect'
+#         from ./bin/../lib/mongo/cursor.rb:47:in `each'
+#         from ./bin/../lib/mongo/db.rb:130:in `collect'
+#         from ./bin/../lib/mongo/db.rb:130:in `index_information'
+#         from ./bin/../lib/mongo/collection.rb:74:in `index_information'
+#         from (irb):15
+
+puts ">> Closing connection"
+db.close
+puts "closed"

data/examples/info.rb

@@ -0,0 +1,31 @@
+$:.unshift(File.join(File.dirname(__FILE__), '..', 'lib'))
+
+require 'mongo'
+
+include Mongo
+
+host = ENV['MONGO_RUBY_DRIVER_HOST'] || 'localhost'
+port = ENV['MONGO_RUBY_DRIVER_PORT'] || MongoClient::DEFAULT_PORT
+
+puts "Connecting to #{host}:#{port}"
+db = MongoClient.new(host, port).db('ruby-mongo-examples')
+coll = db.collection('test')
+
+# Erase all records from collection, if any
+coll.remove
+
+# Insert 3 records
+3.times { |i| coll.insert({'a' => i+1}) }
+
+# Collection names in database
+p db.collection_names
+
+# More information about each collection
+p db.collections_info
+
+# Index information
+coll.create_index('a')
+p db.index_information('test')
+
+# Destroy the collection
+coll.drop

data/examples/queries.rb

@@ -0,0 +1,74 @@
+$:.unshift(File.join(File.dirname(__FILE__), '..', 'lib'))
+
+require 'mongo'
+require 'pp'
+
+include Mongo
+
+host = ENV['MONGO_RUBY_DRIVER_HOST'] || 'localhost'
+port = ENV['MONGO_RUBY_DRIVER_PORT'] || MongoClient::DEFAULT_PORT
+
+puts "Connecting to #{host}:#{port}"
+db = MongoClient.new(host, port).db('ruby-mongo-examples')
+coll = db.collection('test')
+
+# Remove all records, if any
+coll.remove
+
+# Insert three records
+coll.insert('a' => 1)
+coll.insert('a' => 2)
+coll.insert('b' => 3)
+coll.insert('c' => 'foo')
+coll.insert('c' => 'bar')
+
+# Count.
+puts "There are #{coll.count} records."
+
+# Find all records. find() returns a Cursor.
+puts "Find all records:"
+pp cursor = coll.find.to_a
+
+# Print them. Note that all records have an _id automatically added by the
+# database. See pk.rb for an example of how to use a primary key factory to
+# generate your own values for _id.
+puts "Print each document individually:"
+pp cursor.each { |row| pp row }
+
+# See Collection#find. From now on in this file, we won't be printing the
+# records we find.
+puts "Find one record:"
+pp coll.find('a' => 1).to_a
+
+# Find records sort by 'a', skip 1, limit 2 records.
+# Sort can be single name, array, or hash.
+puts "Skip 1, limit 2, sort by 'a':"
+pp coll.find({}, {:skip => 1, :limit => 2, :sort => 'a'}).to_a
+
+# Find all records with 'a' > 1. There is also $lt, $gte, and $lte.
+coll.find({'a' => {'$gt' => 1}})
+coll.find({'a' => {'$gt' => 1, '$lte' => 3}})
+
+# Find all records with 'a' in a set of values.
+puts "Find all records where a is $in [1, 2]:"
+pp coll.find('a' => {'$in' => [1,2]}).to_a
+
+puts "Find by regex:"
+pp coll.find({'c' => /f/}).to_a
+
+# Print query explanation
+puts "Print an explain:"
+pp coll.find({'c' => /f/}).explain
+
+# Use a hint with a query. Need an index. Hints can be stored with the
+# collection, in which case they will be used with all queries, or they can be
+# specified per query, in which case that hint overrides the hint associated
+# with the collection if any.
+coll.create_index('c')
+coll.hint = 'c'
+
+puts "Print an explain with index:"
+pp coll.find('c' => /[f|b]/).explain
+
+puts "Print an explain with natural order hint:"
+pp coll.find({'c' => /[f|b]/}, :hint => '$natural').explain

data/examples/replica_set.rb

@@ -0,0 +1,26 @@
+# This code assumes a running replica set with at least one node at localhost:27017.
+require 'mongo'
+
+include Mongo
+
+cons = []
+
+10.times do
+  cons << MongoReplicaSetClient(['localhost:27017'], :read => :secondary)
+end
+
+ports = cons.map do |con|
+  con.read_pool.port
+end
+
+puts "These ten connections will read from the following ports:"
+p ports
+
+cons[rand(10)]['foo']['bar'].remove
+100.times do |n|
+  cons[rand(10)]['foo']['bar'].insert({:a => n})
+end
+
+100.times do |n|
+  p cons[rand(10)]['foo']['bar'].find_one({:a => n})
+end

data/examples/simple.rb

@@ -0,0 +1,25 @@
+$:.unshift(File.join(File.dirname(__FILE__), '..', 'lib'))
+
+require 'rubygems'
+require 'mongo'
+
+include Mongo
+
+host = ENV['MONGO_RUBY_DRIVER_HOST'] || 'localhost'
+port = ENV['MONGO_RUBY_DRIVER_PORT'] || MongoClient::DEFAULT_PORT
+
+puts "Connecting to #{host}:#{port}"
+db = MongoClient.new(host, port).db('ruby-mongo-examples')
+coll = db.collection('test')
+
+# Erase all records from collection, if any
+coll.remove
+
+# Insert 3 records
+3.times { |i| coll.insert({'a' => i+1}) }
+
+puts "There are #{coll.count()} records in the test collection. Here they are:"
+coll.find().each { |doc| puts doc.inspect }
+
+# Destroy the collection
+coll.drop