Cleaned up some code, added a logger, and got rid of print statements.

Author: matthew-carroll

README.md

@@ -1,2 +1,40 @@
 # Flutter Test Goldens
 A toolkit for writing golden tests.
+
+## Getting Started
+The following shows an example of how to define a golden test that captures
+screenshots over time, placing all of them in a single scene file.
+
+```dart
+testGoldenSceneOnMac("elevated button interactions", (tester) async {
+    final goldenKey = GlobalKey();
+
+    await FilmStrip(tester)
+        // Setup the widget tree.
+        .setupWithPump(() {
+          return FlutterWidgetScaffold(
+            goldenKey: goldenKey,
+            child: ElevatedButton(
+              onPressed: () {},
+              child: Text("Hello"),
+            ),
+          );
+        })
+        // Take a photo.
+        .takePhoto(find.byKey(goldenKey), "idle")
+        // Adjust the existing widget tree by hovering over the ElevatedButton.
+        .hoverOver(find.byType(ElevatedButton))
+        // Take a photo.
+        .takePhoto(find.byKey(goldenKey), "hover")
+        // Adjust the existing widget tree by pressing down at the current offset.
+        .pressHover()
+        // Take a photo.
+        .takePhoto(find.byKey(goldenKey), "pressed")
+        // Either stitch the photos into a single scene file, or compare them against
+        // an existing scene file.
+        .renderOrCompareGolden(
+          goldenName: "button_elevated_interactions",
+          layout: FilmStripLayout.row,
+        );
+});
+```

lib/flutter_test_goldens.dart

@@ -1,5 +1,12 @@
+export 'src/flutter/flutter_test_extensions.dart';
 export 'src/fonts/fonts.dart';
 export 'src/galleries/film_strip.dart';
 export 'src/galleries/gallery.dart';
 export 'src/goldens/golden_camera.dart';
+export 'src/goldens/golden_collections.dart';
+export 'src/goldens/golden_comparisons.dart';
+export 'src/goldens/golden_rendering.dart';
+export 'src/goldens/golden_scenes.dart';
+export 'src/qr_codes/qr_code_image_scanning.dart';
+export 'src/logging.dart';
 export 'src/test_runners.dart';

lib/src/flutter/flutter_test_extensions.dart

@@ -1,6 +1,7 @@
 import 'package:flutter/gestures.dart';
 import 'package:flutter/widgets.dart';
 import 'package:flutter_test/flutter_test.dart';
+import 'package:flutter_test_goldens/flutter_test_goldens.dart';
 
 extension FlutterTestGoldens on WidgetTester {
   /// Pumps a [widgetTree] and then adjusts the test window size to exactly match the
@@ -14,7 +15,7 @@ extension FlutterTestGoldens on WidgetTester {
   /// of the test window is changed to match [widgetTree]. Finally, [widgetTree] is pumped
   /// again with the final window size.
   Future<void> pumpWidgetAndAdjustWindow(Widget widgetTree) async {
-    print("Pumping a widget tree and adjusting window size.");
+    FtgLog.pipeline.fine("Pumping a widget tree and adjusting window size.");
     final contentKey = GlobalKey();
 
     await pumpWidget(
@@ -36,7 +37,7 @@ extension FlutterTestGoldens on WidgetTester {
 
     // Look up the natural content dimensions.
     final contentSize = contentKey.currentContext!.size!;
-    print("Content size: $contentSize");
+    FtgLog.pipeline.fine("Final content and window size: $contentSize");
 
     // Change test window to exactly fit widget tree.
     view.physicalSize = contentSize;