qa-skills 3.0.0

package/skills/qa-robot-framework-writer/references/config.md

@@ -0,0 +1,204 @@
+# Robot Framework Configuration
+
+## CLI Options
+
+### Basic Execution
+
+```bash
+robot tests/                          # Run all tests in tests/
+robot login.robot                     # Run single file
+robot tests/login.robot tests/api/    # Run specific files/dirs
+```
+
+### Output and Reports
+
+| Option | Description | Example |
+| ------ | ----------- | ------- |
+| `-d DIR` | Output directory | `-d results` |
+| `-o FILE` | Output XML file | `-o output.xml` |
+| `-l FILE` | Log file (HTML) | `-l log.html` |
+| `-r FILE` | Report file (HTML) | `-r report.html` |
+| `-N NAME` | Set suite name | `-N "Smoke Tests"` |
+
+```bash
+robot -d results -l results/log.html -r results/report.html tests/
+```
+
+### Variables
+
+| Option | Description | Example |
+| ------ | ----------- | ------- |
+| `-v VAR:value` | Set scalar variable | `-v BROWSER:chrome` |
+| `-v VAR:value1;value2` | Set list variable | `-v USERS:user1;user2` |
+| `-V FILE` | Variable file (Python/YAML) | `-V config/env.py` |
+| `--variablefile FILE` | Legacy variable file | `--variablefile env.py` |
+
+```bash
+robot -v BROWSER:headlesschrome -v BASE_URL:https://staging.example.com -V config/prod.py tests/
+```
+
+### Test Selection
+
+| Option | Description | Example |
+| ------ | ----------- | ------- |
+| `-t "Test Name"` | Run specific test | `-t "User Can Log In"` |
+| `-i TAG` | Include tests with tag | `-i smoke` |
+| `-e TAG` | Exclude tests with tag | `-e slow` |
+| `--include TAG*` | Include (supports patterns) | `--include smoke*` |
+| `--exclude TAG*` | Exclude (supports patterns) | `--exclude skip` |
+
+```bash
+robot -i smoke --exclude slow -d results tests/
+```
+
+### Execution Control
+
+| Option | Description | Example |
+| ------ | ----------- | ------- |
+| `--loglevel LEVEL` | Log level (TRACE, DEBUG, INFO, WARN) | `--loglevel DEBUG` |
+| `--randomize all` | Randomize test order | `--randomize all` |
+| `--rerunfailed FILE` | Re-run failed tests from output | `--rerunfailed output.xml` |
+| `--dryrun` | Validate without executing | `--dryrun` |
+| `--test "Name"` | Run single test | `--test "Login Test"` |
+| `--suite "Suite"` | Run single suite | `--suite "Login"` |
+
+### Parallel Execution (pabot)
+
+For parallel runs, use `pabot` (parallel Robot Framework):
+
+```bash
+pip install robotframework-pabot
+pabot --processes 4 -d results tests/
+```
+
+---
+
+## Variable Files
+
+### Python Variable File
+
+**config/env.py:**
+```python
+def get_variables(env=None):
+    return {
+        'BROWSER': 'chrome',
+        'BASE_URL': 'https://example.com',
+        'HEADLESS': env == 'ci',
+    }
+```
+
+Dynamic variables based on environment:
+
+```python
+import os
+
+def get_variables():
+    return {
+        'BASE_URL': os.getenv('BASE_URL', 'https://default.example.com'),
+        'API_KEY': os.getenv('API_KEY', ''),
+    }
+```
+
+### YAML Variable File
+
+**config/default.yaml:**
+```yaml
+BROWSER: chrome
+BASE_URL: https://example.com
+USERS:
+  - user1
+  - user2
+```
+
+### JSON Variable File (RF 6.0+)
+
+**config/default.json:**
+```json
+{
+  "BROWSER": "chrome",
+  "BASE_URL": "https://example.com"
+}
+```
+
+---
+
+## robot.yaml / pyproject.toml
+
+Robot Framework 6.0+ supports `robot.yaml` for configuration:
+
+**robot.yaml:**
+```yaml
+default:
+  outputDir: results
+  log: results/log.html
+  report: results/report.html
+  variableFiles:
+    - config/env.yaml
+  variables:
+    BROWSER: chrome
+  include:
+    - smoke
+  exclude:
+    - skip
+```
+
+Or in **pyproject.toml** under `[tool.robotframework]`:
+
+```toml
+[tool.robotframework]
+outputDir = "results"
+log = "results/log.html"
+report = "results/report.html"
+variableFiles = ["config/env.yaml"]
+```
+
+---
+
+## Listeners
+
+Custom listeners for hooks (start/end suite, test, keyword):
+
+**listeners/custom_listener.py:**
+```python
+class CustomListener:
+    ROBOT_LISTENER_API_VERSION = 3
+
+    def start_test(self, data, test):
+        print(f"Starting: {test.name}")
+
+    def end_test(self, data, test):
+        print(f"Ended: {test.name} - {test.status}")
+```
+
+Usage: `robot --listener listeners/custom_listener.py tests/`
+
+---
+
+## Resource and Library Paths
+
+- **Resource imports** — Relative to the file containing the import
+- **PYTHONPATH** — For Python libraries; set before running: `export PYTHONPATH=libs:$PYTHONPATH`
+- **--pythonpath** — Add path: `robot --pythonpath libs tests/`
+
+---
+
+## Recommended Project Layout
+
+```
+project/
+├── tests/
+│   ├── login.robot
+│   ├── checkout.robot
+│   └── api/
+│       └── users.robot
+├── resources/
+│   ├── common.robot
+│   ├── login_keywords.robot
+│   └── api_keywords.robot
+├── variables/
+│   ├── env.yaml
+│   └── prod.py
+├── results/           # -d results
+├── robot.yaml         # Optional config
+└── requirements.txt
+```

