fakenewredis: A fake version of a redis-py

fakenewsredis is a fork of fakeredis, a pure-Python implementation of the redis-py python client that simulates talking to a redis server. It was forked because pull requests for fakeredis were languishing without being merged or getting feedback.

fakeredis was created for a single purpose: to write unittests. Setting up redis is not hard, but many times you want to write unittests that do not talk to an external server (such as redis). This module now allows tests to simply use this module as a reasonable substitute for redis.

How to Use

The intent is for fakenewsredis to act as though you're talking to a real redis server. It does this by storing state in the fakenewsredis module. For example:

>>> import fakenewsredis
>>> r = fakenewsredis.FakeStrictRedis()
>>> r.set('foo', 'bar')
True
>>> r.get('foo')
'bar'
>>> r.lpush('bar', 1)
1
>>> r.lpush('bar', 2)
2
>>> r.lrange('bar', 0, -1)
[2, 1]

By storing state in the fakenewsredis module, instances can share data:

>>> import fakenewsredis
>>> r1 = fakenewsredis.FakeStrictRedis()
>>> r1.set('foo', 'bar')
True
>>> r2 = fakenewsredis.FakeStrictRedis()
>>> r2.get('foo')
'bar'
>>> r2.set('bar', 'baz')
True
>>> r1.get('bar')
'baz'
>>> r2.get('bar')
'baz'

Because fakenewsredis stores state at the module level, if you want to ensure that you have a clean slate for every unit test you run, be sure to call r.flushall() in your tearDown method. For example:

def setUp(self):
    # Setup fake redis for testing.
    self.r = fakenewsredis.FakeStrictRedis()

def tearDown(self):
    # Clear data in fakenewsredis.
    self.r.flushall()

Fakenewsredis implements the same interface as redis-py, the popular redis client for python, and models the responses of redis 2.6.

Unimplemented Commands

All of the redis commands are implemented in fakenewsredis with these exceptions:

sorted_set

• zscan

hash

• hstrlen

string

• bitop
• bitpos

geo

• geoadd
• geopos
• georadius
• geohash
• georadiusbymember
• geodist

generic

• restore
• dump
• migrate
• object
• wait

server

• client list
• lastsave
• slowlog
• debug object
• shutdown
• debug segfault
• command count
• monitor
• client kill
• cluster slots
• role
• config resetstat
• time
• config get
• config set
• save
• client setname
• command getkeys
• config rewrite
• sync
• client getname
• bgrewriteaof
• slaveof
• info
• client pause
• bgsave
• command
• dbsize
• command info

cluster

• cluster getkeysinslot
• cluster info
• readwrite
• cluster slots
• cluster keyslot
• cluster addslots
• readonly
• cluster saveconfig
• cluster forget
• cluster meet
• cluster slaves
• cluster nodes
• cluster countkeysinslot
• cluster setslot
• cluster count-failure-reports
• cluster reset
• cluster failover
• cluster set-config-epoch
• cluster delslots
• cluster replicate

connection

• echo
• select
• quit
• auth

scripting

• script flush
• script kill
• script load
• evalsha
• eval
• script exists

Contributing

Contributions are welcome. Please see the contributing guide for more details.

If you'd like to help out, you can start with any of the issues labeled with HelpWanted.

Running the Tests

To ensure parity with the real redis, there are a set of integration tests that mirror the unittests. For every unittest that is written, the same test is run against a real redis instance using a real redis-py client instance. In order to run these tests you must have a redis server running on localhost, port 6379 (the default settings). The integration tests use db=10 in order to minimize collisions with an existing redis instance.

To run all the tests, install the requirements file:

pip install -r requirements.txt

If you just want to run the unittests:

nosetests test_fakenewsredis.py:TestFakeStrictRedis test_fakenewsredis.py:TestFakeRedis

Because this module is attempting to provide the same interface as redis-py, the python bindings to redis, a reasonable way to test this to to take each unittest and run it against a real redis server. fakenewsredis and the real redis server should give the same result. This ensures parity between the two. You can run these "integration" tests like this:

nosetests test_fakenewsredis.py:TestRealStrictRedis test_fakenewsredis.py:TestRealRedis

In terms of implementation, TestRealRedis is a subclass of TestFakeRedis that overrides a factory method to create an instance of redis.Redis (an actual python client for redis) instead of fakenewsredis.FakeStrictRedis.

To run both the unittests and the "integration" tests, run:

nosetests

If redis is not running and you try to run tests against a real redis server, these tests will have a result of 'S' for skipped.

There are some tests that test redis blocking operations that are somewhat slow. If you want to skip these tests during day to day development, they have all been tagged as 'slow' so you can skip them by running:

nosetests -a '!slow'