Support native extensions for analysis and docgen.

pkg/docgen/test/native_extensions_test.dart

 // Copyright (c) 2014, 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 single_library_test;
+library native_extensions_test;
 
 import 'dart:io';
 
 import 'package:path/path.dart' as path;
 import 'package:unittest/unittest.dart';
 
 import '../lib/src/exports/mirrors_util.dart' as dart2js_util;
 import '../lib/docgen.dart';
 
 const String DART_LIBRARY = '''
-  library test;
-  /**
-   * Doc comment for class [A].
-   *
-   * Multiline Test
-   */
-  /*
-   * Normal comment for class A.
-   */
-  class A {
+  library sample_synchronous_extension;
 
-    int _someNumber;
+  import 'dart-ext:sample_extension';
 
-    A() {
-      _someNumber = 12;
-    }
+  // The simplest way to call native code: top-level functions.
+  int systemRand() native "SystemRand";
+  bool systemSrand(int seed) native "SystemSrand";
 
-    /**
-     * Test for linking to parameter [A]
-     */
-    void doThis(int A) {
-      print(A);
-    }
-  }
-
-  main() {
-    A a = new A();
-    a.doThis(5);
+  void main() {
+    systemRand();
+    systemSrand(4);
   }
 ''';
 
 main() {
   group('Generate docs for', () {
-    test('one simple file.', () {
-      var temporaryDir = Directory.systemTemp.createTempSync('single_library_');
+    test('file with native extensions.', () {
+      var temporaryDir = Directory.systemTemp.createTempSync('native_ext_');
       var fileName = path.join(temporaryDir.path, 'temp.dart');
       var file = new File(fileName);
       file.writeAsStringSync(DART_LIBRARY);
 
       return getMirrorSystem([new Uri.file(fileName)], false)
         .then((mirrorSystem) {
           var testLibraryUri = new Uri.file(path.absolute(fileName),
                                             windows: Platform.isWindows);
           var library = new Library(mirrorSystem.libraries[testLibraryUri]);
           expect(library is Library, isTrue);
 
           var classTypes = library.classes;
           var classes = [];
           classes.addAll(classTypes.values);
           classes.addAll(library.errors.values);
           expect(classes.every((e) => e is Class), isTrue);
 
           expect(library.typedefs.values.every((e) => e is Typedef), isTrue);
 
           var classMethodTypes = [];
           classes.forEach((e) {
             classMethodTypes.add(e.methods);
             classMethodTypes.add(e.inheritedMethods);
           });
-          expect(classMethodTypes.every((e) => e is Map<String, Method>), isTrue);
+          expect(classMethodTypes.every((e) => e is Map<String, Method>),
+                 isTrue);
 
           var classMethods = [];
           classMethodTypes.forEach((e) {
             classMethods.addAll(e.values);
           });
           expect(classMethods.every((e) => e is Method), isTrue);
 
           var methodParameters = [];
           classMethods.forEach((e) {
             methodParameters.addAll(e.parameters.values);
           });
           expect(methodParameters.every((e) => e is Parameter), isTrue);
 
           var functionTypes = library.functions;
           expect(functionTypes is Map<String, Method>, isTrue);
 
           var functions = [];
           functions.addAll(functionTypes.values);
           expect(functions.every((e) => e is Method), isTrue);
 
           var functionParameters = [];
           functions.forEach((e) {
             functionParameters.addAll(e.parameters.values);
           });
           expect(functionParameters.every((e) => e is Parameter), isTrue);
 
           var variables = library.variables.values;
           expect(variables.every((e) => e is Variable), isTrue);
 
-          /// Testing fixReference
-          // Testing Doc comment for class [A].
-          var libraryMirror = mirrorSystem.libraries[testLibraryUri];
-          var classMirror =
-              dart2js_util.classesOf(libraryMirror.declarations).first;
-          var classDocComment = library.fixReference('A').children.first.text;
-          expect(classDocComment, 'test.A');
+          // Testing trying to refer to m1 function
+          var libraryDocComment =
+              library.fixReference('systemRand').children.first.text;
+          expect(libraryDocComment, 'sample_synchronous_extension.systemRand');
 
-          // Test for linking to parameter [A]
-          var method = getDocgenObject(
-              classMirror.declarations[dart2js_util.symbolOf('doThis')]);
-          var methodParameterDocComment = method.fixReference(
-              'A').children.first.text;
-          expect(methodParameterDocComment, 'test.A.doThis.A');
-
-          // Testing trying to refer to doThis function
-          var methodDocComment = method.fixReference(
-              'doThis').children.first.text;
-          expect(methodDocComment, 'test.A.doThis');
-
-          // Testing something with no reference
-          var libraryDocComment = method.fixReference('foobar').text;
-          expect(libraryDocComment, 'foobar');
+          libraryDocComment =
+              library.fixReference('systemSrand').children.first.text;
+          expect(libraryDocComment, 'sample_synchronous_extension.systemSrand');
         }).whenComplete(() => temporaryDir.deleteSync(recursive: true));
     });
   });
 }