Combined UFG + Classic

Author: AutomationPanda

Applitools.Example.Tests/AcmeBankTest.cs

@@ -3,6 +3,7 @@
 using NUnit.Framework;
 using OpenQA.Selenium;
 using OpenQA.Selenium.Chrome;
+using OpenQA.Selenium.Remote;
 using System.Drawing;
 using ScreenOrientation = Applitools.VisualGrid.ScreenOrientation;
 
@@ -13,21 +14,30 @@ namespace Applitools.Example.Tests;
 /// </summary>
 public class AcmeBankTest
 {
+    #pragma warning disable CS0162
+    #pragma warning disable CS8618
+
+    // Test constants
+    public const bool UseUltrafastGrid = true;
+    public const bool UseExecutionCloud = false;
+    
     // Test control inputs to read once and share for all tests
     private static string? ApplitoolsApiKey;
     private static bool Headless;
 
     // Applitools objects to share for all tests
     private static BatchInfo Batch;
     private static Configuration Config;
-    private static VisualGridRunner Runner;
+    private static EyesRunner Runner;
 
     // Test-specific objects
     private WebDriver Driver;
     private Eyes Eyes;
 
+    #pragma warning restore CS8618
+
     /// <summary>
-    /// Sets up the configuration for running visual tests in the Ultrafast Grid.
+    /// Sets up the configuration for running visual tests.
     /// The configuration is shared by all tests in a test suite, so it belongs in a `OneTimeSetUp` method.
     /// If you have more than one test class, then you should abstract this configuration to avoid duplication.
     /// <summary>
@@ -42,15 +52,24 @@ public static void SetUpConfigAndRunner()
         // Use headed mode for local development.
         Headless = Environment.GetEnvironmentVariable("HEADLESS")?.ToLower() == "true";
 
-        // Create the runner for the Ultrafast Grid.
-        // Concurrency refers to the number of visual checkpoints Applitools will perform in parallel.
-        // Warning: If you have a free account, then concurrency will be limited to 1.
-        Runner = new VisualGridRunner(new RunnerOptions().TestConcurrency(5));
+        if (UseUltrafastGrid)
+        {
+            // Create the runner for the Ultrafast Grid.
+            // Concurrency refers to the number of visual checkpoints Applitools will perform in parallel.
+            // Warning: If you have a free account, then concurrency will be limited to 1.
+            Runner = new VisualGridRunner(new RunnerOptions().TestConcurrency(5));
+        }
+        else
+        {
+            // Create the Classic runner for local execution.
+            Runner = new ClassicRunner();
+        }
 
         // Create a new batch for tests.
         // A batch is the collection of visual checkpoints for a test suite.
         // Batches are displayed in the Eyes Test Manager, so use meaningful names.
-        Batch = new BatchInfo("Example: Selenium C# NUnit with the Ultrafast Grid");
+        String runnerName = (UseUltrafastGrid) ? "Ultrafast Grid" : "Classic Runner";
+        Batch = new BatchInfo($"Example: Selenium C# NUnit with the {runnerName}");
 
         // Create a configuration for Applitools Eyes.
         Config = new Configuration();
@@ -63,16 +82,19 @@ public static void SetUpConfigAndRunner()
         // Set the batch for the config.
         Config.SetBatch(Batch);
 
-        // Add 3 desktop browsers with different viewports for cross-browser testing in the Ultrafast Grid.
-        // Other browsers are also available, like Edge and IE.
-        Config.AddBrowser(800, 600, BrowserType.CHROME);
-        Config.AddBrowser(1600, 1200, BrowserType.FIREFOX);
-        Config.AddBrowser(1024, 768, BrowserType.SAFARI);
-
-        // Add 2 mobile emulation devices with different orientations for cross-browser testing in the Ultrafast Grid.
-        // Other mobile devices are available, including iOS.
-        Config.AddDeviceEmulation(DeviceName.Pixel_2, ScreenOrientation.Portrait);
-        Config.AddDeviceEmulation(DeviceName.Nexus_10, ScreenOrientation.Landscape);
+        if (UseUltrafastGrid)
+        {
+            // Add 3 desktop browsers with different viewports for cross-browser testing in the Ultrafast Grid.
+            // Other browsers are also available, like Edge and IE.
+            Config.AddBrowser(800, 600, BrowserType.CHROME);
+            Config.AddBrowser(1600, 1200, BrowserType.FIREFOX);
+            Config.AddBrowser(1024, 768, BrowserType.SAFARI);
+
+            // Add 2 mobile emulation devices with different orientations for cross-browser testing in the Ultrafast Grid.
+            // Other mobile devices are available, including iOS.
+            Config.AddDeviceEmulation(DeviceName.Pixel_2, ScreenOrientation.Portrait);
+            Config.AddDeviceEmulation(DeviceName.Nexus_10, ScreenOrientation.Landscape);
+        }
     }
 
     /// <summary>
