From 5db8b67d46c67a3476c0a09edb9c6e7a21dde5f1 Mon Sep 17 00:00:00 2001 From: Craig Younkins Date: Mon, 17 Dec 2012 17:36:48 -0500 Subject: [PATCH] Adding section in Connections docs about the different AMQP transports --- docs/userguide/connections.rst | 16 ++++++++++++++++ 1 file changed, 16 insertions(+) diff --git a/docs/userguide/connections.rst b/docs/userguide/connections.rst index 12e9249d..73d08f29 100644 --- a/docs/userguide/connections.rst +++ b/docs/userguide/connections.rst @@ -123,6 +123,22 @@ keyword arguments, these are: pass to alternate kombu channel implementations. Consult the transport documentation for available options. +AMQP Transports +=============== + +There are 3 transports available for AMQP use. + +1. ``pyamqp`` uses the pure Python library ``amqp``, automatically + installed with Kombu. +2. ``librabbitmq`` uses the high performance transport written in C. + This requires the ``librabbitmq`` Python package to be installed, which + automatically compiles the C library. +3. ``amqp`` tries to use ``librabbitmq`` but falls back to ``pyamqp``. + +For the highest performance, you should install the ``librabbitmq`` package. +To ensure librabbitmq is used, you can explicitly specify it in the +transport URL, or use ``amqp`` to have the fallback. + Transport Comparison ====================