89 lines
2.0 KiB
Plaintext
89 lines
2.0 KiB
Plaintext
= 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:
|