Monger is an idiomatic Clojure MongoDB driver with sane defaults, batteries included, well documented, low overhead

Find a file

Michael S. Klishin 568efa4efc Time to bump to 1.0.0-SNAPSHOT We still need to add more tests & a few minor features to our query DSL, support authentication and refactor things here and there but the API is largely locked down and the jigsaw is falling into place. Per discussion with Alex.		2011-11-14 15:58:17 +04:00
examples	Adding docs for major collection methods.	2011-09-11 16:13:29 +02:00
src/monger	Merge branch 'master' into query-dsl	2011-11-14 15:23:47 +04:00
test	Merge branch 'master' into query-dsl	2011-11-14 15:23:47 +04:00
.gitignore	A typo	2011-10-14 01:00:50 +04:00
.travis.yml	Of course we will be using travis-ci.org	2011-09-11 14:40:15 +04:00
project.clj	Time to bump to 1.0.0-SNAPSHOT	2011-11-14 15:58:17 +04:00
README.md	Add monger.query DSL example to the README	2011-11-14 15:22:12 +04:00

README.md

Monger

Monger is an idiomatic Clojure wrapper around MongoDB Java driver.

Project Goals

There is one MongoDB client for Clojure that has been around since 2009. So, why create another one? Monger authors wanted a client that will

Support most of MongoDB 2.0+ features but only those that really matter. Grouping the way it is done today, for example, does not (it is easier to just use Map/Reduce directly).
Be well documented.
Be well tested.
Be maintained, not carry technical debt from 2009 forever.
Integrate with libraries like clojure.data.json and Joda Time.
Integrate usage of JavaScript files and ClojureScript (as soon as the compiler gets artifact it is possible to depend on for easy embedding).
Learn from other clients like the Java and Ruby ones.
Target Clojure 1.3.0 and later from the ground up.

Usage

We are working on documentation guides & examples site for the 1.0 release. Please refer to the test suite for code examples.

Here is what monger.query DSL looks like right now:

(with-collection "docs"
  (find { :inception_year { $lt 2000 $gte 2011 } })
  (fields { :inception_year 1 :name 1 })
  (skip 10)
  (limit 20)
  (batch-size 50)
  (hint "my-index-name")
  (snapshot))

More code examples can be found in our test suite.

This is a Work In Progress

Core Monger APIs are stabilized but it is still a work in progress. Keep that in mind. 1.0 will be released in late 2011.

Artifacts

Snapshot artifacts are released to Clojars every 24 hours.

With Leiningen:

[com.novemberain/monger "0.11.0-SNAPSHOT"]

With Maven:

<dependency>
  <groupId>com.novemberain</groupId>
  <artifactId>monger</artifactId>
  <version>0.11.0-SNAPSHOT</version>
</dependency>

Continuous Integration

CI is hosted by travis-ci.org

Supported Clojure versions

Monger is built from the ground up for Clojure 1.3 and up.

License

Distributed under the Eclipse Public License, the same as Clojure.