Merge pull request #999 from seleniumbase/recorder-upgrade

Upgrade Recorder Mode, and more

Author: mdmintz

docs/requirements.txt

@@ -9,7 +9,7 @@ docutils==0.17.1
 python-dateutil==2.8.2
 keyring==23.2.1;python_version>="3.6"
 pkginfo==1.7.1;python_version>="3.6"
-Jinja2==3.0.1;python_version>="3.6"
+Jinja2==3.0.2;python_version>="3.6"
 click==8.0.1;python_version>="3.6"
 zipp==3.6.0;python_version>="3.6"
 readme-renderer==30.0

examples/parameterized_test.py

@@ -1,5 +1,5 @@
-from seleniumbase import BaseCase
 from parameterized import parameterized
+from seleniumbase import BaseCase
 
 
 class GoogleTests(BaseCase):

examples/test_hack_search.py

@@ -21,10 +21,10 @@ def test_hack_search(self):
             self.highlight_click(help_docs_install_link)
             self.assert_text("Install SeleniumBase", "h1")
             self.click_link_text("GitHub branch")
-        self.highlight_click('a[href*="github.com/seleniumbase/SeleniumBase"]')
+        self.highlight_click('a[href*="/seleniumbase/SeleniumBase"]')
         self.assert_element('[href="/seleniumbase/SeleniumBase"]')
         self.assert_true("seleniumbase/SeleniumBase" in self.get_current_url())
-        self.click('a[title="examples"]')
+        self.highlight_click('a[title="examples"]')
         self.assert_text("examples", "strong.final-path")
         self.highlight_click('[title="test_hack_search.py"]')
         self.assert_text("test_hack_search.py", "strong.final-path")

examples/test_skype_site.py

@@ -3,7 +3,7 @@
 Usage:  pytest test_skype_site.py --mobile --browser=edge
 
 Default mobile settings for User Agent and Device Metrics if not specified:
