<?xml version="1.0" encoding="UTF-8"?>

<!-- 

============================================================================ 

Name        : common.antlib.xml 

Part of     : Helium 

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

All rights reserved.

This component and the accompanying materials are made available

under the terms of the License "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:

============================================================================

-->

<antlib xmlns:au="org.apache.ant.antunit" xmlns:hlm="http://www.nokia.com/helium">

    <!-- Macro to execute bldmake command. To be removed if not used. -->

    <macrodef name="bldmakeBldfilesMacro" uri="http://www.nokia.com/helium">

        <attribute name="dir"/>

        <sequential>

            <exec executable="${build.drive}/epoc32/tools/bldmake.bat" dir="@{dir}" failonerror="${failonerror}">

                <arg value="bldfiles"/>

                <arg value="-k"/>

            </exec>

        </sequential>

    </macrodef>

    <!-- Macro to execute abld command. Once used in rombuild.ant.xml. -->

    <macrodef name="abldMacro" uri="http://www.nokia.com/helium">

        <attribute name="dir"/>

        <attribute name="command"/>

        <attribute name="platform"/>

        <sequential>

            <exec executable="@{dir}/abld.bat" dir="@{dir}" failonerror="${failonerror}">

                <arg value="@{command}"/>

                <arg value="@{platform}"/>

                <arg value="-k"/>

            </exec>

        </sequential>

    </macrodef>

    <!--

        This macro generate a file that contains a list of path from a path structure:

        <pre>

        <hlm:pathToFileListMacro file="output.lst">

            <path>

                <pathelement path="${helium.dir}"/>

            </path>

        </hlm:pathToFileListMacro> 

        </pre>

    -->

    <scriptdef name="pathToFileListMacro" language="beanshell" uri="http://www.nokia.com/helium">

        <attribute name="file"/>

        <element name="path" type="path"/>

        <![CDATA[

    import java.io.FileWriter;

    FileWriter out = new FileWriter(attributes.get("file"));

    paths = elements.get("path");

    for (int i = 0 ; i < paths.size() ; i++) {

        String[] files = paths.get(i).list();

        for (int l = 0; l < files.length ; l++) {

            out.write(files[l] + "\n");

        }

    }

out.close();

]]>   

    </scriptdef>

    <!-- This Macro is a wrapper to command line tool 

        Currently supported command line tools are

        configuration tool and

        sbs tool

        Usage: 

            name - name of the tool:

            toolvarset - reference id for variables to be passed to the tool

        <pre>

        <hlm:toolMacro name="configuration">

            <hlm:toolvarset refid="cnftool.conf.50"/>

        </hlm:toolMacro>

        </pre>

    -->

    <scriptdef name="toolMacro" language="beanshell" uri="http://www.nokia.com/helium">

        <attribute name="name"/>

<![CDATA[

import com.nokia.ant.util.ToolsProcess;

import com.nokia.tools.*;

import org.apache.tools.ant.types.Reference;

    Reference ref;

    java.lang.String toolName = attributes.get("name");

    confTool =  ToolsProcess.getTool(toolName);

    varSets = elements.get("toolvarset");

    for (i = 0; i < varSets.size(); ++i) {

        try {

            varSet = (VariableSet)varSets.get(i);

            if (varSet.isReference()) {

                varSet = varSet.getRefid().getReferencedObject(project);

            }

            confTool.execute(varSet,project);

        } catch (Exception e) {

            self.log("Error: " + e);

            //self.log("Tool Argument Validation failure");

            throw e;

        }

  }

]]>

    </scriptdef>

    <!-- This task allow to dump the content of a text file to the shell. -->

    <scriptdef name="echoFileMacro" language="beanshell" uri="http://www.nokia.com/helium">

        <attribute name="file"/>

        <![CDATA[        

        //Open the file for reading

         try {

            java.io.BufferedReader in = new java.io.BufferedReader(new java.io.FileReader(attributes.get("file")));

            while ((thisLine = in.readLine()) != null) { // while loop begins here

                 self.log(thisLine);

            } // end while 

        } catch (java.io.IOException e) {

            self.log("Error: " + e);

            throw e;

        }        

        ]]>

    </scriptdef>

    <!-- This task create the herder information in the symbian log file -->

    <scriptdef name="symbianLogHeaderMacro" language="jython" uri="http://www.nokia.com/helium">

        <attribute name="config"/>

        <attribute name="command"/>

        <attribute name="dir"/>

import log2xml

log2xml.symbian_log_header(self, attributes.get('config'), attributes.get('command'), attributes.get('dir'))

    </scriptdef>

    <!-- This task create the footer information in the symbian log file -->

    <scriptdef name="symbianLogFooterMacro" language="jython" uri="http://www.nokia.com/helium">

import log2xml

