1 # Buildsheet autogenerated by ravenadm tool -- Do not edit.
6 VARIANTS= py27 py36 py37
7 SDESC[py36]= Messaging library for Python (PY 36)
8 SDESC[py37]= Messaging library for Python (PY 37)
9 SDESC[py27]= Messaging library for Python (PY 27)
10 HOMEPAGE= https://kombu.readthedocs.io
11 CONTACT= Python_Automaton[python@ironwolf.systems]
14 SITES[main]= PYPI/k/kombu
15 DISTFILE[1]= kombu-4.2.1.tar.gz:main
21 OPTIONS_AVAILABLE= PY27 PY36 PY37
22 OPTIONS_STANDARD= none
23 VOPTS[py36]= PY27=OFF PY36=ON PY37=OFF
24 VOPTS[py37]= PY27=OFF PY36=OFF PY37=ON
25 VOPTS[py27]= PY27=ON PY36=OFF PY37=OFF
31 [PY36].BUILDRUN_DEPENDS_ON= python-amqp:single:py36
32 [PY36].USES_ON= python:py36
34 [PY37].BUILDRUN_DEPENDS_ON= python-amqp:single:py37
35 [PY37].USES_ON= python:py37
37 [PY27].BUILDRUN_DEPENDS_ON= python-amqp:single:py27
38 [PY27].USES_ON= python:py27
40 [FILE:4764:descriptions/desc.single]
41 ========================================
42 kombu - Messaging library for Python
43 ========================================
45 |build-status| |coverage| |license| |wheel| |pyversion| |pyimp|
48 :Web: http://kombu.me/
49 :Download: https://pypi.python.org/pypi/kombu/
50 :Source: https://github.com/celery/kombu/
51 :Keywords: messaging, amqp, rabbitmq, redis, mongodb, python, queue
56 `Kombu` is a messaging library for Python.
58 The aim of `Kombu` is to make messaging in Python as easy as possible by
59 providing an idiomatic high-level interface for the AMQ protocol, and also
60 provide proven and tested solutions to common messaging problems.
62 `AMQP`_ is the Advanced Message Queuing Protocol, an open standard protocol
63 for message orientation, queuing, routing, reliability and security,
64 for which the `RabbitMQ`_ messaging server is the most popular
70 * Allows application authors to support several message server
71 solutions by using pluggable transports.
73 * AMQP transport using the `py-amqp`_, `librabbitmq`_, or
74 `qpid-python`_ libraries.
76 * High performance AMQP transport written in C - when using
79 This is automatically enabled if librabbitmq is installed:
83 $ pip install librabbitmq
85 * Virtual transports makes it really easy to add support for non-AMQP
86 transports. There is already built-in support for `Redis`_,
87 `Amazon SQS`_, `ZooKeeper`_, `SoftLayer MQ`_ and `Pyro`_.
89 * In-memory transport for unit testing.
91 * Supports automatic encoding, serialization and compression of message
94 * Consistent exception handling across transports.
96 * The ability to ensure that an operation is performed by gracefully
97 handling connection and channel errors.
99 * Several annoyances with `amqplib`_ has been fixed, like supporting
100 timeouts and the ability to wait for events on more than one channel.
102 * Projects already using `carrot`_ can easily be ported by using
103 a compatibility layer.
105 For an introduction to AMQP you should read the article `Rabbits and
107 and the `Wikipedia article about AMQP`_.
109 .. _`RabbitMQ`: https://www.rabbitmq.com/
110 .. _`AMQP`: https://amqp.org
111 .. _`py-amqp`: https://pypi.python.org/pypi/amqp/
112 .. _`qpid-python`: https://pypi.python.org/pypi/qpid-python/
113 .. _`Redis`: https://redis.io
114 .. _`Amazon SQS`: https://aws.amazon.com/sqs/
115 .. _`Zookeeper`: https://zookeeper.apache.org/
116 .. _`Rabbits and warrens`:
117 http://web.archive.org/web/20160323134044/http://blogs.digitar.com/jjww/200
118 9/01/rabbits-and-warrens/
119 .. _`amqplib`: https://barryp.org/software/py-amqplib/
120 .. _`Wikipedia article about AMQP`: https://en.wikipedia.org/wiki/AMQP
121 .. _`carrot`: https://pypi.python.org/pypi/carrot/
122 .. _`librabbitmq`: https://pypi.python.org/pypi/librabbitmq
123 .. _`Pyro`: https://pythonhosting.org/Pyro4
124 .. _`SoftLayer MQ`: https://sldn.softlayer.com/reference/messagequeueapi
126 .. _transport-comparison:
131 +---------------+----------+------------+------------+---------------+-----
132 ---------+-----------------------+
133 | **Client** | **Type** | **Direct** | **Topic** | **Fanout** |
134 **Priority** | **TTL** |
135 +---------------+----------+------------+------------+---------------+-----
136 ---------+-----------------------+
137 | *amqp* | Native | Yes | Yes | Yes | Yes
138 [#f3]_ | Yes [#f4]_ |
139 +---------------+----------+------------+------------+---------------+-----
140 ---------+-----------------------+
141 | *qpid* | Native | Yes | Yes | Yes | No
143 +---------------+----------+------------+------------+---------------+-----
144 ---------+-----------------------+
145 | *redis* | Virtual | Yes | Yes | Yes (PUB/SUB) | Yes
147 +---------------+----------+------------+------------+---------------+-----
148 ---------+-----------------------+
149 | *mongodb* | Virtual | Yes | Yes | Yes | Yes
151 +---------------+----------+------------+------------+---------------+-----
152 ---------+-----------------------+
153 | *SQS* | Virtual | Yes | Yes [#f1]_ | Yes [#f2]_ | No
155 +---------------+----------+------------+------------+---------------+-----
156 ---------+-----------------------+
157 | *zookeeper* | Virtual | Yes | Yes [#f1]_ | No | Yes
159 +---------------+----------+------------+------------+---------------+-----
160 ---------+-----------------------+
161 | *in-memory* | Virtual | Yes | Yes [#f1]_ | No | No
166 86adec6c60f63124e2082ea8481bbe4ebe04fde8ebed32c177c7f0cd2c1c9082 423926 kombu-4.2.1.tar.gz