Merge pull request #334 from seleniumbase/timeout-feature

Timeout feature

Author: mdmintz

README.md

@@ -39,7 +39,7 @@ cd SeleniumBase
 pip install -r requirements.txt
 python setup.py develop
 ```
-* ("``pip install -e .``" also works from the top-level SeleniumBase folder.)
+* "``pip install -e .``" also works from the top-level SeleniumBase folder.
 
 You can also install a specific GitHub branch of SeleniumBase:
 ```
@@ -52,17 +52,18 @@ SeleniumBase can download a web driver to the [seleniumbase/drivers](https://git
 ```
 seleniumbase install chromedriver
 ```
-* (You need a different web driver for each web browser you want to run automation on: ``chromedriver`` for Chrome, ``edgedriver`` for Edge, ``geckodriver`` for Firefox, ``operadriver`` for Opera, and ``iedriver`` for Internet Explorer.)
+* You need a different web driver for each web browser you want to run automation on: ``chromedriver`` for Chrome, ``edgedriver`` for Edge, ``geckodriver`` for Firefox, ``operadriver`` for Opera, and ``iedriver`` for Internet Explorer.
 
 ### <img src="https://cdn2.hubspot.net/hubfs/100006/images/super_square_logo_3a.png" title="SeleniumBase" height="32"> Run a test on Chrome:
 ```
 cd examples
 pytest my_first_test.py --browser=chrome
 ```
-* (Chrome is the default browser if not specified with ``--browser``)
+* Chrome is the default browser if not specified with ``--browser=BROWSER``.
+* You MUST add ``--headless`` for your tests to run on a headless machine (No GUI). You can also run in headless mode on any machine.
 
 **Check out [my_first_test.py](https://github.com/seleniumbase/SeleniumBase/blob/master/examples/my_first_test.py) to see what a simple test looks like:**
-* (<i>By default, [CSS Selectors](https://www.w3schools.com/cssref/css_selectors.asp) are used for finding page elements.</i>)
+* <i>By default, [CSS Selectors](https://www.w3schools.com/cssref/css_selectors.asp) are used for finding page elements.</i>
 
 ## <img src="https://cdn2.hubspot.net/hubfs/100006/images/super_square_logo_3a.png" title="SeleniumBase" height="32"> Learn More:
 

examples/timeout_test.py

@@ -0,0 +1,15 @@
+""" This test fails on purpose to demonstrate the timeout feature
+    for tests that run longer than the time limit specified. """
+
+import pytest
+import time
+from seleniumbase import BaseCase
+
+
+class MyTestClass(BaseCase):
+
+    @pytest.mark.expected_failure
+    @pytest.mark.timeout(6)  # The test will fail if it runs longer than this
+    def test_timeout_failure(self):
+        self.open("https://xkcd.com/1658/")
+        time.sleep(7)

requirements.txt

@@ -13,10 +13,11 @@ pluggy>=0.12.0
 pytest>=4.6.3
 pytest-cov>=2.7.1
 pytest-forked>=1.0.2
-pytest-html>=1.21.0
+pytest-html>=1.21.1
 pytest-metadata>=1.8.0
 pytest-ordering>=0.6
 pytest-rerunfailures>=7.0
+pytest-timeout>=1.3.3
 pytest-xdist>=1.29.0
 parameterized>=0.7.0
 beautifulsoup4>=4.6.0
@@ -25,5 +26,5 @@ colorama>=0.4.1
 pyotp>=2.2.7
 boto>=2.49.0
 flake8>=3.7.7
-certifi>=2019.3.9
+certifi>=2019.6.16
 PyVirtualDisplay==0.2.1

seleniumbase/console_scripts/sb_install.py

@@ -19,8 +19,10 @@
 import shutil
 import sys
 import tarfile
+import urllib3
 import zipfile
 from seleniumbase import drivers  # webdriver storage folder for SeleniumBase
+urllib3.disable_warnings()
 DRIVER_DIR = os.path.dirname(os.path.realpath(drivers.__file__))
 
 

seleniumbase/core/browser_launcher.py

@@ -4,6 +4,7 @@
 import sys
 import threading
 import time
+import urllib3
 import warnings
 from selenium import webdriver
 from selenium.common.exceptions import WebDriverException
@@ -17,6 +18,7 @@
 from seleniumbase.fixtures import page_utils
 from seleniumbase import drivers  # webdriver storage folder for SeleniumBase
 from seleniumbase import extensions  # browser extensions storage folder
+urllib3.disable_warnings()
 DRIVER_DIR = os.path.dirname(os.path.realpath(drivers.__file__))
 EXTENSIONS_DIR = os.path.dirname(os.path.realpath(extensions.__file__))
 DISABLE_CSP_ZIP_PATH = "%s/%s" % (EXTENSIONS_DIR, "disable_csp.zip")

seleniumbase/fixtures/base_case.py

@@ -30,6 +30,7 @@ def test_anything(self):
 import re
 import sys
 import time
+import urllib3
 import unittest
 import uuid
 from selenium.common.exceptions import (StaleElementReferenceException,
@@ -53,6 +54,7 @@ def test_anything(self):
 from seleniumbase.fixtures import page_actions
 from seleniumbase.fixtures import page_utils
 from seleniumbase.fixtures import xpath_to_css
+urllib3.disable_warnings()
 ENI_Exception = selenium_exceptions.ElementNotInteractableException
 
 

setup.py

@@ -17,7 +17,7 @@
 
 setup(
     name='seleniumbase',
-    version='1.23.15',
+    version='1.23.16',
     description='Reliable Browser Automation & Testing Framework',
     long_description=long_description,
     long_description_content_type='text/markdown',
@@ -66,10 +66,11 @@
         'pytest>=4.6.3',
         'pytest-cov>=2.7.1',
         'pytest-forked>=1.0.2',
-        'pytest-html>=1.21.0',
+        'pytest-html>=1.21.1',
         'pytest-metadata>=1.8.0',
         'pytest-ordering>=0.6',
         'pytest-rerunfailures>=7.0',
+        'pytest-timeout>=1.3.3',
         'pytest-xdist>=1.29.0',
         'parameterized>=0.7.0',
         'beautifulsoup4>=4.6.0',  # Keep at >=4.6.0 while using "bs4"
@@ -78,7 +79,7 @@
         'pyotp>=2.2.7',
         'boto>=2.49.0',
         'flake8>=3.7.7',
-        'certifi>=2019.3.9',
+        'certifi>=2019.6.16',
         'PyVirtualDisplay==0.2.1',  # Keep at 0.2.1 (later versions are slow)
     ],
     packages=[