robotframework-lynqa 0.1.0__py3-none-any.whl

robotframework_lynqa/test/data_set/testrun_full_status.py

@@ -0,0 +1,129 @@
+"""Dataset: Test run full status response."""
+
+TEST_RUN_FULL_STATUS_SUCCESS_RESPONSE = {
+    "createdAt": "2026-06-12T13:58:24.944Z",
+    "start": "2026-06-12T13:58:28.693Z",
+    "end": "2026-06-12T14:00:36.029Z",
+    "status": "success",
+    "statusMessage": "OK",
+    "stepStatuses": [
+        {
+            "end": "2026-06-12T13:59:07.365Z",
+            "start": "2026-06-12T13:58:53.483Z",
+            "status": "success",
+            "commands": [
+                {
+                    "name": "scroll",
+                    "response": {"success": {"delta": 500, "direction": "down"}},
+                    "screenshot": "3f85e362-d50e-4521-8447-27427110cf5f",
+                },
+                {
+                    "name": "click",
+                    "button": "left",
+                    "response": {"success": {"newUrl": None}},
+                    "screenshot": "4e63b6a6-b337-4642-a872-91f20a4ab919",
+                    "htmlElement": '"Tout refuser button"',
+                },
+            ],
+            "assertionsReport": {
+                "assertions": [
+                    {"checked": True, "assertion": "The browser is navigated to https://www.google.com/"},
+                    {"checked": True, "assertion": "The Google homepage is fully loaded with the search input visible"},
+                    {"checked": True, "assertion": "The cookie consent popup is dismissed"},
+                ],
+                "screenshot": "1be40c8c-dbb2-466e-ab1b-a5155a531fc4",
+            },
+        },
+        {
+            "end": "2026-06-12T13:59:28.493Z",
+            "start": "2026-06-12T13:59:28.493Z",
+            "status": "success",
+            "commands": [],
+            "assertionsReport": {
+                "assertions": [
+                    {"checked": True, "assertion": "The browser is navigated to https://www.google.com/"},
+                    {
+                        "checked": True,
+                        "assertion": "The cookie consent popup is dismissed and the Google homepage is fully accessible",  # ruff: ignore[line-too-long]
+                    },
+                    {"checked": True, "assertion": "The search input is visible and accessible on the Google homepage"},
+                ],
+                "screenshot": "cce0c8f8-e96a-48f2-8b35-ffd41ec979dd",
+            },
+        },
+        {
+            "end": "2026-06-12T13:59:40.504Z",
+            "start": "2026-06-12T13:59:40.504Z",
+            "status": "success",
+            "commands": [],
+            "assertionsReport": {
+                "assertions": [
+                    {"checked": True, "assertion": "The search input exists and is visible on the Google homepage"}
+                ],
+                "screenshot": "296ad2a5-4cea-44a8-8af6-fbf62ce1aeaf",
+            },
+        },
+        {
+            "end": "2026-06-12T14:00:16.258Z",
+            "start": "2026-06-12T14:00:00.401Z",
+            "status": "success",
+            "commands": [
+                {
+                    "name": "click",
+                    "button": "left",
+                    "response": {"success": {"newUrl": None}},
+                    "screenshot": "62a28ce4-f106-4b70-94f7-ea640d55fcdc",
+                    "htmlElement": "Search input field",
+                },
+                {
+                    "name": "type",
+                    "value": "lynqa",
+                    "response": {"success": True},
+                    "screenshot": "caeaa3c5-e37d-4460-a1ed-c53d81406617",
+                },
+                {
+                    "name": "pressKey",
+                    "value": "Return",
+                    "response": {
+                        "success": {
+                            "newUrl": "https://www.google.com/search?q=lynqa&sca_esv=2aa300c80f7be1f4&source=hp&ei=gxAsaqTHMqq4kdUP1ciGmAY&iflsig=AFdpzrgAAAAAaiwek3wNXsJiALMoqmxWYThTRkSuPVDQ&ved=0ahUKEwjklP737YGVAxUqXKQEHVWkAWMQ4dUDCCE&uact=5&oq=lynqa&gs_lp=Egdnd3Mtd2l6IgVseW5xYTIMEC4YgAQYChgLGLEDMg8QLhiABBgKGAsYsQMYgwEyDBAuGAoYCxixAxiABDIMEC4YChgLGLEDGIAEMgkQLhiABBgKGAsyCRAuGIAEGAoYCzIJEAAYgAQYChgLMgkQABiABBgKGAsyCRAuGIAEGAoYCzIJEC4YgAQYChgLSJtnUMRAWJlBcAF4AJABAJgBM6AB1gGqAQE1uAEDyAEA-AEBmAIGoAKIAqgCCsICChAuGAMYjwEY6gLCAgoQABgDGI8BGOoCwgILEAAYgAQYsQMYgwHCAggQABiABBixA8ICCBAuGIAEGLEDwgIREC4YgAQYsQMYgwEYxwEY0QPCAg4QLhiABBixAxjHARjRA8ICBRAuGIAEwgIOEC4YgAQYigUYsQMYgwHCAg4QABiABBiKBRixAxiDAcICBhAAGAMYCsICBBAAGAPCAgUQABiABMICBxAAGIAEGAqYAw3xBaK8RTujFJwPkgcBNqAH50ayBwE1uAf7AcIHBTItNC4yyAcogAgB&sclient=gws-wiz&sei=3hAsauOqNoqbkdUP-YX-qAw"
+                        }
+                    },
+                    "screenshot": "d7a51561-7ac9-4a55-bdf6-b809c5287a69",
+                    "keysSequence": ["Return"],
+                },
+            ],
+            "assertionsReport": {
+                "assertions": [
+                    {"checked": True, "assertion": "Search for 'lynqa' is executed and results page is displayed"},
+                    {"checked": True, "assertion": "Search results include 'Smartesting' in the first results"},
+                ],
+                "screenshot": "3b78845d-41e8-43ba-abe2-b006e8735be2",
+            },
+        },
+        {
+            "end": "2026-06-12T14:00:35.981Z",
+            "start": "2026-06-12T14:00:35.981Z",
+            "status": "success",
+            "commands": [],
+            "assertionsReport": {
+                "assertions": [
+                    {"checked": True, "assertion": "The search query 'lynqa' is entered and results are displayed"},
+                    {"checked": True, "assertion": "Several search results are displayed for the query 'lynqa'"},
+                    {"checked": True, "assertion": "The first result displays 'Smartesting' as the source"},
+                    {"checked": True, "assertion": "The first results (plural) display 'Smartesting'"},
+                ],
+                "screenshot": "d9b611e0-955d-4b69-a51b-58ed40d88fb3",
+            },
+        },
+    ],
+    "initialReport": {"screenshot": "b276c303-d612-4c25-a2cd-18d42b8b4930", "architecture": "omeron"},
+    "type": "gherkin",
+    "steps": [
+        {"keyword": "Given", "text": "go to the website"},
+        {"keyword": "When", "text": "I look at the search input"},
+        {"keyword": "Then", "text": "the search input exists"},
+        {"keyword": "When", "text": "I search for 'lynqa'"},
+        {"keyword": "Then", "text": "several results are displayed and the first results display 'Smartesting'"},
+    ],
+}

