limit option

[le91688]

Title: Implement a --limit Argument for Device Testing

Description:

To facilitate testing on a limited number of devices (e.g., two Android 7 devices across all STF providers), we need to implement a --limit argument that restricts the number of results returned. For instance, --limit 2 would return just two results.

This allows developers to run tests on a smaller subset of devices without altering the query or other settings. This is especially valuable in situations where testing on all available devices isn't necessary or optimal. Manually adjusting the query parameters or settings each time is not scalable and can be prone to errors.

Tasks:

1. Update the command-line argument parsing to accommodate a new --limit argument.
2. Update the logic that returns results to consider the --limit argument.
3. Validate and test the new argument in various scenarios.
4. Update the documentation to include the new --limit argument.

Acceptance Criteria:

• The command-line argument parsing supports the --limit argument.
• The result returning logic accounts for the --limit argument.
• The --limit argument is validated and tested in different scenarios.
• The documentation reflects the new --limit argument.