1 /// Finds methods in a specified interface or class location. 2 module workspaced.visitors.methodfinder; 3 4 import workspaced.visitors.attributes; 5 6 import workspaced.dparseext; 7 8 import dparse.ast; 9 import dparse.formatter; 10 import dparse.lexer; 11 12 import std.algorithm; 13 import std.array; 14 import std.range; 15 import std..string; 16 17 /// Information about an argument in a method defintion. 18 struct ArgumentInfo 19 { 20 /// The whole definition of the argument including everything related to it as formatted code string. 21 string signature; 22 /// The type of the argument. 23 string type; 24 /// The name of the argument. 25 string name; 26 27 /// Returns just the name. 28 string toString() const 29 { 30 return name; 31 } 32 } 33 34 /// Information about a method definition. 35 struct MethodDetails 36 { 37 /// The name of the method. 38 string name; 39 /// The type definition of the method without body, abstract or final. 40 string signature; 41 /// The return type of the method. 42 string returnType; 43 /// All (regular) arguments passable into this method. 44 ArgumentInfo[] arguments; 45 /// 46 bool isNothrowOrNogc; 47 /// True if this function has an implementation. 48 bool hasBody; 49 /// True when the container is an interface or (optionally implicit) abstract class or when in class not having a body. 50 bool needsImplementation; 51 /// True when in a class and method doesn't have a body. 52 bool optionalImplementation; 53 /// Range starting at return type, going until last token before opening curly brace. 54 size_t[2] definitionRange; 55 /// Range containing the starting and ending braces of the body. 56 size_t[2] blockRange; 57 58 /// Signature without any attributes, constraints or parameter details other than types. 59 /// Used to differentiate a method from others without computing the mangle. 60 /// Returns: `"<type> <name>(<argument types>)"` 61 string identifier() 62 { 63 return format("%s %s(%(%s,%))", returnType, name, arguments.map!"a.type"); 64 } 65 } 66 67 /// 68 struct FieldDetails 69 { 70 /// 71 string name, type; 72 /// 73 bool isPrivate; 74 } 75 76 /// 77 struct TypeDetails 78 { 79 enum Type 80 { 81 none, 82 class_, 83 interface_, 84 enum_, 85 struct_, 86 union_, 87 alias_, 88 template_, 89 } 90 91 /// Name in last element, all parents in previous elements. 92 string[] name; 93 /// 94 size_t nameLocation; 95 /// 96 Type type; 97 } 98 99 /// 100 struct ReferencedType 101 { 102 /// Referenced type name, might be longer than actual written name because of normalization of parents. 103 string name; 104 /// Location of name which will start right before the last identifier of the type in a dot chain. 105 size_t location; 106 } 107 108 /// Information about an interface or class 109 struct InterfaceDetails 110 { 111 /// Entire code of the file 112 const(char)[] code; 113 /// True if this is a class and therefore need to override methods using $(D override). 114 bool needsOverride; 115 /// Name of the interface or class. 116 string name; 117 /// Plain old variable fields in this container. 118 FieldDetails[] fields; 119 /// All methods defined in this container. 120 MethodDetails[] methods; 121 /// A list of nested types and locations defined in this interface/class. 122 TypeDetails[] types; 123 // reserved for future use with templates 124 string[] parents; 125 /// Name of all base classes or interfaces. Should use normalizedParents, 126 string[] normalizedParents; 127 /// Absolute code position after the colon where the corresponding parent name starts. 128 int[] parentPositions; 129 /// Range containing the starting and ending braces of the body. 130 size_t[2] blockRange; 131 /// A (name-based) sorted set of referenced types with first occurences of every type or alias not including built-in types, but including object.d types and aliases. 132 ReferencedType[] referencedTypes; 133 } 134 135 class InterfaceMethodFinder : AttributesVisitor 136 { 137 this(const(char)[] code, int targetPosition) 138 { 139 this.code = code; 140 details.code = code; 141 this.targetPosition = targetPosition; 142 } 143 144 override void visit(const StructDeclaration dec) 145 { 146 if (inTarget) 147 return; 148 else 149 super.visit(dec); 150 } 151 152 override void visit(const UnionDeclaration dec) 153 { 154 if (inTarget) 155 return; 156 else 157 super.visit(dec); 158 } 159 160 override void visit(const EnumDeclaration dec) 161 { 162 if (inTarget) 163 return; 164 else 165 super.visit(dec); 166 } 167 168 override void visit(const ClassDeclaration dec) 169 { 170 if (inTarget) 171 return; 172 173 auto c = context.save(); 174 context.pushContainer(ASTContext.ContainerAttribute.Type.class_, dec.name.text); 175 visitInterface(dec.name, dec.baseClassList, dec.structBody, true); 176 context.restore(c); 177 } 178 179 override void visit(const InterfaceDeclaration dec) 180 { 181 if (inTarget) 182 return; 183 184 auto c = context.save(); 185 context.pushContainer(ASTContext.ContainerAttribute.Type.interface_, dec.name.text); 186 visitInterface(dec.name, dec.baseClassList, dec.structBody, false); 187 context.restore(c); 188 } 189 190 private void visitInterface(const Token name, const BaseClassList baseClassList, 191 const StructBody structBody, bool needsOverride) 192 { 193 if (!structBody) 194 return; 195 if (inTarget) 196 return; // ignore nested 197 198 if (targetPosition >= name.index && targetPosition < structBody.endLocation) 199 { 200 details.blockRange = [structBody.startLocation, structBody.endLocation + 1]; 201 details.name = name.text; 202 if (baseClassList) 203 foreach (base; baseClassList.items) 204 { 205 if (!base.type2 || !base.type2.typeIdentifierPart 206 || !base.type2.typeIdentifierPart.identifierOrTemplateInstance) 207 continue; 208 // TODO: template support! 209 details.parents ~= astToString(base.type2); 210 details.normalizedParents ~= astToString(base.type2); 211 details.parentPositions ~= cast( 212 int) base.type2.typeIdentifierPart.identifierOrTemplateInstance.identifier.index + 1; 213 } 214 details.needsOverride = needsOverride; 215 inTarget = true; 216 structBody.accept(new NestedTypeFinder(&details, details.name)); 217 super.visit(structBody); 218 inTarget = false; 219 } 220 } 221 222 override void visit(const FunctionDeclaration dec) 223 { 224 if (!inTarget) 225 return; 226 227 size_t[2] definitionRange = [dec.name.index, 0]; 228 size_t[2] blockRange; 229 230 if (dec.returnType !is null && dec.returnType.tokens.length > 0) 231 definitionRange[0] = dec.returnType.tokens[0].index; 232 233 if (dec.functionBody !is null && dec.functionBody.tokens.length > 0) 234 { 235 definitionRange[1] = dec.functionBody.tokens[0].index; 236 blockRange = [ 237 dec.functionBody.tokens[0].index, dec.functionBody.tokens[$ - 1].index + 1 238 ]; 239 } 240 else if (dec.parameters !is null && dec.parameters.tokens.length > 0) 241 definitionRange[1] = dec.parameters.tokens[$ - 1].index 242 + dec.parameters.tokens[$ - 1].text.length; 243 244 auto origBody = (cast() dec).functionBody; 245 const hasBody = !!origBody && origBody.missingFunctionBody is null; 246 auto origComment = (cast() dec).comment; 247 const implLevel = context.requiredImplementationLevel; 248 const optionalImplementation = implLevel == 1 && !hasBody; 249 const needsImplementation = implLevel == 9 || optionalImplementation; 250 (cast() dec).functionBody = null; 251 (cast() dec).comment = null; 252 scope (exit) 253 { 254 (cast() dec).functionBody = origBody; 255 (cast() dec).comment = origComment; 256 } 257 auto t = appender!string; 258 formatTypeTransforming(t, dec, &resolveType); 259 string method = context.localFormattedAttributes.chain([t.data.strip]) 260 .filter!(a => a.length > 0 && !a.among!("abstract", "final")).join(" "); 261 ArgumentInfo[] arguments; 262 if (dec.parameters) 263 foreach (arg; dec.parameters.parameters) 264 arguments ~= ArgumentInfo(astToString(arg), astToString(arg.type), arg.name.text); 265 string returnType = dec.returnType ? resolveType(astToString(dec.returnType)) : "void"; 266 267 // now visit to populate isNothrow, isNogc (before it would add to the localFormattedAttributes string) 268 // also fills in used types 269 super.visit(dec); 270 271 details.methods ~= MethodDetails(dec.name.text, method, returnType, arguments, context.isNothrowInContainer 272 || context.isNogcInContainer, hasBody, needsImplementation, 273 optionalImplementation, definitionRange, blockRange); 274 } 275 276 override void visit(const FunctionBody) 277 { 278 } 279 280 override void visit(const VariableDeclaration variable) 281 { 282 if (!inTarget) 283 return; 284 if (!variable.type) 285 return; 286 string type = astToString(variable.type); 287 auto isPrivate = context.protectionType == tok!"private"; 288 289 foreach (decl; variable.declarators) 290 details.fields ~= FieldDetails(decl.name.text, type, isPrivate); 291 292 if (variable.type) 293 variable.type.accept(this); // to fill in types 294 } 295 296 override void visit(const TypeIdentifierPart type) 297 { 298 if (!inTarget) 299 return; 300 301 if (type.identifierOrTemplateInstance && !type.typeIdentifierPart) 302 { 303 auto tok = type.identifierOrTemplateInstance.templateInstance 304 ? type.identifierOrTemplateInstance.templateInstance.identifier 305 : type.identifierOrTemplateInstance.identifier; 306 307 usedType(ReferencedType(tok.text, tok.index)); 308 } 309 310 super.visit(type); 311 } 312 313 alias visit = AttributesVisitor.visit; 314 315 protected void usedType(ReferencedType type) 316 { 317 // this is a simple sorted set insert 318 auto sorted = assumeSorted!"a.name < b.name"(details.referencedTypes).trisect(type); 319 if (sorted[1].length) 320 return; // exists already 321 details.referencedTypes.insertInPlace(sorted[0].length, type); 322 } 323 324 string resolveType(const(char)[] inType) 325 { 326 auto parts = inType.splitter('.'); 327 string[] best; 328 foreach (type; details.types) 329 if ((!best.length || type.name.length < best.length) && type.name.endsWith(parts)) 330 best = type.name; 331 332 if (best.length) 333 return best.join("."); 334 else 335 return inType.idup; 336 } 337 338 const(char)[] code; 339 bool inTarget; 340 int targetPosition; 341 InterfaceDetails details; 342 } 343 344 class NestedTypeFinder : ASTVisitor 345 { 346 this(InterfaceDetails* details, string start) 347 { 348 this.details = details; 349 this.nested = [start]; 350 } 351 352 override void visit(const StructDeclaration dec) 353 { 354 handleType(TypeDetails.Type.struct_, dec.name.text, dec.name.index, dec); 355 } 356 357 override void visit(const UnionDeclaration dec) 358 { 359 handleType(TypeDetails.Type.union_, dec.name.text, dec.name.index, dec); 360 } 361 362 override void visit(const EnumDeclaration dec) 363 { 364 handleType(TypeDetails.Type.enum_, dec.name.text, dec.name.index, dec); 365 } 366 367 override void visit(const ClassDeclaration dec) 368 { 369 handleType(TypeDetails.Type.class_, dec.name.text, dec.name.index, dec); 370 } 371 372 override void visit(const InterfaceDeclaration dec) 373 { 374 handleType(TypeDetails.Type.interface_, dec.name.text, dec.name.index, dec); 375 } 376 377 override void visit(const TemplateDeclaration dec) 378 { 379 handleType(TypeDetails.Type.template_, dec.name.text, dec.name.index, dec); 380 } 381 382 override void visit(const AliasDeclaration dec) 383 { 384 if (dec && dec.declaratorIdentifierList) 385 foreach (ident; dec.declaratorIdentifierList.identifiers) 386 details.types ~= TypeDetails(nested ~ ident.text, ident.index, TypeDetails.Type.alias_); 387 } 388 389 void handleType(T)(TypeDetails.Type type, string name, size_t location, T node) 390 { 391 pushNestedType(type, name, location); 392 super.visit(node); 393 popNestedType(); 394 } 395 396 override void visit(const FunctionBody) 397 { 398 } 399 400 alias visit = ASTVisitor.visit; 401 402 protected void pushNestedType(TypeDetails.Type type, string name, size_t index) 403 { 404 nested ~= name; 405 details.types ~= TypeDetails(nested, index, type); 406 } 407 408 protected void popNestedType() 409 { 410 nested.length--; 411 } 412 413 string[] nested; 414 InterfaceDetails* details; 415 } 416 417 void formatTypeTransforming(Sink, T)(Sink sink, T node, string delegate(const(char)[]) translateType, 418 bool useTabs = false, IndentStyle style = IndentStyle.allman, uint indentWith = 4) 419 { 420 TypeTransformingFormatter!Sink formatter = new TypeTransformingFormatter!(Sink)(sink, 421 useTabs, style, indentWith); 422 formatter.translateType = translateType; 423 formatter.format(node); 424 } 425 426 /// 427 class TypeTransformingFormatter(Sink) : Formatter!Sink 428 { 429 string delegate(const(char)[]) translateType; 430 Appender!(char[]) tempBuffer; 431 bool useTempBuffer; 432 433 this(Sink sink, bool useTabs = false, IndentStyle style = IndentStyle.allman, uint indentWidth = 4) 434 { 435 super(sink, useTabs, style, indentWidth); 436 tempBuffer = appender!(char[]); 437 } 438 439 override void put(string s) 440 { 441 if (useTempBuffer) 442 tempBuffer.put(s); 443 else 444 super.put(s); 445 } 446 447 protected void flushTempBuffer() 448 { 449 if (!useTempBuffer || tempBuffer.data.empty) 450 return; 451 452 useTempBuffer = false; 453 put(translateType(tempBuffer.data)); 454 tempBuffer.clear(); 455 } 456 457 override void format(const TypeIdentifierPart type) 458 { 459 useTempBuffer = true; 460 461 if (type.dot) 462 { 463 put("."); 464 } 465 if (type.identifierOrTemplateInstance) 466 { 467 format(type.identifierOrTemplateInstance); 468 } 469 if (type.indexer) 470 { 471 flushTempBuffer(); 472 put("["); 473 format(type.indexer); 474 put("]"); 475 } 476 if (type.typeIdentifierPart) 477 { 478 put("."); 479 format(type.typeIdentifierPart); 480 } 481 else 482 { 483 flushTempBuffer(); 484 } 485 } 486 487 override void format(const IdentifierOrTemplateInstance identifierOrTemplateInstance) 488 { 489 with (identifierOrTemplateInstance) 490 { 491 format(identifier); 492 if (templateInstance) 493 { 494 flushTempBuffer(); 495 format(templateInstance); 496 } 497 } 498 } 499 500 alias format = Formatter!Sink.format; 501 }