This repository contains the Robot Framework Demo workspace. The following topics are covered:

• Web Drivers: chromedriver, geckodriver
• Python 2.7
• Git
• Sublime Text 2 or any text editor
• Web browsers. Note the supported web browser version for web drivers

• git repository for your code - if you are running on Jenkins pipeline
• Jenkins war file
• Java
• [Sauce Labs] (https://saucelabs.com/)
• Docker
• docker-Selenium, dockerised Selenium Grid
• Report Portal
• Phabricator
• archanist, the command line tool for Phabricator

Note: This setup is for MacOS or Ubuntu. For windows, kindly setup these values in Environment Variables.

1. Download the web drivers

• Chromedriver
• Firefox

2. Extract the files in a local directory then run the following scripts:

# Chmod to executable file
chmod +x ~/Downloads/chromedriver

# Move the file from Downloads folder to share folder
sudo mv -f ~/Downloads/chromedriver /usr/local/share/chromedriver

# Create a symlink
sudo ln -s /usr/local/share/chromedriver /usr/local/bin/chromedriver

3. Do the same steps for geckodriver
4. Add the following in the bash_profile

# Edit bash_profile
sudo nano ~/.bash_profile

# Web drivers
export CHROMEDRIVER="/usr/local/bin/chromedriver"
export PATH=$PATH:$CHROMEDRIVER

export GECKODRIVER="/usr/local/bin/geckodriver"
export PATH=$PATH:$GECKODRIVER

5. Save the changes to bash_profile.
6. Source the bash_profile

source ~/.bash_profile

Clone this repository to your local directory. Open a terminal and cd to RobotFrameworkDemoWorkspace where setup.py is located. Run the following in the terminal:

pip install -e .

Or

sudo pip install -e .

Note: An error may sometimes occur, either rerun the pip install script or search and troubleshoot according to the error message.

Source your bash_profile via the following script in the terminal.

source ~/.bash_profile

Include the argument_file.txt found at the top-level directory for non-changing arguments on run time. To run a particular test suite, using the same terminal where the bash_profile was sourced, run the following:

robot --argumentfile argument_file.robot --variable BROWSER:chrome --variable BASE_URL:http://automationpractice.com --variable REMOTE_URL:False --suite AddProductToCartTest .

Tests may also be filtered using tags defined in a test suite's Default Tags, Force Tags or in the Test Case level tags setting table:

robot -A argument_file.robot -v BASE_URL:http://automationpractice.com -v BROWSER:chrome -v REMOTE_URL:False -v HEADLESS_CHROME:True -i REGRESSION .

Running in Headless Chrome. Set HEADLESS_CHROME to True.

robot -A argument_file.robot -v BASE_URL:http://automationpractice.com -v BROWSER:chrome -v HEADLESS_CHROME:True -i LoginTest .

Running in non-headless Chrome. Set HEADLESS_CHROME to False.

robot -A argument_file.robot -v BASE_URL:http://automationpractice.com -v BROWSER:chrome -v HEADLESS_CHROME:False -i DataDrivenLoginTest .

Or remove the variable HEADLESS_CHROME

robot -A argument_file.robot -v BASE_URL:http://automationpractice.com -v BROWSER:chrome -i DataDrivenLoginTest .

Running tests in firefox or other browsers, update the BROWSER value to the applicable browser.

robot -A argument_file.robot -v BASE_URL:http://automationpractice.com -v BROWSER:firefox -v REMOTE_URL:False -i DataDrivenLoginTest .

Running tests in Selenium Grid, set REMOTE_URL to TRUE or to Selenium Grid URI: http://localhost:4444/wd/hub NOTE: Run selenium grid first.

docker-compose -f DockerFiles/docker-compose.yml up

Then run the script on Remote URL using the following script.

robot -A argument_file.robot -v BASE_URL:http://automationpractice.com -v BROWSER:firefox -v REMOTE_URL:True -i DataDrivenLoginTest .

Or

robot -A argument_file.robot -v BASE_URL:http://automationpractice.com -v BROWSER:firefox -REMOTE_URL:http://localhost:4444/wd/hub -i DataDrivenLoginTest .

Running tests in Sauce Labs, set REMOTE_URL to the Saucelabs URI: saucelabs NOTE: Creat a Sauce Labs account then save the Sauce Labs Username and Access Key as environment variables.

GET SAUCELABS DETAILS:

1. Signup with Sauce Labs: https://saucelabs.com.
2. Sign in to Sauce Labs.
3. Click user icon on top right.
4. Go to User Settings > Click Show.
5. Input user password And click the Access key (which is then AutomAticAlly copied toclipboArd).
6. Get the Sauce labs remote URL.
7. Go to Dashboard > AUTOMATED TESTS tab And copy the URI in the instructions: http://ondemand.saucelabs.com/wd/hub.

Save the sauce labs credentials in bash_profile

export SAUCE_USERNAME="<your username>"
export PATH=$PATH:$SAUCE_USERNAME
export SAUCE_ACCESS_KEY="<your sauce labs access key>"
export PATH=$PATH:$SAUCE_ACCESS_KEY

Then run the script on Remote URL using the following script.

robot -A argument_file.robot -v BASE_URL:http://automationpractice.com -v BROWSER:firefox -v REMOTE_URL:http://ondemand.saucelabs.com/wd/hub -i DataDrivenLoginTest .

Note: This setup is for mac or ubuntu. For windows, kindly setup these values in Environment Variables

1. Download Jenkins war file.
2. Extract and move war file to /etc/jenkinswarfile directory.

sudo mv -f ~/Downloads/jenkins.war /etc/jenkinswarfile

3. Update bashrc or bash_profile

sudo nano ~/.bash_profile

4. Add the following in the bash_profile

# Jenkins
export JENKINWARFILE="/etc/jenkinswarfile"
export PATH=$PATH:$JENKINWARFILE
# Java
export JAVA_HOME_8_X64="/usr/bin/java"
export PATH=$PATH:$JAVA_HOME_8_X64

5. Save the changes to bash_profile.
6. Run Jenkins. Use any available port

java -jar jenkins.war --httpPort=9090

7. Open http://localhost:9090, then create a Pipeline. Go to New Item > Pipeline.
8. Enter a name in the Enter an item name textfield then click OK.
9. Scroll down and select Pipeline script from scm as Definition in the Pipeline section.
10. Select Git in the SCM field.
11. Fillout the Repository URL with your git workspace uri. For this example: https://github.com/enhanceTAfrancis/RobotFrameworkDemoWorkspace.git.
12. Fillout the Credentials field with your github credentials.
13. Fillout the Script Path text field. For this example: JenkinsFiles/pipelinetestrunner.
14. Click Save.
15. Build the pipeline you created. The build will initially fail.
16. Rerun the build, and the build button should now be Build with Parameters.
17. Click Build

1. Install Docker
2. Clone the docker-selenium repo.

git clone https://github.com/SeleniumHQ/docker-selenium.git

3. Build the images. cd to the docker-selenium directory, then run:

VERSION=local make build

4. Display all docker images and take note of the created images:

docker image ls

5. Run the hubs and nodes. cd to the RobotFrameworkDemoWorkspace\DockerFiles.

docker-compose -f docker-compose.yml up

Prerequisite: Sublime Text 2 is installed

1. Go to https://packagecontrol.io/installation
2. Download Package Control.sublime-package
3. Click the Preferences > Browse Packages… menu
4. Browse up a folder and then into the Installed Packages/ folder
5. Copy Package Control.sublime-package to Installed Packages/ folder
6. Restart Sublime Text 2
7. Click on Preferences > Package Control menu
8. Type Install Package then select Install Package from the list. Wait for the installation to complete.
9. After installation, another list will be displayed. Type Robot Framework Assistant and press Enter.
10. Restart Sublime.
11. Robot Framework Menu should be visible.