Files
UnrealEngineUWP/Engine/Source/Developer/AutomationController/Private/AutomationReportManager.h
2014-03-14 14:13:41 -04:00

89 lines
3.3 KiB
C++

// Copyright 1998-2014 Epic Games, Inc. All Rights Reserved.
/*=============================================================================
AutomationReportManager.h: Declares the FAutomationReportManager class.
=============================================================================*/
#pragma once
/**
* Wrapper class to obfuscate the hierarchy of tests
*/
class FAutomationReportManager
{
public:
/** default constructor */
FAutomationReportManager();
/** Clears out all reports */
void Empty();
/** Resets for the next run of tests */
void ResetForExecution();
/** Stops all tests from running */
void StopRunningTests();
/**
* Searches for the next test to execute
* @param bOutAllTestsComplete - Returns True if all tests for this device cluster have been completed
* @param ClusterIndex - Index of the platform reporting the results of this test. See AutomationDeviceClusterManager
* @param NumDevicesInCluster - The number of devices which are available in this cluster
*/
TSharedPtr<IAutomationReport> GetNextReportToExecute(bool& bOutAllTestsComplete, const int32 ClusterIndex, const int32 NumDevicesInCluster);
/**
* Ensures the nested tree exists ("blueprint.test.all") would have 3 levels other than the root
* @param TestInfo - Structure containing the test info
* @param ClusterIndex - Index of the platform reporting the results of this test. See AutomationDeviceClusterManager
* @return The automation report
*/
TSharedPtr<IAutomationReport> EnsureReportExists(FAutomationTestInfo& TestInfo, const int32 ClusterIndex);
/** Filters the visible tests based on name, status, speed */
void SetFilter( TSharedPtr< AutomationFilterCollection > InFilter );
/** gets array of filtered tests to display in the UI*/
TArray <TSharedPtr <IAutomationReport> >& GetFilteredReports();
/** Sets whether all visible tests are enabled or not */
void SetVisibleTestsEnabled(const bool bEnabled);
/** Returns number of tests that will be run */
int32 GetEnabledTestsNum () const;
/**
* Export the automation report
* @param FileExportTypeMask - The file export mask - errors, warning etc
* @param NumDeviceClusters - The number of devices in a cluster
*/
const bool ExportReport( uint32 FileExportTypeMask, const int32 NumDeviceClusters );
protected:
/**
* Used in report generation to find leaf reports
* @param InReport - The report to add
* @param NumDeviceClusters - The number of devices in a cluster
* @param ResultsLog - Message log to store the test results
* @param FileExportTypeMask - The file export mask - errors, warning etc
*/
void AddResultReport( TSharedPtr< IAutomationReport > InReport, const int32 NumDeviceClusters, TArray< FString >& ResultsLog, uint32 FileExportTypeMask );
/**
* Used in report generation to find leaf reports
* @param InReport - The parent report
* @param NumDeviceClusters - The number of devices in a cluster
* @param ResultsLog - Message log to store the test results
* @param FileExportTypeMask - The file export mask - errors, warning etc
*/
void FindLeafReport( TSharedPtr< IAutomationReport > InReport, const int32 NumDeviceClusters, TArray< FString >& ResultsLog, uint32 FileExportTypeMask );
private:
/** Root node of the hierarchy, just there to ensure little code duplication */
TSharedPtr <IAutomationReport> ReportRoot;
};