Elastisch, a Clojure client for ElasticSearch
Elastisch is a minimalistic Clojure client for ElasticSearch, a modern distributed RESTful search engine.
- Be reasonably feature complete
- Be well documented
- Be well tested
- Closely follow ElasticSearch API structure, no new abstractions introduced
- Follow recent ElasticSearch releases & developments
- Target Clojure 1.3.0 and later from the ground up
Elastisch 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.
Elastisch is a not a young project. About a year old, it has been used in production since early days. Elastisch API is stabilized. 1.0 has been released in September 2012.
Elastisch 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>clojurewerkz</groupId> <artifactId>elastisch</artifactId> <version>1.0.0</version> </dependency>
Documentation & Examples
Please see our documentation guides site.
Our test suite also has many code examples.
Supported Clojure versions
Elastisch is built from the ground up for Clojure 1.3 and up. Clojure 1.4 is highly recommended.
Elastisch Is a ClojureWerkz Project
Elastisch uses Leiningen 2. Make sure you have it installed and then run tests against all supported Clojure versions using
lein2 all 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-2012 Alex Petrov, Michael S. Klishin
Distributed under the Eclipse Public License, the same as Clojure.
Why Not Just Wrap the Java Client?
Wrapping ES Java client may result in some performance gain but we don't see it to be great enough to be a significant factor for Elastisch. Following Java client conventions would likely make Elastisch less Clojuric.