/*

* Copyright (c) 2005-2009 Nokia Corporation and/or its subsidiary(-ies).

* All rights reserved.

* This component and the accompanying materials are made available

* under the terms of "Eclipse Public License v1.0"

* which accompanies this distribution, and is available

* at the URL "http://www.eclipse.org/legal/epl-v10.html".

*

* Initial Contributors:

* Nokia Corporation - initial contribution.

*

* Contributors:

*

* Description:  

*

*/

// INCLUDE FILES

// For TEF

#include "scriptengine.h"

#include <test/testexecuteclient.h>

#include <test/testexecutelogger.h>

#include "testwatcher.h"

#include "version.h"

#include "tefutils.h"

#include <f32file.h>

#include <test/wrapperutilsplugin.h>

// For STIF

#include <StifTestInterface.h>

#include "teftestmodule.h"

#include "SettingServerClient.h"

#include "logging.h"

GLDEF_D TInt CScriptControl::commentedCommandsCount;

GLDEF_D TInt CScriptControl::iRunScriptFailCount;

// EXTERNAL DATA STRUCTURES

//extern  ?external_data;

// EXTERNAL FUNCTION PROTOTYPES  

//extern ?external_function( ?arg_type,?arg_type );

// CONSTANTS

//const ?type ?constant_var = ?constant;

// MACROS

//#define ?macro ?macro_def

// LOCAL CONSTANTS AND MACROS

//const ?type ?constant_var = ?constant;

//#define ?macro_name ?macro_def

// MODULE DATA STRUCTURES

//enum ?declaration

//typedef ?declaration

// LOCAL FUNCTION PROTOTYPES

//?type ?function_name( ?arg_type, ?arg_type );

// FORWARD DECLARATIONS

//class ?FORWARD_CLASSNAME;

// ============================= LOCAL FUNCTIONS ===============================

// -----------------------------------------------------------------------------

// ?function_name ?description.

// ?description

// Returns: ?value_1: ?description

//          ?value_n: ?description_line1

//                    ?description_line2

// -----------------------------------------------------------------------------

//

/*

?type ?function_name(

    ?arg_type arg,  // ?description

    ?arg_type arg)  // ?description

    {

    ?code  // ?comment

    // ?comment

    ?code

    }

*/

// ============================ MEMBER FUNCTIONS ===============================

// -----------------------------------------------------------------------------

// CTEFTestModule::CTEFTestModule

// C++ default constructor can NOT contain any code, that

// might leave.

// -----------------------------------------------------------------------------

//

CTEFTestModule::CTEFTestModule()

    {

    }

// -----------------------------------------------------------------------------

// CTEFTestModule::ConstructL

// Symbian 2nd phase constructor can leave.

// Note: If OOM test case uses STIF Logger, then STIF Logger must be created

// with static buffer size parameter (aStaticBufferSize). Otherwise Logger 

// allocates memory from heap and therefore causes error situations with OOM 

// testing. For more information about STIF Logger construction, see STIF Users 

// Guide.

// -----------------------------------------------------------------------------

//

void CTEFTestModule::ConstructL()

    {

    //Read logger settings to check whether test case name is to be

    //appended to log file name.

    RSettingServer settingServer;

    TInt ret = settingServer.Connect();

    if(ret != KErrNone)

        {

        User::Leave(ret);

        }

    // Struct to StifLogger settigs.

    TLoggerSettings loggerSettings; 

    // Parse StifLogger defaults from STIF initialization file.

    ret = settingServer.GetLoggerSettings(loggerSettings);

    if(ret != KErrNone)

        {

        User::Leave(ret);

        } 

    // Close Setting server session

    settingServer.Close();

    iAddTestCaseTitleToLogName = loggerSettings.iAddTestCaseTitle;

    iStdLog = CStifLogger::NewL( KTEFTestModuleLogPath, 

                          KTEFTestModuleLogFile);

    iLog = iStdLog;

    iVersionLogged = EFalse;

    iCfg_tcs = EOFF;

    iCfg_Debug = EFalse;

    iCfg_SeparateLog = EFalse;

    }

// -----------------------------------------------------------------------------

// CTEFTestModule::NewL

// Two-phased constructor.

// -----------------------------------------------------------------------------

//

CTEFTestModule* CTEFTestModule::NewL()

    {

    CTEFTestModule* self = new (ELeave) CTEFTestModule;

    CleanupStack::PushL( self );

    self->ConstructL();

    CleanupStack::Pop();

    return self;

    }

