Index: pkg/dartdoc/mirrors/mirrors.dart |
diff --git a/pkg/dartdoc/mirrors/mirrors.dart b/pkg/dartdoc/mirrors/mirrors.dart |
deleted file mode 100644 |
index 786e9b9eadf4b30f62ff2c5e555b28e4804a4140..0000000000000000000000000000000000000000 |
--- a/pkg/dartdoc/mirrors/mirrors.dart |
+++ /dev/null |
@@ -1,468 +0,0 @@ |
-// Copyright (c) 2012, 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('mirrors'); |
- |
-#import('dart:io'); |
-#import('dart:uri'); |
-#import('dart2js_mirror.dart'); |
- |
-/** |
- * [Compilation] encapsulates the compilation of a program. |
- */ |
-class Compilation { |
- /** |
- * Creates a new compilation which has [script] as its entry point. |
- */ |
- factory Compilation(Path script, |
- Path libraryRoot, |
- [Path packageRoot, |
- List<String> opts = const <String>[]]) { |
- return new Dart2JsCompilation(script, libraryRoot, packageRoot, opts); |
- } |
- |
- /** |
- * Creates a new compilation which consists of a set of libraries, but which |
- * has no entry point. This compilation cannot generate output but can only |
- * be used for static inspection of the source code. |
- */ |
- factory Compilation.library(List<Path> libraries, |
- Path libraryRoot, |
- [Path packageRoot, |
- List<String> opts = const []]) { |
- return new Dart2JsCompilation.library(libraries, libraryRoot, |
- packageRoot, opts); |
- } |
- |
- /** |
- * Returns the mirror system for this compilation. |
- */ |
- final MirrorSystem mirrors; |
- |
- /** |
- * Returns a future for the compiled JavaScript code. |
- */ |
- abstract Future<String> compileToJavaScript(); |
-} |
- |
-/** |
- * The main interface for the whole mirror system. |
- */ |
-abstract class MirrorSystem { |
- /** |
- * Returns an unmodifiable map of all libraries in this mirror system. |
- */ |
- Map<Object, LibraryMirror> get libraries; |
-} |
- |
- |
-/** |
- * An entity in the mirror system. |
- */ |
-abstract class Mirror implements Hashable { |
- /** |
- * The simple name of the entity. The simple name is in most cases the |
- * the declared single identifier name of the entity, such as 'method' for |
- * a method [:void method() {...}:]. |
- */ |
- String get simpleName; |
- |
- /** |
- * Returns the name of this entity qualified by is enclosing context. For |
- * instance, the qualified name of a method 'method' in class 'Class' in |
- * library 'library' is 'library.Class.method'. |
- */ |
- String get qualifiedName; |
- |
- /** |
- * Returns the mirror system which contains this mirror. |
- */ |
- MirrorSystem get system; |
-} |
- |
-/** |
- * Common interface for interface types and libraries. |
- */ |
-abstract class ObjectMirror implements Mirror { |
- |
- /** |
- * Returns an unmodifiable map of the members of declared in this type or |
- * library. |
- */ |
- Map<Object, MemberMirror> get declaredMembers; |
-} |
- |
-/** |
- * A library. |
- */ |
-abstract class LibraryMirror extends ObjectMirror { |
- /** |
- * The name of the library, as given in #library(). |
- */ |
- String get simpleName; |
- |
- /** |
- * Returns an iterable over all types in the library. |
- */ |
- Map<Object, InterfaceMirror> get types; |
- |
- /** |
- * Returns the source location for this library. |
- */ |
- Location get location; |
-} |
- |
-/** |
- * Common interface for classes, interfaces, typedefs and type variables. |
- */ |
-abstract class TypeMirror implements Mirror { |
- /** |
- * Returns the source location for this type. |
- */ |
- Location get location; |
- |
- /** |
- * Returns the library in which this member resides. |
- */ |
- LibraryMirror get library; |
- |
- /** |
- * Is [:true:] iff this type is the [:Object:] type. |
- */ |
- bool get isObject; |
- |
- /** |
- * Is [:true:] iff this type is the [:Dynamic:] type. |
- */ |
- bool get isDynamic; |
- |
- /** |
- * Is [:true:] iff this type is the void type. |
- */ |
- bool get isVoid; |
- |
- /** |
- * Is [:true:] iff this type is a type variable. |
- */ |
- bool get isTypeVariable; |
- |
- /** |
- * Is [:true:] iff this type is a typedef. |
- */ |
- bool get isTypedef; |
- |
- /** |
- * Is [:true:] iff this type is a function type. |
- */ |
- bool get isFunction; |
-} |
- |
-/** |
- * A class or interface type. |
- */ |
-abstract class InterfaceMirror implements TypeMirror, ObjectMirror { |
- /** |
- * Returns the defining type, i.e. declaration of a type. |
- */ |
- InterfaceMirror get declaration; |
- |
- /** |
- * Returns the super class of this type, or null if this type is [Object] or a |
- * typedef. |
- */ |
- InterfaceMirror get superclass; |
- |
- /** |
- * Returns an iterable over the interfaces directly implemented by this type. |
- */ |
- Map<Object, InterfaceMirror> get interfaces; |
- |
- /** |
- * Is [:true:] iff this type is a class. |
- */ |
- bool get isClass; |
- |
- /** |
- * Is [:true:] iff this type is an interface. |
- */ |
- bool get isInterface; |
- |
- /** |
- * Is [:true:] if this type is private. |
- */ |
- bool get isPrivate; |
- |
- /** |
- * Is [:true:] if this type is the declaration of a type. |
- */ |
- bool get isDeclaration; |
- |
- /** |
- * Returns a list of the type arguments for this type. |
- */ |
- List<TypeMirror> get typeArguments; |
- |
- /** |
- * Returns the list of type variables for this type. |
- */ |
- List<TypeVariableMirror> get typeVariables; |
- |
- /** |
- * Returns an immutable map of the constructors in this interface. |
- */ |
- Map<Object, MethodMirror> get constructors; |
- |
- /** |
- * Returns the default type for this interface. |
- */ |
- InterfaceMirror get defaultType; |
-} |
- |
-/** |
- * A type parameter as declared on a generic type. |
- */ |
-abstract class TypeVariableMirror implements TypeMirror { |
- /** |
- * Return a mirror on the class, interface, or typedef that declared the |
- * type variable. |
- */ |
- // Should not be called [declaration] as we then would have two [TypeMirror] |
- // subtypes ([InterfaceMirror] and [TypeVariableMirror]) which have |
- // [declaration()] methods but with different semantics. |
- InterfaceMirror get declarer; |
- |
- /** |
- * Returns the bound of the type parameter. |
- */ |
- TypeMirror get bound; |
-} |
- |
-/** |
- * A function type. |
- */ |
-abstract class FunctionTypeMirror implements InterfaceMirror { |
- /** |
- * Returns the return type of this function type. |
- */ |
- TypeMirror get returnType; |
- |
- /** |
- * Returns the parameters for this function type. |
- */ |
- List<ParameterMirror> get parameters; |
- |
- /** |
- * Returns the call method for this function type. |
- */ |
- MethodMirror get callMethod; |
-} |
- |
-/** |
- * A typedef. |
- */ |
-abstract class TypedefMirror implements InterfaceMirror { |
- /** |
- * Returns the defining type for this typedef. For instance [:void f(int):] |
- * for a [:typedef void f(int):]. |
- */ |
- TypeMirror get definition; |
-} |
- |
-/** |
- * A member of a type, i.e. a field, method or constructor. |
- */ |
-abstract class MemberMirror implements Mirror { |
- /** |
- * Returns the source location for this member. |
- */ |
- Location get location; |
- |
- /** |
- * Returns a mirror on the declaration immediately surrounding the reflectee. |
- * This could be a class, interface, library or another method or function. |
- */ |
- ObjectMirror get surroundingDeclaration; |
- |
- /** |
- * Returns true if this is a top level member, i.e. a member not within a |
- * type. |
- */ |
- bool get isTopLevel; |
- |
- /** |
- * Returns true if this member is a constructor. |
- */ |
- bool get isConstructor; |
- |
- /** |
- * Returns true if this member is a field. |
- */ |
- bool get isField; |
- |
- /** |
- * Returns true if this member is a method. |
- */ |
- bool get isMethod; |
- |
- /** |
- * Returns true if this member is private. |
- */ |
- bool get isPrivate; |
- |
- /** |
- * Returns true if this member is static. |
- */ |
- bool get isStatic; |
-} |
- |
-/** |
- * A field. |
- */ |
-abstract class FieldMirror implements MemberMirror { |
- |
- /** |
- * Returns true if this field is final. |
- */ |
- bool get isFinal; |
- |
- /** |
- * Returns the type of this field. |
- */ |
- TypeMirror get type; |
-} |
- |
-/** |
- * Common interface constructors and methods, including factories, getters and |
- * setters. |
- */ |
-abstract class MethodMirror implements MemberMirror { |
- /** |
- * Returns the list of parameters for this method. |
- */ |
- List<ParameterMirror> get parameters; |
- |
- /** |
- * Returns the return type of this method. |
- */ |
- TypeMirror get returnType; |
- |
- /** |
- * Is [:true:] if this method is a constant constructor. |
- */ |
- bool get isConst; |
- |
- /** |
- * Is [:true:] if this method is a factory method. |
- */ |
- bool get isFactory; |
- |
- /** |
- * Returns the constructor name for named constructors and factory methods, |
- * e.g. [:'bar':] for constructor [:Foo.bar:] of type [:Foo:]. |
- */ |
- String get constructorName; |
- |
- /** |
- * Is [:true:] if this method is a getter method. |
- */ |
- bool get isGetter; |
- |
- /** |
- * Is [:true:] if this method is a setter method. |
- */ |
- bool get isSetter; |
- |
- /** |
- * Is [:true:] if this method is an operator method. |
- */ |
- bool get isOperator; |
- |
- /** |
- * Returns the operator name for operator methods, e.g. [:'<':] for |
- * [:operator <:] |
- */ |
- String get operatorName; |
-} |
- |
-/** |
- * A formal parameter. |
- */ |
-abstract class ParameterMirror implements Mirror { |
- /** |
- * Returns the type of this parameter. |
- */ |
- TypeMirror get type; |
- |
- /** |
- * Returns the default value for this parameter. |
- */ |
- String get defaultValue; |
- |
- /** |
- * Returns true if this parameter has a default value. |
- */ |
- bool get hasDefaultValue; |
- |
- /** |
- * Returns true if this parameter is optional. |
- */ |
- bool get isOptional; |
- |
- /** |
- * Returns [:true:] iff this parameter is an initializing formal of a |
- * constructor. That is, if it is of the form [:this.x:] where [:x:] is a |
- * field. |
- */ |
- bool get isInitializingFormal; |
- |
- /** |
- * Returns the initialized field, if this parameter is an initializing formal. |
- */ |
- FieldMirror get initializedField; |
-} |
- |
-/** |
- * A [Location] describes the span of an entity in Dart source code. |
- * A [Location] should be the minimum span that encloses the declaration of the |
- * mirrored entity. |
- */ |
-abstract class Location { |
- /** |
- * The character position where the location begins. |
- */ |
- int get start; |
- |
- /** |
- * The character position where the location ends. |
- */ |
- int get end; |
- |
- /** |
- * Returns the [Source] in which this [Location] indexes. |
- * If [:loc:] is a location, [:loc.source().text()[loc.start()] is where it |
- * starts, and [:loc.source().text()[loc.end()] is where it ends. |
- */ |
- Source get source; |
- |
- /** |
- * The text of the location span. |
- */ |
- String get text; |
-} |
- |
-/** |
- * A [Source] describes the source code of a compilation unit in Dart source |
- * code. |
- */ |
-abstract class Source { |
- /** |
- * Returns the URI where the source originated. |
- */ |
- Uri get uri; |
- |
- /** |
- * Returns the text of this source. |
- */ |
- String get text; |
-} |