Add option for total maximum number of retries across the entire test suite

[kfot]

Currently, pytest-rerunfailures allows specifying the maximum number of retries per failed test via the --reruns option. However, there is no built-in way to limit the total number of retries across the entire test suite as a whole.

Please consider adding a new option (e.g., --max-suite-retries) that would allow users to specify the maximum number of times failed tests can be retried collectively during the suite run, regardless of how many tests fail or pass. This would help limit resource usage and avoid excessive retries in large test suites.

Example:
If --max-suite-retries=5 is set, and multiple tests fail, retries will stop after a total of 5 retries have been attempted across all failing tests.

[icemac]

This is the first time this feature request shows up. Until someone will implement it, --maxfail might be an approximation for the fetature requested.