Sahi Tutorials
May 10, 2010

How to get started with Ruby Sahi and Cucumber

What is Cucumber?

Cucumber lets software development teams describe how software should behave in plain text. The text is written in a business-readable domain-specific language and serves as documentation, automated tests and development-aid - all rolled into one format.- From http://cukes.info/

Follow the steps below to get started with Ruby Sahi and Cucumber.

  1. Install Java
  2. Install Ruby
  3. Install cucumber:

    gem install cucumber
  4. Install Sahi proxy: Download Sahi from sourceforge and unzip to some location. (say D:sahi)
  5. Start Sahi:

    cd D:sahiuserdatabin
    start_sahi.bat
  6. Install Sahi Ruby client:

    gem install sahi
  7. Create a file D:testlogin.feature, add the content below and save it.

    Feature: Login
    In order to access the system
    As a user
    I want to be able to login

    Scenario: Login with valid credentials
    Given I am not logged in
    When I try to login with "test" and "secret"
    Then I should be logged in

    Scenario: Login with invalid credentials
    Given I am not logged in
    When I try to login with "test" and "wrongpassword"
    Then I should not be logged in
    And I should be shown error message "Invalid username or password"
  8. Run this feature:

    cd D:test
    cucumber login.feature


    There will be a lot of messages with hints on implementing the right steps.
  9. Implement the steps:

    Create a file D:testlogin.rb, add the content below and save it

    require  'sahi'
    def init_browser()
    #Use the correct paths from your system
    userdata_dir = "D:/sahi/userdata"browser_path = "C:\Program Files\Mozilla Firefox\firefox.exe"
    browser_options = "-profile #{userdata_dir}/browser/ff/profiles/sahi0 -no-remote"
    return Sahi::Browser.new(browser_path, browser_options)
    end
    #open the browser at the start
    browser = init_browser()
    browser.open
    #close the browser on exit
    at_exit do
    browser.close
    end
    Given /^I am not logged in$/ do
    browser.navigate_to("/demo/training/index.htm")
    end
    When /^I try to login with "([^"]*)" and "([^"]*)"$/ do |username, password|
    browser.textbox("user").value = username
    browser.password("password").value = password
    browser.submit("Login").clickend
    Then /^I should be logged in$/ do
    if !browser.button("Logout").exists?()
    raise "Not logged in"
    end
    end
    Then /^I should not be logged in$/ do
    if !browser.submit("Login").exists?()
    raise "Logged in"
    end
    end
    Then /^I should be shown error message "([^"]*)"$/ do |msg|
    value = browser.div("errorMessage").text()
    if value != msg
    raise "Incorrect message: #{value}"
    end
    end
  10. Run and watch the tests complete successfully

    cd D:test
    cucumber login.feature
  11. Done!

Continue reading

A Usual Day at the Office

Tip of the Day 9