How to get actual image if the expected image was not found

import shutil
shot = capture(SCREEN)
shutil.move(shot, "absolute-path-of-image.png")

the target directory must exist.

to pack this in test:

res = exists(Pattern(img).similar(0.8))
if not res:
    import shutil
    shot = capture(SCREEN)
    shutil.move(shot, "absolute-path-of-image.png")
assert(res)

Thank you RaiMan.

I suppose that "exists(Pattern(img).similar(0.8))" take a screen shot a compare the given image with the screen shot.

My question is:

The image returned by capture(SCREEN) and the one used in "exists" are the same ?

To be sure, take your shot before using exists() (max 3 seconds difference).
If your screen is static during this time: Yes, same image.

If this is really critical for you and you are familiar with Java programming, you might add some Java code, to access the last taken screen shot, which is stored with the relevant region as a buffered image.

Not really clear, saying: To be sure, take your shot before using exists() (max 3 seconds difference).

When searching the whole screen, you have about one screenshot per second (might be more with smaller regions (up to 3-5 per second)).

So it depends on your intention: need the shot before or/and after the completion of the find operation (which might fail)?