..  Titling
    ##++::==~~--''``

The simulator
:::::::::::::

At the heart of Turberfield is a simulator. It keeps the world ticking along.
It looks for messages which are due for attention and dispatches them to where
they are to be handled.

The main job of the simulator is to run tasks. These tasks are supplied by you.

.. automodule:: turberfield.dynamics.simulation

Job Queue
=========

.. autoclass:: turberfield.dynamics.jobqueue.JobQueue
   :members: put

Ticks
=====

.. autoclass:: turberfield.dynamics.types.Tick

.. autoclass:: turberfield.dynamics.types.Stop

Messages
========

You can send any objects you like to the job queue. To define how they
are processed when their time arrives, you should register a handler according
to their type.

.. autofunction:: turberfield.dynamics.simulation.message_handler

Simulation
==========

.. autoclass:: turberfield.dynamics.simulation.Simulation
   :members: ticks, task, dispatch