Merge pull request #512 from seleniumbase/chinese-translations

mdmintz · web-flow · commit 60928dd055c7 · 2020-03-16T01:34:07.000-04:00
Add Chinese language translations
diff --git a/.gitignore b/.gitignore
@@ -19,6 +19,8 @@ lib64
 __pycache__
 
 # Python3 pyvenv
+venv
+sbase
 pyvenv.cfg
 .Python
 include
diff --git a/README.md b/README.md
@@ -238,6 +238,8 @@ SeleniumBase provides additional Pytest command-line options for tests:
 --verify-delay=SECONDS  # (The delay before MasterQA verification checks.)
 --disable-csp  # (This disables the Content Security Policy of websites.)
 --enable-sync  # (The option to enable "Chrome Sync".)
+--no-sandbox  # (The option to enable Chrome's "No-Sandbox" feature.)
+--disable-gpu  # (The option to enable Chrome's "Disable GPU" feature.)
 --incognito  #  (The option to enable Chrome's Incognito mode.)
 --reuse-session  # (The option to reuse the browser session between tests.)
 --maximize-window  # (The option to start with the web browser maximized.)
diff --git a/azure-pipelines.yml b/azure-pipelines.yml
@@ -59,8 +59,8 @@ jobs:
   - script: python -m pytest examples/my_first_test.py --browser=chrome --headless -v -s --junit-xml=junit/test-results.xml
     displayName: 'Run pytest my_first_test.py --browser=chrome --headless'
 
-  - script: python -m pytest examples/test_inspect_html.py --browser=chrome --headless -v -s --junit-xml=junit/test-results.xml
-    displayName: 'Run pytest test_inspect_html.py --browser=chrome --headless'
+  #- script: python -m pytest examples/test_inspect_html.py --browser=chrome --headless -v -s --junit-xml=junit/test-results.xml
+  #  displayName: 'Run pytest test_inspect_html.py --browser=chrome --headless'
 
   #- task: PublishTestResults@2
   #  inputs:
diff --git a/examples/raw_parameter_script.py b/examples/raw_parameter_script.py
@@ -45,6 +45,8 @@
     sb.archive_logs = False
     sb.disable_csp = False
     sb.enable_sync = False
+    sb.no_sandbox = False
+    sb.disable_gpu = False
     sb._reuse_session = False
     sb.visual_baseline = False
     sb.maximize_option = False
