tir-test-generator

Generate Python unittest TIR Webapp UI test scripts for Protheus screens.

115|54|Updated May 25, 2026
One-click install
npx skills add https://github.com/totvs/engpro-advpl-tlpp-skills --skill tir-test-generator
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: tir-test-generator
Source: https://github.com/totvs/engpro-advpl-tlpp-skills/tree/main/skills/advpl-tlpp/tir-test-generator
Command: npx skills add https://github.com/totvs/engpro-advpl-tlpp-skills --skill tir-test-generator

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill removes the guesswork and boilerplate involved in creating end-to-end UI automation tests for Protheus SmartClient/Webapp screens.

Core Features & Use Cases

  • Protheus TIR Webapp test generation: Produces Python unittest scripts using tir.Webapp for full interface workflows.
  • Screen interaction coverage: Supports routine navigation, field input, button clicks, grid operations, tab/folder handling, and report parameter screens.
  • Validation & guardrails: Includes patterns for assertions (CheckResult, CheckHelp) and the required config.json setup to connect to a running Protheus environment.

Example: You want to regression-test a critical MVC screen’s CRUD journey (Include → Save → Visualize → Validate fields → Delete) automatically in a CI pipeline.

Quick Start

Ask the agent to generate a TIR Webapp end-to-end test project in Python for your Protheus routine, including the required TESTCASE/TESTSUITE files and a ready-to-fill config.json.

Frequently Asked Questions about tir-test-generator

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I generate Python unittest E2E tests for Protheus SmartClient screens?

You generate Python unittest E2E tests for Protheus SmartClient screens by creating scripts using the TIR framework and tir.Webapp automation to handle routine navigation, field input, and button clicks across the interface.

Can I automate grid operations and MVC browse interactions in a Protheus TIR test?

Yes, you can automate grid operations and MVC browse interactions in a Protheus TIR test. The generated unittest scripts support advanced screen scenarios including legacy browse interactions, grid validations, and tab/folder handling.

What files are required to set up a TIR Webapp automation project for Protheus?

A TIR Webapp automation project requires a three-file architecture: a ROUTINETESTCASE.py for individual tests, a ROUTINETESTSUITE.py to group them, and a config.json to connect to the running Protheus environment.

How do I validate field inputs and assert error messages in a Protheus TIR test script?

To validate field inputs and assert error messages in a Protheus TIR test script, you apply built-in assertion patterns like CheckResult and CheckHelp to verify message and help outputs during UI automation workflows.

Does the TIR framework support automating Protheus report parameter screens?

Yes, the TIR framework supports automating Protheus report parameter screens. Generated Python unittest scripts can interact with report parameters, apply validation assertions, and execute full CRUD workflows within the Webapp interface.

Why should I use consistent browse keys and button labels in Protheus TIR E2E tests?

You should use consistent browse keys and button labels in Protheus TIR E2E tests to ensure reliable Webapp automation. Correct Setup/Program flow and consistent naming are required guardrails for accurate UI element targeting.