// Destructor

CTEFTestModule::~CTEFTestModule()

    { 

    iLog = NULL;

    delete iStdLog;

    iStdLog = NULL;

    delete iTCLog;

    iTCLog = NULL;

    iArray_ScriptFilePaths.Close();

    iArray_Cfg_TcsData.Close();

    }

// -----------------------------------------------------------------------------

// CTEFTestModule::InitL

// InitL is used to initialize the Test Module.

// -----------------------------------------------------------------------------

//

TInt CTEFTestModule::InitL( 

    TFileName& /*aIniFile*/, 

    TBool /*aFirstTime*/ )

    {

    return KErrNone;

    }

// -----------------------------------------------------------------------------

// CTEFTestModule::CreateTitleLoggerL

// Check for settings and create logger with test case title in file name.

// -----------------------------------------------------------------------------

//

void CTEFTestModule::CreateTitleLoggerL(void)

    {

    //Open new log file with test case title in file name

    if(iAddTestCaseTitleToLogName)

        {

        // Check if there is no test case logger already created.

        if(iTCLog) 

            { 

            delete iTCLog; 

            iTCLog = NULL; 

            } 

        TFileName logFileName;

        TName title;

        TestModuleIf().GetTestCaseTitleL(title);

        logFileName.Format(KTEFTestModuleLogFileWithTitle, &title);

        iTCLog = CStifLogger::NewL(KTEFTestModuleLogPath, 

                                 logFileName);

        iLog = iTCLog; 

        }

    }

// -----------------------------------------------------------------------------

// CTEFTestModule::CreateStdLoggerL

// Check for logger settings and create standard logger.

// -----------------------------------------------------------------------------

//

void CTEFTestModule::DeleteTitleLogger(void)

    {

    //Delete title logger

    if(iAddTestCaseTitleToLogName)

        {

        iLog = iStdLog;

        delete iTCLog;

        iTCLog = NULL;

        }

    }

// -----------------------------------------------------------------------------

// CTEFTestModule::GetTestCasesL

// GetTestCases is used to inquire test cases from the Test Module. Test

// cases are stored to array of test cases. The Test Framework will be 

// the owner of the data in the RPointerArray after GetTestCases return

// and it does the memory deallocation. 

// -----------------------------------------------------------------------------

//

TInt CTEFTestModule::GetTestCasesL( 

    const TFileName& aConfig, 

    RPointerArray<TTestCaseInfo>& aTestCases )

    {

    iLog->Log(_L("GetTestCasesL"));

    TInt ret = KErrNone;

    TRAPD(err, ret = ParseTEFTestCfgFileL(aConfig, aTestCases));

    if(err != KErrNone)

    	{

    	//ret = KErrNotFound;

    	_LIT(KErrLog, "Error in given test configuration file %S. Error = %d.");

    	iLog->Log(CStifLogger::ERed, KErrLog, &aConfig, ret);

    	}

    return ret;

    }

// -----------------------------------------------------------------------------

// CTEFTestModule::RunTestCaseL

// RunTestCaseL is used to run an individual test case specified 

// by aTestCase. Test cases that can be run may be requested from 

// Test Module by GetTestCases method before calling RunTestCase.

// -----------------------------------------------------------------------------

//

