NSMemcached 0.2.0

A simple implementation of a namespaced memcached client

Author:

Nicolas Perriault

Contact:

np at akei com

Contents

• Abstract

• Quick Start

• Caveats

• Dependencies and Compatibility

• License

• Author

Abstract

NSMemcached is simple yet efficient Python implementation of a namespaced client for memcached on top of the python-memcached package.

Quick Start

Sample usage:

>>> import memcache
>>> from nsmemcached.client import NamespacedClient
>>> std_client = memcache.Client(['127.0.0.1:11211'])
>>> ns_client = NamespacedClient(std_client)
>>> ns_client.set('foo', 'bar', ns='barspace')
True
>>> ns_client.get('foo', ns='barspace')
bar
>>> ns_client.get('foo')
None
>>> ns_client.clear_ns('barspace')
>>> ns_client.get('foo', ns='barspace')
None

Yes, that simple.

Caveats

Namespace keys are stored in dedicated keys, so every time you request a namespaced item you’ll make two queries to the memcached server instead of one, so expect a tiny slowdown compared to the way of using the standard, non-namespaced memcached API.

Dependencies and Compatibility

NSMemcached requires the use of Python 2.4 or more recent.

Installing python-memcached package is required in order to use this library, as well as a working memcached server instance, obviously.

NSMemcached is fully compatible with the API of the standard python-memcached client.

License

This code is released under the terms of the MIT License.

Author

Nicolas Perriault, AKEI, <np at akei com>