Files
Terminal.Gui/Tests/UnitTests/Views/HexViewTests.cs
Tig 7422385457 Fixes #4057 - MASSIVE! Fully implements ColorScheme->Scheme + VisualRole + Colors.->SchemeManager. (#4062)
* touching publish.yml

* ColorScheme->Scheme

* ColorScheme->Scheme 2

* Prototype of GetAttributeForRole

* Badly broke CM

* Further Badly broke CM

* Refactored CM big-time. View still broken

* All unit test pass again. Tons added. CM is still WIP, but Schemes is not mostly refactored and working.

* Actually:
All unit test pass again.
Tons added.
CM is still WIP, but Schemes is not mostly refactored and working.

* Bug fixes.
DeepMemberWiseClone cleanup

* Further cleanup of Scope<T>, ConfigProperty, etc.

* Made ConfigManager thread safe.

* WIP: Broken

* WIP: new deep clone impl

* WIP: new deep clone impl is done. Now fixing CM

* WIP:
- config.md
- Working on AOT clean up
- Core CM is broken; but known.

* WIP

* Merged.
Removed CM from Application.Init

* WIP

* More WIP; Less broke

* All CM unit tests pass... Not sure if it actually works though

* All unit tests pass... Themes are broken though in UI Cat

* CM Ready for review?

* Fixed failures due to TextStyles PR

* Working on Scheme/Attribute

* Working on Scheme/Attribute 2

* Working on Scheme/Attribute 3

* Working on Scheme/Attribute 4

* Working on Scheme/Attribute 5

* Working on Scheme/Attribute 6

* Added test to show how awful memory usage is

* Improved schema. Updated config.json

* Nade Scope<T> concurrentdictionary and added test to prove

* Made Themes ConcrurrentDictionary. Added bunches of tests

* Code cleanup

* Code cleanup 2

* Code cleanup 3

* Tweaking Scheme

* ClearJsonErrors

* ClearJsonErrors2

* Updated Attribute API

* It all (mostly) works!

* Skip odd unit test

* Messed with Themes

* Theme tweaks

* Code reorg. New .md stuff

* Fixed Enabled. Added mock driver

* Fixed a bunch of View.Enabled related issues

* Scheme -> Get/SetScheme()

* Cleanup

* Cleanup2

* Broke something

* Fixed everything

* Made CM.Enable better

* Text Style Scenario

* Added comments

* Fixed UI Catalog Theme Changing

* Fixed more dynamic CM update stuff

* Warning cleanup

* New Default Theme

* fixed unit test

* Refactoring Scheme and Attribute to fix inheritance

* more unit tests

* ConfigProperty is not updating schemes correctly

* All unit tests pass.
Code cleanup

* All unit tests pass.
Code cleanup2

* Fixed unit tests

* Upgraded TextField and TextView

* Fixed TextView !Enabled bug

* More updates to TextView. More unit tests for SchemeManager

* Upgraded CharMap

* API docs

* Fixe HexView API

* upgrade HexView

* Fixed shortcut KeyView

* Fixed more bugs. Added new themes

* updated themes

* upgraded Border

* Fixed themes memory usage...mostly

* Fixed themes memory usage...mostly2

* Fixed themes memory usage...2

* Fixed themes memory usage...3

* Added new colors

* Fixed GetHardCodedConfig bug

* Added Themes Scenario - WIP

* Added Themes Scenario

* Tweaked Themes Scenario

* Code cleanup

* Fixed json schmea

* updated deepdives

* updated deepdives

* Tweaked Themes Scenario

* Made Schemes a concurrent dict

* Test cleanup

* Thread safe ConfigProperty tests

* trying to make things more thread safe

* more trying to make things more thread safe

* Fixing bugs in shadowview

* Fixing bugs in shadowview 2

* Refactored GetViewsUnderMouse to GetViewsUnderLocation etc...

* Fixed dupe unit tests?

* Added better description of layout and coordiantes to deep dive

* Added better description of layout and coordiantes to deep dive

* Modified tests that call v2.AddTimeout; they were returning true which means restart the timer!
This was causing mac/linux unit test failures.
I think

* Fixed auto scheme.
Broke TextView/TextField selection

* Realized Attribute.IsExplicitlySet is stupid; just use nullable

* Fixed Attribute. Simplified. MOre theme testing

* Updated themes again

