Add a decorator for flaky tests
# What does this PR do?

This PR adds a new decorator to mark flaky tests, which will then automatically re-run them up to five times each time they fail (that param can be adapted). I've marked as flaky three tests I have seen recently fail for no reason as a demo.
_The documentation is not available anymore as the PR was closed or merged._