{"id":4550,"date":"2016-08-11T12:20:38","date_gmt":"2016-08-11T16:20:38","guid":{"rendered":"https:\/\/qxf2.com\/blog\/?p=4550"},"modified":"2018-04-03T10:24:40","modified_gmt":"2018-04-03T14:24:40","slug":"pytest-and-browserstack","status":"publish","type":"post","link":"https:\/\/qxf2.com\/blog\/pytest-and-browserstack\/","title":{"rendered":"pytest and Browserstack"},"content":{"rendered":"

BrowserStack<\/a> is a cloud-based testing tool that enables developers\/testers to test their application across various browsers on different operating systems and mobile devices. We use Browserstack a lot at Qxf2<\/a> and recommend it to all our clients. We recently started using pytest<\/a> to run our tests. We were surprised how quick and easy it was to configure pytest to run our tests on Browserstack. We have decided to share how we were able to do it.<\/p>\n

\n

Overview<\/h3>\n

BrowserStack needs four pieces of information to start a test:
\na) the browser
\nb) the browser version
\nc) the operating system
\nd) the operating system version<\/p>\n

In this post, we’ll show you how to add these four pieces of information as command line parameters to pytest. While the task at hand is direct, we thought this topic would make a good backdrop for you to learn more about pytest. So throughout this blog post, we have sprinkled in some useful tips that will help you get comfortable with pytest. If you do not understand some of the terms we use – it’s ok! You can still integrate your tests to use pytest and BrowserStack by following the step by step guide and the detailed code samples.<\/p>\n

\n

How to configure pytest to work with BrowserStack<\/h3>\n

pytest can be configured to suit our testing needs. It implements all aspects of configuration, collection, running and reporting. For our problem, there is one term in pytest land that you need to become familiar with – fixtures. A test fixture<\/a> is simply something that a test must (or may) need to know before it can be executed from a known state. We are going to treat each independent piece of information that BrowserStack requires (e.g.: browser, browser version) as pytest fixtures<\/a>. Fixtures can be created for the parameters that are being used in the test function. These fixtures can be held in the test file or be held in a special conftest.py<\/code> file separately. The perk of having fixtures in a conftest.py<\/code> is that it can be used by my multiple tests.<\/p>\n

1. Create a conftest.py file<\/strong>
\nTo begin with, create a file called conftest.py<\/code> and place it in the root directory of your repository or code base. Your root directory is going to be the directory from which you kick off the py.test<\/code> command.<\/p>\n

2. Add a command line parameter to conftest.py<\/strong><\/p>\n

