interface#

class api_filters(combine_mode=None)#

Bases: object

property compmap#

add(*, field, comparison, value)#

asdict()#

class server(baseurl, project)#

Bases: object

build_api_url(*, path, query=None)#

upload(*, filename, sitename, buildname, buildstamp, mdf5=False)#

Upload the file filename to CDash

Parameters:

filename (str) – The path to the file to upload
sitename (str) – The CDash site name
buildname (str) – The CDash build name
buildstamp (str) – The CDash build stamp

static put(url, file)#

static get(url, raw=False)#: Get the response from the CDash API and parse it using the json library

buildid(*, sitename, buildstamp, buildname)#

Get the build ID for the CDash build

Parameters:

sitename (str) – The CDash site name
buildstamp (str) – The CDash build stamp
buildname (str) – The CDash build name

Returns:

The integer build ID if found, else None

Return type:

buildid

static contains(site_name, sites_to_skip)#

builds(*, date=None, buildgroups=None, skip_sites=None)#

Get all of the CDash builds on (optional) date

Parameters:

date (str) – The build date formatted as YYYY-MM-DD
buildgroups (list[str]) – Build groups to pull down from CDash
skip_sites – List of sites to skip. Can be a python regular expression to skip matching sites. Eg, ‘ascic10?’ would match ascic101 but not ascic165.

get_buildgroups(date, buildgroups=None)#

failed_tests(*, date=None, buildgroups=None, skip_sites=None, skip_missing=False, skip_timeout=False)#

Get all failed tests from CDash server

Parameters:

date (str) – Get results from this date
buildgroups (list[str]) – List of build groups to retrieve. Defaults to all
skip_missing (bool) – Skip missing tests
skip_sites (list[str]) – Skip tests at these sites
skip_timeout (bool) – Skip timed out tests

Returns:

failed[n] is a dictionary describing the nth failed test

Return type:

failed

tests(*, date=None, buildgroups=None, skip_missing=False, skip_sites=None, include_details=True)#

Get all failed tests from CDash server

Parameters:

date (str) – Get results from this date
buildgroups (list[str]) – List of build groups to retrieve. Defaults to all
bool (skip_missing) – Skip missing tests
skip_sites (list[str]) – Skip tests at these sites
include_details (bool) – Return details of each test (slow)

Returns:

tests[n] is a dictionary describing the nth test

Return type:

tests (list)

get_failed_tests(build, fail_reason=None, skip_missing=False, include_details=True)#

Get failed tests from CDash

Parameters:

fail_reason (str) – The reason for the failure
skip_missing (bool) – Skip missing tests
include_details (bool) – Return details of each test (slow)

Returns:

list of dict describing the ith failed test

get_tests_from_build(build, skip_missing=False, include_details=True, **kwargs)#

fill_test_details(test)#

static empty_test_data()#

get_text(el: Element) → str#

clean_log_event(event)#: Convert log output from ASCII to Unicode and escape for XML

escapexml(text)#: Convert text from ASCII to Unicode and escape for XML

no_proxy()#: Context manager removing proxy variables from the environment.

Notes#

For the SEMs CDash server, it is necessary to remove proxy settings from the environment in order to upload data.

checksum(hashlib_algo, filename, **kwargs)#: Returns a hex digest of the filename generated using an algorithm from hashlib.

urlescape(item)#

find_build_type(configure, build)#

test_build_type()#

interface#

Notes#