Elastisch, a Clojure client for ElasticSearch
Elastisch is a minimalistic Clojure client for ElasticSearch, a modern distributed 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.2</version> </dependency>
The Most Recent Preview Release
<dependency> <groupId>clojurewerkz</groupId> <artifactId>elastisch</artifactId> <version>1.1.0-beta2</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. The most recent stable release is highly recommended.
REST and Native Clients
1.0 only offers a REST API client. Elastisch
1.1 will feature
a native (transport) client with nearly identical API.
Elastisch Is a ClojureWerkz Project
Elastisch is part of the group of Clojure libraries known as ClojureWerkz, together with
and several others.
Elastisch needs ElasticSearch running locally (
ES_CLUSTER_NAME need to be exported
with the name of the local cluster. To find it out, use
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-2013 Alex Petrov, Michael S. Klishin
Distributed under the Eclipse Public License, the same as Clojure.