summaryrefslogtreecommitdiff
path: root/CHANGELOG.md
blob: 10b1f3caa1d2e1fc5595e7c3315558f29748a034 (plain)
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
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
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
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
<!--
SPDX-FileCopyrightText: 2026 Stefan Majewsky <majewsky@gmx.net>
SPDX-License-Identifier: Apache-2.0
-->

# v1.21.0 (2026-11-10)

Changes:

- oblast: Add type RuntimeIndex.
  I am done contemplating the method naming on this type, and decided that I am fine with it as-is.

# v1.20.0 (2026-11-10)

Changes:

- The minimum Go version was increased from 1.26 to 1.27 to facilitate the use of new APIs surrounding encoding/json/v2.
- jsonmatch: Pointer is now a synonym for jsontext.Pointer from the standard library.
- option: Map() from the options package is now available as a method on type Option directly.
  It is synonymous to options.Map(), which will be deprecated in a future release.
- All implementations of encoding/json.Marshaler and encoding/json.Unmarshaler on types in this module
  have been replaced with implementations of encoding/json/v2.MarshalerTo and encoding/json/v2.UnmarshalerFrom.
  This is technically a backwards-incompatibility for applications that call these methods directly,
  but all actual users call these functions indirectly through encoding/json or encoding/json/v2.
- gsql: Add Exec().

# v1.19.0 (2026-10-06)

Changes:

- pathrouter: Add CatchAllVariableIf(), VariableIf() and Elements().

# v1.18.0 (2026-10-05)

Changes:

- pathrouter: Remove `type Context` argument from `HandlerFunc` signature.
  When first using pathrouter in a real-world application, the extra argument proved cumbersome,
  so I settled on clever shenanigans within the library in order to make application code more readable.
  I really hate that I'm breaking compatiblity yet again, but in the end, user experience matters most.
  My takeaway is that new packages should go through a period of declared instability until the first major users are done.

# v1.17.0 (2026-10-02)

Changes:

- pathrouter: Replace `map[string]string` argument in `HandlerFunc` signature by new type `Context`.
  This constitutes a breaking change, which I find acceptable because there are no known users of this package yet.
  Adding an explicit type here allows the interface of package pathrouter to grow in the future.

# v1.16.0 (2026-09-17)

Changes:

- Add package oblast.
  This used to live at <https://git.xyrillian.de/go-oblast/>, but for the 1.x series,
  I'm moving nearly everything from `go.xyrillian.de/oblast` to `go.xyrillian.de/gg/oblast` because removing the module boundary
  between gsql and oblast opens up some code reuse opportunities and may help future optimizations.
  The only API surface that remains in the old location for now is `type RuntimeIndex`, because I want to contemplate method naming once again before stabilizing it.
- gsql: Add NoneIfNoRows.
  This replaces "OrNone" variants of methods in Oblast, e.g. SelectOne() and then also SelectOneOrNone().

# v1.15.0 (2026-09-08)

Changes:

- gsql: Add an additional `*sql.TxOptions` argument to `WithinTransaction` methods.
  This constitutes a breaking change, which I find acceptable because there are no known users of this function yet.
  The alternative would have been to pollute the namespace with additional methods (like for `Begin` vs `BeginTx`).
- Improve presentation of string literals in `assert.ErrEqual()` output (same as for `assert.Equal()` in v1.11.0).

# v1.14.0 (2026-08-18)

Changes:

- Add package microprom.
- Add `assert.Panics()` and `assert.PanicsWith()`.

# v1.13.3 (2026-08-05)

Changes:

- pgruntime: Add ApplicationName to ConnectionTarget for easy upgrade from go-bits/easypg.

# v1.13.2 (2026-08-05)

Changes:

- pgruntime: Add transaction locking to protect against concurrent migrations.

# v1.13.1 (2026-08-05)

Changes:

- pgruntime: Fix PostgreSQL version detection on Linux distributions with nonstandard `psql --version` output.

# v1.13.0 (2026-08-01)

Changes:

- Add package pgruntime.
- Add WithinTransaction method to `*gsql.DB` and `*gsql.Conn` methods.

# v1.12.0 (2026-07-31)

Changes:

- Add packages errext and gsql.

# v1.11.1 (2026-06-27)

Changes:

- Fixed `assert.ErrsEqual()` not calling `t.Helper()`.

# v1.11.0 (2026-06-27)

Changes:

- Add package pathrouter.
- Add `assert.ErrsEqual()`.
- In `assert.Equal()` output, present string literals with backticks instead of quotes when it makes the output more readable.
- Fixed `assert.ErrEqual()` not calling `t.Helper()`.

# v1.10.1 (2026-06-20)

Changes:

- Fix a panic in assert.ErrEqual when the `expected` argument is an error whose underlying type is a struct type.

# v1.10.0 (2026-06-20)

Changes:

- Add packages assert and testcapture.
- The minimum Go version was increased from 1.24 to 1.26
  because `assert.TestingTB` covers methods added to `testing.TB` in Go 1.26.

# v1.9.1 (2026-06-17)

Changes:

- Fix columnar choking on structs with `json:"-"` fields.

# v1.9.0 (2026-06-04)

Changes:

- jsonmatch: Allow embedding custom Diffable instances within Object and Array.

# v1.8.1 (2026-06-02)

Changes:

- Fix package documentation for columnar missing from pkg.go.dev.

# v1.8.0 (2026-06-02)

Changes:

- Add package columnar.

# v1.7.0 (2026-05-03)

Changes:

- The library must now be imported from the new module path `go.xyrillian.de/gg`.

# v1.6.0 (2026-04-01)

Changes:

- Add `jsonmatch.Irrelevant()`.
- Fix recursion into `jsonmatch.Array` during `DiffAgainst()`.

# v1.5.0 (2025-11-26)

Changes:

- Add package is.

# v1.4.0 (2025-11-18)

Changes:

- Add `jsonmatch.Diff.String()`.

# v1.3.0 (2025-08-15)

Changes:

- Add package assetembed.

# v1.2.0 (2025-08-11)

Changes:

- Add package jsonmatch.

# v1.1.0 (2025-04-24)

Changes:

- Add `options.Max()` and `options.Min()`.

# v1.0.0 (2025-02-12)

Initial release. The Go version requirement is 1.24.0 because `type Option`
depends on support for `omitzero` in encoding/json for correct marshaling.