4 releases (breaking)

0.4.0 Dec 20, 2021
0.3.0 Apr 14, 2021
0.2.0 Apr 11, 2021
0.1.0 Apr 8, 2021

#407 in Database interfaces

26 downloads per month

MIT license



This crate aims to provide a full-features memcached client for the Tokio async runtime using rsmc-core.

This is still an early implementation, so expect some bugs and missing features. If you find something is wrong, please open a GitHub issue (or, even better, a PR to fix the issue!)

Expect some breaking changes before a 1.0 release.


  • Async
  • Connection pooling provided by deadpool
  • TLS support
  • Binary protocol support
    • get, multi_get
    • set, multi_set
    • delete, multi_delete
    • add, replace
    • increment, decrement
  • Consistent hashing
    • Support for different hashing algorithms.
  • Compression
    • Support for different compression algorithms.

Quick start

use flate2::Compression;
use rsmc_core::{
    client::{ClientConfig, Pool},
use rsmc_tokio::TokioConnection;

// Consistent hashing is used to distribute keys
// evenly across a memcached cluster.
let memcached_servers = vec![

// Use `ClientConfig::new_uncompressed()` if compression is not desired.
// You can disable the `zlib` feature (on by default) to disable it entirely.
let cfg = ClientConfig::new(memcached_servers, ZlibCompressor::default());

// Create a connection pool with (at most) 16 connections per server.
let pool = Pool::<TokioConnection, _>::new(cfg, 16);
let mut client = pool.get().await.unwrap();

client.set(b"hello", b"world", 300).await.unwrap();
let response: Option<Vec<u8>> = client.get(b"hello").await.unwrap(); // "world"


~163K SLoC