Merge pull request #793 from Hixie/performance-debugging

Debugging aids for overlays, performances

packages/flutter/lib/src/animation/performance.dart

@@ -53,6 +53,45 @@ abstract class PerformanceView {
 
   /// Whether this animation is stopped at the end
   bool get isCompleted => status == PerformanceStatus.completed;
+
+  String toString() {
+    return '$runtimeType(${toStringDetails()})';
+  }
+  String toStringDetails() {
+    assert(status != null);
+    assert(direction != null);
+    String icon;
+    switch (status) {
+      case PerformanceStatus.forward:
+        icon = '\u25B6'; // >
+        break;
+      case PerformanceStatus.reverse:
+        icon = '\u25C0'; // <
+        break;
+      case PerformanceStatus.completed:
+        switch (direction) {
+          case AnimationDirection.forward:
+            icon = '\u23ED'; // >>|
+            break;
+          case AnimationDirection.reverse:
+            icon = '\u29CF'; // <|
+            break;
+        }
+        break;
+      case PerformanceStatus.dismissed:
+        switch (direction) {
+          case AnimationDirection.forward:
+            icon = '\u29D0'; // |>
+            break;
+          case AnimationDirection.reverse:
+            icon = '\u23EE'; // |<<
+            break;
+        }
+        break;
+    }
+    assert(icon != null);
+    return '$icon ${progress.toStringAsFixed(3)}';
+  }
 }
 
 class AlwaysCompletePerformance extends PerformanceView {
@@ -512,9 +551,9 @@ class Performance extends PerformanceView
 
   SimulationStepper _timeline;
   AnimationDirection get direction => _direction;
-  AnimationDirection _direction;
+  AnimationDirection _direction = AnimationDirection.forward;
   AnimationDirection get curveDirection => _curveDirection;
-  AnimationDirection _curveDirection;
+  AnimationDirection _curveDirection = AnimationDirection.forward;
 
   /// The progress of this performance along the timeline
   ///
@@ -624,10 +663,11 @@ class Performance extends PerformanceView
     _checkStatusChanged();
   }
 
-  String toString() {
-    if (debugLabel != null)
-      return '$runtimeType at $progress for $debugLabel';
-    return '$runtimeType at $progress';
+  String toStringDetails() {    
+    String paused = _timeline.isAnimating ? '' : '; paused';
+    String label = debugLabel == null ? '' : '; for $debugLabel';
+    String more = super.toStringDetails();
+    return '$more$paused$label';
   }
 }
 

packages/flutter/lib/src/widgets/overlay.dart

@@ -34,6 +34,8 @@ class OverlayEntry {
     // TODO(ianh): find a way to make this not rebuild the entire overlay
     _state?.setState(() {});
   }
+
+  String toString() => '$runtimeType@$hashCode(opaque: $opaque)';
 }
 
 class Overlay extends StatefulComponent {
@@ -120,4 +122,9 @@ class OverlayState extends State<Overlay> {
 
     return new Stack(backwardsChildren.reversed.toList(growable: false));
   }
+
+  void debugFillDescription(List<String> description) {
+    super.debugFillDescription(description);
+    description.add('entries: $_entries');
+  }
 }

packages/flutter/lib/src/widgets/transitions.dart

@@ -209,7 +209,8 @@ class AlignTransition extends TransitionWithChild {
       alignment: alignment?.value,
       widthFactor: widthFactor?.value,
       heightFactor: heightFactor?.value,
-      child: child);
+      child: child
+    );
   }
 }