Introduction to bmemcached
==========================

A pure python module to access memcached via it's binary with SASL auth support.

The main purpose of this module it to be able to communicate with memcached using binary protocol and support authentication, so it can work with Heroku for example.

Installing
----------
Use pip or easy_install.

::

    pip install python-binary-memcached

Using
-----

::

    import bmemcached
    client = bmemcached.Client(('127.0.0.1:11211', ), 'user',
                                'password')
    client.set('key', 'value')
    print client.get('key')


Running the tests
-----------------

First run memcached with:

::

    memcached -S -vvv
    memcached -p5000 -S -vvv
    memcached -S -s/tmp/memcached.sock -vvv

This is to cover all tests with socket, standard port and non standard port.

Then, run the tests.

::

    cd src_dir/
    py.test

Using with Django
-----------------
If you want to use it with Django, go to `django-bmemcached <https://github.com/jaysonsantos/django-bmemcached>`_ to get a Django backend.