Ruby driver for MongoDB
26b88efd3b
- Make sure Query#fields returns a hash, not an array. - Fix query limit by passing limit number to cursor and having it enforce the limit. (Database returns limit as first batch, but will continue to return data after the limit if requested.) Improvements: - Query#new can take a single field name instead of an array - A few doc comment improvements here and there. |
||
|---|---|---|
| bin | ||
| examples | ||
| lib | ||
| tests | ||
| .gitignore | ||
| Rakefile | ||
| README.rdoc | ||
= Introduction
This is a simple pure-Ruby driver for the 10gen Mongo DB. For more information
about Mongo, see http://www.mongodb.org.
Note: this driver is still alpha quality. The API will change, as may the
data saved to the database (especially primary key values). Do *_not_* use this
for any production data yet.
= Demo
$ ruby examples/simple.rb
Mongo must be running, of course.
= Testing
$ rake test
The tests assume that the Mongo database is running on the default port.
= Documentation
$ rake rdoc
Then open the file doc/index.html. (I need to figure out where to put this on
the Web, or perhaps how to publish this to the Wiki at
http://github.com/jimm/mongo-ruby-driver/wikis automatically.)
= The Code
Most of this code was transliterated from Geir Magnusson Jr's Java Mongo
driver, which can be found at
http://github.com/geir/mongo-java-driver/tree/master.
== Release Notes
Added "strict" db attribute.
I plan to remove the auto-generation of _id primary keys.
If you ran tests using code before release
http://github.com/jimm/mongo-ruby-driver/commit/4244f56ce6c7044a1ce096843eb991856422c0cc
then the DB API tests might fail the first time you run it. If that doesn't
clear up the failed test, you might have to delete your database. To do that,
type
$ rm /data/db/ruby-mongo-test*
= To Do
* Only update message sizes once, not after every write of a value. This will
require an explicit call to update_message_length in each message subclass.
* Tests for update and repsert.
* Add a way to specify a collection of databases on startup (a simple array of
IP address/port numbers, perhaps, or a hash or something). The driver would
then find the master and, on each subsequent command, ask that machine if it
is the master before proceeding.
* Tests that prove that this driver's ObjectID and Geir's Java version do the
same thing. (I've done so manually.)
* Capped collection support.
* Support more types: REF, SYMBOL, CODE_W_SCOPE, etc.
* Introduce optional per-database and per-collection PKInjector.
* Synchronization.
* More tests.
* Implement Admin.
* Study src/main/ed/db/{dbcollection,dbcursor,db}.js and ByteEncoder.java in
the Babble code. That's what I should be writing to.
= Credits
Adrian Madrid, aemadrid@gmail.com
* bin/mongo_console
* examples/benchmarks.rb
* examples/irb.rb
* Modifications to examples/simple.rb
* Found plenty of bugs and missing features.
* Ruby 1.9 support.
* Gem support.
* Many other code suggestions and improvements.
= License
== Mongo Ruby Driver
Copyright (C) 2008-2009 10gen Inc.
This program is free software: you can redistribute it and/or modify it under
the terms of the GNU Affero General Public License, version 3, as published by
the Free Software Foundation.
This program is distributed in the hope that it will be useful, but WITHOUT
ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
FOR A PARTICULAR PURPOSE. See the GNU Affero General Public License for more
details.
See http://www.gnu.org/licenses for a copy of the GNU Affero General Public
License.