\r\n#Contents of the conftest.py file\r\ndef pytest_addoption(parser):\r\n    parser.addoption(\"-B\",\"--browser\",\r\n                      dest=\"browser\",\r\n                      default=\"firefox\",\r\n                      help=\"Browser. Valid options are firefox, ie and chrome\") \r\n<\/pre>\n
3. Add a fixture to conftest.py<\/strong><\/p>\n
\r\n@pytest.fixture\r\ndef browser():\r\n    \"pytest fixture for browser\"\r\n    return pytest.config.getoption(\"-B\") #Note how this ties to the newly added command line parameter\r\n<\/pre>\n
Everytime pytest sees browser<\/code> as the test function parameter it executes the pytest fixture which looks if any command line parameter has been provided, if no option is given pytest uses the default option that was mentioned when the option was added.<\/p>\n
We are almost done! Once you setup your conftest.py<\/code> to take in the browser version, os and os version – you are done with configuring pytest. You can see the completed conftest file (has fixtures for all four pieces of information that BrowserStack needs) in the ‘Putting it all together section’.<\/p>\n
\n
How to run a test on Browserstack<\/h3>\n
In this section we will show you how to modify your test so it works well with BrowserStack and pytest. Let us try running an example test to check the browser title and test the form in the Qxf2-selenium-tutorial-page<\/a> on Browserstack using pytest.<\/p>\n
If you are completely new to BrowserStack, you can get started with this post<\/a>. For the sake of completeness, we will show you a snippet required to get a webdriver and set useful capabilities<\/a>:<\/p>\n
\r\n#NOTE: This is highly simplified code to make this post illustrative\r\n#We do not use this code at clients\r\n#We use Driver_Factory to return apporpriate drivers within our framework\r\ndef get_webdriver(browser,browser_version,platform,os_version):\r\n    \"Run the test in browser stack browser stack flag is 'Y'\"\r\n    USERNAME = usename #We fetch values from a conf file in our framework we use on our clients\r\n    PASSWORD = accesskey\r\n    if browser.lower() == 'firefox':\r\n        desired_capabilities = DesiredCapabilities.FIREFOX\r\n    if browser.lower() == 'chrome':\r\n        desired_capabilities = DesiredCapabilities.CHROME\r\n    desired_capabilities['os'] = platform\r\n    desired_capabilities['os_version'] = os_version\r\n    desired_capabilities['browser_version'] = browser_version\r\n\r\n    return webdriver.Remote(command_executor='http:\/\/%s:%s@hub.browserstack.com:80\/wd\/hub'%(USERNAME,PASSWORD),\r\n                            desired_capabilities=desired_capabilities)\r\n<\/pre>\n
The get_webdriver<\/code> method gets the browser,browser_version,platform,os_version sets them as the desired capabilities and returns the appropriate webdriver.<\/p>\n
\n
Putting it all together:<\/h3>\n
We are including a sample test for you to checkout the pytest and BrowserStack integration. The test script looks like the code below:<\/p>\n
\r\n#NOTE: This is highly simplified code to make this post illustrative\r\n#We do not use this code at clients\r\n#Our framework uses the Page Object pattern\r\n\r\n#Contents of test_example_form.py\r\ndef test_example_form(browser,browserstack_flag,browser_version,platform,os_version):\r\n    \"Test example form\"\r\n\r\n    #Create an driver object\r\n    driver = get_webdriver(browser,browser_version,platform,os_version)\r\n    #Create variables to keep count of pass\/fail\r\n    pass_check_counter = 0\r\n    total_checks = 0\r\n    #Visit the tutorial page\r\n    driver.get('http:\/\/qxf2.com\/selenium-tutorial-main') \r\n    print \"The browser for this test it %s\"%browser\r\n    print \"The browser version is %s\"%browser_version\r\n    print \"The platform is %s\"%platform\r\n    print \"The os version is %s\"%os_version\r\n    #Check 1: Is the page title correct?\r\n    if(driver.title==\"Qxf2 Services: Selenium training main\"):\r\n        print \"\\n\"\r\n        print (\"Success: Title of the Qxf2 Tutorial page is correct\")\r\n        pass_check_counter += 1\r\n    else:\r\n        print (\"Failed: Qxf2 Tutorial page Title is incorrect\")\r\n    total_checks += 1 \r\n    #Check 2: Fill name, email and phone in the example form\r\n    total_checks += 1\r\n    name_field = driver.find_element_by_xpath(\"\/\/input[@type='name']\")\r\n    name_field.send_keys('Shivahari')\r\n    email_field = driver.find_element_by_xpath(\"\/\/input[@type='email']\")\r\n    email_field.send_keys('test@qxf2.com')\r\n    phone_field = driver.find_element_by_xpath(\"\/\/input[@type='phone']\")\r\n    phone_field.send_keys('9999999999')\r\n    submit_button = driver.find_element_by_xpath(\"\/\/button[@type='submit']\") #Click on the Click me button\r\n    try:\r\n        submit_button.click()\r\n        pass_check_counter += 1\r\n    except Exception,e:\r\n        print str(e)   \r\n    #Quit the browser window\r\n    driver.quit() \r\n    #Assert if the pass and fail check counters are equal\r\n    assert total_checks == pass_check_counter \r\n<\/pre>\n
The completed conftest.py<\/code> looks like this:<\/p>\n
\r\n#Contents of conftest.py\r\nimport pytest\r\nimport os\r\n\r\n@pytest.fixture\r\ndef browser():\r\n    \"pytest fixture for browser\"\r\n    return pytest.config.getoption(\"-B\")\r\n\r\n\r\n@pytest.fixture\r\ndef browserstack_flag():\r\n    \"pytest fixture for browserstack flag\"\r\n    return pytest.config.getoption(\"-M\")\r\n\r\n\r\n@pytest.fixture\r\ndef browser_version():\r\n    \"pytest fixture for browser version\"\r\n    return pytest.config.getoption(\"-V\") \r\n\r\n\r\n@pytest.fixture\r\ndef platform():\r\n    \"pytest fixture for platform\"\r\n    return pytest.config.getoption(\"-P\") \r\n\r\n\r\n@pytest.fixture\r\ndef os_version():\r\n    \"pytest fixture for os version\"\r\n    return pytest.config.getoption(\"-O\") \r\n\r\n\r\ndef pytest_addoption(parser):\r\n    parser.addoption(\"-B\",\"--browser\",\r\n                      dest=\"browser\",\r\n                      default=\"firefox\",\r\n                      help=\"Browser. Valid options are firefox, ie and chrome\") \r\n    parser.addoption(\"-M\",\"--browserstack_flag\",\r\n                      dest=\"browserstack_flag\",\r\n                      default=\"N\",\r\n                      help=\"Run the test in Browserstack: Y or N\")\r\n    parser.addoption(\"-V\",\"--ver\",\r\n                      dest=\"browser_version\",\r\n                      help=\"The version of the browser: a whole number\",\r\n                      default=45)\r\n    parser.addoption(\"-P\",\"--platform\",\r\n                      dest=\"platform\",\r\n                      help=\"The operating system: Windows 7, Linux\",\r\n                      default=\"Windows\")\r\n    parser.addoption(\"-O\",\"--os_version\",\r\n                      dest=\"os_version\",\r\n                      help=\"The operating system: xp, 7\",\r\n                      default=\"7\")\r\n<\/pre>\n
\n
Run the test:<\/h3>\n
To run the test use the command py.test<\/code>
\n\"pytest_test_run2\"<\/a>
\nYou can run this test on a different platform (say OS X Yosemite) using a different browser (say Chrome 50) by using the command:
\npy.test -B chrome -V 50 -P \"OS X\" -O Yosemite -M y<\/code><\/p>\n
\n
There you go,a detailed example to configure pytest and run tests on browserstack. Now try running the tests across different platforms,platform version,browsers and browser versions.<\/p>\n
If you liked what you read, know more about Qxf2<\/a>.<\/strong><\/p>\n
\n