robotframework_lynqa/test/data_set/testrun_full_status_failure.py

@@ -0,0 +1,130 @@
+"""Dataset: Test run full status response."""
+
+TEST_RUN_FULL_STATUS_FAILURE_RESPONSE = {
+    "createdAt": "2026-06-12T13:58:24.944Z",
+    "start": "2026-06-12T13:58:28.693Z",
+    "end": "2026-06-12T14:00:36.029Z",
+    "status": "failed",
+    "statusMessage": "KO",
+    "stepStatuses": [
+        {
+            "end": "2026-06-12T13:59:07.365Z",
+            "start": "2026-06-12T13:58:53.483Z",
+            "status": "success",
+            "commands": [
+                {
+                    "name": "scroll",
+                    "response": {"success": {"delta": 500, "direction": "down"}},
+                    "screenshot": "3f85e362-d50e-4521-8447-27427110cf5f",
+                },
+                {
+                    "name": "click",
+                    "button": "left",
+                    "response": {"success": {"newUrl": None}},
+                    "screenshot": "4e63b6a6-b337-4642-a872-91f20a4ab919",
+                    "htmlElement": '"Tout refuser button"',
+                },
+            ],
+            "assertionsReport": {
+                "assertions": [
+                    {"checked": True, "assertion": "The browser is navigated to https://www.google.com/"},
+                    {"checked": True, "assertion": "The Google homepage is fully loaded with the search input visible"},
+                    {"checked": True, "assertion": "The cookie consent popup is dismissed"},
+                ],
+                "screenshot": "1be40c8c-dbb2-466e-ab1b-a5155a531fc4",
+            },
+        },
+        {
+            "end": "2026-06-12T13:59:28.493Z",
+            "start": "2026-06-12T13:59:28.493Z",
+            "status": "success",
+            "commands": [],
+            "assertionsReport": {
+                "assertions": [
+                    {"checked": True, "assertion": "The browser is navigated to https://www.google.com/"},
+                    {
+                        "checked": True,
+                        "assertion": "The cookie consent popup is dismissed and the Google homepage is fully accessible",  # ruff: ignore[line-too-long]
+                    },
+                    {"checked": True, "assertion": "The search input is visible and accessible on the Google homepage"},
+                ],
+                "screenshot": "cce0c8f8-e96a-48f2-8b35-ffd41ec979dd",
+            },
+        },
+        {
+            "end": "2026-06-12T13:59:40.504Z",
+            "start": "2026-06-12T13:59:40.504Z",
+            "status": "failed",
+            "commands": [],
+            "assertionsReport": {
+                "assertions": [
+                    {"checked": True, "assertion": "The search input exists and is visible on the Google homepage"}
+                ],
+                "screenshot": "296ad2a5-4cea-44a8-8af6-fbf62ce1aeaf",
+            },
+        },
+        {
+            "end": "2026-06-12T14:00:16.258Z",
+            "start": "2026-06-12T14:00:00.401Z",
+            "status": "success",
+            "commands": [
+                {
+                    "name": "click",
+                    "button": "left",
+                    "response": {"success": {"newUrl": None}},
+                    "screenshot": "62a28ce4-f106-4b70-94f7-ea640d55fcdc",
+                    "htmlElement": "Search input field",
+                },
+                {
+                    "name": "type",
+                    "value": "lynqa",
+                    "response": {"success": True},
+                    "screenshot": "caeaa3c5-e37d-4460-a1ed-c53d81406617",
+                },
+                {
+                    "name": "pressKey",
+                    "value": "Return",
+                    "response": {
+                        "success": {
+                            "newUrl": "https://www.google.com/search?q=lynqa&sca_esv=2aa300c80f7be1f4&source=hp&ei=gxAsaqTHMqq4kdUP1ciGmAY&iflsig=AFdpzrgAAAAAaiwek3wNXsJiALMoqmxWYThTRkSuPVDQ&ved=0ahUKEwjklP737YGVAxUqXKQEHVWkAWMQ4dUDCCE&uact=5&oq=lynqa&gs_lp=Egdnd3Mtd2l6IgVseW5xYTIMEC4YgAQYChgLGLEDMg8QLhiABBgKGAsYsQMYgwEyDBAuGAoYCxixAxiABDIMEC4YChgLGLEDGIAEMgkQLhiABBgKGAsyCRAuGIAEGAoYCzIJEAAYgAQYChgLMgkQABiABBgKGAsyCRAuGIAEGAoYCzIJEC4YgAQYChgLSJtnUMRAWJlBcAF4AJABAJgBM6AB1gGqAQE1uAEDyAEA-AEBmAIGoAKIAqgCCsICChAuGAMYjwEY6gLCAgoQABgDGI8BGOoCwgILEAAYgAQYsQMYgwHCAggQABiABBixA8ICCBAuGIAEGLEDwgIREC4YgAQYsQMYgwEYxwEY0QPCAg4QLhiABBixAxjHARjRA8ICBRAuGIAEwgIOEC4YgAQYigUYsQMYgwHCAg4QABiABBiKBRixAxiDAcICBhAAGAMYCsICBBAAGAPCAgUQABiABMICBxAAGIAEGAqYAw3xBaK8RTujFJwPkgcBNqAH50ayBwE1uAf7AcIHBTItNC4yyAcogAgB&sclient=gws-wiz&sei=3hAsauOqNoqbkdUP-YX-qAw"
+                        }
+                    },
+                    "screenshot": "d7a51561-7ac9-4a55-bdf6-b809c5287a69",
+                    "keysSequence": ["Return"],
+                },
+            ],
+            "assertionsReport": {
+                "assertions": [
+                    {"checked": True, "assertion": "Search for 'lynqa' is executed and results page is displayed"},
+                    {"checked": True, "assertion": "Search results include 'Smartesting' in the first results"},
+                ],
+                "screenshot": "3b78845d-41e8-43ba-abe2-b006e8735be2",
+            },
+        },
+        {
+            "end": "2026-06-12T14:00:35.981Z",
+            "start": "2026-06-12T14:00:35.981Z",
+            "status": "failed",
+            "commands": [],
+            "assertionsReport": {
+                "assertions": [
+                    {"checked": True, "assertion": "The search query 'lynqa' is entered and results are displayed"},
+                    {"checked": True, "assertion": "Several search results are displayed for the query 'lynqa'"},
+                    {"checked": True, "assertion": "The first result displays 'Smartesting' as the source"},
+                    {"checked": True, "assertion": "The first results (plural) display 'Smartesting'"},
+                ],
+                "screenshot": "d9b611e0-955d-4b69-a51b-58ed40d88fb3",
+            },
+            "testVerdictCause": "An error occurred while executing the test",
+        },
+    ],
+    "initialReport": {"screenshot": "b276c303-d612-4c25-a2cd-18d42b8b4930", "architecture": "omeron"},
+    "type": "gherkin",
+    "steps": [
+        {"keyword": "Given", "text": "go to the website"},
+        {"keyword": "When", "text": "I look at the search input"},
+        {"keyword": "Then", "text": "the search input exists"},
+        {"keyword": "When", "text": "I search for 'lynqa'"},
+        {"keyword": "Then", "text": "several results are displayed and the first results display 'Smartesting'"},
+    ],
+}

