PyPI · #526 most downloaded on PyPI

fakeredis

2.39.037M downloads/mocunla/fakeredis-py ↗New releases in your daily digest, changelog included.

Python implementation of redis API, can be used for testing purposes.

Last release 4 days ago
01 Oct 2026
Ships fairly regularly
a new release about every 4 weeks
Nearly every release is documented
notes for 60 of the last 60 stable releases
1 version withdrawn
withdrawn after publishing
15 years old
146 releases · first in 2012

Release timeline

146 releases since 2012

2012201420162018

Releases

2.39.01 Oct 20263 sources agree
feat: support Redis 8.10 commands LMOVEM , BLMOVEM , SUNIONCARD , SDIFFCARD , TS.QUERYLABELS , TS.NRANGE , TS.NREVRANGE and TS.READ
🚀 Features

feat: support Redis 8.10 commands LMOVEM, BLMOVEM, SUNIONCARD, SDIFFCARD, TS.QUERYLABELS, TS.NRANGE, TS.NREVRANGE and TS.READ (#597)

feat(kividb): add the kividb server type, matching KiviDB 1.0.4's command surface (#570, #571)

feat(streams): XADD/XTRIM accept the KEEPREF/DELREF/ACKED reference policies (#583)

🐛 Bug Fixes

fix: MOVE/SMOVE invalidate WATCH like Redis, add SORT_RO, sort unsorted SORT results in scripts/STORE, and fix ZSCAN while deleting (#595)

fix(bitmap): BITOP pads shorter operands and treats missing keys as empty (#593)

fix(geo): *BYMEMBER/FROMMEMBER searches on a missing member return Redis'/Valkey 9's error instead of crashing (#594)

fix(valkey): from_url works for FakeValkey, FakeStrictValkey and FakeAsyncValkey (#591)

fix(streams): approximate (~) trimming drops whole nodes and XADD/XTRIM options use Redis' errors (#583)

fix(streams): XADD never reuses deleted IDs and rejects invalid IDs like Redis (#583)

fix(streams): XGROUP SETID/CREATE, entries-read and lag follow Redis' rules (#583)

fix(streams): consumer-group commands on a missing key return Redis' errors (#584)

fix(streams): XRANGE/XREVRANGE/XPENDING treat an end ID without sequence as the whole millisecond (#584)

fix(tdigest): TDIGEST.QUANTILE on a single observation follows Redis 8.10 (#597)

fix(tcp-server): TcpFakeServer answers RESP2 clients in RESP2 (#580)

fix(model): ExpiringMembersSet keeps the member when clearing its TTL (#578)

fix(async): FakeAsyncValkey raises valkey exceptions and async connections report addr/laddr/fd (#589)

fix: each connection gets one client ID, and a new one on reconnect (#589)

fix: FakeRedis(version=10) no longer shares a server with version=1 (#589)

🧰 Maintenance

perf: cache glob patterns, skip empty TTL scans, and stop polling in get_message(timeout=...) (#577)

refactor: layer internals into fakeredis/_core, fakeredis/_clients and fakeredis/_socket packages (#589, #590, #592)

test: run CI against Redis 8.10 and a real KiviDB (#570, #597)

test: drop stale TODOs and narrow Dragonfly zset test skips (#596)

test: drop from __future__ import annotations from test files (#586)

chore: update dependencies and the setup-uv action (#587)

New Contributors

@kratos0718 made their first contribution in #593

Full Changelog: v2.38.0...v2.39.0

One column per quarter.

2.38.08 Sept 20263 sources agree

feat: implement Dragonfly's CL.THROTTLE rate-limiting command, ported from Dragonfly's own code so the quirks match — millisecond-ceiling time fields,

v2.38.0 - 2026-09-08

🚀 Features

feat: implement Dragonfly's CL.THROTTLE rate-limiting command, ported from Dragonfly's own code so
the quirks match — millisecond-ceiling time fields, remaining truncating towards zero, and an
over-sized request reporting retry_after = -1 without writing the key (#536)
feat(dragonfly): match its errors, validation and limits — backticked unknown-command errors,
unsigned numkeys/COUNT, SCAN COUNT 0 falling back to the default batch size, SMOVE checking
its destination type up front, no LCS at all, a relative expiry past 2**28-1 seconds clamped
while an absolute one is rejected, hash-field TTLs capped at 2**26 seconds, and strings capped at
256MB rather than Redis' 512MB (#555, #556)
feat(dragonfly): match the replies it sends — doubles from INCRBYFLOAT/HINCRBYFLOAT, empty arrays
from a timed-out blocking pop and from an XREAD/XREADGROUP that matched nothing, ZPOPMIN/
ZPOPMAX always paired under RESP3, flat WITHSCORES from ZUNION/ZINTER, a null
first-entry/last-entry for an empty stream, -1 as XINFO GROUPS' unknown-lag sentinel,
XPENDING looking up the key before the group, and one namespace for shard and plain pub/sub
channels (#557, #558, #559)
feat(dragonfly): match its command behaviour — SORT without -> hash-field patterns and without
Redis' weight tie-break, COPY without a DB option, GEORADIUS/GEOSEARCH in geohash order
unless sorted, a watched key dirtied by any write, Lua 5.4 scripting (non-integral numbers as
doubles, Redis 6-style error wrapping, admin commands refused inside scripts), and its own JSON
quirks (legacy paths wrapped like JSONPath, no filter expressions) (#560, #561, #562, #563)

🐛 Bug Fixes

fix: redis.call in a Lua script now returns RESP2 shapes whatever protocol the client negotiated,
matching real Redis, where a script must opt into RESP3. redis.setresp(2)/redis.setresp(3) are
now supported and reset to RESP2 for each run. Dragonfly has no redis.setresp, so fakeredis does
not expose one when emulating it, and a script returning {double=...} there answers with an empty
array the way the real server does (#543)
fix: XCLAIM/XAUTOCLAIM now move an entry's pending count to the claiming consumer instead of
leaving it on the previous owner, so a later XACK no longer drives that count negative (#548)
fix: XACK no longer raises a raw Python KeyError when a pending entry has no live consumer, and
XGROUP DELCONSUMER now removes the entries that consumer owned, returning how many it dropped
(#549)
fix: XCLAIM now honours RETRYCOUNT, and XCLAIM/XAUTOCLAIM honour JUSTID, when updating an
entry's delivery counter. RETRYCOUNT takes precedence over JUSTID, and a negative RETRYCOUNT
means "not given" (#544)
fix: cancelling a blocking async command (BRPOP, BLPOP, XREAD BLOCK 0, ...) no longer leaves
the connection unusable — it went back to the pool with its socket still paused, so every later
command on it hung (#471)
fix: XAUTOCLAIM now returns the cursor its next scan should start from, and 0-0 once the pending
list is exhausted (#547)
fix: SMOVE no longer raises WRONGTYPE for a wrongly typed destination when the source key is
missing, BITCOUNT reports the syntax error before decoding its range arguments on a pre-7.0
server, and GEORADIUS returns an unsorted reply in geohash order rather than insertion order
(#553)
fix: reap TcpFakeServer handler threads when a client disconnects (#541)

🧰 Maintenance

docs: docs/dragonfly-support.md now writes up every Dragonfly divergence fakeredis emulates, and
the handful it does not (#564)
test(hypothesis): the stateful machines now run against Dragonfly in CI, with the non-deterministic
corners kept out (skiplist-encoded sorted sets, hash-order aggregation, SAVE, short-circuiting set
intersections) (#564)

New Contributors

@ProchazkaDavid made their first contribution in #547
@arththebird made their first contribution in #541

Full Changelog: v2.37.1...v2.38.0

Open source →

2.37.118 Aug 20263 sources agree

fix: honor the FILTER-EF (max filtering effort) option in VSIM — the value was previously parsed but ignored, so a low FILTER-EF could return filter m

What's Changed

🐛 Bug Fixes

fix: honor the FILTER-EF (max filtering effort) option in VSIM — the value was previously parsed but ignored, so a
low FILTER-EF could return filter matches that real Redis skips
fix: ZPOPMIN/ZPOPMAX in RESP3 now return a flat [member, score] pair when no count is given (an array of pairs is
only returned when an explicit count is passed), matching real Redis
fix: ZPOPMIN/ZPOPMAX now reject a negative count with value is out of range, must be positive
fix: ZPOPMIN/ZPOPMAX/BZPOPMIN/BZPOPMAX/ZMPOP/BZMPOP now delete the sorted set key once its last member is
popped
fix: LTRIM now signals the key as modified even when the trim is a no-op, so a WATCH on that key correctly aborts
the following transaction, matching real Redis
fix: align stream group errors with Redis — XPENDING on a missing key or unknown group now raises NOGROUP instead
of returning 0/an empty array, and neither XPENDING nor XINFO GROUPS creates the key as a side effect (#532)

🧰 Maintenance

perf: VADD/VSIM keep a row-oriented matrix of the vector set resident and reuse it, instead of restacking every
stored vector on each call; re-adding an existing member now replaces its row rather than leaving a stale one
perf: cache compiled JSONPath objects in the JSON stack mixin (#538)
build: drop Python 3.9, target Python 3.10+ (#534)
Update to redis-py 8.1
refactor: modernize typing for Ruff 0.16 defaults (#533)
test: refactor hypothesis tests

New Contributors

@emerardd made their first contribution in #532
@flowln made their first contribution in #538

Full Changelog: v2.37.0...v2.37.1

Open source →

2.37.022 Jul 2026

feat: implement connection commands RESET , CLIENT KILL , CLIENT UNBLOCK , CLIENT REPLY , CLIENT PAUSE , CLIENT UNPAUSE , CLIENT NO-EVICT and CLIENT N

v2.37.0 - 2026-07-22

🚀 Features

feat: implement connection commands RESET, CLIENT KILL, CLIENT UNBLOCK, CLIENT REPLY, CLIENT PAUSE,
CLIENT UNPAUSE, CLIENT NO-EVICT and CLIENT NO-TOUCH. CLIENT PAUSE validates and records its arguments but does
not actually suspend command processing; the client-side caching commands (CLIENT TRACKING, CLIENT TRACKINGINFO,
CLIENT CACHING, CLIENT GETREDIR) remain unsupported
feat: support INCREX command (redis 8.8) (#520)
feat: support FPHA argument in JSON.SET to force homogeneous numeric arrays to a floating-point type (redis 8.8) (
#523)
feat: support hash field subkey notifications (redis 8.8) (#525)
feat: support multiple aggregators in TS.RANGE/TS.REVRANGE/TS.MRANGE/TS.MREVRANGE (redis 8.8) (#524)
feat: support COUNT aggregator in ZUNION/ZINTER/ZUNIONSTORE/ZINTERSTORE (redis 8.8) (#522)
feat: support CLAIM min-idle-time option in XREADGROUP (redis 8.4) (#527)
feat(bitfield): support #-prefixed offsets in BITFIELD

🐛 Bug Fixes

fix: align XNACK with redis 8.8 semantics (#521)
fix: HEXPIRE/HPEXPIRE now raise an error on negative expiration time
fix: GEOADD now rejects longitude/latitude pairs outside the valid range

🧰 Maintenance

Update to redis-py 8.0.1
Update Valkey version used in CI to 8.1.8
refactor: reorganize and clean up command classes in _commands.py and related mixins
test: skip subkey notification tests on redis-py below 5 (#526)
doc: fix link to implement command guide (#519)

Full Changelog: v2.36.2...v2.37.0

Open source →

Additional notes2 sources agree

🚀 Features

feat: implement connection commands RESET, CLIENT KILL, CLIENT UNBLOCK, CLIENT REPLY, CLIENT PAUSE, CLIENT UNPAUSE, CLIENT NO-EVICT and CLIENT NO-TOUCH. CLIENT PAUSE validates and records its arguments but does not actually suspend command processing; the client-side caching commands (CLIENT TRACKING, CLIENT TRACKINGINFO, CLIENT CACHING, CLIENT GETREDIR) remain unsupported
feat: support INCREX command (redis 8.8) (#520)
feat: support FPHA argument in JSON.SET to force homogeneous numeric arrays to a floating-point type (redis 8.8) ( #523)
feat: support hash field subkey notifications (redis 8.8) (#525)
feat: support multiple aggregators in TS.RANGE/TS.REVRANGE/TS.MRANGE/TS.MREVRANGE (redis 8.8) (#524)
feat: support COUNT aggregator in ZUNION/ZINTER/ZUNIONSTORE/ZINTERSTORE (redis 8.8) (#522)
feat: support CLAIM min-idle-time option in XREADGROUP (redis 8.4) (#527)
feat(bitfield): support #-prefixed offsets in BITFIELD

🐛 Bug Fixes

fix: align XNACK with redis 8.8 semantics (#521)
fix: HEXPIRE/HPEXPIRE now raise an error on negative expiration time
fix: GEOADD now rejects longitude/latitude pairs outside the valid range
fix: validate command option values that real Redis rejects instead of silently acting on them — negative expirations in HGETEX/HSETEX, non-positive COUNT/numkeys in LMPOP/BLMPOP/ZMPOP/BZMPOP and SINTERCARD, negative LPOS COUNT/MAXLEN, out-of-range COPY DB index, negative blocking timeouts, non-positive SCAN/SSCAN/HSCAN/ZSCAN COUNT, and invalid BITCOUNT/BITPOS range arguments (#528)

🧰 Maintenance

Update to redis-py 8.0.1
Update Valkey version used in CI to 8.1.8
refactor: reorganize and clean up command classes in _commands.py and related mixins
test: skip subkey notification tests on redis-py below 5 (#526)
doc: fix link to implement command guide (#519)

Open source →

2.36.217 Jun 20263 sources agree

fix: replace async can_read busy-poll with event-based wakeup

🐛 Bug Fixes

fix: replace async can_read busy-poll with event-based wakeup (#506)
fix: enforce GT/LT conditions in ZADD with INCR (#507)
fix: reject negative LIMIT in SINTERCARD and ZINTERCARD (#508)
fix: EXPIRE GT/LT mishandle keys with no existing TTL (#509)
fix: restore missing addr/laddr/fd fields in CLIENT LIST/CLIENT INFO (#512)
fix: SORT/SORT_RO BY must keep natural order (#510)

New Contributors

@xav-ie made their first contribution in #506
@gaoflow made their first contribution in #507

Full Changelog: v2.36.1...v2.36.2

Open source →

2.36.17 Jun 20263 sources agree

fix: TypeError on import in Python 3.8 due to list[Any] annotation in sort command

🐛 Bug Fixes

fix: TypeError on import in Python 3.8 due to list[Any] annotation in sort command (#490)
fix: Using path in connection
fix(async): _decode recurses into dict so RESP3 HGETALL responses are decoded (#492)
fix: Database now uses stable identity-based __hash__/__eq__ (previously returned an unstable hash)

🧰 Maintenance

Restored support for redis-py 4.6 #493
Update the default server version to 8.
refactor: deduplicate sync and async client construction into a shared build_client_kwds helper
chore: remove dead code in connection/socket setup

Full Changelog: v2.36.0...v2.36.1

Open source →

2.36.029 May 20263 sources agree

Implement keyspace notifications @alexbthundiyil-spec

🚀 Features

Implement keyspace notifications @alexbthundiyil-spec (#463)
feat(lua): add server global alias for Valkey @przemub (#480)
feat(streams): implement XACKDEL, XDELEX, XIDMPRECORD, XNACK commands (#484)
feat: add VISMEMBER command to check element existence in vector set
feat: implement array commands (ARSET, ARGET, ARLEN, ARGETRANGE, ARINSERT, ARDEL, etc.) for Redis 8.8 (
#487)

🐛 Bug Fixes

fix: XREADGROUP with non-'>' ID returns consumer PEL @tomtom103 #470
fix: similarity calculation in vector set VSIM command
fix: CF.RESERVE and CF.SCANDUMP should not create keys if they do not exist
fix: various issues in vector set commands VSET
fix(tcp_server): clean up handler threads on shutdown (#479)

🧰 Maintenance

Improved CLIENT INFO and CLIENT GETNAME commands
Better TDigest implementation
Update Redis 8 image used in CI to 8.8
Update to redis-py 8.0.0
perf(hash): make HSET O(1) by using len(h) instead of len(h.keys()) @invoker-bot (#473)
refactor: introduce CommandsMixinBase to centralise shared mixin attributes (#482)
refactor: VectorSet improvements (#476)
refactor: async Redis tests to use AsyncClientType for improved type safety

New Contributors

@tomtom103 made their first contribution in #470
@alexbthundiyil-spec made their first contribution in #463
@invoker-bot made their first contribution in #473
@przemub made their first contribution in #480
@cjwatson made their first contribution in #485

Full Changelog: v2.35.1...v2.36.0

Open source →

2.35.112 Apr 2026Breaking3 sources agree

fix: Breaking change in 2.35.0: FakeConnection renamed without backward-compatible alias #468

🐛 Bug Fixes

fix: Breaking change in 2.35.0: FakeConnection renamed without backward-compatible alias #468

Full Changelog: v2.35.0...v2.35.1

Open source →

2.35.09 Apr 2026Deprecated3 sources agree

Fix DeprecationWarning caused by mixing valkey and redis classes ( @kurtmckee ) #462 #464

What's Changed

🚀 Features

Support for idempotent message processing introduced in Redis 8.6 #461
Support for vector set commands VADD, VCARD, VDIM, VEMB, VGETATTR, VINFO, VLINKS, VRANDMEMBER,
VRANGE, VREM, VSETATTR, VSIM #451

🐛 Bug Fixes

fix XREADGROUP on multiple streams only returns one message #460
fix: XDEL sending ResponseError when stream ID is invalid #465
Fix DeprecationWarning caused by mixing valkey and redis classes (@kurtmckee) #462 #464
fix: bug referencing non existing variable #465

🧰 Maintenance

Update typing-extensions version constraint to support newer versions #458
Improved documentation with mermaidjs diagrams #467
Move documentation dependencies to pyproject.toml

Full Changelog: v2.34.1...v2.35.0

Open source →

2.34.125 Feb 2026Deprecated3 sources agree

Fix handling of deprecated arguments in FakeRedis to support redis-py 7.2.0 #457

What's Changed

🐛 Bug Fixes

Fix handling of deprecated arguments in FakeRedis to support redis-py 7.2.0 #457
Blocking XREAD with block=0 works as expected #453

Full Changelog: v2.34.0...v2.34.1

Open source →

2.34.016 Feb 2026

TcpFakeServer supports RESP3 #437

🚀 Features

TcpFakeServer supports RESP3 #437

🐛 Bug Fixes

Add missing keys to XINFO STREAM #445
Caching LuaRuntime to prevent memory leak in eval() @chrisguidry #449 #446

New Contributors

@chrisguidry made their first contribution in #449

Full Changelog: v2.33.0...v2.34.0

Open source →

Additional notes2 sources agree

🚀 Features

TcpFakeServer supports RESP3 #437

🐛 Bug Fixes

Add missing keys to XINFO STREAM #445
Caching LuaRuntime to prevent memory leak in eval() @chrisguidry #449 #446

🧰 Maintenance

Refactor models to use BaseModel with redis-type #454

Open source →

2.33.016 Dec 20253 sources agree

Implement MSETEX (From Redis 8.4)

🚀 Features

Implement MSETEX (From Redis 8.4)

🐛 Bug Fixes

fix[FakeAsyncRedis]: FakeAsyncRedis supports protocol=3 #442
fix[TcpFakeServer]: TcpFakeServer supports pub/sub #431
fix[TcpFakeServer]: preserve whitespace in bulk strings @oliverhaas #435

🧰 Maintenance

Update tests to support redis-py 7.1.0 and Redis 8.4
Async tests run on resp3 and resp2

New Contributors

@oliverhaas made their first contribution in https://github.com/cunla/fakeredis-py/pull/433

Full Changelog: https://github.com/cunla/fakeredis-py/compare/v2.32.1...v2.33.0

Open source →

Additional notes

🚀 Features

Implement MSETEX (From Redis 8.4)

🐛 Bug Fixes

fix[FakeAsyncRedis]: FakeAsyncRedis supports protocol=3 #442
fix[TcpFakeServer]: TcpFakeServer supports pub/sub #431
fix[TcpFakeServer]: preserve whitespace in bulk strings @oliverhaas #435

🧰 Maintenance

Update tests to support redis-py 7.1.0 and Redis 8.4
Async tests run on resp3 and resp2

New Contributors

@oliverhaas made their first contribution in #433

Full Changelog: v2.32.1...v2.33.0

Open source →

2.32.16 Nov 20253 sources agree

fix:xpending_range to return all 4 required fields per Redis spec @zzstoatzz #427

v2.32.1 -

🐛 Bug Fixes

fix:support for py3.7 #423
fix:xpending_range to return all 4 required fields per Redis spec @zzstoatzz #427
fix[TcpFakeServer]: add exception prefix #432

🧰 Maintenance

Update tests to support redis-py 7.0.1
Update tests to support valkey 9.0.0

Full Changelog: https://github.com/cunla/fakeredis-py/compare/v2.32.0...v2.32.1

Open source →

2.32.07 Oct 20253 sources agree

add support for nx/xx/gt/lt options for expireat/pexpire/pexpireat @praboud-ant #421

🐛 Bug Fixes

🚀 Features

add support for nx/xx/gt/lt options for expireat/pexpire/pexpireat @praboud-ant #421

🐛 Bug Fixes

fix:removing use of self.protocol to support redis-py < 5 #419
fix:race condition due to closing socket in TCPFakeRequestHandler:finish #420

New Contributors

@praboud-ant made their first contribution in https://github.com/cunla/fakeredis-py/pull/415

Full Changelog: https://github.com/cunla/fakeredis-py/compare/v2.31.3...v2.32.0

Open source →

2.31.322 Sept 20252 sources agree

Fix checking valkey exceptions in async client #416

🐛 Bug Fixes

Fix checking valkey exceptions in async client #416
Fix issue with TS.MRANGE filters with IN condition not working @ben-swid #414 #415
Fix issue trying to import valkey when connection class is FakeRedis #417

Open source →

2.31.131 Aug 20253 sources agree

Sending lib_name and lib_version only when relevant #408

🐛 Bug Fixes

Sending lib_name and lib_version only when relevant #408
TcpFakeServer: Closing threads on server close #409
TcpFakeServer: Register Lock scripts #406

🧰 Maintenance

Improve documentation of using TcpFakeServer #409
Support TcpFakeServer for Python 3.9 (#411)

Contributors

We'd like to thank all the contributors who worked on this release!

@mgorny and @phi-friday

Full Changelog: https://github.com/cunla/fakeredis-py/compare/v2.31.0...v2.31.1

Open source →

2.31.011 Aug 20253 sources agree

Add native cjson support for lua redis scripts #399 @ItsDrike

🚀 Features

Add native cjson support for lua redis scripts #399 @ItsDrike

🐛 Bug Fixes

version init argument typing #401
include lib_name and lib_version in FakeBaseConnectionMixin
when using FakeValkey, raise valkey.ResponseError instead of redis.ResponseError #402
fix issue with pytest-asyncio #404 @seifertm

New Contributors

@ItsDrike made their first contribution in https://github.com/cunla/fakeredis-py/pull/399
@seifertm made their first contribution in https://github.com/cunla/fakeredis-py/pull/404

Full Changelog: https://github.com/cunla/fakeredis-py/compare/v2.30.3...v2.31.0

Open source →

2.30.329 Jul 20253 sources agree

Import Callable from typing to support python 3.8 #398

🐛 Bug Fixes

Import Callable from typing to support python 3.8 #398
FakeValkey init arguments #400

Full Changelog: https://github.com/cunla/fakeredis-py/compare/v2.30.2...v2.30.3

Open source →

2.30.228 Jul 20253 sources agree

Import Callable from typing to support python 3.8 #398

🐛 Bug Fixes

Import Callable from typing to support python 3.8 #398

🧰 Maintenance

Refactor tests
FakeValkey uses valkey-py instead of redis-py

Full Changelog: https://github.com/cunla/fakeredis-py/compare/v2.30.1...v2.30.2

Open source →

2.30.119 Jun 2025Deprecated

Show warning for deprecated parameter only if parameter is included in instantiation #384

🐛 Bug Fixes

Move LICENSE file to fakeredis/ on build #395
Show warning for deprecated parameter only if parameter is included in instantiation #384

🧰 Maintenance

Replace deprecated event_loop fixture @mgorny #396

Full Changelog: https://github.com/cunla/fakeredis-py/compare/v2.30.0...v2.30.1

Open source →

Additional notes2 sources agree

🐛 Bug Fixes

Move LICENSE file to fakeredis/ on build #395
Show warning for deprecated parameter only if the parameter is included in instantiation #384

🧰 Maintenance

Replace deprecated event_loop fixture @mgorny #396

Open source →

2.30.016 Jun 2025

Implement support for COPY @ajhetherington #383

Changes

🚀 Features

Support for RESP3 #360
Implement support for COPY @ajhetherington #383

🐛 Bug Fixes

aio.FakeRedis: Using inspect to get __init__ paramaters #384
Discrepancy when using xread with resp3 #393

Contributors

We'd like to thank all the contributors who worked on this release!

@ajhetherington

Full Changelog: https://github.com/cunla/fakeredis-py/compare/v2.29.0...v2.30.0

Open source →

Additional notes2 sources agree

🚀 Features

Support for RESP3 #360
Implement support for COPY @ajhetherington #383

🐛 Bug Fixes

aio.FakeRedis: Using inspect to get __init__ parameters #384
Discrepancy when using xread with resp3 #393

Open source →

2.29.06 May 2025

Implement support for NOVALUES for HSCAN

🚀 Features

Implement support for NOVALUES for HSCAN
Implement support for CLIENT LIST #376

🐛 Bug Fixes

Fix json.set nx arg behavior #372
Fix issue with hset not resetting expiration over field
Fix inconsistent 'pending' field in return from XINFO GROUPS #374
Fix TDIGEST.QUANTILE to match redis behavior on a TDigest with one value #377
Fix HINCRBY/hincrbyfloat commands now don't remove ttl from hash key @M1ha-Shvn #381

New Contributors

@M1ha-Shvn made their first contribution in https://github.com/cunla/fakeredis-py/pull/381

Full Changelog: https://github.com/cunla/fakeredis-py/compare/v2.28.1...v2.29.0

Open source →

Additional notes2 sources agree

🚀 Features

Implement support for NOVALUES for HSCAN
Implement support for CLIENT LIST #376

🐛 Bug Fixes

Fix json.set nx arg behavior #372
Fix issue with hset not resetting expiration over field
Fix inconsistent 'pending' field in return from XINFO GROUPS #374
Fix TDIGEST.QUANTILE to match redis behavior on a TDigest with one value #377
Fix HINCRBY/hincrbyfloat commands now don't remove ttl from hash key @M1ha-Shvn #381

🧰 Maintenance

Running redis-stack tests on redis8 #382

Open source →

2.28.12 Apr 20253 sources agree

Open commands.json with encoding specified #367

🐛 Bug Fixes

Open commands.json with encoding specified #367
Fix xadd to use last timestamp if the current system timestamp is lower than the last timestamp #368

Full Changelog: https://github.com/cunla/fakeredis-py/compare/v2.28.0...v2.28.1

Open source →

2.28.029 Mar 20253 sources agree

implement support for WITHSCORE in ZRANK and ZREVRANK #357

🚀 Features

implement support for WITHSCORE in ZRANK and ZREVRANK #357
implement support for Connection commands HELLO, CLIENT SETNAME, CLIENT GETNAME, CLIENT ID, CLIENT INFO #361
implement support for HGETEX, HSETEX, HGETDEL #365

🐛 Bug Fixes

Fix test_tcp_server_started to close the connection @mgorny (#363)
[ACL] Always allow AUTH command @wakonig (#362)
[ACL] Provide default account acl on startup @wakonig (#362)

🧰 Maintenance

Refactor hypothesis tests (#366)

Contributors

We'd like to thank all the contributors who worked on this release!

@mgorny and @wakonig

Full Changelog: https://github.com/cunla/fakeredis-py/compare/v2.27.0...v2.28.0

Open source →

2.27.011 Feb 20253 sources agree

ACL LOAD, ACL SAVE, ACL LIST, ACL USERS, ACL GETUSER, ACL SETUSER, ACL DELUSER, ACL CAT, ACL LOG, ACL HELP, ACL WHOAMI, ACL GENPASS, ACL AUTH, ACL LOG

Changes

🚀 Features

ACL commands support #338
- ACL LOAD, ACL SAVE, ACL LIST, ACL USERS, ACL GETUSER, ACL SETUSER, ACL DELUSER, ACL CAT, ACL LOG, ACL HELP, ACL WHOAMI, ACL GENPASS, ACL AUTH, ACL LOG_RESET, ACL LOG_COUNT, ACL LOG_GET, ACL LOG_HELP, ACL LOG_RESET, ACL LOG_COUNT, ACL LOG_GET, ACL LOG_HELP
Add support disable_decoding in async read_response #349
Implement support for SADDEX, using a new set implementation with support for expiring members #350

🧰 Maintenance

Remove end of life python 3.8 from test matrix
Add python 3.13 to test matrix
Improve documentation for Dragonfly/Valkey support

Contributors

We'd like to thank all the contributors who worked on this release!

@Redoubts

Full Changelog: https://github.com/cunla/fakeredis-py/compare/v2.26.2...v2.27.0

Open source →

2.26.217 Dec 20243 sources agree

Fix bug in xreadgroup when stream length is less than COUNT with BLOCK #344

🐛 Bug Fixes

Fix bug in xreadgroup when stream length is less than COUNT with BLOCK #344

🧰 Maintenance

Implement test for SADDEX (Dragonfly specific command) #348
Update dependencies

Full Changelog: https://github.com/cunla/fakeredis-py/compare/v2.26.1...v2.26.2

Open source →

2.26.128 Oct 2024

## 🧰 Maintenance - add py3.7 test (#343) Full Changelog: https://github.com/cunla/fakeredis-py/compare/v2.26.0...v2.26.1

🧰 Maintenance

add py3.7 test (#343)

Full Changelog: https://github.com/cunla/fakeredis-py/compare/v2.26.0...v2.26.1

Open source →

Additional notes2 sources agree

🐛 Bug Fixes

Minor fix: using typing_extensions instead of typing for python 3.7 support #341/#343

Open source →

2.26.024 Oct 20243 sources agree

Support for server-type specific commands #340

🚀 Features

Support for server-type specific commands #340
Support for Dragonfly SADDEX command #340

🐛 Bug Fixes

Fix bug in bitpos function for the clear bit mode @Diskein #337

Full Changelog: https://github.com/cunla/fakeredis-py/compare/v2.25.1...v2.26.0

Open source →

2.25.130 Sept 20243 sources agree

Fix missing default values for version/server_type in FakeBaseConnectionMixin #334

🐛 Bug Fixes

Fix missing default values for version/server_type in FakeBaseConnectionMixin #334

Full Changelog: https://github.com/cunla/fakeredis-py/compare/v2.25.0...v2.25.1

Open source →

2.25.028 Sept 20243 sources agree

Implement support for hash expiration related commands @j00bar #328 HEXPIRE, HEXPIREAT, HEXPIRETIME, HPERSIST, HPEXPIRE, HPEXPIREAT, HPEXPIRETIME, HPT

🚀 Features

Implement support for hash expiration related commands @j00bar #328 HEXPIRE, HEXPIREAT, HEXPIRETIME, HPERSIST, HPEXPIRE, HPEXPIREAT, HPEXPIRETIME, HPTTL, HTTL,
Implement support for SORT_RO #325, EXPIRETIME #323, and PEXPIRETIME #324
Support for creating a tcp server listening to multiple clients
Testing against valkey 8.0 #333
Improve documentation #332

🐛 Bug Fixes

Replace typing_extensions dependency with typing-extensions #330

Contributors

We'd like to thank all the contributors who worked on this release!

@cunla and @j00bar

Full Changelog: https://github.com/cunla/fakeredis-py/compare/v2.24.1...v2.25.0

Open source →

2.24.126 Aug 20243 sources agree

Fix license file added to site-packages #320

Changes

🐛 Bug Fixes

Fix license file added to site-packages #320

Full Changelog: https://github.com/cunla/fakeredis-py/compare/v2.24.0...v2.24.1

Open source →

2.24.024 Aug 20243 sources agree

Support for TIME SERIES commands (no support for align arguments on some commands) #310

🚀 Features

Support for TIME SERIES commands (no support for align arguments on some commands) #310

🐛 Bug Fixes

fix:xrevrange to work with exclusive ranges @hurlenko #319

🧰 Maintenance

Update all dependencies, particularly pytest to v8
Add tests against Dragonfly server #318
Implement decocator unsupported_server_types to enable excluding tests from running against certain server types #318

Contributors

We'd like to thank all the contributors who worked on this release!

@hurlenko

Full Changelog: https://github.com/cunla/fakeredis-py/compare/v2.23.5...v2.24.0

Open source →

2.23.53 Aug 20243 sources agree

fix:issue with async connection and blocking operations writing responses twice to socket #316

🐛 Bug Fixes

fix:issue with async connection and blocking operations writing responses twice to socket #316

Full Changelog: https://github.com/cunla/fakeredis-py/compare/v2.23.4...v2.23.5

Open source →

2.23.430 Jul 20243 sources agree

fix:move random seed to HeavyKeeper to avoid issues #315

🐛 Bug Fixes

fix:move random seed to HeavyKeeper to avoid issues #315

🧰 Maintenance

Documented how to use fakeredis with FastAPI. @ sjjessop #292
Using black for linting python code.

Full Changelog: https://github.com/cunla/fakeredis-py/compare/v2.23.3...v2.23.4

Open source →

2.23.329 Jun 20243 sources agree

docs: Full code for FastAPI integration

🧰 Maintenance

docs: Full code for FastAPI integration (#312)

🐛 Bug Fixes

Fix ttl for empty stream #313

Full Changelog: https://github.com/cunla/fakeredis-py/compare/v2.23.2...v2.23.3

Open source →

2.23.218 May 20243 sources agree

Fix reading multiple streams with blocking #309

🐛 Bug Fixes

Fix reading multiple streams with blocking #309

Full Changelog: https://github.com/cunla/fakeredis-py/compare/v2.23.1...v2.23.2

Open source →

2.23.112 May 20243 sources agree

Fix XREAD behavior when COUNT is not provided but BLOCKING is provided #308

🐛 Bug Fixes

Fix XREAD behavior when COUNT is not provided but BLOCKING is provided #308

Full Changelog: https://github.com/cunla/fakeredis-py/compare/v2.23.0...v2.23.1

Open source →

2.23.07 May 20243 sources agree

Support for TDigest commands: TDIGEST.ADD,TDIGEST.BYRANK,TDIGEST.BYREVRANK,TDIGEST.CDF, TDIGEST.CREATE, TDIGEST.INFO, TDIGEST.MAX, TDIGEST.MERGE, TDIG

🚀 Features

Support for TDigest commands: TDIGEST.ADD,TDIGEST.BYRANK,TDIGEST.BYREVRANK,TDIGEST.CDF, TDIGEST.CREATE, TDIGEST.INFO, TDIGEST.MAX, TDIGEST.MERGE, TDIGEST.MIN, TDIGEST.QUANTILE, TDIGEST.RANK, TDIGEST.RESET, TDIGEST.REVRANK, TDIGEST.TRIMMED_MEAN.

🐛 Bug Fixes

Import Self from typing vs. typing_extension

🧰 Maintenance

Update dependencies
Add redis-py 5.0.4 to tests
Update lupa version constraint #306 @noamkush

Contributors

We'd like to thank all the contributors who supported the work on this release! @noamkush

Full Changelog: https://github.com/cunla/fakeredis-py/compare/v2.22.0...v2.23.0

Open source →

2.22.019 Apr 20243 sources agree

Support for setting LUA version from environment variable FAKEREDIS_LUA_VERSION #287

Changes

🚀 Features

Support for setting LUA version from environment variable FAKEREDIS_LUA_VERSION #287
Support for loading LUA binary modules in fakeredis #304

🐛 Bug Fixes

Fix the type hint for the version parameter in the async client #302
Using LUA 5.1 like real redis #287
fix: FakeRedisMixin.from_url() return type is really Self. @ben-xo #305

@ben-xo

Full Changelog: https://github.com/cunla/fakeredis-py/compare/v2.21.3...v2.22.0

Open source →

2.21.312 Mar 20243 sources agree

Revert behavior of defaulting to share the same server data structure between connections @howamith #303

🐛 Bug Fixes

Revert behavior of defaulting to share the same server data structure between connections @howamith #303
Fix type hint for version #302

Full Changelog: https://github.com/cunla/fakeredis-py/compare/v2.21.2...v2.21.3

Open source →

2.21.210 Mar 2024

Connection params are defaulted to be the same between async and sync connections #290

Changes

🐛 Bug Fixes

Connection params are defaulted to be the same between async and sync connections #290
xinfo_stream raises exception when stream does not exist #296

Full Changelog: https://github.com/cunla/fakeredis-py/compare/v2.21.1...v2.21.2

Open source →

Additional notes2 sources agree

Note: Since connection params are defaulted to be the same between async and sync connections, different FakeRedis connections with the same connection params (or without connection parameters) will share the same server data structure.

🐛 Bug Fixes

Connection params are defaulted to be the same between async and sync connections #297
xinfo_stream raises exception when stream does not exist #296

Open source →

2.21.115 Feb 20243 sources agree

Support for float timeout values #289

🐛 Bug Fixes

Support for float timeout values #289

🧰 Maintenance

Fix django cache documentation #286

Contributors

We'd like to thank all the contributors who worked on this release!

@ldkv

Full Changelog: https://github.com/cunla/fakeredis-py/compare/v2.21.0...v2.21.1

Open source →

2.21.031 Jan 2024

Implement all TOP-K commands (TOPK.INFO, TOPK.LIST, TOPK.RESERVE, TOPK.ADD, TOPK.COUNT, TOPK.QUERY, TOPK.INCRBY) #278

🚀 Features

Implement all TOP-K commands (TOPK.INFO, TOPK.LIST, TOPK.RESERVE, TOPK.ADD, TOPK.COUNT, TOPK.QUERY, TOPK.INCRBY) #278
Implement all cuckoo filter commands #276
Implement all Count-Min Sketch commands #277

🐛 Bug Fixes

Fix XREAD blocking bug #274 #275
EXAT option does not work #279

Full Changelog: https://github.com/cunla/fakeredis-py/compare/v2.20.1...v2.21.0

Open source →

Additional notes2 sources agree

🚀 Features

Implement all TOP-K commands (TOPK.INFO, TOPK.LIST, TOPK.RESERVE, TOPK.ADD, TOPK.COUNT, TOPK.QUERY, TOPK.INCRBY) #278
Implement all cuckoo filter commands #276
Implement all Count-Min Sketch commands #277

🐛 Bug Fixes

Fix XREAD blocking bug #274 #275
EXAT option does not work #279

🧰 Maintenance

Support for redis-py 5.1.0b3
Improve @testtools.run_test_if_redispy_ver
Refactor bloom filter commands implementation to use pyprobables instead of pybloom_live

Open source →

2.20.113 Dec 20233 sources agree

### 🐛 Bug Fixes - Fix XREAD bug #256 ### 🧰 Maintenance - Testing for python 3.12 - Dependencies update Full Changelog: https://github.com/cunla/fakere

🐛 Bug Fixes

Fix XREAD bug #256

🧰 Maintenance

Testing for python 3.12
Dependencies update

Full Changelog: https://github.com/cunla/fakeredis-py/compare/v2.20.0...v2.20.1

Open source →

2.20.021 Oct 2023

Implement COMMAND, COMMAND INFO, COMMAND COUNT

Changes

🚀 Features

Implement BITFIELD (#247)
Implement COMMAND, COMMAND INFO, COMMAND COUNT (#248)

Contributors

We'd like to thank all the contributors who worked on this release!

@fcr--

Full Changelog: https://github.com/cunla/fakeredis-py/compare/v2.19.0...v2.20.0

Open source →

Additional notes2 sources agree

🚀 Features

Implement BITFIELD command #247
Implement COMMAND, COMMAND INFO, COMMAND COUNT #248

Open source →

2.19.025 Sept 20233 sources agree

Implement Bloom filters commands #239

🚀 Features

Implement Bloom filters commands #239

🐛 Bug Fixes

Fix error on blocking XREADGROUP #237

Full Changelog: https://github.com/cunla/fakeredis-py/compare/v2.18.1...v2.19.0

Open source →

2.18.18 Sept 20233 sources agree

Officially for redis-py 5.0.0, redis 7.2

🐛 Bug Fixes

Fix stream type issue #233

🧰 Maintenance

Add mypy hints to everything
Officially for redis-py 5.0.0, redis 7.2

Full Changelog: https://github.com/cunla/fakeredis-py/compare/v2.18.0...v2.18.1

Open source →

2.18.014 Aug 20233 sources agree

Implement PUBSUB NUMPAT #195, SSUBSCRIBE #199, SPUBLISH #198, SUNSUBSCRIBE #200, PUBSUB SHARDCHANNELS #196, PUBSUB SHARDNUMSUB #197

Changes

🚀 Features

Implement PUBSUB NUMPAT #195, SSUBSCRIBE #199, SPUBLISH #198, SUNSUBSCRIBE #200, PUBSUB SHARDCHANNELS #196, PUBSUB SHARDNUMSUB #197

🐛 Bug Fixes

Fix All aio.FakeRedis instances share the same server #218
fix:bug using same server with aioredis (#223)

⬆️ Dependency Updates

chore(deps): bump pypa/gh-action-pypi-publish from 1.8.8 to 1.8.10 (#224)
chore(deps): bump lupa from 1.14.1 to 2.0 (#215)
chore(deps): bump mkdocs-material from 9.1.11 to 9.1.19 (#216)

Full Changelog: https://github.com/cunla/fakeredis-py/compare/v2.17.0...v2.18.0

Open source →

2.17.018 Jul 2023

Implement LPOS #207, LMPOP #184, and BLMPOP #183

Changes

🚀 Features

Implement LPOS #207, LMPOP #184, and BLMPOP #183
Implement ZMPOP #191, BZMPOP #186

🧰 Bug Fixes

Fix incorrect error msg for group not found #210
fix: use same server_key within pipeline when issued watch #213
issue with ZRANGE and ZRANGESTORE with BYLEX #214

Contributors

We'd like to thank all the contributors who worked on this release!

@OlegZv, @sjjessop

Full Changelog: https://github.com/cunla/fakeredis-py/compare/v2.16.0...v2.17.0

Open source →

Additional notes2 sources agree

🚀 Features

Implement LPOS #207, LMPOP #184, and BLMPOP #183
Implement ZMPOP #191, BZMPOP #186

🐛 Bug Fixes

Fix incorrect error msg for the group not found #210
fix: use the same server_key within the pipeline when issued watch #213
issue with ZRANGE and ZRANGESTORE with BYLEX #214

Contributors

We'd like to thank all the contributors who worked on this release!

@OlegZv, @sjjessop

Open source →

2.16.04 Jul 20233 sources agree

Implemented support for JSON.MSET #174, JSON.MERGE #181

Changes

🚀 Features

Implemented support for JSON.MSET #174, JSON.MERGE #181

🧰 Bug Fixes

Add support for version for async FakeRedis #205

🧰 Maintenance

Updated how to test django_rq #204

Full Changelog: https://github.com/cunla/fakeredis-py/compare/v2.15.0...v2.16.0

Open source →

2.15.019 Jun 20233 sources agree

Implemented support for various stream groups commands:

v2.15.0

🚀 Features

Implemented support for various stream groups commands:
- XGROUP CREATE #161, XGROUP DESTROY #164, XGROUP SETID #165, XGROUP DELCONSUMER #162, XGROUP CREATECONSUMER #163, XINFO GROUPS #168, XINFO CONSUMERS #168, XINFO STREAM #169, XREADGROUP #171, XACK #157, XPENDING #170, XCLAIM #159, XAUTOCLAIM #158
Implemented sorted set commands:
- ZRANDMEMBER #192, ZDIFF #187, ZINTER #189, ZUNION #194, ZDIFFSTORE #188, ZINTERCARD #190, ZRANGESTORE #193
Implemented list commands:
- BLMOVE #182,

🧰 Maintenance

Improved documentation.

Full Changelog: https://github.com/cunla/fakeredis-py/compare/v2.14.1...v2.14.2

Open source →

2.14.16 Jun 2023

Fix the requirement for packaging.Version #177

Changes

🧰 Bug Fixes

Fix the requirement for packaging.Version #177

Full Changelog: https://github.com/cunla/fakeredis-py/compare/v2.14.0...v2.14.1

Open source →

Additional notes2 sources agree

🐛 Bug Fixes

Fix requirement for packaging.Version #177

Open source →

2.14.05 Jun 20233 sources agree

### 🚀 Features - Implement HRANDFIELD #156 - Implement JSON.MSET ### 🧰 Maintenance - Improve streams code Full Changelog: https://github.com/cunla/fak

🚀 Features

Implement HRANDFIELD #156
Implement JSON.MSET

🧰 Maintenance

Improve streams code

Full Changelog: https://github.com/cunla/fakeredis-py/compare/v2.13.0...v2.14.0

Open source →

2.13.022 May 2023

Fixed xadd timestamp (fixes #151)

Changes

🚀 Features

Implement XDEL (#153)

🐛 Bug Fixes

Fixed xadd timestamp (fixes #151) (#152)

🧰 Maintenance

Improve test code
Fix reported security issue

Contributors

We'd like to thank all the contributors who worked on this release!

@bomber8013

Full Changelog: https://github.com/cunla/fakeredis-py/compare/v2.12.1...v2.13.0

Open source →

Additional notes2 sources agree

🐛 Bug Fixes

Fixed xadd timestamp (fixes #151) (#152)
Implement XDEL #153

🧰 Maintenance

Improve test code
Fix reported security issue

Open source →

2.12.111 May 2023

Add support for Connection.read_response arguments used in redis-py 4.5.5 and 5.0.0

Changes

Adding state for scan commands (#99)
Add support for Connection.read_response arguments used in redis-py 4.5.5 and 5.0.0

Contributors

We'd like to thank all the contributors who worked on this release!

@matanper

Full Changelog: https://github.com/cunla/fakeredis-py/compare/v2.12.0...v2.12.1

Open source →

Additional notes2 sources agree

🐛 Bug Fixes

Add support for Connection.read_response arguments used in redis-py 4.5.5 and 5.0.0
Adding state for scan commands (#99)

🧰 Maintenance

Improved documentation (added async sample, etc.)
Add redis-py 5.0.0b3 to GitHub workflow

Open source →

2.12.08 May 2023

# Changes ## 🚀 Features - Implement XREAD (#147) Full Changelog: https://github.com/cunla/fakeredis-py/compare/v2.11.2...v2.12.0

Changes

🚀 Features

Implement XREAD (#147)

Full Changelog: https://github.com/cunla/fakeredis-py/compare/v2.11.2...v2.12.0

Open source →

Additional notes2 sources agree

🚀 Features

Implement XREAD #147

Open source →

2.11.229 Apr 20233 sources agree

Unique FakeServer when no connection params are provided

Changes

🐛 Bug Fixes

Unique FakeServer when no connection params are provided (#142)

Full Changelog: https://github.com/cunla/fakeredis-py/compare/v2.11.1...v2.11.2

Open source →

2.11.125 Apr 2023

Minor fixes supporting multiple connections

Changes

Minor fixes supporting multiple connections
Update documentation

Full Changelog: https://github.com/cunla/fakeredis-py/compare/v2.11.0...v2.11.1

Open source →

Additional notes2 sources agree

🧰 Maintenance

Minor fixes supporting multiple connections
Update documentation

Open source →

2.11.022 Apr 20233 sources agree

connection parameters awareness: Creating multiple clients with the same connection parameters will result in the same server data structure.

🚀 Features

connection parameters awareness: Creating multiple clients with the same connection parameters will result in the same server data structure.

🧰 Bug Fixes

Fix creating fakeredis.aioredis using url with user/password (#139)

Contributors

We'd like to thank all the contributors who worked on this release!

@markuspinter

Full Changelog: https://github.com/cunla/fakeredis-py/compare/v2.10.3...v2.11.0

Open source →

2.10.33 Apr 20233 sources agree

Fix import used in GenericCommandsMixin.randomkey

Changes

🧰 Maintenance

Support for redis-py 5.0.0b1
Include tests in sdist (#133)

🐛 Bug Fixes

Fix import used in GenericCommandsMixin.randomkey (#135)

Contributors

We'd like to thank all the contributors who worked on this release!

@cunla, @mgorny and @mudetz

Full Changelog: https://github.com/cunla/fakeredis-py/compare/v2.10.2...v2.10.3

Open source →

Your coding agent can read these notes before it upgrades. Set up the MCP server →