Skip to main content
Warning: You are using the test version of PyPI. This is a pre-production deployment of Warehouse. Changes made here affect the production instance of TestPyPI (
Help us improve Python packaging - Donate today!

A tool for serializing Robot Framework test run results into an sqlite3 database.

Project Description

DbBot is a Python script to serialize Robot Framework produced test run results, i.e. output.xml files, into a SQLite database. This way the future Robot Framework related tools and plugins will have a unified storage for the test run results.


  • Python 2.6 or newer installed
  • Robot Framework 2.7 or newer installed

Robot Framework version 2.7.4 or later is recommended as versions prior to 2.7.4 do not support storing total elapsed time for test runs or tags.

Migrating from Robot Framework 2.7 to 2.8

In Robot Framework 2.8, output.xml has changed slightly. Due this, the databases created with 2.7 need to migrated to be 2.8 compatible.

To migrate the existing database, issue the following script:

bin/migrate27to28 -b <path_to_robot_results_db>

How it works

The script takes one or more output.xml files as input, initializes the database schema, and stores the respective results into a database (robot_results.db by default, can be changed with -b or –database).


The executable is ‘dbbot’ in directory ‘bin’. Run the script from command-line:

bin/dbbot [options]

Required options are:

Short format Long format Description
-f –files One or more Robot output.xml files

Additional options are:

Short format Long format Description
-k –also-keywords Parse also suites’ and tests’ keywords
-v –verbose Be verbose about the operation
-b DB_FILE_PATH –database=DB_FILE_PATH SQLite database for test run results (robot_results.db by default)
-d –dry-run Do everything except store the results

On Windows environments, you might need to rename the executable to have the ‘.py’ file extension (‘bin/dbbot’ -> ‘bin/’).

Usage examples

Typical usage with a single output.xml file:

dbbot -f atest/testdata/one_suite/output.xml

If the database does not already exist, it’s created. Otherwise the test results are just inserted into the existing database. Only new results are inserted.

The default database is a file named ‘robot_results.db’.

Specifying custom database name:

dbbot -f atest/testdata/one_suite/output.xml -b my_own_database.db

Parsing test run results with keywords included:

dbbot -k --files atest/testdata/one_suite/output.xml

Giving multiple test run result files at the same time:

dbbot --files atest/testdata/one_suite/output.xml atest/testdata/one_suite/output_latter.xml

What is stored

Both the test data (names, content) and test statistics (how many did pass or fail, possible errors occurred, how long it took to run, etc.) related to suites and test cases are stored by default. However, keywords are not stored by default as it might take tens of seconds for massive test runs. Keywords can be stored by using -k or –also-keywords flag.


You can inspect the created database using the ‘sqlite3’ command-line tool:

$ sqlite3 robot_results.db

sqlite> .tables
arguments        suite_status     test_run_errors  tests
keyword_status   suites           test_run_status
keywords         tag_status       test_runs
messages         tags             test_status

sqlite> SELECT count(),,
        FROM tests, test_status
        WHERE == test_status.test_id AND
        test_status.status == "FAIL"
        GROUP BY;

Please note that when database is initialized, no indices are created by DbBot. This is to avoid slowing down the inserts. You might want to add indices to the database by hand to speed up certain queries in your own scripts.

For information about the database schema, see ‘doc/’.

Directory structure

Directory Description
atests Robot Framework powered acceptance tests for DbBot. Also has some test data.
bin Contains the executables, mainly ‘dbbot’. You may want to append this directory to your PATH.
dbbot Contains the packages used by dbbot. You may want to append this directory to your PYTHONPATH if your scripts are inheriting the abstract classes in package ‘dbbot’
doc Mainly technical documentation about the database schema.
examples Examples that are using the DbBot created database and extending the ‘dbbot’ modules.

Use case: Most failing tests

One of the common use cases for DbBot is to get a report of the most commonly failing suites, tests and keywords. There’s an example for this purpose in ‘examples/FailBot/bin/failbot’.

Failbot is a Python script used to produce a summary web page of the failing suites, tests and keywords, using the information stored in the DbBot database. Please adjust (the barebone) HTML templates in ‘examples/FailBot/templates’ to your needs.

Another potential use case is to build a script to output the most time-consuming test cases, keywords etc.

Writing your own scripts

Please take a look at the modules in ‘examples/FailBot/failbot’ as an example on how to extend the DbBot provided classes to your own scripting needs.

You may also want to append the DbBot root directory to your PYTHONPATH if you are developing something that uses the classes.


DbBot is released under the Apache License, Version 2.0.

See LICENSE.TXT for details.

Release History

This version
History Node


History Node


Download Files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

File Name & Hash SHA256 Hash Help Version File Type Upload Date
(13.0 kB) Copy SHA256 Hash SHA256
Source Feb 28, 2014

Supported By

WebFaction WebFaction Technical Writing Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Heroku Heroku PaaS Kabu Creative Kabu Creative UX & Design Fastly Fastly CDN DigiCert DigiCert EV Certificate Rackspace Rackspace Cloud Servers DreamHost DreamHost Log Hosting