Owen/control docs p5 (#5845)

* add search bar example tests and images

* try to read flutter output from flet_test_app.py

* revert changes on flet_test_app.py

* add row, slider, search_bar example tests and update docs; add tap_at function to flet Tester

* use existing ft.Offset object as argument to tap_at

* use parseOffset

* fix tester doctring for tap_at, fix spacing, condense dart case

* fix tap_at call in tests

* fix row example images sizing

* add reference to utils/transforms.dart

* update imports to tester service

---------

Co-authored-by: Feodor Fitsner <feodor@appveyor.com>

Author: OwenMcDonnell

client/integration_test/flutter_tester.dart

@@ -74,23 +74,24 @@ class FlutterWidgetTester implements Tester {
   }
 
   @override
-  Future<void> tap(TestFinder finder, int finderIndex) async {
-    await _tester.tap((finder as FlutterTestFinder).raw.at(finderIndex));
-  }
+  Future<void> tap(TestFinder finder, int finderIndex) =>
+      _tester.tap((finder as FlutterTestFinder).raw.at(finderIndex));
 
   @override
-  Future<void> longPress(TestFinder finder, int finderIndex) async {
-    await _tester.longPress((finder as FlutterTestFinder).raw.at(finderIndex));
-  }
+  Future<void> tapAt(Offset offset) =>
+      _tester.tapAt(offset);
+
+  @override
+  Future<void> longPress(TestFinder finder, int finderIndex) =>
+      _tester.longPress((finder as FlutterTestFinder).raw.at(finderIndex));
 
   @override
   Future<void> enterText(
-      TestFinder finder, int finderIndex, String text) async {
-    await _tester.enterText(
-      (finder as FlutterTestFinder).raw.at(finderIndex),
-      text,
-    );
-  }
+      TestFinder finder, int finderIndex, String text) =>
+      _tester.enterText(
+        (finder as FlutterTestFinder).raw.at(finderIndex),
+        text,
+      );
 
   @override
   Future<void> mouseHover(TestFinder finder, int finderIndex) async {

packages/flet/lib/src/services/tester.dart

@@ -5,6 +5,8 @@ import '../testing/test_finder.dart';
 import '../utils/icons.dart';
 import '../utils/keys.dart';
 import '../utils/time.dart';
+import 'package:flet/src/utils/transforms.dart';
+
 
 class TesterService extends FletService {
   TesterService({required super.control});
@@ -82,6 +84,12 @@ class TesterService extends FletService {
           await control.backend.tester!.tap(finder, args["finder_index"]);
         }
 
+      case "tap_at":
+        var offset = parseOffset(args["offset"]);
+        if (offset != null) {
+          await control.backend.tester!.tapAt(offset);
+        }
+
       case "long_press":
         var finder = _finders[args["finder_id"]];
         if (finder != null) {

packages/flet/lib/src/testing/tester.dart

@@ -13,6 +13,7 @@ abstract class Tester {
   TestFinder findByTooltip(String value);
   TestFinder findByIcon(IconData icon);
   Future<Uint8List> takeScreenshot(String name);
+  Future<void> tapAt(Offset offset);
   Future<void> tap(TestFinder finder, int finderIndex);
   Future<void> longPress(TestFinder finder, int finderIndex);
   Future<void> enterText(TestFinder finder, int finderIndex, String text);

sdk/python/examples/controls/row/__init__.py

@@ -44,4 +44,5 @@ def main(page: ft.Page):
     )
 
 
-ft.run(main)
+if __name__ == "__main__":
+    ft.run(main)

sdk/python/examples/controls/row/alignment.py

@@ -24,6 +24,7 @@ def handle_slider_change(e: ft.Event[ft.Slider]):
             controls=[
                 ft.Text("Spacing between items"),
                 ft.Slider(
+                    key="slider",
                     min=0,
                     max=50,
                     divisions=50,
@@ -39,4 +40,5 @@ def handle_slider_change(e: ft.Event[ft.Slider]):
     )
 
 
-ft.run(main)
+if __name__ == "__main__":
+    ft.run(main)

sdk/python/examples/controls/row/spacing.py

@@ -35,4 +35,5 @@ def main(page: ft.Page):
     )
 
 
-ft.run(main)
+if __name__ == "__main__":
+    ft.run(main)

sdk/python/examples/controls/row/vertical_alignment.py

@@ -45,4 +45,5 @@ def handle_slider_change(e: ft.Event[ft.Slider]):
     )
 
 
-ft.run(main)
+if __name__ == "__main__":
+    ft.run(main)

sdk/python/examples/controls/row/wrap.py

@@ -15,7 +15,7 @@
 def main(page: ft.Page):
     page.horizontal_alignment = ft.CrossAxisAlignment.CENTER
 
-    def build_tiles(items: list[str]) -> list[ft.ListTile]:
+    def build_tiles(items: list[str]) -> list[ft.Control]:
         return [
             ft.ListTile(
                 title=ft.Text(item),
@@ -55,4 +55,5 @@ async def handle_tap(e: ft.Event[ft.SearchBar]):
     )
 
 
-ft.run(main)
+if __name__ == "__main__":
+    ft.run(main)