Monger, a modern Clojure MongoDB Driver

It has batteries included, offers powerful expressive query DSL, strives to support every MongoDB 3.6+ feature and has sane defaults. Monger for modern Clojure and sits on top of the official MongoDB Java driver.

Immediate TODOs

• [ ] mark deprecated methods in 3.9
• [x] $pushAll deprecated for {$push {:tag {$each ["value1" "value2"]}}}
• [ ] transactions (in-progress)
• [x] SCRAM-256 authentication
• [ ] change streams -> see MongoDatabase.watch and MongoClient.watch
• [x] retryWrites options on 3.6+ -- deprecation of other options.
• [x] make all tests pass

Open a pull request to add to this list, we will be checking these off once complete.

Project Goals

• Support most modern MongoDB features.
• Be well documented.
• Be well tested.
• Be as close to the Mongo shell query language as practical
• Integrate with libraries like Joda Time, Cheshire, Ragtime.
• Support URI connections.
• Support only latest version of Clojure.

Artifacts

Monger artifacts are released to Clojars.

[com.novemberain/monger "3.1.0"]

Getting Started

Please refer to our Getting Started guide. Don't hesitate to join our mailing list and ask questions, too!

Documentation & Examples

Please see our documentation guides site and API reference.

Our test suite also has many code examples.

Supported Clojure versions

Monger requires Clojure 1.9+.

Development

Monger uses Leiningen 2. Make sure you have it installed and then run tests against supported Clojure versions using

lein exec -p bin/ci/before_script.sh
lein test

Then create a branch and make your changes on it. Once you are done with your changes and all tests pass, submit a pull request on Github.

License

Copyright (C) 2011-2018 Michael S. Klishin, Alex Petrov, and the ClojureWerkz team.

Double licensed under the Eclipse Public License (the same as Clojure) or the Apache Public License 2.0.