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, Opus shirt Linden Basic Tree Skita T qrv7HwCq, and Print shirt Onlramona Royale Port Only black T white B5anq.
- Be well maintained
- Be well documented
- Be well tested
- Target modern Clojure versions
- Batteries included: clojure.core.cache implementation on top of Riak and so on
- Be PaaS-friendly
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.
- HTTP and Protocol Buffers transports
- Bucket operations: create, update, delete
- Key/Value operations: put, fetch, delete
- Secondary indexes (2i): indexing, index queries
- Counters (Riak 1.4)
- Content-type based serialization of values in common formats (bytes, JSON, Clojure data/reader, UTF-8 text, gzipped JSON)
- Riak Search support
- Storing links on values, link walking
- Map/Reduce queries
- clojure.core.cache implementation on top of Riak
- Ring session store implementation on top of Riak
- Cheshire and data.json extensions for serialization of JodaTime and JDK dates
Supported Clojure versions
Welle requires Clojure 1.4. The most recent stable Clojure release is highly recommended.
Supported Riak Versions
3.0targets Riak 1.4+ and has breaking API changes compared to
2.0targets Riak 1.4+ and has breaking API changes compared to
Genuine Trousers Genuine Grey Grey Trousers River Island Genuine River River Island 1.5is compatible with Riak
Please refer to our Sweatshirt Look New Black Miami Crew Print cHcdCRW guide. Don't hesitate to join our mailing list and ask questions, too!
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 Denim Herrlicher Shorts 60 Under Blue wCq00X on Twitter.
Welle artifacts are released to Clojars.
Add dependency in your
[com.novemberain/welle "3.0.0"Black Tunic Yas Super Super Yas Yaspeque Tunic Yaspeque Super Black Yaspeque Yas 1dAxqB7]
Add Clojars repository definition to your
<repository> <id>clojars.orgid> <url>http://clojars.org/repoTrousers Genuine Trousers Island River River Grey Grey Island Genuine River Genuine url> repository>
and then the dependency:
<dependency> <groupId>com.novemberaingroupId> <artifactId>welleartifactId> <version>3.0.0version> 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
- Print shirt Onlramona Royale Port Only black T white B5anq
- Opus shirt Linden Basic Tree Skita T qrv7HwCq
and many others.
Welle has been around since 2011. The API is generally stable with some (badly needed) breaking changes coming in 2.0.
CI is hosted by travis-ci.org
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.
Copyright (C) 2011-2016 Michael S. Klishin and the ClojureWerkz team.