Metadata-Version: 2.5
Name: tracera-robot
Version: 1.1.1
Summary: Tracera Autotest adapter for Robot Framework
Project-URL: Homepage, https://tracera.dev/docs/robot
Project-URL: Changelog, https://github.com/tracera-dev/tracera-releases/releases?q=Adapters+%28Python%29
Project-URL: Bug-Tracker, https://github.com/tracera-dev/tracera-releases/issues
Author-email: Tracera <contact@tracera.dev>
License-Expression: Apache-2.0
License-File: LICENSE.md
Keywords: autotest,robotframework,test-reporting,testops,tracera
Classifier: Development Status :: 5 - Production/Stable
Classifier: Framework :: Robot Framework
Classifier: Framework :: Robot Framework :: Library
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Classifier: Topic :: Software Development :: Testing
Requires-Python: >=3.11
Requires-Dist: tracera-core==1.1.1
Description-Content-Type: text/markdown

# tracera-robot

Tracera Autotest adapter for Robot Framework (listener).

**Requires Python ≥ 3.11 and Robot Framework ≥ 7.**

```bash
pip install tracera-robot
```

How-to: [Robot Framework](https://tracera.dev/docs/robot). Shared env / run mode: [Autotest adapters](https://tracera.dev/docs/adapters).

## Setup

```bash
robot --listener tracera_robot.listener.TraceraListener suite.robot
```

Optional companion library for comment / error / attachment / explicit step:

```robot
*** Settings ***
Library    tracera_robot.keywords.TraceraKeywords
```

## Bind

Tags `tracera.id:…` / optional literal `tracera.name:…`. If `tracera.name` is omitted → Robot test name. Tags do not support `{param}` templates. Imperative `Tracera Test Case` via the companion library is also available.

## Skip

Stock Robot `Skip`. The reason becomes a result `comment`.

## Steps

User and library keywords → **Test** steps (nesting follows keyword calls). FOR / IF / WHILE / TRY are reported. **Test** Setup / Teardown → **Setup** / **Teardown**; Suite Setup / Teardown are not reported.

By default the step title is the keyword name. For a different title, use the companion library keyword `Tracera Step` (custom title, then the keyword to run). Python helpers can also use `tracera.step` or `@tracera.step("…")` from core.

## Comments, errors, and attachments

Use `TraceraKeywords` (`Tracera Comment`, `Tracera Error`, `Tracera Attachment`) — see [Autotest adapters](https://tracera.dev/docs/adapters).

## Parameterized

Stock `[Template]` — same `tracera.id` for every argument line under the template. Different id per row → one Robot test per row.

**Pabot:** workers share one run automatically — nothing extra to set.
