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/buildwise-samples

    The test project will be under /Users/YOU/work/projects/agiletravel-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