feat: Added a decorator function, which will be used to test explicit examples

[Sai-Suraj-27]

PR Description

Added a decorator function, which will be used to test explicit examples that are difficult/not feasible to define as strategies.
The decorator is also generalized so that we can test all 4 ivy tests, frontend tests, methods, frontend methods with explicit examples.

Related Issue

Closes #28207

Checklist

• Did you add a function?
• Did you add the tests?
• Did you run your tests and are your tests passing?
• Did pre-commit not fail on any check?
• Did you follow the steps we provided?

Socials

[vedpatwardhan]

Hey @Sai-Suraj-27, could you please test this out for frontend tests and methods as well? Probably just add the decorator to a function from those categories temporarily as well so that we can confirm in the CI if that example ran correctly?
The changes look great to me otherwise, thanks for looking into this 😄

[Sai-Suraj-27]

Hey @Sai-Suraj-27, could you please test this out for frontend tests and methods as well? Probably just add the decorator to a function from those categories temporarily as well so that we can confirm in the CI if that example ran correctly? The changes look great to me otherwise, thanks for looking into this 😄

Hey, @vedpatwardhan. I actually did that already, but didn't committed those changes. Sure, I will add few more example decorators and the documentation part👍🏻.

[Sai-Suraj-27]

Hey, @vedpatwardhan. In the CI, I see that the following 2 tests are mentioned as passing in main (main: pass) but failing after these changes.

1. https://github.com/unifyai/ivy/actions/runs/7884526822/job/21515049892?pr=28251#step:6:34
2. https://github.com/unifyai/ivy/actions/runs/7884526822/job/21515049892?pr=28251#step:6:127

But when I tested locally, the first 2nd one is passing all the backends successfully.

The first one is already failing on main (present here as currently one of the failing tests). So, I'm not sure, why they are shown in the CI. Just thought of clarifying. Thank you.

[vedpatwardhan]

lgtm! Feel free to revert the changes with the dummy handle_example and merge the PR (the 2 test failures that are passing on main seem unrelated to the changes made)
Thanks @Sai-Suraj-27 😄