Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with
or
.
Download ZIP
An expressive Clojure client for Riak with batteries included
Clojure Other

README.md

Welle, a Clojure client for Riak

Welle is an expressive Clojure client for Riak with batteries included. Its API and code style closely follow other ClojureWerkz Clojure libraries, namely Langohr, Elastisch, Neocons, and Monger.

Project Goals

Project Maturity

Welle is a mature project that is over 2 years old and has been used to build systems that process terabytes of data per day.

Supported Features

Supported Clojure versions

Welle requires Clojure 1.4. The most recent stable Clojure release is highly recommended.

Supported Riak Versions

  • Welle 3.0 targets Riak 1.4+ and has breaking API changes compared to 2.0.
  • Welle 2.0 targets Riak 1.4+ and has breaking API changes compared to 1.5.
  • Welle 1.5 is compatible with Riak 1.3.0.

Getting Started

Please refer to our Getting Started with Clojure and Riak guide. Don't hesitate to join our mailing list and ask questions, too!

Community

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

Maven Artifacts

Welle artifacts are released to Clojars.

With Leiningen

Add dependency in your project.clj:

[com.novemberain/welle "3.0.0"]

With Maven

Add Clojars repository definition to your pom.xml:

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

and then the dependency:

<dependency>
  <groupId>com.novemberain</groupId>
  <artifactId>welle</artifactId>
  <version>3.0.0</version>
</dependency>

Documentation & Examples

Welle has documentation guides.

For additional code examples, see our test suite.

Welle Is a ClojureWerkz Project

Welle is part of the group of Clojure libraries known as ClojureWerkz, together with

and many others.

Project Maturity

Welle has been around since 2011. The API is generally stable with some (badly needed) breaking changes coming in 2.0.

Continuous Integration

Continuous Integration status

CI is hosted by travis-ci.org

Development

Welle 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-2015 Michael S. Klishin and the ClojureWerkz team.

Double licensed under the Eclipse Public License (the same as Clojure) or the Apache Public License 2.0.

Something went wrong with that request. Please try again.