NAME

Tapper::Reports::DPath - Tapper - Extended DPath functionality for Tapper reports

SYNOPSIS

   use Tapper::Reports::DPath 'reports_dpath_search';
   # the first bogomips entry of math sections:
   @resultlist = reportdata (
                    '{ suite_name => "TestSuite-LmBench" } :: /tap/section/math/*/bogomips[0]'
                 );
   # all report IDs of suite_id 17 that FAILed:
   @resultlist = reportdata (
                    '{ suite_name => "TestSuite-LmBench" } :: /suite_id[value == 17]/../successgrade[value eq 'FAIL']/../id'
                 );

#
# '{ "reportgrouptestrun.testrun_id" => 4711 } :: /suite_id[value == 17]/../successgrade[value eq 'FAIL']/../id
#
# '{ "reportgrouparbitrary.arbitrary_id" => "fc123a2" } :: /suite_id[value == 17]/../successgrade[value eq 'FAIL']/../id

This searches all reports of the test suite "TestSuite-LmBench" and furthermore in them for a TAP section "math" with the particular subtest "bogomips" and takes the first array entry of them.

The part before the '::' selects reports to search in a DBIx::Class search query, the second part is a normal Data::DPath expression that matches against the datastructure that is build from the DB.

API FUNCTIONS

reports_dpath_search

Takes an extended DPath expression, applies it to Tapper Reports with TAP::DOM structure and returns the matching results in an array.

rds

Alias for reports_dpath_search.

reportdata

Alias for reports_dpath_search.

UTILITY FUNCTIONS

cache_single_dpath

Cache a result for a raw dpath on a report id.

cached_single_dpath

Return cached result for a raw dpath on a report id.

cache_whole_dpath

Cache a result for a complete tapper::dpath on all reports.

cached_whole_dpath

Return cached result for a complete tapper::dpath on all reports.

AUTHORS

• AMD OSRC Tapper Team <tapper@amd64.org>

• Tapper Team <tapper-ops@amazon.com>

COPYRIGHT AND LICENSE

This software is Copyright (c) 2016 by Advanced Micro Devices, Inc..

This is free software, licensed under:

The (two-clause) FreeBSD License