Monger, a modern Clojure MongoDB Driver
Monger is an idiomatic Clojure MongoDB driver for a more civilized age.
It has batteries included, offers powerful expressive query DSL, strives to support modern MongoDB features and have the "look and feel" and flexibility of the MongoDB shell.
Monger is built from for modern Clojure versions and sits on top of the official MongoDB Java driver.
There is one MongoDB client for Clojure that has been around since 2009. So, why create another one? Monger authors wanted a client that would
- Support most of modern MongoDB features, focus on those that really matter.
- Be well documented.
- Be well tested.
- Target modern Clojure versions.
- Be as close to the Mongo shell query language as practical
- Integrate with libraries like Joda Time, Cheshire, clojure.data.json, Ragtime.
- Support URI connections to be friendly to Heroku and other PaaS providers.
- Not carry technical debt from 2009 forever.
Monger is not a young project: started in July 2011, it is over 7 years old with active production use from week 1.
Monger artifacts are released to
Clojars. If you are using
Maven, add the following repository definition to your
<repository> <id>clojars.org</id> <url>http://clojars.org/repo</url> </repository>
The Most Recent Release
<dependency> <groupId>com.novemberain</groupId> <artifactId>monger</artifactId> <version>3.5.0</version> </dependency>
Documentation & Examples
Our test suite also has many code examples.
Monger has a mailing list. Feel free to join it and ask any questions you may have.
To subscribe for announcements of releases, important changes and so on, please follow @ClojureWerkz on Twitter.
Supported Clojure versions
Monger requires Clojure 1.8+. The most recent stable release is highly recommended.
Continuous Integration Status
Monger Is a ClojureWerkz Project
Monger uses Leiningen 2. Make sure you have it installed and then run tests against supported Clojure versions using
./bin/ci/before_script.sh lein all do clean, javac, 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.
Copyright (C) 2011-2018 Michael S. Klishin, Alex Petrov, and the ClojureWerkz team.