mongo-ruby-driver

Ruby driver for MongoDB

Go to file

Jim Menard abd65c5c94 More to-do items		2008-12-04 16:25:51 -05:00
examples	Added ObjectID class. Fixed BSON object serialization bug. db.count now works.	2008-12-01 20:01:13 -05:00
lib	Add _id to inserted records. Fixed ObjectID load, save, and generation.	2008-12-04 08:37:42 -05:00
tests	Fixed bug in BSON serializer: was forgetting to include NUL byt in string length.	2008-12-02 10:25:36 -05:00
README	More to-do items	2008-12-04 16:25:51 -05:00
Rakefile	Added call to db.count to example. Need to see why it's not working.	2008-12-01 19:36:20 -05:00

README

= Introduction

This is a simple pure-Ruby driver for the 10gen Mongo DB. For more information
about Mongo, see http://www.mongodb.org.


= Demo

  $ ruby examples/demo.rb

Mongo must be running, of course.


= Testing

  $ rake test

The tests assume that the Mongo database is running on the default port.


= 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

If you ran tests using code before relase
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

* More code comments. More text in this file.

* Rake task for rdoc generation.

* Remove default _id generation.

* Introduce optional per-database and per-collection PKInjector.

* Synchronization.

* More tests.

* Implement Admin.

* See FIXME in db test.


= 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.

See http://www.gnu.org/licenses/ for a copy of the GNU Affero General Public
License.

== UUID

This driver uses the UUID generator by Assaf Arkin and Eric Hodel, which uses
the MIT license (see the top of the file lib/mongo/util/uuid.rb).

== MAC Address Finder

This driver uses the MAC address finder found at
http://codeforpeople.com/lib/ruby/macaddr/macaddr-1.0.0/lib/macaddr.rb, which
uses Ruby's license (see http://codeforpeople.com/lib/license.txt).

# Local Variables:
# mode:rdoc
# End: