#nullable enable using System.Collections.Concurrent; using Xunit.Abstractions; using Xunit.Sdk; namespace UnitTests_Parallelizable.DriverTests; /// /// Low-level tests for IInput and IOutput implementations across all drivers. /// These tests are designed to fail with good error messages when run in environments /// without a real terminal (like GitHub Actions). /// public class IInputOutputTests (ITestOutputHelper output) { private readonly ITestOutputHelper _output = output; #region DotNet Driver Tests [Fact] [Trait ("Category", "LowLevelDriver")] public void NetInput_Constructor_DoesNotThrow_WhenNoTerminalAvailable () { // Arrange & Act Exception? exception = Record.Exception (() => { using var input = new NetInput (); _output.WriteLine ("NetInput created successfully"); }); // Assert if (exception != null) { _output.WriteLine ($"FAILED: NetInput constructor threw: {exception.GetType ().Name}: {exception.Message}"); _output.WriteLine ($"Stack trace: {exception.StackTrace}"); } Assert.Null (exception); } [Fact] [Trait ("Category", "LowLevelDriver")] public void NetInput_Peek_DoesNotThrow_WhenNoTerminalAvailable () { // Arrange using var input = new NetInput (); // Act Exception? exception = Record.Exception (() => { bool hasInput = input.Peek (); _output.WriteLine ($"NetInput.Peek() returned: {hasInput}"); }); // Assert if (exception != null) { _output.WriteLine ($"FAILED: NetInput.Peek() threw: {exception.GetType ().Name}: {exception.Message}"); _output.WriteLine ($"Stack trace: {exception.StackTrace}"); } Assert.Null (exception); } [Fact] [Trait ("Category", "LowLevelDriver")] public void NetInput_Read_DoesNotThrow_WhenNoTerminalAvailable () { // Arrange using var input = new NetInput (); // Act Exception? exception = Record.Exception (() => { List items = input.Read ().ToList (); _output.WriteLine ($"NetInput.Read() returned {items.Count} items"); }); // Assert if (exception != null) { _output.WriteLine ($"FAILED: NetInput.Read() threw: {exception.GetType ().Name}: {exception.Message}"); _output.WriteLine ($"Stack trace: {exception.StackTrace}"); } Assert.Null (exception); } [Fact] [Trait ("Category", "LowLevelDriver")] public void NetInput_Dispose_DoesNotThrow_WhenNoTerminalAvailable () { // Arrange var input = new NetInput (); // Act Exception? exception = Record.Exception (() => { input.Dispose (); _output.WriteLine ("NetInput disposed successfully"); }); // Assert if (exception != null) { _output.WriteLine ($"FAILED: NetInput.Dispose() threw: {exception.GetType ().Name}: {exception.Message}"); _output.WriteLine ($"Stack trace: {exception.StackTrace}"); } Assert.Null (exception); } [Fact] [Trait ("Category", "LowLevelDriver")] public void NetOutput_Constructor_DoesNotThrow_WhenNoTerminalAvailable () { // Arrange & Act Exception? exception = Record.Exception (() => { using var output = new NetOutput (); _output.WriteLine ("NetOutput created successfully"); }); // Assert if (exception != null) { _output.WriteLine ($"FAILED: NetOutput constructor threw: {exception.GetType ().Name}: {exception.Message}"); _output.WriteLine ($"Stack trace: {exception.StackTrace}"); } Assert.Null (exception); } [Fact] [Trait ("Category", "LowLevelDriver")] public void NetOutput_GetSize_ReturnsDefaultSize_WhenNoTerminalAvailable () { // Arrange using var output = new NetOutput (); // Act Size size = default; Exception? exception = Record.Exception (() => { size = output.GetSize (); _output.WriteLine ($"NetOutput.GetSize() returned: {size.Width}x{size.Height}"); }); // Assert if (exception != null) { _output.WriteLine ($"FAILED: NetOutput.GetSize() threw: {exception.GetType ().Name}: {exception.Message}"); _output.WriteLine ($"Stack trace: {exception.StackTrace}"); } Assert.Null (exception); Assert.True (size.Width > 0, "Width should be > 0"); Assert.True (size.Height > 0, "Height should be > 0"); } [Fact] [Trait ("Category", "LowLevelDriver")] public void NetOutput_Write_DoesNotThrow_WhenNoTerminalAvailable () { // Arrange using var output = new NetOutput (); // Act Exception? exception = Record.Exception (() => { ReadOnlySpan text = "Test".AsSpan (); output.Write (text); _output.WriteLine ("NetOutput.Write() succeeded"); }); // Assert if (exception != null) { _output.WriteLine ($"FAILED: NetOutput.Write() threw: {exception.GetType ().Name}: {exception.Message}"); _output.WriteLine ($"Stack trace: {exception.StackTrace}"); } Assert.Null (exception); } [Fact] [Trait ("Category", "LowLevelDriver")] public void NetOutput_SetCursorPosition_DoesNotThrow_WhenNoTerminalAvailable () { // Arrange using var output = new NetOutput (); // Act Exception? exception = Record.Exception (() => { output.SetCursorPosition (0, 0); _output.WriteLine ("NetOutput.SetCursorPosition() succeeded"); }); // Assert if (exception != null) { _output.WriteLine ($"FAILED: NetOutput.SetCursorPosition() threw: {exception.GetType ().Name}: {exception.Message}"); _output.WriteLine ($"Stack trace: {exception.StackTrace}"); } Assert.Null (exception); } [Fact] [Trait ("Category", "LowLevelDriver")] public void NetInputProcessor_Constructor_DoesNotThrow () { // Arrange & Act Exception? exception = Record.Exception (() => { ConcurrentQueue queue = new (); var processor = new NetInputProcessor (queue); _output.WriteLine ("NetInputProcessor created successfully"); }); // Assert if (exception != null) { _output.WriteLine ($"FAILED: NetInputProcessor constructor threw: {exception.GetType ().Name}: {exception.Message}"); _output.WriteLine ($"Stack trace: {exception.StackTrace}"); } Assert.Null (exception); } #endregion #region Unix Driver Tests [Fact] [Trait ("Category", "LowLevelDriver")] [Trait ("Platform", "Unix")] public void UnixInput_Constructor_DoesNotThrow_WhenNoTerminalAvailable () { // Arrange & Act Exception? exception = Record.Exception (() => { try { using var input = new UnixInput (); _output.WriteLine ("UnixInput created successfully"); } catch (Exception ex) { _output.WriteLine ($"Expected failure on non-terminal: {ex.Message}"); throw new XunitException ( $"UnixInput failed in non-terminal environment: {ex.Message}\nThis is expected in GitHub Actions. The driver should detect this and handle gracefully."); } }); // Assert if (exception != null && !(exception is XunitException)) { _output.WriteLine ($"FAILED: UnixInput constructor threw: {exception.GetType ().Name}: {exception.Message}"); _output.WriteLine ($"Stack trace: {exception.StackTrace}"); } } [Fact] [Trait ("Category", "LowLevelDriver")] [Trait ("Platform", "Unix")] public void UnixOutput_Constructor_DoesNotThrow_WhenNoTerminalAvailable () { if (OperatingSystem.IsWindows ()) { _output.WriteLine ("Skipping Unix test on Windows"); return; } // Arrange & Act Exception? exception = Record.Exception (() => { using var output = new UnixOutput (); _output.WriteLine ("UnixOutput created successfully"); }); // Assert if (exception != null) { _output.WriteLine ($"FAILED: UnixOutput constructor threw: {exception.GetType ().Name}: {exception.Message}"); _output.WriteLine ($"Stack trace: {exception.StackTrace}"); } Assert.Null (exception); } [Fact] [Trait ("Category", "LowLevelDriver")] [Trait ("Platform", "Unix")] public void UnixOutput_GetSize_ReturnsDefaultSize_WhenNoTerminalAvailable () { if (OperatingSystem.IsWindows ()) { _output.WriteLine ("Skipping Unix test on Windows"); return; } // Arrange using var output = new UnixOutput (); // Act Size size = default; Exception? exception = Record.Exception (() => { size = output.GetSize (); _output.WriteLine ($"UnixOutput.GetSize() returned: {size.Width}x{size.Height}"); }); // Assert Assert.Null (exception); Assert.Equal (80, size.Width); Assert.Equal (25, size.Height); } #endregion #region Windows Driver Tests [Fact] [Trait ("Category", "LowLevelDriver")] [Trait ("Platform", "Windows")] public void WindowsInput_Constructor_DoesNotThrow_WhenNoTerminalAvailable () { if (!OperatingSystem.IsWindows ()) { _output.WriteLine ("Skipping Windows test on non-Windows"); return; } // Arrange & Act Exception? exception = Record.Exception (() => { using var input = new WindowsInput (); _output.WriteLine ("WindowsInput created successfully"); }); // Assert if (exception != null) { _output.WriteLine ($"FAILED: WindowsInput constructor threw: {exception.GetType ().Name}: {exception.Message}"); _output.WriteLine ($"Stack trace: {exception.StackTrace}"); } Assert.Null (exception); } [Fact] [Trait ("Category", "LowLevelDriver")] [Trait ("Platform", "Windows")] public void WindowsOutput_Constructor_DoesNotThrow_WhenNoTerminalAvailable () { if (!OperatingSystem.IsWindows ()) { _output.WriteLine ("Skipping Windows test on non-Windows"); return; } // Arrange & Act Exception? exception = Record.Exception (() => { try { using var output = new WindowsOutput (); _output.WriteLine ("WindowsOutput created successfully"); } catch (Exception ex) { _output.WriteLine ($"WindowsOutput threw during construction: {ex.GetType ().Name}: {ex.Message}"); throw; } }); // Assert if (exception != null) { _output.WriteLine ($"FAILED: WindowsOutput constructor threw: {exception.GetType ().Name}: {exception.Message}"); _output.WriteLine ($"Stack trace: {exception.StackTrace}"); } Assert.Null (exception); } #endregion #region Fake Driver Tests [Fact] [Trait ("Category", "LowLevelDriver")] public void FakeInput_Constructor_DoesNotThrow () { // Arrange & Act Exception? exception = Record.Exception (() => { using var input = new FakeInput (); _output.WriteLine ("FakeInput created successfully"); }); // Assert Assert.Null (exception); } [Fact] [Trait ("Category", "LowLevelDriver")] public void FakeOutput_Constructor_DoesNotThrow () { // Arrange & Act Exception? exception = Record.Exception (() => { using var output = new FakeOutput (); _output.WriteLine ("FakeOutput created successfully"); }); // Assert Assert.Null (exception); } [Fact] [Trait ("Category", "LowLevelDriver")] public void FakeOutput_GetSize_ReturnsExpectedSize () { // Arrange using var output = new FakeOutput (); // Act Size size = output.GetSize (); _output.WriteLine ($"FakeOutput.GetSize() returned: {size.Width}x{size.Height}"); // Assert Assert.True (size.Width > 0); Assert.True (size.Height > 0); } #endregion #region Component Factory Tests [Fact] [Trait ("Category", "LowLevelDriver")] public void NetComponentFactory_CreateInput_DoesNotThrow () { // Arrange var factory = new NetComponentFactory (); // Act Exception? exception = Record.Exception (() => { using IInput input = factory.CreateInput (); _output.WriteLine ("NetComponentFactory.CreateInput() succeeded"); }); // Assert if (exception != null) { _output.WriteLine ($"FAILED: NetComponentFactory.CreateInput() threw: {exception.GetType ().Name}: {exception.Message}"); _output.WriteLine ($"Stack trace: {exception.StackTrace}"); } Assert.Null (exception); } [Fact] [Trait ("Category", "LowLevelDriver")] public void NetComponentFactory_CreateOutput_DoesNotThrow () { // Arrange var factory = new NetComponentFactory (); // Act Exception? exception = Record.Exception (() => { using IOutput output = factory.CreateOutput (); _output.WriteLine ("NetComponentFactory.CreateOutput() succeeded"); }); // Assert if (exception != null) { _output.WriteLine ($"FAILED: NetComponentFactory.CreateOutput() threw: {exception.GetType ().Name}: {exception.Message}"); _output.WriteLine ($"Stack trace: {exception.StackTrace}"); } Assert.Null (exception); } [Fact] [Trait ("Category", "LowLevelDriver")] public void FakeComponentFactory_CreateInput_DoesNotThrow () { // Arrange var factory = new FakeComponentFactory (); // Act Exception? exception = Record.Exception (() => { using IInput input = factory.CreateInput (); _output.WriteLine ("FakeComponentFactory.CreateInput() succeeded"); }); // Assert Assert.Null (exception); } [Fact] [Trait ("Category", "LowLevelDriver")] public void FakeComponentFactory_CreateOutput_DoesNotThrow () { // Arrange var factory = new FakeComponentFactory (); // Act Exception? exception = Record.Exception (() => { using IOutput output = factory.CreateOutput (); _output.WriteLine ("FakeComponentFactory.CreateOutput() succeeded"); }); // Assert Assert.Null (exception); } #endregion }