1. Change key word "Variable" to "Identifier", all related items are changed
[people/mcb30/basetools.git] / Source / Python / Ecc / DataClass.py
1 ## @file\r
2 # This file is used to define class for data sturcture used in ECC\r
3 #\r
4 # Copyright (c) 2007, Intel Corporation\r
5 # All rights reserved. This program and the accompanying materials\r
6 # are licensed and made available under the terms and conditions of the BSD License\r
7 # which accompanies this distribution.    The full text of the license may be found at\r
8 # http://opensource.org/licenses/bsd-license.php\r
9 #\r
10 # THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,\r
11 # WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.\r
12 \r
13 ##\r
14 # Import Modules\r
15 #\r
16 import Common.EdkLogger as EdkLogger\r
17 \r
18 ##\r
19 # Static values for data models\r
20 #\r
21 MODEL_UNKNOWN = 0\r
22 \r
23 MODEL_FILE_C = 1001\r
24 MODEL_FILE_H = 1002\r
25 MODEL_FILE_ASM = 1003\r
26 MODEL_FILE_INF = 1011\r
27 MODEL_FILE_DEC = 1012\r
28 MODEL_FILE_DSC = 1013\r
29 MODEL_FILE_DSC = 1014\r
30 \r
31 MODEL_IDENTIFIER_FILE_HEADER = 2001\r
32 MODEL_IDENTIFIER_FUNCTION_HEADER = 2002\r
33 MODEL_IDENTIFIER_COMMENT = 2003\r
34 MODEL_IDENTIFIER_PARAMETER = 2004\r
35 MODEL_IDENTIFIER_STRUCTURE = 2005\r
36 MODEL_IDENTIFIER_IDENTIFIER = 2006\r
37 MODEL_IDENTIFIER_INCLUDE = 2007\r
38 MODEL_IDENTIFIER_MACRO = 2008\r
39 MODEL_IDENTIFIER_PREDICATE_EXPRESSION = 2009\r
40 MODEL_IDENTIFIER_ENUMERATE = 2010\r
41 MODEL_IDENTIFIER_PCD = 2011\r
42 \r
43 MODEL_EFI_PROTOCOL = 3001\r
44 MODEL_EFI_PPI = 3002\r
45 MODEL_EFI_GUID = 3003\r
46 MODEL_EFI_LIBRARY_CLASS = 3004\r
47 MODEL_EFI_LIBRARY_INSTANCE = 3005\r
48 MODEL_EFI_PCD = 3006\r
49 MODEL_EFI_SOURCE_FILE = 3007\r
50 MODEL_EFI_BINARY_FILE = 3008\r
51 \r
52 MODEL_PCD_FIXED_AT_BUILD = 4001\r
53 MODEL_PCD_PATCHABLE_IN_MODULE = 4002\r
54 MODEL_PCD_FEATURE_FLAG = 4003\r
55 MODEL_PCD_DYNAMIC_EX = 4004\r
56 MODEL_PCD_DYNAMIC = 4005\r
57 \r
58 MODEL_LIST = [('MODEL_UNKNOWN', MODEL_UNKNOWN),\r
59               ('MODEL_FILE_C', MODEL_FILE_C),\r
60               ('MODEL_FILE_H', MODEL_FILE_H),\r
61               ('MODEL_FILE_ASM', MODEL_FILE_ASM),\r
62               ('MODEL_FILE_INF', MODEL_FILE_INF),\r
63               ('MODEL_FILE_DEC', MODEL_FILE_DEC),\r
64               ('MODEL_FILE_DSC', MODEL_FILE_DSC),\r
65               ('MODEL_FILE_DSC', MODEL_FILE_DSC),\r
66               ('MODEL_IDENTIFIER_FILE_HEADER', MODEL_IDENTIFIER_FILE_HEADER),\r
67               ('MODEL_IDENTIFIER_FUNCTION_HEADER', MODEL_IDENTIFIER_FUNCTION_HEADER),\r
68               ('MODEL_IDENTIFIER_COMMENT', MODEL_IDENTIFIER_COMMENT),\r
69               ('MODEL_IDENTIFIER_PARAMETER', MODEL_IDENTIFIER_PARAMETER),\r
70               ('MODEL_IDENTIFIER_STRUCTURE', MODEL_IDENTIFIER_STRUCTURE),\r
71               ('MODEL_IDENTIFIER_IDENTIFIER', MODEL_IDENTIFIER_IDENTIFIER),\r
72               ('MODEL_IDENTIFIER_INCLUDE', MODEL_IDENTIFIER_INCLUDE),\r
73               ('MODEL_IDENTIFIER_MACRO', MODEL_IDENTIFIER_MACRO),\r
74               ('MODEL_IDENTIFIER_PREDICATE_EXPRESSION', MODEL_IDENTIFIER_PREDICATE_EXPRESSION),\r
75               ('MODEL_IDENTIFIER_ENUMERATE', MODEL_IDENTIFIER_ENUMERATE),\r
76               ('MODEL_IDENTIFIER_PCD', MODEL_IDENTIFIER_PCD),\r
77               ('MODEL_EFI_PROTOCOL', MODEL_EFI_PROTOCOL),\r
78               ('MODEL_EFI_PPI', MODEL_EFI_PPI),\r
79               ('MODEL_EFI_GUID', MODEL_EFI_GUID),\r
80               ('MODEL_EFI_LIBRARY_CLASS', MODEL_EFI_LIBRARY_CLASS),\r
81               ('MODEL_EFI_LIBRARY_INSTANCE', MODEL_EFI_LIBRARY_INSTANCE),\r
82               ('MODEL_EFI_PCD', MODEL_EFI_PCD),\r
83               ('MODEL_EFI_SOURCE_FILE', MODEL_EFI_SOURCE_FILE),\r
84               ('MODEL_EFI_BINARY_FILE', MODEL_EFI_BINARY_FILE),\r
85               ('MODEL_PCD_FIXED_AT_BUILD', MODEL_PCD_FIXED_AT_BUILD),\r
86               ('MODEL_PCD_PATCHABLE_IN_MODULE', MODEL_PCD_PATCHABLE_IN_MODULE),\r
87               ('MODEL_PCD_FEATURE_FLAG', MODEL_PCD_FEATURE_FLAG),\r
88               ('MODEL_PCD_DYNAMIC_EX', MODEL_PCD_DYNAMIC_EX),\r
89               ('MODEL_PCD_DYNAMIC', MODEL_PCD_DYNAMIC)\r
90              ]\r
91 \r
92 ## FunctionClass\r
93 #\r
94 # This class defines a structure of a function\r
95\r
96 # @param ID:               ID of a Function\r
97 # @param Header:           Header of a Function\r
98 # @param Modifier:         Modifier of a Function \r
99 # @param Name:             Name of a Function\r
100 # @param ReturnStatement:  ReturnStatement of a Funciont\r
101 # @param StartLine:        StartLine of a Function\r
102 # @param StartColumn:      StartColumn of a Function\r
103 # @param EndLine:          EndLine of a Function\r
104 # @param EndColumn:        EndColumn of a Function\r
105 # @param BelongsToFile:    The Function belongs to which file\r
106 # @param IdentifierList:   IdentifierList of a File\r
107 # @param PcdList:          PcdList of a File\r
108 #\r
109 # @var ID:                 ID of a Function\r
110 # @var Header:             Header of a Function\r
111 # @var Modifier:           Modifier of a Function \r
112 # @var Name:               Name of a Function\r
113 # @var ReturnStatement:    ReturnStatement of a Funciont\r
114 # @var StartLine:          StartLine of a Function\r
115 # @var StartColumn:        StartColumn of a Function\r
116 # @var EndLine:            EndLine of a Function\r
117 # @var EndColumn:          EndColumn of a Function\r
118 # @var BelongsToFile:      The Function belongs to which file\r
119 # @var IdentifierList:     IdentifierList of a File\r
120 # @var PcdList:            PcdList of a File\r
121 #\r
122 class FunctionClass(object):\r
123     def __init__(self, ID = -1, Header = '', Modifier = '', Name = '', ReturnStatement = '', StartLine = -1, StartColumn = -1, EndLine = -1, EndColumn = -1, BelongsToFile = -1, IdentifierList = [], PcdList = []):\r
124         self.ID = ID\r
125         self.Header = Header\r
126         self.Modifier = Modifier                    \r
127         self.Name = Name\r
128         self.ReturnStatement = ReturnStatement\r
129         self.StartLine = StartLine\r
130         self.StartColumn = StartColumn\r
131         self.EndLine = EndLine\r
132         self.EndColumn = EndColumn\r
133         self.BelongsToFile = BelongsToFile\r
134         \r
135         self.IdentifierList = IdentifierList\r
136         self.PcdList = PcdList\r
137 \r
138 ## IdentifierClass\r
139 #\r
140 # This class defines a structure of a variable\r
141\r
142 # @param ID:                 ID of a Identifier\r
143 # @param Modifier:           Modifier of a Identifier\r
144 # @param Type:               Type of a Identifier\r
145 # @param Name:               Name of a Identifier\r
146 # @param Value:              Value of a Identifier\r
147 # @param Model:              Model of a Identifier\r
148 # @param BelongsToFile:      The Identifier belongs to which file\r
149 # @param BelongsToFunction:  The Identifier belongs to which function\r
150 # @param StartLine:          StartLine of a Identifier\r
151 # @param StartColumn:        StartColumn of a Identifier\r
152 # @param EndLine:            EndLine of a Identifier\r
153 # @param EndColumn:          EndColumn of a Identifier\r
154 #\r
155 # @var ID:                   ID of a Identifier\r
156 # @var Modifier:             Modifier of a Identifier\r
157 # @var Type:                 Type of a Identifier\r
158 # @var Name:                 Name of a Identifier\r
159 # @var Value:                Value of a Identifier\r
160 # @var Model:                Model of a Identifier\r
161 # @var BelongsToFile:        The Identifier belongs to which file\r
162 # @var BelongsToFunction:    The Identifier belongs to which function\r
163 # @var StartLine:            StartLine of a Identifier\r
164 # @var StartColumn:          StartColumn of a Identifier\r
165 # @var EndLine:              EndLine of a Identifier\r
166 # @var EndColumn:            EndColumn of a Identifier\r
167 #\r
168 class IdentifierClass(object):\r
169     def __init__(self, ID = -1, Modifier = '', Type = '', Name = '', Value = '', Model = MODEL_UNKNOWN, BelongsToFile = -1, BelongsToFunction = -1, StartLine = -1, StartColumn = -1, EndLine = -1, EndColumn = -1):\r
170         self.ID = ID\r
171         self.Modifier = Modifier\r
172         self.Type = Type\r
173         self.Name = Name\r
174         self.Value = Value\r
175         self.Model = Model\r
176         self.BelongsToFile = BelongsToFile\r
177         self.BelongsToFunction = BelongsToFunction\r
178         self.StartLine = StartLine\r
179         self.StartColumn = StartColumn\r
180         self.EndLine = EndLine\r
181         self.EndColumn = EndColumn\r
182 \r
183 ## PcdClass\r
184 #\r
185 # This class defines a structure of a Pcd\r
186\r
187 # @param ID:                   ID of a Pcd\r
188 # @param CName:                CName of a Pcd\r
189 # @param TokenSpaceGuidCName:  TokenSpaceGuidCName of a Pcd\r
190 # @param Token:                Token of a Pcd\r
191 # @param DatumType:            DatumType of a Pcd\r
192 # @param Model:                Model of a Pcd\r
193 # @param BelongsToFile:        The Pcd belongs to which file\r
194 # @param BelongsToFunction:    The Pcd belongs to which function\r
195 # @param StartLine:            StartLine of a Pcd\r
196 # @param StartColumn:          StartColumn of a Pcd\r
197 # @param EndLine:              EndLine of a Pcd\r
198 # @param EndColumn:            EndColumn of a Pcd\r
199 #\r
200 # @var ID:                     ID of a Pcd\r
201 # @var CName:                  CName of a Pcd\r
202 # @var TokenSpaceGuidCName:    TokenSpaceGuidCName of a Pcd\r
203 # @var Token:                  Token of a Pcd\r
204 # @var DatumType:              DatumType of a Pcd\r
205 # @var Model:                  Model of a Pcd\r
206 # @var BelongsToFile:          The Pcd belongs to which file\r
207 # @var BelongsToFunction:      The Pcd belongs to which function\r
208 # @var StartLine:              StartLine of a Pcd\r
209 # @var StartColumn:            StartColumn of a Pcd\r
210 # @var EndLine:                EndLine of a Pcd\r
211 # @var EndColumn:              EndColumn of a Pcd\r
212 #\r
213 class PcdClass(object):\r
214     def __init__(self, ID = -1, CName = '', TokenSpaceGuidCName = '', Token = '', DatumType = '', Model = MODEL_UNKNOWN, BelongsToFile = -1, BelongsToFunction = -1, StartLine = -1, StartColumn = -1, EndLine = -1, EndColumn = -1):\r
215         self.ID = ID\r
216         self.CName = CName\r
217         self.TokenSpaceGuidCName = TokenSpaceGuidCName\r
218         self.Token = Token\r
219         self.DatumType = DatumType\r
220         self.BelongsToFile = BelongsToFile\r
221         self.BelongsToFunction = BelongsToFunction\r
222         self.StartLine = StartLine\r
223         self.StartColumn = StartColumn\r
224         self.EndLine = EndLine\r
225         self.EndColumn = EndColumn\r
226 \r
227 ## FileClass\r
228 #\r
229 # This class defines a structure of a file\r
230\r
231 # @param ID:              ID of a File\r
232 # @param Name:            Name of a File\r
233 # @param ExtName:         ExtName of a File\r
234 # @param Path:            Path of a File\r
235 # @param FullPath:        FullPath of a File\r
236 # @param Model:           Model of a File\r
237 # @param FunctionList:    FunctionList of a File\r
238 # @param IdentifierList:  IdentifierList of a File\r
239 # @param PcdList:         PcdList of a File\r
240 #\r
241 # @var ID:                ID of a File\r
242 # @var Name:              Name of a File\r
243 # @var ExtName:           ExtName of a File\r
244 # @var Path:              Path of a File\r
245 # @var FullPath:          FullPath of a File\r
246 # @var Model:             Model of a File\r
247 # @var FunctionList:      FunctionList of a File\r
248 # @var IdentifierList:    IdentifierList of a File\r
249 # @var PcdList:           PcdList of a File\r
250 #\r
251 class FileClass(object):\r
252     def __init__(self, ID = -1, Name = '', ExtName = '', Path = '', FullPath = '', Model = MODEL_UNKNOWN, FunctionList = [], IdentifierList = [], PcdList = []):\r
253         self.ID = ID                                   \r
254         self.Name = Name\r
255         self.ExtName = ExtName                    \r
256         self.Path = Path\r
257         self.FullPath = FullPath\r
258         self.Model = Model\r
259         \r
260         self.FunctionList = FunctionList\r
261         self.IdentifierList = IdentifierList\r
262         self.PcdList = PcdList\r