Package: pyelasticache_client
pyelasticache_client========================.. image:: https://travis-ci.org/touchvie/pyelasticache_client.svg?branch=master:target: https://travis-ci.org/touchvie/pyelasticache_client.. image:: https://img.shields.io/pypi/v/pyelasticache_client.svg:target: https://pypi.python.org/pypi/pyelasticache_clientA comprehensive, fast, pure-Python memcached client with consistent key hashingand node autodiscovery.Forked from the Pinterest pymemcache project:https://github.com/pinterest/pymemcachepyelasticache_client 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.* Optional use of Ketama hashing to consistently distribute cache keys on nodes.* Automatic cluster nodes autodiscovery and update through the "config cluster" optionInstalling pyelasticache_client===================================Install from pip:.. code-block:: bashpip install pyelasticache_clientFor development, clone from github and run the tests with:.. code-block:: bashgit clone https://github.com/touchvie/pyelasticache_client.gitcd pyelasticache_clientpython setup.py nosetestsUsage=====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 isfast, implements consistent hashing, the full memcached protocol and timeouts.It does not provide access to the "noreply" flag, and it doesn't provide abuilt-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, hasa single timeout for all socket calls and has a flexible approach toserialization and deserialization. It is also written entirely in Python, soit works well with libraries like gevent. However, it is tied to using threadlocals, doesn't implement "noreply", can't treat errors as cache misses and isslower than both pylibmc and pymemcache. It is also tied to a specific methodfor handling clusters of memcached servers.memcache_client---------------The team at mixpanel put together a pure Python memcached client as well. Ithas more fine grained support for socket timeouts, only connects to a singlehost. However, it doesn't support most of the memcached API (just get, set,delete and stats), doesn't support "noreply", has no serialization ordeserialization 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.txtThe python-memcached library (another pure-Python library):https://github.com/linsomniac/python-memcachedMixpanel'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_clientKetama hashing algorithm:http://www.last.fm/user/RJ/journal/2007/04/10/rz_libketama_-_a_consistent_hashing_algo_for_memcache_clientsMemcached autodiscovery feature:http://docs.aws.amazon.com/AmazonElastiCache/latest/UserGuide/AutoDiscovery.AddingToYourClientLibrary.htmlCredits=======* `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>`_* `Ernest W. Durbin III <https://github.com/ewdurbin>`_* `Remco van Oosterhout <https://github.com/Vhab>`_* `David Fierro <https://github.com/davidfierro>`_* `Guillermo Menéndez <https://github.com/gmcorral>`_* `Natalia Angulo <https://github.com/AnguloHerrera>`_Change Log==========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 EINTRNew in version 1.2.9--------------------* Introduced PooledClient a thread-safe pool of clients