diff --git a/examples/translations/ReadMe.md b/examples/translations/ReadMe.md
@@ -0,0 +1,4 @@
+[<img src="https://cdn2.hubspot.net/hubfs/100006/images/SeleniumBaseText_F.png" title="SeleniumBase" align="center" height="38">](https://github.com/seleniumbase/SeleniumBase/blob/master/README.md)
+### Multi-Language Tests
+
+#### (Python 3 Only!)
diff --git a/examples/translations/chinese_test_1.py b/examples/translations/chinese_test_1.py
@@ -0,0 +1,22 @@
+# Chinese Language Test - Python 3 Only!
+from seleniumbase.translate.chinese import 硒测试用例  # noqa
+
+
+class 测试类(硒测试用例):  # noqa
+
+    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.单击("#searchButton")
+        self.断言文本("程序设计", "#firstHeading")
diff --git a/help_docs/customizing_test_runs.md b/help_docs/customizing_test_runs.md
@@ -220,6 +220,8 @@ SeleniumBase provides additional Pytest command-line options for tests:
 --verify-delay=SECONDS  # (The delay before MasterQA verification checks.)
 --disable-csp  # (This disables the Content Security Policy of websites.)
 --enable-sync  # (The option to enable "Chrome Sync".)
+--no-sandbox  # (The option to enable Chrome's "No-Sandbox" feature.)
+--disable-gpu  # (The option to enable Chrome's "Disable GPU" feature.)
 --incognito  #  (The option to enable Chrome's Incognito mode.)
 --reuse-session  # (The option to reuse the browser session between tests.)
 --maximize-window  # (The option to start with the web browser maximized.)
diff --git a/help_docs/features_list.md b/help_docs/features_list.md
@@ -1,6 +1,6 @@
 [<img src="https://cdn2.hubspot.net/hubfs/100006/images/super_logo_i.png" title="SeleniumBase" height="48">](https://github.com/seleniumbase/SeleniumBase/blob/master/README.md)
 
-[<img src="http://img.youtube.com/vi/Sjzq9kU5kOw/0.jpg" title="SeleniumBase" height="150">](https://www.youtube.com/watch?v=Sjzq9kU5kOw)
+[<img src="http://img.youtube.com/vi/Sjzq9kU5kOw/0.jpg" title="SeleniumBase" height="180">](https://www.youtube.com/watch?v=Sjzq9kU5kOw)
 
 (**[Watch an overview on YouTube](https://www.youtube.com/watch?v=Sjzq9kU5kOw)**)
 
diff --git a/help_docs/method_summary.md b/help_docs/method_summary.md
@@ -166,6 +166,10 @@ self.activate_jquery()
 
 self.bring_to_front(selector, by=By.CSS_SELECTOR)
 
+self.highlight_click(selector, by=By.CSS_SELECTOR, loops=3, scroll=True)
+
+self.highlight_update_text(selector, new_value, by=By.CSS_SELECTOR, loops=3, scroll=True)
+
 self.highlight(selector, by=By.CSS_SELECTOR, loops=4, scroll=True)
 
 self.scroll_to(selector, by=By.CSS_SELECTOR)
diff --git a/seleniumbase/core/browser_launcher.py b/seleniumbase/core/browser_launcher.py
@@ -135,8 +135,8 @@ def _add_chrome_disable_csp_extension(chrome_options):
 def _set_chrome_options(
         downloads_path, headless,
         proxy_string, proxy_auth, proxy_user, proxy_pass,
-        user_agent, disable_csp, enable_sync, incognito,
-        user_data_dir, extension_zip, extension_dir, servername,
+        user_agent, disable_csp, enable_sync, no_sandbox, disable_gpu,
+        incognito, user_data_dir, extension_zip, extension_dir, servername,
         mobile_emulator, device_width, device_height, device_pixel_ratio):
     chrome_options = webdriver.ChromeOptions()
     prefs = {
@@ -220,9 +220,10 @@ def _set_chrome_options(
             # using Chrome's built-in headless mode. See link for details:
             # https://bugs.chromium.org/p/chromium/issues/detail?id=706008
             chrome_options.add_argument("--headless")
+    if headless or disable_gpu:
         chrome_options.add_argument("--disable-gpu")
-        if "linux" in PLATFORM:
-            chrome_options.add_argument("--no-sandbox")
+    if (headless and "linux" in PLATFORM) or no_sandbox:
+        chrome_options.add_argument("--no-sandbox")
     if "linux" in PLATFORM:
         chrome_options.add_argument("--disable-dev-shm-usage")
     return chrome_options
@@ -335,9 +336,10 @@ def validate_proxy_string(proxy_string):
 def get_driver(browser_name, headless=False, use_grid=False,
                servername='localhost', port=4444, proxy_string=None,
                user_agent=None, cap_file=None, disable_csp=None,
-               enable_sync=None, incognito=None, user_data_dir=None,
-               extension_zip=None, extension_dir=None, mobile_emulator=False,
-               device_width=None, device_height=None, device_pixel_ratio=None):
+               enable_sync=None, no_sandbox=None, disable_gpu=None,
+               incognito=None, user_data_dir=None, extension_zip=None,
+               extension_dir=None, mobile_emulator=False, device_width=None,
+               device_height=None, device_pixel_ratio=None):
     proxy_auth = False
     proxy_user = None
     proxy_pass = None
@@ -371,22 +373,23 @@ def get_driver(browser_name, headless=False, use_grid=False,
         return get_remote_driver(
             browser_name, headless, servername, port,
             proxy_string, proxy_auth, proxy_user, proxy_pass, user_agent,
-            cap_file, disable_csp, enable_sync, incognito, user_data_dir,
-            extension_zip, extension_dir, mobile_emulator,
-            device_width, device_height, device_pixel_ratio)
+            cap_file, disable_csp, enable_sync, no_sandbox, disable_gpu,
+            incognito, user_data_dir, extension_zip, extension_dir,
+            mobile_emulator, device_width, device_height, device_pixel_ratio)
     else:
         return get_local_driver(
             browser_name, headless, servername,
             proxy_string, proxy_auth, proxy_user, proxy_pass, user_agent,
-            disable_csp, enable_sync, incognito, user_data_dir,
-            extension_zip, extension_dir, mobile_emulator,
+            disable_csp, enable_sync, no_sandbox, disable_gpu, incognito,
+            user_data_dir, extension_zip, extension_dir, mobile_emulator,
             device_width, device_height, device_pixel_ratio)
 
 
 def get_remote_driver(
         browser_name, headless, servername, port, proxy_string, proxy_auth,
         proxy_user, proxy_pass, user_agent, cap_file, disable_csp,
-        enable_sync, incognito, user_data_dir, extension_zip, extension_dir,
+        enable_sync, no_sandbox, disable_gpu, incognito, user_data_dir,
+        extension_zip, extension_dir,
         mobile_emulator, device_width, device_height, device_pixel_ratio):
     downloads_path = download_helper.get_downloads_folder()
     download_helper.reset_downloads_folder()
@@ -397,8 +400,8 @@ def get_remote_driver(
     if browser_name == constants.Browser.GOOGLE_CHROME:
         chrome_options = _set_chrome_options(
             downloads_path, headless,
-            proxy_string, proxy_auth, proxy_user, proxy_pass,
-            user_agent, disable_csp, enable_sync, incognito,
+            proxy_string, proxy_auth, proxy_user, proxy_pass, user_agent,
+            disable_csp, enable_sync, no_sandbox, disable_gpu, incognito,
             user_data_dir, extension_zip, extension_dir, servername,
             mobile_emulator, device_width, device_height, device_pixel_ratio)
         capabilities = chrome_options.to_capabilities()
@@ -509,8 +512,8 @@ def get_remote_driver(
 def get_local_driver(
         browser_name, headless, servername,
         proxy_string, proxy_auth, proxy_user, proxy_pass, user_agent,
-        disable_csp, enable_sync, incognito, user_data_dir,
-        extension_zip, extension_dir,
+        disable_csp, enable_sync, no_sandbox, disable_gpu, incognito,
+        user_data_dir, extension_zip, extension_dir,
         mobile_emulator, device_width, device_height, device_pixel_ratio):
     '''
     Spins up a new web browser and returns the driver.
@@ -598,9 +601,10 @@ def get_local_driver(
             chrome_options = _set_chrome_options(
                 downloads_path, headless,
                 proxy_string, proxy_auth, proxy_user, proxy_pass, user_agent,
-                disable_csp, enable_sync, incognito, user_data_dir,
-                extension_zip, extension_dir, servername, mobile_emulator,
-                device_width, device_height, device_pixel_ratio)
+                disable_csp, enable_sync, no_sandbox, disable_gpu, incognito,
+                user_data_dir, extension_zip, extension_dir, servername,
+                mobile_emulator, device_width, device_height,
+                device_pixel_ratio)
             if LOCAL_EDGEDRIVER and os.path.exists(LOCAL_EDGEDRIVER):
                 try:
                     make_driver_executable_if_not(LOCAL_EDGEDRIVER)
@@ -652,9 +656,10 @@ def get_local_driver(
             chrome_options = _set_chrome_options(
                 downloads_path, headless,
                 proxy_string, proxy_auth, proxy_user, proxy_pass, user_agent,
-                disable_csp, enable_sync, incognito, user_data_dir,
-                extension_zip, extension_dir, servername, mobile_emulator,
-                device_width, device_height, device_pixel_ratio)
+                disable_csp, enable_sync, no_sandbox, disable_gpu, incognito,
+                user_data_dir, extension_zip, extension_dir, servername,
+                mobile_emulator, device_width, device_height,
+                device_pixel_ratio)
             if LOCAL_CHROMEDRIVER and os.path.exists(LOCAL_CHROMEDRIVER):
                 try:
                     make_driver_executable_if_not(LOCAL_CHROMEDRIVER)
diff --git a/seleniumbase/fixtures/base_case.py b/seleniumbase/fixtures/base_case.py
@@ -1374,8 +1374,9 @@ def switch_to_default_window(self):
     def get_new_driver(self, browser=None, headless=None,
                        servername=None, port=None, proxy=None, agent=None,
                        switch_to=True, cap_file=None, disable_csp=None,
-                       enable_sync=None, incognito=None, user_data_dir=None,
-                       extension_zip=None, extension_dir=None, is_mobile=False,
+                       enable_sync=None, no_sandbox=None, disable_gpu=None,
+                       incognito=None, user_data_dir=None, extension_zip=None,
+                       extension_dir=None, is_mobile=False,
                        d_width=None, d_height=None, d_p_r=None):
         """ This method spins up an extra browser for tests that require
             more than one. The first browser is already provided by tests
@@ -1391,6 +1392,8 @@ def get_new_driver(self, browser=None, headless=None,
             cap_file - the file containing desired capabilities for the browser
             disable_csp - an option to disable Chrome's Content Security Policy
             enable_sync - the option to enable the Chrome Sync feature (Chrome)
+            no_sandbox - the option to enable the "No-Sandbox" feature (Chrome)
+            disable_gpu - the option to enable Chrome's "Disable GPU" feature
             incognito - the option to enable Chrome's Incognito mode (Chrome)
             user_data_dir - Chrome's User Data Directory to use (Chrome-only)
             extension_zip - A Chrome Extension ZIP file to use (Chrome-only)
@@ -1444,6 +1447,10 @@ def get_new_driver(self, browser=None, headless=None,
             disable_csp = self.disable_csp
         if enable_sync is None:
             enable_sync = self.enable_sync
+        if no_sandbox is None:
+            no_sandbox = self.no_sandbox
+        if disable_gpu is None:
+            disable_gpu = self.disable_gpu
         if incognito is None:
             incognito = self.incognito
         if user_data_dir is None:
@@ -1481,6 +1488,8 @@ def get_new_driver(self, browser=None, headless=None,
                                                  cap_file=cap_file,
                                                  disable_csp=disable_csp,
                                                  enable_sync=enable_sync,
+                                                 no_sandbox=no_sandbox,
+                                                 disable_gpu=disable_gpu,
                                                  incognito=incognito,
                                                  user_data_dir=user_data_dir,
                                                  extension_zip=extension_zip,
@@ -4273,6 +4282,8 @@ def setUp(self, masterqa_mode=False):
             self.verify_delay = sb_config.verify_delay
             self.disable_csp = sb_config.disable_csp
             self.enable_sync = sb_config.enable_sync
+            self.no_sandbox = sb_config.no_sandbox
+            self.disable_gpu = sb_config.disable_gpu
             self.incognito = sb_config.incognito
             self.user_data_dir = sb_config.user_data_dir
             self.extension_zip = sb_config.extension_zip
@@ -4426,6 +4437,8 @@ def setUp(self, masterqa_mode=False):
                                               cap_file=self.cap_file,
                                               disable_csp=self.disable_csp,
                                               enable_sync=self.enable_sync,
+                                              no_sandbox=self.no_sandbox,
+                                              disable_gpu=self.disable_gpu,
                                               incognito=self.incognito,
                                               user_data_dir=self.user_data_dir,
                                               extension_zip=self.extension_zip,
diff --git a/seleniumbase/plugins/pytest_plugin.py b/seleniumbase/plugins/pytest_plugin.py
@@ -41,6 +41,8 @@ def pytest_addoption(parser):
     --verify-delay=SECONDS  (The delay before MasterQA verification checks.)
     --disable-csp  (This disables the Content Security Policy of websites.)
     --enable-sync  (The option to enable "Chrome Sync".)
+    --no-sandbox  (The option to enable Chrome's "No-Sandbox" feature.)
+    --disable_gpu  (The option to enable Chrome's "Disable GPU" feature.)
     --incognito  (The option to enable Chrome's Incognito mode.)
     --reuse-session  (The option to reuse the browser session between tests.)
     --maximize-window  (The option to start with the web browser maximized.)
@@ -319,6 +321,16 @@ def pytest_addoption(parser):
                      dest='enable_sync',
                      default=False,
                      help="""Using this enables the "Chrome Sync" feature.""")
+    parser.addoption('--no_sandbox', '--no-sandbox',
+                     action="store_true",
+                     dest='no_sandbox',
+                     default=False,
+                     help="""Using this enables the "No Sandbox" feature.""")
+    parser.addoption('--disable_gpu', '--disable-gpu',
+                     action="store_true",
+                     dest='disable_gpu',
+                     default=False,
+                     help="""Using this enables the "Disable GPU" feature.""")
     parser.addoption('--incognito',
                      action="store_true",
                      dest='incognito',
@@ -407,6 +419,8 @@ def pytest_configure(config):
     sb_config.verify_delay = config.getoption('verify_delay')
     sb_config.disable_csp = config.getoption('disable_csp')
     sb_config.enable_sync = config.getoption('enable_sync')
+    sb_config.no_sandbox = config.getoption('no_sandbox')
+    sb_config.disable_gpu = config.getoption('disable_gpu')
     sb_config.incognito = config.getoption('incognito')
     sb_config.reuse_session = config.getoption('reuse_session')
     sb_config.shared_driver = None  # The default driver for session reuse
diff --git a/seleniumbase/plugins/selenium_plugin.py b/seleniumbase/plugins/selenium_plugin.py
@@ -35,6 +35,8 @@ class SeleniumBrowser(Plugin):
     --verify-delay=SECONDS  (The delay before MasterQA verification checks.)
     --disable-csp  (This disables the Content Security Policy of websites.)
     --enable-sync  (The option to enable "Chrome Sync".)
+    --no-sandbox  (The option to enable Chrome's "No-Sandbox" feature.)
+    --disable_gpu  (The option to enable Chrome's "Disable GPU" feature.)
     --incognito  (The option to enable Chrome's Incognito mode.)
     --maximize-window  (The option to start with the web browser maximized.)
     --save-screenshot  (The option to save a screenshot after each test.)
@@ -250,6 +252,18 @@ def options(self, parser, env):
             dest='enable_sync',
             default=False,
             help="""Using this enables the "Chrome Sync" feature.""")
+        parser.add_option(
+            '--no_sandbox', '--no-sandbox',
+            action="store_true",
+            dest='no_sandbox',
+            default=False,
+            help="""Using this enables the "No Sandbox" feature.""")
+        parser.add_option(
+            '--disable_gpu', '--disable-gpu',
+            action="store_true",
+            dest='disable_gpu',
+            default=False,
+            help="""Using this enables the "Disable GPU" feature.""")
         parser.add_option(
             '--incognito',
             action="store_true",
@@ -321,6 +335,8 @@ def beforeTest(self, test):
         test.test.verify_delay = self.options.verify_delay  # MasterQA
         test.test.disable_csp = self.options.disable_csp
         test.test.enable_sync = self.options.enable_sync
+        test.test.no_sandbox = self.options.no_sandbox
+        test.test.disable_gpu = self.options.disable_gpu
         test.test.incognito = self.options.incognito
         test.test.maximize_option = self.options.maximize_option
         test.test.save_screenshot_after_test = self.options.save_screenshot
diff --git a/seleniumbase/translate/__init__.py b/seleniumbase/translate/__init__.py
diff --git a/seleniumbase/translate/chinese.py b/seleniumbase/translate/chinese.py
diff --git a/setup.py b/setup.py
