Skip to content
This repository

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP

A Python wrapper around the libmemcached interface from TangentOrg.

tag: 0.7.3

Fetching latest commit…

Octocat-spinner-32-eaf2f5

Cannot retrieve the latest commit at this time

Octocat-spinner-32 .gitignore
Octocat-spinner-32 LICENSE
Octocat-spinner-32 MANIFEST.in
Octocat-spinner-32 README.rst
Octocat-spinner-32 TODO
Octocat-spinner-32 _pylibmcmodule.c
Octocat-spinner-32 _pylibmcmodule.h
Octocat-spinner-32 cmemcache_tests.py
Octocat-spinner-32 pylibmc.py
Octocat-spinner-32 setup.py
Octocat-spinner-32 tests.py
README.rst

pylibmc is a Python wrapper around the accompanying C Python extension _pylibmc, which is a wrapper around libmemcached from TangentOrg.

You have to install libmemcached separately, and have your compiler and linker find the include files and libraries.

With libmemcached installed and this package set up, the following basic usage example should work:

>>> import pylibmc
>>> mc = pylibmc.Client(["127.0.0.1:11211"])
>>> mc.set("foo", "Hello world!")
True
>>> mc.get("foo")
'Hello world!'

The API is pretty much python-memcached. Some parts of libmemcached aren't exposed yet. I think.

Behaviors

libmemcached has ways of telling it how to behave. You'll have to refer to its documentation on what the different behaviors do.

To change behaviors, quite simply:

>>> mc.behaviors["hash"] = "fnv1a_32"

For a list of the defined behavior key names, see what the keys of a client is. For example:

>>> mc.behaviors.keys()  # doctest: +NORMALIZE_WHITESPACE
['hash', 'connect timeout', 'cache lookups', 'buffer requests',
 'verify key', 'support cas', 'poll timeout', 'no block', 'tcp nodelay',
 'distribution', 'sort hosts']

The hash and distribution keys are mapped by the Python module to constant integer values used by libmemcached. See pylibmc.hashers and pylibmc.distributions.

Comparison to other libraries

Why use pylibmc? Because it's fast.

See this (a bit old) speed comparison.

IRC

#sendapatch on chat.freenode.net.

Compiling on Snow Leopard

Since, for some reason, compiling Python extensions under Mac OS X 10.6 won't use the proper -arch flag to gcc, here's how you'd do it:

$ CFLAGS="-arch x86_64" LDFLAGS="-arch x86_64" python setup.py build

Change Log

New in version 0.7

  • Restructured some of the code, which should yield better performance (if not for that, it reads better.)
  • Fixed some memory leaks.
  • Integrated changes from amix.dk, which should make pylibmc work under Snow Leopard.
  • Add support for the boolean datatype.
  • Improved test-runner -- now tests build/lib.*/_pylibmc.so if available, and reports some version information.
  • Support for x86_64 should now work completely.

New in version 0.6

  • Added compatibility with libmemcached 0.26, WRT error return codes.
  • Added flush_all and disconnect_all methods.
  • Now using the latest pickling protocol.

New in version 0.5

  • Fixed lots of memory leaks, and added support for libmemcached 0.23.
  • Also made the code tighter in terms of compiler pedantics.

New in version 0.4

  • Renamed the C module to _pylibmc, and added lots of libmemcached constants to it, as well as implemented behaviors.
Something went wrong with that request. Please try again.