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

Find a file

Oleksandr Petrov 7ab8d51a84 Adding missing $nin operator.		2012-01-25 21:56:06 +01:00
docs	Commenting code, adding docs.	2011-12-03 18:39:17 +01:00
examples	Adding docs for major collection methods.	2011-09-11 16:13:29 +02:00
src/monger	Adding missing $nin operator.	2012-01-25 21:56:06 +01:00
test	Adding missing $nin operator.	2012-01-25 21:56:06 +01: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	Exclude Clojure dependency for clojure.data.json	2011-11-28 21:05:32 +04:00
README.md	Add monger.query DSL example to the README	2011-11-14 15:22:12 +04:00
todo.md	Adding some items for todo.	2011-11-30 22:07:53 +01: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.