PKG-INFO 6.9 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154
  1. Metadata-Version: 1.2
  2. Name: amqp
  3. Version: 2.4.1
  4. Summary: Low-level AMQP client for Python (fork of amqplib).
  5. Home-page: http://github.com/celery/py-amqp
  6. Author: Barry Pederson
  7. Author-email: pyamqp@celeryproject.org
  8. Maintainer: Ask Solem
  9. License: BSD
  10. Description: =====================================================================
  11. Python AMQP 0.9.1 client library
  12. =====================================================================
  13. |build-status| |coverage| |license| |wheel| |pyversion| |pyimp|
  14. :Version: 2.4.1
  15. :Web: https://amqp.readthedocs.io/
  16. :Download: https://pypi.org/project/amqp/
  17. :Source: http://github.com/celery/py-amqp/
  18. :Keywords: amqp, rabbitmq
  19. About
  20. =====
  21. This is a fork of amqplib_ which was originally written by Barry Pederson.
  22. It is maintained by the Celery_ project, and used by `kombu`_ as a pure python
  23. alternative when `librabbitmq`_ is not available.
  24. This library should be API compatible with `librabbitmq`_.
  25. .. _amqplib: https://pypi.org/project/amqplib/
  26. .. _Celery: http://celeryproject.org/
  27. .. _kombu: https://kombu.readthedocs.io/
  28. .. _librabbitmq: https://pypi.org/project/librabbitmq/
  29. Differences from `amqplib`_
  30. ===========================
  31. - Supports draining events from multiple channels (``Connection.drain_events``)
  32. - Support for timeouts
  33. - Channels are restored after channel error, instead of having to close the
  34. connection.
  35. - Support for heartbeats
  36. - ``Connection.heartbeat_tick(rate=2)`` must called at regular intervals
  37. (half of the heartbeat value if rate is 2).
  38. - Or some other scheme by using ``Connection.send_heartbeat``.
  39. - Supports RabbitMQ extensions:
  40. - Consumer Cancel Notifications
  41. - by default a cancel results in ``ChannelError`` being raised
  42. - but not if a ``on_cancel`` callback is passed to ``basic_consume``.
  43. - Publisher confirms
  44. - ``Channel.confirm_select()`` enables publisher confirms.
  45. - ``Channel.events['basic_ack'].append(my_callback)`` adds a callback
  46. to be called when a message is confirmed. This callback is then
  47. called with the signature ``(delivery_tag, multiple)``.
  48. - Exchange-to-exchange bindings: ``exchange_bind`` / ``exchange_unbind``.
  49. - ``Channel.confirm_select()`` enables publisher confirms.
  50. - ``Channel.events['basic_ack'].append(my_callback)`` adds a callback
  51. to be called when a message is confirmed. This callback is then
  52. called with the signature ``(delivery_tag, multiple)``.
  53. - Authentication Failure Notifications
  54. Instead of just closing the connection abruptly on invalid
  55. credentials, py-amqp will raise an ``AccessRefused`` error
  56. when connected to rabbitmq-server 3.2.0 or greater.
  57. - Support for ``basic_return``
  58. - Uses AMQP 0-9-1 instead of 0-8.
  59. - ``Channel.access_request`` and ``ticket`` arguments to methods
  60. **removed**.
  61. - Supports the ``arguments`` argument to ``basic_consume``.
  62. - ``internal`` argument to ``exchange_declare`` removed.
  63. - ``auto_delete`` argument to ``exchange_declare`` deprecated
  64. - ``insist`` argument to ``Connection`` removed.
  65. - ``Channel.alerts`` has been removed.
  66. - Support for ``Channel.basic_recover_async``.
  67. - ``Channel.basic_recover`` deprecated.
  68. - Exceptions renamed to have idiomatic names:
  69. - ``AMQPException`` -> ``AMQPError``
  70. - ``AMQPConnectionException`` -> ConnectionError``
  71. - ``AMQPChannelException`` -> ChannelError``
  72. - ``Connection.known_hosts`` removed.
  73. - ``Connection`` no longer supports redirects.
  74. - ``exchange`` argument to ``queue_bind`` can now be empty
  75. to use the "default exchange".
  76. - Adds ``Connection.is_alive`` that tries to detect
  77. whether the connection can still be used.
  78. - Adds ``Connection.connection_errors`` and ``.channel_errors``,
  79. a list of recoverable errors.
  80. - Exposes the underlying socket as ``Connection.sock``.
  81. - Adds ``Channel.no_ack_consumers`` to keep track of consumer tags
  82. that set the no_ack flag.
  83. - Slightly better at error recovery
  84. Further
  85. =======
  86. - Differences between AMQP 0.8 and 0.9.1
  87. http://www.rabbitmq.com/amqp-0-8-to-0-9-1.html
  88. - AMQP 0.9.1 Quick Reference
  89. http://www.rabbitmq.com/amqp-0-9-1-quickref.html
  90. - RabbitMQ Extensions
  91. http://www.rabbitmq.com/extensions.html
  92. - For more information about AMQP, visit
  93. http://www.amqp.org
  94. - For other Python client libraries see:
  95. http://www.rabbitmq.com/devtools.html#python-dev
  96. .. |build-status| image:: https://secure.travis-ci.org/celery/py-amqp.png?branch=master
  97. :alt: Build status
  98. :target: https://travis-ci.org/celery/py-amqp
  99. .. |coverage| image:: https://codecov.io/github/celery/py-amqp/coverage.svg?branch=master
  100. :target: https://codecov.io/github/celery/py-amqp?branch=master
  101. .. |license| image:: https://img.shields.io/pypi/l/amqp.svg
  102. :alt: BSD License
  103. :target: https://opensource.org/licenses/BSD-3-Clause
  104. .. |wheel| image:: https://img.shields.io/pypi/wheel/amqp.svg
  105. :alt: Python AMQP can be installed via wheel
  106. :target: https://pypi.org/project/amqp/
  107. .. |pyversion| image:: https://img.shields.io/pypi/pyversions/amqp.svg
  108. :alt: Supported Python versions.
  109. :target: https://pypi.org/project/amqp/
  110. .. |pyimp| image:: https://img.shields.io/pypi/implementation/amqp.svg
  111. :alt: Support Python implementations.
  112. :target: https://pypi.org/project/amqp/
  113. Keywords: amqp rabbitmq cloudamqp messaging
  114. Platform: any
  115. Classifier: Development Status :: 5 - Production/Stable
  116. Classifier: Programming Language :: Python
  117. Classifier: Programming Language :: Python :: 2
  118. Classifier: Programming Language :: Python :: 2.7
  119. Classifier: Programming Language :: Python :: 3
  120. Classifier: Programming Language :: Python :: 3.4
  121. Classifier: Programming Language :: Python :: 3.5
  122. Classifier: Programming Language :: Python :: 3.6
  123. Classifier: License :: OSI Approved :: BSD License
  124. Classifier: Intended Audience :: Developers
  125. Classifier: Operating System :: OS Independent
  126. Requires-Python: >=2.7, !=3.0.*, !=3.1.*, !=3.2.*, !=3.3.*