=======
gomongo
=======
Go driver for `MongoDB`_, a document based database which is being used in
`production`_ with great success.

Read this `article` to know more.


.. _MongoDB: http://www.mongodb.org/
.. _production: http://www.mongodb.org/display/DOCS/Production+Deployments
.. _article: http://go.hokapoka.com/golang/mongodb-golang-gomongo/


Installation
============
The easiest way to install it's through `goinstall` which automatically installs
the third libraries::

	$ [sudo -E] goinstall github.com/mikejs/gomongo/mongo

Example usage
-------------

	package main

	import "github.com/mikejs/gomongo/mongo"


	func main() {
		conn, _ := mongo.Connect("127.0.0.1")
		collection := conn.GetDB("test").GetCollection("test_collection")

		doc, _ := mongo.Marshal(map[string]string{
			"_id":     "doc1",
			"title":   "A Mongo document",
			"content": "Testing, 1. 2. 3.",
		})
		collection.Insert(doc)

		query, _ := mongo.Marshal(map[string]string{"_id": "doc1"})
		got, _ := collection.FindOne(query)
		mongo.Equal(doc, got) // true!

		collection.Drop()
	}