2008-12-02 01:20:00 +00:00
|
|
|
= Introduction
|
|
|
|
|
|
|
|
This is a simple pure-Ruby driver for the 10gen Mongo DB. For more information
|
|
|
|
about Mongo, see http://www.mongodb.org.
|
|
|
|
|
2008-12-16 12:42:56 +00:00
|
|
|
Note: this driver is still alpha quality. The API will change, as may the
|
2008-12-04 21:38:04 +00:00
|
|
|
data saved to the database (especially primary key values). Do *_not_* use this
|
2008-12-16 12:42:56 +00:00
|
|
|
for any production data yet.
|
2008-12-04 21:38:04 +00:00
|
|
|
|
2008-12-02 01:21:22 +00:00
|
|
|
|
2008-12-02 01:20:00 +00:00
|
|
|
= Demo
|
|
|
|
|
2008-12-17 16:43:08 +00:00
|
|
|
$ ruby examples/simple.rb
|
2008-12-02 01:20:00 +00:00
|
|
|
|
|
|
|
Mongo must be running, of course.
|
|
|
|
|
2008-12-02 01:21:22 +00:00
|
|
|
|
2008-12-02 01:20:00 +00:00
|
|
|
= Testing
|
|
|
|
|
|
|
|
$ rake test
|
|
|
|
|
|
|
|
The tests assume that the Mongo database is running on the default port.
|
|
|
|
|
2008-12-02 01:21:22 +00:00
|
|
|
|
2008-12-04 22:02:19 +00:00
|
|
|
= Documentation
|
|
|
|
|
|
|
|
$ rake rdoc
|
|
|
|
|
|
|
|
Then open the file doc/index.html. (I need to figure out where to put this on
|
2008-12-16 12:42:56 +00:00
|
|
|
the Web, or perhaps how to publish this to the Wiki at
|
2008-12-04 22:02:19 +00:00
|
|
|
http://github.com/jimm/mongo-ruby-driver/wikis automatically.)
|
|
|
|
|
|
|
|
|
2008-12-02 15:45:02 +00:00
|
|
|
= 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
|
|
|
|
|
2008-12-16 22:08:15 +00:00
|
|
|
Added "strict" db attribute.
|
|
|
|
|
2008-12-04 21:38:04 +00:00
|
|
|
I plan to remove the auto-generation of _id primary keys.
|
|
|
|
|
|
|
|
If you ran tests using code before release
|
2008-12-02 15:45:02 +00:00
|
|
|
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*
|
|
|
|
|
|
|
|
|
2008-12-02 01:21:22 +00:00
|
|
|
= To Do
|
|
|
|
|
2008-12-17 16:03:09 +00:00
|
|
|
* Tests for update and repsert.
|
|
|
|
|
2008-12-16 22:35:31 +00:00
|
|
|
* 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
|
2008-12-16 22:19:53 +00:00
|
|
|
then find the master and, on each subsequent command, ask that machine if it
|
|
|
|
is the master before proceeding.
|
2008-12-16 22:08:15 +00:00
|
|
|
|
2008-12-09 18:00:14 +00:00
|
|
|
* Tests that prove that this driver's ObjectID and Geir's Java version do the
|
2008-12-16 12:42:56 +00:00
|
|
|
same thing. (I've done so manually.)
|
2008-12-09 18:00:14 +00:00
|
|
|
|
2008-12-08 13:23:24 +00:00
|
|
|
* Capped collection support.
|
|
|
|
|
2008-12-08 20:57:20 +00:00
|
|
|
* Support more types: REF, SYMBOL, CODE_W_SCOPE, etc.
|
2008-12-04 21:25:51 +00:00
|
|
|
|
|
|
|
* Introduce optional per-database and per-collection PKInjector.
|
|
|
|
|
2008-12-02 01:21:22 +00:00
|
|
|
* Synchronization.
|
|
|
|
|
|
|
|
* More tests.
|
|
|
|
|
2008-12-02 12:22:32 +00:00
|
|
|
* Implement Admin.
|
|
|
|
|
2008-12-08 20:57:20 +00:00
|
|
|
* Study src/main/ed/db/{dbcollection,dbcursor,db}.js and ByteEncoder.java in
|
|
|
|
the Babble code. That's what I should be writing to.
|
2008-12-02 12:22:32 +00:00
|
|
|
|
2008-12-02 01:21:22 +00:00
|
|
|
|
2008-12-05 21:39:00 +00:00
|
|
|
= Credits
|
|
|
|
|
|
|
|
Adrian Madrid, aemadrid@gmail.com
|
2009-01-06 15:49:18 +00:00
|
|
|
* bin/mongo_console
|
2008-12-05 21:39:00 +00:00
|
|
|
* examples/benchmarks.rb
|
|
|
|
* examples/irb.rb
|
2008-12-08 20:08:14 +00:00
|
|
|
* Modifications to examples/simple.rb
|
|
|
|
* Found plenty of bugs and missing features.
|
2009-01-06 15:49:18 +00:00
|
|
|
* Ruby 1.9 support.
|
|
|
|
* Gem support.
|
2008-12-08 20:08:14 +00:00
|
|
|
* Many other code suggestions and improvements.
|
2008-12-05 21:39:00 +00:00
|
|
|
|
|
|
|
|
2008-12-02 01:20:00 +00:00
|
|
|
= License
|
|
|
|
|
|
|
|
== Mongo Ruby Driver
|
|
|
|
|
|
|
|
Copyright (C) 2008 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.
|
|
|
|
|
2008-12-17 16:49:06 +00:00
|
|
|
See http://www.gnu.org/licenses for a copy of the GNU Affero General Public
|
2008-12-02 01:20:00 +00:00
|
|
|
License.
|