python-binary-memcached

Introduction to bmemcached

A pure python module (thread safe) 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.

Latest compiled docs on Read The Docs here.

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'))

Using it with distributed keys

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

Testing

python-binary-memcached unit tests are found in the test/ directory and are designed to be run using pytest. pytest will discover the tests automatically, so all you have to do is:

$ pytest
...
170 passed in 4.43 seconds

This runs the tests with the default Python interpreter.

You can also verify that the tests pass on other supported Python interpreters. For this we use tox, which will automatically create a virtualenv for each supported Python version and run the tests. For example:

$ tox
...
py27: commands succeeded
ERROR:  py34: InterpreterNotFound: python3.4
py35: commands succeeded
py36: commands succeeded
py37: commands succeeded
py38: commands succeeded

You may not have all the required Python versions installed, in which case you will see one or more InterpreterNotFound errors.

Using with Django

If you want to use it with Django, go to django-bmemcached to get a Django backend.

Tests Status

https://travis-ci.org/jaysonsantos/python-binary-memcached.png?branch=master

v0.32.0 (2026-04-28)

Docs

Add repository contribution guidelines.

v0.31.2 (2022-12-14)

Fix

Remove setup’s.py dependency on m2r

v0.31.1 (2021-12-29)

v0.31.0 (2021-12-28)

Refactor

Use bytearrays for building up bytes for I/O. (#245)

Feat

Expose incr/decr default and time protocol arguments in client class (#243)

v0.30.1 (2020-10-11)

v0.30.0 (2020-08-18)

Add ability to return default value on get but breaking get’s API
Support an arbitrary collection of keys, not just a list

v0.30 (2020-06-10)

v0.29.0 (2020-01-29)

added TLS support on #211 thanks to @moisesguimaraes!

v0.28.0 (2018-10-02)

moved bmemcached.Client to bmemcached.ReplicantClient but keeps backward compatibility
added DistributedClient to distribute keys over servers using consistent hashing

v0.27.0 (2018-08-10)

0.26.1 (2017-07-18)

0.26.0 (2017-01-13)

0.25.0 (2016-12-15)

0.24.7 (2016-11-08)

0.24.2 (2014-05-27)

0.24.1 (2014-05-20)

0.24 (2014-04-28)

0.23 (2014-04-18)

v0.18 (2013-05-06)

v0.17 (2013-04-15)

Release files for python-binary-memcached 0.32.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for python-binary-memcached 0.32.0
File	Size	Uploaded
python_binary_memcached-0.32.0.tar.gz	101.3 kB	Apr 28, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for python-binary-memcached 0.32.0
File	Interpreter	ABI	Platform	Reset
python_binary_memcached-0.32.0-py3-none-any.whl 21.1 kB Apr 28, 2026	Python 3	none	any	Details

Total release size: 122.3 kB

Release files / python_binary_memcached-0.32.0.tar.gz

Download URL	python_binary_memcached-0.32.0.tar.gz
Size	101.3 kB
Tags	Source
SHA-256 checksum How to use checksums	`d0572e1db5a61a6c3185ed783b8337d00d65d1eb1521e2302a36e45d5e0fb3b7`
BLAKE2b-256 checksum How to use checksums	`ecfbbc3d76fa6ca3adb99d07ad212710f4654e2d0b21d1e2f878a504ca936aec`
Upload date	Apr 28, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/6.1.0 CPython/3.13.12`

Release files / python_binary_memcached-0.32.0-py3-none-any.whl

Download URL	python_binary_memcached-0.32.0-py3-none-any.whl
Size	21.1 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`1c98c59621becd7f9a9cb4d271466bface38ac99e45597705ee53d532e4752d8`
BLAKE2b-256 checksum How to use checksums	`ab89de544a214febd4c38042b7855a47c295ec9e42a252ade31f8dd20cea645d`
Upload date	Apr 28, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/6.1.0 CPython/3.13.12`