Create package leak_tracker_flutter_testing.

.github/workflows/ci.yaml

@@ -37,7 +37,7 @@ jobs:
 
       - name: flutter test
         run: flutter test
-        working-directory: pkgs/leak_tracker_flutter_test
+        working-directory: pkgs/leak_tracker_flutter_testing
 
       - name: integration test
         run: flutter test integration_test/app_test.dart -d flutter-tester

README.md

@@ -1,28 +1,17 @@
 
-Coming soon! See https://github.com/flutter/devtools/issues/3951 and https://github.com/flutter/devtools/issues/5606.
-
-The text below is under construction.
-
 [![CI](https://github.com/dart-lang/leak_tracker/actions/workflows/ci.yaml/badge.svg)](https://github.com/dart-lang/leak_tracker/actions/workflows/ci.yaml)
 
 # Memory Leak Tracker
 
-This is a framework for detecting memory issues in Dart and Flutter applications. It enables:
-
-1. [Memory leak auto-detection](doc/DETECT.md) for applications and tests.
-2. [Memory usage tracking and auto-snapshotting](doc/USAGE.md).
-
-Documentation:
-1. [Understand leak tracking concepts](doc/CONCEPTS.md).
-2. [Troubleshoot memory leaks](doc/TROUBLESHOOT.md).
+This is a framework for detecting memory issues in Dart and Flutter applications.
 
 ## Packages
 
 | Package | Description | Version |
 | --- | --- | --- |
-| [leak_tracker](pkgs/leak_tracker/) | A framework for memory leak tracking for Dart and Flutter applications. | [![pub package](https://img.shields.io/pub/v/leak_tracker.svg)](https://pub.dev/packages/leak_tracker) |
-| [leak_tracker_flutter_test](pkgs/leak_tracker_flutter_test/) | Tests for leak_tracker that depend on Flutter framework. |  |
-| [leak_tracker_testing](pkgs/leak_tracker_testing/) | Leak tracking code intended for usage in tests. | [![pub package](https://img.shields.io/pub/v/leak_tracker_testing.svg)](https://pub.dev/packages/leak_tracker_testing) |
+| [leak_tracker](pkgs/leak_tracker/) | A framework for detecting memory issues for Dart and Flutter applications. | [![pub package](https://img.shields.io/pub/v/leak_tracker.svg)](https://pub.dev/packages/leak_tracker) |
+| [leak_tracker_flutter_testing](pkgs/leak_tracker_flutter_testing/) | Leak tracking helpers intended for usage in Flutter tests. | [![pub package](https://img.shields.io/pub/v/leak_tracker_flutter_testing.svg)](https://pub.dev/packages/leak_tracker_flutter_testing) |
+| [leak_tracker_testing](pkgs/leak_tracker_testing/) | Leak tracking helpers intended for usage in tests. | [![pub package](https://img.shields.io/pub/v/leak_tracker_testing.svg)](https://pub.dev/packages/leak_tracker_testing) |
 
 ## How to enable logs
 

pkgs/leak_tracker/README.md

@@ -1,6 +1,18 @@
 [![pub package](https://img.shields.io/pub/v/leak_tracker.svg)](https://pub.dev/packages/leak_tracker)
 [![package publisher](https://img.shields.io/pub/publisher/leak_tracker.svg)](https://pub.dev/packages/leak_tracker/publisher)
 
-Coming soon!
+Coming soon! See https://github.com/flutter/devtools/issues/3951 and https://github.com/flutter/devtools/issues/5606.
 
-See full documentation at https://github.com/dart-lang/leak_tracker.
+The text below is under construction.
+
+This is a framework for detecting memory issues in Dart and Flutter applications.
+
+It enables:
+
+1. [Memory leak auto-detection](https://github.com/dart-lang/leak_tracker/blob/main/doc/DETECT.md) for applications and tests.
+2. [Memory usage tracking and auto-snapshotting](https://github.com/dart-lang/leak_tracker/blob/main/doc/USAGE.md).
+
+Read more:
+
+1. [Understand leak tracking concepts](https://github.com/dart-lang/leak_tracker/blob/main/doc/CONCEPTS.md).
+2. [Troubleshoot memory leaks](https://github.com/dart-lang/leak_tracker/blob/main/doc/TROUBLESHOOT.md).

pkgs/leak_tracker/lib/src/leak_tracking/leak_tracking.dart

@@ -2,13 +2,16 @@
 // 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.
 
+import 'package:logging/logging.dart';
 import '../devtools_integration/_registration.dart';
 import '../shared/_primitives.dart';
 import '../shared/shared_model.dart';
 import '_leak_tracker.dart';
 import '_primitives/_dispatcher.dart' as dispatcher;
 import '_primitives/model.dart';
 
+final _log = Logger('leak_tracking.dart');
+
 /// Provides leak tracking functionality.
 abstract class LeakTracking {
   static LeakTracker? _leakTracker;
@@ -72,6 +75,7 @@ abstract class LeakTracking {
       } else {
         registerLeakTrackingServiceExtension();
       }
+      _log.info('started leak tracking');
       return true;
     }());
   }
@@ -83,6 +87,7 @@ abstract class LeakTracking {
     assert(() {
       _leakTracker?.dispose();
       _leakTracker = null;
+      _log.info('stopped leak tracking');
       return true;
     }());
   }

pkgs/leak_tracker_flutter_testing/CHANGELOG.md

@@ -0,0 +1,3 @@
+# 1.0.0
+
+* First release.

pkgs/leak_tracker_flutter_testing/README.md

@@ -0,0 +1,22 @@
+[![pub package](https://img.shields.io/pub/v/leak_tracker_testing.svg)](https://pub.dev/packages/leak_tracker_testing)
+[![package publisher](https://img.shields.io/pub/publisher/leak_tracker_testing.svg)](https://pub.dev/packages/leak_tracker_testing/publisher)
+
+Coming soon! See https://github.com/flutter/devtools/issues/3951.
+
+The text below is under construction.
+
+## What is this?
+
+This is Flutter specific test helpers for [leak_tracker](https://pub.dev/packages/leak_tracker).
+
+## How to use the helpers?
+
+To make your widget test failing in case of leaks, use `testWidgetsWithLeakTracking` instead of `testWidgets`:
+
+```
+testWidgetsWithLeakTracking('not leaking', (widgetTester) async {
+    ...
+});
+```
+
+See more examples in [end_to_end_test.dart](https://github.com/dart-lang/leak_tracker/tree/main/pkgs/leak_tracker_flutter_testing/test/tests/end_to_end).

pkgs/leak_tracker_flutter_testing/lib/leak_tracker_flutter_testing.dart

@@ -0,0 +1,6 @@
+// Copyright (c) 2022, 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.
+
+export 'src/leak_tracking_flutter_testing.dart';
+export 'src/model.dart';