Monger is an idiomatic Clojure MongoDB driver with sane defaults, batteries included, well documented, low overhead
Find a file
Michael S. Klishin c109702117 Rewort $operator macros to evaluate to strings and not functions
Unlike Casbah and Korma, we already use query language data structures as close to what MongoDB uses as possible
(Clojure maps, vectors, numerics and strings are effectively JSON) so we don't need any layers on top, they won't improve
anything.

Having these operators is nice beacuse if you use atomic operators a lot, this will make sure Clojure compiler catches
typos for you. It is completely opt-in, however.

Finally, having a function inserted carries certain runtime performance cost and having $operator macros
that evaluate to themselves does not.

Per discussion with Alex.
2011-11-09 12:40:22 +04:00
examples Adding docs for major collection methods. 2011-09-11 16:13:29 +02:00
src/monger Rewort $operator macros to evaluate to strings and not functions 2011-11-09 12:40:22 +04:00
test Rewort $operator macros to evaluate to strings and not functions 2011-11-09 12:40:22 +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 Upgrade to MongoDB Java driver 2.7.0 2011-11-04 22:45:09 +04:00
README.md Update README.md 2011-11-04 10:26:32 +04:00

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.

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

Continuous Integration status

CI is hosted by travis-ci.org

Supported Clojure versions

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

License

Copyright (C) 2011 Michael S. Klishin

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