summaryrefslogtreecommitdiff
path: root/docs
diff options
context:
space:
mode:
authorAsk Solem <ask@celeryproject.org>2012-11-05 13:27:07 +0000
committerAsk Solem <ask@celeryproject.org>2012-11-05 13:27:07 +0000
commitaa0323e3983ac53888aff653bf7cd0103ebea79d (patch)
treee6f838967c8e73def9d1d871bed10d41d4e9fe28 /docs
parent02262aab38c6d9955aaba995bae066655650c3a3 (diff)
downloadkombu-aa0323e3983ac53888aff653bf7cd0103ebea79d.tar.gz
py-amqp replaces amqplib as the default transport
Diffstat (limited to 'docs')
-rw-r--r--docs/reference/index.rst4
-rw-r--r--docs/userguide/connections.rst23
2 files changed, 16 insertions, 11 deletions
diff --git a/docs/reference/index.rst b/docs/reference/index.rst
index f162067a..f55ca799 100644
--- a/docs/reference/index.rst
+++ b/docs/reference/index.rst
@@ -23,11 +23,11 @@
kombu.abstract
kombu.syn
kombu.transport
- kombu.transport.amqplib
- kombu.transport.librabbitmq
kombu.transport.pyamqp
+ kombu.transport.librabbitmq
kombu.transport.pika
kombu.transport.pika2
+ kombu.transport.amqplib
kombu.transport.memory
kombu.transport.redis
kombu.transport.zmq
diff --git a/docs/userguide/connections.rst b/docs/userguide/connections.rst
index 52e1c17a..d7275ea4 100644
--- a/docs/userguide/connections.rst
+++ b/docs/userguide/connections.rst
@@ -10,8 +10,8 @@ Basics
======
To send and receive messages you need a transport and a connection.
-There are several transports to choose from (amqplib, pika, redis, in-memory),
-and you can even create your own. The default transport is amqplib.
+There are several transports to choose from (amqp, librabbitmq, redis, in-memory, etc.),
+and you can even create your own. The default transport is amqp.
Create a connection using the default transport::
@@ -110,8 +110,8 @@ keyword arguments, these are:
:port: Default port if not provided in the URL.
:transport: Default transport if not provided in the URL.
Can be a string specifying the path to the class. (e.g.
- ``kombu.transport.pyamqplib.Transport``), or one of the aliases:
- ``amqplib``, ``pika``, ``redis``, ``memory``, and so on.
+ ``kombu.transport.pyamqp:Transport``), or one of the aliases:
+ ``pyamqp``, ``librabbitmq``, ``redis``, ``memory``, and so on.
:ssl: Use SSL to connect to the server. Default is ``False``.
Only supported by the amqp transport.
@@ -132,17 +132,17 @@ Transport Comparison
+---------------+----------+------------+------------+---------------+
| **Client** | **Type** | **Direct** | **Topic** | **Fanout** |
+---------------+----------+------------+------------+---------------+
-| *amqplib* | Native | Yes | Yes | Yes |
+| *amqp* | Native | Yes | Yes | Yes |
+---------------+----------+------------+------------+---------------+
-| *pika* | Native | Yes | Yes | Yes |
+| *redis* | Virtual | Yes | Yes | Yes (PUB/SUB) |
+---------------+----------+------------+------------+---------------+
-| *redis* | Virtual | Yes | Yes [#f1]_ | Yes (PUB/SUB) |
+| *mongodb* | Virtual | Yes | Yes | Yes |
+---------------+----------+------------+------------+---------------+
| *beanstalk* | Virtual | Yes | Yes [#f1]_ | No |
+---------------+----------+------------+------------+---------------+
| *SQS* | Virtual | Yes | Yes [#f1]_ | Yes [#f2]_ |
+---------------+----------+------------+------------+---------------+
-| *mongodb* | Virtual | Yes | Yes [#f1]_ | No |
+| *pika* | Native | Yes | Yes | Yes |
+---------------+----------+------------+------------+---------------+
| *couchdb* | Virtual | Yes | Yes [#f1]_ | No |
+---------------+----------+------------+------------+---------------+
@@ -150,10 +150,15 @@ Transport Comparison
+---------------+----------+------------+------------+---------------+
| *in-memory* | Virtual | Yes | Yes [#f1]_ | No |
+---------------+----------+------------+------------+---------------+
+| *django* | Virtual | Yes | Yes [#f1]_ | No |
++---------------+----------+------------+------------+---------------+
+| *sqlalchemy* | Virtual | Yes | Yes [#f1]_ | No |
++---------------+----------+------------+------------+---------------+
.. [#f1] Declarations only kept in memory, so exchanges/queues
must be declared by all clients that needs them.
.. [#f2] Fanout supported via storing routing tables in SimpleDB.
- Can be disabled by setting the ``supports_fanout`` transport option.
+ Disabled by default, but can be enabled by using the
+ ``supports_fanout`` transport option.