TInt CTEFTestModule::RunTestCaseL(

    const TInt aCaseNumber,

    const TFileName& /*aConfig*/,

    TTestResult& aResult )

    {

    iLog->Log(_L("RunTestCaseL"));

    SendTestModuleVersion();

    CreateTitleLoggerL();

    //Test case implementation or function call here

    TRAPD(err, TEFInitialize() );

    __ASSERT_ALWAYS(!err, User::Panic(KTestExecuteName,err));

#if (defined __DATA_CAGING__)

	// Platform security hooks    

	RProcess().DataCaging(RProcess::EDataCagingOn);

	RProcess().SecureApi(RProcess::ESecureApiOn);

#endif

	CActiveScheduler* sched = new (ELeave) CActiveScheduler();

	CleanupStack::PushL(sched);

	CActiveScheduler::Install(sched);

    if(!sched)

    {

    __RDEBUG( (_L("Error: TEFTestModule.dll, Error in getting current active scheduler.") ) );

	iLog->Log(CStifLogger::ERed, _L("Error: TEFTestModule.dll, Error in getting current active scheduler."));

    User::Panic(_L("TEFTestModule"), -2);

    }

	TInt scriptCount = iArray_ScriptFilePaths.Count();

	TInt tcsDataCount = iArray_Cfg_TcsData.Count();

	if(aCaseNumber > scriptCount)

		{

		__RDEBUG( (_L("Error: Case number to run is bigger than expected.") ) );

		iLog->Log(CStifLogger::ERed, _L("Error: Case number to run is bigger than expected."));

		// Cleanup the scheduler object

		CleanupStack::PopAndDestroy(sched);

		DeleteTitleLogger();

		User::Leave(KErrNotFound);

		}

	TRAPD(errRun, RunScriptL(	sched,

								*(iArray_ScriptFilePaths[aCaseNumber-1]), 

								*(iArray_Cfg_TcsData[aCaseNumber-1])

							) );

	if (errRun != KErrNone)

		{

		__RDEBUG( (_L("Run script leave. code=%d"),errRun) );

		iLog->Log(CStifLogger::ERed, _L("Run script leave. code=%d"),errRun);

		}

	// Cleanup the scheduler object

	CleanupStack::PopAndDestroy(sched);

    aResult.SetResult( errRun, *(iArray_ScriptFilePaths[aCaseNumber-1]) );     

    // Test case was executed

    DeleteTitleLogger();

    return KErrNone;

    }

// -----------------------------------------------------------------------------

// CTEFTestModule::OOMTestQueryL

// Used to check if a particular test case should be run in OOM conditions and 

// which memory allocations should fail.    

//

// NOTE: This method is virtual and must be implemented only if test case

// should be executed using OOM conditions.  

// -----------------------------------------------------------------------------

//

TBool CTEFTestModule::OOMTestQueryL( 

                                const TFileName& /* aTestCaseFile */, 

                                const TInt /* aCaseNumber */, 

                                TOOMFailureType& /* aFailureType */, 

                                TInt& /* aFirstMemFailure */, 

                                TInt& /* aLastMemFailure */ ) 

    {

    _LIT( KOOMTestQueryL, "CTEFTestModule::OOMTestQueryL" );

    iLog->Log( KOOMTestQueryL ); 

    return EFalse;

    }

// -----------------------------------------------------------------------------

// CTEFTestModule::OOMTestInitializeL

// Used to perform the test environment setup for a particular OOM test case. 

// Test Modules may use the initialization file to read parameters for Test 

// Module initialization but they can also have their own configure file or 

// some other routine to initialize themselves.  

//

// NOTE: This method is virtual and must be implemented only if test case

// should be executed using OOM conditions.  

// -----------------------------------------------------------------------------

//

void CTEFTestModule::OOMTestInitializeL( 

                                const TFileName& /* aTestCaseFile */, 

                                const TInt /* aCaseNumber */ )

    {

    }

// -----------------------------------------------------------------------------

// CTEFTestModule::OOMHandleWarningL

// In some cases the heap memory allocation should be skipped, either due to

// problems in the OS code or components used by the code being tested, or even 

// inside the tested components which are implemented this way on purpose (by 

// design), so it is important to give the tester a way to bypass allocation 

// failures.

//

// NOTE: This method is virtual and must be implemented only if test case

// should be executed using OOM conditions.  

// -----------------------------------------------------------------------------

//

void CTEFTestModule::OOMHandleWarningL( 

                                const TFileName& /* aTestCaseFile */,

                                const TInt /* aCaseNumber */, 

                                TInt& /* aFailNextValue */ )

    {

    }

// -----------------------------------------------------------------------------

// CTEFTestModule::OOMTestFinalizeL

// Used to perform the test environment cleanup for a particular OOM test case.

//

// NOTE: This method is virtual and must be implemented only if test case

// should be executed using OOM conditions.  

// -----------------------------------------------------------------------------

//                  

void CTEFTestModule::OOMTestFinalizeL( 

                                const TFileName& /* aTestCaseFile */, 

                                const TInt /* aCaseNumber */ )

    {

    }

//-----------------------------------------------------------------------------

// CTemplateScriptTEFTestModule::SendTestModuleVersion

// Method used to send version of test module

//-----------------------------------------------------------------------------

//

void CTEFTestModule::SendTestModuleVersion()

	{

	if(iVersionLogged)

		{

		return;

		}

	TVersion moduleVersion;

	moduleVersion.iMajor = TEST_MODULE_VERSION_MAJOR;

	moduleVersion.iMinor = TEST_MODULE_VERSION_MINOR;

	moduleVersion.iBuild = TEST_MODULE_VERSION_BUILD;

	TFileName moduleName;

	moduleName = _L("TEFTestModule.dll");

	TBool newVersionOfMethod = ETrue;

	TestModuleIf().SendTestModuleVersion(moduleVersion, moduleName, newVersionOfMethod);

	iVersionLogged = ETrue;

	}

