bldsystemtools/commonbldutils/SFPostProcessResults.pl
author Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
Wed, 31 Mar 2010 23:20:42 +0300
branchRCL_3
changeset 4 a9d4531388d0
parent 2 99082257a271
permissions -rw-r--r--
Revision: 201013 Kit: 201013

#
# 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 "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:
#     matti.parnanen@nokia.com
#
# Description:  Post processes result  CSV file generated by the SFCheckSource.pl
#

use strict;
use Getopt::Long;
use File::Basename;
use IO::Handle;
use FileHandle;

# Constants
use constant HEADER_LINE => 'Issue,Category,Comment,Distr. ID,Url,Line,Package,PO,Stamp=$build';
use constant LINE_WITH_LXR => '$issue,$category,$comment,"$distrid",=HYPERLINK("http://s60lxr/source/$filename?v=$lxrbuild#$linenum"),$linenum,$package,$PO';
use constant LINE_WITH_SOURCEPATH => '$issue,$category,$comment,"$distrid",=HYPERLINK("$sourcepath$filename"),$linenum,$package,$PO';
use constant LINE_WITHOUT_LXR => '$issue,$category,$comment,"$distrid",$filename,$linenum,$package,$PO';
use constant NON_NOKIA_FILE => 'Non-Nokia-file';
use constant SOURCE_ISSUE => 'source-issue';
my $IGNORE = 'Ignore';
my $IGNORE_MAN ='Ignore-manually';
my $IGNORE_PATTERN ='Ignore-by-filename';  # Default comments

# Global variables
# Tool version
use constant VERSION => "0.52";
my $optNoIgnored = 0;
my $optBuild = "Undefined";
my $optPackageOwnerFile;
my $optManuallyCheckedFile;
my $optConfigFile;
my $optIgnorefilepattern;  # File patterns to ignore
my $optIgnorefilepatternComment = "";  # Comment value for file patterns to ignore
my %packageOwnerHash;
my %manuallyCheckedHash; # Hash of manually ignored cases
my @sfDistributionIdArray = ();  # Distr ID array

##################################################
# Postprocess subroutine
##################################################

sub doIt($) 
{
    my $sourcefile = shift;
    my $lxrbuild = shift;
    my $outputfile = shift;
    my $sourcepath = shift;

    open(IN,$sourcefile) || die "Unable to open file: $sourcefile\"\" for reading.";
    my $headerline = HEADER_LINE();
    $headerline =~ s/\$build/$optBuild/;
    if ($outputfile)
    {
        print OUTPUT "$headerline\n";
    }
    else
    {
        print "$headerline\n";
    }

    # Collect all files marked as ignored here
    my %ignoreFilesHash;

LINE:
    while(<IN>)
    {
        chomp;
        my $line = $_;
        my @items = parse_csv($line);
        my $issue    = $items[0]; 
        my $category = $items[1];
        my $comment  = $items[2];
        my $distrid     = $items[3];
        my $filename = $items[4];
        $filename =~ s/\\/\//g;  # Standardize name 
        $filename =~ s/[a-zA-Z]\:(\/)?//i;  # Remove possible "drive:/" strings
        my $linenum  = $items[5];
        # Sometimes the tool produces bad data, ignore them
        next LINE if (!($issue =~ m/issue/));  # Not issue
        next LINE if ($optNoIgnored && ($comment =~ m/$IGNORE/i));  # Ignore 
        next LINE if !$category;
        next LINE if  ($optConfigFile && !isSFDistribution($distrid));
        my $ignoreThis = $manuallyCheckedHash{$category . filenameOf($filename)};
        if (defined $ignoreThis) 
        {
            next if $optNoIgnored;
            $comment = $IGNORE_MAN;
        }
        elsif ($optIgnorefilepattern && filenameOf($filename) =~ m/$optIgnorefilepattern/i)
        {
            # Ignore by given pattern in file name
            $comment = $optIgnorefilepatternComment;
        }

        # Extract file parts
        # my ($fname, $filepath, $filext)=fileparse($filename, qr/\.[^.]*/);

        my $linePattern = LINE_WITH_LXR();
        if ($lxrbuild eq "")
        {
            $linePattern = LINE_WITHOUT_LXR();
        }
        if ($sourcepath ne "")
        {
            $linePattern = LINE_WITH_SOURCEPATH();
        }

        # Create result line using the pattern
        $linePattern =~ s/\$issue/$issue/;
        $linePattern =~ s/\$category/$category/;
        $linePattern =~ s/\$comment/$comment/;
        $linePattern =~ s/\$distrid/$distrid/;
        $linePattern =~ s/\$sourcepath/$sourcepath/;
        $linePattern =~ s/\$filename/$filename/;
        my $p = packageOf($filename);
        my $po = packageOwnerOf($filename);
        $linePattern =~ s/\$package/$p/;
        $linePattern =~ s/\$PO/$po/;
        if ($lxrbuild ne "")
        {
            $linenum = sprintf("%03d", $linenum); # LXR requires 3 digits
            $linePattern =~ s/\$lxrbuild/$lxrbuild/;
        }
        $linePattern =~ s/\$linenum/$linenum/;

        if ($outputfile)
        {
            print OUTPUT "$linePattern\n";
        }
        else
        {
            print ("$linePattern\n");
        }
    }

    close (IN);

}


