v3.0.0-beta1 (2025-04-21)

Author: ptaoussanis

CHANGELOG.md

@@ -2,6 +2,42 @@ This project uses [**Break Versioning**](https://www.taoensso.com/break-versioni
 
 ---
 
+# `v3.0.0-beta1` (2025-04-21)
+
+- **Dependency**: [on Clojars](https://clojars.org/com.taoensso/tufte/versions/3.0.0-beta1)
+- **Versioning**: [Break Versioning](https://www.taoensso.com/break-versioning)
+
+This is a **major upgrade** of Tufte with *many* new features and improvements, including expanded documentation and a rich new API for filtering and handling that it has in common with [Telemere](https://www.taoensso.com/telemere).
+
+v3 includes **breaking changes** (indicated by ➤ below) that may affect some (but not all) users. Please see the **relevant linked commit messages** below for details and migration info.
+
+Apologies for any hassle while upgrading! My hope is that most users will be unaffected, and that those affected will be able to migrate easily.
+
+As always please **report any unexpected problems** on [GitHub](https://github.com/taoensso/telemere/issues) or the [Slack channel](https://www.taoensso.com/telemere/slack), and feel free to ping if I can provide any assistance! 🙏
+
+\- [Peter Taoussanis](https://www.taoensso.com)
+
+## Changes since v2.7.0 (2024-04-15)
+
+Please read **linked commit messages** carefully in case you may be affected:
+
+- ➤ **\[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]
+- ➤ **\[mod]** \[BREAKING] Change default `min-level` (2 -> `:info`) \[125fc76]
+- ➤ **\[mod]** \[BREAKING] Changed arg given to `profile` handlers \[a778ac9], see [`help:signal-content`](https://cljdoc.org/d/com.taoensso/tufte/CURRENT/api/taoensso.tufte#help:signal-content) for new arg
+
+## New since v2.7.0 (2024-04-15)
+
+- \[new] Add [Telemere](https://www.taoensso.com/telemere) handler \[c01d5a2]
+- \[new] *Many* new options available 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 available 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] Significantly expanded filtering and handler capabilities, see [`help:filters`](https://cljdoc.org/d/com.taoensso/tufte/CURRENT/api/taoensso.tufte#help:filters) and [`help:handlers`](https://cljdoc.org/d/com.taoensso/tufte/CURRENT/api/taoensso.tufte#help:handlers)
+- \[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 \[d9e57b6], \[049ecc8], etc.
+- \[new] Major code refactor for improved performance and maintenance \[312bb4c], \[bbc8dfc], \[e51df6a], \[2b6e276], \[a778ac9], etc.
+
+---
+
 # `v2.7.0` (2025-04-15)
 
 - **Dependency**: [on Clojars](https://clojars.org/com.taoensso/tufte/versions/2.7.0)

README.md

@@ -17,8 +17,8 @@ It works great with [Telemere](https://www.taoensso.com/telemere) and [Truss](ht
 
 ## Latest release/s
 
+- `2025-04-21` `v3.0.0-beta1`: (forthcoming) [release info](../../releases/tag/v3.0.0-beta1) (v3 shares a common filter and handler API with [Telemere](https://www.taoensso.com/telemere))
 - `2025-04-15` `v2.7.0`: (stable) [release info](../../releases/tag/v2.7.0)
-- `YYYY-MM-DD` `v3.0.0-RC1`: (dev) [release info](../../releases/tag/v3.0.0-RC1) (v3 shares a common filter and handler API with [Telemere](https://www.taoensso.com/telemere))
 
 [![Main tests][Main tests SVG]][Main tests URL]
 [![Graal tests][Graal tests SVG]][Graal tests URL]

project.clj

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