robotframework_lynqa/test/test_library.py

@@ -0,0 +1,203 @@
+"""Unit tests for robotframework_lynqa."""
+
+from datetime import datetime, timedelta, timezone
+from pathlib import Path
+
+import pytest
+import robot
+from pylynqa import TestData, TestRunContext
+from robot.result import ExecutionResult, Keyword
+
+from robotframework_lynqa.library import LynqaLibrary
+from robotframework_lynqa.test import API_KEY, _CaptureLibInstance
+from robotframework_lynqa.test.data_set.testrun_full_status import TEST_RUN_FULL_STATUS_SUCCESS_RESPONSE
+from robotframework_lynqa.test.data_set.testrun_full_status_failure import TEST_RUN_FULL_STATUS_FAILURE_RESPONSE
+from robotframework_lynqa.test.test_reporter import EXPECTED_SCREENSHOT_COUNT
+
+DATA_SET_FOLDER = Path(__file__).parent / "data_set"
+TEST_LYNQA_ROBOT_FILE = DATA_SET_FOLDER / "test_lynqa_nominal.robot"
+TEST_LYNQA_WITH_DATE_ROBOT_FILE = DATA_SET_FOLDER / "test_lynqa_with_date.robot"
+TEST_LYNQA_WITHOUT_URL_ROBOT_FILE = DATA_SET_FOLDER / "test_lynqa_without_url.robot"
+TEST_LYNQA_WITH_RESULTS_ROBOT_FILE = DATA_SET_FOLDER / "test_lynqa_with_results.robot"
+
+EXPECTED_SCENARIO = (
+    "Given the storefront is open at the home page\n"
+    "When the user searches for an autonomous testing agent\n"
+    "When the user filters the results to top-rated agents under 50 credits\n"
+    "Then a list of matching AI agents is displayed with their prices\n"
+    'Then the premium "Bobcat" agent is sold out because its success'
+)
+
+
+@pytest.fixture
+def client(mocker, screenshot_base64):
+    """Mock the Lynqa HTTP client so no real request is sent.
+
+    Patches :class:`LynqaClient` in the library module: every ``LynqaLibrary`` created during the run gets this mock as
+    its ``_client``. The run is reported as an immediately successful one.
+
+    :returns: The mock client instance shared by every ``LynqaLibrary``.
+    """
+    client = mocker.patch("robotframework_lynqa.library.LynqaClient").return_value
+    client.add_gherkin_test_run.return_value = 123456
+    client.get_test_run_status.return_value = {"status": "success"}
+    client.get_test_run_full_status.return_value = {"status": "success", "statusMessage": "OK"}
+    client.get_screenshot.return_value = screenshot_base64
+    return client
+
+
+@pytest.fixture
+def listener_probe(monkeypatch, mocker, client):
+    """Initialize the listener probe used to capture the library instance."""
+    monkeypatch.setenv("LYNQA_API_KEY", API_KEY)
+    mock_datetime = mocker.patch("robotframework_lynqa.library.datetime")
+    fixed_now = datetime(2026, 6, 24, 9, 52, 0, tzinfo=timezone(timedelta(hours=2)))
+    mock_datetime.now.return_value.astimezone.return_value = fixed_now
+    return _CaptureLibInstance()
+
+
+@pytest.fixture
+def library(client):
+    """Build a ``LynqaLibrary`` instance wired to the mocked client for unit tests.
+
+    :returns: A library whose ``_client`` is the shared mock from ``client``.
+    """
+    return LynqaLibrary(api_key=API_KEY)
+
+
+def test_nominal_scenario(tmp_path, listener_probe):
+    """Test that the scenario is executed."""
+    # Act
+    rc = robot.run(str(TEST_LYNQA_ROBOT_FILE), outputdir=str(tmp_path), listener=listener_probe)
+
+    # Assert
+    listener_inst = listener_probe.instance
+    assert rc == 0
+    assert listener_inst is not None
+    assert listener_inst.scenario == EXPECTED_SCENARIO
+    assert listener_inst.url == "https://www.super-u.ai"
+    assert listener_inst.context == TestRunContext(
+        client_language="rf-RF",
+        client_datetime="Wed Jun 24 2026 09:52:00 GMT+0200",
+        secrets=[TestData(name="login", value="superu"), TestData(name="password", value="TrèsS3cr3t")],
+    )
+
+
+def test_variable_with_date(tmp_path, listener_probe):
+    """Test that the scenario is executed with a provided date."""
+    # Act
+    rc = robot.run(str(TEST_LYNQA_WITH_DATE_ROBOT_FILE), outputdir=str(tmp_path), listener=listener_probe)
+
+    # Assert
+    listener_inst = listener_probe.instance
+    assert rc == 0
+    assert listener_inst.context == TestRunContext(
+        client_language="rf-RF",
+        client_datetime="Wed May 8 2026 09:00:00 GMT+0200",
+        secrets=[TestData(name="login", value="superu"), TestData(name="password", value="TrèsS3cr3t")],
+    )
+
+
+def test_variable_without_url(tmp_path, listener_probe):
+    """Test that the execution fails if URL is missing."""
+    # Act
+    rc = robot.run(str(TEST_LYNQA_WITHOUT_URL_ROBOT_FILE), outputdir=str(tmp_path), listener=listener_probe)
+
+    # Assert
+    assert rc > 0
+
+
+def test_scenario_result(tmp_path, listener_probe, client):
+    """Test that the scenario result is returned."""
+    # Arrange
+    client.get_test_run_full_status.return_value = TEST_RUN_FULL_STATUS_SUCCESS_RESPONSE
+    # Act
+    rc = robot.run(str(TEST_LYNQA_WITH_RESULTS_ROBOT_FILE), outputdir=str(tmp_path), listener=listener_probe)
+
+    # Assert
+    assert rc == 0
+    robot_result = ExecutionResult(str(tmp_path / "output.xml"))
+    # Assert Test status
+    test = robot_result.suite.tests[0]
+    assert test.status == "PASS"
+    assert test.message == "OK"
+    # Assert Keywords status
+    keywords = [elt for elt in test.body if isinstance(elt, Keyword)]
+    for keyword in keywords:
+        assert keyword.status == "PASS"
+    assert len(keywords[0].messages) > 1
+    # Assert Screenshots presence
+    embedded_images = [
+        message for keyword in keywords for message in keyword.messages if message.html and "<img" in message.message
+    ]
+    assert len(embedded_images) == EXPECTED_SCREENSHOT_COUNT
+
+
+def test_scenario_result_failure(tmp_path, listener_probe, client):
+    """Test that the scenario result is failed."""
+    # Arrange
+    client.get_test_run_full_status.return_value = TEST_RUN_FULL_STATUS_FAILURE_RESPONSE
+
+    # Act
+    rc = robot.run(str(TEST_LYNQA_WITH_RESULTS_ROBOT_FILE), outputdir=str(tmp_path), listener=listener_probe)
+
+    # Assert
+    assert rc > 0
+    robot_result = ExecutionResult(str(tmp_path / "output.xml"))
+    # Assert Test status
+    test = robot_result.suite.tests[0]
+    assert test.status == "FAIL"
+    assert test.message == "KO"
+    # Assert Keywords status
+    keywords = [elt for elt in test.body if isinstance(elt, Keyword)]
+    keywords_status = [keyword.status for keyword in keywords]
+    assert keywords_status == ["PASS", "PASS", "FAIL", "PASS", "FAIL"]
+    assert len(keywords[0].messages) > 1
+
+
+def test_wait_until_testrun_end_polls_until_complete(library, client, mocker):
+    """Polling continues while the run is pending, then stops on a final status."""
+    # Arrange
+    mocker.patch("robotframework_lynqa.library.time.sleep")
+    statuses = [
+        {"status": "running"},
+        {"status": "running"},
+        {"status": "success"},
+    ]
+    client.get_test_run_status.side_effect = statuses
+
+    # Act
+    library._wait_until_testrun_end(timeout=100)
+
+    # Assert
+    assert client.get_test_run_status.call_count == len(statuses)
+
+
+def test_wait_until_testrun_end_raises_on_timeout(library, client, mocker):
+    """A run that never leaves a pending status raises ``TimeoutError``."""
+    # Arrange
+    mocker.patch("robotframework_lynqa.library.time.sleep")
+    client.get_test_run_status.return_value = {"status": "running"}
+
+    # Act / Assert
+    with pytest.raises(TimeoutError):
+        library._wait_until_testrun_end(timeout=-1)
+
+
+def test_search_secrets_variables_unset(library, mocker):
+    """An unset secrets variable yields an empty list."""
+    # Arrange
+    mocker.patch.object(library, "_search_variable", return_value=None)
+
+    # Act / Assert
+    assert library._search_secrets_variables() == []
+
+
+def test_search_secrets_variables_invalid_type(library, mocker):
+    """A non-mapping secrets variable raises ``TypeError``."""
+    # Arrange
+    mocker.patch.object(library, "_search_variable", return_value="not-a-dict")
+
+    # Act / Assert
+    with pytest.raises(TypeError):
+        library._search_secrets_variables()

