Caution

This page documents the latest, unreleased version of Buildbot. For documentation for released versions, see https://docs.buildbot.net/current/.

2.5.25.2. TestReactorMixin

class buildbot.test.reactor.TestReactorMixin

The class TestReactorMixin is used to create a fake twisted.internet.reactor in tests. This allows to mock the flow of time in tests. The fake reactor becomes available as self.reactor in the test case that mixes in TestReactorMixin.

Call self.reactor.advance(seconds) to advance the mocked time by the specified number of seconds.

Call self.reactor.pump(seconds_list) to advance the mocked time multiple times as if by calling advance.

For more information see the documentation of twisted.internet.task.Clock.

setup_test_reactor(use_asyncio=False, auto_tear_down=True)
Parameters:
  • use_asyncio (bool) – Whether to enable asyncio integration. This option has been deprecated and has no effect.

  • auto_tear_down (bool) – Whether to automatically tear down the test reactor. Setting it to False is deprecated.

Call this function in the setUp() of the test case to setup fake reactor.

tear_down_test_reactor()

Call this function in the tearDown() of the test case to tear down fake reactor. This function is deprecated. The function returns a Deferred.