Parser.py 9.12 KB
Newer Older
1
#!/usr/bin/env python3
2
3
#SCT log parser

4

5
import sys
Vincent Stehlé's avatar
Vincent Stehlé committed
6
7
import argparse

8

9
#based loosley on https://stackoverflow.com/a/4391978
Jeff Booher-Kaeding's avatar
V1.0?    
Jeff Booher-Kaeding committed
10
# returns a filtered dict of dicts that meet some Key-value pair.
11
# I.E. key="result" value="FAILURE"
12
def key_value_find(list_1, key, value):
13
    found = list()
14
    for test in list_1:
15
        if test[key] == value:
16
            found.append(test)
17
    return found
18

19
20

#Were we intrept test logs into test dicts
21
def test_parser(string, current):
22
    test_list = {
Vincent Stehlé's avatar
Vincent Stehlé committed
23
      "name": string[2], #FIXME:Sometimes, SCT has name and Description,
24
      "result": string[1],
25
      **current,
26
      "guid": string[0], #FIXME:GUID's overlap
Jeff Booher-Kaeding's avatar
V1.0?    
Jeff Booher-Kaeding committed
27
      #"comment": string[-1], #FIXME:need to hash this out, sometime there is no comments
28
      "log": ' '.join(string[3:])
29
    }
30
    return test_list
Vincent Stehlé's avatar
Vincent Stehlé committed
31

32
#Parse the ekl file, and create a map of the tests
33
34
def ekl_parser (file):
    #create our "database" dict
35
    temp_list = list()
36
    #All tests are grouped by the "HEAD" line the procedes them.
37
38
39
40
41
42
    current = {
        'group': "N/A",
        'test set': "N/A",
        'sub set': "N/A",
        'set guid': "N/A",
    }
43
44

    for line in file:
Vincent Stehlé's avatar
Vincent Stehlé committed
45
46
47
48
49
50
51
        # Strip the line from trailing whitespaces
        line = line.rstrip()

        # Skip empty line
        if line == '':
            continue

52
53
54
        #strip the line of | & || used for sepration
        split_line = [string for string in line.split('|') if string != ""]

Vincent Stehlé's avatar
Vincent Stehlé committed
55
56
        # Skip TERM
        if split_line[0] == "TERM":
57
58
59
60
61
            continue

        #The "HEAD" tag is the only indcation we are on a new test set
        if split_line[0]=="HEAD":
            #split the header into test group and test set.
62
            try:
63
                group, Set = split_line[8].split('\\')
64
            except:
65
66
67
68
69
70
                group, Set = '', split_line[8]
            current = {
                'group': group,
                'test set': Set,
                'sub set': split_line[6],
                'set guid': split_line[4],
71
72
73
74
75
76
                'iteration': split_line[1],
                'start date': split_line[2],
                'start time': split_line[3],
                'revision': split_line[5],
                'descr': split_line[7],
                'device path': split_line[9],
77
            }
78

Jeff Booher-Kaeding's avatar
V1.0?    
Jeff Booher-Kaeding committed
79
        #FIXME:? EKL file has an inconsistent line structure,
80
81
82
        # sometime we see a line that consits ' dump of GOP->I\n'
        #easiest way to skip is check for blank space in the first char
        elif split_line[0][0] != " ":
83
84
85
86
            try:
                #deliminiate on ':' for tests
                split_test = [new_string for old_string in split_line for new_string in old_string.split(':')]
                #put the test into a dict, and then place that dict in another dict with GUID as key
87
                tmp_dict = test_parser(split_test, current)
88
89
90
91
92
                temp_list.append(tmp_dict)
            except:
                print("Line:",split_line)
                sys.exit("your log may be corrupted")
    return temp_list
93

Jeff Booher-Kaeding's avatar
Jeff Booher-Kaeding committed
94
#Parse Seq file, used to tell which tests should run.
95
def seq_parser(file):
96
    temp_dict = list()
97
    lines=file.readlines()
Jeff Booher-Kaeding's avatar
V1.0?    
Jeff Booher-Kaeding committed
98
    magic=7 #a test in a seq file is 7 lines, if not mod7, something wrong..
99
100
    if len(lines)%magic != 0:
        sys.exit("seqfile cut short, should be mod7")
