Smolder::DB::SmokeReport
Class::DBI based model class for the 'smoke_report' table in the database.
Each column in the borough table has a method with the same name that can be used as an accessor and mutator.
The following columns will return objects instead of the value contained in the table:
A DateTime object representing the datetime stored.
The Smolder::DB::Developer object who added this report
The Smolder::DB::Project object that this report is about
This method will add a tag to a given smoke report
$report->add_tag('foo');
This method will remove a tag from a given smoke report
$report->delete_tag('foo');
Returns a list of all of tags that have been added to this smoke report. (in the smoke_report_tag table).
# returns a simple list of scalars my @tags = $report->tags();
The directory in which the data files for this report reside. If it doesn't exist it will be created.
This returns the file name of where the full report file for this smoke report does (or will) reside. If the directory does not yet exist, it will be created.
A reference to the HTML text of this Test Report.
This method will return the HTML for the details of an individual test file. This is useful when you only need the details for some of the test files (such as an AJAX request).
It receives one argument, which is the index of the test file to show.
This method will return the file name that holds the recorded TAP stream given the index of that stream.
This method will delete all of the files that can be created and stored in association with a smoke test report (the 'data_dir' directory). It will croak if the files can't be deleted for some reason. Returns true if all is good.
croak
Returns a text string summarizing the whole test run.
Returns the total percentage of passed tests.
This method will take the name of the uploaded file and the project it's being added, and various other details and process them. If everything is successful then the resulting Smolder::DB::SmokeReport object will be returned.
If the given file is compressed, it will be uncompressed before being processed. After all processing is done, the details file will also be compressed.
It takes the following named arguments
The full path to the uploaded file. This is required.
The Smolder::DB::Project object that this report is being associated with. This is required.
The Smolder::DB::Developer who is uploading this file. If none is given, then the anonymous guest account will be used. This is optional.
The architecture this test was run on. This is optional.
The platform this test was run on. This is optional.
Any comments associated with this report. This is optional.
Look at all existing reports in the database and regenerate the HTML for each of these reports. This is useful for development and also upgrading when the report HTML template files have changed and you want that change to propagate.
To install Smolder, copy and paste the appropriate command in to your terminal.
cpanm
cpanm Smolder
CPAN shell
perl -MCPAN -e shell install Smolder
For more information on module installation, please visit the detailed CPAN module installation guide.