Metadata-Version: 2.1
Name: robotframework-browser-migration
Version: 0.5.0
Summary: Some small helpers for migration of SeleniumLibrary to Browser
Home-page: https://github.com/Snooz82/robotframework-browser-migration
Author: René Rohner(Snooz82)
Author-email: snooz@posteo.de
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Operating System :: OS Independent
Classifier: Topic :: Software Development :: Testing
Classifier: Topic :: Software Development :: Testing :: Acceptance
Classifier: Framework :: Robot Framework
Requires-Python: >=3.6
Description-Content-Type: text/x-rst

===================================================
robotframework-browser-migration
===================================================

At the moment just a small statistics tool that helps the Browser-Team to implement
the right Keywords.

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!

|

Installation
------------

If you already have Python >= 3.6 with pip installed, you can simply
run:

``pip install robotframework-browser-migration``

If you have Python 2 ... i am very sorry! Please update!

|

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

    
