Tests are functions that begin with ‘test’ and are located in Python modules in the test folder of a project.

To create a test first start a Golem test directory, if you don’t already have one, and add a project to it:

golem-admin createdirectory <directory_name>
cd <directory_name>
golem createproject <project_name>

Then add a test file inside that project:

golem createtest <project_name> <test_name>

A project and a test can also be created using the Web Module:

golem gui

Test Structure

description = ''

tags = []

pages = []

skip = False

def setup(data):

def test_one(data):

def test_two(data):

def teardown(data):

A test file must implement at least one test function that receives a data object as argument.

Multiple Tests per File

All test functions inside a test file are run in sequence. The data is shared between tests. The browser session is shared as well, unless a test explicitly closes the current open browser.

Test Data

Test data can be defined inside the file or in a separate CSV file. For detailed info about see: Test Data

CSV Data

It should be defined in a CSV file with the same name and in the same folder as the test.

Infile Test Data

A test can have data defined as a list of dictionaries.

data = [
        'url': 'http://url1.com',
        'title': 'title1'
        'url': 'http://url2.com',
        'title': 'title2'

def test(data):

Note: when saving a test using the Test Module, if the test_data setting is not ‘infile’, any data stored in the test will be moved to a CSV file.

Skip flag

A flag variable to indicate that this test should be skipped. It should be a boolean or a string to use as skip message. Note: tests will only be skipped when running from a suite.


A list of tags (strings). Tags can be used to filter tests when running a suite. See Filter Tests by Tags.

Implicit vs Explicit Imports

By default, the test runner imports the golem.actions module and any page module implicitly during the execution. Pages are saved as a list of strings. The GUI test builder complies with this format and generates code like the following:

pages = ['page1']

def test(data):

This behaviour can be turned off by setting implicit_actions_import and implicit_page_import to false.

Then, the test structure will be:

from golem import actions

from projects.<project_name>.pages import page1

def test(data):

GUI Test Builder and Imports Statements

The GUI test builder only supports import statements for the golem.actions module and any Python module inside the pages folder; and only when the implicit modes are turned off. Any other import statements will be discarded when saving a test from the GUI test builder.