101
102
103
104
105
106
107
108
    #the utf-16 char makes this looping a bit harder, so we use x+(i) where i is next 0-6th
    for x in range(0,len(lines),magic): #loop ever "7 lines"
        #(x+0)[Test Case]
        #(x+1)Revision=0x10000
        #(x+2)Guid=XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX
        #(x+3)Name=InstallAcpiTableFunction
        #(x+4)Order=0xFFFFFFFF
        #(x+5)Iterations=0xFFFFFFFF
Vincent Stehlé's avatar
Vincent Stehlé committed
109
        #(x+6)(utf-16 char)
110
        #currently only add tests that are supposed to run, should add all?
Jeff Booher-Kaeding's avatar
V1.0?    
Jeff Booher-Kaeding committed
111
        #0xFFFFFFFF in "Iterations" means the test is NOT supposed to run
112
113
114
115
116
117
118
119
        if not "0xFFFFFFFF" in lines[x+5]:
            seq_dict = {
                "name": lines[x+3][5:-1],#from after "Name=" to end (5char long)
                "guid": lines[x+2][5:-1],#from after"Guid=" to the end, (5char long)
                "Iteration": lines[x+5][11:-1],#from after "Iterations=" (11char long)
                "rev": lines[x+1][9:-1],#from after "Revision=" (9char long)
                "Order": lines[x+4][6:-1]#from after "Order=" (6char long)
            }
120
            temp_dict.append(seq_dict) #put in a dict based on guid
121

122
    return temp_dict
123

124
125
126
127
#group items by key, and print by key
#we slowly iterate through the list, group and print groups
def key_tree_2_md(input_list,file,key):
    #make a copy so we don't destroy the first list.
Vincent Stehlé's avatar
Vincent Stehlé committed
128
    temp_list = input_list.copy()
129
130
131
132
133
134
135
136
137
138
139
140
    while temp_list:
        test_dict = temp_list.pop()
        found, not_found = [test_dict],[]
        #go through whole list looking for key match
        while temp_list:
            next_dict = temp_list.pop()
            if next_dict[key] == test_dict[key]: #if match add to found
                found.append(next_dict)
            else: #else not found
                not_found.append(next_dict)
        temp_list = not_found #start over with found items removed
        file.write("### " + test_dict[key])
141
        dict_2_md(found,file)
Vincent Stehlé's avatar
Vincent Stehlé committed
142

143
144


145
146
147
#generic writer, takes a list of dicts and turns the dicts into an MD table.
def dict_2_md(input_list,file):
    if len(input_list) > 0:
Jeff Booher-Kaeding's avatar
Jeff Booher-Kaeding committed
148
        file.write("\n\n")
149
150
151
152
        #create header for MD table using dict keys
        temp_string1, temp_string2 = "|", "|"
        for x in (input_list[0].keys()):
            temp_string1 += (x + "|")
Jeff Booher-Kaeding's avatar
Jeff Booher-Kaeding committed
153
            temp_string2 += ("---|")
154
155
156
157
158
159
160
        file.write(temp_string1+"\n"+temp_string2+"\n")
        #print each item from the dict into the table
        for x in input_list:
            test_string = "|"
            for y in x.keys():
                test_string += (x[y] + "|")
            file.write(test_string+'\n')
Vincent Stehlé's avatar
Vincent Stehlé committed
161
    #seprate table from other items in MD
162
    file.write("\n\n")
163

Jeff Booher-Kaeding's avatar
V1.0?    
Jeff Booher-Kaeding committed
164

165
def main():
Vincent Stehlé's avatar
Vincent Stehlé committed
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
    parser = argparse.ArgumentParser(
        description='Process SCT results.'
                    ' This program takes the SCT summary and sequence files,'
                    ' and generates a nice report in mardown format.',
        formatter_class=argparse.ArgumentDefaultsHelpFormatter)
    parser.add_argument(
        '--md', help='Output .md filename', default='result.md')
    parser.add_argument(
        'log_file', nargs='?', default='sample.ekl',
        help='Input .ekl filename')
    parser.add_argument(
        'seq_file', nargs='?', default='sample.seq',
        help='Input .seq filename')
    parser.add_argument('find_key', nargs='?', help='Search key')
    parser.add_argument('find_value', nargs='?', help='Search value')
    args = parser.parse_args()

    #Command line argument 1, ekl file to open
184
    db1 = list() #"database 1" all tests.
Vincent Stehlé's avatar
Vincent Stehlé committed
185
    with open(args.log_file,"r",encoding="utf-16") as f: #files are encoded in utf-16