robotframework_lynqa/test/test_reporter.py

@@ -0,0 +1,61 @@
+"""Unit tests for :class:`robotframework_lynqa.reporter.StepReporter`.
+
+These tests exercise the reporter in isolation from Robot Framework: the Robot ``logger`` is patched to capture the
+messages, and the Lynqa client is a mock, so only the reporter's own log-presentation logic is under test.
+"""
+
+import pytest
+
+from robotframework_lynqa.reporter import StepReporter
+from robotframework_lynqa.test.data_set.testrun_full_status import TEST_RUN_FULL_STATUS_SUCCESS_RESPONSE
+from robotframework_lynqa.test.data_set.testrun_full_status_failure import TEST_RUN_FULL_STATUS_FAILURE_RESPONSE
+
+# Screenshots embedded for the sample runs: 1 initial + 5 command + 5 assertion screenshots.
+EXPECTED_SCREENSHOT_COUNT = 11
+
+
+@pytest.fixture
+def reporter(mocker, screenshot_base64):
+    """Build a :class:`StepReporter` wired to the given client and run data."""
+    client = mocker.patch("pylynqa.LynqaClient")
+    client.get_screenshot.return_value = screenshot_base64
+    return StepReporter(client, run_id="ur35vkfr7k5rm321dsuvllab", url="https://petit-robot.bzh")
+
+
+@pytest.fixture
+def mock_logger(mocker):
+    """Fixture to intercept logger calls."""
+    return mocker.patch("robotframework_lynqa.reporter.logger")
+
+
+def _embedded_image_count(mock_logger):
+    """Count the log messages that embedded an inline screenshot."""
+    messages = [call.args[0] for call in mock_logger.info.call_args_list]
+    messages += [call.args[0] for call in mock_logger.write.call_args_list]
+    return sum("<img" in message for message in messages)
+
+
+@pytest.mark.parametrize(
+    "results",
+    [TEST_RUN_FULL_STATUS_SUCCESS_RESPONSE, TEST_RUN_FULL_STATUS_FAILURE_RESPONSE],
+    ids=["success", "failure"],
+)
+def test_log_step_embeds_every_screenshot(reporter, mock_logger, results):
+    """Every screenshot (initial + commands + assertions) is fetched and embedded as an inline image."""
+    # Act
+    for index, _ in enumerate(results["stepStatuses"]):
+        reporter.log_step(index, results)
+
+    # Assert
+    assert reporter._client.get_screenshot.call_count == EXPECTED_SCREENSHOT_COUNT
+    assert _embedded_image_count(mock_logger) == EXPECTED_SCREENSHOT_COUNT
+
+
+def test_embed_screenshot_catches_fetch_errors(reporter, mock_logger):
+    """A screenshot download error is caught and logged, returning an empty string instead of raising."""
+    # Arrange
+    reporter._client.get_screenshot.side_effect = Exception("Kenavo")
+
+    # Act / Assert
+    assert not reporter._embed_screenshot("415bceb6-9328-4c50-80b3-d0139f8bcafe", "caption")
+    mock_logger.error.assert_called_once()

