Skip to content

Commit e68c2d5

Browse files
ptaoussanisptaoussanis
committed
v3.5.0 (2025-04-15)
1 parent bfba594 commit e68c2d5

File tree

5 files changed

+78
-30
lines changed

5 files changed

+78
-30
lines changed

‎CHANGELOG.md‎

Lines changed: 65 additions & 15 deletions
Original file line numberDiff line numberDiff line change
@@ -2,6 +2,56 @@ This project uses [**Break Versioning**](https://www.taoensso.com/break-versioni
22

33
---
44

5+
# `v3.5.0` (2025-04-15)
6+
7+
- **Dependency**: [on Clojars](https://clojars.org/com.taoensso/nippy/versions/3.5.0)
8+
- **Versioning**: [Break Versioning](https://www.taoensso.com/break-versioning)
9+
10+
This is a **general maintenance release** focused on updating dependencies and laying groundwork (read support) for new array types coming in Nippy v3.6.
11+
12+
It **drops support for Clojure v1.9** but should otherwise be a safe update from (at least) all recent versions of Nippy.
13+
14+
## Since `v3.5.0-RC1` (2024-10-28)
15+
16+
- **\[mod]** Drop official Clojure v1.9 support \[da57206]
17+
- \[new] Add string array type to default [thaw-serializable-allowlist](https://cljdoc.org/d/com.taoensso/nippy/CURRENT/api/taoensso.nippy#*thaw-serializable-allowlist*) \[bfba594]
18+
- \[new] Use [Truss exceptions](https://cljdoc.org/d/com.taoensso/truss/CURRENT/api/taoensso.truss#ex-info) on errors \[8d62dc2]
19+
- \[new] [#184] Incl. cause on non-native freeze failures \[8d10765]
20+
- \[doc] Clarify `*freeze-fallback*` docstring \[1026ea0]
21+
22+
## Since `v3.4.2` (2024-05-26)
23+
24+
- **\[mod]** Drop official Clojure v1.9 support \[da57206]
25+
- \[new] Add string array type to default [thaw-serializable-allowlist](https://cljdoc.org/d/com.taoensso/nippy/CURRENT/api/taoensso.nippy#*thaw-serializable-allowlist*) \[bfba594]
26+
- \[new] Use [Truss exceptions](https://cljdoc.org/d/com.taoensso/truss/CURRENT/api/taoensso.truss#ex-info) on errors \[8d62dc2]
27+
- \[new] [#184] Incl. cause on non-native freeze failures \[8d10765]
28+
- \[new] [#175] Mark [cache](https://cljdoc.org/d/com.taoensso/nippy/CURRENT/api/taoensso.nippy#cache) feature as stable \[b217db5]
29+
- \[doc] Clarify `*freeze-fallback*` docstring \[1026ea0]
30+
31+
## Migration info
32+
33+
| Updating from Nippy | Changes to API? | Changes to [byte output](https://github.com/taoensso/nippy/wiki/2-Operational-considerations#stability-of-byte-output)? | Rolling update sequence [1] |
34+
| :------------------------ | :-------------- | :---------------------------------------------------------------------------------------------------------------------- | :-------------------------- |
35+
| `v3.5.0-RC1` (2024-10-28) | - | - | - |
36+
| `v3.4.2` (2024-05-26) | - | - | - |
37+
| `v3.4.1` (2024-05-02) | - | - | - |
38+
| `v3.4.0` (2024-04-30) | - | **Yes** | - |
39+
| `v3.3.0` (2023-10-11) | - | - | - |
40+
| `v3.2.0` (2022-07-18) | - | - | - |
41+
| `v3.1.3` (2022-06-23) | - | - | - |
42+
43+
> [1] Relevant only when Nippy introduces support for new types **AND** you plan to update Nippy with a **rolling update** (coexisting new and old versions).
44+
45+
If updating from older versions of Nippy, please see the relevant release notes.
46+
47+
As always:
48+
49+
- See [operational considerations](https://github.com/taoensso/nippy/wiki/2-Operational-considerations) for info on: **data compatibility**, **rolling updates**, **rollback support**, etc.
50+
- It's always a good idea to **ensure adequate testing** in your environment before updating against production data!
51+
- **Please report any unexpected problems** 🙏
52+
53+
\- [Peter Taoussanis](https://www.taoensso.com)
54+
555
# `v3.5.0-RC1` (2024-10-28)
656

757
- **Dependency**: [on Clojars](https://clojars.org/com.taoensso/nippy/versions/3.5.0-RC1)
@@ -11,14 +61,14 @@ This is a **non-breaking maintenance release** that updates dependencies and inc
1161

1262
It should be safe to update from (at least) all recent versions of Nippy.
1363

14-
| Updating from Nippy | Changes to API? | Changes to [byte output](https://github.com/taoensso/nippy/wiki/2-Operational-considerations#stability-of-byte-output)? | Rolling update sequence [1]
15-
| :-- | :-- | :-- | :--
16-
| `v3.4.2` (2024-05-26) | - | - | -
17-
| `v3.4.1` (2024-05-02) | - | - | -
18-
| `v3.4.0` (2024-04-30) | - | Yes | -
19-
| `v3.3.0` (2023-10-11) | - | - | -
20-
| `v3.2.0` (2022-07-18) | - | - | -
21-
| `v3.1.3` (2022-06-23) | - | - | -
64+
| Updating from Nippy | Changes to API? | Changes to [byte output](https://github.com/taoensso/nippy/wiki/2-Operational-considerations#stability-of-byte-output)? | Rolling update sequence [1] |
65+
| :-------------------- | :-------------- | :---------------------------------------------------------------------------------------------------------------------- | :-------------------------- |
66+
| `v3.4.2` (2024-05-26) | - | - | - |
67+
| `v3.4.1` (2024-05-02) | - | - | - |
68+
| `v3.4.0` (2024-04-30) | - | Yes | - |
69+
| `v3.3.0` (2023-10-11) | - | - | - |
70+
| `v3.2.0` (2022-07-18) | - | - | - |
71+
| `v3.1.3` (2022-06-23) | - | - | - |
2272

2373
> [1] Relevant only when introducing support for new types, and for users that do rolling updates
2474
@@ -43,13 +93,13 @@ As always:
4393

4494
It should be a **straight-forward and non-breaking update** for almost everyone:
4595

46-
| Updating from Nippy | Changes to API? | Changes to [byte output](https://github.com/taoensso/nippy/wiki/2-Operational-considerations#stability-of-byte-output)? | Rolling update sequence [1]
47-
| :-- | :-- | :-- | :--
48-
| `v3.4.1` (2024-05-02) | - | - | -
49-
| `v3.4.0` (2024-04-30) | - | Yes | -
50-
| `v3.3.0` (2023-10-11) | - | - | -
51-
| `v3.2.0` (2022-07-18) | - | - | -
52-
| `v3.1.3` (2022-06-23) | - | - | -
96+
| Updating from Nippy | Changes to API? | Changes to [byte output](https://github.com/taoensso/nippy/wiki/2-Operational-considerations#stability-of-byte-output)? | Rolling update sequence [1] |
97+
| :-------------------- | :-------------- | :---------------------------------------------------------------------------------------------------------------------- | :-------------------------- |
98+
| `v3.4.1` (2024-05-02) | - | - | - |
99+
| `v3.4.0` (2024-04-30) | - | Yes | - |
100+
| `v3.3.0` (2023-10-11) | - | - | - |
101+
| `v3.2.0` (2022-07-18) | - | - | - |
102+
| `v3.1.3` (2022-06-23) | - | - | - |
53103

54104
> [1] Relevant only when introducing support for new types, and for users that do rolling updates
55105

‎README.md‎

Lines changed: 5 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
<a href="https://www.taoensso.com/clojure" title="More stuff by @ptaoussanis at www.taoensso.com"><img src="https://www.taoensso.com/open-source.png" alt="Taoensso open source" width="340"/></a>
2-
[**API**][cljdoc docs] | [**Wiki**][GitHub wiki] | [Latest releases](#latest-releases) | [Get support][GitHub issues]
2+
[**API**][cljdoc] | [**Wiki**][GitHub wiki] | [Latest releases](#latest-releases) | [Get support][GitHub issues]
33

44
# Nippy
55

@@ -13,8 +13,7 @@ It is used at scale by [Carmine](https://www.taoensso.com/carmine), [Faraday](ht
1313

1414
## Latest release/s
1515

16-
- `2024-05-26` `v3.4.2` (stable): [release info](../../releases/tag/v3.4.2)
17-
- `2024-10-28` `v3.5.0-RC1` (dev): [release info](../../releases/tag/v3.5.0-RC1)
16+
- `2025-04-15` `v3.5.0`: [release info](../../releases/tag/v3.5.0)
1817

1918
[![Main tests][Main tests SVG]][Main tests URL]
2019
[![Graal tests][Graal tests SVG]][Graal tests URL]
@@ -96,15 +95,15 @@ PRs welcome to include other alternatives in the [benchmark suite](../../blob/ma
9695
## Documentation
9796

9897
- [Wiki][GitHub wiki] (getting started, usage, etc.)
99-
- API reference: [cljdoc][cljdoc docs], [Codox][Codox docs]
98+
- API reference via [cljdoc][cljdoc]
10099

101100
## Funding
102101

103102
You can [help support][sponsor] continued work on this project, thank you!! 🙏
104103

105104
## License
106105

107-
Copyright &copy; 2012-2024 [Peter Taoussanis][].
106+
Copyright &copy; 2012-2025 [Peter Taoussanis][].
108107
Licensed under [EPL 1.0](LICENSE.txt) (same as Clojure).
109108

110109
<!-- Common -->
@@ -118,8 +117,7 @@ Licensed under [EPL 1.0](LICENSE.txt) (same as Clojure).
118117

119118
<!-- Project -->
120119

121-
[Codox docs]: https://taoensso.github.io/nippy/
122-
[cljdoc docs]: https://cljdoc.org/d/com.taoensso/nippy/CURRENT/api/taoensso.nippy
120+
[cljdoc]: https://cljdoc.org/d/com.taoensso/nippy/CURRENT/api/taoensso.nippy
123121

124122
[Clojars SVG]: https://img.shields.io/clojars/v/com.taoensso/nippy.svg
125123
[Clojars URL]: https://clojars.org/com.taoensso/nippy

‎project.clj‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,4 @@
1-
(defproject com.taoensso/nippy "3.5.0-RC1"
1+
(defproject com.taoensso/nippy "3.5.0"
22
:author "Peter Taoussanis <https://www.taoensso.com>"
33
:description "The fastest serialization library for Clojure"
44
:url "https://www.taoensso.com/nippy"

‎src/taoensso/nippy.clj‎

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -197,13 +197,13 @@
197197
15 [:byte-array-md [[:elements {:read 2}]]]
198198
2 [:byte-array-lg [[:elements {:read 4}]]]
199199

200-
109 [:int-array-lg [[:elements {:read 4}]]] ; Added v3.5.0 (YYYY-MM-DD)
201-
108 [:long-array-lg [[:elements {:read 4}]]] ; Added v3.5.0 (YYYY-MM-DD)
200+
109 [:int-array-lg [[:elements {:read 4}]]] ; Added v3.5.0 (2025-04-15)
201+
108 [:long-array-lg [[:elements {:read 4}]]] ; Added v3.5.0 (2025-04-15)
202202

203-
117 [:float-array-lg [[:elements {:read 4}]]] ; Added v3.5.0 (YYYY-MM-DD)
204-
116 [:double-array-lg [[:elements {:read 4}]]] ; Added v3.5.0 (YYYY-MM-DD)
203+
117 [:float-array-lg [[:elements {:read 4}]]] ; Added v3.5.0 (2025-04-15)
204+
116 [:double-array-lg [[:elements {:read 4}]]] ; Added v3.5.0 (2025-04-15)
205205

206-
107 [:string-array-lg [[:elements {:read 4}]]] ; Added v3.5.0 (YYYY-MM-DD)
206+
107 [:string-array-lg [[:elements {:read 4}]]] ; Added v3.5.0 (2025-04-15)
207207
115 [:object-array-lg [[:elements {:read 4}]]]
208208

209209
;; Serializable

‎src/taoensso/nippy/impl.clj‎

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -183,8 +183,8 @@
183183

184184
;; To help support release targeting, we track new type ids added over time
185185
(let [id-history ; {<release> #{type-ids}}
186-
{350 ; v3.5.0 (YYYY-MM-DD), added 5x
187-
;; #{string-array-lg long-array-lg int-array-lg double-array-lg float-array-lg}
186+
{350 ; v3.5.0 (2025-04-15), added 5x
187+
;; #{int-array-lg long-array-lg float-array-lg double-array-lg string-array-lg}
188188
#{0 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28
189189
29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54
190190
55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80

0 commit comments

Comments
 (0)