Skip to content

Commit d139aa6

Browse files
committed
Move "selenium_ide" conversion tool to "seleniumbase/utilities"
1 parent be1723a commit d139aa6

File tree

5 files changed

+21
-30
lines changed

5 files changed

+21
-30
lines changed

integrations/katalon/ReadMe.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1 +1 @@
1-
## This page has been moved to: [../selenium_ide/ReadMe.md](https://github.com/seleniumbase/SeleniumBase/blob/master/integrations/selenium_ide/ReadMe.md)
1+
### The ReadMe for the Katalon / Selenium IDE conversion tool has been moved to: [seleniumbase/utilities/selenium_ide/ReadMe.md](https://github.com/seleniumbase/SeleniumBase/blob/master/seleniumbase/utilities/selenium_ide/ReadMe.md) and all related code has been moved to [seleniumbase/utilities/selenium_ide](https://github.com/seleniumbase/SeleniumBase/blob/master/seleniumbase/utilities/selenium_ide)

integrations/selenium_ide/ReadMe.md

Lines changed: 1 addition & 29 deletions
Original file line numberDiff line numberDiff line change
@@ -1,29 +1 @@
1-
## Converting Katalon/Selenium IDE recordings into SeleniumBase test scripts
2-
3-
[Katelon Recorder / Selenium IDE](https://www.katalon.com/resources-center/blog/katalon-automation-recorder/) (<i>the successor to the [old Selenium IDE](http://docs.seleniumhq.org/projects/ide/)</i>) is a tool that allows you to record and playback actions performed inside a web browser. It's available as a [downloadable Chrome extension](https://chrome.google.com/webstore/detail/katalon-recorder-selenium/ljdobmomdgdljniojadhoplhkpialdid) and a [downloadable Firefox extension](https://addons.mozilla.org/en-US/firefox/addon/katalon-automation-record/). Katelon Recorder comes with an option to export recordings as various WebDriver test scripts, one of which is ``Python 2 (WebDriver + unittest)``. Unfortunately, these natively-exported scripts can be very messy and don't always run reliably. The purpose of this converter is to clean up and improve the scripts so that they can be used in production-level environments.
4-
5-
#### Step 1: Make a recording with Katelon Recorder
6-
7-
![](https://cdn2.hubspot.net/hubfs/100006/images/katalon_recorder_2.png "Katelon Recorder example")
8-
9-
#### Step 2: Export your recording as a Python 2 Webdriver script
10-
11-
* ``{} Export`` => ``Python 2 (WebDriver + unittest)`` => ``Save As File``
12-
13-
#### Step 3: Drop your exported file into the ``selenium_ide`` folder
14-
15-
* Just copy & paste!
16-
17-
(The full path of the folder is ``SeleniumBase/integrations/selenium_ide``)
18-
19-
#### Step 4: Run ``convert_ide.py`` on the exported Python script
20-
21-
```bash
22-
python convert_ide.py [MY_TEST.py]
23-
```
24-
25-
You should see a [MY_TEST_SB.py] file appear in the folder. (``_SB`` is added to the file name so that the original file stays intact in case you still need it.)
26-
27-
#### Step 5: Enjoy your new clean & reliable SeleniumBase test script
28-
29-
* You can now copy your new SeleniumBase test script into your test suite. It's ready to be run!
1+
### The ReadMe for the Katalon / Selenium IDE conversion tool has been moved to: [seleniumbase/utilities/selenium_ide/ReadMe.md](https://github.com/seleniumbase/SeleniumBase/blob/master/seleniumbase/utilities/selenium_ide/ReadMe.md) and all related code has been moved to [seleniumbase/utilities/selenium_ide](https://github.com/seleniumbase/SeleniumBase/blob/master/seleniumbase/utilities/selenium_ide)
Lines changed: 19 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,19 @@
1+
## Converting Katalon/Selenium IDE recordings into SeleniumBase test scripts
2+
3+
[Katelon Recorder / Selenium IDE](https://www.katalon.com/resources-center/blog/katalon-automation-recorder/) (<i>the successor to the [old Selenium IDE](http://docs.seleniumhq.org/projects/ide/)</i>) is a tool that allows you to record and playback actions performed inside a web browser. It's available as a [downloadable Chrome extension](https://chrome.google.com/webstore/detail/katalon-recorder-selenium/ljdobmomdgdljniojadhoplhkpialdid) and a [downloadable Firefox extension](https://addons.mozilla.org/en-US/firefox/addon/katalon-automation-record/). Katelon Recorder comes with an option to export recordings as various WebDriver test scripts, one of which is ``Python 2 (WebDriver + unittest)``. Unfortunately, these natively-exported scripts can be very messy and don't always run reliably. The purpose of this converter is to clean up and improve the scripts so that they can be used in production-level environments.
4+
5+
#### Step 1: Make a recording with Katelon Recorder
6+
7+
![](https://cdn2.hubspot.net/hubfs/100006/images/katalon_recorder_2.png "Katelon Recorder example")
8+
9+
#### Step 2: Export your recording as a Python 2 Webdriver script
10+
11+
* ``{} Export`` => ``Python 2 (WebDriver + unittest)`` => ``Save As File``
12+
13+
#### Step 3: Run ``seleniumbase convert`` on your exported Python file
14+
15+
```
16+
seleniumbase convert [MY_TEST.py]
17+
```
18+
19+
* You should see a [MY_TEST_SB.py] file appear in the folder. (``_SB`` is added to the file name so that the original file stays intact in case you still need it.) This new clean & reliable SeleniumBase test script is ready to be added into your test suite for running.

0 commit comments

Comments
 (0)