deis-tools/distributedexercisesaau

distributedexercisesaau's Issues

GUI for stepping

Make a GUI overlay in tkinter that displays the current state of the simulator and allows for interaction with the simulator via #21

Unit-test / exercise test framework

Extend the framework with the ability to replay concrete execution-sequences as to provoke errors in implementation and allow for self-evaluation by the users.

Stepping in Simulation

Implement a new Emulator that supports stepping by keyboard interaction.

Backtrace when not using the stepping emulator

python is version 3.10 on my system.

Using the command

python exercise_runner.py --lecture 0 --algorithm PingPong --type async --devices 3

Gives the following backtrace:

Traceback (most recent call last):
  File "/home/mads/GitHub/DistributedExercisesAAU/exercise_runner.py", line 100, in <module>
    run_exercise(args.lecture[0], args.algorithm[0], args.type[0], args.devices[0], False)
  File "/home/mads/GitHub/DistributedExercisesAAU/exercise_runner.py", line 79, in run_exercise
    instance.shell.start()
    ^^^^^^^^^^^^^^
AttributeError: 'AsyncEmulator' object has no attribute 'shell'

It seems that only the SteppingEmulator has this attribute.

It seems to run anyway, though.

Extending Stepper

The "Stepper" needs to be extended with a few extra commands.

• A show command that displays all messages currently in transit (with an index in the list)
• A pick command that allows the user to pick a specific message in transit to deliver next
• An extension of the current step, fast-forward and skip-to-end commands s.t. these can be done as either sync or Async

Wrt. the last task, a sufficient solution is for the user to pick the specific mode initially (i.e. prompt the user) and then fix the default behavior throughout the execution.
However, it is important that the pick and show commands allow for modifying the order of message delivery.

Extend Readme

Currently the README lacks mentions of the stepper and packages needed to run the scripts.

The README should be extended with a "setup"-section.

lines and text between devices

A suggested addition to the framework from the presentation was to have arrows between nodes in the distributed network with the message written next to it