Skip to main content

A comprehensive, fast, pure Python memcached client

Project description

pymemcache

https://travis-ci.org/pinterest/pymemcache.png https://img.shields.io/pypi/v/pymemcache.svg Master Documentation Status

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 with:

git clone https://github.com/pinterest/pymemcache.git
cd pymemcache
python setup.py nosetests

Usage

See the documentation here: http://pymemcache.readthedocs.org/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, and it doesn’t provide a built-in API for serialization and deserialization. It also isn’t pure Python, so using it with libraries like gevent is out of the question.

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.

Credits

Change Log

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


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

pymemcache-1.3.0.tar.gz (29.6 kB view details)

Uploaded Source

Built Distribution

pymemcache-1.3.0-py2.py3-none-any.whl (44.4 kB view details)

Uploaded Python 2 Python 3

File details

Details for the file pymemcache-1.3.0.tar.gz.

File metadata

  • Download URL: pymemcache-1.3.0.tar.gz
  • Upload date:
  • Size: 29.6 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No

File hashes

Hashes for pymemcache-1.3.0.tar.gz
Algorithm Hash digest
SHA256 46cbfb5afd60565d30b12d5eba0f38e1c3df2aa3eaeffdc7667efae752a627bc
MD5 b7308dd0e7fbf9f21fdaddffbca4e8da
BLAKE2b-256 7255e313c8ea6cf5cd9b8a89fcdd7c248c269d0172e3d9d7a4043206df9774de

See more details on using hashes here.

Provenance

File details

Details for the file pymemcache-1.3.0-py2.py3-none-any.whl.

File metadata

File hashes

Hashes for pymemcache-1.3.0-py2.py3-none-any.whl
Algorithm Hash digest
SHA256 650fd0b86cd2e77afae22b845482b406bf6238deb384b27c90901bd06948325e
MD5 61f35638eb3e57641c34ce806432b088
BLAKE2b-256 86b2fb82d95f1c1b01682af2efaccd72f70215f952db0550053d126a16aa9e20

See more details on using hashes here.

Provenance

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page