{"id":15018821,"url":"https://github.com/qahive/robotframework-exceldatadriver","last_synced_at":"2025-10-24T00:31:21.787Z","repository":{"id":54852393,"uuid":"231272974","full_name":"qahive/robotframework-ExcelDataDriver","owner":"qahive","description":"ExcelDataDriver is a Excel Data-Driven Testing library for Robot Framework.","archived":false,"fork":false,"pushed_at":"2022-12-27T15:36:44.000Z","size":153,"stargazers_count":9,"open_issues_count":1,"forks_count":1,"subscribers_count":6,"default_branch":"master","last_synced_at":"2024-09-26T20:53:21.283Z","etag":null,"topics":["datadriven","robotframework","rpa"],"latest_commit_sha":null,"homepage":"https://www.qahive.com/","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/qahive.png","metadata":{"files":{"readme":"README.rst","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2020-01-01T22:58:30.000Z","updated_at":"2024-06-24T16:54:22.000Z","dependencies_parsed_at":"2023-01-31T04:45:08.857Z","dependency_job_id":null,"html_url":"https://github.com/qahive/robotframework-ExcelDataDriver","commit_stats":null,"previous_names":[],"tags_count":18,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/qahive%2Frobotframework-ExcelDataDriver","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/qahive%2Frobotframework-ExcelDataDriver/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/qahive%2Frobotframework-ExcelDataDriver/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/qahive%2Frobotframework-ExcelDataDriver/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/qahive","download_url":"https://codeload.github.com/qahive/robotframework-ExcelDataDriver/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":219867315,"owners_count":16555821,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["datadriven","robotframework","rpa"],"created_at":"2024-09-24T19:52:30.241Z","updated_at":"2025-10-24T00:31:21.436Z","avatar_url":"https://github.com/qahive.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"ExcelDataDriver\n===============\n.. figure:: https://github.com/qahive/robotframework-ExcelDataDriver/workflows/Python%20package/badge.svg\n.. contents::\n\nIntroduction\n------------\n\nExcelDataDriver_ is a Excel Data-Driven Testing library for `RobotFramework \u003chttp://code.google.com/p/robotframework/\u003e`_.\nThe project is hosted on `GitHub \u003chttps://github.com/qahive/robotframework-ExcelDataDriver\u003e`_ and downloads can be found from `PyPI \u003chttps://pypi.org/project/robotframework-ExcelDataDriver/\u003e`_.\n\nInspired by: https://github.com/Snooz82/robotframework-datadriver\n\n\nKeyword documentation\n---------------------\n\nSee `keyword documentation \u003chttps://qahive.github.io/robotframework-ExcelDataDriver/ExcelDataDriver.html\u003e`_ for available keywords and more information about the library in general.\n\n\nInstallation\n------------\n\nThe recommended installation method is using pip::\n\n    pip install --upgrade robotframework-exceldatadriver\n\nManual download source code to your local computer and running following command to install using python::\n\n    python setup.py install --force -v\n\n\nDirectory Layout\n----------------\n\nExamples/\n    A simple demonstration, with a web application and RF test suite\n\ndocs/\n    Keyword documentation\n\nCoreRPAHive/\n    Python source code\n\ntests/\n    Python nose test scripts\n\n\nUsage\n-----\n\nTo write tests with Robot Framework and ExcelDataDriver,\nExcelDataDriver must be imported into your RF test suite.\n\n1. Create Excel file by copy from template (`download \u003chttps://github.com/qahive/robotframework-ExcelDataDriver/raw/master/Examples/test_data/DefaultDemoData.xlsx\u003e`_).\n\n    Mandatory Columns:\n       - [Status]       For report test result Pass/Fail\n       - [Log Message]\tError message or any message after test done\n       - [Screenshot]\tScreenshot (Support only 1 screenshot)\n       - [Tags]         Robot Tag\n\n    Test data Columns:\n\n    User can add their own test data columns without limit\n        Example:\n\n        - Username\n        - Password\n\n2. Create RF test suite\n\n.. code:: robotframework\n\n    *** Setting ***\n    Library    ExcelDataDriver    ./test_data/BasicDemoData.xlsx    capture_screenshot=Skip\n    Test Template    Validate user data template\n\n    *** Test Cases ***\n    Verify valid user '${username}'    ${None}    ${None}    ${None}\n\n    *** Keywords ***\n    Validate user data template\n        [Arguments]    ${username}     ${password}    ${email}\n        Log    ${username}\n        Log    ${password}\n        Log    ${email}\n        Should Be True    '${password}' != '${None}'\n        Should Match Regexp    ${email}    [A-Za-z0-9._%+-]+@[A-Za-z0-9.-]+\\.[A-Za-z]{2,}\n\n\nEnhancement and release\n-----------------------\n\n- Create update keyword documents\n\n.. code:: python\n\n    python -m robot.libdoc -f html ExcelDataDriver docs/ExcelDataDriver.html\n\n- Extended (In-progress)\n\n\nLimitation\n----------\n\n``Eclipse plug-in RED``\n\nThere are known issues if the Eclipse plug-in RED is used. Because the debugging Listener of this tool pre-calculates the number of test cases before the creation of test cases by the Data Driver. This leads to the situation that the RED listener throws exceptions because it is called for each test step but the RED GUI already stopped debugging so that the listener cannot send Information to the GUI.\n\nThis does not influence the execution in any way but produces a lot of unwanted exceptions in the Log.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fqahive%2Frobotframework-exceldatadriver","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fqahive%2Frobotframework-exceldatadriver","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fqahive%2Frobotframework-exceldatadriver/lists"}