Integration test to load the default example of the default SDK and change the example

.gitignore

@@ -127,6 +127,7 @@ website/www/yarn-error.log
 **/.packages
 **/generated_plugin_registrant.dart
 playground/frontend/playground_components/pubspec.lock
+playground/frontend/playground_components_dev/pubspec.lock
 
 # Ignore Beam Playground Terraform
 **/.terraform

learning/tour-of-beam/frontend/pubspec.yaml

@@ -27,7 +27,7 @@ environment:
   flutter: '>=3.3.2'
 
 dependencies:
-  app_state: ^0.8.1
+  app_state: ^0.8.4
   collection: ^1.16.0
   easy_localization: ^3.0.1
   easy_localization_ext: ^0.1.0

playground/frontend/README.md

@@ -141,6 +141,37 @@ Code can be automatically reformatted using:
 flutter format ./lib
 ```
 
+### Unit Tests
+
+To delete all generated files and re-generate them again and then run tests:
+
+```bash
+./gradlew :playground:frontend:playground_components_test
+./gradlew :playground:frontend:test
+```
+
+To run tests without re-generating files:
+
+```bash
+cd playground/frontend/playground_components
+flutter test
+cd ..
+flutter test
+```
+
+### Integration Tests
+
+Integration tests currently can be run only on a local development machine.
+Server testing has not been verified yet.
+
+1. Install and run Chrome Driver: https://chromedriver.chromium.org/downloads
+2. Run it on port 4444: `chromedriver --port=4444`
+3. Run:
+
+```bash
+./gradlew :playground:frontend:integrationTest
+```
+
 ## Localization
 
 The project is in the process of migrating from

playground/frontend/build.gradle

@@ -17,18 +17,11 @@
  */
 
 
-apply plugin: 'org.apache.beam.module'
-apply plugin: 'base'
+apply(plugin: "org.apache.beam.module")
+apply(plugin: "base")
 applyDockerNature()
 
-def playgroundBackendUrl = project.playgroundBackendUrl
-def analyticsUA = project.analyticsUA
-def playgroundBackendJavaRouteUrl = project.playgroundBackendJavaRouteUrl
-def playgroundBackendGoRouteUrl = project.playgroundBackendGoRouteUrl
-def playgroundBackendPythonRouteUrl = project.playgroundBackendPythonRouteUrl
-def playgroundBackendScioRouteUrl = project.playgroundBackendScioRouteUrl
-
-def playgroundJobServerProject = "${project.path.replace('-container', '')}"
+def playgroundJobServerProject = "${project.path.replace("-container", "")}"
 
 description = project(playgroundJobServerProject).description + " :: Container"
 
@@ -37,10 +30,10 @@ configurations {
 }
 
 dependencies {
-  dockerDependency project(path: playgroundJobServerProject, configuration: "shadow")
+  dockerDependency(project(path: playgroundJobServerProject, configuration: "shadow"))
 }
 
-task generate {
+tasks.register("generate") {
   dependsOn("playground_components:generate")
 
   dependsOn("generateCode")
@@ -49,7 +42,7 @@ task generate {
   description = "Generates all generated files."
 }
 
-task printPath {
+tasks.register("printPath") {
   doLast {
     exec {
       executable("printenv")
@@ -58,7 +51,7 @@ task printPath {
   }
 }
 
-task analyze  {
+tasks.register("analyze") {
   dependsOn("playground_components:generateCode")
   dependsOn("generateCode")
 
@@ -74,7 +67,7 @@ task analyze  {
   }
 }
 
-task pubGet {
+tasks.register("pubGet") {
   group = "build"
   description = "Get packages for the playground frontend project"
   doLast {
@@ -85,7 +78,7 @@ task pubGet {
   }
 }
 
-task format {
+tasks.register("format") {
   group = "build"
   description = "Idiomatically format Dart source code"
   doLast {
@@ -97,9 +90,10 @@ task format {
   }
 }
 
-task run {
+tasks.register("run") {
   group = "application"
   description = "Run application on Google Chrome"
+
   doLast {
     exec {
       executable("flutter")
@@ -108,7 +102,7 @@ task run {
   }
 }
 
-task test {
+tasks.register("test") {
   dependsOn("playground_components:generateCode")
   dependsOn("generateCode")
 
@@ -123,14 +117,14 @@ task test {
   }
 }
 
-task precommit {
+tasks.register("precommit") {
   dependsOn("playground_components:precommit")
 
   dependsOn("analyze")
   dependsOn("test")
 }
 
-task generateCode {
+tasks.register("generateCode") {
   dependsOn("playground_components:generateCode")
 
   dependsOn("cleanFlutter")
@@ -147,7 +141,7 @@ task generateCode {
   }
 }
 
-task cleanFlutter {
+tasks.register("cleanFlutter") {
   group = "build"
   description = "Remove build artifacts"
 
@@ -159,7 +153,7 @@ task cleanFlutter {
   }
 }
 
-task cleanGenerated {
+tasks.register("cleanGenerated") {
   dependsOn("playground_components:cleanGenerated")
 
   group = "build"
@@ -188,75 +182,54 @@ ext.deleteFilesByRegExp = { re ->
   }
 }
 
+tasks.register("integrationTest") {
+  dependsOn("integrationTest_standalone_change_example")
+}
+
+tasks.register("integrationTest_standalone_change_example") {
+  runIntegrationTest("standalone_change_example", "/")
+}
+
+void runIntegrationTest(String path, String url) {
+  exec {
+    executable("flutter")
+    args(
+      "drive",
+      "--driver=test_driver/integration_test.dart",
+      "--target=integration_test/${path}_test.dart",
+      "--web-launch-url='$url'",
+      "--device-id=chrome",
+    )
+  }
+}
+
 task copyDockerfileDependencies(type: Copy) {
    group = "build"
    description = "Copy files that required to build docker container"
    copy {
-      from '.'
-      into 'build/'
-      exclude 'build'
-      exclude 'Dockerfile'
+      from(".")
+      into("build/")
+      exclude("build")
+      exclude("Dockerfile")
    }
    copy {
-      from '../playground'
-      into 'build/playground'
+      from("../playground")
+      into("build/playground")
    }
 }
 
 docker {
   group = "build"
   description = "Build container for playground frontend application"
-  name containerImageName(
-          name: project.docker_image_default_repo_prefix + "playground-frontend",
-          root: project.rootProject.hasProperty(["docker-repository-root"]) ?
-                  project.rootProject["docker-repository-root"] :
-                  project.docker_image_default_repo_root)
-  files "./build/"
-  tags containerImageTags()
-  buildArgs(['FLUTTER_VERSION': project.rootProject.hasProperty(["flutter-version"]) ?
-                                project.rootProject["flutter-version"] :
-                                "3.3.2" ])
+  name = containerImageName(
+    name: project.docker_image_default_repo_prefix + "playground-frontend",
+    root: project.rootProject.hasProperty(["docker-repository-root"])
+            ? project.rootProject["docker-repository-root"]
+            : project.docker_image_default_repo_root
+  )
+  files("./build/")
+  tags(containerImageTags())
 }
 
 // Ensure that we build the required resources and copy and file dependencies from related projects
-dockerPrepare.dependsOn copyDockerfileDependencies
-
-task("createConfig") {
-  group = "build"
-  description = "Generate config for the playground frontend project"
-  doLast {
-    def configFileName = "config.g.dart"
-    def modulePath = project(":playground:frontend").projectDir.absolutePath
-    def file = new File(modulePath + "/lib", configFileName)
-    file.write("""/*
- * Licensed to the Apache Software Foundation (ASF) under one
- * or more contributor license agreements.  See the NOTICE file
- * distributed with this work for additional information
- * regarding copyright ownership.  The ASF licenses this file
- * to you under the Apache License, Version 2.0 (the
- * "License"); you may not use this file except in compliance
- * with the License.  You may obtain a copy of the License at
- *
- *     http://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing, software
- * distributed under the License is distributed on an "AS IS" BASIS,
- * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- * See the License for the specific language governing permissions and
- * limitations under the License.
- */
-
-const String kApiClientURL =
-    '${playgroundBackendUrl}';
-const String kAnalyticsUA = '${analyticsUA}';
-const String kApiJavaClientURL =
-    '${playgroundBackendJavaRouteUrl}';
-const String kApiGoClientURL =
-    '${playgroundBackendGoRouteUrl}';
-const String kApiPythonClientURL =
-    '${playgroundBackendPythonRouteUrl}';
-const String kApiScioClientURL =
-    '${playgroundBackendScioRouteUrl}';
-""")
-  }
-}
+dockerPrepare.dependsOn(copyDockerfileDependencies)

playground/frontend/integration_test/common.dart

@@ -0,0 +1,37 @@
+/*
+ * Licensed to the Apache Software Foundation (ASF) under one
+ * or more contributor license agreements.  See the NOTICE file
+ * distributed with this work for additional information
+ * regarding copyright ownership.  The ASF licenses this file
+ * to you under the Apache License, Version 2.0 (the
+ * "License"); you may not use this file except in compliance
+ * with the License.  You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+import 'package:flutter/widgets.dart';
+import 'package:flutter_test/flutter_test.dart';
+import 'package:playground/main.dart' as app;
+import 'package:playground/modules/examples/example_selector.dart';
+
+Future<void> init(WidgetTester wt) async {
+  app.main();
+  await wt.pumpAndSettle();
+}
+
+extension CommonFindersExtension on CommonFinders {
+  Finder exampleSelector() {
+    return byType(ExampleSelector);
+  }
+
+  Finder exampleItemInDropdown(String name) {
+    return widgetWithText(GestureDetector, name);
+  }
+}

playground/frontend/integration_test/standalone_change_example_test.dart

@@ -0,0 +1,49 @@
+/*
+ * Licensed to the Apache Software Foundation (ASF) under one
+ * or more contributor license agreements.  See the NOTICE file
+ * distributed with this work for additional information
+ * regarding copyright ownership.  The ASF licenses this file
+ * to you under the Apache License, Version 2.0 (the
+ * "License"); you may not use this file except in compliance
+ * with the License.  You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+import 'package:flutter_test/flutter_test.dart';
+import 'package:integration_test/integration_test.dart';
+import 'package:playground_components_dev/playground_components_dev.dart';
+
+import 'common.dart';
+
+void main() {
+  IntegrationTestWidgetsFlutterBinding.ensureInitialized();
+
+  group('Integration.', () {
+    testWidgets('Change example', (WidgetTester wt) async {
+      await init(wt);
+
+      expect(
+        wt.findOneCodeController().lastTextSpan!.toPlainText(),
+        await Examples.getJavaVisibleText(ExamplePaths.javaMinimalWordCount),
+      );
+
+      await wt.tap(find.exampleSelector());
+      await wt.pumpAndSettle();
+
+      await wt.tap(find.exampleItemInDropdown(ExampleNames.aggregationMax));
+      await wt.pumpAndSettle();
+
+      expect(
+        wt.findOneCodeController().lastTextSpan!.toPlainText(),
+        await Examples.getJavaVisibleText(ExamplePaths.javaAggregationMax),
+      );
+    });
+  });
+}

playground/frontend/lib/main.dart

@@ -42,7 +42,7 @@ void main() async {
 
   // Router API specific initialization.
   final pageStack = GetIt.instance.get<PageStack>();
-  final routerDelegate = PageStackRouterDelegate(pageStack);
+  final routerDelegate = BeamRouterDelegate(pageStack);
   final routeInformationParser = PlaygroundRouteInformationParser();
   final backButtonDispatcher = PageStackBackButtonDispatcher(pageStack);