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
- Support multiple transports: HTTP, native ES client, possibly more (e.g. Memcached)
- Follow recent Elasticsearch releases & developments
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. Started in late 2011, it has been used in production since the early days. Elastisch API is stable. 1.0 was released in September 2012, 2.0 in June 2014, 3.0 in December 2018.
Supported ElasticSearch Versions
Elastisch 6.x (master) targets ElasticSearch 6.x (and 5.x to the extent possible).
Elastisch 3.x focuses on Elasticsearch 2.x support.
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 3.x Release
Note: Elastisch documentation is not currently updated for version 3.0.
With Leiningen:
[clojurewerkz/elastisch "3.0.1"]
With Maven:
<dependency>
<groupId>clojurewerkz</groupId>
<artifactId>elastisch</artifactId>
<version>3.0.1</version>
</dependency>
Documentation & Examples
Please see our documentation guides site. Note: Elastisch documentation is not currently updated for version 3.0.
Our test suite also has many code examples.
Supported Clojure Versions
Elastisch requires Clojure 1.6. The most recent stable release is highly recommended.
Supported Elasticsearch Versions
Elastisch 2.1 and 2.2 target Elasticsearch 1.x starting with 1.1 and through 1.7.x. Elastisch master provides Elasticsearch 3.x compatibility but not every ElasticSearch 3.0+ feature.
ElasticSearch 5.0 support will be available in a future version.
REST and Native Clients
Elastisch provides HTTP and native (transport) clients with nearly
identical API as of 1.1.0
.
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/_nodes/cluster
Running Tests
To run Elastisch tests, make sure you have Elasticsearch running. It must be the same version that Elastisch depends on due to binary protocol changes between releases. project.clj or project page on Clojars can help find that out.
Finally, run all tests with
lein all test
To run only HTTP client tests, use
lein all test :ci
Leiningen
Elastisch uses Leiningen 2. Make sure you have it installed and then run tests against all supported Clojure versions using
lein 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
Copyright (c) 2011-2019 Alex Petrov, Michael S. Klishin, and the ClojureWerkz Team.
Double-licensed under the Eclipse Public License (the same as Clojure) and Apache Public License 2.0.