Metadata-Version: 1.1
Name: pyelasticache_client
Version: 0.1.1
Summary: A comprehensive, fast, pure Python memcached client
Home-page: https://github.com/touchvie/pyelasticache_client
Author: David Fierro, Guillermo Menendez, N. Angulo y Charles Gordon
Author-email: backend@touchvie.com
License: UNKNOWN
Description: 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_client
         
        A comprehensive, fast, pure-Python memcached client with consistent key hashing 
        and node autodiscovery.
        Forked from the Pinterest pymemcache project:
        
        https://github.com/pinterest/pymemcache
        
        
        pyelasticache_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" option
        
        Installing pyelasticache_client
        ===============================
        
        Install from pip:
        
        .. code-block:: bash
        
          pip install pyelasticache_client
        
        For development, clone from github and run the tests with:
        
        .. code-block:: bash
        
            git clone https://github.com/touchvie/pyelasticache_client.git
            cd pyelasticache_client
            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
        
        Ketama hashing algorithm:
          http://www.last.fm/user/RJ/journal/2007/04/10/rz_libketama_-_a_consistent_hashing_algo_for_memcache_clients
        
        Memcached autodiscovery feature:
          http://docs.aws.amazon.com/AmazonElastiCache/latest/UserGuide/AutoDiscovery.AddingToYourClientLibrary.html
        
        
        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>`_
        * `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>`_
        * `N. Angulo <https://github.com/AnguloHerrera>`_
        
Keywords: AWS,elasticache,memcache,autodiscovery
Platform: UNKNOWN
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 2.6
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3.3
Classifier: Programming Language :: Python :: 3.4
Classifier: Programming Language :: Python :: Implementation :: PyPy
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Topic :: Database
