{"id":23560,"library":"django-bmemcached","title":"django-bmemcached","description":"A Django cache backend using the bmemcached module (binary protocol with SASL authentication). Current version 0.3.0. Low release cadence; last release in 2015.","status":"deprecated","version":"0.3.0","language":"python","source_language":"en","source_url":"https://github.com/jaysonsantos/django-bmemcached","tags":["django","memcached","cache","binary-protocol"],"install":[{"cmd":"pip install django-bmemcached","lang":"bash","label":"Basic install"}],"dependencies":[{"reason":"Required for the backend; bmemcached is a wrapper over it.","package":"python-memcached","optional":false},{"reason":"Cache backend intended for Django projects.","package":"django","optional":false}],"imports":[{"note":"django-bmemcached provides its own backend class; bmemcached library is separate.","wrong":"from bmemcached import BMemcachedCache","symbol":"BMemcachedCache","correct":"from django_bmemcached import BMemcachedCache"},{"note":"This exception is in the memcached submodule.","wrong":"from django_bmemcached import InvalidCacheOptions","symbol":"InvalidCacheOptions","correct":"from django_bmemcached.memcached import InvalidCacheOptions"}],"quickstart":{"code":"import os\n\nCACHES = {\n    'default': {\n        'BACKEND': 'django_bmemcached.memcached.BMemcachedCache',\n        'LOCATION': [os.environ.get('MEMCACHED_HOST', '127.0.0.1:11211')],\n        'OPTIONS': {\n            'username': os.environ.get('MEMCACHED_USER', ''),\n            'password': os.environ.get('MEMCACHED_PASS', ''),\n        }\n    }\n}\n","lang":"python","description":"Django settings configuration for using bmemcached with authentication."},"warnings":[{"fix":"Only use keys: 'username', 'password', 'pickleProtocol', 'behaviors', and others listed in the source.","message":"OPTIONS keys are validated against a whitelist. Unrecognized keys raise InvalidCacheOptions.","severity":"breaking","affected_versions":">=0.3.0"},{"fix":"Consider migrating to django-pylibmc or django-corecache.","message":"Library is unmaintained since 2015. Does not support modern Django versions (2.x, 3.x, 4.x).","severity":"deprecated","affected_versions":"all"},{"fix":"Use BACKEND: 'django_bmemcached.memcached.BMemcachedCache'.","message":"The import path in Django CACHES settings must be 'django_bmemcached.memcached.BMemcachedCache', not 'django_bmemcached.BMemcachedCache'.","severity":"gotcha","affected_versions":"all"}],"env_vars":null,"last_verified":"2026-05-01T00:00:00.000Z","next_check":"2026-07-30T00:00:00.000Z","problems":[{"fix":"Remove the key or add it to the whitelist in django_bmemcached/memcached.py.","cause":"You passed an OPTIONS key not in the whitelist.","error":"InvalidCacheOptions: Option 'xxx' is not a valid memcached option"},{"fix":"pip install bmemcached","cause":"Missing bmemcached dependency (the underlying library).","error":"ImportError: No module named bmemcached"},{"fix":"pip install django-bmemcached and use 'django_bmemcached.memcached.BMemcachedCache'.","cause":"django-bmemcached not installed or import path wrong.","error":"ImproperlyConfigured: Error importing cache backend module 'django_bmemcached.memcached': No module named django_bmemcached"}],"ecosystem":"pypi","meta_description":null,"install_score":null,"install_tag":null,"quickstart_score":null,"quickstart_tag":null}