Skip to main content

A comprehensive, fast, pure Python memcached client

Project description

pymemcache

[![Build Status](https://travis-ci.org/pinterest/pymemcache.png)](https://travis-ci.org/pinterest/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

You can install pymemcache manually, with Nose tests, by doing the following:

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

You can also use pip:

sudo pip install https://github.com/pinterest/pymemcache.git

Usage

See the module documentation in pymemcache.client for details.

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

  1. [Charles Gordon](http://github.com/cgordon)

  2. [Dave Dash](http://github.com/davedash)

  3. [Dan Crosta](http://github.com/dcrosta)

  4. [Julian Berman](http://github.com/Julian)

  5. [Mark Shirley](http://github.com/maspwr)

  6. [Tim Bart](http://github.com/pims)

  7. [Thomas Orozco](http://github.com/krallin)

  8. [Marc Abramowitz](http://github.com/msabramo)

  9. [Marc-Andre Courtois](http://github.com/mcourtois)

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.1.4.tar.gz (17.4 kB view details)

Uploaded Source

File details

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

File metadata

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

File hashes

Hashes for pymemcache-1.1.4.tar.gz
Algorithm Hash digest
SHA256 bd8c066cebef9aee643afbd6cef02800fe62e6b91291dd8229b0b1d003842b3d
MD5 ce232376b98cbf8555d592217cf2f4c7
BLAKE2b-256 31e1b0cceb4563e61c7ba1c5f9860e474ff748bf0de15e8c1c4bf4e195e33a43

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