Skip to content
This repository

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP

A Clojure Memcached client (also: Couchbase, Kestrel). Built on top of SpyMemcached, supports ASCII and binary protocols, strives to be 100% feature complete.

README.md

What is Spyglass

Spyglass is a very fast Clojure client for Memcached built on top of SpyMemcached

Community

Spyglass 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

Spyglass is no longer a young project. It is almost 100% feature complete. Built on a very solid Java client, SpyMemcached and has good test coverage (using adapted Memcached client test suite by Dustin Sallings).

As such, you can confidently use it, the API is small and locked down.

Artifacts

Artifact Repositories

Spyglass artifacts are released to Clojars. Spyglass relies on a recent SpyMemcached release so you may need to add SpyMemcached repository first.

With Leiningen:

;; in project.clj
:repositories {"spy-memcached" {:url "http://files.couchbase.com/maven2/"}}

With Maven:

<repositories>
  <repository>
    <id>spy</id>
    <name>Spy Repository</name>
    <layout>default</layout>
    <url>http://files.couchbase.com/maven2/</url>
    <snapshots>
      <enabled>false</enabled>
    </snapshots>
  </repository>
</repositories>

The Most Recent Release

With Leiningen:

[clojurewerkz/spyglass "1.1.0"]

With Maven:

<dependency>
  <groupId>clojurewerkz</groupId>
  <artifactId>spyglass</artifactId>
  <version>1.1.0</version>
</dependency>

Documentation & Examples

Spyglass has a documentation site at clojurememcached.info.

Our test suite has plenty of code examples, too.

Supported Clojure Versions

Spyglass requires Clojure 1.4+.

Continuous Integration

Continuous Integration status

CI is hosted by travis-ci.org

Development

Spyglass 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

Copyright (C) 2012-2014 Michael S. Klishin, Alex Petrov

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

Something went wrong with that request. Please try again.