Skip to main content

A comprehensive, fast, pure Python memcached client

Project description

pymemcache
==========

.. image:: https://travis-ci.org/pinterest/pymemcache.png
:target: https://travis-ci.org/pinterest/pymemcache

.. image:: https://img.shields.io/pypi/v/pymemcache.svg
:target: https://pypi-hypernode.com/pypi/pymemcache

.. image:: https://readthedocs.org/projects/pymemcache/badge/?version=master
:target: http://pymemcache.readthedocs.org/en/latest/
:alt: 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:

.. code-block:: bash

pip install pymemcache

For development, clone from github and run the tests with:

.. code-block:: bash

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.

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):
https://github.com/linsomniac/python-memcached

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:
https://github.com/mixpanel/memcache_client

Credits
=======

* `Charles Gordon <http://github.com/cgordon>`_
* `Dave Dash <http://github.com/davedash>`_
* `Dan Crosta <http://github.com/dcrosta>`_
* `Julian Berman <http://github.com/Julian>`_
* `Mark Shirley <http://github.com/maspwr>`_
* `Tim Bart <http://github.com/pims>`_
* `Thomas Orozco <http://github.com/krallin>`_
* `Marc Abramowitz <http://github.com/msabramo>`_
* `Marc-Andre Courtois <http://github.com/mcourtois>`_
* `Julien Danjou <http://github.com/jd>`_
* `INADA Naoki <http://github.com/methane>`_
* `James Socol <http://github.com/jsocol>`_
* `Joshua Harlow <http://github.com/harlowja>`_
* `John Anderson <http://github.com/sontek>`_
* `Adam Chainz <http://github.com/adamchainz>`_

Change Log
==========
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.3.2.tar.gz (29.7 kB view details)

Uploaded Source

Built Distribution

pymemcache-1.3.2-py2.py3-none-any.whl (44.6 kB view details)

Uploaded Python 2 Python 3

File details

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

File metadata

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

File hashes

Hashes for pymemcache-1.3.2.tar.gz
Algorithm Hash digest
SHA256 b5eeecb5deeed099318f8e92520051ea7ed0f4f61eb6b3eba6b999836cc3bddb
MD5 a74a57d3073ef0abfe6d1663bda5dce7
BLAKE2b-256 6e985268cc25f565a9fec54c8e8d161da25a24f960b1add3bdafaad77e391791

See more details on using hashes here.

Provenance

File details

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

File metadata

File hashes

Hashes for pymemcache-1.3.2-py2.py3-none-any.whl
Algorithm Hash digest
SHA256 5f4fe50b72e84ac84e8bb5c6d121fb08f510fc4413e8c91fe5c50874b1691ec2
MD5 b9aafa80f166eb52439fb2dc96d84c5e
BLAKE2b-256 cd74c5d48a39c399773aa45f59dbfb450b0062aaf02183c7389c88017e2e9b1c

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