* GetViewsUnderMouse to GetViewsUnderLocation broke TransparentMouse.

* Fixing mouseunder bugs

* rewriting...

* All working again.
Shadows are now slick as snot.
GetViewsUnderLocation is rewritten to actually work and be readable.
Tons more low-level unit tests.
Margin is now actually ViewportSettings.Transparent.

* Code cleanup

* Code cleanup

* Code cleanup of color apis

* Fixed Hover/Highlight

* Update Examples/UICatalog/Scenarios/AllViewsTester.cs

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

* Update Examples/UICatalog/Scenarios/CharacterMap/CharacterMap.cs

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

* Update Examples/UICatalog/Scenarios/Clipping.cs

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

* Fixed race condition?

* reverted

* Simplified Attribute API by removing events from SetAttributeForRole

* Removed recursion from GetViewsAtLocation

* Removed unneeded code

* Code clean up.
Fixed Scheme bug.

* reverted temporary disable

* Adjusted scheme algo

* Upgraded TextValidateField

* Fixed TextValidate bugs

* Tweaks

* Frameview rounded border by default

* API doc cleanup

* Readme fix

* Addressed tznind feeback

* Fixed more unit test issues by protecting Application statics from being set if Application.Initialized is not true

* Fixed more unit test issues by protecting Application statics from being set if Application.Initialized is not true 2

* cleanup

---------

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
2025-05-29 13:55:54 -06:00

429 lines
15 KiB
C#