log2xml.symbian_log_footer(self)

    </scriptdef>

    <!-- Macro to record content to a separate log file without recording in the main log. -->

    <macrodef name="recordStartMacro" uri="http://www.nokia.com/helium">

        <attribute name="name"/>

        <attribute name="emacsmode" default="false"/>

        <sequential>

            <if>

                <available file="${build.log.dir}" type="dir"/>

                <then>

                </then>

            </if>

        </sequential>

    </macrodef>

    <!-- Macro to stop recording content to a separate log file without recording in the main log. -->

    <macrodef name="recordStopMacro" uri="http://www.nokia.com/helium">

        <attribute name="name"/>

        <sequential>

            <if>

                <available file="${build.log.dir}/@{name}"/>

                <then>

                </then>

            </if>

        </sequential>

    </macrodef>

    <!--Macro to stop recording to the main log file (if present) and record to

        a separate log file that is filtered after logging is stopped. -->

    <macrodef name="filterRecordStartMacro" uri="http://www.nokia.com/helium">

        <sequential>

        </sequential>

    </macrodef>

    <!--Macro to stop recording the seperate filtered log file, filter the passwords

    and start recording in main log file -->

    <macrodef name="filterRecordStopMacro" uri="http://www.nokia.com/helium">

        <attribute name="log" default="${build.log}"/>

        <attribute name="append" default="true"/>

        <sequential>

            <concat destfile="@{log}" append="@{append}">

                <filelist dir="${build.cache.log.dir}" files="temp_ant_build.log"/>                        

            </concat>

            <delete file="${build.cache.log.dir}/temp_ant_build.log" failonerror="false"/>

            <echo>End of filtering @{log} for passwords</echo>

        </sequential>

    </macrodef>

    <!-- A generic assert macro similar to AntUnit "assertTrue". -->

    <macrodef name="assert" uri="http://www.nokia.com/helium">

        <attribute name="message" default="Value is not true."/>

        <element name="condition" implicit="yes"/>

        <sequential>

            <if>

                <isset property="hlm.enable.asserts"/>

                <then>

                    <au:assertTrue message="@{message}">

                        <condition/>

                    </au:assertTrue>

                </then>

                <else>

                    <trycatch property="assert.try">

                        <try>

                            <au:assertTrue message="@{message}">

                                <condition/>

                            </au:assertTrue>

                        </try>

                        <catch>

                            <echo message="Warning: @{message}"/>

                            <hlm:hlmassertmessage assertName="hlm:assert" message="Warning: @{message}"/>

                        </catch>

                    </trycatch>

                </else>

            </if>

        </sequential>

    </macrodef>

    <!-- A generic assert macro similar to AntUnit "assertFileExists". -->

    <macrodef name="assertFileExists" uri="http://www.nokia.com/helium">

        <attribute name="file"/>

        <attribute name="message" default="@{file} does not exists."/>

        <sequential>

            <if>

                <isset property="hlm.enable.asserts"/>

                <then>

                    <au:assertFileExists file="@{file}" message="Warning: @{message}"/>

                </then>

                <else>

                    <trycatch property="assert.try">

                        <try>

                            <au:assertFileExists file="@{file}" message="Warning: @{message}"/>                                

                        </try>

                        <catch>

                            <echo message="Warning: @{message}"/>

                            <hlm:hlmassertmessage assertName="hlm:assertFileExists" message="Warning: @{message}"/>

                        </catch>

                    </trycatch>

                </else>

            </if>

        </sequential>

    </macrodef>

    <!-- A generic assert macro similar to AntUnit "assertPropertySet". -->

    <macrodef name="assertPropertySet" uri="http://www.nokia.com/helium">

        <attribute name="property"/>

        <attribute name="message" default="@{property} is not set."/>

        <sequential>

            <if>

                <isset property="hlm.enable.asserts"/>

                <then>

                    <au:assertPropertySet name="@{property}" message="@{message}"/>

                </then>

                <else>

                    <trycatch property="assert.try">

                        <try>

                            <au:assertPropertySet name="@{property}" message="@{message}"/>

                        </try>

                        <catch>

                            <echo message="Warning: @{message}"/>

                            <hlm:hlmassertmessage assertName="hlm:assertPropertySet" message="Warning: @{message}"/>

                        </catch>

                    </trycatch>

                </else>

            </if>

        </sequential>

    </macrodef>

    <!-- Script definition to collect target dependencies -->

    <scriptdef name="dependencies" language="jython" uri="http://www.nokia.com/helium">

        <attribute name="target"/>

        <attribute name="format"/>

parsedTargets = []

targetList = []

def collectTargetDependencies(targetName, indent):    

    targetObject = project.getTargets().get(targetName)

    if targetObject is None :

        print  "Target '" + targetName + "' not found."   

    else :

        dependenciesEnum = targetObject.getDependencies()

        while dependenciesEnum.hasMoreElements():

            dependency = dependenciesEnum.nextElement()

            if dependency not in parsedTargets:

                collectTargetDependencies(dependency, indent + 1)

                parsedTargets.append(dependency)

                targetList.append((dependency, indent))

