sjalloul / golem

A simple yet powerful test automation framework

Golem - Test Automation Framework

Intro

Automate end to end tests in minutes, not hours.

Golem is a complete test automation tool and framework for end-to-end testing. It creates powerful, robust and maintainable test suites, yet it is easy to pick up and learn even without a lot of programming knowledge. It is based on Selenium Webdriver and it can be extended using Python.

It can:

• Use the Page Object pattern
• Write tests with multi data sets (data-driven)
• Run tests in parallel.
• Test APIs
• Run tests remotely (Selenium Grid or a cloud testing provider)
• It can be executed from Jenkins or any other CI tool

It has:

• A complete GUI module (a web application) to write and execute tests
• A reporting engine and a web reports module
• An interactive console

---

Contents

• Screen Captures
• Pre-requisites
• Installation
• Quick Start
• Documentation
• Example Projects
• Roadmap
• License

Screen Captures

Test Builder

Test as Pure Python Code

Report Dashboard

Execution Report

Test Execution Detail

Pre-requisites

Basic knowledge of Selenium Webdriver is required. Check out this docs first.

Installation

Golem works with Python 3.4+

pip install golem-framework

Read the full installation guide here: http://golem-framework.readthedocs.io/en/latest/installation.html

Quick Start

Create a test directory anywhere in your machine

golem-admin createdirectory <test_directory>

Download the latest webdriver executables Note: Golem needs the latest webdrivers in order to work, by default, it will pick up the executables placed in the <test_directory>/drivers directory, this setting can be overriden from the settings. The latests versions of the webdrivers can be found here:

• Chrome: (https://sites.google.com/a/chromium.org/chromedriver/)
• Firefox: (https://github.com/mozilla/geckodriver/releases)

For more information check this page of the documentation.

Start the Web Module

cd <test_directory>
python golem.py gui

The Web Module can be accessed at http://localhost:5000/

By default, the following user is available: username: admin / password: admin

Documentation

Read the full documentation here: http://golem-framework.readthedocs.io/

Example Projects

Here is a repo with example working projects usign Golem: https://github.com/lucianopuccio/golem-demo

Roadmap

• Integrate with Appium for mobile testing
• Better integration with Sauce Labs
• Improve API test Golem actions
• Video recording

License

MIT