@@ -86,15 +108,25 @@ public void OpenBrowserAndEyes()
         // it still needs to run the test one time locally to capture snapshots.
         ChromeOptions options = new ChromeOptions();
         if (Headless) options.AddArgument("headless");
-        Driver = new ChromeDriver(options);
+        
+        if (UseExecutionCloud)
+        {
+            // Open the browser remotely in the Execution Cloud.
+            Driver = new RemoteWebDriver(new Uri(Eyes.GetExecutionCloudURL()), options);
+        }
+        else
+        {
+            // Create a local WebDriver.
+            Driver = new ChromeDriver(options);
+        }
 
         // Set an implicit wait of 10 seconds.
         // For larger projects, use explicit waits for better control.
         // https://www.selenium.dev/documentation/webdriver/waits/
         // The following call works for Selenium 4:
         Driver.Manage().Timeouts().ImplicitWait = TimeSpan.FromSeconds(10);
 
-        // Create the Applitools Eyes object connected to the VisualGridRunner and set its configuration.
+        // Create the Applitools Eyes object connected to the runner and set its configuration.
         Eyes = new Eyes(Runner);
         Eyes.SetConfiguration(Config);
         Eyes.SaveNewTests = true;
@@ -179,4 +211,6 @@ public static void PrintResults()
         TestResultsSummary allTestResults = Runner.GetAllTestResults();
         Console.WriteLine(allTestResults);
     }
+
+    #pragma warning restore CS0162
 }

Applitools.Example.Tests/Applitools.Example.Tests.csproj

@@ -9,12 +9,12 @@
   </PropertyGroup>
 
   <ItemGroup>
-    <PackageReference Include="Eyes.Selenium4" Version="3.33.0" />
-    <PackageReference Include="Microsoft.NET.Test.Sdk" Version="17.3.2" />
+    <PackageReference Include="Eyes.Selenium4" Version="3.51.0" />
+    <PackageReference Include="Microsoft.NET.Test.Sdk" Version="17.5.0" />
     <PackageReference Include="NUnit" Version="3.13.3" />
-    <PackageReference Include="NUnit3TestAdapter" Version="4.2.1" />
-    <PackageReference Include="NUnit.Analyzers" Version="3.3.0" />
-    <PackageReference Include="coverlet.collector" Version="3.1.2" />
+    <PackageReference Include="NUnit3TestAdapter" Version="4.4.2" />
+    <PackageReference Include="NUnit.Analyzers" Version="3.6.1" />
+    <PackageReference Include="coverlet.collector" Version="3.2.0" />
   </ItemGroup>
 
 </Project>

README.md

@@ -1,10 +1,9 @@
-# Applitools Example: Selenium C# NUnit with the Ultrafast Grid
+# Applitools Example: Selenium in C# with NUnit
 
 This is the example project for the [Selenium C# NUnit tutorial](https://applitools.com/tutorials/quickstart/web/selenium/csharp/nunit).
 It shows how to start automating visual tests
 with [Applitools Eyes](https://applitools.com/platform/eyes/)
-and the [Ultrafast Grid](https://applitools.com/platform/ultrafast-grid/)
-using [Selenium WebDriver](https://www.selenium.dev/) in C#.
+and using [Selenium WebDriver](https://www.selenium.dev/) in C#.
 
 It uses:
 
@@ -14,7 +13,11 @@ It uses:
 * [NuGet](https://www.nuget.org/) for dependency management
 * [NUnit](https://nunit.org/) as the core test framework
 * [Applitools Eyes](https://applitools.com/platform/eyes/) for visual testing
+
+It can also run tests with:
+
 * [Applitools Ultrafast Grid](https://applitools.com/platform/ultrafast-grid/) for cross-browser execution
+* [Applitools Execution Cloud](https://applitools.com/platform/execution-cloud/) for self-healing remote WebDriver sessions
 
 To run this example project, you'll need:
 
@@ -26,6 +29,8 @@ To run this example project, you'll need:
 5. A corresponding version of [ChromeDriver](https://chromedriver.chromium.org/downloads).
 
 The main test case is [`AcmeBankTest.cs`](Applitools.Example.Tests/AcmeBankTest.cs).
+By default, the project will run tests with Ultrafast Grid but not Execution Cloud.
+You can change these settings in the test class.
 
 To execute tests, set the `APPLITOOLS_API_KEY` environment variable
 to your [account's API key](https://applitools.com/tutorials/guides/getting-started/registering-an-account).