A comprehensive, fast, pure Python memcached client
Project description
pymemcache
A comprehensive, fast, pure-Python memcached client.
pymemcache supports the following features:
Complete implementation of the memcached text protocol.
Configurable timeouts for socket connect and send/recv calls.
Access to the “noreply” flag, which can significantly increase the speed of writes.
Flexible, simple approach to serialization and deserialization.
The (optional) ability to treat network and memcached errors as cache misses.
Installing pymemcache
Install from pip:
pip install pymemcache
For development, clone from github and run the tests:
git clone https://github.com/pinterest/pymemcache.git
cd pymemcache
Run the tests manually:
python setup.py nosetests
Or with Tox:
tox
Usage
See the documentation here: https://pymemcache.readthedocs.io/en/latest/
Comparison with Other Libraries
pylibmc
The pylibmc library is a wrapper around libmemcached, implemented in C. It is fast, implements consistent hashing, the full memcached protocol and timeouts. It does not provide access to the “noreply” flag. It also isn’t pure Python, so using it with libraries like gevent is out of the question, and its dependency on libmemcached poses challenges (e.g., it must be built against the same version of libmemcached that it will use at runtime).
Python-memcache
The python-memcache library implements the entire memcached text protocol, has a single timeout for all socket calls and has a flexible approach to serialization and deserialization. It is also written entirely in Python, so it works well with libraries like gevent. However, it is tied to using thread locals, doesn’t implement “noreply”, can’t treat errors as cache misses and is slower than both pylibmc and pymemcache. It is also tied to a specific method for handling clusters of memcached servers.
memcache_client
The team at mixpanel put together a pure Python memcached client as well. It has more fine grained support for socket timeouts, only connects to a single host. However, it doesn’t support most of the memcached API (just get, set, delete and stats), doesn’t support “noreply”, has no serialization or deserialization support and can’t treat errors as cache misses.
External Links
- The memcached text protocol reference page:
https://github.com/memcached/memcached/blob/master/doc/protocol.txt
- The python-memcached library (another pure-Python library):
- Mixpanel’s Blog post about their memcached client for Python:
http://code.mixpanel.com/2012/07/16/we-went-down-so-we-wrote-a-better-pure-python-memcache-client/
- Mixpanel’s pure Python memcached client:
Credits
Change Log
New in version 1.4.3
Documentation improvements
Fixed cachedump stats command, see [ticket](https://github.com/pinterest/pymemcache/issues/103)
Honor default_value in HashClient
New in version 1.4.2
Drop support for python 2.6, see [ticket](https://github.com/pinterest/pymemcache/issues/139)
New in version 1.4.1
Python 3 serializations [fixes](https://github.com/pinterest/pymemcache/pull/131)
Drop support for pypy3
Comment cleanup
Add gets_many to hash_client
Better checking for illegal chars in key
New in version 1.4.0
Unicode keys support. It is now possible to pass the flag allow_unicode_keys when creating the clients, thanks @jogo!
Fixed a bug where PooledClient wasn’t following default_noreply arg set on init, thanks @kols!
Improved documentation
New in version 1.3.8
use cpickle instead of pickle when possible (python2)
New in version 1.3.7
default parameter on get(key, default=0)
fixed docs to autogenerate themselves with sphinx
fix linter to work with python3
improve error message on illegal Input for the key
refactor stat parsing
fix MockMemcacheClient
fix unicode char in middle of key bug
New in version 1.3.6
Fix flake8 and cleanup tox building
Fix security vulnerability by sanitizing key input
New in version 1.3.5
Bug fix for HashClient when retries is set to zero.
Adding the VERSION command to the clients.
New in version 1.3.4
Bug fix for the HashClient that corrects behavior when there are no working servers.
New in version 1.3.3
Adding caching to the Travis build.
A bug fix for pluggable hashing in HashClient.
Adding a default_noreply argument to the Client ctor.
New in version 1.3.2
Making the location of Memcache Exceptions backwards compatible.
New in version 1.3.0
Python 3 Support
Introduced HashClient that uses consistent hasing for allocating keys across many memcached nodes. It also can detect servers going down and rebalance keys across the available nodes.
Retry sock.recv() when it raises EINTR
New in version 1.2.9
Introduced PooledClient a thread-safe pool of clients
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for pymemcache-1.4.3-py2.py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 6cdc1a149b604ba4612c1429d1442c2a72155608908da2a242d364af243a14fd |
|
MD5 | 21bbeae0233295438dc30d3e91e0e032 |
|
BLAKE2b-256 | 5d49e3ccd6dbb1d6335857beaac12d12a4ae8a0d78e57e402ff337f9c9470161 |