Screenshot

At any point during or after program execution, you can take a screenshot of what appears on its virtual terminal.

favoritecolor.py:

import sys

answer = input("favorite color:")

sys.stdout.write(answer.upper())
sys.stdout.flush()

With code:

from icommandlib import ICommand, IProcessTimeout
from commandlib import python

process = ICommand(python("favoritecolor.py")).run()
process.wait_until_output_contains("favorite color:")
process.send_keys("red\n")

process.wait_until_output_contains("RED")

Taking a screenshot

with open("screenshot-before-finish.txt", "w") as handle:
    handle.write(process.screenshot())

process.wait_for_finish()

with open("stripshot-after-finish.txt", "w") as handle:
    handle.write(process.stripshot())

• When the code is run to completion.

The file contents of screenshot-before-finish.txt will then be:

favorite color:red
RED

The file contents of stripshot-after-finish.txt will then be:

favorite color:red
RED

Waiting for stripshot to match string and succeeding

process.wait_for_stripshot_to_match("favorite color:red\nRED")
process.wait_for_finish()

• When the code is run to completion.

Waiting for stripshot to match string and failing

With code:

from icommandlib import ICommand, IProcessTimeout
from commandlib import python

process = ICommand(python("favoritecolor.py")).run()
process.wait_until_output_contains("favorite color:")

try:
    process.wait_for_stripshot_to_match("notthis", timeout=0.1)
except IProcessTimeout as error:
    with open("timeout-stripshot.txt", "w") as handle:
        handle.write("Did not match. This was the output instead:\n")
        handle.write(error.stripshot)

• When the code is run to completion.

The file contents of timeout-stripshot.txt will then be:

Did not match. This was the output instead:
favorite color:

Executable specification

Documentation automatically generated from screenshot.story storytests.