Files
Terminal.Gui/Tests/UnitTests/ConsoleDrivers/ConsoleDriverTests.cs
Thomas Nind 51dda7e69f Fixes #3947 Adds Fake driver and fixes fluent tests (iteration-zero) (#4225)
* Consider width2 chars that are not IsBmp

* Apply same fix in WindowsDriver

* Explicitly use type of local variable

* Revert changes to WindowsDriver

* Assume we are running in a terminal that supports true color by default unless user explicitly forces 16

* Switch to SetAttribute and WriteConsole instead of WriteConsoleOutput for 16 color mode

* Fix some cursor issues (WIP)

* Remove concept of 'dirty rows' from v2 as its never actually used

* Remove damageRegion as it does nothing

* Make string builder to console writing simpler

* Radically simplify Write method

* Simplify conditional logic

* Simplify restoring cursor position

* Reference local variable for console buffer

* Reduce calls to ConsoleWrite by accumulating till attribute changes

* When resizing v2 16 color mode on windows, recreate the back buffer to match its size

* Fixes for VTS enabled

* Fix _lastSize never being assigned

* Fixes VTS for Force16Colors

* Fixes force16Colors in VTS

* Fixes escape sequences always echoing in non-VTS

* Force Force16Colors in non-VTS. It have a bug in adding a newline in the last line

* WIP Add base class for NetOutput

* Abstract away how we change attribute

* WIP - Make WindowsOutput use base class

* WIP working to fix set cursor position

* Remove commented out code

* Fixes legacy output mode

* Fixes size with no alt buffer supported on VTS and size restore after maximized.

* Fix set cursor which also fixes the broken surrogate pairs

* Add force parameter

* Fixes an issue that only happens with Windows Terminal when paste surrogate pairs by press Ctrl+V

* In Windows escape sequences must be sent during the lifetime of the console which is created in input handle

* Ensure flush the input buffer before reset the console

* Flush input buffer before reset console in v2win

* Fixes issue in v2net not being refreshing the menu bar at start

* Only force layout and draw on size changed.

* Fix v2net issue not draw first line by forcing set cursor position

* Set _lastCursorPosition nullable and remove bool force from set cursor position

* Remove force parameter

* Add v2 version of fake driver attribute

* Make direct replacement and wire up window resizing events

* Update casts to use V2 fake driver instead

* Adjust interfaces to expose less internals

* Fix not raising iteration event in v2

* WIP investigate what it takes to do resize and redraw using TextAlignment_Centered as example

* Sketch adding component factory

* Create relevant fake component factories

* Add window size monitor into factory

* Fake size monitor injecting

* Add helper for faking console resize in AutoInitShutdown tests

* Fix size setting in FakeDriverV2

* Switch to new method

* Fix IsLegacy becoming false when using blank constructor

* Fix for Ready not being raised when showing same top twice also fixes garbage collection issue if running millions of top levels

* Fix tests

* Remove auto init

* Restore conditional compilation stuff

* Restore 'if running unit tests' logic

* Check only for the output being specific classes for the suppression

* Fix ShadowView blowing up with index out of bounds error

* Fix resize in fluent tests

* Fix for people using Iteration call directly

* Fix more calls to iteration to use
        AutoInitShutdownAttribute.RunIteration ();

* Add comment

* Remove assumption that Run with prior view not disposed should throw

* Fix timings in Dialog_Opened_From_Another_Dialog

* Fix Zero_Buttons_Works

* Standardize and fix Button_IsDefault_True_Return_His_Index_On_Accepting

* Fix iteration counts on MessageBoxTests

* Fix WizartTests and DrawTests_Ruler

* Implement SendKeys into ConsoleDriverFacade

* Fix SendKeys in console driver facade such that FileDialogTests works
Fix when Clip is null in popover

* Add missing dispose call to test

* Fix support for Esc in facade SendKeys

* Fix AutocompleteTests

* Fix various tests

* Replace LayoutAndDraw with run iteration

* Fix draw issues

* fix draw order

* Fix run iteration calls

* Fix unit tests

* Fix SendKeys in facade.

* Manipulate upper and lower cases.

* Add IsValidInput method to the interface.

* Fix SendKeys scenario

* Fixes surrogate pairs in the label

* Make tests more sensible - they are testing draw functionality.  Callbacks do not need to happen in Iteration method

* Fix tests and harden cleanup in AutoInitShutdownAttribute v2 lifecycle dispose

* Delete extra create input call

* Fix mocks and order of exceptions thrown in Run when things are not initialized

