Skip to main content

Writing Tests

DevAssure allows you to define UI test scenarios using simple, plain-language steps.

You can create tests in either:

  • YAML format (recommended for structured test suites)
  • CSV format (ideal for bulk imports from tools like Jira or TestRail)

All test files live inside the .devassure/tests/ directory.

YAML Test Cases​

Add .yaml or .yml files under .devassure/tests/.

The summary and steps fields are required; priority and tags are optional.

summary: Verify app loads without errors
steps:
  - Open the application url
  - Verify if the page loads successfully
  - Verify if there are no error messages
priority: P0
tags:
  - sanity
  - app-load

Adding tests from the sidebar:

In the Tests view, right-click the tests root or any subfolder:

  • Add Folder — creates a new subfolder (e.g., my-suite)
  • Add Test Case — prompts for a name, creates a new YAML file with placeholder content, and opens it in the editor

CSV Test Cases​

You can run tests directly from a CSV file without writing YAML.

  1. Place the CSV file under .devassure/tests/ (or .devassure/).
  2. Configure column mappings in .devassure/csv_mapping.yaml if your headers differ from the defaults.
  3. Run from the Tests view or via CodeLens in the editor.

If your CSV uses custom headers (for example, Title instead of Summary), ensure they are mapped correctly in csv_mapping.yaml.