Skip to content

Commit 9500f27

Browse files
committed
Changelog for v5.0.0 release
1 parent c0ff1d4 commit 9500f27

File tree

2 files changed

+38
-1
lines changed

2 files changed

+38
-1
lines changed

CHANGELOG.md

Lines changed: 37 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,42 @@
11
# Changelog
22

3+
## v5.0.0 - 2026-01-18
4+
5+
Echo `v5` is maintenance release with **major breaking changes**
6+
- `Context` is now struct instead of interface and we can add method to it in the future in minor versions.
7+
- Adds new `Router` interface for possible new routing implementations.
8+
- Drops old logging interface and uses moderm `log/slog` instead.
9+
- Rearranges alot of methods/function signatures to make them more consistent.
10+
11+
Upgrade notes and `v4` support:
12+
- Echo `v4` is supported with **security*** updates and **bug** fixes until **2026-12-31**
13+
- If you are using Echo in a production environment, it is recommended to wait until after 2026-03-31 before upgrading.
14+
- Until 2026-03-31, any critical issues requiring breaking `v5` API changes will be addressed, even if this violates semantic versioning.
15+
16+
See [API_CHANGES_V5.md](./API_CHANGES_V5.md) for public API changes between `v4` and `v5`, notes on **upgrading**.
17+
18+
Upgrading TLDR:
19+
20+
If you are using Linux you can migrate easier parts like that:
21+
```bash
22+
find . -type f -name "*.go" -exec sed -i 's/ echo.Context/ *echo.Context/g' {} +
23+
find . -type f -name "*.go" -exec sed -i 's/echo\/v4/echo\/v5/g' {} +
24+
```
25+
macOS
26+
```bash
27+
find . -type f -name "*.go" -exec sed -i '' 's/ echo.Context/ *echo.Context/g' {} +
28+
find . -type f -name "*.go" -exec sed -i '' 's/echo\/v4/echo\/v5/g' {} +
29+
```
30+
31+
or in your favorite IDE
32+
33+
Replace all:
34+
1. ` echo.Context` -> ` *echo.Context`
35+
2. `echo/v4` -> `echo/v5`
36+
37+
This should solve most of the issues. Probably the hardest part is updating all the tests.
38+
39+
340
## v4.15.0 - 2026-01-01
441

542

version.go

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -5,5 +5,5 @@ package echo
55

66
const (
77
// Version of Echo
8-
Version = "5.0.0-alpha"
8+
Version = "5.0.0"
99
)

0 commit comments

Comments
 (0)