A pure Julia client for memcached servers. All memcached commands as of memcached version 1.4.17 are implemented.

Both numbers and strings are stored in plain string format so as to be interoperable with other memcached client libraries. Other Julia types are stored in their serialized form.

Type MemcacheClient represents a connection to a single memcached server instance.

Type MemcacheClients wraps over multiple MemcacheClient instances to provide distributed cache across more than one memcached server instances. Operations are routed to appropriate server based on key hash value.

• Setting and getting data: set, cas, add, replace, append, prepend, incr, decr, get, touch
• Administration: stats, version, flush_all, close, slabs_reassign, slabs_automove, quit

All methods are supported for both MemcacheClient and MemcacheClients, but results of administration commands would return and array of responses from all servers. See memcached command documentation for details of administration commands.

Below is an illustration of using the most common commands.

julia> using Memcache

julia> # create a client connection

julia> mc = MemcacheClient("localhost", 11211);

julia> 

julia> # simple set and get

julia> set(mc, "key1", "val1")

julia> set(mc, "key2", 2)

julia> get(mc, "key1")
"val1"

julia> 

julia> # multi get

julia> get(mc, "key1", "key2")
["key1"=>"val1","key2"=>2]

julia> 

julia> # increment, decrement

julia> incr(mc, "key2", 8)
10

julia> decr(mc, "key2", 3)
7

julia> 

julia> # append, prepend

julia> append(mc, "key1", "--")

julia> prepend(mc, "key1", "--")

julia> get(mc, "key1")
"--val1--"

julia> 

julia> # cas

julia> res = get(mc, "key1", cas=true)
["key1"=>("--val1--",40)]

julia> val,casval = res["key1"]
("--val1--",40)

julia> cas(mc, "key1", 2, casval)

julia> get(mc, "key1")
2

• compression
• optimize multi get for MemcacheClients