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:

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.

Credits

Change Log

New in version 1.4.3

New in version 1.4.2

New in version 1.4.1

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


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

Uploaded Source

Built Distribution

pymemcache-1.4.3-py2.py3-none-any.whl (38.5 kB view details)

Uploaded Python 2 Python 3

File details

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

File metadata

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

File hashes

Hashes for pymemcache-1.4.3.tar.gz
Algorithm Hash digest
SHA256 be858c46b05620ce10e60a1fda7d9d2aeaaa4673f5ef9bd856f410849f48368c
MD5 00ff1e5ceb272e6ba6041d372d97b9fb
BLAKE2b-256 21f70f5c0b5f1db4e15ffb0395bbd4c6ee8541e90639c55e5c85aa8d21260f4c

See more details on using hashes here.

Provenance

File details

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

File metadata

File hashes

Hashes for pymemcache-1.4.3-py2.py3-none-any.whl
Algorithm Hash digest
SHA256 6cdc1a149b604ba4612c1429d1442c2a72155608908da2a242d364af243a14fd
MD5 21bbeae0233295438dc30d3e91e0e032
BLAKE2b-256 5d49e3ccd6dbb1d6335857beaac12d12a4ae8a0d78e57e402ff337f9c9470161

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