memcache-ppp v0.5.2

Memcache Plus Plus Plus

Memcache Plus Plus Plus - Bettererer Memcache module for Node js. Forked from the memcache-pp module, which was forked from memcache-plus, so you can find many refs to the memcache-plus in the docs or code itself.

What's new in "Plus Plus Plus" over "Plus Plus" and the original "Plus"?

• Removed hashring and replaced it with a simple cycle through each host
• Fixed uncaught exception errors when retrieving certain data values
• Support multiline/empty string/values where the data is a keyword (such as END) properly
• Added missing touch/gat/gats commands
• getMulti/gatMulti send one one command to request all keys at once instead of a loop of many requests
• Fixed potential race condition when using 2+ hosts requesting the same key at the same time

Use unix sockets (33% faster than TCP)

Edit your /etc/memcached.conf and comment out / add lines such as:

# -p 11211
# -l 127.0.0.1
-s /var/run/memcached/memcached.sock
-a 777

Then use in your code with:

import MemcachePlus from 'memcache-ppp';
const memcache = new MemcachePlus({ "hosts": ["/var/run/memcached/memcached.sock:0"] });

Use Gets/Cas

const [value, cas] = await memcache.gets('key');
if (!await memcache.cas('key', 'newvalue', cas)) {
  // value changed between our gets() and cas() calls
}

Touch and Gat/Gats

memcache.touch(key, ttl);
memcache.gat(key, ttl, opts);
memcache.gats(key, ttl, opts);

Why remove hashring?

• Many people use only a single server on localhost, or a unix socket, making it pointless anyway
• It is CPU intensive to calculate a MD5 hash of every key for every operation
• Hashring's internal cache grows up to several GB of RAM in less than a day

What makes it "Plus"?

• Native support for Promises or Callbacks
• Elasticache auto discovery baked in
• Actively developed and used
• Focus on cleanliness and simplicity
• Command buffering - start issuing commands right away, memcache-plus will automatically wait until connected then flush that buffer
• Ability to disable with just a flag on init - sounds trivial, but nice to test with memcache off without altering any of your code
• Compression built in on a per item basis
• Cached retrieve (coming soon!) - simply pass a function for retrieving a value and a key and memcache-plus will do the whole "check key, if it exists return it, if not run the function to retrieve it, set the value, and return it" for you
• Support for binaries (coming soon!) which the other memcache libraries for Node don't support
• (these things are not coming here)