Skip to content

Latest commit

 

History

History
40 lines (25 loc) · 1.38 KB

README.md

File metadata and controls

40 lines (25 loc) · 1.38 KB
Raw

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