* Revert use of `MapConsoleKeyInfoToKeyCode`

* Ignore casing as it is not what test is really about

* Clear application top and top levels before each auto init shutdown test

* Fix for unstable tests

* Restore actually working SendKeys code

* option to pass logger in fluent ctor

* restore ToArray

* Fix SendKeys method and add extension to unit test

* Leverage the EscSeqUtils.MapConsoleKeyInfo method to avoid duplicate code

* Remove unnecessary hack

* Using only KeyCode for rKeys

* Recover modifier keys in surrogate pairs

* Reformat

* Remove iteration limit for benchmarking in v2

* remove iteration delay to identify bugs

* Remove nudge to unique key and make Then run on UI thread

* fix fluid assertions

* Ensure UI operations all happen on UI thread

* Add explicit error for WaitIteration during an invoke

* Remove timeout added for debug

* Catch failing asserts better

* Fix screenshot

* Fix null ref

* Fix race condition in processing input

* Test fixing

* Standardize asserts

* Remove calls to layout and draw, remove pointless lock and enable reading Cancelled from Dialog even if it is disposed

* fix bad merge

* Make logs access threadsafe

* add extra wait to remove race between iteration end and assert

* Code cleanup

* Remove test for crash on access Cancelled after dispose as this is no longer a restriction

* Change resize console to run on UI thread - fixing race condition with redrawing

* Restore original frame rate after test

* Restore nudge to unique key

* Code Cleanup

* Fix for cascading failures when an assert fails in a specific test

* fix for bad merge

* Address PR feedback

* Move classes to seperate files and add xmldoc

* xml doc warnings

* More xml comments docs

* Fix spelling

---------

Co-authored-by: BDisp <bd.bdisp@gmail.com>
2025-09-10 10:01:57 -06:00

398 lines
14 KiB
C#