package/skills/qa-robot-framework-writer/references/libraries.md

@@ -0,0 +1,273 @@
+# Robot Framework Libraries Reference
+
+## SeleniumLibrary
+
+Browser automation via Selenium WebDriver. Install: `pip install robotframework-seleniumlibrary`
+
+### Setup/Teardown
+
+| Keyword | Description |
+| ------- | ----------- |
+| `Open Browser` | Open browser; args: url, browser (chrome, firefox, etc.) |
+| `Close Browser` | Close current browser |
+| `Close All Browsers` | Close all open browsers |
+
+### Navigation
+
+| Keyword | Description |
+| ------- | ----------- |
+| `Go To` | Navigate to URL |
+| `Go Back` | Browser back |
+| `Reload Page` | Reload current page |
+| `Get Location` | Get current URL |
+| `Get Title` | Get page title |
+
+### Element Interaction
+
+| Keyword | Description |
+| ------- | ----------- |
+| `Click Element` | Click element by locator |
+| `Click Button` | Click button |
+| `Input Text` | Type text into input |
+| `Input Password` | Type password (masked in logs) |
+| `Clear Element Text` | Clear input field |
+| `Select From List By Value` | Select dropdown option by value |
+| `Select Checkbox` / `Unselect Checkbox` | Toggle checkbox |
+| `Choose File` | Upload file |
+
+### Waits
+
+| Keyword | Description |
+| ------- | ----------- |
+| `Wait Until Element Is Visible` | Wait for element |
+| `Wait Until Page Contains` | Wait for text |
+| `Wait Until Location Contains` | Wait for URL |
+| `Set Selenium Implicit Wait` | Set default wait timeout |
+
+### Assertions
+
+| Keyword | Description |
+| ------- | ----------- |
+| `Element Should Be Visible` | Assert element visible |
+| `Page Should Contain` | Assert text on page |
+| `Title Should Be` | Assert page title |
+| `Location Should Be` | Assert URL |
+| `Element Should Be Enabled` | Assert element enabled |
+
+### Locators
+
+- `id=element_id`
+- `css=div.class`
+- `xpath=//button[@type='submit']`
+- `name=fieldname`
+- `link=Click here`
+
+---
+
+## BrowserLibrary
+
+Playwright-based browser automation. Install: `pip install robotframework-browser`
+
+### Setup/Teardown
+
+| Keyword | Description |
+| ------- | ----------- |
+| `New Browser` | Create browser; args: browser (chromium, firefox, webkit), headless |
+| `New Page` | Open new page/tab |
+| `Close Browser` | Close browser |
+| `Close Context` | Close browser context |
+
+### Navigation
+
+| Keyword | Description |
+| ------- | ----------- |
+| `Go To` | Navigate to URL |
+| `Get Url` | Get current URL |
+| `Get Title` | Get page title |
+
+### Element Interaction
+
+| Keyword | Description |
+| ------- | ----------- |
+| `Click` | Click element (selector) |
+| `Fill Text` | Fill text input |
+| `Type Text` | Type with optional delay |
+| `Check` / `Uncheck` | Toggle checkbox |
+| `Select Options By` | Select dropdown |
+| `Upload File By Selector` | Upload file |
+
+### Assertions
+
+| Keyword | Description |
+| ------- | ----------- |
+| `Get Text` | Get element text |
+| `Get Property` | Get element property |
+| `Get Attribute` | Get element attribute |
+| `Wait For Elements State` | Wait for element state (visible, hidden, etc.) |
+
+### Selectors
+
+- `text=Exact text`
+- `css=button.primary`
+- `id=element-id`
+- `role=button[name="Submit"]`
+
+---
+
+## RequestsLibrary
+
+API testing. Install: `pip install robotframework-requests`
+
+### Session Management
+
+| Keyword | Description |
+| ------- | ----------- |
+| `Create Session` | Create named session; args: alias, base_url, optional auth, headers |
+| `Delete All Sessions` | Close all sessions |
+
+### HTTP Methods
+
+| Keyword | Description |
+| ------- | ----------- |
+| `GET` | GET request; returns response |
+| `POST` | POST request |
+| `PUT` | PUT request |
+| `PATCH` | PATCH request |
+| `DELETE` | DELETE request |
+| `HEAD` | HEAD request |
+
+### Assertions
+
+| Keyword | Description |
+| ------- | ----------- |
+| `Status Should Be` | Assert status code (e.g., 200, 201) |
+| `Response Should Be Successful` | 2xx status |
+| `Response Should Be Client Error` | 4xx status |
+| `Response Should Be Server Error` | 5xx status |
+
+### Response Access
+
+| Keyword | Description |
+| ------- | ----------- |
+| `Integer` | Parse response as int |
+| `Json` | Parse response as JSON |
+| `Content` | Raw response content |
+| `Headers` | Response headers |
+
+### Example
+
+```robot
+*** Settings ***
+Library    RequestsLibrary
+
+*** Test Cases ***
+Get User
+    Create Session    api    https://api.example.com
+    ${resp}=    GET    api    /users/1
+    Status Should Be    200    ${resp}
+    Dictionary Should Contain Key    ${resp.json()}    id
+```
+
+---
+
+## BuiltIn
+
+Always available. Core keywords for logic, assertions, control flow.
+
+### Logging
+
+| Keyword | Description |
+| ------- | ----------- |
+| `Log` | Log message |
+| `Log To Console` | Print to console |
+| `Log Many` | Log multiple variables |
+
+### Assertions
+
+| Keyword | Description |
+| ------- | ----------- |
+| `Should Be Equal` | Assert equality |
+| `Should Not Be Equal` | Assert inequality |
+| `Should Be True` | Assert expression true |
+| `Should Contain` | Assert string/list contains |
+| `Should Match Regexp` | Assert regex match |
+| `Fail` | Force test failure |
+
+### Control Flow
+
+| Keyword | Description |
+| ------- | ----------- |
+| `Run Keyword If` | Conditional keyword execution |
+| `Run Keyword And Return` | Execute and return value |
+| `Run Keyword And Ignore Error` | Execute, return status and output |
+| `Wait Until Keyword Succeeds` | Retry keyword until success |
+| `FOR` / `END` | Loop |
+| `IF` / `ELSE` / `END` | Conditional (RF 5.0+) |
+| `TRY` / `EXCEPT` / `END` | Exception handling (RF 5.0+) |
+
+### Variables
+
+| Keyword | Description |
+| ------- | ----------- |
+| `Set Variable` | Create variable |
+| `Set Suite Variable` | Suite-level variable |
+| `Set Test Variable` | Test-level variable |
+| `Get Variable Value` | Get variable with default |
+| `Evaluate` | Evaluate Python expression |
+
+---
+
+## Collections
+
+List and dictionary operations. Import: `Library Collections`
+
+### List Keywords
+
+| Keyword | Description |
+| ------- | ----------- |
+| `Append To List` | Add item to list |
+| `Get From List` | Get item by index |
+| `Length` | Get list length |
+| `List Should Contain Value` | Assert list contains |
+| `Remove From List` | Remove by index |
+| `Sort List` | Sort list |
+
+### Dictionary Keywords
+
+| Keyword | Description |
+| ------- | ----------- |
+| `Get From Dictionary` | Get value by key |
+| `Set To Dictionary` | Set key-value |
+| `Dictionary Should Contain Key` | Assert key exists |
+| `Dictionary Should Contain Value` | Assert value exists |
+| `Log Dictionary` | Log dict contents |
+
+---
+
+## String
+
+String manipulation. Import: `Library String`
+
+| Keyword | Description |
+| ------- | ----------- |
+| `Get Length` | String length |
+| `Split String` | Split by separator |
+| `Replace String` | Replace substring |
+| `Get Substring` | Extract substring |
+| `Convert To Lowercase` | Lowercase |
+| `Convert To Uppercase` | Uppercase |
+| `Strip String` | Trim whitespace |
+| `Should Match Regexp` | Regex match |
+
+---
+
+## DateTime
+
+Date and time. Import: `Library DateTime`
+
+| Keyword | Description |
+| ------- | ----------- |
+| `Get Current Date` | Current date/time |
+| `Add Time To Date` | Add duration to date |
+| `Subtract Date From Date` | Date difference |
+| `Convert Date` | Format date (e.g., `%Y-%m-%d`) |