target = str(attributes.get('target'))

collectTargetDependencies(target, 1)

targetList.append((target, 0))

format = str(attributes.get('format'))

if format == 'nested':    

    for target, indent in targetList:        

        indentString = ''.join(['   ' for x in range(indent)])

        print indentString + str(target)

elif format == 'executable':

    print "Top level targets:\n"

    print ''.join([str(target) + ' ' for target, indent in targetList[:-1] if indent == 1])

    print "\n\nAll targets in sequence:\n"

    print ''.join([str(target) + ' ' for target, indent in targetList[:-1]])

    </scriptdef>

    <!-- This new task allows to save a reference to a file. -->

    <scriptdef name="referenceToFileMacro" language="jython" uri="http://www.nokia.com/helium">

        <attribute name="refid"/>

        <attribute name="output"/>

    <![CDATA[

from java.io import FileWriter

refid = str(attributes.get("refid"))

output = str(attributes.get("output"))

if refid == None:

    raise Exception("'refid' attribute must be defined!")    

if output == None:

    raise Exception("'output' attribute must be defined!")

self.log("Creating %s using %s" % (output, refid))

reference = project.getReference(refid)

if reference == None:

    raise Exception("Unknown reference '%s'" % refid)

output = FileWriter(output)

i = reference.iterator()

while i.hasNext():

    path = i.next().toString()

    self.log(path)

    output.write(path + "\n")

output.close()

    ]]></scriptdef>

    <!-- Reads password from .netrc file for a specific type of service. -->

    <scriptdef name="netrcPasswordMacro" language="jython" uri="http://www.nokia.com/helium">

        <attribute name="output-prop"/>

        <attribute name="result-prop"/>

        <attribute name="type"/>

        <![CDATA[

import netrc

import os

result = "0"

try:

    netrc_file = netrc.netrc()

    self.log("Type: %s" % str(attributes.get("type")))

    netrc_info = netrc_file.authenticators(str(attributes.get("type")))

    if netrc_info == None:

        raise Exception("No entry found for Type: %s" % str(attributes.get("type")))

    (n_username, n_account, n_password) = netrc_info

    if attributes.get('output-prop') != None:

        project.setProperty(str(attributes.get('output-prop')), str(n_password))

except Exception, e:

    result = "-1"

if attributes.get('result-prop') != None:

    project.setProperty(str(attributes.get('result-prop')), str(result))

        ]]>

    </scriptdef>

    <!-- Reads user name from .netrc file for a specific type of service. -->

    <scriptdef name="netrcUsernameMacro" language="jython" uri="http://www.nokia.com/helium">

        <attribute name="output-prop"/>

        <attribute name="result-prop"/>

        <attribute name="type"/>

        <![CDATA[

import netrc

import os

result = "0"

try:

    netrc_file = netrc.netrc()

    self.log("Type: %s" % str(attributes.get("type")))

    netrc_info = netrc_file.authenticators(str(attributes.get("type")))

    if netrc_info == None:

        raise Exception("No entry found for Type: %s" % str(attributes.get("type")))

    (n_username, n_account, n_password) = netrc_info

    if attributes.get('output-prop') != None:

        project.setProperty(str(attributes.get('output-prop')), str(n_username))

except Exception, e:

    result = "-1"

if attributes.get('result-prop') != None:

    project.setProperty(str(attributes.get('result-prop')), str(result))

        ]]>

    </scriptdef>

    <!-- Check availability of synergy. -->   

    <scriptdef  name="ccmAvailableMacro" language="jython" uri="http://www.nokia.com/helium">

        <attribute name="resultproperty"/>

        <![CDATA[

import nokia.nokiaccm

import logging

import ccm.extra

logging.basicConfig(level=logging.INFO)

session = None

result = "0"

cache = None

if project.getProperty("ccm.cache.xml")is not None:

    cache = str(project.getProperty("ccm.cache.xml"))

try:

    database = project.getProperty('ccm.database')

    if project.getProperty('ccm.user.login') == None :

        raise Exception("'ccm.user.login' property is not defined")

    username = project.getProperty('ccm.user.login')

    if project.getProperty('ccm.user.password') == None :

        raise Exception("'ccm.user.password' property is not defined")

    password = project.getProperty('ccm.user.password')

    engine = project.getProperty('ccm.engine.host')

    dbpath = project.getProperty('ccm.database.path')

    provider = ccm.extra.CachedSessionProvider(opener=nokia.nokiaccm.open_session, cache=cache)

    if database != None:

        session = provider.get(username, password, database=database, reuse=False)

    else:

        session = provider.get(username, password, engine, dbpath, reuse=False)

except Exception, e:

    print "ERROR: %s" % e

    if str(e).find("access denied") != -1:

        result = "-2"

    else:

        result = "-1"

self.log("Result: %s" % attributes.get('resultproperty'))

project.setProperty(str(attributes.get('resultproperty')), str(result))