Run Lettuce Tests in Parallel

On BrowserStack, you can run multiple Lettuce tests at the same time across various browser, device and OS combinations. This is called Parallel Testing. Parallel Testing gives you the same benefits as running a multi-threaded application.

With Parallel Testing, you can run the same test on different browser/device combinations i.e. cross-browser testing, or run different tests on the same or different browser/device combinations. Parallel Testing will help you reduce the run time of your test suite, resulting in faster build times and faster releases.

Run sample test in parallel

1. Clone the lettuce-browserstack sample repo on GitHub, if not already done:
   
   

   git clone https://github.com/browserstack/lettuce-browserstack.git
   cd lettuce-browserstack
   

2. Install the dependencies using pip install -r requirements.txt

3. Setup your credentials and browser/devices where you want to run your test, in the lettuce-browserstack/config/parallel.json file as shown below:
   
   

    {
      "server": "hub.browserstack.com",
      "user": "YOUR_USERNAME",
      "key": "YOUR_ACCESS_KEY",
   
      "capabilities": {
        "build": "lettuce-browserstack",
        "name": "parallel_test",
        "browserstack.debug": true
      },
   
      "environments": [{
        "browser": "chrome"
      },{
        "browser": "firefox"
      },{
        "browser": "safari"
      },{
        "browser": "internet explorer"
      }]
    }
   

4. Capabilities for each environment can be customized. You can generate custom capabilities for your tests using our capability builder. For example:
   
   

   "capabilities": {
        "build": "lettuce-browserstack",
        "name": "parallel_test",
        "browserstack.debug": "true",
        "resolution": "1920x1080"
      },
   "environments": [{
        "browser": "chrome",
        "browser_version": "latest",
        "os": "Windows",
        "os_version": "10"
      },{
        "browser": "firefox",
        "browser_version": "latest-beta",
        "os": "Windows",
        "os_version": "10"
      },{
        "device": "iPhone 12 Pro",
        "real_mobile": "true",
        "os": "iPhone"
      },{
        "device": "Samsung Galaxy S20 Ultra",
        "real_mobile": "true",
        "os": "Android"
      }]
   

5. You can now run your tests in parallel on BrowserStack using the following command:

   paver run parallel
   

You can visit BrowserStack Automate Dashboard and see your test there once it has successfully completed.