Elastisch, a Clojure client for ElasticSearch

Elastisch is a minimalistic Clojure client for ElasticSearch, a modern distributed search engine.

Project Goals

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

Community

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.

Project Maturity

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.

Artifacts

Elastisch artifacts are released to Clojars.

If you are using Maven, add the following repository definition to your pom.xml:

<repository>
  <id>clojars.org</id>
  <url>http://clojars.org/repo</url>
</repository>

The Most Recent Release

With Leiningen:

[clojurewerkz/elastisch "1.0.2"]

With Maven:

<dependency>
  <groupId>clojurewerkz</groupId>
  <artifactId>elastisch</artifactId>
  <version>1.0.2</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

Elastisch 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.

Continuous Integration

Development

ElasticSearch Setup

Elastisch needs ElasticSearch running locally (127.0.0.1). ES_CLUSTER_NAME need to be exported with the name of the local cluster. To find it out, use

curl http://localhost:9200/_cluster/nodes

Leiningen

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.

License

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

davie/elastisch