2.0. Managing Test Suites

In Ptero, a Test Suite is the primary unit for executing tests.
It stores the configuration—including scenarios, run modes, and test data—that is applied whenever a run is triggered.

Test Suite types #

The available test suite types depend on your project type.

Project type	Available types
Mobile App	Autonomous Test Suite, Scenario Test Suite
D2D Mobile App	Scenario Test Suite only

Test Suite list #

The Test Suites tab displays all Test Suites within your project.

Column	Description
ID	The unique identifier for the test suite
Test Suite	The name of the test suite
# of Scenarios	The number of registered scenarios. Hover over the preview icon to see their names.
Test Type	Autonomous or Scenario
Run Mode	The execution method for the Test Suite
Created Date	The date the Test Suite was created

Creating a Test Suite #

1. Go to the Test Suites tab in your project.
2. Click Create New Test Suite.
3. Select the Test Suite type.

The new Test Suite will appear in the list.

Configuring a Scenario Test Suite #

Scenarios #

Click + Add Scenarios to select scenarios from the Scenario Repository.
To ensure Test Suites remain manageable and effective, we recommend organizing scenarios by feature or testing objective.

In the Add Scenarios popup:

1. Select the folder containing your target scenarios.
2. Check the boxes next to the scenarios you want to include.
3. Click Add.

For more details, see Scenario Repository Management.

Run mode #

Choose how the scenarios will run.

Mode	What it does	Available in
Parallel	Runs scenarios simultaneously for faster execution. Ideal when tests are independent and do not share states or accounts.	Mobile App, D2D
Sequential	Runs scenarios one after another. Best for tests that require a specific execution order or share a login account.	Mobile App, D2D
Combined Sequential	Merges all scenarios into a single continuous flow and saves them as one consolidated result.	Mobile App only
Synchronized	Executes scenarios across multiple devices at the exact same time. Designed for real-time interaction tests, such as chat or voice calls.	D2D only

Test data #

User Variables #

Set up reusable key-value pairs that scenarios can reference during execution.

Field	Description
Key	The variable name
Value	The value applied at runtime

Data Set #

Upload a CSV file to manage large sets of User Variables simultaneously.

After uploading the dataset, preview the file to confirm all values loaded correctly.

To learn more, see Working with Input Data.
Verify how variables and data sets were applied in the test results — see Reviewing Test Results.

Device Settings (D2D only) #

Specify the devices that will participate in the D2D run.

• Device Roles configured in Stego will automatically appear here.
• Each selected device displays its specific model and OS version (e.g., iPhone 12 / iOS 15.1).

Note:
Make sure to configure Device Roles in Stego before adding scenarios to a D2D Test Suite.
For guidance, see Scenario Settings.

Autonomous Test Suite (Mobile App only) #

An Autonomous Test Suite allows the AI to automatically navigate and explore the app without requiring predefined scenarios.

A default Autonomous Test Suite is automatically generated when you create a Mobile App project;
you can also create additional suites as needed.

Setting up an Autonomous Test Suite #

Test Suite Name: Enter a descriptive name for the Test Suite.

Credential Info: Define login credentials. The AI will automatically apply these when it encounters a login screen.

Field	Description
Login ID	The account ID used during testing
Password	The corresponding password for the account

User Variables: Provide key-value pairs that the AI can intuitively use during the app exploration phase.

Field	Description
Key	The variable name
Value	The variable value

To learn more, see Working with Input Data.

Copying, editing, and deleting Test Suites #

Click the ︙ (More Options) icon next to a Test Suite to view the following options:

• Copy:
  Duplicates the Test Suite.
  The duplicate is named automatically in the format [Original Name] Copy [Number] (e.g., test → test Copy 1).
• Edit: Opens the Test Suite configuration page to allow modifications.
• Delete: Permanently removes the Test Suite from the project.

Note:
Once deleted, a Test Suite cannot be restored.

Deleting multiple Test Suites at once #

1. Select the checkboxes next to the Test Suites you wish to remove.
2. Click the Delete button in the upper-right corner.

Note:
Once deleted, Test Suites cannot be restored.