package/skills/qa-robot-framework-writer/references/patterns.md

@@ -0,0 +1,216 @@
+# Robot Framework Patterns
+
+## Keyword-Driven Testing
+
+Tests are composed of high-level keywords that hide implementation details:
+
+```robot
+*** Test Cases ***
+User Can Log In
+    [Documentation]    Verify successful login
+    Given User Is On Login Page
+    When User Enters Credentials    ${VALID_USER}    ${VALID_PASS}
+    And User Clicks Login Button
+    Then User Should See Dashboard
+    And User Should Be Logged In
+```
+
+Keywords are defined in *** Keywords *** or imported from resource files:
+
+```robot
+*** Keywords ***
+User Is On Login Page
+    Open Browser    ${LOGIN_URL}    ${BROWSER}
+    Title Should Be    Login
+
+User Enters Credentials
+    [Arguments]    ${username}    ${password}
+    Input Text    id=username    ${username}
+    Input Password    id=password    ${password}
+```
+
+## BDD Syntax (Given/When/Then)
+
+Use BDD-style keyword names for readability:
+
+```robot
+*** Test Cases ***
+Checkout With Valid Card
+    Given User Has Items In Cart
+    When User Proceeds To Checkout
+    And User Enters Payment    ${CARD_NUMBER}    ${EXPIRY}
+    Then Order Should Be Confirmed
+    And User Receives Confirmation Email
+```
+
+Keyword naming convention:
+- **Given** — Setup, preconditions
+- **When** — Action, user/system behavior
+- **Then** — Assertion, expected outcome
+- **And** — Additional step in same phase
+
+## Data-Driven Tests
+
+### FOR Loops
+
+```robot
+*** Test Cases ***
+Validate Multiple Inputs
+    FOR    ${input}    IN    valid    invalid    empty
+        Log    Testing with: ${input}
+        Validate Input    ${input}
+    END
+```
+
+### Template Tests
+
+Single keyword executed with different arguments:
+
+```robot
+*** Test Cases ***
+Login With Valid Credentials
+    [Template]    Login And Verify
+    user1    pass1    Dashboard
+    user2    pass2    Admin Panel
+    admin    admin123    Settings
+
+*** Keywords ***
+Login And Verify
+    [Arguments]    ${user}    ${pass}    ${expected_page}
+    Input Text    id=username    ${user}
+    Input Password    id=password    ${pass}
+    Click Button    id=login
+    Location Should Contain    ${expected_page}
+```
+
+### Data-Driven With [Template] and Multiple Rows
+
+```robot
+*** Test Cases ***
+Search With Different Terms
+    [Template]    Search And Verify Results
+    robot framework    10
+    selenium    5
+    pytest    8
+```
+
+## Resource Files
+
+Shared keywords and variables in separate files:
+
+```robot
+*** Settings ***
+Resource    resources/common.robot
+Resource    resources/login_keywords.robot
+Library     SeleniumLibrary
+```
+
+**resources/common.robot:**
+```robot
+*** Settings ***
+Library    SeleniumLibrary
+
+*** Variables ***
+${BROWSER}    chrome
+${BASE_URL}    https://example.com
+
+*** Keywords ***
+Open Application
+    Open Browser    ${BASE_URL}    ${BROWSER}
+    Maximize Browser Window
+
+Close Application
+    Close All Browsers
+```
+
+## Variable Files
+
+### Python Variable File
+
+**variables/env.py:**
+```python
+BROWSER = "chrome"
+BASE_URL = "https://example.com"
+VALID_USER = "testuser"
+VALID_PASS = "secret"
+```
+
+Usage: `robot -V variables/env.py tests/`
+
+### YAML Variable File
+
+**variables/config.yaml:**
+```yaml
+BROWSER: chrome
+BASE_URL: https://example.com
+VALID_USER: testuser
+VALID_PASS: secret
+```
+
+Usage: `robot -V variables/config.yaml tests/`
+
+## Control Flow
+
+### IF / ELSE (RF 5.0+)
+
+```robot
+*** Keywords ***
+Handle Optional Step
+    [Arguments]    ${condition}
+    IF    ${condition} == ${True}
+        Click Button    submit
+    ELSE
+        Log    Skipping submit
+    END
+```
+
+### TRY / EXCEPT (RF 5.0+)
+
+```robot
+*** Keywords ***
+Safe Click
+    [Arguments]    ${locator}
+    TRY
+        Click Element    ${locator}
+    EXCEPT    Element not found
+        Log    Element not found, skipping
+    END
+```
+
+### Run Keyword If (Legacy)
+
+```robot
+Run Keyword If    '${ENV}' == 'prod'    Log    Production
+...    ELSE IF    '${ENV}' == 'staging'    Log    Staging
+...    ELSE    Log    Development
+```
+
+## Test Setup and Teardown
+
+```robot
+*** Settings ***
+Suite Setup       Open Application
+Suite Teardown    Close Application
+Test Setup        Navigate To Home
+Test Teardown     Capture Page Screenshot On Failure
+
+*** Keywords ***
+Capture Page Screenshot On Failure
+    Run Keyword If Test Failed    Capture Page Screenshot
+```
+
+## Tags
+
+```robot
+*** Test Cases ***
+Critical Login Test
+    [Tags]    smoke    critical    login
+    User Can Log In
+
+Slow E2E Flow
+    [Tags]    e2e    slow
+    [Timeout]    2 minutes
+    Complete Checkout Flow
+```
+
+Run by tag: `robot --include smoke tests/` or `robot --exclude slow tests/`