Merge pull request #990 from seleniumbase/recorder-mode-optimizations

Recorder Mode optimizations

Author: mdmintz

README.md

@@ -39,8 +39,8 @@
 <br />
 <a href="https://github.com/seleniumbase/SeleniumBase/blob/master/integrations/github/workflows/ReadMe.md">🤖 CI</a> |
 <a href="https://github.com/seleniumbase/SeleniumBase/blob/master/examples/presenter/ReadMe.md">🎞️ Slides</a> |
-<a href="https://github.com/seleniumbase/SeleniumBase/tree/master/examples/boilerplates">♻️ Boilerplates</a> |
 <a href="https://github.com/seleniumbase/SeleniumBase/blob/master/help_docs/translations.md">🌏 Translate</a> |
+<a href="https://github.com/seleniumbase/SeleniumBase/tree/master/examples/boilerplates">♻️ Boilerplates</a> |
 <a href="https://github.com/seleniumbase/SeleniumBase/blob/master/examples/tour_examples/ReadMe.md">🗺️ Tour</a> |
 <a href="https://github.com/seleniumbase/SeleniumBase/blob/master/examples/chart_maker/ReadMe.md">📶 Charts</a> |
 <a href="https://github.com/seleniumbase/SeleniumBase/blob/master/examples/dialog_boxes/ReadMe.md">🛂 DialogBox</a>

examples/test_hack_search.py

@@ -16,6 +16,12 @@ def test_hack_search(self):
         self.sleep(0.5)
         self.js_click('[value="Bing Search"]')
         self.highlight("h1.b_logo")
+        help_docs_install_link = 'a[href*="seleniumbase.io/help_docs/install"]'
+        if self.is_element_visible(help_docs_install_link):
+            self.highlight_click(help_docs_install_link)
+            self.switch_to_newest_window()
+            self.assert_text("Install SeleniumBase", "h1")
+            self.click_link_text("GitHub branch")
         self.highlight_click('a[href*="github.com/seleniumbase/SeleniumBase"]')
         self.switch_to_newest_window()
         self.assert_element('[href="/seleniumbase/SeleniumBase"]')

help_docs/install.md