// ========================== OTHER EXPORTED FUNCTIONS =========================

// -----------------------------------------------------------------------------

// LibEntryL is a polymorphic Dll entry point

// Returns: CTestModuleBase*: Pointer to Test Module object

// -----------------------------------------------------------------------------

//

EXPORT_C CTestModuleBase* LibEntryL()

    {

    return CTEFTestModule::NewL();

    }

// -----------------------------------------------------------------------------

// SetRequirements handles test module parameters(implements evolution

// version 1 for test module's heap and stack sizes configuring).

// Returns: TInt: Symbian error code.

// -----------------------------------------------------------------------------

//

EXPORT_C TInt SetRequirements( CTestModuleParam*& aTestModuleParam, 

                                TUint32& aParameterValid )

    {

    /* --------------------------------- NOTE ---------------------------------

    USER PANICS occurs in test thread creation when:

    1) "The panic occurs when the value of the stack size is negative."

    2) "The panic occurs if the minimum heap size specified is less

       than KMinHeapSize".

       KMinHeapSize: "Functions that require a new heap to be allocated will

       either panic, or will reset the required heap size to this value if

       a smaller heap size is specified".

    3) "The panic occurs if the minimum heap size specified is greater than

       the maximum size to which the heap can grow".

    Other:

    1) Make sure that your hardware or Symbian OS is supporting given sizes.

       e.g. Hardware might support only sizes that are divisible by four.

    ------------------------------- NOTE end ------------------------------- */

    // Normally STIF uses default heap and stack sizes for test thread, see:

    // KTestThreadMinHeap, KTestThreadMinHeap and KStackSize.

    // If needed heap and stack sizes can be configured here by user. Remove

    // comments and define sizes.

    aParameterValid = KStifTestModuleParameterChanged;

    CTestModuleParamVer01* param = CTestModuleParamVer01::NewL();

    //We're quite heavy on the stack...

    // Stack size

    param->iTestThreadStackSize= 28672; // 28K stack

    // Heap sizes

    param->iTestThreadMinHeap = 4096;   // 4K heap min

    param->iTestThreadMaxHeap = 1260480;// 1.2M heap max

    TInt stackSizeFromUser = -1;

    TInt parseErr = KErrNone;

    TRAPD( err, parseErr = CTEFTestModule::ParseStackSizeL(stackSizeFromUser));

    if(err != KErrNone)

    	{

    	__RDEBUG( (_L("Error: Leaves when get StackSize from TestFramework.ini") ) );

    	}

    if(parseErr != KErrNone)

    	{

    	__RDEBUG( (_L("Error: Error when get StackSize from TestFramework.ini, err= %d"), parseErr) );

    	}

    if(stackSizeFromUser > 0)

    	{

    	param->iTestThreadStackSize = stackSizeFromUser; // user configed stack size

    	}

    aTestModuleParam = param;

    return KErrNone;

    }

// -----------------------------------------------------------------------------

// CTEFTestModule::TEFInitialize

// InitializeModule is used to do some preparations.

// Returns: void

// -----------------------------------------------------------------------------

//

void CTEFTestModule::TEFInitialize(void)

	{

	// Check to see if the plugin wrapper around the GetSystemDrive is loadable

	// If yes, then instantiate the wrapper object and obtain the default system drive

	// Else, use the hardcoded default drive as c:

	iDefaultSysDrive = KTEFLegacySysDrive;	

	RLibrary pluginLibrary;

	CWrapperUtilsPlugin* plugin = TEFUtils::WrapperPluginNew(pluginLibrary);

	if (plugin!=NULL)

		{

		TDriveUnit driveUnit(plugin->GetSystemDrive());

		iDefaultSysDrive.Copy(driveUnit.Name());

		delete plugin;

		pluginLibrary.Close();

		}

	TBool enableSysStart = ETrue;

	CTestExecuteIniData* iniData = NULL;

	TRAPD(err, iniData = CTestExecuteIniData::NewL(iDefaultSysDrive));

	if (err == KErrNone)

		{

		// Extract all the key values within the object

		iniData->ExtractValuesFromIni();

		iniData->GetKeyValueFromIni(KTEFSystemStarter, enableSysStart);