##################################################
# Show usage help
##################################################
sub usage
{
    print "SFPostProcessResults.pl by matti.parnanen\@nokia.com, version " . VERSION() .  "\n";
    print "Generates hyperlinks to filenames using LXR or plain filename links\n";
    print "Usage:\n";
    print "   perl SFPostProcessResults.pl -input csv-file-from-sfchecksource -lxrbuild LXR-buildname [-outputfile different-csv-file-name]\n";
    print "   perl SFPostProcessResults.pl -input csv-file-from-sfchecksource -sourcepath source-path [-outputfile different-csv-file-name]\n";
}


##################################################
# Parse command line and extract options
##################################################
sub parseCmdLine
{

    
    my $opt1;
    my $opt2;
    my $opt3;
    my $opt4;

    if( ! GetOptions(
			 'inputfile=s' => \$opt1,
			 'lxrbuild:s' => \$opt2,
			 'output:s' => \$opt3,
			 'pofile:s' => \$optPackageOwnerFile,
			 'configfile:s' => \$optConfigFile,
			 'oldoutput:s' => \$optManuallyCheckedFile,
			 'sourcepath:s' => \$opt4,
		     'help'     => \&usage,
             'noignored' => \$optNoIgnored,  # Do not included items marked as Ignore
			 'build:s' => \$optBuild,
             'ignorefile:s' => \$optIgnorefilepattern,   #Ignore file pattern
             'ignorecomment:s' => \$optIgnorefilepatternComment,   #Comment used for these
		     '<>'       => \&usage))
		{
		&usage;
		exit(1);
		}

    if (lc($opt1) eq lc($opt3))
    { 
        &usage;
        exit(1);
    }

   return ($opt1, $opt2, $opt3,$opt4);

}

#
# Taken from  Mastering Regular Expressions
#
sub parse_csv {
  my $text = shift; ## record containing comma-separated values
  my @new = ();
  push(@new, $+) while $text =~ m{
    "([^\"\\]*(?:\\.[^\"\\]*)*)",?
      | ([^,]+),?
      | ,
    }gx;
    push(@new, undef) if substr($text, -1,1) eq ',';
    return @new; ## list of values that were comma-spearated
}


##################################################
# Read the content of old output
##################################################
sub readPackageOwnerFile
{
    my($filename) = $optPackageOwnerFile;
    if (!$filename)
    {
        return;
    }

    my $fh = new FileHandle "<$filename";
    if (!defined($fh))
    {
        return;
    }

    my  @lines = <$fh>;
    my $line;
    foreach $line (@lines)
    {
       # Example line
       #ui,mw,classicui,ari.t.valtaoja@nokia.com,Nokia/S60/A&F/UFO,Beijing,1279685+166558

       $line = lc($line);
       my (@parts) = split(/\,/,$line);  # Split line with "," separator
       # print ("DEBUG:readPackageOwnerFile::$parts[1]/$parts[2]=$parts[3]\n");
       $packageOwnerHash{$parts[1] . "/" . $parts[2]} = $parts[3] ;
    }

    close ($fh);
}