#nullable enable
using System.Text;
using JetBrains.Annotations;
namespace Terminal.Gui.ViewsTests;
public class HexViewTests
{
[Theory]
[InlineData (0, 4)]
[InlineData (4, 4)]
[InlineData (8, 4)]
[InlineData (35, 4)]
[InlineData (36, 8)]
[InlineData (37, 8)]
[InlineData (41, 8)]
[InlineData (54, 12)]
[InlineData (55, 12)]
[InlineData (71, 12)]
[InlineData (72, 16)]
[InlineData (73, 16)]
public void BytesPerLine_Calculates_Correctly (int width, int expectedBpl)
{
var hv = new HexView (LoadStream (null, out long _)) { Width = width, Height = 10, AddressWidth = 0 };
hv.Layout ();
Assert.Equal (width, hv.Frame.Width);
Assert.Equal (expectedBpl, hv.BytesPerLine);
}
[Fact]
public void ReadOnly_Prevents_Edits ()
{
var hv = new HexView (LoadStream (null, out _, true)) { Width = 20, Height = 20 };
Application.Navigation = new ApplicationNavigation ();
Application.Top = new Toplevel ();
Application.Top.Add (hv);
Application.Top.SetFocus ();
// Needed because HexView relies on LayoutComplete to calc sizes
hv.LayoutSubViews ();
Assert.True (Application.RaiseKeyDownEvent (Key.Tab)); // Move to left side
Assert.Empty (hv.Edits);
hv.ReadOnly = true;
Assert.True (Application.RaiseKeyDownEvent (Key.Home));
Assert.False (Application.RaiseKeyDownEvent (Key.A));
Assert.Empty (hv.Edits);
Assert.Equal (126, hv.Source!.Length);
hv.ReadOnly = false;
Assert.True (Application.RaiseKeyDownEvent (Key.D4));
Assert.True (Application.RaiseKeyDownEvent (Key.D1));
Assert.Single (hv.Edits);
Assert.Equal (65, hv.Edits.ToList () [0].Value);
Assert.Equal ('A', (char)hv.Edits.ToList () [0].Value);
Assert.Equal (126, hv.Source.Length);
// Appends byte
Assert.True (Application.RaiseKeyDownEvent (Key.End));
Assert.True (Application.RaiseKeyDownEvent (Key.D4));
Assert.True (Application.RaiseKeyDownEvent (Key.D2));
Assert.Equal (2, hv.Edits.Count);
Assert.Equal (66, hv.Edits.ToList () [1].Value);
Assert.Equal ('B', (char)hv.Edits.ToList () [1].Value);
Assert.Equal (126, hv.Source.Length);
hv.ApplyEdits ();
Assert.Empty (hv.Edits);
Assert.Equal (127, hv.Source.Length);
Application.Top.Dispose ();
Application.ResetState (true);
}
[Fact]
public void ApplyEdits_With_Argument ()
{
Application.Navigation = new ApplicationNavigation ();
Application.Top = new Toplevel ();
byte [] buffer = Encoding.Default.GetBytes ("Fest");
var original = new MemoryStream ();
original.Write (buffer, 0, buffer.Length);
original.Flush ();
var copy = new MemoryStream ();
original.Position = 0;
original.CopyTo (copy);
copy.Flush ();
var hv = new HexView (copy) { Width = Dim.Fill (), Height = Dim.Fill () };
Application.Top.Add (hv);
Application.Top.SetFocus ();
// Needed because HexView relies on LayoutComplete to calc sizes
hv.LayoutSubViews ();
var readBuffer = new byte [hv.Source!.Length];
hv.Source.Position = 0;
hv.Source.Read (readBuffer);
Assert.Equal ("Fest", Encoding.Default.GetString (readBuffer));
Assert.True (Application.RaiseKeyDownEvent (Key.Tab)); // Move to left side
Assert.True (Application.RaiseKeyDownEvent (Key.D5));
Assert.True (Application.RaiseKeyDownEvent (Key.D4));
readBuffer [hv.Edits.ToList () [0].Key] = hv.Edits.ToList () [0].Value;
Assert.Equal ("Test", Encoding.Default.GetString (readBuffer));
Assert.True (Application.RaiseKeyDownEvent (Key.Tab)); // Move to right side
Assert.True (Application.RaiseKeyDownEvent (Key.CursorLeft));
Assert.True (Application.RaiseKeyDownEvent (Key.Z.WithShift));
readBuffer [hv.Edits.ToList () [0].Key] = hv.Edits.ToList () [0].Value;
Assert.Equal ("Zest", Encoding.Default.GetString (readBuffer));
hv.ApplyEdits (original);
original.Position = 0;
original.Read (buffer);
copy.Position = 0;
copy.Read (readBuffer);
Assert.Equal ("Zest", Encoding.Default.GetString (buffer));
Assert.Equal ("Zest", Encoding.Default.GetString (readBuffer));
Assert.Equal (Encoding.Default.GetString (buffer), Encoding.Default.GetString (readBuffer));
Application.Top.Dispose ();
Application.ResetState (true);
}
[Fact]
public void Constructors_Defaults ()
{
var hv = new HexView ();
Assert.NotNull (hv.Source);
Assert.IsAssignableFrom<MemoryStream> (hv.Source);
Assert.True (hv.CanFocus);
Assert.True (!hv.ReadOnly);
hv = new (new MemoryStream ());
Assert.NotNull (hv.Source);
Assert.IsAssignableFrom<Stream> (hv.Source);
Assert.True (hv.CanFocus);
Assert.True (!hv.ReadOnly);
}
[Fact]
public void Position_Encoding_Default ()
{
Application.Navigation = new ApplicationNavigation ();
var hv = new HexView (LoadStream (null, out _)) { Width = 100, Height = 100 };
Application.Top = new Toplevel ();
Application.Top.Add (hv);
Application.Top.LayoutSubViews ();
Assert.Equal (63, hv.Source!.Length);
Assert.Equal (20, hv.BytesPerLine);
Assert.Equal (new (0, 0), hv.GetPosition (hv.Address));
Assert.True (Application.RaiseKeyDownEvent (Key.Tab));
Assert.Equal (new (0, 0), hv.GetPosition (hv.Address));
Assert.True (Application.RaiseKeyDownEvent (Key.CursorRight.WithCtrl));
Assert.Equal (hv.BytesPerLine - 1, hv.GetPosition (hv.Address).X);
Assert.True (Application.RaiseKeyDownEvent (Key.Home));
Assert.True (Application.RaiseKeyDownEvent (Key.CursorRight));
Assert.Equal (new (1, 0), hv.GetPosition (hv.Address));
Assert.True (Application.RaiseKeyDownEvent (Key.CursorDown));
Assert.Equal (new (1, 1), hv.GetPosition (hv.Address));
Assert.True (Application.RaiseKeyDownEvent (Key.End));
Assert.Equal (new (3, 3), hv.GetPosition (hv.Address));
Assert.Equal (hv.Source!.Length, hv.Address);
Application.Top.Dispose ();
Application.ResetState (true);
}
[Fact]
public void Position_Encoding_Unicode ()
{
Application.Navigation = new ApplicationNavigation ();
var hv = new HexView (LoadStream (null, out _, unicode: true)) { Width = 100, Height = 100 };
Application.Top = new Toplevel ();
Application.Top.Add (hv);
hv.LayoutSubViews ();
Assert.Equal (126, hv.Source!.Length);
Assert.Equal (20, hv.BytesPerLine);
Assert.Equal (new (0, 0), hv.GetPosition (hv.Address));
Assert.True (Application.RaiseKeyDownEvent (Key.Tab));
Assert.True (Application.RaiseKeyDownEvent (Key.CursorRight.WithCtrl));
Assert.Equal (hv.BytesPerLine - 1, hv.GetPosition (hv.Address).X);
Assert.True (Application.RaiseKeyDownEvent (Key.Home));
Assert.True (Application.RaiseKeyDownEvent (Key.CursorRight));
Assert.Equal (new (1, 0), hv.GetPosition (hv.Address));
Assert.True (Application.RaiseKeyDownEvent (Key.CursorDown));
Assert.Equal (new (1, 1), hv.GetPosition (hv.Address));
Assert.True (Application.RaiseKeyDownEvent (Key.End));
Assert.Equal (new (6, 6), hv.GetPosition (hv.Address));
Assert.Equal (hv.Source!.Length, hv.Address);
Application.Top.Dispose ();
Application.ResetState (true);
}
[Fact]
public void DiscardEdits_Method ()
{
var hv = new HexView (LoadStream (null, out _, true)) { Width = 20, Height = 20 };
// Needed because HexView relies on LayoutComplete to calc sizes
hv.LayoutSubViews ();
Assert.True (hv.NewKeyDownEvent (Key.D4));
Assert.True (hv.NewKeyDownEvent (Key.D1));
Assert.Single (hv.Edits);
Assert.Equal (65, hv.Edits.ToList () [0].Value);
Assert.Equal ('A', (char)hv.Edits.ToList () [0].Value);
Assert.Equal (126, hv.Source!.Length);
hv.DiscardEdits ();
Assert.Empty (hv.Edits);
}
[Fact]
public void Edited_Event ()
{
var hv = new HexView (LoadStream (null, out _, true)) { Width = 20, Height = 20 };
// Needed because HexView relies on LayoutComplete to calc sizes
hv.LayoutSubViews ();
KeyValuePair<long, byte> keyValuePair = default;
hv.Edited += (s, e) => keyValuePair = new (e.Address, e.NewValue);
Assert.True (hv.NewKeyDownEvent (Key.D4));
Assert.True (hv.NewKeyDownEvent (Key.D6));
Assert.Equal (0, (int)keyValuePair.Key);
Assert.Equal (70, keyValuePair.Value);
Assert.Equal ('F', (char)keyValuePair.Value);
}
[Fact]
public void Exceptions_Tests ()
{
Assert.Throws<ArgumentNullException> (() => new HexView (null));
Assert.Throws<ArgumentException> (() => new HexView (new NonSeekableStream (new MemoryStream ())));
}
[Fact]
public void KeyBindings_Test_Movement_LeftSide ()
{
Application.Navigation = new ApplicationNavigation ();
Application.Top = new Toplevel ();
var hv = new HexView (LoadStream (null, out _)) { Width = 20, Height = 10 };
Application.Top.Add (hv);
hv.LayoutSubViews ();
Assert.Equal (MEM_STRING_LENGTH, hv.Source!.Length);
Assert.Equal (0, hv.Address);
Assert.Equal (4, hv.BytesPerLine);
// Default internal focus is on right side. Move back to left.
Assert.True (Application.RaiseKeyDownEvent (Key.Tab.WithShift));
Assert.True (Application.RaiseKeyDownEvent (Key.CursorRight));
Assert.Equal (1, hv.Address);
Assert.True (Application.RaiseKeyDownEvent (Key.CursorLeft));
Assert.Equal (0, hv.Address);
Assert.True (Application.RaiseKeyDownEvent (Key.CursorDown));
Assert.Equal (4, hv.Address);
Assert.True (Application.RaiseKeyDownEvent (Key.CursorUp));
Assert.Equal (0, hv.Address);
Assert.True (Application.RaiseKeyDownEvent (Key.PageDown));
Assert.Equal (40, hv.Address);
Assert.True (Application.RaiseKeyDownEvent (Key.PageUp));
Assert.Equal (0, hv.Address);
Assert.True (Application.RaiseKeyDownEvent (Key.End));
Assert.Equal (MEM_STRING_LENGTH, hv.Address);
Assert.True (Application.RaiseKeyDownEvent (Key.Home));
Assert.Equal (0, hv.Address);
Assert.True (Application.RaiseKeyDownEvent (Key.CursorRight.WithCtrl));
Assert.Equal (3, hv.Address);
Assert.True (Application.RaiseKeyDownEvent (Key.CursorLeft.WithCtrl));
Assert.Equal (0, hv.Address);
Assert.True (Application.RaiseKeyDownEvent (Key.CursorDown.WithCtrl));
Assert.Equal (36, hv.Address);
Assert.True (Application.RaiseKeyDownEvent (Key.CursorUp.WithCtrl));
Assert.Equal (0, hv.Address);
Application.Top.Dispose ();
Application.ResetState (true);
}
[Fact]
public void PositionChanged_Event ()
{
var hv = new HexView (LoadStream (null, out _)) { Width = 20, Height = 10 };
Application.Top = new Toplevel ();
Application.Top.Add (hv);
Application.Top.LayoutSubViews ();
HexViewEventArgs hexViewEventArgs = null!;
hv.PositionChanged += (s, e) => hexViewEventArgs = e;
Assert.Equal (4, hv.BytesPerLine);
Assert.True (hv.NewKeyDownEvent (Key.CursorRight)); // left side must press twice
Assert.True (hv.NewKeyDownEvent (Key.CursorRight));
Assert.True (hv.NewKeyDownEvent (Key.CursorDown));
Assert.Equal (4, hexViewEventArgs.BytesPerLine);
Assert.Equal (new (1, 1), hexViewEventArgs.Position);
Assert.Equal (5, hexViewEventArgs.Address);
Application.Top.Dispose ();
Application.ResetState (true);
}
[Fact]
public void Source_Sets_Address_To_Zero_If_Greater_Than_Source_Length ()
{
var hv = new HexView (LoadStream (null, out _)) { Width = 10, Height = 5 };
Application.Top = new Toplevel ();
Application.Top.Add (hv);
Application.Top.Layout ();
Assert.True (hv.NewKeyDownEvent (Key.End));
Assert.Equal (MEM_STRING_LENGTH, hv.Address);
hv.Source = new MemoryStream ();
Application.Top.Layout ();
Assert.Equal (0, hv.Address);
hv.Source = LoadStream (null, out _);
hv.Width = Dim.Fill ();
hv.Height = Dim.Fill ();
Application.Top.Layout ();
Assert.Equal (0, hv.Address);
Assert.True (hv.NewKeyDownEvent (Key.End));
Assert.Equal (MEM_STRING_LENGTH, hv.Address);
hv.Source = new MemoryStream ();
Application.Top.Layout ();
Assert.Equal (0, hv.Address);
Application.Top.Dispose ();
Application.ResetState (true);
}
private const string MEM_STRING = "Hello world.\nThis is a test of the Emergency Broadcast System.\n";
private const int MEM_STRING_LENGTH = 63;
private Stream LoadStream (string? memString, out long numBytesInMemString, bool unicode = false)
{
var stream = new MemoryStream ();
byte [] bArray;
Assert.Equal (MEM_STRING_LENGTH, MEM_STRING.Length);
if (memString is null)
{
memString = MEM_STRING;
}
if (unicode)
{
bArray = Encoding.Unicode.GetBytes (memString);
}
else
{
bArray = Encoding.Default.GetBytes (memString);
}
numBytesInMemString = bArray.Length;
stream.Write (bArray);
return stream;
}
private class NonSeekableStream (Stream baseStream) : Stream
{
public override bool CanRead => baseStream.CanRead;
public override bool CanSeek => false;
public override bool CanWrite => baseStream.CanWrite;
public override long Length => throw new NotSupportedException ();
public override long Position
{
get => baseStream.Position;
set => throw new NotSupportedException ();
}
public override void Flush () { baseStream.Flush (); }
public override int Read (byte [] buffer, int offset, int count) { return baseStream.Read (buffer, offset, count); }
public override long Seek (long offset, SeekOrigin origin) { throw new NotImplementedException (); }
public override void SetLength (long value) { throw new NotSupportedException (); }
public override void Write (byte [] buffer, int offset, int count) { baseStream.Write (buffer, offset, count); }
}
}