Skip to content

v1.0.0-RC4 (2025-03-03)

Latest
Compare
Choose a tag to compare
@ptaoussanis ptaoussanis released this 03 Mar 15:55
· 5 commits to master since this release

📦 Dependencies

Available on Clojars:

  1. Telemere - main dependency.
  2. SLF4J provider - additional dependency for users that want their Java logging to go to Telemere.

This project uses Break Versioning.

Release notes

RC4 includes some minor fixes, minor usability improvements, and a few breaking changes (indicated by ➤) that should not affect most users.

If no unexpected issues come up, RC4 will become v1 stable in March 2025.

Big thanks to everyone that's been helping test and give feedback. And as always, please report any unexpected problems on GitHub or the Slack channel 🙏

Thanks for the patience awaiting v1 final! I hope and believe that it'll have been worth the time + effort.

- Peter Taoussanis

Recent CHANGES

Since v1.0.0-RC1 (2024-10-29)

➤ Changes to API since v1.0.0-RC1

Please read these carefully in case you might be affected:

  • [mod] log!, event! now always return nil [ac5feb4] (RC4)
  • [mod] Signal content: drop :location, add :coords [fda22ce] (RC3)
  • [mod] Signal options: drop :location, add :coords [1f99f71] (RC3)
  • [mod] OpenTelemetry: use standard attr names when possible [bb715fb] (RC3)
  • [mod] [#39] Discontinued separate "shell" library [096c432] (RC2)
  • [mod] Change return value of experimental with-signals [cb6a5d9] (RC2)
  • [mod] Remove rarely-used advanced options from catch->error! [0de5c09] (RC2)

Changes to default output since v1.0.0-RC1

Other changes

Recent additions

Since v1.0.0-RC1 (2024-10-29)

Misc improvements

Doc improvements

Earlier improvements

  • [new] Add :ctx+, :middleware+ signal options [5a8c407] (RC1)
  • [new] OpenTelemetry handler: try print map vals as EDN [c1e1c1e] (RC1)
  • [new] [#28] OpenTelemetry handler: support custom signal attrs [5ef4f12] (RC1)
  • [new] Simplify default OpenTelemetry providers code, expose SDK [19548d3] (RC1)
  • [new] Add dispatch-signal! util [5ac8725] (RC1)
  • [new] writeable-file!: resolve sym links, etc. [9965450] (RC1)
  • [new] Extend IIFE-wrap to Clj [d0ad99d] (RC1)
  • [new] Numerous improvements to docs and examples (RC1)
  • [new] Add :rate-limit-by option to all signal creators [d9c3583] (beta 23)
  • [new] Add clean-signal-fn util [be55f44] (beta 23)
  • [new] Add signal-allowed? util [d12b0b1] (beta 23)
  • [new] Allow compile-time config of uid kind [965c227] (beta 23)
  • [new] Avoid duplicated trace bodies [c9e84e8] (beta 23)
  • [new] Cap length of displayed run-form when tracing [85772f7] (beta 23)
  • [new] Added experimental shell API for library authors [ece51b2] (beta 22)
  • [new] Auto stop existing handler when replacing it (beta 22)
  • [new] Added "(.*)" wildcard syntax to kind/ns/id filters (beta 22)
  • [new] Internal and doc improvements: [8066776], [b4b06f3], [3068ccf] (beta 21)
  • [new] OpenTelemetry handler: improve span interop [84957c6] (beta 20)
  • [new] OpenTelemetry handler: add experimental trace output [67cb494] (beta 18)
  • [new] Improve uid control, switch to nano-style by default [5ab2736] (beta 18)
  • [new] Add host info to signal content [1cef195] (beta 18)
  • [new] Add extra tracing info to signal content [d635318] (beta 18)
  • [new] Ongoing API and wiki doc improvements (beta 15)
  • [new] [#5] Added comparison to Mulog (beta 15)
  • [new] SLF4J and tools.logging signals now have a namespace (from logger name) (beta 14)
  • [new] Added get-handlers-stats (beta 13)
  • [new] add-handler! can now specify per-handler :drain-msecs (beta 13)
  • [new] Added *auto-stop-handlers?* (beta 13)
  • [new] remove-handler! now auto stops relevant handlers after removal (beta 13)
  • [new] with-handler and with-handler+ now auto stops relevant handlers after use (beta 12)
  • [new] (Advanced) Handler fns can now include :dispatch-opts metadata, useful for handler authors that want to set defaults for use by add-handler! (beta 8)
  • [new] Added Slack handler (beta 8)
  • [new] Added TCP and UDP socket handlers (beta 7)
  • [new] Clj signal content now includes :thread {:keys [group name id]} key (beta 7)
  • [new] Added postal (email) handler (beta 5)
  • [new] Handlers now block to try drain their signal queues on shutdown (beta 3)
  • [new] Rate limiter performance improvements (via Encore) (beta 3)

Recent fixes

Since v1.0.0-RC1 (2024-10-29)

  • [fix] [#52] signal-preamble-fn should use host info in signal (@marksto) [410ed89] (RC4)
  • [fix] Timbre shim: rename spy! -> spy (@lvh) [3a9ffc6] (RC3)
  • [fix] Timbre shim: don't attach empty :vargs data [0e642ba] (RC3)
  • [fix] Fix environment val docs [db26a5d] (RC3)
  • [fix] spy! docstring typo (@rafd) [35606d9] (RC3)
  • [fix] Broken signal string representation [8c701d4] (RC2)
  • [fix] Trace formatting: always include root info [f522307] (RC2)
  • [fix] Trace formatting: properly format nil ids [68a894e] (RC2)
  • [fix] [#36] Fix missing cljdoc docstrings [b58ec73] (RC2)

Earlier fixes

  • [fix] signal-opts: allow map forms as intended [f7a5663] (RC1)
  • [fix] uncaught->error! wasn't working (@benalbrecht) [7f52cb1] (RC1)
  • [fix] Regression affecting deprecated rate-limiter* (beta 25)
  • [fix] Don't try count non-list tracing bodies [88f7a3c] (beta 24)
  • [fix] [#21] Work around issue with use in Cljs core.async/go bodies [cbab57b] (beta 23)
  • [fix] [#20] Wrong :arglists meta on spy! [568906c] (beta 23)
  • [fix] [#18] Support {:uid :auto} for non-tracing signal creators [f52a04b] (beta 23)
  • [fix] Runtime Clj env config now works correctly in uberjars (beta 23)
  • [fix] Signal :line info missing for some wrapped-macro cases [0f09b79] (beta 22)
  • [fix] OpenTelemetry handler: use signal callsite Context as root span parent [a8e9230] (beta 19)
  • [fix] [#16] OpenTelemetry handler: coerce line attrs (@flyingmachine) [17349a0] (beta 19)
  • [fix] Decrease min Java version (11->8) (@flyingmachine) [a1c50f1] (beta 19)
  • [fix] Broken handler ns and kind filters [2319423] (beta 16)
  • [fix] [#10] OpenTelemetry handler: render keywords as plain strings [6e94215] (beta 15)
  • [fix] [#11] OpenTelemetry handler: signals without message fail [863cea1] (beta 15)
  • [fix] [#14] File handler: Don't truncate gzip output [2d4b049] (beta 15)
  • [fix] Don't drop signals while draining async buffer during shutdown, add tests (via Encore) (beta 12, beta 13)
  • [fix] pr-signal-fn wasn't realizing delayed messages, add tests [cf72017] (beta 11)
  • [fix] pr-signal-fn broken custom pr-fn support, add tests [e7cce0c] (beta 10)
  • [fix] [#6] Missing root stack trace, add tests [213c647] (beta 9)
  • [fix] Broken AOT support, add tests [ffea1a3] (beta 1)