##################################################
# Get normalized filename starting from "sf/layer/package"
##################################################
sub filenameOf
{
    my($filename) = shift;
    $filename =~ s/\\/\//g;  # Standardize name 
    $filename = lc($filename);

    # There might be some paths before /sf/layer/package if tool run manually in some local directory
    # structure
    my ($tmp1,$tmp2) = split(/sf\//,$filename);
    # print ("DEBUG:sf/" . $tmp2 . "\n");
    return "sf/" . $tmp2;
}


##################################################
# Get package owner
##################################################
sub packageOwnerOf
{
    my($filename) = shift;
    $filename = filenameOf($filename);

    my (@parts) = split(/\//,$filename);  # "sf/layer/package"
    my $owner = $packageOwnerHash{$parts[1] . "/" . $parts[2]};
    if (defined $owner)
    {
        return $owner;
    }
    return "";
}

##################################################
# Get package name
##################################################
sub packageOf
{
    my($filename) = shift;
    $filename = filenameOf($filename);
    my (@parts) = split(/\//,$filename);  # "sf/layer/package"

    return $parts[2];
}


##################################################
# Read the content of cleaned cases manually ignored
# (these are tool reported case cleared manually=
##################################################
sub readManuallyCheckedFile
{
    my($filename) = $optManuallyCheckedFile;
    if (!$filename)
    {
        return;
    }

    my $fh = new FileHandle "<$filename";
    if (!defined($fh))
    {
        return;
    }

    my  @lines = <$fh>;
    my $line;
    foreach $line (@lines)
    {
       my (@parts) = split(/\,/,$line);  # Split line with "," separator
       if ($parts[2] =~ m/$IGNORE_MAN/i)
       {
            my $fullfilename = lc($parts[4]);
            my $category = $parts[1];
            $fullfilename =~ s/\\/\//g;  # Standardize name 
            # print("\nDEBUG:Marked:$category,$fullfilename as ignored");
            $manuallyCheckedHash{$category . $fullfilename} = "1" ;  # Just some value
       }
    }

    close ($fh);
}

##################################################
# Test  ID is under SF distribution
##################################################
sub isSFDistribution
{
    my $id = shift;
    use constant SFL_DISTRIBUTION_VALUE => "3";  
    use constant EPL_DISTRIBUTION_VALUE => "7";

    if ($id == "")
    {
        return 0;
    }

    if (($id == SFL_DISTRIBUTION_VALUE) || ($id == EPL_DISTRIBUTION_VALUE))
    {
        # Implicit case
        return 1;
    }

    my $otherOkId = grep { $_ eq $id } @sfDistributionIdArray;  # Use exact match
    return $otherOkId;
}


##################################################
# Read configuation file of the
# SFUpdateLicenceHeader.pl to get OK distribution IDs
##################################################
sub readConfigFile
{
    my ($filename) = $optConfigFile;
    if (!$filename)
    {
        return;
    }

    open(IN,$filename) || die "Unable to open file: \"$filename\" for reading.";
    LINE:
    while(<IN>) 
    {
        chomp;
        # tr/A-Z/a-z/;  # Do not lowercase pattern
        my $line = $_;
        $line =~ s/^\s+//;  # trim left
        $line =~ s/\s+$//;  # trim right
        
        next LINE if length($line) == 0; # # Skip empty lines
        next LINE if ($line =~ /^\#.*/); # Skip comments;

        if ($line =~ /^sf-update-licence-header-config.*/i) 
        {
            my ($tmp1, $tmp2) = split(/sf-update-licence-header-config-/,$line);  # Get version
        }
        elsif ($line =~ /^sf-distribution-id/i) 
        {
            my ($tmp, @parts) = split(/[\s\t]+/,$line); # space as separator
            my $cnt = @parts;
            push(@sfDistributionIdArray, @parts);
            my $cnt = @sfDistributionIdArray;
        }
    }

    # Pre-compile here the source line pattern
    close (IN);
}


##################################################
#            MAIN
##################################################

#
# Command line variables
#
my $inputfile = "";
my $outputfile = "";
my $lxrbuild  = "";
my $sourcepath  = "";

# Initialize
($inputfile,$lxrbuild,$outputfile,$sourcepath) = &parseCmdLine;

&readPackageOwnerFile();
&readManuallyCheckedFile();
&readConfigFile();

if ($outputfile)
{
    open (OUTPUT, ">$outputfile") || die "Couldn't open $outputfile\n";
    OUTPUT->autoflush(1);  # Force flush
}

&doIt($inputfile,$lxrbuild,$outputfile,$sourcepath);

close OUTPUT;