===================================================
robotframework-browser-migration
===================================================
This project contains two things.
1. A small script to analyze your SeleniumLibrary keywords unsed and create a statistic over
the usage in your project.
2. A migration layer library named `SeleniumLibraryToBrowser` that has ~80% of the SeleniumLibrary keywords implemented by Browser library.
Installation
------------
run:
``pip install robotframework-browser-migration``
for the migration layer library you also need Robot_Framework_Browser_ installed and initialized as well:
``pip install robotframework-browser``
and
``rfbrowser init``
.. _Robot_Framework_Browser: https://browserlibrary.org
|
===================================================
SeleniumLibraryToBrowser
===================================================
Please find the implemented keywords here in the Keyword_Documentation_.
.. _Keyword_Documentation: https://snooz82.github.io/robotframework-browser-migration/?tag=IMPLEMENTED
Usage:
.. code:: robotframework
*** Settings ***
Library SeleniumLibraryToBrowser
*** Test Cases ***
My Test Case
Open Browser https://robocon.io chrome
Location Should Be https://robocon.io/
${hamburger}= Run Keyword And Return Status Element Should Be Visible css:.hamburger
IF ${hamburger} Click Button css:.hamburger
Click Link RBCN22
Location Should Be https://robocon.io/2022
Close All Browsers
Be aware that some keywords will never be implemented and others are just barely compatible.
Like ``Open Browser`` is really recommented to use the Browser library ``New Browser/New Context/New Page`` or ``New Persistent Context`` instead.
===================================================
SeleniumStats
===================================================
We want to know which keywords are massively used in our community.
In the first step we would like to get this information to know which keywords are missing
in Browser Library.
Later we also will show you which of your keywords are already replaceable by Browser and
how to do so.
We appreciate your help!
|
How it works
------------
This small script analyzes your output.xml and creates a statistic over the usage of your
SeleniumLibrary Keywords.
It will check which Selenium Keywords are used, and how often they are called in general.
It also check how many different parents (Keywords, TestCases or TestSuites) calls this keyword
directly. This "parent" count is the number of places you may have to change when migrating later.
We never ever ever take any of your private or confidential data!
We also just uses hashes of the names of your
Tests and Keywords to sum up their appearance.
And also these hashes are never ever stored in any file.
The generated data/statistic are absolutely anonymous!
You will see all collected data as a statistics table when finished.
Like here:
.. code-block::
+----------------------------------+-------+---------+
| Keyword | count | parents |
+----------------------------------+-------+---------+
| Checkbox Should Be Selected | 10 | 2 |
| Checkbox Should Not Be Selected | 10 | 2 |
| Clear Element Text | 1 | 1 |
| Click Button | 4 | 4 |
| Click Element | 48 | 20 |
| Click Link | 18 | 10 |
| Close All Browsers | 30 | 16 |
| Close Browser | 15 | 8 |
| Element Text Should Be | 18 | 5 |
| Execute Javascript | 18 | 2 |
| Get Element Count | 8 | 1 |
| Get Location | 8 | 2 |
| Get Text | 40 | 9 |
| Get WebElement | 17 | 3 |
| Get WebElements | 10 | 3 |
| Go To | 30 | 19 |
| Input Password | 45 | 19 |
| Input Text | 47 | 21 |
| Location Should Be | 47 | 16 |
| Open Browser | 55 | 29 |
| Page Should Contain Element | 9 | 8 |
| Select Checkbox | 10 | 4 |
| Select From List By Label | 2 | 2 |
| Select From List By Value | 1 | 1 |
| Set Window Position | 2 | 2 |
| Switch Window | 16 | 1 |
| Title Should Be | 30 | 16 |
| Unselect Checkbox | 8 | 4 |
| Wait Until Element Is Visible | 27 | 9 |
| Wait Until Page Contains Element | 4 | 1 |
+----------------------------------+-------+---------+
Statistics File: /Source/robotframework-browser-migration/src/keyword_stats.json
Please upload the file to https://data.keyword-driven.de/index.php/s/SeleniumStats for full anonymity.
IP-Addresses or other personal data are not logged when uploading the file!
You can also mail it to mailto:rene@robotframework.org.
Thanks you very much for your support!
Your Browser-Team (Mikko, Tatu, Kerkko, Janne and René)
The easiest and most anonymous way to share these data with us, would be to upload the
``keyword_stats.json`` to https://data.keyword-driven.de/index.php/s/SeleniumStats .
We do not store any information of the one who uploaded it. No IP-Address! Nothing.
|
Usage
~~~~~
Call the SeleniumStats with the path to your ``output.xml`` as first argument.
The ``output.xml`` can also be from a dryrun!
``python -m SeleniumStats c:\\MyTests\\output.xml``
Then send us the ``keyword_stats.json`` please.
|
Thank you very much!!!
----------------------
The Browser-Team
Raw data
{
"_id": null,
"home_page": "https://github.com/Snooz82/robotframework-browser-migration",
"name": "robotframework-browser-migration",
"maintainer": "",
"docs_url": null,
"requires_python": ">=3.6",
"maintainer_email": "",
"keywords": "",
"author": "Ren\u00e9 Rohner(Snooz82)",
"author_email": "snooz@posteo.de",
"download_url": "https://files.pythonhosted.org/packages/ab/ca/0138c7464657c128aad165849790371b9e302b1fb4e515749f1428105751/robotframework-browser-migration-1.0.0.tar.gz",
"platform": null,
"description": "===================================================\nrobotframework-browser-migration\n===================================================\n\n\nThis project contains two things.\n\n1. A small script to analyze your SeleniumLibrary keywords unsed and create a statistic over\n the usage in your project.\n2. A migration layer library named `SeleniumLibraryToBrowser` that has ~80% of the SeleniumLibrary keywords implemented by Browser library.\n\n\nInstallation\n------------\n\nrun:\n\n``pip install robotframework-browser-migration``\n\nfor the migration layer library you also need Robot_Framework_Browser_ installed and initialized as well:\n\n``pip install robotframework-browser``\n\nand\n\n``rfbrowser init``\n\n.. _Robot_Framework_Browser: https://browserlibrary.org\n\n|\n\n===================================================\nSeleniumLibraryToBrowser\n===================================================\n\nPlease find the implemented keywords here in the Keyword_Documentation_.\n\n.. _Keyword_Documentation: https://snooz82.github.io/robotframework-browser-migration/?tag=IMPLEMENTED\n\nUsage:\n\n\n.. code:: robotframework\n\n *** Settings ***\n Library SeleniumLibraryToBrowser\n\n *** Test Cases ***\n My Test Case\n Open Browser https://robocon.io chrome\n Location Should Be https://robocon.io/\n ${hamburger}= Run Keyword And Return Status Element Should Be Visible css:.hamburger\n IF ${hamburger} Click Button css:.hamburger\n Click Link RBCN22\n Location Should Be https://robocon.io/2022\n Close All Browsers\n\n\nBe aware that some keywords will never be implemented and others are just barely compatible.\nLike ``Open Browser`` is really recommented to use the Browser library ``New Browser/New Context/New Page`` or ``New Persistent Context`` instead.\n\n\n===================================================\nSeleniumStats\n===================================================\n\nWe want to know which keywords are massively used in our community.\nIn the first step we would like to get this information to know which keywords are missing\nin Browser Library.\n\nLater we also will show you which of your keywords are already replaceable by Browser and\nhow to do so.\n\nWe appreciate your help!\n\n|\n\nHow it works\n------------\n\nThis small script analyzes your output.xml and creates a statistic over the usage of your\nSeleniumLibrary Keywords.\n\nIt will check which Selenium Keywords are used, and how often they are called in general.\nIt also check how many different parents (Keywords, TestCases or TestSuites) calls this keyword\ndirectly. This \"parent\" count is the number of places you may have to change when migrating later.\n\nWe never ever ever take any of your private or confidential data!\nWe also just uses hashes of the names of your\nTests and Keywords to sum up their appearance.\nAnd also these hashes are never ever stored in any file.\n\nThe generated data/statistic are absolutely anonymous!\n\nYou will see all collected data as a statistics table when finished.\n\nLike here:\n\n.. code-block::\n\n +----------------------------------+-------+---------+\n | Keyword | count | parents |\n +----------------------------------+-------+---------+\n | Checkbox Should Be Selected | 10 | 2 |\n | Checkbox Should Not Be Selected | 10 | 2 |\n | Clear Element Text | 1 | 1 |\n | Click Button | 4 | 4 |\n | Click Element | 48 | 20 |\n | Click Link | 18 | 10 |\n | Close All Browsers | 30 | 16 |\n | Close Browser | 15 | 8 |\n | Element Text Should Be | 18 | 5 |\n | Execute Javascript | 18 | 2 |\n | Get Element Count | 8 | 1 |\n | Get Location | 8 | 2 |\n | Get Text | 40 | 9 |\n | Get WebElement | 17 | 3 |\n | Get WebElements | 10 | 3 |\n | Go To | 30 | 19 |\n | Input Password | 45 | 19 |\n | Input Text | 47 | 21 |\n | Location Should Be | 47 | 16 |\n | Open Browser | 55 | 29 |\n | Page Should Contain Element | 9 | 8 |\n | Select Checkbox | 10 | 4 |\n | Select From List By Label | 2 | 2 |\n | Select From List By Value | 1 | 1 |\n | Set Window Position | 2 | 2 |\n | Switch Window | 16 | 1 |\n | Title Should Be | 30 | 16 |\n | Unselect Checkbox | 8 | 4 |\n | Wait Until Element Is Visible | 27 | 9 |\n | Wait Until Page Contains Element | 4 | 1 |\n +----------------------------------+-------+---------+\n\n Statistics File: /Source/robotframework-browser-migration/src/keyword_stats.json\n Please upload the file to https://data.keyword-driven.de/index.php/s/SeleniumStats for full anonymity.\n IP-Addresses or other personal data are not logged when uploading the file!\n You can also mail it to mailto:rene@robotframework.org.\n\n Thanks you very much for your support!\n Your Browser-Team (Mikko, Tatu, Kerkko, Janne and Ren\u00e9)\n\nThe easiest and most anonymous way to share these data with us, would be to upload the\n``keyword_stats.json`` to https://data.keyword-driven.de/index.php/s/SeleniumStats .\nWe do not store any information of the one who uploaded it. No IP-Address! Nothing.\n\n\n|\n\nUsage\n~~~~~\n\nCall the SeleniumStats with the path to your ``output.xml`` as first argument.\nThe ``output.xml`` can also be from a dryrun!\n\n``python -m SeleniumStats c:\\\\MyTests\\\\output.xml``\n\nThen send us the ``keyword_stats.json`` please.\n\n|\n\nThank you very much!!!\n----------------------\nThe Browser-Team\n\n",
"bugtrack_url": null,
"license": "",
"summary": "Some small helpers for migration of SeleniumLibrary to Browser",
"version": "1.0.0",
"project_urls": {
"Homepage": "https://github.com/Snooz82/robotframework-browser-migration"
},
"split_keywords": [],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "8b74657ab90f8755a1f4924313b40bb1d9a04ce74e6153777d3789fd952caa52",
"md5": "b3d100c7906b023552a8f219225cc527",
"sha256": "b23dbcc93b74011ac6ef3e9347a43f289418d3ce9118d477876d4318ca2f81b3"
},
"downloads": -1,
"filename": "robotframework_browser_migration-1.0.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "b3d100c7906b023552a8f219225cc527",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.6",
"size": 29633,
"upload_time": "2024-01-28T11:40:00",
"upload_time_iso_8601": "2024-01-28T11:40:00.267491Z",
"url": "https://files.pythonhosted.org/packages/8b/74/657ab90f8755a1f4924313b40bb1d9a04ce74e6153777d3789fd952caa52/robotframework_browser_migration-1.0.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "abca0138c7464657c128aad165849790371b9e302b1fb4e515749f1428105751",
"md5": "3db32ebe1f3a6592b6e7398cc5e50f7f",
"sha256": "5f07f428c21e2aac112b99d9b40e57c8d049ce03ba943c99ac5ce74079fc3914"
},
"downloads": -1,
"filename": "robotframework-browser-migration-1.0.0.tar.gz",
"has_sig": false,
"md5_digest": "3db32ebe1f3a6592b6e7398cc5e50f7f",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.6",
"size": 31279,
"upload_time": "2024-01-28T11:40:03",
"upload_time_iso_8601": "2024-01-28T11:40:03.007722Z",
"url": "https://files.pythonhosted.org/packages/ab/ca/0138c7464657c128aad165849790371b9e302b1fb4e515749f1428105751/robotframework-browser-migration-1.0.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-01-28 11:40:03",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "Snooz82",
"github_project": "robotframework-browser-migration",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "robotframework-browser-migration"
}
JSON
