1 # Buildsheet autogenerated by ravenadm tool -- Do not edit.
6 VARIANTS= py27 py35 py36
7 SDESC[py35]= Low-level AMQP client for Python (fork of (PY 35)
8 SDESC[py36]= Low-level AMQP client for Python (fork of (PY 36)
9 SDESC[py27]= Low-level AMQP client for Python (fork of (PY 27)
10 HOMEPAGE= https://github.com/celery/py-amqp
11 CONTACT= Python_Automaton[python@ironwolf.systems]
14 SITES[main]= PYPI/a/amqp
15 DISTFILE[1]= amqp-2.2.2.tar.gz:main
21 OPTIONS_AVAILABLE= PY27 PY35 PY36
22 OPTIONS_STANDARD= none
23 VOPTS[py35]= PY27=OFF PY35=ON PY36=OFF
24 VOPTS[py36]= PY27=OFF PY35=OFF PY36=ON
25 VOPTS[py27]= PY27=ON PY35=OFF PY36=OFF
29 LICENSE= BSDGROUP:single
31 LICENSE_FILE= BSDGROUP:{{WRKSRC}}/LICENSE
35 [PY35].BUILDRUN_DEPENDS_ON= python-vine:single:py35
36 [PY35].USES_ON= python:py35
38 [PY36].BUILDRUN_DEPENDS_ON= python-vine:single:py36
39 [PY36].USES_ON= python:py36
41 [PY27].BUILDRUN_DEPENDS_ON= python-vine:single:py27
42 [PY27].USES_ON= python:py27
44 [FILE:4071:descriptions/desc.single]
45 =====================================================================
46 Python AMQP 0.9.1 client library
47 =====================================================================
49 |build-status| |coverage| |license| |wheel| |pyversion| |pyimp|
52 :Web: https://amqp.readthedocs.io/
53 :Download: http://pypi.python.org/pypi/amqp/
54 :Source: http://github.com/celery/py-amqp/
55 :Keywords: amqp, rabbitmq
60 This is a fork of amqplib_ which was originally written by Barry Pederson.
61 It is maintained by the Celery_ project, and used by `kombu`_ as a pure python
62 alternative when `librabbitmq`_ is not available.
64 This library should be API compatible with `librabbitmq`_.
66 .. _amqplib: http://pypi.python.org/pypi/amqplib
67 .. _Celery: http://celeryproject.org/
68 .. _kombu: https://kombu.readthedocs.io/
69 .. _librabbitmq: http://pypi.python.org/pypi/librabbitmq
71 Differences from `amqplib`_
72 ===========================
74 - Supports draining events from multiple channels (``Connection.drain_events``)
75 - Support for timeouts
76 - Channels are restored after channel error, instead of having to close the
78 - Support for heartbeats
80 - ``Connection.heartbeat_tick(rate=2)`` must called at regular intervals
81 (half of the heartbeat value if rate is 2).
82 - Or some other scheme by using ``Connection.send_heartbeat``.
83 - Supports RabbitMQ extensions:
84 - Consumer Cancel Notifications
85 - by default a cancel results in ``ChannelError`` being raised
86 - but not if a ``on_cancel`` callback is passed to ``basic_consume``.
88 - ``Channel.confirm_select()`` enables publisher confirms.
89 - ``Channel.events['basic_ack'].append(my_callback)`` adds a callback
90 to be called when a message is confirmed. This callback is then
91 called with the signature ``(delivery_tag, multiple)``.
92 - Exchange-to-exchange bindings: ``exchange_bind`` / ``exchange_unbind``.
93 - ``Channel.confirm_select()`` enables publisher confirms.
94 - ``Channel.events['basic_ack'].append(my_callback)`` adds a callback
95 to be called when a message is confirmed. This callback is then
96 called with the signature ``(delivery_tag, multiple)``.
97 - Authentication Failure Notifications
98 Instead of just closing the connection abruptly on invalid
99 credentials, py-amqp will raise an ``AccessRefused`` error
100 when connected to rabbitmq-server 3.2.0 or greater.
101 - Support for ``basic_return``
102 - Uses AMQP 0-9-1 instead of 0-8.
103 - ``Channel.access_request`` and ``ticket`` arguments to methods
105 - Supports the ``arguments`` argument to ``basic_consume``.
106 - ``internal`` argument to ``exchange_declare`` removed.
107 - ``auto_delete`` argument to ``exchange_declare`` deprecated
108 - ``insist`` argument to ``Connection`` removed.
109 - ``Channel.alerts`` has been removed.
110 - Support for ``Channel.basic_recover_async``.
111 - ``Channel.basic_recover`` deprecated.
112 - Exceptions renamed to have idiomatic names:
113 - ``AMQPException`` -> ``AMQPError``
114 - ``AMQPConnectionException`` -> ConnectionError``
115 - ``AMQPChannelException`` -> ChannelError``
116 - ``Connection.known_hosts`` removed.
117 - ``Connection`` no longer supports redirects.
118 - ``exchange`` argument to ``queue_bind`` can now be empty
119 to use the "default exchange".
120 - Adds ``Connection.is_alive`` that tries to detect
121 whether the connection can still be used.
122 - Adds ``Connection.connection_errors`` and ``.channel_errors``,
123 a list of recoverable errors.
124 - Exposes the underlying socket as ``Connection.sock``.
125 - Adds ``Channel.no_ack_consumers`` to keep track of consumer tags
126 that set the no_ack flag.
127 - Slightly better at error recovery
132 - Differences between AMQP 0.8 and 0.9.1
134 http://www.rabbitmq.com/amqp-0-8-to-0-9-1.html
136 - AMQP 0.9.1 Quick Reference
138 http://www.rabbitmq.com/amqp-0-9-1-quickref.html
140 - RabbitMQ Extensions
142 http://www.rabbitmq.com/extensions.html
144 - For more information about AMQP, visit
148 cba1ace9d4ff6049b190d8b7991f9c1006b443a5238021aca96dd6ad2ac9da22 103128 amqp-2.2.2.tar.gz