using System.Text;
using Xunit.Abstractions;
// Alias Console to MockConsole so we don't accidentally use Console
using Console = Terminal.Gui.Drivers.FakeConsole;
namespace Terminal.Gui.DriverTests;
public class ConsoleDriverTests
{
private readonly ITestOutputHelper _output;
public ConsoleDriverTests (ITestOutputHelper output)
{
ConsoleDriver.RunningUnitTests = true;
_output = output;
}
[Theory]
[InlineData (typeof (FakeDriver))]
[InlineData (typeof (NetDriver))]
//[InlineData (typeof (ANSIDriver))]
[InlineData (typeof (WindowsDriver))]
[InlineData (typeof (CursesDriver))]
public void End_Cleans_Up (Type driverType)
{
var driver = (IConsoleDriver)Activator.CreateInstance (driverType);
driver.Init ();
driver.End ();
}
[Theory]
[InlineData (typeof (FakeDriver))]
public void FakeDriver_MockKeyPresses (Type driverType)
{
var driver = (IConsoleDriver)Activator.CreateInstance (driverType);
Application.Init (driver);
var text = "MockKeyPresses";
Stack<ConsoleKeyInfo> mKeys = new ();
foreach (char r in text.Reverse ())
{
ConsoleKey ck = char.IsLetter (r) ? (ConsoleKey)char.ToUpper (r) : (ConsoleKey)r;
var cki = new ConsoleKeyInfo (r, ck, char.IsUpper(r), false, false);
mKeys.Push (cki);
}
Console.MockKeyPresses = mKeys;
Toplevel top = new ();
var view = new View { CanFocus = true };
var rText = "";
var idx = 0;
view.KeyDown += (s, e) =>
{
Assert.Equal (new Rune(text [idx]), e.AsRune);
rText += e.AsRune;
Assert.Equal (rText, text.Substring (0, idx + 1));
e.Handled = true;
idx++;
};
top.Add (view);
Application.Iteration += (s, a) =>
{
if (mKeys.Count == 0)
{
Application.RequestStop ();
}
};
Application.Run (top);
Assert.Equal ("MockKeyPresses", rText);
top.Dispose ();
// Shutdown must be called to safely clean up Application if Init has been called
Application.Shutdown ();
}
[Theory]
[InlineData (typeof (FakeDriver))]
public void FakeDriver_Only_Sends_Keystrokes_Through_MockKeyPresses (Type driverType)
{
var driver = (IConsoleDriver)Activator.CreateInstance (driverType);
Application.Init (driver);
Toplevel top = new ();
var view = new View { CanFocus = true };
var count = 0;
var wasKeyPressed = false;
view.KeyDown += (s, e) => { wasKeyPressed = true; };
top.Add (view);
Application.Iteration += (s, a) =>
{
count++;
if (count == 10)
{
Application.RequestStop ();
}
};
Application.Run (top);
Assert.False (wasKeyPressed);
top.Dispose ();
// Shutdown must be called to safely clean up Application if Init has been called
Application.Shutdown ();
}
[Theory]
[InlineData (typeof (FakeDriver))]
[InlineData (typeof (NetDriver))]
//[InlineData (typeof (ANSIDriver))]
[InlineData (typeof (WindowsDriver))]
[InlineData (typeof (CursesDriver))]
public void Init_Inits (Type driverType)
{
var driver = (IConsoleDriver)Activator.CreateInstance (driverType);
MainLoop ml = driver.Init ();
Assert.NotNull (ml);
Assert.NotNull (driver.Clipboard);
Console.ForegroundColor = ConsoleColor.Red;
Assert.Equal (ConsoleColor.Red, Console.ForegroundColor);
Console.BackgroundColor = ConsoleColor.Green;
Assert.Equal (ConsoleColor.Green, Console.BackgroundColor);
driver.End ();
}
//[Theory]
//[InlineData (typeof (FakeDriver))]
//public void FakeDriver_MockKeyPresses_Press_AfterTimeOut (Type driverType)
//{
// var driver = (IConsoleDriver)Activator.CreateInstance (driverType);
// Application.Init (driver);
// // Simulating pressing of QuitKey after a short period of time
// uint quitTime = 100;
// Func<MainLoop, bool> closeCallback = (MainLoop loop) => {
// // Prove the scenario is using Application.QuitKey correctly
// output.WriteLine ($" {quitTime}ms elapsed; Simulating keypresses...");
// FakeConsole.PushMockKeyPress (Key.F);
// FakeConsole.PushMockKeyPress (Key.U);
// FakeConsole.PushMockKeyPress (Key.C);
// FakeConsole.PushMockKeyPress (Key.K);
// return false;
// };
// output.WriteLine ($"Add timeout to simulate key presses after {quitTime}ms");
// _ = Application.AddTimeout (TimeSpan.FromMilliseconds (quitTime), closeCallback);
// // If Top doesn't quit within abortTime * 5 (500ms), this will force it
// uint abortTime = quitTime * 5;
// Func<MainLoop, bool> forceCloseCallback = (MainLoop loop) => {
// Application.RequestStop ();
// Assert.Fail ($" failed to Quit after {abortTime}ms. Force quit.");
// return false;
// };
// output.WriteLine ($"Add timeout to force quit after {abortTime}ms");
// _ = Application.AddTimeout (TimeSpan.FromMilliseconds (abortTime), forceCloseCallback);
// Key key = Key.Unknown;
// Application.Top.KeyPress += (e) => {
// key = e.Key;
// output.WriteLine ($" Application.Top.KeyPress: {key}");
// e.Handled = true;
// };
// int iterations = 0;
// Application.Iteration += (s, a) => {
// output.WriteLine ($" iteration {++iterations}");
// if (Console.MockKeyPresses.Count == 0) {
// output.WriteLine ($" No more MockKeyPresses; RequestStop");
// Application.RequestStop ();
// }
// };
// Application.Run ();
// // Shutdown must be called to safely clean up Application if Init has been called
// Application.Shutdown ();
//}
[Theory]
[InlineData (typeof (FakeDriver))]
[InlineData (typeof (NetDriver))]
//[InlineData (typeof (ANSIDriver))]
[InlineData (typeof (WindowsDriver))]
[InlineData (typeof (CursesDriver))]
public void TerminalResized_Simulation (Type driverType)
{
var driver = (IConsoleDriver)Activator.CreateInstance (driverType);
driver?.Init ();
driver.Cols = 80;
driver.Rows = 25;
var wasTerminalResized = false;
driver.SizeChanged += (s, e) =>
{
wasTerminalResized = true;
Assert.Equal (120, e.Size.GetValueOrDefault ().Width);
Assert.Equal (40, e.Size.GetValueOrDefault ().Height);
};
Assert.Equal (80, driver.Cols);
Assert.Equal (25, driver.Rows);
Assert.False (wasTerminalResized);
driver.Cols = 120;
driver.Rows = 40;
((ConsoleDriver)driver).OnSizeChanged (new SizeChangedEventArgs (new (driver.Cols, driver.Rows)));
Assert.Equal (120, driver.Cols);
Assert.Equal (40, driver.Rows);
Assert.True (wasTerminalResized);
driver.End ();
}
// Disabled due to test error - Change Task.Delay to an await
// [Fact, AutoInitShutdown]
// public void Write_Do_Not_Change_On_ProcessKey ()
// {
// var win = new Window ();
// Application.Begin (win);
// AutoInitShutdownAttribute.FakeResize(new Size ( (20, 8);
// System.Threading.Tasks.Task.Run (() => {
// System.Threading.Tasks.Task.Delay (500).Wait ();
// Application.Invoke (() => {
// var lbl = new Label ("Hello World") { X = Pos.Center () };
// var dlg = new Dialog ();
// dlg.Add (lbl);
// Application.Begin (dlg);
// var expected = @"
//┌──────────────────┐
//│┌───────────────┐ │
//││ Hello World │ │
//││ │ │
//││ │ │
//││ │ │
//│└───────────────┘ │
//└──────────────────┘
//";
// var pos = DriverAsserts.AssertDriverContentsWithFrameAre (expected, output);
// Assert.Equal (new (0, 0, 20, 8), pos);
// Assert.True (dlg.ProcessKey (new (Key.Tab)));
// dlg.Draw ();
// expected = @"
//┌──────────────────┐
//│┌───────────────┐ │
//││ Hello World │ │
//││ │ │
//││ │ │
//││ │ │
//│└───────────────┘ │
//└──────────────────┘
//";
// pos = DriverAsserts.AssertDriverContentsWithFrameAre (expected, output);
// Assert.Equal (new (0, 0, 20, 8), pos);
// win.RequestStop ();
// });
// });
// Application.Run (win);
// Application.Shutdown ();
// }
[Theory]
[InlineData ('\ud83d', '\udcc4')] // This seems right sequence but Stack is LIFO
[InlineData ('\ud83d', '\ud83d')]
[InlineData ('\udcc4', '\udcc4')]
public void FakeDriver_IsValidInput_Wrong_Surrogate_Sequence (char c1, char c2)
{
var driver = (IConsoleDriver)Activator.CreateInstance (typeof (FakeDriver));
Application.Init (driver);
Stack<ConsoleKeyInfo> mKeys = new (
[
new ('a', ConsoleKey.A, false, false, false),
new (c1, ConsoleKey.None, false, false, false),
new (c2, ConsoleKey.None, false, false, false)
]);
Console.MockKeyPresses = mKeys;
Toplevel top = new ();
var view = new View { CanFocus = true };
var rText = "";
var idx = 0;
view.KeyDown += (s, e) =>
{
Assert.Equal (new ('a'), e.AsRune);
Assert.Equal ("a", e.AsRune.ToString ());
rText += e.AsRune;
e.Handled = true;
idx++;
};
top.Add (view);
Application.Iteration += (s, a) =>
{
if (mKeys.Count == 0)
{
Application.RequestStop ();
}
};
Application.Run (top);
Assert.Equal ("a", rText);
Assert.Equal (1, idx);
Assert.Equal (0, ((FakeDriver)driver)._highSurrogate);
top.Dispose ();
// Shutdown must be called to safely clean up Application if Init has been called
Application.Shutdown ();
}
[Fact]
public void FakeDriver_IsValidInput_Correct_Surrogate_Sequence ()
{
var driver = (IConsoleDriver)Activator.CreateInstance (typeof (FakeDriver));
Application.Init (driver);
Stack<ConsoleKeyInfo> mKeys = new (
[
new ('a', ConsoleKey.A, false, false, false),
new ('\udcc4', ConsoleKey.None, false, false, false),
new ('\ud83d', ConsoleKey.None, false, false, false)
]);
Console.MockKeyPresses = mKeys;
Toplevel top = new ();
var view = new View { CanFocus = true };
var rText = "";
var idx = 0;
view.KeyDown += (s, e) =>
{
if (idx == 0)
{
Assert.Equal (new (0x1F4C4), e.AsRune);
Assert.Equal ("📄", e.AsRune.ToString ());
}
else
{
Assert.Equal (new ('a'), e.AsRune);
Assert.Equal ("a", e.AsRune.ToString ());
}
rText += e.AsRune;
e.Handled = true;
idx++;
};
top.Add (view);
Application.Iteration += (s, a) =>
{
if (mKeys.Count == 0)
{
Application.RequestStop ();
}
};
Application.Run (top);
Assert.Equal ("📄a", rText);
Assert.Equal (2, idx);
top.Dispose ();
// Shutdown must be called to safely clean up Application if Init has been called
Application.Shutdown ();
}
}