Jeff Booher-Kaeding's avatar
V1.0?    
Jeff Booher-Kaeding committed
186
187
        db1 = ekl_parser(f.readlines())

Vincent Stehlé's avatar
Vincent Stehlé committed
188
    #Command line argument 2, seq file to open
189
    db2 = dict() #"database 2" all test sets that should run
Vincent Stehlé's avatar
Vincent Stehlé committed
190
    with open(args.seq_file,"r",encoding="utf-16") as f: #files are encoded in utf-16
191
        db2 = seq_parser(f)
Vincent Stehlé's avatar
Vincent Stehlé committed
192

Jeff Booher-Kaeding's avatar
V1.0?    
Jeff Booher-Kaeding committed
193
    #cross check is filled only with tests labled as "run" int the seq file
194
    cross_check = list()
Jeff Booher-Kaeding's avatar
V1.0?    
Jeff Booher-Kaeding committed
195
    #combine a list of test sets that did not run for whatever reason.
196
    would_not_run = list()
Jeff Booher-Kaeding's avatar
V1.0?    
Jeff Booher-Kaeding committed
197
    for x in db2: #for each "set guid" in db2
198
        temp_dict = key_value_find(db1,"set guid",x["guid"])#find tests in db1 with given set guid
Jeff Booher-Kaeding's avatar
V1.0?    
Jeff Booher-Kaeding committed
199
        if bool(temp_dict): #if its not empty, apprend it to our dict
200
            cross_check = (cross_check +temp_dict)
Jeff Booher-Kaeding's avatar
V1.0?    
Jeff Booher-Kaeding committed
201
        else: #if it is empty, this test set was not run.
202
            would_not_run.append(x)
203

Vincent Stehlé's avatar
Vincent Stehlé committed
204

Jeff Booher-Kaeding's avatar
V1.0?    
Jeff Booher-Kaeding committed
205
    #search for failures and warnings & passes,
Vincent Stehlé's avatar
Vincent Stehlé committed
206

207
208
209
    failures = key_value_find(cross_check,"result","FAILURE")
    warnings = key_value_find(cross_check,"result","WARNING")
    passes = key_value_find(cross_check,"result","PASS")
210
211

    # generate MD summary
Vincent Stehlé's avatar
Vincent Stehlé committed
212
    with open(args.md, 'w') as resultfile:
213
214
215
216
217
218
219
        resultfile.write("# SCT Summary \n\n")
        resultfile.write("|  |  |\n")
        resultfile.write("|--|--|\n")
        resultfile.write("|Dropped:|" + str(len(would_not_run)) + "|\n")
        resultfile.write("|Failures:|" + str(len(failures)) + "|\n")
        resultfile.write("|Warnings:|" + str(len(warnings)) + "|\n")
        resultfile.write("|Passes:|" + str(len(passes)) + "|\n")
220
221
        resultfile.write("\n\n")

Jeff Booher-Kaeding's avatar
Jeff Booher-Kaeding committed
222
        resultfile.write("## 1. Silently dropped or missing")
223
224
        dict_2_md(would_not_run,resultfile)

225
        resultfile.write("## 4. Failure by group")
Vincent Stehlé's avatar
Vincent Stehlé committed
226
        resultfile.write("\n\n")
227
        key_tree_2_md(failures,resultfile,"group")
Vincent Stehlé's avatar
Vincent Stehlé committed
228

229

230
231
        resultfile.write("## 3. Warnings by group")
        resultfile.write("\n\n")
232
        key_tree_2_md(warnings,resultfile,"group")
233

Vincent Stehlé's avatar
Vincent Stehlé committed
234

Jeff Booher-Kaeding's avatar
V1.0?    
Jeff Booher-Kaeding committed
235
236
    #command line argument 3&4, key are to support a key & value search.
    #these will be displayed in CLI
Vincent Stehlé's avatar
Vincent Stehlé committed
237
238
    if args.find_key is not None and args.find_value is not None:
        found = key_value_find(db1, args.find_key, args.find_value)
Jeff Booher-Kaeding's avatar
V1.0?    
Jeff Booher-Kaeding committed
239
240
241
        #print the dict
        print("found:",len(found),"items with search constraints")
        for x in found:
Vincent Stehlé's avatar
Vincent Stehlé committed
242
243
244
245
            print(
                x["guid"], ":", x["name"], "with", args.find_key, ":",
                x[args.find_key])

246

247
main()