v3.0.0 (2025-06-23)

Author: ptaoussanis

CHANGELOG.md

@@ -2,6 +2,40 @@ This project uses [**Break Versioning**](https://www.taoensso.com/break-versioni
 
 ---
 
+# `v3.0.0` (2025-06-23)
+
+- **Dependency**: [on Clojars](https://clojars.org/com.taoensso/tufte/versions/3.0.0)
+- **Versioning**: [Break Versioning](https://www.taoensso.com/break-versioning)
+
+This is a **major upgrade** with many improvements. It includes **breaking changes** for a minority of users. Please see below for changes, and linked commit messages for relevant migration info and motivations.
+
+Sincere apologies for the hassle! Most users (esp. those using defaults) should be able to upgrade without any modifications, but as always please **report any unexpected problems** on [GitHub](https://github.com/taoensso/telemere/issues) or the [Slack channel](https://www.taoensso.com/tufte/slack), and feel free to ping if I can provide any assistance! 🙏
+
+\- [Peter Taoussanis](https://www.taoensso.com)
+
+## Breaking since `v2.7.0` (2024-04-15)
+
+- ➤ **\[mod]** \[BREAKING] Changed arg given to custom `profile` handlers \0f73778], see [`help:signal-content`](https://cljdoc.org/d/com.taoensso/tufte/CURRENT/api/taoensso.tufte#help:signal-content) for new arg
+- ➤ **\[mod]** \[BREAKING] Change default `min-level` (2 -> `:info`) \[025ff70]
+- ➤ **\[mod]** \[BREAKING] New API for draining [stats accumulator](https://cljdoc.org/d/com.taoensso/tufte/CURRENT/api/taoensso.tufte#stats-accumulator) \[b2c866b]
+- ➤ **\[mod]** \[BREAKING] Omit `defn_` / `fn_` id prefix when using [`defnp`](https://cljdoc.org/d/com.taoensso/tufte/CURRENT/api/taoensso.tufte#defnp), [`defnp-`](https://cljdoc.org/d/com.taoensso/tufte/CURRENT/api/taoensso.tufte#defnp-), [`fnp`](https://cljdoc.org/d/com.taoensso/tufte/CURRENT/api/taoensso.tufte#fnp) \[5f5d2ef]
+- ➤ **\[mod]** \[BREAKING] Remove `:file` key from [pstats](https://cljdoc.org/d/com.taoensso/tufte/CURRENT/api/taoensso.tufte#help:pstats-content) `:loc` maps \[79ccac5]
+
+## New since `v2.7.0` (2024-04-15)
+
+- \[new] Added [Telemere](https://www.taoensso.com/telemere) and [Trove](https://www.taoensso.com/trove) handlers.
+- \[new] Many new options added to [`profiled`](https://cljdoc.org/d/com.taoensso/tufte/CURRENT/api/taoensso.tufte#profiled), [`profile`](https://cljdoc.org/d/com.taoensso/tufte/CURRENT/api/taoensso.tufte#profile) (see linked docstrings)
+- \[new] Many new options added to [`add-handler!`](https://cljdoc.org/d/com.taoensso/tufte/CURRENT/api/taoensso.tufte#add-handler!) (see linked docstring, [`help:handler-dispatch-options`](https://cljdoc.org/d/com.taoensso/tufte/CURRENT/api/taoensso.tufte#help:handler-dispatch-options))
+- \[new] Automatic handler stats (see [`get-handlers-stats`](https://cljdoc.org/d/com.taoensso/tufte/CURRENT/api/taoensso.tufte#get-handlers-stats))
+- \[new] Major documentation improvements \[7d14517], \[1d7abfd], etc.
+- \[new] Major performance improvements \[312bb4c], \[bbc8dfc], \[e51df6a], \[2b6e276], \[0f73778], etc.
+
+## Since `v3.0.0-RC1` (2025-04-30)
+
+- \[mod] Some changes to the options and output to the Timbre and Telemere handlers \[48e82ad]. Please recheck if you're using custom options.
+
+---
+
 # `v3.0.0-RC1` (2025-04-30)
 
 - **Dependency**: [on Clojars](https://clojars.org/com.taoensso/tufte/versions/3.0.0-RC1)

README.md

@@ -22,8 +22,7 @@ Use it alone, or as part of a suite of complementary **observability tools** for
 
 ## Latest release/s
 
-- `2025-04-30` `v3.0.0-RC1`: [release info](../../releases/tag/v3.0.0-RC1) (improved [Telemere](https://www.taoensso.com/telemere) interop, much more)
-- `2025-04-15` `v2.7.0`: [release info](../../releases/tag/v2.7.0)
+- `2025-06-23` `v3.0.0`: [release info](../../releases/tag/v3.0.0)
 
 [![Clj tests][Clj tests SVG]][Clj tests URL]
 [![Cljs tests][Cljs tests SVG]][Cljs tests URL]
@@ -64,16 +63,14 @@ Using Tufte v3:
     (tufte/p :get-y (get-y))))
 
 ;; The following will be printed to *out*:
-;; 2025-04-18T11:23:08.820786Z INFO MyHost readme-examples[15,1]
-;; <<< pstats <<<
+;; 2025-04-18T11:23:08.820786Z INFO MyHost readme-examples[15,1] Tufte pstats
 ;; pId           nCalls        Min      50% ≤      90% ≤      95% ≤      99% ≤        Max       Mean   MAD      Clock  Total
 ;;
 ;; :get-y             5      238ms      501ms      981ms      981ms      981ms      981ms      618ms  ±42%      3.09s    55%
 ;; :get-x             5      501ms      502ms      505ms      505ms      505ms      505ms      503ms   ±0%      2.51s    45%
 ;;
 ;; Accounted                                                                                                    5.60s   100%
 ;; Clock                                                                                                        5.60s   100%
-;; >>> pstats >>>
 ```
 
 ## Documentation
@@ -113,4 +110,4 @@ Licensed under [EPL 1.0](LICENSE.txt) (same as Clojure).
 [Cljs tests SVG]:  https://github.com/taoensso/tufte/actions/workflows/cljs-tests.yml/badge.svg
 [Cljs tests URL]:  https://github.com/taoensso/tufte/actions/workflows/cljs-tests.yml
 [Graal tests SVG]: https://github.com/taoensso/tufte/actions/workflows/graal-tests.yml/badge.svg
-[Graal tests URL]: https://github.com/taoensso/tufte/actions/workflows/graal-tests.yml
+[Graal tests URL]: https://github.com/taoensso/tufte/actions/workflows/graal-tests.yml

examples/README.cljc

@@ -19,16 +19,14 @@
     (tufte/p :get-y (get-y))))
 
 ;; The following will be printed to *out*:
-;; 2025-04-18T11:23:08.820786Z INFO MyHost readme-examples[15,1]
-;; <<< pstats <<<
+;; 2025-04-18T11:23:08.820786Z INFO MyHost readme-examples[15,1] Tufte pstats
 ;; pId           nCalls        Min      50% ≤      90% ≤      95% ≤      99% ≤        Max       Mean   MAD      Clock  Total
 ;;
 ;; :get-y             5      238ms      501ms      981ms      981ms      981ms      981ms      618ms  ±42%      3.09s    55%
 ;; :get-x             5      501ms      502ms      505ms      505ms      505ms      505ms      503ms   ±0%      2.51s    45%
 ;;
 ;; Accounted                                                                                                    5.60s   100%
 ;; Clock                                                                                                        5.60s   100%
-;; >>> pstats >>>
 
 (tufte/profile
   ;; See `profile` docstring for all options:

project.clj

@@ -1,4 +1,4 @@
-(defproject com.taoensso/tufte "3.0.0-RC1"
+(defproject com.taoensso/tufte "3.0.0"
   :author "Peter Taoussanis <https://www.taoensso.com>"
   :description "Simple performance monitoring library for Clojure/Script"
   :url "https://github.com/taoensso/tufte"

wiki/1-Getting-started.md

@@ -100,13 +100,11 @@ An example:
     (get-y)))
 
 ;; The following will be printed to *out*:
-;; 2025-04-18T11:23:08.820786Z INFO MyHost readme-examples[15,1]
-;; <<< pstats <<<
+;; 2025-04-18T11:23:08.820786Z INFO MyHost readme-examples[15,1] Tufte pstats
 ;; pId         nCalls      50% ≤       Mean      Clock  Total
 ;; defn_get-y       5      572ms      567ms      2.84s    53%
 ;; defn_get-x       5      500ms      500ms      2.50s    47%
 ;;
 ;; Accounted                                     5.34s   100%
 ;; Clock                                         5.34s   100%
-;; >>> pstats >>>
 ```