@@ -1,4 +1,4 @@
-<a href="https://github.com/seleniumbase/SeleniumBase/blob/master/README.md"><img src="https://seleniumbase.io/cdn/img/sb_logo_b.png" alt="SeleniumBase" title="SeleniumBase" width="360" /></a>
+[<img src="https://seleniumbase.io/cdn/img/sb_logo_10t.png" title="SeleniumBase" width="220">](https://github.com/seleniumbase/SeleniumBase/)
 
 <h2><img src="https://seleniumbase.io/img/logo6.png" title="SeleniumBase" width="32" /> Installation</h2>
 
@@ -37,3 +37,7 @@ pip install git+https://github.com/seleniumbase/SeleniumBase.git@master#egg=sele
 > (Use ``pip3`` if multiple versions of Python are installed.)
 
 (If you're not using a virtual environment, you may need to add <code>--user</code> to your <code>pip</code> command if you're seeing errors during installation.)
+
+--------
+
+<a href="https://github.com/seleniumbase/SeleniumBase/"><img src="https://seleniumbase.io/cdn/img/sb_logo_b.png" alt="SeleniumBase" title="SeleniumBase" width="280" /></a>

help_docs/recorder_mode.md

@@ -58,6 +58,8 @@ class RecorderTest(BaseCase):
 
 <p>🔴 SeleniumBase <code>1.66.2</code> adds the ability to save selectors using the <code>":contains(TEXT)"</code> selector. If a Python file being recorded has multiple tests being run, then all those tests will get saved to the generated <code>*_rec.py</code> file. The Recorder will now save common <code>self.assert_*</code> calls made during tests. In order to escape iframes when using <code>self.set_content_to_frame(frame)</code>, a new method was added: <code>self.set_content_to_default()</code>. The <code>self.set_content_to_*()</code> methods will be automatically used in place of <code>self.switch_to_*()</code> methods in Recorder Mode, unless a test explicitly calls <code>self._rec_overrides_switch = False</code> before the <code>self.switch_to_*()</code> methods are called. Additionally, if an iframe contains the <code>src</code> attribute, that page will get loaded in a new tab when switching to it in Recorder Mode.</p>
 
+<p>🔴 SeleniumBase <code>1.66.3</code> improves the algorithm for generating efficient selectors. Additionally, single and double quotes in selectors will now be properly escaped with backslashes as needed.</p>
+
 --------
 
 <div>To learn more about SeleniumBase, check out the Docs Site:</div>

help_docs/syntax_formats.md

@@ -1,4 +1,4 @@
-<h3 align="left"><a href="https://github.com/seleniumbase/SeleniumBase/"><img src="https://seleniumbase.io/cdn/img/mac_sb_logo_3.png" title="SeleniumBase" width="360" /></a></h3>
+<h3 align="left"><a href="https://github.com/seleniumbase/SeleniumBase/"><img src="https://seleniumbase.io/cdn/img/mac_sb_logo_3.png" title="SeleniumBase" width="320" /></a></h3>
 
 <a id="syntax_formats"></a>
 <h2><img src="https://seleniumbase.io/img/green_logo.png" title="SeleniumBase" width="32" /> The 17 syntax formats</h2>
@@ -194,21 +194,22 @@ from seleniumbase.translate.chinese import 硒测试用例
 
 class 我的测试类(硒测试用例):
     def test_例子1(self):
-        self.开启网址("https://xkcd.in/comic?lg=cn&id=353")
-        self.断言标题("Python - XKCD中文站")
-        self.断言元素("#content div.comic-body")
-        self.断言文本("上漫画")
-        self.单击("div.nextLink")
-        self.断言文本("母亲的功绩", "#content h1")
-        self.单击链接文本("下一篇")
-        self.断言文本("敲打", "#content h1")
-        self.断言文本("有时，最有趣的事也会显得无聊")
-        self.回去()
-        self.单击链接文本("兰德尔·门罗")
-        self.断言文本("兰德尔·门罗", "#firstHeading")
-        self.输入文本("#searchInput", "程式设计")
+        self.开启("https://zh.wikipedia.org/wiki/")
+        self.断言标题("维基百科，自由的百科全书")
+        self.断言元素('a[title="首页"]')
+        self.断言文本("新闻动态", "span#新闻动态")
+        self.输入文本("#searchInput", "舞龍")
         self.单击("#searchButton")
-        self.断言文本("程序设计", "#firstHeading")
+        self.断言文本("舞龍", "#firstHeading")
+        self.断言元素('img[src*="Chinese_draak.jpg"]')
+        self.输入文本("#searchInput", "火鍋")
+        self.单击("#searchButton")
+        self.断言文本("火鍋", "#firstHeading")
+        self.断言元素('td:contains("火鍋的各種食材")')
+        self.输入文本("#searchInput", "精武英雄")
+        self.单击("#searchButton")
+        self.断言元素('img[src*="Fist_of_legend.jpg"]')
+        self.断言文本("李连杰", 'li a[title="李连杰"]')
 ```
 
 (See <a href="https://github.com/seleniumbase/SeleniumBase/blob/master/examples/translations/chinese_test_1.py">examples/translations/chinese_test_1.py</a> for the Chinese test.)

help_docs/translations.md

@@ -1,4 +1,4 @@
-<h3 align="left"><a href="https://github.com/seleniumbase/SeleniumBase/"><img src="https://seleniumbase.io/cdn/img/super_logo_m.png" title="SeleniumBase" width="300" /></a></h3>
+<h3 align="left"><a href="https://github.com/seleniumbase/SeleniumBase/"><img src="https://seleniumbase.io/cdn/img/mac_sb_logo_3.png" title="SeleniumBase" width="300" /></a></h3>
 
 <a id="language_tests"></a>
 <h3><img src="https://seleniumbase.io/img/logo6.png" title="SeleniumBase" width="32" /> Language Tests (Python 3+)</h3>
@@ -7,15 +7,26 @@
 
 Examples can be found in [<a href="https://github.com/seleniumbase/SeleniumBase/tree/master/examples/translations">SeleniumBase/examples/translations</a>].
 
-Multi-language tests are run with **pytest** like any other test. Every test method has a one-to-one mapping to every other supported language. <i>Example:</i>
-```
-self.open(URL) <=> self.开启网址(URL)
+Multi-language tests are run with **pytest** like any other test. Test methods have a one-to-one mapping to the other supported languages. Here's an example of a translated test:
+
+```python
+from seleniumbase.translate.chinese import 硒测试用例
+
+class 我的测试类(硒测试用例):
+    def test_例子1(self):
+        self.开启("https://zh.wikipedia.org/wiki/")
+        self.断言标题("维基百科，自由的百科全书")
+        self.断言元素('a[title="首页"]')
+        self.断言文本("新闻动态", "span#新闻动态")
+        self.输入文本("#searchInput", "舞龍")
+        self.单击("#searchButton")
+        self.断言文本("舞龍", "#firstHeading")
 ```
 
 <a id="translation_api"></a>
 <h2><img src="https://seleniumbase.io/img/logo6.png" title="SeleniumBase" width="32" /> Translation API</h2>
 
-You can use SeleniumBase to selectively translate the method names of any test from one language to another via the console scripts interface. Additionally, the ``import`` line at the top of the Python file will change to import the new ``BaseCase``. Example: ``BaseCase`` becomes ``CasoDeTeste`` when a test is translated into Portuguese.
+You can use SeleniumBase to selectively translate the method names of any test from one language to another with the console scripts interface. Additionally, the ``import`` line at the top of the Python file will change to import the new ``BaseCase``. Example: ``BaseCase`` becomes ``CasoDeTeste`` when a test is translated into Portuguese.
 
 ```bash
 seleniumbase translate
@@ -59,3 +70,7 @@ plus the 2-letter language code of the new language.
 (Example: Translating ``test_1.py`` into Japanese with
 ``-c`` will create a new file called ``test_1_ja.py``.)
 ```
+
+--------
+
+<h3 align="left"><a href="https://github.com/seleniumbase/SeleniumBase/"><img src="https://seleniumbase.io/cdn/img/super_logo_m.png" title="SeleniumBase" width="280" /></a></h3>

mkdocs.yml

@@ -142,4 +142,4 @@ extra:
   analytics:
     provider: google
     property: UA-167313767-1
-google_analytics: ['UA-167313767-1', 'seleniumbase.io']
+# google_analytics: ['UA-167313767-1', 'seleniumbase.io']

seleniumbase/__version__.py

@@ -1,2 +1,2 @@
 # seleniumbase package
-__version__ = "1.66.2"
+__version__ = "1.66.3"