BuildWise

Continuous Testing Server with Functional UI test execution in parallel

Version 1.3.0
All Platforms

BuildWise Agent for Mac

BuildWise Agent Mac Edition is packaged in a standard DMG file. To install, downoad and open the DMG file, drag BuildWise app to Applications folder.

Agent setting

BuildWise Agent configuration files:

  • /Users/YOU/.buildwise/agent-config.xml: the configuration file

  • /Users/YOU/.buildwise/agent-license.key: license key (if entered)

  • /Users/YOU/.buildwise/agent-test-results: test results saved under

Detect test frameworks

BuildWise has built-in tool to help identifying the framworks currently installed on your agent machine. Firstly, under Settings tab, make sure the PATH (in which BuildWise Agent finds executables to run tests) is valid. Feel free to update.

Click Detect button under Frameworks tab.

If detected, the version of frameworks (and its location) will be displayed.

If not, verify the execution PATH or read the next section to install required frameworks.

Install Test frameworks

To let BuildWise Agent execute your tests, besides Agent, prerequisites are:

  • Your test scripts (checked out from Git)
  • Test frameworks such as Selenium WebDriver and RSpec, plus extra libraries used in your test scripts
  • Browser driver, such as chromedriver (download and put it PATH, typically under /usr/local/bin)

RSpec

Ruby comes with Mac OS X. Run the command below to install Selenium WebDriver and RSpec. If you using Ruby version management software such as rbenv, the sudo may be optional.

sudo gem install --no-rdoc --no-ri selenium-webdriver rspec rspec_junit_formatter

Note: make sure you have Xcode and its command line tools are up to date with OS.

Cucumber

Cucumber is also based on Ruby language.

sudo gem install --no-rdoc --no-ri cucumber

Pytest

Pytest supports running Python unittest.py style tests, plus extra features. After Python 3 is installed (using brew install python3), run the commands below to install.

pip3 install selenium
pip install -U pytest
pip install xmlrunner

Mocha

Mocha is a popular JS test framework. After installing Node.js (using brew install node), run the commands below

npm install -g mocha
npm install -g mocha-junit-reporter

Verify test execution in BuildWise Agent

Sample projects

To make it easy for you to verify, you can use one of sample projects hosted on Github. We suggest you verifying with the sample project first, then your own test scripts.

Assume your working directory is /Users/YOU/work/projects, run the command below to clone the test scripts.

git clone https://github.com/testwisely/agiletravel-ui-tests

The test project will be under /Users/YOU/work/projectsagiletravel-ui-tests.

Verify RSpec

Enter a sample test script file, such as /Users/zhimin/work/projects/agiletravel-ui-tests/selenium-webdriver-rspec/spec/login_spec.rb, click Run Test button. You shall see test execution in a newly opened Chrome browser window.

Verify Cucumber

Sample Cucumber test: /Users/zhimin/work/projects/agiletravel-ui-tests/selenium-webdriver-cucumber/features/login.feature

Verify Pytest

Sample Pytest (or Python unittest): /Users/zhimin/work/projects/agiletravel-ui-tests/selenium-webdriver-python-unittest/test/login_test.py

Verify Mocha

Sample Mocha test: /Users/zhimin/work/projects/agiletravel-ui-tests/selenium-webdriver-nodejs-mocha/spec/login_spec.js