robotframework_lynqa-0.1.0.dist-info/METADATA

@@ -0,0 +1,109 @@
+Metadata-Version: 2.4
+Name: robotframework-lynqa
+Version: 0.1.0
+Summary: Robot Framework library for the Lynqa test execution agent
+Author-email: Alexis Pallier <alexis.pallier@petit-robot.bzh>
+License-Expression: Apache-2.0
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: pylynqa>=0.1
+Requires-Dist: robotframework>=7
+Provides-Extra: dev
+Requires-Dist: pytest>=7; extra == "dev"
+Requires-Dist: pytest-mock>=3; extra == "dev"
+Requires-Dist: pytest-cov>=5; extra == "dev"
+Requires-Dist: ruff>=0.15; extra == "dev"
+Requires-Dist: ty>=0.0; extra == "dev"
+Requires-Dist: coverage>=7.10; extra == "dev"
+Requires-Dist: robotframework-robocop>=6; extra == "dev"
+Requires-Dist: docstrfmt>=1.11; extra == "dev"
+Requires-Dist: sphinx-lint>=0.9; extra == "dev"
+Provides-Extra: doc
+Requires-Dist: docutils>=0.22; extra == "doc"
+Requires-Dist: zensical>=0.0; extra == "doc"
+Dynamic: license-file
+
+# robotframework-lynqa
+
+[![CI](https://github.com/petit-robot/robotframework-lynqa/actions/workflows/ci.yml/badge.svg)](https://github.com/petit-robot/robotframework-lynqa/actions/workflows/ci.yml)
+[![Acceptance test](https://github.com/petit-robot/robotframework-lynqa/actions/workflows/acceptance.yml/badge.svg)](https://github.com/petit-robot/robotframework-lynqa/actions/workflows/acceptance.yml)
+[![License](https://img.shields.io/badge/license-Apache--2.0-blue.svg)](LICENSE)
+[![Documentation](https://img.shields.io/badge/docs-Full%20documentation-blue.svg)](https://petit-robot.github.io/robotframework-lynqa/)
+
+**robotframework-lynqa** is a [Robot Framework](https://robotframework.org) library for the
+[Lynqa](https://lynqa.smartesting.com) test execution AI Agent.
+
+<picture>
+  <source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/petit-robot/robotframework-lynqa/main/docs/robotframework-lynqa-dark.png">
+  <img alt="Robot Framework/Lynqa connector" src="https://raw.githubusercontent.com/petit-robot/robotframework-lynqa/main/docs/robotframework-lynqa.png">
+</picture>
+
+Write your scenarios in plain Gherkin and let Lynqa, [Smartesting](https://www.smartesting.com)'s AI test-execution agent, execute them autonomously.
+No need to implement local keywords, simply provide your web application's URL.
+Lynqa analyses your test steps and application UI, then runs your test cases as a user would, producing comprehensive execution evidence.
+UI changes are handled automatically, eliminating the need for test automation maintenance.
+
+It builds on [pylynqa](https://github.com/petit-robot/pylynqa), the Python client for the Lynqa REST API.
+
+## Disclaimers
+
+> [!IMPORTANT]
+> **This is an unofficial project.** robotframework-lynqa is **not affiliated with, endorsed by, or maintained by
+> [Smartesting](https://www.smartesting.com)**, the company that develops Lynqa. "Lynqa" and "Smartesting" are the
+> property of their respective owners.
+
+> [!NOTE]
+> **Lynqa is a commercial product.** Using this library requires a Lynqa account and an API key, and running tests
+> consumes paid credits. See <https://my.lynqa.smartesting.com/integration> to create an API key.
+
+## Requirements
+
+- Python 3.9+
+- Robot Framework 7+
+- A Lynqa account and API key (test executions consume credits)
+
+## Installation
+
+```bash
+pip install robotframework-lynqa
+```
+
+## Quick start
+
+Import the library and write your test cases with the `Given`/`When`/`Then` keywords, each taking a single
+natural-language step:
+
+```robotframework
+*** Settings ***
+Library    robotframework_lynqa.LynqaLibrary    api_key=%{LYNQA_API_KEY}
+
+*** Variables ***
+${LYNQA_URL}    https://lemonde.fr
+
+*** Test Cases ***
+Search An Article
+    Given    the website is open
+    When     I search an article on "france ia"
+    Then     there is an article on "IA agentique"
+```
+
+The scenario is captured and submitted to Lynqa, which runs it against the site at `${LYNQA_URL}` and reports each step's
+result back to Robot Framework.
+
+## Documentation
+
+Full documentation: installation, configuration variables and the complete keyword reference — is available at
+<https://petit-robot.github.io/robotframework-lynqa/>.
+
+## Collaboration
+
+This project is at an early stage, so **external contributions are limited for now**. This may be opened up more broadly
+later as the project matures.
+
+In the meantime, **you are very welcome to open an
+[issue](https://github.com/petit-robot/robotframework-lynqa/issues)** to report a bug or ask any question.
+
+## License
+
+Licensed under the [Apache License 2.0](LICENSE).

robotframework_lynqa-0.1.0.dist-info/RECORD

@@ -0,0 +1,22 @@
+robotframework_lynqa/__init__.py,sha256=cfyw4h9FAPx6XZqEbBiNIFykosoLjyKQE-O-E7beANg,166
+robotframework_lynqa/library.py,sha256=O9YrSQ-cgO1DYbttFwOiCExBmN21BQ9oj-FAgpetYfU,13810
+robotframework_lynqa/reporter.py,sha256=4RheUnEubzBr_ZYRPd1TV1dbmYcf0iucLTYXDrz4kO8,5950
+robotframework_lynqa/atest/lynqa_search.robot,sha256=_eZXZzjhKhZ6EAjAo0NnoRNUKqdGKXWOA5EVTqLISrw,715
+robotframework_lynqa/test/__init__.py,sha256=PKTiZ9hxApp32cXzuhG1kWKEuR2oNJJFowiTe2ohWkg,1037
+robotframework_lynqa/test/conftest.py,sha256=K6l5557bSPAd6wbpTy2m5kmuqV-XQFn73_iZAQVhBsk,989
+robotframework_lynqa/test/test_library.py,sha256=9SO52kjZKEtXbksvjVtCFADQoAlKjOds7DpqDt-LkGw,7837
+robotframework_lynqa/test/test_reporter.py,sha256=Q-D45CCi4W9jrWnBiG0O8U44G5adzw5YMaS-t1AYGEo,2569
+robotframework_lynqa/test/data_set/screenshot.png,sha256=TWkyp04NyIeOUCP6Md0nOVp33ItE3AHmnIA1K5MyetY,16612
+robotframework_lynqa/test/data_set/test_lynqa_nominal.robot,sha256=DH0Wdd0Q_4JbTCeQnIdNX84zcPTiftJTkBFFFI5Srrg,638
+robotframework_lynqa/test/data_set/test_lynqa_with_date.robot,sha256=wOEkTmxa5Q9gmd4T9cAQ-LuJqS5P2_Xa_eCyI7h9C98,577
+robotframework_lynqa/test/data_set/test_lynqa_with_results.robot,sha256=Tc4kzTkKOUfTIUG6zfR9mGrA5MrS3NW6WPllzeR9H1k,411
+robotframework_lynqa/test/data_set/test_lynqa_without_url.robot,sha256=PZ_LCeAOajiBDTiDyfFyh1qmOyuvIz3NdZAiNCwQWvo,532
+robotframework_lynqa/test/data_set/testrun_full_status.py,sha256=nynK-Vtg8te_1N-s9nt7vg2AAQaH_NrSJWXsRwJ-a7E,6437
+robotframework_lynqa/test/data_set/testrun_full_status_failure.py,sha256=7u28mBECxzjWyQY5W9WCXc-1aLOYbEIIUqYZlOvEGC4,6512
+robotframework_lynqa-0.1.0.dist-info/licenses/LICENSE,sha256=xx0jnfkXJvxRnG63LTGOxlggYnIysveWIZ6H3PNdCrQ,11357
+robotframework_lynqa-0.1.0.dist-info/METADATA,sha256=jTHg2qsYRu0nzANLXfnRy7dbb8O1CYdSk7p795DbR18,4542
+robotframework_lynqa-0.1.0.dist-info/WHEEL,sha256=K260EYznzXsJYBQGqmI8VTxEdiZYNvDZwW9cBh9-_MA,91
+robotframework_lynqa-0.1.0.dist-info/scm_file_list.json,sha256=n7wEzh7hU-uQa4XGobXRCHT-ooJu3PNS3G-cwVl5V2I,1428
+robotframework_lynqa-0.1.0.dist-info/scm_version.json,sha256=1zocZrvkPySUGA-DaIkk-Nfowm3bbZdbBkTDECNxwGk,160
+robotframework_lynqa-0.1.0.dist-info/top_level.txt,sha256=9wtppVSjlZ9nniUMeFezx6h1SKSk9YCvrzFQmAdpoXE,21
+robotframework_lynqa-0.1.0.dist-info/RECORD,,

robotframework_lynqa-0.1.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (83.0.0)
+Root-Is-Purelib: true
+Tag: py3-none-any
+