-        User Agent:   --agent="Mozilla/5.0 (Linux; Android 9; Pixel 3 XL)"
+        User Agent:   --agent="Mozilla/5.0 (Linux; Android 11; Pixel 4 XL)"
         CSS Width, CSS Height, Pixel-Ratio:   --metrics="411,731,3"
 """
 from seleniumbase import BaseCase
@@ -16,8 +16,6 @@ def test_skype_mobile_site(self):
             print('  (Use "--mobile" to run this test in Mobile Mode!)')
             self.skip('Use "--mobile" to run this test in Mobile Mode!')
         self.open("https://www.skype.com/en/")
-        self.assert_text("Install Skype", "div.appInfo")
-        self.highlight("div.appBannerContent")
         self.highlight('[itemprop="url"]')
         self.highlight("h1")
         self.highlight('[data-bi-area="meet-now-home-page"]')

examples/test_todomvc.py

@@ -0,0 +1,30 @@
+from parameterized import parameterized
+from seleniumbase import BaseCase
+
+
+class TodoMVC(BaseCase):
+    @parameterized.expand(
+        [
+            ["angularjs"],
+            ["mithril"],
+            ["react"],
+            ["vue"],
+        ]
+    )
+    def test_todomvc(self, framework):
+        self.open("https://todomvc.com/")
+        self.clear_local_storage()
+        self.click('a[href="examples/%s"]' % framework)
+        self.assert_element("section.todoapp")
+        new_todo_input = "input.new-todo"
+        todo_count_span = "span.todo-count"
+        self.type(new_todo_input, "Learn Python\n")
+        self.type(new_todo_input, "Learn JavaScript\n")
+        self.type(new_todo_input, "Learn SeleniumBase\n")
+        self.assert_text("3 items left", todo_count_span)
+        self.check_if_unchecked("ul.todo-list li input")
+        self.check_if_unchecked("ul.todo-list li:nth-of-type(2) input")
+        self.check_if_unchecked("ul.todo-list li:nth-of-type(3) input")
+        self.assert_text("0 items left", todo_count_span)
+        self.click('label[for="toggle-all"]')
+        self.assert_text("3 items left", todo_count_span)

help_docs/recorder_mode.md

@@ -6,10 +6,10 @@
 
 <img src="https://seleniumbase.io/cdn/img/sb_recorder_notification.png" title="SeleniumBase" width="380">
 
-🔴 To activate Recorder Mode, add ``--recorder`` to your ``pytest`` run command when running an existing test on Chrome or Edge. (Also add ``-s`` to allow breakpoints, unless you already have a ``pytest.ini`` file present with ``addopts = --capture=no`` in it.)
+🔴 To activate Recorder Mode, add ``--rec`` OR ``--record`` OR ``--recorder`` to your ``pytest`` run command when running an existing test on Chrome or Edge. (Also add ``-s`` to allow breakpoints, unless you already have a ``pytest.ini`` file present with ``addopts = --capture=no`` in it.)
 
 ```bash
-pytest TEST_NAME.py --recorder -s
+pytest TEST_NAME.py --rec -s
 ```
 
 🔴 To add manual actions, you'll need to create a breakpoint inside your test to activate "Debug Mode" while in "Recorder Mode": (For reference, "Debug Mode" is also known as the "ipdb debugger".)
@@ -23,7 +23,7 @@ import ipdb; ipdb.set_trace()
 🔴 You can also activate Debug Mode at the start of your test by adding ``--trace`` as a ``pytest`` command-line option:
 
 ```bash
-pytest TEST_NAME.py --trace --recorder -s
+pytest TEST_NAME.py --trace --rec -s
 ```
 
 🔴 Once you've reached the breakpoint, you can take control of the browser and add in any actions that you want recorded. When you are finished recording, type "``c``" on the command-line and press ``[Enter]`` to let the test continue from the breakpoint. After the test completes, a file called ``TEST_NAME_rec.py`` will be automatically created in the ``./recordings`` folder, which will include the actions performed by the test, and the manual actions that you added in. Below is a command-line notification:
@@ -42,7 +42,7 @@ pytest TEST_NAME.py --trace --recorder -s
 
 🔴 While a recording is in progress, you can hit the ``[ESC]`` key to pause the recording. To resume the recording, you can hit the ``[~`]`` key, which is located directly below the ``[ESC]`` key on most keyboards.
 
-<p>🔴 If you want to create a recording from scratch, just run:<br><code>pytest --recorder</code> on a Python file such as this one:</p>
+<p>🔴 If you want to create a recording from scratch, just run:<br><code>pytest --rec</code> on a Python file such as this one:</p>
 
 ```python
 from seleniumbase import BaseCase
@@ -56,7 +56,7 @@ class RecorderTest(BaseCase):
 
 <p>🔴 Recorder Mode works by saving your recorded actions into the browser's <code>sessionStorage</code>. SeleniumBase then reads from the browser's <code>sessionStorage</code> to take the raw data and generate a full test from it. Keep in mind that <code>sessionStorage</code> is only present for a website while the browser tab remains on a web page of the same domain/origin. If you leave that domain/origin, the <code>sessionStorage</code> of that tab will no longer have the raw data that SeleniumBase needs to create a full recording. To compensate for this, all links to web pages of a different domain/origin will automatically open a new tab for you while in Recorder Mode. Additionally, the SeleniumBase <code>self.open(URL)</code> method will also open a new tab for you in Recorder Mode if the domain/origin is different from the current URL. When the recorded test completes, SeleniumBase will scan the <code>sessionStorage</code> of all open browser tabs for the data it needs to generate the complete SeleniumBase automation script.</p>
 
-<p>🔴 If you just want to record actions on a single URL of a multi-URL test, you can call <code>self.activate_recorder()</code> from the test instead of using <code>pytest --recorder</code> from the command-line. When doing so, make sure that the browser tab is still on the same domain/origin at the end of the test, or else SeleniumBase will not have access to the <code>sessionStorage</code> data that it needs for generating a complete test.</p>
+<p>🔴 If you just want to record actions on a single URL of a multi-URL test, you can call <code>self.activate_recorder()</code> from within the test instead of using <code>pytest --rec</code> from the command-line. When doing so, make sure that the browser tab is still on the same domain/origin at the end of the test, or else SeleniumBase will not have access to the <code>sessionStorage</code> data that it needs for generating a complete test.</p>
 
 <p>🔴 (Note that <b>same domain/origin</b> is not the same as <b>same URL</b>. Example: <code>https://xkcd.com/353/</code> and <code>https://xkcd.com/1537/</code> are two different URLs with the <b>same domain/origin</b>. That means that both URLs will share the same <code>sessionStorage</code> data, and that any changes to <code>sessionStorage</code> from one URL will carry on to the <code>sessionStorage</code> of a different URL when the domain/origin is the same. If you want to find out a website's origin during a test, just call: <code>self.get_origin()</code>, which returns the value of <code>window.location.origin</code> from the browser's console.)</p>
 
@@ -72,10 +72,12 @@ class RecorderTest(BaseCase):
 
 <p>🔴 SeleniumBase <code>1.66.5</code> improves the algorithm for converting recorded actions into SeleniumBase code.</p>
 
-<p>🔴 SeleniumBase <code>1.66.6</code> adds more selector options and improves the algorithm for converting recorded actions into SeleniumBase code.</p>
+<p>🔴 SeleniumBase <code>1.66.6</code> improves the algorithm for converting recorded actions into SeleniumBase code.</p>
 
 <p>🔴 SeleniumBase <code>1.66.7</code> improves Recorder Mode post-processing and automatically adds <code>self.show_file_choosers()</code> if file-upload fields are hidden when calling <code>self.choose_file(selector, file_path)</code>.</p>
 
+<p>🔴 SeleniumBase <code>1.66.8</code> generates better selectors in Recorder Mode and improves the algorithm for converting recorded actions into SeleniumBase code.</p>
+
 --------
 
 <div>To learn more about SeleniumBase, check out the Docs Site:</div>

requirements.txt

@@ -69,7 +69,8 @@ beautifulsoup4==4.9.3;python_version<"3.5"
 beautifulsoup4==4.10.0;python_version>="3.5"
 cryptography==2.9.2;python_version<"3.5"
 cryptography==3.2.1;python_version>="3.5" and python_version<"3.6"
-cryptography==3.4.8;python_version>="3.6"
+cryptography==3.4.8;python_version>="3.6" and python_version<"3.7"
+cryptography==35.0.0;python_version>="3.7"
 pygments==2.5.2;python_version<"3.5"
 pygments==2.10.0;python_version>="3.5"
 traitlets==4.3.3;python_version<"3.7"
@@ -111,7 +112,8 @@ pdfminer.six==20201018;python_version>="3.5"
 
 coverage==5.5;python_version<"3.6"
 coverage==6.0;python_version>="3.6"
-pytest-cov==2.12.1
+pytest-cov==2.12.1;python_version<"3.6"
+pytest-cov==3.0.0;python_version>="3.6"
 flake8==3.7.9;python_version<"3.5"
 flake8==3.9.2;python_version>="3.5"
 pyflakes==2.1.1;python_version<"3.5"

seleniumbase/__version__.py

@@ -1,2 +1,2 @@
 # seleniumbase package
-__version__ = "1.66.7"
+__version__ = "1.66.8"