Index: mojo/public/dart/third_party/analyzer/lib/src/task/strong_mode.dart |
diff --git a/mojo/public/dart/third_party/analyzer/lib/src/task/strong_mode.dart b/mojo/public/dart/third_party/analyzer/lib/src/task/strong_mode.dart |
new file mode 100644 |
index 0000000000000000000000000000000000000000..3d13146065a5344d93801fdf710494630f757e27 |
--- /dev/null |
+++ b/mojo/public/dart/third_party/analyzer/lib/src/task/strong_mode.dart |
@@ -0,0 +1,557 @@ |
+// Copyright (c) 2015, the Dart project authors. Please see the AUTHORS file |
+// for details. All rights reserved. Use of this source code is governed by a |
+// BSD-style license that can be found in the LICENSE file. |
+ |
+library analyzer.src.task.strong_mode; |
+ |
+import 'dart:collection'; |
+ |
+import 'package:analyzer/src/generated/ast.dart'; |
+import 'package:analyzer/src/generated/element.dart'; |
+import 'package:analyzer/src/generated/resolver.dart'; |
+import 'package:analyzer/src/generated/utilities_dart.dart'; |
+ |
+/** |
+ * Set the type of the sole parameter of the given [element] to the given [type]. |
+ */ |
+void setParameterType(PropertyAccessorElement element, DartType type) { |
+ if (element is PropertyAccessorElementImpl) { |
+ ParameterElement parameter = _getParameter(element); |
+ if (parameter is ParameterElementImpl) { |
+ // |
+ // Update the type of the parameter. |
+ // |
+ parameter.type = type; |
+ // |
+ // Update the type of the setter to reflect the new parameter type. |
+ // |
+ FunctionType functionType = element.type; |
+ if (functionType is FunctionTypeImpl) { |
+ element.type = |
+ new FunctionTypeImpl(element, functionType.prunedTypedefs); |
+ } else { |
+ assert(false); |
+ } |
+ } else { |
+ assert(false); |
+ } |
+ } else { |
+ throw new StateError('element is an instance of ${element.runtimeType}'); |
+ assert(false); |
+ } |
+} |
+ |
+/** |
+ * Set the return type of the given [element] to the given [type]. |
+ */ |
+void setReturnType(ExecutableElement element, DartType type) { |
+ if (element is ExecutableElementImpl) { |
+ // |
+ // Update the return type of the element, which is stored in two places: |
+ // directly in the element and indirectly in the type of the element. |
+ // |
+ element.returnType = type; |
+ FunctionType functionType = element.type; |
+ if (functionType is FunctionTypeImpl) { |
+ element.type = new FunctionTypeImpl(element, functionType.prunedTypedefs); |
+ } else { |
+ assert(false); |
+ } |
+ } else { |
+ assert(false); |
+ } |
+} |
+ |
+/** |
+ * Return the element for the single parameter of the given [setter], or `null` |
+ * if the executable element is not a setter or does not have a single |
+ * parameter. |
+ */ |
+ParameterElement _getParameter(ExecutableElement setter) { |
+ if (setter is PropertyAccessorElement && setter.isSetter) { |
+ List<ParameterElement> parameters = setter.parameters; |
+ if (parameters.length == 1) { |
+ return parameters[0]; |
+ } |
+ } |
+ return null; |
+} |
+ |
+/** |
+ * A function that returns `true` if the given [variable] passes the filter. |
+ */ |
+typedef bool VariableFilter(VariableElement element); |
+ |
+/** |
+ * An object used to find static variables whose types should be inferred and |
+ * classes whose members should have types inferred. Clients are expected to |
+ * visit a [CompilationUnit]. |
+ */ |
+class InferrenceFinder extends SimpleAstVisitor { |
+ /** |
+ * The static variables that should have types inferred for them. |
+ */ |
+ final List<VariableElement> staticVariables = <VariableElement>[]; |
+ |
+ /** |
+ * The classes defined in the unit. |
+ * |
+ * TODO(brianwilkerson) We don't currently remove classes whose members do not |
+ * need to be processed, but we potentially could. |
+ */ |
+ final List<ClassElement> classes = <ClassElement>[]; |
+ |
+ /** |
+ * Initialize a newly created finder. |
+ */ |
+ InferrenceFinder(); |
+ |
+ @override |
+ void visitClassDeclaration(ClassDeclaration node) { |
+ classes.add(node.element); |
+ for (ClassMember member in node.members) { |
+ member.accept(this); |
+ } |
+ } |
+ |
+ @override |
+ void visitClassTypeAlias(ClassTypeAlias node) { |
+ classes.add(node.element); |
+ } |
+ |
+ @override |
+ void visitCompilationUnit(CompilationUnit node) { |
+ for (CompilationUnitMember declaration in node.declarations) { |
+ declaration.accept(this); |
+ } |
+ } |
+ |
+ @override |
+ void visitFieldDeclaration(FieldDeclaration node) { |
+ if (node.isStatic && node.fields.type == null) { |
+ _addVariables(node.fields.variables); |
+ } |
+ } |
+ |
+ @override |
+ void visitTopLevelVariableDeclaration(TopLevelVariableDeclaration node) { |
+ if (node.variables.type == null) { |
+ _addVariables(node.variables.variables); |
+ } |
+ } |
+ |
+ /** |
+ * Add all of the [variables] with initializers to the list of variables whose |
+ * type can be inferred. Technically, we only infer the types of variables |
+ * that do not have a static type, but all variables with initializers |
+ * potentially need to be re-resolved after inference because they might |
+ * refer to fields whose type was inferred. |
+ */ |
+ void _addVariables(NodeList<VariableDeclaration> variables) { |
+ for (VariableDeclaration variable in variables) { |
+ if (variable.initializer != null) { |
+ VariableElement element = variable.element; |
+ if (element.hasImplicitType) { |
+ staticVariables.add(element); |
+ } |
+ } |
+ } |
+ } |
+} |
+ |
+/** |
+ * An object used to infer the type of instance fields and the return types of |
+ * instance methods within a single compilation unit. |
+ */ |
+class InstanceMemberInferrer { |
+ /** |
+ * The type provider used to look up types. |
+ */ |
+ final TypeProvider typeProvider; |
+ |
+ /** |
+ * The type system used to compute the least upper bound of types. |
+ */ |
+ TypeSystem typeSystem; |
+ |
+ /** |
+ * The inheritance manager used to find overridden method. |
+ */ |
+ InheritanceManager inheritanceManager; |
+ |
+ /** |
+ * The classes that have been visited while attempting to infer the types of |
+ * instance members of some base class. |
+ */ |
+ HashSet<ClassElementImpl> elementsBeingInferred = |
+ new HashSet<ClassElementImpl>(); |
+ |
+ /** |
+ * Initialize a newly create inferrer. |
+ */ |
+ InstanceMemberInferrer(this.typeProvider) { |
+ typeSystem = new TypeSystemImpl(typeProvider); |
+ } |
+ |
+ /** |
+ * Infer type information for all of the instance members in the given |
+ * compilation [unit]. |
+ */ |
+ void inferCompilationUnit(CompilationUnitElement unit) { |
+ inheritanceManager = new InheritanceManager(unit.library); |
+ unit.types.forEach((ClassElement classElement) { |
+ try { |
+ _inferClass(classElement); |
+ } on _CycleException { |
+ // This is a short circuit return to prevent types that inherit from |
+ // types containing a circular reference from being inferred. |
+ } |
+ }); |
+ } |
+ |
+ /** |
+ * Compute the best type for the [parameter] at the given [index] that must be |
+ * compatible with the types of the corresponding parameters of the given |
+ * [overriddenMethods]. |
+ * |
+ * At the moment, this method will only return a type other than 'dynamic' if |
+ * the types of all of the parameters are the same. In the future we might |
+ * want to be smarter about it, such as by returning the least upper bound of |
+ * the parameter types. |
+ */ |
+ DartType _computeParameterType(ParameterElement parameter, int index, |
+ List<ExecutableElement> overriddenMethods) { |
+ DartType parameterType = null; |
+ int length = overriddenMethods.length; |
+ for (int i = 0; i < length; i++) { |
+ DartType type = _getTypeOfCorrespondingParameter( |
+ parameter, index, overriddenMethods[i]); |
+ if (parameterType == null) { |
+ parameterType = type; |
+ } else if (parameterType != type) { |
+ return typeProvider.dynamicType; |
+ } |
+ } |
+ return parameterType == null ? typeProvider.dynamicType : parameterType; |
+ } |
+ |
+ /** |
+ * Compute the best return type for a method that must be compatible with the |
+ * return types of each of the given [overriddenMethods]. |
+ * |
+ * At the moment, this method will only return a type other than 'dynamic' if |
+ * the return types of all of the methods are the same. In the future we might |
+ * want to be smarter about it. |
+ */ |
+ DartType _computeReturnType(List<ExecutableElement> overriddenMethods) { |
+ DartType returnType = null; |
+ int length = overriddenMethods.length; |
+ for (int i = 0; i < length; i++) { |
+ DartType type = _getReturnType(overriddenMethods[i]); |
+ if (returnType == null) { |
+ returnType = type; |
+ } else if (returnType != type) { |
+ return typeProvider.dynamicType; |
+ } |
+ } |
+ return returnType == null ? typeProvider.dynamicType : returnType; |
+ } |
+ |
+ DartType _getReturnType(ExecutableElement element) { |
+ DartType returnType = element.returnType; |
+ if (returnType == null) { |
+ return typeProvider.dynamicType; |
+ } |
+ return returnType; |
+ } |
+ |
+ /** |
+ * Given a [method], return the type of the parameter in the method that |
+ * corresponds to the given [parameter]. If the parameter is positional, then |
+ * it appears at the given [index] in its enclosing element's list of |
+ * parameters. |
+ */ |
+ DartType _getTypeOfCorrespondingParameter( |
+ ParameterElement parameter, int index, ExecutableElement method) { |
+ // |
+ // Find the corresponding parameter. |
+ // |
+ List<ParameterElement> methodParameters = method.parameters; |
+ ParameterElement matchingParameter = null; |
+ if (parameter.parameterKind == ParameterKind.NAMED) { |
+ // |
+ // If we're looking for a named parameter, only a named parameter with |
+ // the same name will be matched. |
+ // |
+ matchingParameter = methodParameters.lastWhere( |
+ (ParameterElement methodParameter) => |
+ methodParameter.parameterKind == ParameterKind.NAMED && |
+ methodParameter.name == parameter.name, |
+ orElse: () => null); |
+ } else { |
+ // |
+ // If we're looking for a positional parameter we ignore the difference |
+ // between required and optional parameters. |
+ // |
+ if (index < methodParameters.length) { |
+ matchingParameter = methodParameters[index]; |
+ if (matchingParameter.parameterKind == ParameterKind.NAMED) { |
+ matchingParameter = null; |
+ } |
+ } |
+ } |
+ // |
+ // Then return the type of the parameter. |
+ // |
+ return matchingParameter == null |
+ ? typeProvider.dynamicType |
+ : matchingParameter.type; |
+ } |
+ |
+ /** |
+ * If the given [accessorElement] represents a non-synthetic instance getter |
+ * for which no return type was provided, infer the return type of the getter. |
+ */ |
+ void _inferAccessor(PropertyAccessorElement accessorElement) { |
+ if (!accessorElement.isSynthetic && |
+ accessorElement.isGetter && |
+ !accessorElement.isStatic && |
+ accessorElement.hasImplicitReturnType) { |
+ List<ExecutableElement> overriddenGetters = inheritanceManager |
+ .lookupOverrides( |
+ accessorElement.enclosingElement, accessorElement.name); |
+ if (overriddenGetters.isNotEmpty && _onlyGetters(overriddenGetters)) { |
+ DartType newType = _computeReturnType(overriddenGetters); |
+ List<ExecutableElement> overriddenSetters = inheritanceManager |
+ .lookupOverrides( |
+ accessorElement.enclosingElement, accessorElement.name + '='); |
+ PropertyAccessorElement setter = (accessorElement.enclosingElement |
+ as ClassElement).getSetter(accessorElement.name); |
+ if (setter != null) { |
+ overriddenSetters.add(setter); |
+ } |
+ if (!_isCompatible(newType, overriddenSetters)) { |
+ newType = typeProvider.dynamicType; |
+ } |
+ setReturnType(accessorElement, newType); |
+ (accessorElement.variable as FieldElementImpl).type = newType; |
+ } |
+ } |
+ } |
+ |
+ /** |
+ * Infer type information for all of the instance members in the given |
+ * [classElement]. |
+ */ |
+ void _inferClass(ClassElement classElement) { |
+ if (classElement is ClassElementImpl) { |
+ if (classElement.hasBeenInferred) { |
+ return; |
+ } |
+ if (!elementsBeingInferred.add(classElement)) { |
+ // We have found a circularity in the class hierarchy. For now we just |
+ // stop trying to infer any type information for any classes that |
+ // inherit from any class in the cycle. We could potentially limit the |
+ // algorithm to only not inferring types in the classes in the cycle, |
+ // but it isn't clear that the results would be significantly better. |
+ throw new _CycleException(); |
+ } |
+ try { |
+ // |
+ // Ensure that all of instance members in the supertypes have had types |
+ // inferred for them. |
+ // |
+ _inferType(classElement.supertype); |
+ classElement.mixins.forEach(_inferType); |
+ classElement.interfaces.forEach(_inferType); |
+ // |
+ // Then infer the types for the members. |
+ // |
+ classElement.fields.forEach(_inferField); |
+ classElement.accessors.forEach(_inferAccessor); |
+ classElement.methods.forEach(_inferMethod); |
+ classElement.hasBeenInferred = true; |
+ } finally { |
+ elementsBeingInferred.remove(classElement); |
+ } |
+ } |
+ } |
+ |
+ /** |
+ * If the given [fieldElement] represents a non-synthetic instance field for |
+ * which no type was provided, infer the type of the field. |
+ */ |
+ void _inferField(FieldElement fieldElement) { |
+ if (!fieldElement.isSynthetic && |
+ !fieldElement.isStatic && |
+ fieldElement.hasImplicitType) { |
+ // |
+ // First look for overridden getters with the same name as the field. |
+ // |
+ List<ExecutableElement> overriddenGetters = inheritanceManager |
+ .lookupOverrides(fieldElement.enclosingElement, fieldElement.name); |
+ DartType newType = null; |
+ if (overriddenGetters.isNotEmpty && _onlyGetters(overriddenGetters)) { |
+ newType = _computeReturnType(overriddenGetters); |
+ List<ExecutableElement> overriddenSetters = inheritanceManager |
+ .lookupOverrides( |
+ fieldElement.enclosingElement, fieldElement.name + '='); |
+ if (!_isCompatible(newType, overriddenSetters)) { |
+ newType = null; |
+ } |
+ } |
+ // |
+ // Then, if none was found, infer the type from the initialization |
+ // expression. |
+ // |
+ if (newType == null) { |
+ if (fieldElement.initializer != null && |
+ (fieldElement.isFinal || overriddenGetters.isEmpty)) { |
+ newType = fieldElement.initializer.returnType; |
+ } |
+ } |
+ if (newType == null || newType.isBottom) { |
+ newType = typeProvider.dynamicType; |
+ } |
+ (fieldElement as FieldElementImpl).type = newType; |
+ setReturnType(fieldElement.getter, newType); |
+ if (!fieldElement.isFinal && !fieldElement.isConst) { |
+ setParameterType(fieldElement.setter, newType); |
+ } |
+ } |
+ } |
+ |
+ /** |
+ * If the given [methodElement] represents a non-synthetic instance method |
+ * for which no return type was provided, infer the return type of the method. |
+ */ |
+ void _inferMethod(MethodElement methodElement) { |
+ if (methodElement.isSynthetic || methodElement.isStatic) { |
+ return; |
+ } |
+ List<ExecutableElement> overriddenMethods = null; |
+ // |
+ // Infer the return type. |
+ // |
+ if (methodElement.hasImplicitReturnType) { |
+ overriddenMethods = inheritanceManager.lookupOverrides( |
+ methodElement.enclosingElement, methodElement.name); |
+ if (overriddenMethods.isEmpty || !_onlyMethods(overriddenMethods)) { |
+ return; |
+ } |
+ MethodElementImpl element = methodElement as MethodElementImpl; |
+ setReturnType(element, _computeReturnType(overriddenMethods)); |
+ } |
+ // |
+ // Infer the parameter types. |
+ // |
+ List<ParameterElement> parameters = methodElement.parameters; |
+ int length = parameters.length; |
+ for (int i = 0; i < length; ++i) { |
+ ParameterElement parameter = parameters[i]; |
+ if (parameter is ParameterElementImpl && parameter.hasImplicitType) { |
+ if (overriddenMethods == null) { |
+ overriddenMethods = inheritanceManager.lookupOverrides( |
+ methodElement.enclosingElement, methodElement.name); |
+ } |
+ if (overriddenMethods.isEmpty || !_onlyMethods(overriddenMethods)) { |
+ return; |
+ } |
+ parameter.type = _computeParameterType(parameter, i, overriddenMethods); |
+ } |
+ } |
+ } |
+ |
+ /** |
+ * Infer type information for all of the instance members in the given |
+ * interface [type]. |
+ */ |
+ void _inferType(InterfaceType type) { |
+ if (type != null) { |
+ ClassElement element = type.element; |
+ if (element != null) { |
+ _inferClass(element); |
+ } |
+ } |
+ } |
+ |
+ /** |
+ * Return `true` if the given [type] is compatible with the argument types of |
+ * all of the given [setters]. |
+ */ |
+ bool _isCompatible(DartType type, List<ExecutableElement> setters) { |
+ for (ExecutableElement setter in setters) { |
+ ParameterElement parameter = _getParameter(setter); |
+ if (parameter != null && !typeSystem.isSubtypeOf(parameter.type, type)) { |
+ return false; |
+ } |
+ } |
+ return true; |
+ } |
+ |
+ /** |
+ * Return `true` if the list of [elements] contains only getters. |
+ */ |
+ bool _onlyGetters(List<ExecutableElement> elements) { |
+ for (ExecutableElement element in elements) { |
+ if (!(element is PropertyAccessorElement && element.isGetter)) { |
+ return false; |
+ } |
+ } |
+ return true; |
+ } |
+ |
+ /** |
+ * Return `true` if the list of [elements] contains only methods. |
+ */ |
+ bool _onlyMethods(List<ExecutableElement> elements) { |
+ for (ExecutableElement element in elements) { |
+ if (element is! MethodElement) { |
+ return false; |
+ } |
+ } |
+ return true; |
+ } |
+} |
+ |
+/** |
+ * A visitor that will gather all of the variables referenced within a given |
+ * AST structure. The collection can be restricted to contain only those |
+ * variables that pass a specified filter. |
+ */ |
+class VariableGatherer extends RecursiveAstVisitor { |
+ /** |
+ * The filter used to limit which variables are gathered, or `null` if no |
+ * filtering is to be performed. |
+ */ |
+ final VariableFilter filter; |
+ |
+ /** |
+ * The variables that were found. |
+ */ |
+ final Set<VariableElement> results = new HashSet<VariableElement>(); |
+ |
+ /** |
+ * Initialize a newly created gatherer to gather all of the variables that |
+ * pass the given [filter] (or all variables if no filter is provided). |
+ */ |
+ VariableGatherer([this.filter = null]); |
+ |
+ @override |
+ void visitSimpleIdentifier(SimpleIdentifier node) { |
+ if (!node.inDeclarationContext()) { |
+ Element element = node.staticElement; |
+ if (element is PropertyAccessorElement && element.isSynthetic) { |
+ element = (element as PropertyAccessorElement).variable; |
+ } |
+ if (element is VariableElement && (filter == null || filter(element))) { |
+ results.add(element); |
+ } |
+ } |
+ } |
+} |
+ |
+/** |
+ * A class of exception that is not used anywhere else. |
+ */ |
+class _CycleException implements Exception {} |