using System.Diagnostics;
using System.Globalization;
using System.Reflection;
using System.Text;
using System.Text.RegularExpressions;
using Xunit.Abstractions;
using Xunit.Sdk;
namespace Terminal.Gui;
///
/// This class enables test functions annotated with the [AutoInitShutdown] attribute to
/// automatically call Application.Init at start of the test and Application.Shutdown after the
/// test exits.
/// This is necessary because a) Application is a singleton and Init/Shutdown must be called
/// as a pair, and b) all unit test functions should be atomic..
///
[AttributeUsage (AttributeTargets.Class | AttributeTargets.Method)]
public class AutoInitShutdownAttribute : BeforeAfterTestAttribute
{
///
/// Initializes a [AutoInitShutdown] attribute, which determines if/how Application.Init and Application.Shutdown
/// are automatically called Before/After a test runs.
///
/// If true, Application.Init will be called Before the test runs.
///
/// Determines which ConsoleDriver (FakeDriver, WindowsDriver, CursesDriver, NetDriver)
/// will be used when Application.Init is called. If null FakeDriver will be used. Only valid if
/// is true.
///
///
/// If true, will force the use of . Only valid if
/// == and is true.
///
///
/// Only valid if is true. Only
/// valid if == and is true.
///
///
/// Only valid if is true. Only valid if
/// == and is true.
///
/// Determines what config file locations will load from.
public AutoInitShutdownAttribute (
bool autoInit = true,
Type consoleDriverType = null,
bool useFakeClipboard = true,
bool fakeClipboardAlwaysThrowsNotSupportedException = false,
bool fakeClipboardIsSupportedAlwaysTrue = false,
ConfigurationManager.ConfigLocations configLocation = ConfigurationManager.ConfigLocations.DefaultOnly
)
{
AutoInit = autoInit;
CultureInfo.DefaultThreadCurrentUICulture = CultureInfo.GetCultureInfo ("en-US");
_driverType = consoleDriverType ?? typeof (FakeDriver);
FakeDriver.FakeBehaviors.UseFakeClipboard = useFakeClipboard;
FakeDriver.FakeBehaviors.FakeClipboardAlwaysThrowsNotSupportedException =
fakeClipboardAlwaysThrowsNotSupportedException;
FakeDriver.FakeBehaviors.FakeClipboardIsSupportedAlwaysFalse = fakeClipboardIsSupportedAlwaysTrue;
ConfigurationManager.Locations = configLocation;
}
private readonly Type _driverType;
public override void After (MethodInfo methodUnderTest)
{
Debug.WriteLine ($"After: {methodUnderTest.Name}");
// Turn off diagnostic flags in case some test left them on
View.Diagnostics = ViewDiagnosticFlags.Off;
if (AutoInit)
{
// TODO: This Dispose call is here until all unit tests that don't correctly dispose Toplevel's they create are fixed.
Application.Top?.Dispose ();
Application.Shutdown ();
#if DEBUG_IDISPOSABLE
if (Responder.Instances.Count == 0)
{
Assert.Empty (Responder.Instances);
}
else
{
Responder.Instances.Clear ();
}
#endif
ConfigurationManager.Reset ();
}
}
public override void Before (MethodInfo methodUnderTest)
{
Debug.WriteLine ($"Before: {methodUnderTest.Name}");
if (AutoInit)
{
ConfigurationManager.Reset ();
#if DEBUG_IDISPOSABLE
// Clear out any lingering Responder instances from previous tests
if (Responder.Instances.Count == 0)
{
Assert.Empty (Responder.Instances);
}
else
{
Responder.Instances.Clear ();
}
#endif
Application.Init ((ConsoleDriver)Activator.CreateInstance (_driverType));
}
}
private bool AutoInit { get; }
}
[AttributeUsage (AttributeTargets.Class | AttributeTargets.Method)]
public class TestRespondersDisposed : BeforeAfterTestAttribute
{
public TestRespondersDisposed () { CultureInfo.DefaultThreadCurrentUICulture = CultureInfo.GetCultureInfo ("en-US"); }
public override void After (MethodInfo methodUnderTest)
{
Debug.WriteLine ($"After: {methodUnderTest.Name}");
base.After (methodUnderTest);
#if DEBUG_IDISPOSABLE
Assert.Empty (Responder.Instances);
#endif
}
public override void Before (MethodInfo methodUnderTest)
{
Debug.WriteLine ($"Before: {methodUnderTest.Name}");
base.Before (methodUnderTest);
#if DEBUG_IDISPOSABLE
// Clear out any lingering Responder instances from previous tests
Responder.Instances.Clear ();
Assert.Empty (Responder.Instances);
#endif
}
}
// TODO: Make this inherit from TestRespondersDisposed so that all tests that don't dispose Views correctly can be identified and fixed
[AttributeUsage (AttributeTargets.Class | AttributeTargets.Method)]
public class SetupFakeDriverAttribute : BeforeAfterTestAttribute
{
///
/// Enables test functions annotated with the [SetupFakeDriver] attribute to set Application.Driver to new
/// FakeDriver(). The driver is setup with 25 rows and columns.
///
public SetupFakeDriverAttribute () { }
public override void After (MethodInfo methodUnderTest)
{
Debug.WriteLine ($"After: {methodUnderTest.Name}");
// Turn off diagnostic flags in case some test left them on
View.Diagnostics = ViewDiagnosticFlags.Off;
Application.Driver = null;
base.After (methodUnderTest);
}
public override void Before (MethodInfo methodUnderTest)
{
Debug.WriteLine ($"Before: {methodUnderTest.Name}");
Assert.Null (Application.Driver);
Application.Driver = new FakeDriver { Rows = 25, Cols = 25 };
base.Before (methodUnderTest);
}
}
[AttributeUsage (AttributeTargets.Class | AttributeTargets.Method)]
public class TestDateAttribute : BeforeAfterTestAttribute
{
public TestDateAttribute () { CultureInfo.CurrentCulture = CultureInfo.InvariantCulture; }
private readonly CultureInfo _currentCulture = CultureInfo.CurrentCulture;
public override void After (MethodInfo methodUnderTest)
{
CultureInfo.CurrentCulture = _currentCulture;
Assert.Equal (CultureInfo.CurrentCulture, _currentCulture);
}
public override void Before (MethodInfo methodUnderTest) { Assert.Equal (CultureInfo.CurrentCulture, CultureInfo.InvariantCulture); }
}
internal partial class TestHelpers
{
private const char SpaceChar = ' ';
private static readonly Rune SpaceRune = (Rune)SpaceChar;
#pragma warning disable xUnit1013 // Public method should be marked as test
///
/// Verifies are found at the locations specified by
/// . is a bitmap of indexes into
/// (e.g. "00110" means the attribute at expectedAttributes[1] is expected
/// at the 3rd and 4th columns of the 1st row of driver.Contents).
///
///
/// Numbers between 0 and 9 for each row/col of the console. Must be valid indexes into
/// .
///
/// The ConsoleDriver to use. If null will be used.
///
public static void AssertDriverAttributesAre (
string expectedLook,
ConsoleDriver driver = null,
params Attribute [] expectedAttributes
)
{
#pragma warning restore xUnit1013 // Public method should be marked as test
if (expectedAttributes.Length > 10)
{
throw new ArgumentException ("This method only works for UIs that use at most 10 colors");
}
expectedLook = expectedLook.Trim ();
driver ??= Application.Driver;
Cell [,] contents = driver.Contents;
var line = 0;
foreach (string lineString in expectedLook.Split ('\n').Select (l => l.Trim ()))
{
for (var c = 0; c < lineString.Length; c++)
{
Attribute? val = contents [line, c].Attribute;
List match = expectedAttributes.Where (e => e == val).ToList ();
switch (match.Count)
{
case 0:
throw new (
$"{Application.ToString (driver)}\n"
+ $"Expected Attribute {val} (PlatformColor = {val.Value.PlatformColor}) at Contents[{line},{c}] {contents [line, c]} ((PlatformColor = {contents [line, c].Attribute.Value.PlatformColor}) was not found.\n"
+ $" Expected: {string.Join (",", expectedAttributes.Select (c => c))}\n"
+ $" But Was: "
);
case > 1:
throw new ArgumentException (
$"Bad value for expectedColors, {match.Count} Attributes had the same Value"
);
}
char colorUsed = Array.IndexOf (expectedAttributes, match [0]).ToString () [0];
char userExpected = lineString [c];
if (colorUsed != userExpected)
{
throw new (
$"{Application.ToString (driver)}\n"
+ $"Unexpected Attribute at Contents[{line},{c}] {contents [line, c]}.\n"
+ $" Expected: {userExpected} ({expectedAttributes [int.Parse (userExpected.ToString ())]})\n"
+ $" But Was: {colorUsed} ({val})\n"
);
}
}
line++;
}
}
#pragma warning disable xUnit1013 // Public method should be marked as test
/// Asserts that the driver contents match the expected contents, optionally ignoring any trailing whitespace.
///
///
/// The ConsoleDriver to use. If null will be used.
///
public static void AssertDriverContentsAre (
string expectedLook,
ITestOutputHelper output,
ConsoleDriver driver = null,
bool ignoreLeadingWhitespace = false
)
{
#pragma warning restore xUnit1013 // Public method should be marked as test
var actualLook = Application.ToString (driver ?? Application.Driver);
if (string.Equals (expectedLook, actualLook))
{
return;
}
// get rid of trailing whitespace on each line (and leading/trailing whitespace of start/end of full string)
expectedLook = TrailingWhiteSpaceRegEx ().Replace (expectedLook, "").Trim ();
actualLook = TrailingWhiteSpaceRegEx ().Replace (actualLook, "").Trim ();
if (ignoreLeadingWhitespace)
{
expectedLook = LeadingWhitespaceRegEx ().Replace (expectedLook, "").Trim ();
actualLook = LeadingWhitespaceRegEx ().Replace (actualLook, "").Trim ();
}
// standardize line endings for the comparison
expectedLook = expectedLook.Replace ("\r\n", "\n");
actualLook = actualLook.Replace ("\r\n", "\n");
// If test is about to fail show user what things looked like
if (!string.Equals (expectedLook, actualLook))
{
output?.WriteLine ("Expected:" + Environment.NewLine + expectedLook);
output?.WriteLine (" But Was:" + Environment.NewLine + actualLook);
}
Assert.Equal (expectedLook, actualLook);
}
///
/// Asserts that the driver contents are equal to the provided string.
///
///
///
/// The ConsoleDriver to use. If null will be used.
///
public static Rectangle AssertDriverContentsWithFrameAre (
string expectedLook,
ITestOutputHelper output,
ConsoleDriver driver = null
)
{
List> lines = new ();
var sb = new StringBuilder ();
driver ??= Application.Driver;
int x = -1;
int y = -1;
int w = -1;
int h = -1;
Cell [,] contents = driver.Contents;
for (var rowIndex = 0; rowIndex < driver.Rows; rowIndex++)
{
List runes = [];
for (var colIndex = 0; colIndex < driver.Cols; colIndex++)
{
Rune runeAtCurrentLocation = contents [rowIndex, colIndex].Rune;
if (runeAtCurrentLocation != SpaceRune)
{
if (x == -1)
{
x = colIndex;
y = rowIndex;
for (var i = 0; i < colIndex; i++)
{
runes.InsertRange (i, [SpaceRune]);
}
}
if (runeAtCurrentLocation.GetColumns () > 1)
{
colIndex++;
}
if (colIndex + 1 > w)
{
w = colIndex + 1;
}
h = rowIndex - y + 1;
}
if (x > -1)
{
runes.Add (runeAtCurrentLocation);
}
// See Issue #2616
//foreach (var combMark in contents [r, c].CombiningMarks) {
// runes.Add (combMark);
//}
}
if (runes.Count > 0)
{
lines.Add (runes);
}
}
// Remove unnecessary empty lines
if (lines.Count > 0)
{
for (int r = lines.Count - 1; r > h - 1; r--)
{
lines.RemoveAt (r);
}
}
// Remove trailing whitespace on each line
foreach (List row in lines)
{
for (int c = row.Count - 1; c >= 0; c--)
{
Rune rune = row [c];
if (rune != (Rune)' ' || row.Sum (x => x.GetColumns ()) == w)
{
break;
}
row.RemoveAt (c);
}
}
// Convert Rune list to string
for (var r = 0; r < lines.Count; r++)
{
var line = StringExtensions.ToString (lines [r]);
if (r == lines.Count - 1)
{
sb.Append (line);
}
else
{
sb.AppendLine (line);
}
}
var actualLook = sb.ToString ();
if (string.Equals (expectedLook, actualLook))
{
return new (x > -1 ? x : 0, y > -1 ? y : 0, w > -1 ? w : 0, h > -1 ? h : 0);
}
// standardize line endings for the comparison
expectedLook = expectedLook.ReplaceLineEndings ();
actualLook = actualLook.ReplaceLineEndings ();
// Remove the first and the last line ending from the expectedLook
if (expectedLook.StartsWith (Environment.NewLine))
{
expectedLook = expectedLook [Environment.NewLine.Length..];
}
if (expectedLook.EndsWith (Environment.NewLine))
{
expectedLook = expectedLook [..^Environment.NewLine.Length];
}
// If test is about to fail show user what things looked like
if (!string.Equals (expectedLook, actualLook))
{
output?.WriteLine ("Expected:" + Environment.NewLine + expectedLook);
output?.WriteLine (" But Was:" + Environment.NewLine + actualLook);
}
Assert.Equal (expectedLook, actualLook);
return new (x > -1 ? x : 0, y > -1 ? y : 0, w > -1 ? w : 0, h > -1 ? h : 0);
}
#pragma warning disable xUnit1013 // Public method should be marked as test
///
/// Verifies two strings are equivalent. If the assert fails, output will be generated to standard output showing
/// the expected and actual look.
///
///
///
/// A string containing the expected look. Newlines should be specified as "\r\n" as they will
/// be converted to to make tests platform independent.
///
///
public static void AssertEqual (ITestOutputHelper output, string expectedLook, string actualLook)
{
// Convert newlines to platform-specific newlines
expectedLook = ReplaceNewLinesToPlatformSpecific (expectedLook);
// If test is about to fail show user what things looked like
if (!string.Equals (expectedLook, actualLook))
{
output?.WriteLine ("Expected:" + Environment.NewLine + expectedLook);
output?.WriteLine (" But Was:" + Environment.NewLine + actualLook);
}
Assert.Equal (expectedLook, actualLook);
}
#pragma warning restore xUnit1013 // Public method should be marked as test
public static View CreateViewFromType (Type type, ConstructorInfo ctor)
{
View viewType = null;
if (type.IsGenericType && type.IsTypeDefinition)
{
List gTypes = new ();
foreach (Type args in type.GetGenericArguments ())
{
gTypes.Add (typeof (object));
}
type = type.MakeGenericType (gTypes.ToArray ());
Assert.IsType (type, (View)Activator.CreateInstance (type));
}
else
{
ParameterInfo [] paramsInfo = ctor.GetParameters ();
Type paramType;
List