memcached in rust
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
cppperf
doc
pyemc
src
.gitignore
.travis.yml
Cargo.lock
Cargo.toml
LICENSE
README.md
TODO.md
all_unit_tests.sh
bench_tests.sh
fast_unit_tests.sh
format_all_code.sh
integration_tests.sh
run_server.sh
rustfmt.toml

README.md

emcache

Build Status Coverage Status

An implementation of memcached in Rust.

Features and todo list

  • Implements the memcached protocol.
  • Bounded cache with LRU behavior.
  • Concurrency model based on thread-per-connection.
  • Modular architecture. Transport layer is separate from storage and is configured in a N:1 topology with communication using immutable Cmd/Resp values over async channels.
  • Fairly good test coverage.
  • No config file, logging or daemonization yet.
  • Performance is generally within 0.5-1x of memcached.
  • Currently (Apr 2016) only builds against rust-nightly due to dependency on unstable "test" crate for benchmarking.

Development

To build:

$ cargo build

To run unit tests:

$ ./all_unit_tests.sh

To run the server:

$ ./run_server.sh

The Python integration test suite supplies various forms of tests. To run them against a running server:

$ python -m pyemc.main -p $PORT            # integration tests
$ python -m pyemc.main -p $PORT --stress   # burn in tests
$ python -m pyemc.main -p $PORT --fill 45  # fill to 45% capacity