v3.5.0 (2025-11-06)

• Dependency: on Clojars
• Versioning: Break Versioning

This is a major maintenance release with many improvements. It includes a breaking change regarding Carmine's logging. Please report any unexpected problems to the Slack channel or GitHub.

A big thanks to all contributors and testers on this release! 🙏

- Peter Taoussanis

Since v3.4.1 (2024-05-30)

Changes

• ➤ [mod] [BREAKING] Switch logging: Timbre -> Trove [ee75844]
• [mod] Drop support for Clojure 1.9 [70a6065]

New

• [new] First publicly available experimental Carmine v4 core for early testers (currently undocumented)
• [new] Update command spec [52c0cc0]
• [new] Now use Truss contextual exceptions for all errors [3c5ede7]
• [new] [#322] Tests: use shared config, make benchmarks easier to tune (@kaizer113) [3a21e98]
• [new] [mq] Add experimental :reset-init-backoff? opt for debouncing, etc. [983fde9]
• [new] [mq] [#315] [#316] Allow zero-thread workers (@adam-jijo-swym) [7e9adce]
• [new] [#313] Replace lua code with native command (@GabrielHVM) [ed10934]
• [doc] [#314] Fix wiki typos (@mardukbp) [6c20de1]
• [doc] [#317] wcar docstring improvements [d4265aa]
• [doc] Add migration info re: v3.3 MQ holding connections longer [8dc6fc1]

Fixes

• None

v3.4.1 (2024-05-30)

Dep: Carmine is on Clojars.
Versioning: Carmine uses Break Versioning.

This is a hotfix release that should be non-breaking.

And as always please report any unexpected problems - thank you! 🙏

- Peter Taoussanis

Fixes since v3.4.0 (2024-05-28)

• 9dd6720 [fix] [mq] [#305] Typo in final loop error handler
• 81f58d8 [fix] [mq] Monitor :ndry-runs arg should be an int
• 41e5ed3 [fix] [mq] Properly assume :success handler status by default

v3.4.0 (2024-05-28)

Dep: Carmine is on Clojars.
Versioning: Carmine uses Break Versioning.

This is a security and maintenance release that should be non-breaking for most users.

⚠️ It addresses a security vulnerability in Nippy's upstream compression library and is recommended for all existing users. Please review the relevant Nippy release info, and ensure adequate testing in your environment before updating production data.

And as always please report any unexpected problems - thank you! 🙏

- Peter Taoussanis

Changes since v3.3.2 (2023-10-24)

• Updated to latest stable Nippy. This should be a non-breaking change for most users, but please ensure adequate testing in your environment before updating production data.

Fixes since v3.3.2 (2023-10-24)

• 105cecb [fix] [mq] [#299] Fix queue-names and queues-clear-all!!! typos
• 95c52aa [fix] [mq] [#301] Document behaviour on handler errors
• 9c8b996 [fix] [#307] Fix Pub/Sub channel handlers masking pattern handlers
• Fixed several typos in docs/README (@chage, @J0sueTM, @mohammedamarnah)

New since v3.3.2 (2023-10-24)

• 12c4100 [new] Update Redis command spec (2024-05-27)
• Several wiki and docstring improvements

v3.3.2 (2023-10-24)

📦 Available on Clojars, this project uses Break Versioning.

This is a minor hotfix release and should be a safe upgrade for users of v3.3.0.

Fixes since v3.3.1

• be9d4cd [#289] [fix] Typo in previous hotfix

v3.3.1 (2023-10-24)

📦 Available on Clojars, this project uses Break Versioning.

This is a minor hotfix release and should be a safe upgrade for users of v3.3.0.

Fixes since v3.3.0

• ab00f2a [#289] [fix] >1 arity parse-map broken since v3.3.0

v3.3.0 (2023-10-12)

📦 Available on Clojars, this project uses Break Versioning.

This is a major feature release focused on significantly improving the performance and observability of Carmine's message queue.

There are BREAKING CHANGES for the message queue API, see migration info.

Please test carefully and report any unexpected problems, thank you! 🙏

Changes since v3.2.0

• ⚠️ 1804ef9 [mod] [BREAKING] [#278] Carmine message queue API changes (see migration info)

Fixes since v3.2.0

• 2e6722b [fix] [#281 #279] parse-uri: only provide ACL params when non-empty (@frwdrik)
• c68c995 [fix] [#283] Support new command.json spec format used for XTRIM, etc.

New since v3.2.0

• Several major message queue architectural improvements
• Several major message queue API improvements
• c9c8d81 [new] Update commands to match latest commands.json spec
• 19d97eb [new] [#282] Add support for TLS URIs to URI parser
• 5cfdbbb [new] Add scan-keys util
• 37f0030 [new] Add set-min-log-level! util
• GraalVM compatibility is now tested during build

Other improvements since v3.3.0

• Uses latest Nippy (v3.3.0)
• Various internal improvements

3.3.0-RC1 (2023-07-18)

📦 Available on Clojars

This is a major feature release which includes possible breaking changes for users of Carmine's message queue.

The main objective is to introduce a rewrite of Carmine's message queue that significantly improves queue performance and observability.

If you use Carmine's message queue:

• Please see the 1804ef9 commit message for important details.
• Please test this release carefully before deploying to production, and once deployed monitor for any unexpected behaviour.

My sincere apologies for the possible breaks. My hope is that:

• Few users will actually be affected by these breaks.
• If affected, migration should be simple.
• Ultimately the changes will be positive - and something that all queue users can benefit from.

Changes since 3.2.0

• ⚠️ 1804ef9 [mod] [BREAK] [#278] Merge work from message queue v2 branch (see linked commit message for details)

Fixes since 3.2.0

• 2e6722b [fix] [#281 #279] parse-uri: only provide ACL params when non-empty (@frwdrik)
• c68c995 [fix] [#283] Support new command.json spec format used for XTRIM, etc.

New since 3.2.0

• f79a640 [new] Update commands to match latest commands.json spec
• 19d97eb [new] [#282] Add support for TLS URIs to URI parser
• 5cfdbbb [new] Add scan-keys util
• 37f0030 [new] Add set-min-log-level! util
• GraalVM compatibility is now tested during build

v3.2.0 / 2022 Dec 3

[com.taoensso/carmine "3.2.0"]

This is a major feature + maintenance release. It should be non-breaking.
See here for recommended steps when updating any Clojure/Script dependencies.

Changes since v3.1.0

• [#279] [#257] Any username in conn-spec URI will now automatically be used for ACL in AUTH

Fixes since v3.1.0

• Fix warning of parse var replacements (parse-long, parse-double)

New since v3.1.0

• [a1d0c4e] [#201] [#224] [#266] Improve wcar documentation, alias pool constructor in main ns
• [9cc10fb] [#251] [#257] [#270] Add support for username (ACL) in AUTH (@lsevero @sumeet14)
• Update to latest commands.json (from 2022-09-22)
• [50ce6bf] [#259] [#261] Ring middleware: add :extend-on-read? option (@svdo)
• [8454542][Message queue] Print extra debug info on invalid handler status

Other improvements since v3.1.0

• [#264] Remove unnecessary reflection in Tundra (@frwdrik)
• Stop using deprecated Encore vars
• [#271] Refactor tests, fix flakey results
• Update dependencies
• Work underway on Carmine v4, which'll introduce support for RESP3, Redis Sentinel, Redis Cluster, and more.

v3.1.0 / 2020 Nov 24

[com.taoensso/carmine "3.1.0"]

This is a minor feature release. It should be non-breaking.

New since v3.0.0

• [#244 #245] Message queue: add initial-backoff-ms option to enqueue (@st3fan)

v3.0.0 / 2020 Sep 22

[com.taoensso/carmine "3.0.0"]

This is a major feature + security release. It may be BREAKING.
See here for recommended steps when updating any Clojure/Script dependencies.

Changes since v2.20.0

• [BREAKING] Bumped minimum Clojure version from v1.5 to v1.7.
• [BREAKING] Bump Nippy to v3 for an important security fix. See here for details incl. necessary upgrade instructions for folks using Carmine's automatic de/serialization feature.
• Bump Timbre to v5.

New since v2.20.0

• Update to latest Redis commands spec.
• Listeners (incl. Pub/Sub) significantly improved:
  • [#15] Allow conn-alive? check for listener connections
  • [#219] Try ping on socket timeouts for increased reliability (@ylgrgyq)
  • [#207] Publish connection and handler errors to handlers, enabling convenient reconnect logic (@aravindbaskaran)
  • [#207] Support optional ping-ms keep-alive for increased reliability (@aravindbaskaran)
  • Added parse-listener-msg util for more easily writing handler fns
  • Allow with-new-pubsub-listener to take a single direct handler-fn