Merge remote-tracking branch 'origin/master' into ndyakov/CAE-1088-resp3-notification-handlers

Author: ndyakov

.github/actions/run-tests/action.yml

@@ -25,7 +25,7 @@ runs:
         
         # Mapping of redis version to redis testing containers
         declare -A redis_version_mapping=(
-          ["8.2.x"]="8.2-rc2-pre"
+          ["8.2.x"]="8.2"
           ["8.0.x"]="8.0.2"
           ["7.4.x"]="rs-7.4.0-v5"
           ["7.2.x"]="rs-7.2.0-v17"

.github/wordlist.txt

@@ -74,4 +74,5 @@ Azure
 StreamingCredentialsProvider
 oauth
 entraid
-MiB
+MiB
+KiB

.github/workflows/build.yml

@@ -44,7 +44,7 @@ jobs:
           
           # Mapping of redis version to redis testing containers
           declare -A redis_version_mapping=(
-            ["8.2.x"]="8.2-rc2-pre"
+            ["8.2.x"]="8.2"
             ["8.0.x"]="8.0.2"
             ["7.4.x"]="rs-7.4.0-v5"
           )

.github/workflows/stale-issues.yml

@@ -18,10 +18,11 @@ jobs:
   stale:
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/stale@v9
+      # First step: Handle regular issues (excluding needs-information)
+      - name: Mark regular issues as stale
+        uses: actions/stale@v9
         with:
           repo-token: ${{ secrets.GITHUB_TOKEN }}
-          dry-run: true
 
           # Default stale policy
           days-before-stale: ${{ env.DAYS_BEFORE_STALE }}
@@ -32,15 +33,15 @@ jobs:
           stale-pr-label: "stale"
 
           stale-issue-message: |
-            This issue has been automatically marked as stale due to inactivity. 
-            It will be closed in 30 days if no further activity occurs. 
+            This issue has been automatically marked as stale due to inactivity.
+            It will be closed in 30 days if no further activity occurs.
             If you believe this issue is still relevant, please add a comment to keep it open.
 
           close-issue-message: |
-            This issue has been automatically closed due to inactivity. 
+            This issue has been automatically closed due to inactivity.
             If you believe this issue is still relevant, please reopen it or create a new issue with updated information.
 
-          # Exclude needs-information issues from this job
+          # Exclude needs-information issues from this step
           exempt-issue-labels: 'no-stale,needs-information'
 
           # Remove stale label when issue/PR becomes active again
@@ -51,24 +52,21 @@ jobs:
           days-before-pr-close: ${{ env.DAYS_BEFORE_CLOSE }}
 
           stale-pr-message: |
-            This pull request has been automatically marked as stale due to inactivity. 
+            This pull request has been automatically marked as stale due to inactivity.
             It will be closed in 30 days if no further activity occurs.
 
           close-pr-message: |
-            This pull request has been automatically closed due to inactivity. 
+            This pull request has been automatically closed due to inactivity.
             If you would like to continue this work, please reopen the PR or create a new one.
 
           # Only exclude no-stale PRs (needs-information PRs follow standard timeline)
           exempt-pr-labels: 'no-stale'
 
-  # Separate job for needs-information issues ONLY with accelerated timeline
-  stale-needs-info:
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/stale@v9
+      # Second step: Handle needs-information issues with accelerated timeline
+      - name: Mark needs-information issues as stale
+        uses: actions/stale@v9
         with:
           repo-token: ${{ secrets.GITHUB_TOKEN }}
-          dry-run: true
 
           # Accelerated timeline for needs-information
           days-before-stale: ${{ env.NEEDS_INFO_DAYS_BEFORE_STALE }}
@@ -81,17 +79,17 @@ jobs:
           only-issue-labels: 'needs-information'
 
           stale-issue-message: |
-            This issue has been marked as stale because it requires additional information 
-            that has not been provided for 30 days. It will be closed in 7 days if the 
+            This issue has been marked as stale because it requires additional information
+            that has not been provided for 30 days. It will be closed in 7 days if the
             requested information is not provided.
 
           close-issue-message: |
-            This issue has been closed because the requested information was not provided within the specified timeframe. 
+            This issue has been closed because the requested information was not provided within the specified timeframe.
             If you can provide the missing information, please reopen this issue or create a new one.
 
-          # Disable PR processing for this job
+          # Disable PR processing for this step
           days-before-pr-stale: -1
           days-before-pr-close: -1
 
           # Remove stale label when issue becomes active again
-          remove-stale-when-updated: true
+          remove-stale-when-updated: true

README.md

@@ -20,6 +20,7 @@ In `go-redis` we are aiming to support the last three releases of Redis. Current
 - [Redis 7.2](https://raw.githubusercontent.com/redis/redis/7.2/00-RELEASENOTES) - using Redis Stack 7.2 for modules support
 - [Redis 7.4](https://raw.githubusercontent.com/redis/redis/7.4/00-RELEASENOTES) - using Redis Stack 7.4 for modules support
 - [Redis 8.0](https://raw.githubusercontent.com/redis/redis/8.0/00-RELEASENOTES) - using Redis CE 8.0 where modules are included
+- [Redis 8.2](https://raw.githubusercontent.com/redis/redis/8.2/00-RELEASENOTES) - using Redis CE 8.2 where modules are included
 
 Although the `go.mod` states it requires at minimum `go 1.18`, our CI is configured to run the tests against all three
 versions of Redis and latest two versions of Go ([1.23](https://go.dev/doc/devel/release#go1.23.0),
@@ -77,6 +78,7 @@ key value NoSQL database that uses RocksDB as storage engine and is compatible w
 - [Redis Ring](https://redis.uptrace.dev/guide/ring.html).
 - [Redis Performance Monitoring](https://redis.uptrace.dev/guide/redis-performance-monitoring.html).
 - [Redis Probabilistic [RedisStack]](https://redis.io/docs/data-types/probabilistic/)
+- [Customizable read and write buffers size.](#custom-buffer-sizes)
 
 ## Installation
 
@@ -372,6 +374,21 @@ For example:
 ```
 You can find further details in the [query dialect documentation](https://redis.io/docs/latest/develop/interact/search-and-query/advanced-concepts/dialects/).
 
+#### Custom buffer sizes
+Prior to v9.12, the buffer size was the default go value of 4096 bytes. Starting from v9.12, 
+go-redis uses 256KiB read and write buffers by default for optimal performance.
+For high-throughput applications or large pipelines, you can customize buffer sizes:
+
+```go
+rdb := redis.NewClient(&redis.Options{
+    Addr:            "localhost:6379",
+    ReadBufferSize:  1024 * 1024, // 1MiB read buffer
+    WriteBufferSize: 1024 * 1024, // 1MiB write buffer
+})
+```
+
+**Important**: If you experience any issues with the default buffer sizes, please try setting them to the go default of 4096 bytes.
+
 ## Contributing
 We welcome contributions to the go-redis library! If you have a bug fix, feature request, or improvement, please open an issue or pull request on GitHub.
 We appreciate your help in making go-redis better for everyone.
@@ -412,6 +429,7 @@ vals, err := rdb.Eval(ctx, "return {KEYS[1],ARGV[1]}", []string{"key"}, "hello")
 res, err := rdb.Do(ctx, "set", "key", "value").Result()
 ```
 
+
 ## Run the test
 
 go-redis will start a redis-server and run the test cases.

RELEASE-NOTES.md

@@ -1,17 +1,37 @@
 # Release Notes
 
-# 9.12.0-beta.1 (2025-08-04)
+# 9.12.1 (2025-08-11)
+## 🚀 Highlights
+In the last version (9.12.0) the client introduced bigger write and read buffer sized. The default value we set was 512KiB.
+However, users reported that this is too big for most use cases and can lead to high memory usage.
+In this version the default value is changed to 256KiB. The `README.md` was updated to reflect the
+correct default value and include a note that the default value can be changed.
+
+## 🐛 Bug Fixes
+
+- fix(options): Add buffer sizes to failover. Update README ([#3468](https://github.com/redis/go-redis/pull/3468))
+
+## 🧰 Maintenance
+
+- fix(options): Add buffer sizes to failover. Update README ([#3468](https://github.com/redis/go-redis/pull/3468))
+- chore: update & fix otel example ([#3466](https://github.com/redis/go-redis/pull/3466))
+
+## Contributors
+We'd like to thank all the contributors who worked on this release!
+
+[@ndyakov](https://github.com/ndyakov) and [@vmihailenco](https://github.com/vmihailenco)
+
+# 9.12.0 (2025-08-05)
 
 ## 🚀 Highlights
 
-- This is a beta release for Redis 8.2 support.
+- This release includes support for [Redis 8.2](https://redis.io/docs/latest/operate/oss_and_stack/stack-with-enterprise/release-notes/redisce/redisos-8.2-release-notes/).
 - Introduces an experimental Query Builders for `FTSearch`, `FTAggregate` and other search commands.
 - Adds support for `EPSILON` option in `FT.VSIM`.
-- Includes bug fixes and improvements related to search and community contributions for [redisotel](https://github.com/redis/go-redis/tree/master/extra/redisotel).
+- Includes bug fixes and improvements contributed by the community related to ring and [redisotel](https://github.com/redis/go-redis/tree/master/extra/redisotel).
 
 ## Changes
-
-- chore(github): Improve stale issue workflow ([#3458](https://github.com/redis/go-redis/pull/3458))
+- Improve stale issue workflow ([#3458](https://github.com/redis/go-redis/pull/3458))
 - chore(ci): Add 8.2 rc2 pre build for CI ([#3459](https://github.com/redis/go-redis/pull/3459))
 - Added new stream commands ([#3450](https://github.com/redis/go-redis/pull/3450))
 - feat: Add "skip_verify" to Sentinel ([#3428](https://github.com/redis/go-redis/pull/3428))
@@ -21,33 +41,38 @@
 
 ## 🚀 New Features
 
+- feat: recover addIdleConn may occur panic ([#2445](https://github.com/redis/go-redis/pull/2445))
+- feat(ring): specify custom health check func via HeartbeatFn option ([#2940](https://github.com/redis/go-redis/pull/2940))
 - Add Query Builder for RediSearch commands ([#3436](https://github.com/redis/go-redis/pull/3436))
-- Add configurable buffer sizes for Redis connections ([#3453](https://github.com/redis/go-redis/pull/3453))
+- add configurable buffer sizes for Redis connections ([#3453](https://github.com/redis/go-redis/pull/3453))
 - Add VAMANA vector type to RediSearch ([#3449](https://github.com/redis/go-redis/pull/3449))
 - VSIM add `EPSILON` option ([#3454](https://github.com/redis/go-redis/pull/3454))
 - Add closing support to otel metrics instrumentation ([#3444](https://github.com/redis/go-redis/pull/3444))
 
 ## 🐛 Bug Fixes
 
+- fix(redisotel): fix buggy append in reportPoolStats ([#3122](https://github.com/redis/go-redis/pull/3122))
 - fix(search): return results even if doc is empty ([#3457](https://github.com/redis/go-redis/pull/3457))
 - [ISSUE-3402]: Ring.Pipelined return dial timeout error ([#3403](https://github.com/redis/go-redis/pull/3403))
 
 ## 🧰 Maintenance
 
+- Merges stale issues jobs into one job with two steps ([#3463](https://github.com/redis/go-redis/pull/3463))
+- improve code readability ([#3446](https://github.com/redis/go-redis/pull/3446))
+- chore(release): 9.12.0-beta.1 ([#3460](https://github.com/redis/go-redis/pull/3460))
 - DOC-5472 time series doc examples ([#3443](https://github.com/redis/go-redis/pull/3443))
 - Add VAMANA compression algorithm tests ([#3461](https://github.com/redis/go-redis/pull/3461))
 - bumped redis 8.2 version used in the CI/CD ([#3451](https://github.com/redis/go-redis/pull/3451))
 
 ## Contributors
 We'd like to thank all the contributors who worked on this release!
 
-[@andy-stark-redis](https://github.com/andy-stark-redis), [@cxljs](https://github.com/cxljs), [@htemelski-redis](https://github.com/htemelski-redis), [@jouir](https://github.com/jouir), [@ndyakov](https://github.com/ndyakov), [@ofekshenawa](https://github.com/ofekshenawa), [@rokn](https://github.com/rokn) and [@smnvdev](https://github.com/smnvdev)
+[@andy-stark-redis](https://github.com/andy-stark-redis), [@cxljs](https://github.com/cxljs), [@elena-kolevska](https://github.com/elena-kolevska), [@htemelski-redis](https://github.com/htemelski-redis), [@jouir](https://github.com/jouir), [@monkey92t](https://github.com/monkey92t), [@ndyakov](https://github.com/ndyakov), [@ofekshenawa](https://github.com/ofekshenawa), [@rokn](https://github.com/rokn), [@smnvdev](https://github.com/smnvdev), [@strobil](https://github.com/strobil) and [@wzy9607](https://github.com/wzy9607)
 
 ## New Contributors
-* [@htemelski-redis](https://github.com/htemelski-redis) made their first contribution in https://github.com/redis/go-redis/pull/3409
-* [@smnvdev](https://github.com/smnvdev) made their first contribution in https://github.com/redis/go-redis/pull/3403
-* [@rokn](https://github.com/rokn) made their first contribution in https://github.com/redis/go-redis/pull/3444
-
+* [@htemelski-redis](https://github.com/htemelski-redis) made their first contribution in [#3409](https://github.com/redis/go-redis/pull/3409)
+* [@smnvdev](https://github.com/smnvdev) made their first contribution in [#3403](https://github.com/redis/go-redis/pull/3403)
+* [@rokn](https://github.com/rokn) made their first contribution in [#3444](https://github.com/redis/go-redis/pull/3444)
 
 # 9.11.0 (2025-06-24)
 
@@ -383,4 +408,4 @@ We would like to thank all the contributors who made this release possible:
 ### Fixed
 
 - Improved and fixed pipeline retries.
-- As usually, added support for more commands and fixed some bugs.
+- As usually, added support for more commands and fixed some bugs.

example/del-keys-without-ttl/go.mod

@@ -5,7 +5,7 @@ go 1.18
 replace github.com/redis/go-redis/v9 => ../..
 
 require (
-	github.com/redis/go-redis/v9 v9.12.0-beta.1
+	github.com/redis/go-redis/v9 v9.12.1
 	go.uber.org/zap v1.24.0
 )
 

example/hll/go.mod

@@ -4,7 +4,7 @@ go 1.18
 
 replace github.com/redis/go-redis/v9 => ../..
 
-require github.com/redis/go-redis/v9 v9.12.0-beta.1
+require github.com/redis/go-redis/v9 v9.12.1
 
 require (
 	github.com/cespare/xxhash/v2 v2.3.0 // indirect

example/hset-struct/go.mod

@@ -6,7 +6,7 @@ replace github.com/redis/go-redis/v9 => ../..
 
 require (
 	github.com/davecgh/go-spew v1.1.1
-	github.com/redis/go-redis/v9 v9.12.0-beta.1
+	github.com/redis/go-redis/v9 v9.12.1
 )
 
 require (

example/lua-scripting/go.mod

@@ -4,7 +4,7 @@ go 1.18
 
 replace github.com/redis/go-redis/v9 => ../..
 
-require github.com/redis/go-redis/v9 v9.12.0-beta.1
+require github.com/redis/go-redis/v9 v9.12.1
 
 require (
 	github.com/cespare/xxhash/v2 v2.3.0 // indirect