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.
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)
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 is also based on Ruby language.
sudo gem install --no-rdoc --no-ri cucumber
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 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
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
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.
Sample Cucumber test:
Sample Pytest (or Python unittest):
Sample Mocha test: