added generic information

pkg/docgen/lib/docgen.dart

 // Copyright (c) 2013, 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.
 
 /**
  * **docgen** is a tool for creating machine readable representations of Dart
  * code metadata, including: classes, members, comments and annotations.
  *
  * docgen is run on a `.dart` file or a directory containing `.dart` files.
  *
@@ skipping 350 matching lines @@
  * Returns a map of [Class] objects constructed from inputted mirrors.
  */
 Map<String, Class> _getClasses(Map<String, ClassMirror> mirrorMap,
     bool includePrivate) {
   
   var abstractClasses = {};
   var classes = {};
   var typedefs = {};
   var errors = {};
   
-  mirrorMap.forEach((String mirrorName, ClassMirror mirror) {
+  mirrorMap.forEach((String mirrorName, ClassMirror mirror) {    
     if (includePrivate || !mirror.isPrivate) {
       var superclass = (mirror.superclass != null) ?
           mirror.superclass.qualifiedName : '';
       var interfaces =
           mirror.superinterfaces.map((interface) => interface.qualifiedName);
       var clazz = new Class(mirrorName, superclass, _getComment(mirror), 
           interfaces.toList(), _getVariables(mirror.variables, includePrivate),
           _getMethods(mirror.methods, includePrivate),
-          _getAnnotations(mirror), mirror.qualifiedName);
+          _getAnnotations(mirror), _getGenerics(mirror), mirror.qualifiedName);
       _currentClass = mirror;
       
       if (isError(mirror.qualifiedName)) {
         errors[mirrorName] = clazz;
       } else if (mirror.isTypedef) {
         typedefs[mirrorName] = clazz;
       } else if (mirror.isAbstract) {
         abstractClasses[mirrorName] = clazz;
       } else if (mirror.isClass) {
         classes[mirrorName] = clazz;
@@ skipping 19 matching lines @@
     _currentMember = mirror;
     data[mirror.simpleName] = new Parameter(mirror.simpleName, 
         mirror.isOptional, mirror.isNamed, mirror.hasDefaultValue, 
         mirror.type.qualifiedName, mirror.defaultValue, 
         _getAnnotations(mirror));
   });
   return data;
 }
 
 /**
+ * Returns a map of [Generic] objects constructed from the class mirror. 
+ */
+Map<String, Generic> _getGenerics(ClassMirror mirror) {
+  var data = {};

[Alan Knight, 2013/07/18 22:20:46]

Today I learned... you could write this as
new Map.fromIterable(mirror.typeVariables.values,
      key: (e) => e.toString(),
      value: (e) => new Generic(e.toString(), e.upperBound.qualifiedName));

[janicejl, 2013/07/19 01:12:22]

Done. That's really neat. Thanks for letting me know. 

+  mirror.typeVariables.forEach((e) {
+    data[e.toString()] = new Generic(e.toString(), e.upperBound.qualifiedName);
+  });
+  return data;
+}
+
+/**
  * Writes text to a file in the 'docs' directory.
  */
 void _writeToFile(String text, String filename) {
   Directory dir = new Directory('docs');
   if (!dir.existsSync()) {
     dir.createSync();
   }
   File file = new File('docs/$filename');
   if (!file.existsSync()) {
     file.createSync();
@@ skipping 78 matching lines @@
 
   /// List of the names of interfaces that this class implements.
   List<String> interfaces;
 
   /// Top-level variables in the class.
   Map<String, Variable> variables;
 
   /// Methods in the class.
   Map<String, Map<String, Method>> methods;
   
+  /// Generic infomation about the class. 
+  Map<String, Generic> generics;
+  
   String name;
   String superclass;
 
   /// List of the meta annotations on the class.
   List<String> annotations;
   
   Class(this.name, this.superclass, this.comment, this.interfaces, 
-      this.variables, this.methods, this.annotations, 
+      this.variables, this.methods, this.annotations, this.generics,
       String qualifiedName) : super(qualifiedName) {}
 
   /// Generates a map describing the [Class] object.
   Map toMap() {
     var classMap = {};
     classMap['name'] = name;
     classMap['comment'] = comment;
     classMap['superclass'] = superclass;
     classMap['implements'] = new List.from(interfaces);
     classMap['variables'] = recurseMap(variables);
     classMap['methods'] = recurseMap(methods);
     classMap['annotations'] = new List.from(annotations);
+    classMap['generics'] = recurseMap(generics);
     return classMap;
   }
 }
 
 /**
  * A class containing properties of a Dart variable.
  */
 class Variable extends Indexable {
 
   /// Documentation comment with converted markdown.
@@ skipping 82 matching lines @@
     parameterMap['name'] = name;
     parameterMap['optional'] = isOptional.toString();
     parameterMap['named'] = isNamed.toString();
     parameterMap['default'] = hasDefaultValue.toString();
     parameterMap['type'] = type;
     parameterMap['value'] = defaultValue;
     parameterMap['annotations'] = new List.from(annotations);
     return parameterMap;
   }
 }
+
+/**
+ * A class containing properties of a Generic. 
+ */
+class Generic {
+  String name;
+  String type;
+  
+  Generic(this.name, this.type);
+  
+  Map toMap() {
+    var genericMap = {};
+    genericMap['name'] = name;

[Alan Knight, 2013/07/18 22:20:46]

You could write this as

=> {"name" : name, "type" : type}

[janicejl, 2013/07/19 01:12:22]

Done.

+    genericMap['type'] = type;
+    return genericMap;
+  }
+}