NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
PyPI, #451 most downloaded on PyPI
Messaging library for Python.
Latest stable
5.7.0
Last release 10 days ago
03 Nov 2026
Ships unpredictably
gaps range from 2 weeks to 9 months
Nearly every release is documented
notes for 58 of the last 60 stable releases
2 versions withdrawn
withdrawn after publishing
16 years old
210 releases · first in 2010
Drag across the ruler to compare, or tap a release to open it.
importlib_metadata remove deprecated entry point interfaces by @woutdenolf in https://github.com/celery/kombu/pull/1601
mypy to the pipeline by @Kludex in https://github.com/celery/kombu/pull/1512utils/uuid.py and utils/text.py by @Kludex in https://github.com/celery/kombu/pull/1514__exit__ function signatures by @sondrelg in https://github.com/celery/kombu/pull/1524--py37-plus for pyupgrade and add __future__.annotations import by @Kludex in https://github.com/celery/kombu/pull/1531exceptions.py and clocks.py by @Kludex in https://github.com/celery/kombu/pull/1526abstract.py by @Kludex in https://github.com/celery/kombu/pull/1522matcher.py by @Kludex in https://github.com/celery/kombu/pull/1532Connection.ensure() to retry on specific exceptions given by policy by @Nusnus in https://github.com/celery/kombu/pull/1629_setupfuns from serialization.py by @last-partizan in https://github.com/celery/kombu/pull/1658setup.py by @stegayet in https://github.com/celery/kombu/pull/1711Full Changelog: https://github.com/celery/kombu/compare/v5.2.4...v5.3.0
Your coding agent can read these notes before it upgrades. Set up the MCP server →
Support for Kafka as transport.
Add fanout to filesystem (#1499).
Added possibility to serialize and deserialize binary messages in json (#1516).
Support pymongo 4.x (#1536).
Support redis-py 4.5.x.
Upgrade Azure Storage Queues transport to version 12 (#1539).
Add support to SQS DelaySeconds (#1567).
Add WATCH to prefixed complex commands.
Avoid losing type of UUID when serializing/deserializing (#1575).
Added HLEN to the list of prefixed redis commands (#1540).
Add managed identity support to azure storage queue (#1631).
Add Support of sqlalchemy v2.0.
Deprecate pytz and use zoneinfo (#1680)
add missing zoneinfo dependency by @woutdenolf in https://github.com/celery/kombu/pull/1732
Full Changelog: https://github.com/celery/kombu/compare/v5.3.0rc1...v5.3.0rc2
add missing zoneinfo dependency (#1732).
Support redis >= 4.5.2
Loosen urlib3 version range for botocore compat
Deprecate pytz and use zoneinfo by @max-muoto in https://github.com/celery/kombu/pull/1680
setup.py by @stegayet in https://github.com/celery/kombu/pull/1711Full Changelog: https://github.com/celery/kombu/compare/v5.3.0b3...v5.3.0rc1
Moved to pytest-freezer (#1683).
Deprecate pytz and use zoneinfo (#1680).
handle keyerror in azureservicebus transport when message is not
found in qos and perform basic_ack (#1691). - fix mongodb transport obsolete calls (#1694). - SQS: avoid excessive GetQueueURL calls by using cached queue url (#1621). - Update confluentkafka.txt version (#1727). - Revert back to pyro4 for now.
Use SPDX license expression in project metadata by @RazerM in https://github.com/celery/kombu/pull/1616
Connection.ensure() to retry on specific exceptions given by policy by @Nusnus in https://github.com/celery/kombu/pull/1629_setupfuns from serialization.py by @last-partizan in https://github.com/celery/kombu/pull/1658Full Changelog: https://github.com/celery/kombu/compare/v5.3.0b2...v5.3.0b3
Use SPDX license expression in project metadata.
Allowing Connection.ensure() to retry on specific exceptions given by policy (#1629).
Redis==4.3.4 temporarilly in an attempt to avoid BC (#1634).
Add managed identity support to azure storage queue (#1631).
Support sqla v2.0 (#1651).
Switch to Pyro5 (#1655).
Remove unused _setupfuns from serialization.py.
Refactor: Refactor utils/json (#1659).
Adapt the mock to correctly mock the behaviors as implemented on Python 3.10. (Ref #1663).
importlib_metadata remove deprecated entry point interfaces by @woutdenolf in https://github.com/celery/kombu/pull/1601
Full Changelog: https://github.com/celery/kombu/compare/v5.3.0b1...v5.3.0b2
fix: save QueueProperties to _queue_name_cache instead of QueueClient.
hub: tick delay fix (#1587).
Fix incompatibility with redis in disconnect() (#1589).
Solve Kombu filesystem transport not thread safe.
importlib_metadata remove deprecated entry point interfaces (#1601).
Allow azurestoragequeues transport to be used with Azurite emulator in docker-compose (#1611).
Add ext.py files to setup.cfg by @Kludex in https://github.com/celery/kombu/pull/1566
Full Changelog: https://github.com/celery/kombu/compare/v5.3.0a1...v5.3.0b1
Add ext.py files to setup.cfg.
Add support to SQS DelaySeconds (#1567).
Add WATCH to prefixed complex commands.
Avoid losing type of UUID when serializing/deserializing (#1575).
chore: add confluentkafka to extras.
[pre-commit.ci] pre-commit autoupdate by @pre-commit-ci in https://github.com/celery/kombu/pull/1502
mypy to the pipeline by @Kludex in https://github.com/celery/kombu/pull/1512utils/uuid.py and utils/text.py by @Kludex in https://github.com/celery/kombu/pull/1514__exit__ function signatures by @sondrelg in https://github.com/celery/kombu/pull/1524--py37-plus for pyupgrade and add __future__.annotations import by @Kludex in https://github.com/celery/kombu/pull/1531exceptions.py and clocks.py by @Kludex in https://github.com/celery/kombu/pull/1526abstract.py by @Kludex in https://github.com/celery/kombu/pull/1522matcher.py by @Kludex in https://github.com/celery/kombu/pull/1532Full Changelog: https://github.com/celery/kombu/compare/v5.2.4...v5.3.0a1
Add fanout to filesystem (#1499).
Protect set of ready tasks by lock to avoid concurrent updates. (#1489).
Correct documentation stating kombu uses pickle protocol version 2.
Use new entry_points interface.
Add mypy to the pipeline (#1512).
Added possibility to serialize and deserialize binary messages in json (#1516).
Bump pyupgrade version and add __future__.annotations import.
json.py cleaning from outdated libs (#1533).
bump new py-amqp to 5.1.1 (#1534).
add GitHub URL for PyPi.
Upgrade pytest to ~=7.1.1.
Support pymongo 4.x (#1536).
Initial Kafka support (#1506).
Upgrade Azure Storage Queues transport to version 12 (#1539).
move to consul2 (#1544).
Datetime serialization and deserialization fixed (#1515).
Bump redis>=4.2.2 (#1546).
Update sqs dependencies (#1547).
Added HLEN to the list of prefixed redis commands (#1540).
Added some type annotations.
allow getting recoverable_connection_errors without an active transport by @pawl in https://github.com/celery/kombu/pull/1471
Full Changelog: https://github.com/celery/kombu/compare/v5.2.3...v5.2.4
Allow getting recoverable_connection_errors without an active transport.
Prevent KeyError: 'purelib' by removing INSTALLED_SCHEME hack from setup.py.
Revert "try pining setuptools (#1466)" (#1481).
Fix issue #789: Async http code not allowing for proxy config (#790).
Fix The incorrect times of retrying.
Set redelivered property for Celery with Redis (#1484).
Remove use of OrderedDict in various places (#1483).
Warn about missing hostname only when default one is available (#1488).
All supported versions of Python define __package__.
Added global_keyprefix support for pubsub clients (#1495).
try pytest 7 (#1497).
Add an option to not base64-encode SQS messages.
Fix SQS extract_task_name message reference.
create codeql actions by @auvipy in https://github.com/celery/kombu/pull/1441
Full Changelog: https://github.com/celery/kombu/compare/v5.2.2...v5.2.3
Allow redis >= 4.0.2.
Fix PyPy CI jobs.
SQS transport: detect FIFO queue properly by checking queue URL (#1450).
Ensure that restore is atomic in redis transport (#1444).
Restrict setuptools>=59.1.1,<59.7.0.
Bump minimum py-amqp to v5.0.9 (#1462).
Reduce memory usage of Transport (#1470).
Prevent event loop polling on closed redis transports (and causing leak).
Respect connection timeout (#1458)
prevent redis event loop stopping on 'consumer: Cannot connect' (#1477).
[pre-commit.ci] pre-commit autoupdate by @pre-commit-ci in https://github.com/celery/kombu/pull/1430
Full Changelog: https://github.com/celery/kombu/compare/v5.2.1...v5.2.2
Pin redis version to >= 3.4.1<4.0.0 as it is not fully compatible yet.
Added integration test of failed authentication to redis by @matusvalo in https://github.com/celery/kombu/pull/1423
Full Changelog: https://github.com/celery/kombu/compare/v5.2.0...v5.2.1
Bump redis version to >= 3.4.1.
try latest sqs dependencies ti fix security warning.
Tests & dependency updates
Revert "Added redis transport key_prefix from envvars" by @matusvalo in https://github.com/celery/kombu/pull/1249
SentinelChannel by @matusvalo in https://github.com/celery/kombu/pull/1253{} if not defined by @infinitewarp in https://github.com/celery/kombu/pull/1372Full Changelog: https://github.com/celery/kombu/compare/v5.0.2...v5.2.0
v 1.4.x (#1338).
stop mentioning librabbitmq (#1381).
Merge branch 'master' of https://github.com/celery/kombu
test new pytest version (#1383).
drop python 3.6 from CI (#1382).
Use ANY from unittest instead of case.mock.
Fix missing dependency to redis in docs requirements.
[pre-commit.ci] pre-commit autoupdate.
Remove dependency to case (#1389).
Fix: check redis response type.
[pre-commit.ci] pre-commit autoupdate (#1393).
py3.7+ on setup (#1392).
Prevent caching of oid in pidbox (#1394).
Added unittests for #1394 .
fix flake8 in kombu/asynchronous/aws/connection.py (#1397).
[pre-commit.ci] pre-commit autoupdate.
Fix test_pidbox unittests to support non-linux platforms (#1398).
[pre-commit.ci] pre-commit autoupdate.
removre bdist.
add python 3.10 to CI & fix other issues (#1402).
try to fix CI (#1407).
Dont failfast when pypy3 tests fail (#1408).
Return empty list instead of InconsistencyError when exchange table is empty (#1404).
[pre-commit.ci] pre-commit autoupdate.
:release-date: 2021-09-07 7:00 P.M UTC+6:00 :release-by: Asif Saif Uddin
:release-date: 2021-09-07 7:00 P.M UTC+6:00 :release-by: Asif Saif Uddin
:release-date: 2021-05-23 7:00 P.M UTC+3:00 :release-by: Omer Katz
Fix queue names special characters replacement for Azure Service Bus. (#1324)
Add support for SQLAlchemy 1.4. (#1328)
Coerce seconds argument to a floating point number in Timer.enter_after. (#1330)
Add accept parameter to SimpleQueue class. (#1140)
prepare_accept_content() now raises SerializerNotInstalled instead of KeyError. (#1343)
:release-date: 2021-04-01 10:30 P.M UTC+6:00 :release-by: Asiff Saif Uddin
:release-date: 2021-04-01 10:30 P.M UTC+6:00 :release-by: Asiff Saif Uddin
SentinelChannel (#1253).:release-date: 2020-09-06 6:30 P.M UTC+3:00 :release-by: Omer Katz
Bump required amqp version to 5.0.0.
:release-date: 2020-08-23 19:10 P.M UTC+3:00 :release-by: Omer Katz
Removed kombu.five from the reference documentation since it no longer exists
Adjusted the stable documentation's version in Sphinx's configuration since that was overlooked in the latest release
BREAKING CHANGE: Dropped support for Python 2
BREAKING CHANGE: Dropped support for Python 2 (#1232)
Add an SQS transport option for custom botocore config (#1219)
:release-date: 2020-06-24 1.15 P.M UTC+6:00 :release-by: Asif Saif Uddin
Revert incompatible changes in #1193 and additional improvements (#1211)
Default_channel should reconnect automatically (#1209)
:release-date: 2020-06-03 10.45 A.M UTC+6:00 :release-by: Asif Saif Uddin
:release-date: 2020-06-03 10.45 A.M UTC+6:00 :release-by: Asif Saif Uddin
Doc improvement.
set _connection in _ensure_connection (#1205)
Fix for the issue #1172
reuse connection [bug fix]
SQLAlchemy transport: Use Query.with_for_update() instead of deprecated
Prevent failure if AWS creds are not explicitly defined on predefined.
Raise RecoverableConnectionError in maybe_declare with retry on and.
Fix for the issue #1172 .
possible fix for #1174 .
Fix: make SQLAlchemy Channel init thread-safe
Added integration testing infrastructure for RabbitMQ
Initial redis integration tests implementation
SQLAlchemy transport: Use Query.with_for_update() instead of deprecated
Fix Consumer Encoding
Added Integration tests for direct, topic and fanout exchange types
Added TTL integration tests
Added integration tests for priority queues
fix 100% cpu usage on linux while using sqs
Modified Mutex to use redis LuaLock implementation
Fix: eliminate remaining race conditions from SQLAlchemy Channel
Fix connection imaybe_declare (#1196)
Fix for issue #1198: Celery crashes in cases where there aren’t enough
Ensure connection when connecting to broker
update pyamqp to 2.6 with optional cythonization
:release-date: 2020-03-29 20:45 A.M UTC+6:00 :release-by: Asif Saif Uddin
Added support for health_check_interval option in broker_transport_options (#1145)
Added retry_on_timeout parameter to Redis Channel (#1150)
Added support for standard values for ssl_cert_reqs query parameter for Redis (#1139)
Added predefined_queues option to SQS transport (#1156)
Added ssl certificate verification against ca certificates when amqps is used for pyamqp transport (#1151)
Fix issue (#701) where kombu.transport.redis.Mutex is broken in python 3 (#1141)
Fix brop error in Redis Channel (#1144)
:release-date: 2019-12-07 20:45 A.M UTC+6:00 :release-by: Asif Saif Uddin
Use importlib.metadata from the standard library on Python 3.8+ (#1086).
Add peek lock settings to be changed using transport options (#1119).
Fix redis health checks (#1122).
Reset ready before execute callback (#1126).
Add missing parameter queue_args in kombu.connection.SimpleBuffer (#1128)
:release-date: 2019-11-11 00:15 A.M UTC+6:00 :release-by: Asif Saif Uddin
Revert _lookup_direct and related changes of redis.
Python 3.8 support
Fix 'NoneType' object has no attribute 'can_read' bug of redis transport
Issue #1019 Fix redis transport socket timeout
Add wait timeout settings to receive queue message (#1110)
Bump py-amqp to 2.5.2
:release-date: 2019-09-30 19:30 P.M UTC+6:00 :release-by: Asif Saif Uddin
Revert _lookup api and correct redis implemetnation.
Major overhaul of redis test cases by adding more full featured fakeredis module.
Add more test cases to boost coverage of kombu redis transport.
Refactor the producer consumer test cases to be based on original mocks and be passing
Fix lingering line length issue in test.
Sanitise url when include_password is false
Pinned pycurl to 7.43.0.2 as it is the latest build with wheels provided
Bump py-amqp to 2.5.2
:release-date: 2019-08-14 22:45 P.M UTC+6:00 :release-by: Asif Saif Uddin
Use importlib-metadata instead of pkg_resources for better performance
Allow users to switch URLs while omitting the resource identifier (#1032)
Don't stop receiving tasks on 503 SQS error. (#1064)
Fix maybe declare (#1066)
Revert "Revert "Use SIMEMBERS instead of SMEMBERS to check for queue (Redis Broker)
Fix MongoDB backend to work properly with TTL (#1076)
Make sure that max_retries=0 is treated differently than None (#1080)
Bump py-amqp to 2.5.1
:release-date: 2019-06-15 12:45 A.M UTC+6:00 :release-by: Asif Saif Uddin
Revert FastUUID for kombu 4.6
:release-date: 2019-06-15 12:45 A.M UTC+6:00 :release-by: Asif Saif Uddin
Fix sbugs and regressions
:release-date: 2019-06-06 10:30 A.M UTC+6:00 :release-by: Asif Saif Uddin
Fix some newly introduced bug in kombu 4.6
:release-date: 2019-05-30 15:30 P.M UTC+6:00 :release-by: Asif Saif Uddin
Dropped python 3.4
Bump py-amqp to 2.5.0
Use SIMEMBERS instead of SMEMBERS to check for queue (redis broker)
Add _lookup_direct method to virtual channel. (#994)
Add possibility to optimize lookup for queue in direct exchange set.
Add _lookup_direct method to redis virtual channel. (#994)
Use SISMEMBER instead of SMEMBERS command to check if queue exists in a set. Time complexity is increased from O(N) to O(1) where N is the set cardinality.
Contributed by Stevan Milic and Asif Saif Uddin
Include priority in properties only if it's not None. Since we attempt to serialize the priority property if it exists in the dictionary it must be an integer.
Contributed by Omer Katz
Removed dangerous default mutable arguments from function definitions where appropriate.
Contributed by Todd Cook
Codebase improvements and fixes by:
Omer Katz
Asif Saif Uddin
:release-date: 2019-03-3 18:30 P.M UTC+3:00 :release-by: Omer Katz
The Redis transport now supports a custom separator for keys.
Previously when storing a key in Redis which represents a queue we used the hardcored value \x06\x16 separator to store different attributes of the queue in the queue's name.
The separator is now configurable using the sep transport option:
with Connection('redis://', transport_options={
'sep': ':',
}):
# ...
pass
Contributed by Joris Beckers
When the SQS server returns a timeout we ignore it and keep trying instead of raising an error.
This will prevent Celery from raising an error and hanging.
Contributed by Erwin Rossen
Properly declare async support for the Qpid transport.
If you are using this transport we strongly urge you to upgrade.
Contributed by Rohan McGovern
Revert celery/kombu#906 and introduce unique broadcast queue names as an optional keyword argument.
If you want each broadcast queue to have a unique name specify unique=True:
>>> from kombu.common import Broadcast
>>> q = Broadcast(queue='foo', unique=True)
>>> q.name
'foo.7ee1ac20-cda3-4966-aaf8-e7a3bb548688'
>>> q = Broadcast(queue='foo')
>>> q.name
'foo'
Codebase improvements and fixes by:
Omer Katz
:release-date: 2019-03-3 9:00 P.M UTC+2:00 :release-by: Omer Katz
Restore bz2 import checks in compression module.
The checks were removed in celery/kombu#938 due to assumption that it only affected Jython. However, bz2 support can be missing in Pythons built without bz2 support.
Contributed by Patrick Woods
Fix regression that occurred in 4.3.0 when parsing Redis Sentinel master URI containing password.
Contributed by Peter Lithammer
Handle the case when only one Redis Sentinel node is provided.
Contributed by Peter Lithammer
Support SSL URL parameters correctly for rediss://` URIs.
Contributed by Paul Bailey
Revert celery/kombu#954. Instead bump the required redis-py dependency to 3.2.0 to include this fix andymccurdy/redis-py@4e1e748.
Contributed by Peter Lithammer
Added support for broadcasting using a regular expression pattern or a glob pattern to multiple Pidboxes.
Contributed by Jason Held
:release-date: 2019-01-14 7:00 P.M UTC+2:00 :release-by: Omer Katz
Added Python 3.7 support.
Contributed by Omer Katz, Mads Jensen and Asif Saif Uddin
Avoid caching queues which are declared with a TTL.
Queues that are declared with a TTL are now also be excluded from the in-memory cache in case they expire between publishes on the same channel.
Contributed by Matt Yule-Bennett
Added an index to the Message table for the SQLAlchemy transport.
The index allows to effectively sorting the table by the message's timestamp.
Note
We do not provide migrations for this model yet. You will need to add the index manually if you are already using the SQLAlchemy transport.
The syntax may vary between databases. Please refer to your database's documentation for instructions.
Contributed by Mikhail Shcherbinin
Added a timeout that limits the amount of time we retry to reconnect to a transport.
Contributed by :github_user:`tothegump`
:class:celery.asynchronous.hub.Hub is now reentrant.
This allows calling celery.bin.celery.main to revive a worker in the same process after rescuing from shutdown (:class:SystemExit).
Contributed by Alan Justino da Silva
Queues now accept string exchange names as arguments as documented.
Tests were added to avoid further regressions.
Contributed by Antonio Gutierrez
Specifying names for broadcast queues now work as expected.
Previously, named broadcast queues did not create multiple queues per worker. They incorrectly declared the named queue which resulted in one queue per fanout exchange, thus missing the entire point of a fanout exchange. The behavior is now matched to unnamed broadcast queues.
Contributed by Kuan Hsuan-Tso
When initializing the Redis transport in conjunction with gevent restore all unacknowledged messages to queue.
Contributed by Gal Cohen
Allow :class:kombu.simple.SimpleQueue to pass queue_arguments to Queue object.
This allows :class:kombu.simple.SimpleQueue to connect to RabbitMQ queues with custom arguments like 'x-queue-mode'='lazy'.
Contributed by C Blue Neeh
Add support for 'rediss' scheme for secure Redis connections.
The rediss scheme defaults to the least secure form, as there is no suitable default location for ca_certs. The recommendation would still be to follow the documentation and specify broker_use_ssl if coming from celery.
Contributed by Daniel Blair
Added the Azure Storage Queues transport.
The transport is implemented on top of Azure Storage Queues. This offers a simple but scalable and low-cost PaaS transport for Celery users in Azure. The transport is intended to be used in conjunction with the Azure Block Blob Storage backend.
Contributed by Clemens Wolff, :github_user:`@ankurokok`, Denis Kisselev, Evandro de Paula, Martin Peck and :github_user:`@michaelperel`
Added the Azure Service Bus transport.
The transport is implemented on top of Azure Service Bus and offers PaaS support for more demanding Celery workloads in Azure. The transport is intended to be used in conjunction with the Azure CosmosDB backend.
Contributed by Clemens Wolff, :github_user:`@ankurokok`, Denis Kisselev, Evandro de Paula, Martin Peck and :github_user:`@michaelperel`
Drop remaining mentions of Jython support completely.
Contributed by Asif Saif Uddin and Mads Jensen
When publishing messages to the Pidbox, retry if an error occurs.
Contributed by Asif Saif Uddin
Fix infinite loop in :method:kombu.asynchronous.hub.Hub.create_loop.
Previous attempt to fix the problem (PR kombu/760) did not consider an edge case. It is now fixed.
Contributed by Vsevolod Strukchinsky
Worker shutdown no longer duplicates messages when using the SQS broker.
Contributed by Mintu Kumar Sah
When using the SQS broker, prefer boto's default region before our hardcoded default.
Contributed by Victor Villas
Fixed closing of shared redis sockets which previously caused Celery to hang.
Contributed by Alexey Popravka
the `Pyro`_ transport (kombu.transport.pyro) now works with recent Pyro versions. Also added a Pyro Kombu Broker that this transport needs for its queues.
Contributed by Irmen de Jong
Handle non-base64-encoded SQS messages.
Fix contributed by Tim Li, Asif Saif Uddin and Omer Katz.
Move the handling of Sentinel failures to the redis library itself.
Previously, Redis Sentinel worked only if the first node's sentinel service in the URI was up. A server outage would have caused downtime.
Contributed by Brian Price
When using Celery and the pickle serializer with binary data as part of the payload, UnicodeDecodeError would be raised as the content was not utf-8. We now replace on errors.
Contributed by Jian Dai
Allow setting :method:boto3.sqs.create_queue Attributes via transport_options.
Contributed by Hunter Fernandes
Fixed infinite loop when entity.channel is replaced by revive() on connection drop.
Contributed by Tzach Yarimi
Added optional support for Brotli compression.
Contributed by Omer Katz
When using the SQS broker, FIFO queues with names that ended with the 'f' letter were incorrectly parsed. This is now fixed.
Contributed by Alex Vishnya and Ilya Konstantinov
Added optional support for LZMA compression.
Contributed by Omer Katz
Added optional support for ZStandard compression.
Contributed by Omer Katz
Require py-amqp 2.4.0 as the minimum version.
Contributed by Asif Saif Uddin
The value of DISABLE_TRACEBACKS environment variable is now respected on debug, info and warning logger level.
Contributed by Ludovic Rivallain
As documented in kombu/#741 and eventlet/eventlet#415 there is a mismatch between the monkey-patched eventlet queue and the interface Kombu is expecting. This causes Celery to crash when the broker_pool_limit configuration option is set eventlet/eventlet#415 suggests that the mutex can be a noop. This is now the case.
Contributed by Josh Morrow
Codebase improvements and fixes by:
Omer Katz
Mads Jensen
Asif Saif Uddin
Lars Rinn
Documentation improvements by:
Jon Dufresne
Fay Cheng
Asif Saif Uddin
Kyle Verhoog
Noah Hall
:github_user:`brabiega`
:release-date: 2019-01-01 04:00 P.M IST :release-by: Omer Katz
Note
The previous release contained code from master. It is now deleted from PyPi. Please use this release instead.
No changes since previous release.
:release-date: 2018-05-21 09:00 A.M IST :release-by: Omer Katz
Note
The 4.2.0 release contained remains of the async module by accident. This is now fixed.
Handle librabbitmq fileno raising a ValueError when socket is not connected.
Contributed by Bryan Shelton
:release-date: 2018-05-21 09:00 A.M IST :release-by: Omer Katz
Now passing max_retries, interval_start, interval_step, interval_max parameters from broker transport_options to ~kombu.Connection.ensure_connection when returning ~kombu.Connection.default_connection (Issue #765).
Contributed by Anthony Lukach.
Qpid: messages are now durable by default
Contributed by David Davis
Kombu now requires version 2.10.4 or greater of the redis library, in line with Celery
Contributed by Colin Jeanne
Fixed ImportError in some environments with outdated simplejson
Contributed by Aaron Morris
MongoDB: fixed failure on MongoDB versions with an "-rc" tag
Contributed by dust8
Ensure periodic polling frequency does not exceed timeout in virtual transport
Contributed by Arcadiy Ivanov
Fixed string handling when using python-future module
Contributed by John Koehl
Replaced "async" with "asynchronous" in preparation for Python 3.7
Contributed by Thomas Achtemichuk
Allow removing pool size limit when in use
Contributed by Alex Hill
Codebase improvements and fixes by:
j2gg0s
Jon Dufresne
Jonas Lergell
Mads Jensen
Nicolas Delaby
Omer Katz
Documentation improvements by:
Felix Yan
Harry Moreno
Mads Jensen
Omer Katz
Radha Krishna. S.
Wojciech Matyśkiewicz
Removed deprecated use of StopIteration in generators and invalid regex escape sequence.
SQS: Added support for long-polling on all supported queries. Fixed bug causing error on parsing responses with no retrieved messages from SQS.
Contributed by Anthony Lukach.
Async hub: Fixed potential infinite loop while performing todo tasks (Issue celery/celery#3712).
Qpid: Fixed bug where messages could have duplicate delivery_tag (Issue #563).
Contributed by bmbouter.
MongoDB: Fixed problem with using readPreference option at pymongo 3.x.
Contributed by Mikhail Elovskikh.
Re-added support for :pypi:SQLAlchemy
Contributed by Amin Ghadersohi.
SQS: Fixed bug where hostname would default to localhost if not specified in settings.
Contributed by Anthony Lukach.
Redis: Added support for reading password from transport URL (Issue #677).
Contributed by George Psarakis.
RabbitMQ: Ensured safer encoding of queue arguments.
Contributed by Robert Kopaczewski.
Added fallback to :func:uuid.uuid5 in :func:generate_oid if :func:uuid.uuid3 fails.
Contributed by Bill Nottingham.
Fixed race condition and innacurrate timeouts for :class:kombu.simple.SimpleBase (Issue #720).
Contributed by c-nichols.
Zookeeper: Fixed last chroot character trimming
Contributed by Dima Kurguzov.
RabbitMQ: Fixed bug causing an exception when attempting to close an already-closed connection (Issue #690).
Contributed by eavictor.
Removed deprecated use of StopIteration in generators and invalid regex escape sequence.
Contributed by Jon Dufresne.
Added Python 3.6 to CI testing.
Contributed by Jon Dufresne.
SQS: Allowed endpoint URL to be specified in the boto3 connection.
Contributed by georgepsarakis.
SQS: Added support for Python 3.4.
Contributed by Anthony Lukach.
SQS: kombu[sqs] now depends on boto3 (no longer using boto).
Adds support for Python 3.4+
Adds support for FIFO queues (Issue #678) and (Issue celery/celery#3690)
Avoids issues around a broken endpoints file (Issue celery/celery#3672)
Contributed by Mischa Spiegelmock and Jerry Seutter.
Zookeeper: Added support for delaying task with Python 3.
Contributed by Dima Kurguzov.
SQS: Fixed bug where kombu.transport.SQS.drain_events did not support callback argument (Issue #694).
Contributed by Michael Montgomery.
Fixed bug around modifying dictionary size while iterating over it (Issue #675).
Contributed by Felix Yan.
etcd: Added handling for EtcdException exception rather than EtcdError.
Contributed by Stephen Milner.
Documentation improvements by:
Mads Jensen
Matias Insaurralde
Omer Katz
Dmitry Dygalo
Christopher Hoskin
:release-date: 2016-12-15 03:31 P.M PST :release-by: Ask Solem
Now depends on amqp 2.1.4
This new version takes advantage of TCP Keepalive settings on Linux, making it better at detecting closed connections, also in failover conditions.
Redis: Priority was reversed so, e.g. priority 0 became priority 9.
:release-date: 2016-12-07 06:00 P.M PST :release-by: Ask Solem
Now depends on amqp 2.1.3
This new version takes advantage of the new TCP_USER_TIMEOUT socket option on Linux.
Producer: Fixed performance degradation when default exchange specified (Issue #651).
QPid: Switch to using getattr in qpid.Transport.__del__ (Issue #658)
Contributed by Patrick Creech.
QPid: Now uses monotonic time for timeouts.
MongoDB: Fixed compatibility with Python 3 (Issue #661).
Consumer: __exit__ now skips cancelling consumer if connection-related error raised (Issue #670).
MongoDB: Removes use of natural sort (Issue #638).
Contributed by Anton Chaporgin.
Fixed wrong keyword argument channel error (Issue #652).
Contributed by Toomore Chiang.
Safe argument to urllib.quote must be bytes on Python 2.x (Issue #645).
Documentation improvements by:
Carlos Edo
Cemre Mengu
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
:release-date: 2016-10-06 05:00 P.M PDT :release-by: Ask Solem
Connection: Return value of .info() was no longer JSON serializable, leading to "itertools.cycle object not JSON serializable" errors (Issue #635).
:release-date: 2016-09-30 03:06 P.M PDT :release-by: Ask Solem
Connection: Fixed bug when cloning connection with alternate urls.
Fix contributed by Emmanuel Cazenave.
Redis: Fixed problem with unix socket connections.
https://github.com/celery/celery/issues/2903
Fix contributed by Raphael Michel.
Redis: Fixed compatibility with older redis-py versions (Issue #576).
Broadcast now retains queue name when being copied/pickled (Issue #578).
:release-date: 2016-03-22 11:22 P.M PST :release-by: Ask Solem
msgpack: msgpack support now requires msgpack-python > 0.4.7.
Redis: TimeoutError was no longer handled as a recoverable error.
Redis: Adds the ability to set more Redis connection options using Connection(transport_options={...}).
socket_connect_timeout
socket_keepalive (requires redis-py > 2.10)
socket_keepalive_options (requires redis-py > 2.10)
msgpack: Fixes support for binary/unicode data
:release-date: 2016-03-03 05:30 P.M PST :release-by: Ask Solem
Qpid: Adds async error handling.
Contributed by Brian Bouterse.
Qpid: Delivery tag is now a UUID4 (Issue #563).
Fix contributed by Brian Bouterse.
Redis: Connection.as_uri() returned malformed URLs when the redis+socket scheme was ised (Issue celery/celery#2995).
msgpack: Use binary encoding instead of utf-8 (Issue #570).
:release-date: 2016-01-08 06:36 P.M PST :release-by: Ask Solem
Now depends on amqp 1.4.9.
Redis: Fixed problem with auxilliary connections causing the main consumer connection to be closed (Issue #550).
Qpid: No longer uses threads to operate, to ensure compatibility with all environments (Issue #531).
:release-date: 2015-12-16 02:29 P.M PST :release-by: Ask Solem
Redis: Fixed bug introduced in 3.0.31 where the redis transport always connects to localhost, regardless of host setting.
:release-date: 2015-12-16 12:00 P.M PST :release-by: Ask Solem
Redis: Fixed bug introduced in 3.0.30 where socket was prematurely disconnected.
Hub: Removed debug logging message: "Deregistered fd..." (Issue #549).
:release-date: 2015-12-07 12:28 A.M PST :release-by: Ask Solem
Fixes compatiblity with uuid in Python 2.7.11 and 3.5.1.
Fix contributed by Kai Groner.
Redis transport: Attempt at fixing problem with hanging consumer after disconnected from server.
Attempt at fixing issue with 100% CPU when using the Redis transport,
Database transport: Fixed oracle compatiblity.
An "ORA-00907: missing right parenthesis" error could manifest when using an Oracle database with the database transport.
Fix contributed by Deepak N.
Documentation fixes
Contributed by Tommaso Barbugli.
:release-date: 2015-10-26 11:10 A.M PDT :release-by: Ask Solem
Fixed serialization issue for bindings.as_dict() (Issue #453).
Fix contributed by Sergey Tikhonov.
Json serializer wrongly treated bytes as ascii, not utf-8 (Issue #532).
MongoDB: Now supports pymongo 3.x.
Contributed by Len Buckens.
SQS: Tests passing on Python 3.
Fix contributed by Felix Yan
:release-date: 2015-10-12 12:00 PM PDT :release-by: Ask Solem
Django transport migrations.
If you're using Django 1.8 and have already created the kombu_transport_django tables, you have to run a fake initial migration:
$ python manage.py migrate kombu_transport_django --fake-initial
No longer compatible with South by default.
To keep using kombu.transport.django with South migrations you now need to configure a new location for the kombu migrations:
SOUTH_MIGRATION_MODULES = { 'kombu_transport_django': 'kombu.transport.django.south_migrations', }
Keep old South migrations in kombu.transport.django.south_migrations.
Now works with Redis < 2.10 again.
:release-date: 2015-10-09 3:10 PM PDT :release-by: Ask Solem
Now depends on amqp 1.4.7.
Fixed libSystem import error on some macOS 10.11 (El Capitan) installations.
Fix contributed by Eric Wang.
Now compatible with Django 1.9.
Django: Adds migrations for the database transport.
Redis: Now depends on py-redis 2.10.0 or later (Issue #468).
QPid: Can now connect as localhost (Issue #519).
Fix contributed by Brian Bouterse.
QPid: Adds support for login_method (Issue #502, Issue #499).
Contributed by Brian Bouterse.
QPid: Now reads SASL mechanism from broker string (Issue #498).
Fix contributed by Brian Bouterse.
QPid: Monitor thread now properly terminated on session close (Issue #485).
Fix contributed by Brian Bouterse.
QPid: Fixed file descriptor leak (Issue #476).
Fix contributed by Jeff Ortel
Docs: Fixed wrong order for entrypoint arguments (Issue #473).
ConsumerMixin: Connection error logs now include traceback (Issue #480).
BaseTransport now raises RecoverableConnectionError when disconnected (Issue #507).
Consumer: Adds tag_prefix option to modify how consumer tags are generated (Issue #509).
:release-date: 2015-04-22 06:00 P.M UTC :release-by: Ask Solem
Fixed compatibility with py-redis versions before 2.10.3 (Issue #470).
:release-date: 2015-04-21 02:00 P.M UTC :release-by: Ask Solem
pyamqp/librabbitmq now uses 5671 as default port when SSL is enabled (Issue #459).
Redis: Now supports passwords in redis+socket://:pass@host:port URLs (Issue #460).
Producer.publish now defines the expiration property in support of the RabbitMQ per-message TTL extension.
Contributed by Anastasis Andronidis.
Connection transport attribute now set correctly for all transports.
Contributed by Alex Koshelev.
qpid: Fixed bug where the connectionw as not being closed properly.
Contributed by Brian Bouterse.
~kombu.entity.bindings is now JSON serializable (Issue #453).
Contributed by Sergey Tikhonov.
Fixed typo in error when yaml is not installed (said msgpack).
Contributed by Joshua Harlow.
Redis: Now properly handles redis.exceptions.TimeoutError raised by redis.
Contributed by markow.
qpid: Adds additional string to check for when connecting to qpid.
When we connect to qpid, we need to ensure that we skip to the next SASL mechanism if the current mechanism fails. Otherwise, we will keep retrying the connection with a non-working mech.
Contributed by Chris Duryee.
qpid: Handle NotFound exceptions.
Contributed by Brian Bouterse.
Queue.__repr__ now makes sure return value is not unicode (Issue #440).
qpid: Queue.purge incorrectly raised AttributeErrror if the does not exist (Issue #439).
Contributed by Brian Bouterse.
Linux: Now ignores permission errors on epoll unregister.
:release-date: 2014-11-17 11:00 P.M UTC :release-by: Ask Solem
The Qpid broker is supported for Python 2.x environments. The Qpid transport includes full SSL support within Kombu. See the kombu.transport.qpid docs for more info.
Contributed by Brian Bouterse and Chris Duryee through support from Red Hat.
Dependencies: extra[librabbitmq] now requires librabbitmq 1.6.0
Docstrings for ~kombu.utils.limit.TokenBucket did not match implementation.
Fix contributed by Jesse Dhillon.
~kombu.common.oid_from accidentally called uuid.getnode() but did not use the return value.
Fix contributed by Alexander Todorov.
Redis: Now ignores errors when cosing the underlying connection.
Redis: Restoring messages will now use a single connection.
kombu.five.monotonic: Can now be imported even if ctypes is not available for some reason (e.g. App Engine)
Documentation: Improved example to use the declare argument to Producer (Issue #423).
Django: Fixed app_label for older Django versions (< 1.7). (Issue #414).
:release-date: 2014-09-14 10:45 P.M UTC :release-by: Ask Solem
Django: Fixed bug in the Django 1.7 compatibility improvements related to autocommit handling.
Contributed by Radek Czajka.
Django: The Django transport models would not be created on syncdb after app label rename (Issue #406).
:release-date: 2014-09-04 03:00 P.M UTC :release-by: Ask Solem
kombu.async: Min. delay between waiting for timer was always increased to one second.
Fixed bug in itermessages where message is received after the with statement exits the block.
Fixed by Rumyana Neykova
(__module__, __name__, __doc__). Fixes #392.
Contributed by johtso.
Django: Now sets custom app label for kombu.transport.django to work with recent changes in Django 1.7.
SimpleQueue removed messages from the wrong end of buffer (Issue #380).
Tests: Now using unittest.mock if available (Issue #381).
One column per quarter.