1 # Buildsheet autogenerated by ravenadm tool -- Do not edit.
6 VARIANTS= py27 py38 py37
7 SDESC[py37]= Low-level AMQP client (PY 37)
8 SDESC[py38]= Low-level AMQP client (PY 38)
9 SDESC[py27]= Low-level AMQP client (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.5.2.tar.gz:main
21 OPTIONS_AVAILABLE= PY27 PY38 PY37
22 OPTIONS_STANDARD= none
23 VOPTS[py37]= PY27=OFF PY38=OFF PY37=ON
24 VOPTS[py38]= PY27=OFF PY38=ON PY37=OFF
25 VOPTS[py27]= PY27=ON PY38=OFF PY37=OFF
33 [PY37].BUILDRUN_DEPENDS_ON= python-vine:single:py37
34 [PY37].USES_ON= python:py37
36 [PY38].BUILDRUN_DEPENDS_ON= python-vine:single:py38
37 [PY38].USES_ON= python:py38
39 [PY27].BUILDRUN_DEPENDS_ON= python-vine:single:py27
40 [PY27].USES_ON= python:py27
42 [FILE:4064:descriptions/desc.single]
43 =====================================================================
44 Python AMQP 0.9.1 client library
45 =====================================================================
47 |build-status| |coverage| |license| |wheel| |pyversion| |pyimp|
50 :Web: https://amqp.readthedocs.io/
51 :Download: https://pypi.org/project/amqp/
52 :Source: http://github.com/celery/py-amqp/
53 :Keywords: amqp, rabbitmq
58 This is a fork of amqplib_ which was originally written by Barry Pederson.
59 It is maintained by the Celery_ project, and used by `kombu`_ as a pure
61 alternative when `librabbitmq`_ is not available.
63 This library should be API compatible with `librabbitmq`_.
65 .. _amqplib: https://pypi.org/project/amqplib/
66 .. _Celery: http://celeryproject.org/
67 .. _kombu: https://kombu.readthedocs.io/
68 .. _librabbitmq: https://pypi.org/project/librabbitmq/
70 Differences from `amqplib`_
71 ===========================
73 - Supports draining events from multiple channels
74 (``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
82 (half of the heartbeat value if rate is 2).
83 - Or some other scheme by using ``Connection.send_heartbeat``.
84 - Supports RabbitMQ extensions:
85 - Consumer Cancel Notifications
86 - by default a cancel results in ``ChannelError`` being raised
87 - but not if a ``on_cancel`` callback is passed to
90 - ``Channel.confirm_select()`` enables publisher confirms.
91 - ``Channel.events['basic_ack'].append(my_callback)`` adds a
93 to be called when a message is confirmed. This callback is then
94 called with the signature ``(delivery_tag, multiple)``.
95 - Exchange-to-exchange bindings: ``exchange_bind`` /
97 - ``Channel.confirm_select()`` enables publisher confirms.
98 - ``Channel.events['basic_ack'].append(my_callback)`` adds a
100 to be called when a message is confirmed. This callback is then
101 called with the signature ``(delivery_tag, multiple)``.
102 - Authentication Failure Notifications
103 Instead of just closing the connection abruptly on invalid
104 credentials, py-amqp will raise an ``AccessRefused`` error
105 when connected to rabbitmq-server 3.2.0 or greater.
106 - Support for ``basic_return``
107 - Uses AMQP 0-9-1 instead of 0-8.
108 - ``Channel.access_request`` and ``ticket`` arguments to methods
110 - Supports the ``arguments`` argument to ``basic_consume``.
111 - ``internal`` argument to ``exchange_declare`` removed.
112 - ``auto_delete`` argument to ``exchange_declare`` deprecated
113 - ``insist`` argument to ``Connection`` removed.
114 - ``Channel.alerts`` has been removed.
115 - Support for ``Channel.basic_recover_async``.
116 - ``Channel.basic_recover`` deprecated.
117 - Exceptions renamed to have idiomatic names:
118 - ``AMQPException`` -> ``AMQPError``
119 - ``AMQPConnectionException`` -> ConnectionError``
120 - ``AMQPChannelException`` -> ChannelError``
121 - ``Connection.known_hosts`` removed.
122 - ``Connection`` no longer supports redirects.
123 - ``exchange`` argument to ``queue_bind`` can now be empty
124 to use the "default exchange".
125 - Adds ``Connection.is_alive`` that tries to detect
126 whether the connection can still be used.
127 - Adds ``Connection.connection_errors`` and ``.channel_errors``,
128 a list of recoverable errors.
129 - Exposes the underlying socket as ``Connection.sock``.
130 - Adds ``Channel.no_ack_consumers`` to keep track of consumer tags
131 that set the no_ack flag.
132 - Slightly better at error recovery
137 - Differences between AMQP 0.8 and 0.9.1
139 http://www.rabbitmq.com/amqp-0-8-to-0-9-1.html
141 - AMQP 0.9.1 Quick Reference
143 http://www.rabbitmq.com/amqp-0-9-1-quickref.html
145 - RabbitMQ Extensions
147 http://www.rabbitmq.com/extensions.html
149 - For more information about AMQP, visit
153 77f1aef9410698d20eaeac5b73a87817365f457a507d82edf292e12cbb83b08d 117788 amqp-2.5.2.tar.gz