Skip to content
Branch: master
Find file Copy path
Find file Copy path
Fetching contributors…
Cannot retrieve contributors at this time
39 lines (29 sloc) 1.21 KB


Pykka actors can be tested using the regular Python testing tools like pytest, :mod:`unittest`, and :mod:`unittest.mock`.

To test actors in a setting as close to production as possible, a typical pattern is the following:

  1. In the test setup, start an actor together with any actors/collaborators it depends on. The dependencies will often be replaced by mocks to control their behavior.
  2. In the test, :meth:`~pykka.ActorRef.ask` or :meth:`~pykka.ActorRef.tell` the actor something.
  3. In the test, assert on the actor's state or the return value from the :meth:`~pykka.ActorRef.ask`.
  4. In the test teardown, stop the actor to properly clean up before the next test.

An example

Let's look at an example actor that we want to test:

.. literalinclude:: ../examples/

We can test this actor with pytest by mocking the consumer and asserting that it receives a newly produced item:

.. literalinclude:: ../examples/

If this way of setting up and tearing down test resources is unfamiliar to you, it is strongly recommended to read up on pytest's great fixture feature.

You can’t perform that action at this time.