Files
Terminal.Gui/Tests/UnitTestsParallelizable/Drawing/LineCanvasTests.cs
Tig a84b2c4896 Fixes #4419, #4148, #4408 - Toplevel is GONE - Replaced by Runnable (#4422)
* WIP: Broken

* Got working. Mostly.

* Parllel tests pass

* More progres

* Fixed app tests.

* Mouse

* more progress.

* working on shortcut

* Shortcut accept on ENTER is broken.

* One left...

* More test progress.

* All unit tests pass. Still some issues though.

* tweak

* Fixed Integration Tests

* Fixed UI Catalog

* Tweaking CP to try to find race condition

* Refactor StandardColors and improve ColorPicker logic

Refactored `StandardColors` to use lazy initialization for static fields, improving performance and avoiding static constructor convoy effects. Introduced `NamesValueFactory` and `MapValueFactory` methods for encapsulated initialization logic.

Simplified `GetColorNames` to directly return `_names.Value`. Improved `TryParseColor` by clarifying default value usage and adopting object initializer syntax. Updated `TryNameColor` to use `_argbNameMap.Value`.

Refactored `GetArgb` for better readability. Replaced `MultiStandardColorNameResolver` with `StandardColorsNameResolver` in `ColorPicker`. Commented out `app.Init("Fake")` in `ColorPickerTests` for testing purposes.

Made minor formatting improvements, including updated comments and XML documentation for consistency.

* revert

* Throttle input loop to prevent CPU spinning

Introduce a 20ms delay in the input loop of `InputImpl<TInputRecord>`
to prevent excessive CPU usage when no input is available. Removed
the `DateTime dt = Now();` line and the `while (Peek())` block, which
previously enqueued input records.

This change improves resource management, especially in scenarios
where multiple `ApplicationImpl` instances are created in parallel
tests without calling `Shutdown()`. It prevents thread pool
exhaustion and ensures better performance in such cases.

* Refactor ApplicationImpl to use IDisposable pattern

Implemented the IDisposable pattern in ApplicationImpl to improve resource management. Added `Dispose` and `DisposeCore` methods, and marked the `Shutdown` method as obsolete, encouraging the use of `Dispose` or `using` statements instead. Updated the `IApplication` interface to inherit from IDisposable and added `GetResult` methods for retrieving run session results.

Refactored unit tests to adopt the new lifecycle management approach, replacing legacy `Shutdown` calls with `Dispose` or `using`. Removed fragile and obsolete tests, and re-enabled previously skipped tests after addressing underlying issues.

Updated `FakeApplicationLifecycle` and `SetupFakeApplicationAttribute` to align with the new disposal pattern. Improved documentation and examples to guide users toward modern usage patterns. Maintained backward compatibility for legacy singleton usage.

* Add IDisposable pattern with input loop throttling

- Add IDisposable to IApplication for proper resource cleanup
- Add 20ms throttle to input loop (prevents CPU spinning)
- Add Lazy<T> to StandardColors (eliminates convoy effect)
- Add MainLoopCoordinatorTests suite (5 new tests)
- Add Dispose() calls to all 16 ColorPickerTests
- Mark Application.Shutdown() as [Obsolete]

IApplication now requires Dispose() for cleanup

Performance: 100x CPU reduction, 15x faster disposal, tests complete in <5s

Fixes: Thread leaks, CPU saturation, test hangs in parallel execution
Docs: Updated application.md and newinv2.md with disposal patterns

* Refactor test for input loop throttling clarity

Updated `InputLoop_Throttle_Limits_Poll_Rate` test to improve clarity, reliability, and efficiency:
- Rewrote summary comment to clarify purpose and emphasize the 20ms throttle's role in preventing CPU spinning.
- Replaced `var` with explicit types for better readability.
- Reduced test duration from 1s to 500ms to improve test speed.
- Revised assertions:
  - Replaced range-based assertion with upper-bound check to ensure poll count is below 500, avoiding timing sensitivity issues.
  - Added assertion to verify the thread ran and was not immediately canceled.
- Added a 2-second timeout to `inputTask.Wait` and verified task completion.
- Improved comments to explain test behavior and reasoning behind changes.

* tweaks

* Fix nullabiltiy stuff.

* runnable fixes

* more nullabe

* More nullability

* warnings gone

* Fixed fluent test failure.

* Refactor ApplicationImpl and update Runnable layout logic

Refactored `ApplicationImpl.Run.cs` for improved readability and
atomicity:
- Combined `if (wasModal)` with `SessionStack?.TryPop` to streamline
  logic.
- Simplified restoration of `previousRunnable` by reducing nesting.
- Updated comments for clarity and retained `SetIsModal` call.

Simplified focus-setting logic in `ApplicationImpl.Run.cs` using
pattern matching for `TopRunnableView`.

In `Runnable<TResult>`, added `SetNeedsLayout` after `IsModalChanged`
to ensure layout updates. Removed an unused empty line for cleanup.

Corrected namespace in `GetViewsUnderLocationForRootTests.cs` to
align with test structure.

* Update layout on modal state change

A call to `SetNeedsLayout()` was added to the `OnIsModalChanged`
method in the `Runnable` class. This ensures that the layout
is updated whenever the modal state changes.

* Increase test timeout for inputTask.Wait to 10 seconds

Extended the timeout duration for the `inputTask.Wait` method
from 4 seconds to 10 seconds in `MainLoopCoordinatorTests`.
This change ensures the test has a longer window to complete
under conditions of increased load or slower execution
environments, reducing the likelihood of false test failures.

* Refactor project files and simplify test logic

Removed `<LangVersion>` and `<ImplicitUsings>` properties from
`UnitTests.csproj` and `UnitTests.Parallelizable.csproj` to rely
on default SDK settings and disable implicit global usings.

Simplified the `SizeChanged_Event_Still_Fires_For_Compatibility`
test in `FakeDriverTests` by removing the `screenChangedFired`
variable, its associated event handler, and related assertions.
Also removed obsolete warning suppression directives as they
are no longer needed.

* Reduce UnitTestsParallelizable iterations from 10 to 3

Reduced the number of iterations for the UnitTestsParallelizable
test suite from 10 to 3 to save time and resources while still
exposing concurrency issues. Updated the loop and log messages
to reflect the new iteration count.

* disabled InputLoop_Throttle_Limits_Poll_Rate

* Refactor app lifecycle and improve Runnable API

Refactored `Program.cs` to simplify application lifecycle:
- Modularized app creation, initialization, and disposal.
- Improved result handling and ensured proper resource cleanup.

Re-implemented `Runnable<TResult>` with a cleaner design:
- Retained functionality while improving readability and structure.
- Added XML documentation and followed the Cancellable Work Pattern.

Re-implemented `RunnableWrapper<TView, TResult>`:
- Enabled wrapping any `View` to make it runnable with typed results.
- Added examples and remarks for better developer guidance.

Re-implemented `ViewRunnableExtensions`:
- Provided fluent API for making views runnable with or without results.
- Enhanced documentation with examples for common use cases.

General improvements:
- Enhanced code readability, maintainability, and error handling.
- Replaced redundant code with cleaner, more maintainable versions.

* Modernize codebase for Terminal.Gui and MVVM updates

Refactored `LoginView` to remove redundant `Application.LayoutAndDraw()`
call. Enhanced `LoginViewModel` with new observable properties for
automatic property change notifications. Updated `Message` class to use
nullable generics for improved type safety.

Replaced legacy `Application.Init()` and `Application.Run()` calls with
the modern `IApplication` API across `Program.cs`, `Example.cs`, and
`ReactiveExample`. Ensured proper disposal of `IApplication` instances
to prevent resource leaks.

Updated `TerminalScheduler` to integrate with `IApplication` for
invoking actions and managing timeouts. Added null checks and improved
timeout disposal logic for robustness.

Refactored `ExampleWindow` for better readability and alignment with
modern `Terminal.Gui` conventions. Cleaned up unused imports and
improved code clarity across the codebase.

Updated README.md to reflect the latest `Terminal.Gui` practices,
including examples of the `IApplication` API and automatic UI refresh
handling. Renamed `LoginAction` to `LoginActions` for consistency.

* Refactor: Transition to IRunnable-based architecture

Replaced `Toplevel` with `Window` as the primary top-level UI element. Introduced the `IRunnable` interface to modernize the architecture, enabling greater flexibility and testability. Deprecated the static `Application` class in favor of the instance-based `IApplication` model, which supports multiple application contexts.

Updated methods like `Application.Run()` and `Application.RequestStop()` to use `IRunnable`. Removed or replaced legacy `Modal` properties with `IsModal`. Enhanced the `IApplication` interface with a fluent API, including methods like `Run<TRunnable>()` and `GetResult<T>()`.

Refactored tests and examples to align with the new architecture. Updated documentation to reflect the instance-based model. Deprecated obsolete members and methods, including `Application.Current` and `Application.TopRunnable`.

Improved event handling by replacing the `Accept` event with `Accepting` and using `e.Handled` for event processing. Updated threading examples to use `App?.Invoke()` or `app.Invoke()` for UI updates. Cleaned up redundant code and redefined modal behavior for better consistency.

These changes modernize the `Terminal.Gui` library, improving clarity, usability, and maintainability while ensuring backward compatibility where possible.

* Refactor: Replace Toplevel with Runnable class

This commit introduces a major architectural update to the `Terminal.Gui` library, replacing the legacy `Toplevel` class with the new `Runnable` class. The changes span the entire codebase, including core functionality, tests, documentation, and configuration files.

- **Core Class Replacement**:
  - Replaced `Toplevel` with `Runnable` as the base class for modal views and session management.
  - Updated all references to `Toplevel` in the codebase, including constructors, methods, and properties.

- **Configuration Updates**:
  - Updated `tui-config-schema.json` to reflect the new `Runnable` scheme.

- **New Classes**:
  - Added `UICatalogRunnable` for managing the UI Catalog application.
  - Introduced `Runnable<TResult>` as a generic base class for blocking sessions with result handling.

- **Documentation and Tests**:
  - Updated documentation to emphasize `Runnable` and mark `Toplevel` as obsolete.
  - Refactored test cases to use `Runnable` and ensure compatibility.

- **Behavioral Improvements**:
  - Enhanced lifecycle management and alignment with the `IRunnable` interface.
  - Improved clarity and consistency in naming conventions.

These changes modernize the library, improve flexibility, and provide a clearer architecture for developers.

* Refactor: Consolidate Runnable classes and decouple View from ApplicationImpl

- Made Runnable<TResult> inherit from Runnable (eliminating ~180 LOC duplication)
- Moved View init/layout/cursor logic from ApplicationImpl to Runnable lifecycle events
- ApplicationImpl.Begin now operates purely on IRunnable interface

Related to #4419

* Simplified the disposal logic in `ApplicationImpl.Run.cs` by replacing
the type-specific check for `View` with a more general check for
`IDisposable`. This ensures proper disposal of any `IDisposable`
object, improving robustness.

Removed the `FrameworkOwnedRunnable` property from the `ApplicationImpl`
class in `ApplicationImpl.cs` and the `IApplication` interface in
`IApplication.cs`. This eliminates the need to manage this property,
reducing complexity and improving maintainability.

Updated `application.md` to reflect the removal of the
`FrameworkOwnedRunnable` property, ensuring the documentation aligns
with the updated codebase.

* Replaces the legacy `Shutdown()` method with `Dispose()` to align
with the `IDisposable` pattern, ensuring proper resource cleanup
and simplifying the API. The `Dispose()` method is now the
recommended way to release resources, with `using` statements
encouraged for automatic disposal.

Key changes:
- Marked `Shutdown()` as obsolete; it now internally calls `Dispose()`.
- Updated the fluent API to remove `Shutdown()` from chaining.
- Enhanced session lifecycle management for thread safety.
- Updated tests to validate proper disposal and state reset.
- Improved `IRunnable` integration with automatic disposal for
  framework-created runnables.
- Maintained backward compatibility for the legacy static
  `Application` singleton.
- Refactored documentation and examples to reflect modern practices
  and emphasize `Dispose()` usage.

These changes modernize the `Terminal.Gui` lifecycle, improve
testability, and encourage alignment with .NET conventions.

* Refactor runnable app context handling in ApplicationImpl

Refactor how the application context is set for `runnable` objects
by introducing a new `SetApp` method in the `IRunnable` interface.
This replaces the previous logic of directly setting the `App`
property for `View` objects, making the process more generic and
encapsulated within `IRunnable` implementations.

Simplify `Mouse.UngrabMouse()` by removing the conditional check
and calling it unconditionally.

Make a minor formatting adjustment in the generic constraint of
`Run<TRunnable>` in `ApplicationImpl`.

Add `SetApp(IApplication app)` to the `IRunnable` interface and
implement it in the `Runnable` class to set the `App` property
to the provided application instance.

* Improve docs, tests, and modularity across the codebase

Reorganized and updated `CONTRIBUTING.md`:
- Added **Key Architecture Concepts** section and reordered the table of contents.
- Updated testing requirements to discourage legacy patterns.
- Added instructions for replicating CI workflows locally.
- Clarified PR guidelines and coding style expectations.

Enhanced `README.md` with detailed CI/CD workflow documentation.

Refactored `ColorPicker.Prompt` to use `IApplication` for improved modularity and testability.

Introduced `IApplicationScreenChangedTests` for comprehensive testing of `ScreenChanged` events and `Screen` property.

Refactored `ApplicationScreenTests` and `TextView.PromptForColors` to align with modern patterns.

Updated `Terminal.sln` to include `.github/workflows/README.md`.

Performed general cleanup:
- Removed outdated documentation links.
- Improved XML documentation and coding consistency.

* readme tweaks

* Improve thread safety, layout, and test coverage

Refactored `OutputBufferImpl.cs` to enhance thread safety by locking shared resources and adding bounds checks for columns and rows. Improved handling of wide characters and removed outdated TODO comments.

Updated `Runnable.cs` to call `SetNeedsDraw()` on modal state changes, ensuring proper layout and drawing updates. Simplified layout handling in `ApplicationImpl.Run.cs` by replacing redundant comments with a `LayoutAndDraw()` call.

Added a check in `AllViewsTester.cs` to skip creating instances of `RunnableWrapper` types with unsatisfiable generic constraints, logging a warning when encountered.

Enhanced `ListViewTests.cs` by adding explicit `app.LayoutAndDraw()` calls to validate visual output and ensure tests reflect the updated application state.

These changes improve robustness, prevent race conditions, and ensure consistent behavior across the application.

* Refactor: Rename Toplevel to Runnable and update logic

Updated the `Border` class to use `Command.Quit` instead of
`Command.QuitToplevel` in the `CloseButton.Accept` handler.

Renamed test methods in `GetViewsAtLocationTests.cs` to replace
"Toplevel" with "Runnable" for consistency. Updated `Runnable<bool>`
instances to use "topRunnable" as the `Id` property.

These changes align the codebase with updated naming conventions
and improve clarity.

* Removed `ToplevelTests` and migrated relevant test cases to
`MouseDragTests` with improved structure and coverage. Updated
tests to use `Application.Create`, `app.Begin`, and `app.End`
for better resource management and lifecycle handling.

Replaced direct event handling with `app.Mouse.RaiseMouseEvent`
to align with the application's event-handling mechanism. Added
`Runnable` objects to ensure views are properly initialized and
disposed of within the application context.

Enhanced tests to include assertions for minimum width and
height constraints during resize operations. Removed redundant
tests and streamlined logic to reduce duplication and improve
maintainability.

* Reorged Unit Test namespaces.

* more

* Refactor tests and update namespaces for consistency

Updated namespaces in `ArrangementTests.cs` and `MouseDragTests.cs` for better organization. Enhanced `ArrangementTests.cs` with additional checks for arrangement flags. Reformatted and re-added `MouseDragTests.cs` and `SchemeTests.cs` with modern C# features like nullable annotations and object initializers. Ensured no functional changes while improving code clarity and consistency.

* Fix nullability warnings in MouseDragTests.cs

Updated `app.End` calls to use the null-forgiving operator (`!`)
on `app.SessionStack` to ensure it is treated as non-null.
This change addresses potential nullability warnings and
improves code safety and clarity. Applied consistently across
all relevant test cases in the `MouseDragTests` class.
2025-12-01 12:54:21 -07:00

1511 lines
49 KiB
C#

using System.Text;
using UnitTests;
using Xunit.Abstractions;
namespace DrawingTests;
/// <summary>
/// Pure unit tests for <see cref="LineCanvas"/> that don't require Application.Driver or View context.
/// These tests focus on properties and behavior that don't depend on glyph rendering.
/// Note: Tests that verify rendered output (ToString()) cannot be parallelized because LineCanvas
/// depends on Application.Driver for glyph resolution and configuration. Those tests remain in UnitTests.
/// </summary>
public class LineCanvasTests (ITestOutputHelper output) : FakeDriverBase
{
#region Basic API Tests
[Fact]
public void Empty_Canvas_ToString_Returns_EmptyString ()
{
var canvas = new LineCanvas ();
Assert.Equal (string.Empty, canvas.ToString ());
}
[Fact]
public void Clear_Removes_All_Lines ()
{
var canvas = new LineCanvas ();
canvas.AddLine (new (0, 0), 5, Orientation.Horizontal, LineStyle.Single);
canvas.AddLine (new (0, 0), 3, Orientation.Vertical, LineStyle.Single);
canvas.Clear ();
Assert.Empty (canvas.Lines);
Assert.Equal (Rectangle.Empty, canvas.Bounds);
Assert.Equal (string.Empty, canvas.ToString ());
}
[Fact]
public void Lines_Property_Returns_ReadOnly_Collection ()
{
var canvas = new LineCanvas ();
canvas.AddLine (new (0, 0), 5, Orientation.Horizontal, LineStyle.Single);
Assert.Single (canvas.Lines);
Assert.IsAssignableFrom<IReadOnlyCollection<StraightLine>> (canvas.Lines);
}
[Fact]
public void AddLine_Adds_Line_To_Collection ()
{
var canvas = new LineCanvas ();
Assert.Empty (canvas.Lines);
canvas.AddLine (new (0, 0), 5, Orientation.Horizontal, LineStyle.Single);
Assert.Single (canvas.Lines);
canvas.AddLine (new (0, 0), 3, Orientation.Vertical, LineStyle.Single);
Assert.Equal (2, canvas.Lines.Count);
}
[Fact]
public void Constructor_With_Lines_Creates_Canvas_With_Lines ()
{
StraightLine [] lines = new []
{
new StraightLine (new (0, 0), 5, Orientation.Horizontal, LineStyle.Single),
new StraightLine (new (0, 0), 3, Orientation.Vertical, LineStyle.Single)
};
var canvas = new LineCanvas (lines);
Assert.Equal (2, canvas.Lines.Count);
}
#endregion
#region Bounds Tests - Tests for Bounds property
[Theory]
[InlineData (0, 0, 0, 0, 0, 1, 1)]
[InlineData (0, 0, 1, 0, 0, 1, 1)]
[InlineData (0, 0, 2, 0, 0, 2, 2)]
[InlineData (0, 0, 3, 0, 0, 3, 3)]
[InlineData (0, 0, -1, 0, 0, 1, 1)]
[InlineData (0, 0, -2, -1, -1, 2, 2)]
[InlineData (0, 0, -3, -2, -2, 3, 3)]
public void Viewport_H_And_V_Lines_Both_Positive (
int x,
int y,
int length,
int expectedX,
int expectedY,
int expectedWidth,
int expectedHeight
)
{
var canvas = new LineCanvas ();
canvas.AddLine (new (x, y), length, Orientation.Horizontal, LineStyle.Single);
canvas.AddLine (new (x, y), length, Orientation.Vertical, LineStyle.Single);
Assert.Equal (new (expectedX, expectedY, expectedWidth, expectedHeight), canvas.Bounds);
}
[Theory]
[InlineData (0, 0, 0, 0, 0, 1, 1)]
[InlineData (0, 0, 1, 0, 0, 1, 1)]
[InlineData (0, 0, 2, 0, 0, 2, 1)]
[InlineData (0, 0, 3, 0, 0, 3, 1)]
[InlineData (0, 0, -1, 0, 0, 1, 1)]
[InlineData (0, 0, -2, -1, 0, 2, 1)]
[InlineData (0, 0, -3, -2, 0, 3, 1)]
public void Viewport_H_Line (
int x,
int y,
int length,
int expectedX,
int expectedY,
int expectedWidth,
int expectedHeight
)
{
var canvas = new LineCanvas ();
canvas.AddLine (new (x, y), length, Orientation.Horizontal, LineStyle.Single);
Assert.Equal (new (expectedX, expectedY, expectedWidth, expectedHeight), canvas.Bounds);
}
[Fact]
public void Bounds_Specific_Coordinates ()
{
var canvas = new LineCanvas ();
canvas.AddLine (new (5, 5), 3, Orientation.Horizontal, LineStyle.Single);
Assert.Equal (new (5, 5, 3, 1), canvas.Bounds);
}
[Fact]
public void Bounds_Empty_Canvas_Returns_Empty_Rectangle ()
{
var canvas = new LineCanvas ();
Assert.Equal (Rectangle.Empty, canvas.Bounds);
}
[Fact]
public void Bounds_Single_Point_Zero_Length ()
{
var canvas = new LineCanvas ();
canvas.AddLine (new (5, 5), 0, Orientation.Horizontal, LineStyle.Single);
Assert.Equal (new (5, 5, 1, 1), canvas.Bounds);
}
[Fact]
public void Bounds_Horizontal_Line ()
{
var canvas = new LineCanvas ();
canvas.AddLine (new (2, 3), 5, Orientation.Horizontal, LineStyle.Single);
Assert.Equal (new (2, 3, 5, 1), canvas.Bounds);
}
[Fact]
public void Bounds_Vertical_Line ()
{
var canvas = new LineCanvas ();
canvas.AddLine (new (2, 3), 5, Orientation.Vertical, LineStyle.Single);
Assert.Equal (new (2, 3, 1, 5), canvas.Bounds);
}
[Fact]
public void Bounds_Multiple_Lines_Returns_Union ()
{
var canvas = new LineCanvas ();
canvas.AddLine (new (0, 0), 5, Orientation.Horizontal, LineStyle.Single);
canvas.AddLine (new (0, 0), 3, Orientation.Vertical, LineStyle.Single);
Assert.Equal (new (0, 0, 5, 3), canvas.Bounds);
}
[Fact]
public void Bounds_Negative_Length_Line ()
{
var canvas = new LineCanvas ();
canvas.AddLine (new (5, 5), -3, Orientation.Horizontal, LineStyle.Single);
// Line from (5,5) going left 3 positions: includes points 3, 4, 5 (width 3, X starts at 3)
Assert.Equal (new (3, 5, 3, 1), canvas.Bounds);
}
[Fact]
public void Bounds_Complex_Box ()
{
var canvas = new LineCanvas ();
// top
canvas.AddLine (new (0, 0), 3, Orientation.Horizontal, LineStyle.Single);
// left
canvas.AddLine (new (0, 0), 2, Orientation.Vertical, LineStyle.Single);
// right
canvas.AddLine (new (2, 0), 2, Orientation.Vertical, LineStyle.Single);
// bottom
canvas.AddLine (new (0, 2), 3, Orientation.Horizontal, LineStyle.Single);
Assert.Equal (new (0, 0, 3, 3), canvas.Bounds);
}
#endregion
#region Exclusion Tests
[Fact]
public void ClearExclusions_Clears_Exclusion_Region ()
{
var canvas = new LineCanvas ();
canvas.AddLine (new (0, 0), 5, Orientation.Horizontal, LineStyle.Single);
var region = new Region (new (0, 0, 2, 1));
canvas.Exclude (region);
canvas.ClearExclusions ();
// After clearing exclusions, GetMap should return all points
Dictionary<Point, Rune> map = canvas.GetMap ();
Assert.Equal (5, map.Count);
}
[Fact]
public void Exclude_Removes_Points_From_Map ()
{
var canvas = new LineCanvas ();
canvas.AddLine (new (0, 0), 5, Orientation.Horizontal, LineStyle.Single);
var region = new Region (new (0, 0, 2, 1));
canvas.Exclude (region);
Dictionary<Point, Rune> map = canvas.GetMap ();
// Should have 5 - 2 = 3 points (excluding the first 2)
Assert.Equal (3, map.Count);
}
#endregion
#region Fill Property Tests
[Fact]
public void Fill_Property_Can_Be_Set ()
{
var foregroundFill = new SolidFill (new (255, 0));
var backgroundFill = new SolidFill (new (0, 0));
var fillPair = new FillPair (foregroundFill, backgroundFill);
var canvas = new LineCanvas { Fill = fillPair };
Assert.Equal (fillPair, canvas.Fill);
}
[Fact]
public void Fill_Property_Defaults_To_Null ()
{
var canvas = new LineCanvas ();
Assert.Null (canvas.Fill);
}
#endregion
[Theory]
// Horizontal lines with a vertical zero-length
[InlineData (
0,
0,
1,
Orientation.Horizontal,
LineStyle.Double,
0,
0,
0,
Orientation.Vertical,
LineStyle.Single,
"╞"
)]
[InlineData (
0,
0,
-1,
Orientation.Horizontal,
LineStyle.Double,
0,
0,
0,
Orientation.Vertical,
LineStyle.Single,
"╡"
)]
[InlineData (
0,
0,
1,
Orientation.Horizontal,
LineStyle.Single,
0,
0,
0,
Orientation.Vertical,
LineStyle.Double,
"╟"
)]
[InlineData (
0,
0,
-1,
Orientation.Horizontal,
LineStyle.Single,
0,
0,
0,
Orientation.Vertical,
LineStyle.Double,
"╢"
)]
[InlineData (
0,
0,
1,
Orientation.Horizontal,
LineStyle.Single,
0,
0,
0,
Orientation.Vertical,
LineStyle.Single,
"├"
)]
[InlineData (
0,
0,
-1,
Orientation.Horizontal,
LineStyle.Single,
0,
0,
0,
Orientation.Vertical,
LineStyle.Single,
"┤"
)]
[InlineData (
0,
0,
1,
Orientation.Horizontal,
LineStyle.Double,
0,
0,
0,
Orientation.Vertical,
LineStyle.Double,
"╠"
)]
[InlineData (
0,
0,
-1,
Orientation.Horizontal,
LineStyle.Double,
0,
0,
0,
Orientation.Vertical,
LineStyle.Double,
"╣"
)]
// Vertical lines with a horizontal zero-length
[InlineData (
0,
0,
1,
Orientation.Vertical,
LineStyle.Double,
0,
0,
0,
Orientation.Horizontal,
LineStyle.Single,
"╥"
)]
[InlineData (
0,
0,
-1,
Orientation.Vertical,
LineStyle.Double,
0,
0,
0,
Orientation.Horizontal,
LineStyle.Single,
"╨"
)]
[InlineData (
0,
0,
1,
Orientation.Vertical,
LineStyle.Single,
0,
0,
0,
Orientation.Horizontal,
LineStyle.Double,
"╤"
)]
[InlineData (
0,
0,
-1,
Orientation.Vertical,
LineStyle.Single,
0,
0,
0,
Orientation.Horizontal,
LineStyle.Double,
"╧"
)]
[InlineData (
0,
0,
1,
Orientation.Vertical,
LineStyle.Single,
0,
0,
0,
Orientation.Horizontal,
LineStyle.Single,
"┬"
)]
[InlineData (
0,
0,
-1,
Orientation.Vertical,
LineStyle.Single,
0,
0,
0,
Orientation.Horizontal,
LineStyle.Single,
"┴"
)]
[InlineData (
0,
0,
1,
Orientation.Vertical,
LineStyle.Double,
0,
0,
0,
Orientation.Horizontal,
LineStyle.Double,
"╦"
)]
[InlineData (
0,
0,
-1,
Orientation.Vertical,
LineStyle.Double,
0,
0,
0,
Orientation.Horizontal,
LineStyle.Double,
"╩"
)]
// Crosses (two zero-length)
[InlineData (
0,
0,
0,
Orientation.Vertical,
LineStyle.Double,
0,
0,
0,
Orientation.Horizontal,
LineStyle.Single,
"╫"
)]
[InlineData (
0,
0,
0,
Orientation.Vertical,
LineStyle.Single,
0,
0,
0,
Orientation.Horizontal,
LineStyle.Double,
"╪"
)]
[InlineData (
0,
0,
0,
Orientation.Vertical,
LineStyle.Single,
0,
0,
0,
Orientation.Horizontal,
LineStyle.Single,
"┼"
)]
[InlineData (
0,
0,
0,
Orientation.Vertical,
LineStyle.Double,
0,
0,
0,
Orientation.Horizontal,
LineStyle.Double,
"╬"
)]
public void Add_2_Lines (
int x1,
int y1,
int len1,
Orientation o1,
LineStyle s1,
int x2,
int y2,
int len2,
Orientation o2,
LineStyle s2,
string expected
)
{
IDriver driver = CreateFakeDriver ();
View v = GetCanvas (driver, out LineCanvas lc);
v.Width = 10;
v.Height = 10;
v.Viewport = new (0, 0, 10, 10);
lc.AddLine (new (x1, y1), len1, o1, s1);
lc.AddLine (new (x2, y2), len2, o2, s2);
OutputAssert.AssertEqual (output, expected, lc.ToString ());
v.Dispose ();
}
[Fact]
public void Viewport_Specific ()
{
// Draw at 1,1 within client area of View (i.e. leave a top and left margin of 1)
// This proves we aren't drawing excess above
var x = 1;
var y = 2;
var width = 3;
var height = 2;
var lc = new LineCanvas ();
// 01230
// ╔╡╞╗1
// ║ ║2
// Add a short horiz line for ╔╡
lc.AddLine (new (x, y), 2, Orientation.Horizontal, LineStyle.Double);
Assert.Equal (new (x, y, 2, 1), lc.Bounds);
//LHS line down
lc.AddLine (new (x, y), height, Orientation.Vertical, LineStyle.Double);
Assert.Equal (new (x, y, 2, 2), lc.Bounds);
//Vertical line before Title, results in a ╡
lc.AddLine (new (x + 1, y), 0, Orientation.Vertical, LineStyle.Single);
Assert.Equal (new (x, y, 2, 2), lc.Bounds);
//Vertical line after Title, results in a ╞
lc.AddLine (new (x + 2, y), 0, Orientation.Vertical, LineStyle.Single);
Assert.Equal (new (x, y, 3, 2), lc.Bounds);
// remainder of top line
lc.AddLine (new (x + 2, y), width - 1, Orientation.Horizontal, LineStyle.Double);
Assert.Equal (new (x, y, 4, 2), lc.Bounds);
//RHS line down
lc.AddLine (new (x + width, y), height, Orientation.Vertical, LineStyle.Double);
Assert.Equal (new (x, y, 4, 2), lc.Bounds);
OutputAssert.AssertEqual (
output,
@"
╔╡╞╗
║ ║",
$"{Environment.NewLine}{lc}"
);
}
[Fact]
public void Viewport_Specific_With_Ustring ()
{
// Draw at 1,1 within client area of View (i.e. leave a top and left margin of 1)
// This proves we aren't drawing excess above
var x = 1;
var y = 2;
var width = 3;
var height = 2;
var lc = new LineCanvas ();
// 01230
// ╔╡╞╗1
// ║ ║2
// Add a short horiz line for ╔╡
lc.AddLine (new (x, y), 2, Orientation.Horizontal, LineStyle.Double);
Assert.Equal (new (x, y, 2, 1), lc.Bounds);
//LHS line down
lc.AddLine (new (x, y), height, Orientation.Vertical, LineStyle.Double);
Assert.Equal (new (x, y, 2, 2), lc.Bounds);
//Vertical line before Title, results in a ╡
lc.AddLine (new (x + 1, y), 0, Orientation.Vertical, LineStyle.Single);
Assert.Equal (new (x, y, 2, 2), lc.Bounds);
//Vertical line after Title, results in a ╞
lc.AddLine (new (x + 2, y), 0, Orientation.Vertical, LineStyle.Single);
Assert.Equal (new (x, y, 3, 2), lc.Bounds);
// remainder of top line
lc.AddLine (new (x + 2, y), width - 1, Orientation.Horizontal, LineStyle.Double);
Assert.Equal (new (x, y, 4, 2), lc.Bounds);
//RHS line down
lc.AddLine (new (x + width, y), height, Orientation.Vertical, LineStyle.Double);
Assert.Equal (new (x, y, 4, 2), lc.Bounds);
OutputAssert.AssertEqual (
output,
@"
╔╡╞╗
║ ║",
$"{Environment.NewLine}{lc}"
);
}
[Fact]
public void Canvas_Updates_On_Changes ()
{
var lc = new LineCanvas ();
Assert.Equal (Rectangle.Empty, lc.Bounds);
lc.AddLine (Point.Empty, 2, Orientation.Horizontal, LineStyle.Double);
Assert.NotEqual (Rectangle.Empty, lc.Bounds);
lc.Clear ();
Assert.Equal (Rectangle.Empty, lc.Bounds);
}
[InlineData (0, 0, Orientation.Horizontal, "─")]
[InlineData (1, 0, Orientation.Horizontal, "─")]
[InlineData (0, 1, Orientation.Horizontal, "─")]
[InlineData (-1, 0, Orientation.Horizontal, "─")]
[InlineData (0, -1, Orientation.Horizontal, "─")]
[InlineData (-1, -1, Orientation.Horizontal, "─")]
[InlineData (0, 0, Orientation.Vertical, "│")]
[InlineData (1, 0, Orientation.Vertical, "│")]
[InlineData (0, 1, Orientation.Vertical, "│")]
[InlineData (0, -1, Orientation.Vertical, "│")]
[InlineData (-1, 0, Orientation.Vertical, "│")]
[InlineData (-1, -1, Orientation.Vertical, "│")]
[Theory]
public void Length_0_Is_1_Long (int x, int y, Orientation orientation, string expected)
{
var canvas = new LineCanvas ();
// Add a line at 5, 5 that's has length of 1
canvas.AddLine (new (x, y), 1, orientation, LineStyle.Single);
OutputAssert.AssertEqual (output, $"{expected}", $"{canvas}");
}
// X is offset by 2
[InlineData (0, 0, 1, Orientation.Horizontal, "─")]
[InlineData (1, 0, 1, Orientation.Horizontal, "─")]
[InlineData (0, 1, 1, Orientation.Horizontal, "─")]
[InlineData (0, 0, 1, Orientation.Vertical, "│")]
[InlineData (1, 0, 1, Orientation.Vertical, "│")]
[InlineData (0, 1, 1, Orientation.Vertical, "│")]
[InlineData (-1, 0, 1, Orientation.Horizontal, "─")]
[InlineData (0, -1, 1, Orientation.Horizontal, "─")]
[InlineData (-1, 0, 1, Orientation.Vertical, "│")]
[InlineData (0, -1, 1, Orientation.Vertical, "│")]
[InlineData (0, 0, -1, Orientation.Horizontal, "─")]
[InlineData (1, 0, -1, Orientation.Horizontal, "─")]
[InlineData (0, 1, -1, Orientation.Horizontal, "─")]
[InlineData (0, 0, -1, Orientation.Vertical, "│")]
[InlineData (1, 0, -1, Orientation.Vertical, "│")]
[InlineData (0, 1, -1, Orientation.Vertical, "│")]
[InlineData (-1, 0, -1, Orientation.Horizontal, "─")]
[InlineData (0, -1, -1, Orientation.Horizontal, "─")]
[InlineData (-1, 0, -1, Orientation.Vertical, "│")]
[InlineData (0, -1, -1, Orientation.Vertical, "│")]
[InlineData (0, 0, 2, Orientation.Horizontal, "──")]
[InlineData (1, 0, 2, Orientation.Horizontal, "──")]
[InlineData (0, 1, 2, Orientation.Horizontal, "──")]
[InlineData (1, 1, 2, Orientation.Horizontal, "──")]
[InlineData (0, 0, 2, Orientation.Vertical, "│\r\n│")]
[InlineData (1, 0, 2, Orientation.Vertical, "│\r\n│")]
[InlineData (0, 1, 2, Orientation.Vertical, "│\r\n│")]
[InlineData (1, 1, 2, Orientation.Vertical, "│\r\n│")]
[InlineData (-1, 0, 2, Orientation.Horizontal, "──")]
[InlineData (0, -1, 2, Orientation.Horizontal, "──")]
[InlineData (-1, 0, 2, Orientation.Vertical, "│\r\n│")]
[InlineData (0, -1, 2, Orientation.Vertical, "│\r\n│")]
[InlineData (-1, -1, 2, Orientation.Vertical, "│\r\n│")]
[InlineData (0, 0, -2, Orientation.Horizontal, "──")]
[InlineData (1, 0, -2, Orientation.Horizontal, "──")]
[InlineData (0, 1, -2, Orientation.Horizontal, "──")]
[InlineData (0, 0, -2, Orientation.Vertical, "│\r\n│")]
[InlineData (1, 0, -2, Orientation.Vertical, "│\r\n│")]
[InlineData (0, 1, -2, Orientation.Vertical, "│\r\n│")]
[InlineData (1, 1, -2, Orientation.Vertical, "│\r\n│")]
[InlineData (-1, 0, -2, Orientation.Horizontal, "──")]
[InlineData (0, -1, -2, Orientation.Horizontal, "──")]
[InlineData (-1, 0, -2, Orientation.Vertical, "│\r\n│")]
[InlineData (0, -1, -2, Orientation.Vertical, "│\r\n│")]
[InlineData (-1, -1, -2, Orientation.Vertical, "│\r\n│")]
[Theory] public void Length_n_Is_n_Long (int x, int y, int length, Orientation orientation, string expected)
{
var canvas = new LineCanvas ();
canvas.AddLine (new (x, y), length, orientation, LineStyle.Single);
var result = canvas.ToString ();
OutputAssert.AssertEqual (output, expected, result);
}
[Fact]
public void Length_Negative ()
{
var offset = new Point (5, 5);
var canvas = new LineCanvas ();
canvas.AddLine (offset, -3, Orientation.Horizontal, LineStyle.Single);
var looksLike = "───";
Assert.Equal (looksLike, $"{canvas}");
}
[InlineData (Orientation.Horizontal, "─")]
[InlineData (Orientation.Vertical, "│")]
[Theory]
public void Length_Zero_Alone_Is_Line (Orientation orientation, string expected)
{
var lc = new LineCanvas ();
// Add a line at 0, 0 that's has length of 0
lc.AddLine (Point.Empty, 0, orientation, LineStyle.Single);
OutputAssert.AssertEqual (output, expected, $"{lc}");
}
[InlineData (Orientation.Horizontal, "┼")]
[InlineData (Orientation.Vertical, "┼")]
[Theory]
public void Length_Zero_Cross_Is_Cross (Orientation orientation, string expected)
{
var lc = new LineCanvas ();
// Add point at opposite orientation
lc.AddLine (
Point.Empty,
0,
orientation == Orientation.Horizontal ? Orientation.Vertical : Orientation.Horizontal,
LineStyle.Single
);
// Add a line at 0, 0 that's has length of 0
lc.AddLine (Point.Empty, 0, orientation, LineStyle.Single);
OutputAssert.AssertEqual (output, expected, $"{lc}");
}
[InlineData (Orientation.Horizontal, "╥")]
[InlineData (Orientation.Vertical, "╞")]
[Theory]
public void Length_Zero_NextTo_Opposite_Is_T (Orientation orientation, string expected)
{
var lc = new LineCanvas ();
// Add line with length of 1 in opposite orientation starting at same location
if (orientation == Orientation.Horizontal)
{
lc.AddLine (Point.Empty, 1, Orientation.Vertical, LineStyle.Double);
}
else
{
lc.AddLine (Point.Empty, 1, Orientation.Horizontal, LineStyle.Double);
}
// Add a line at 0, 0 that's has length of 0
lc.AddLine (Point.Empty, 0, orientation, LineStyle.Single);
OutputAssert.AssertEqual (output, expected, $"{lc}");
}
[Fact]
public void TestLineCanvas_LeaveMargin_Top1_Left1 ()
{
var canvas = new LineCanvas ();
// Upper box
canvas.AddLine (Point.Empty, 2, Orientation.Horizontal, LineStyle.Single);
canvas.AddLine (Point.Empty, 2, Orientation.Vertical, LineStyle.Single);
var looksLike =
@"
┌─
│ ";
OutputAssert.AssertEqual (output, looksLike, $"{Environment.NewLine}{canvas}");
}
[Fact]
public void TestLineCanvas_Window_Heavy ()
{
var driver = CreateFakeDriver ();
View v = GetCanvas (driver, out LineCanvas canvas);
// outer box
canvas.AddLine (Point.Empty, 10, Orientation.Horizontal, LineStyle.Heavy);
canvas.AddLine (new (9, 0), 5, Orientation.Vertical, LineStyle.Heavy);
canvas.AddLine (new (9, 4), -10, Orientation.Horizontal, LineStyle.Heavy);
canvas.AddLine (new (0, 4), -5, Orientation.Vertical, LineStyle.Heavy);
canvas.AddLine (new (5, 0), 5, Orientation.Vertical, LineStyle.Heavy);
canvas.AddLine (new (0, 2), 10, Orientation.Horizontal, LineStyle.Heavy);
v.Draw ();
var looksLike =
@"
┏━━━━┳━━━┓
┃ ┃ ┃
┣━━━━╋━━━┫
┃ ┃ ┃
┗━━━━┻━━━┛";
DriverAssert.AssertDriverContentsAre (looksLike, output, driver);
v.Dispose ();
}
[Theory]
[InlineData (LineStyle.Single)]
[InlineData (LineStyle.Rounded)]
public void TestLineCanvas_Window_HeavyTop_ThinSides (LineStyle thinStyle)
{
var driver = CreateFakeDriver ();
View v = GetCanvas (driver, out LineCanvas canvas);
// outer box
canvas.AddLine (Point.Empty, 10, Orientation.Horizontal, LineStyle.Heavy);
canvas.AddLine (new (9, 0), 5, Orientation.Vertical, thinStyle);
canvas.AddLine (new (9, 4), -10, Orientation.Horizontal, LineStyle.Heavy);
canvas.AddLine (new (0, 4), -5, Orientation.Vertical, thinStyle);
canvas.AddLine (new (5, 0), 5, Orientation.Vertical, thinStyle);
canvas.AddLine (new (0, 2), 10, Orientation.Horizontal, LineStyle.Heavy);
v.Draw ();
var looksLike =
@"
┍━━━━┯━━━┑
│ │ │
┝━━━━┿━━━┥
│ │ │
┕━━━━┷━━━┙
";
DriverAssert.AssertDriverContentsAre (looksLike, output, driver);
v.Dispose ();
}
[Theory]
[InlineData (LineStyle.Single)]
[InlineData (LineStyle.Rounded)]
public void TestLineCanvas_Window_ThinTop_HeavySides (LineStyle thinStyle)
{
var driver = CreateFakeDriver ();
View v = GetCanvas (driver, out LineCanvas canvas);
// outer box
canvas.AddLine (Point.Empty, 10, Orientation.Horizontal, thinStyle);
canvas.AddLine (new (9, 0), 5, Orientation.Vertical, LineStyle.Heavy);
canvas.AddLine (new (9, 4), -10, Orientation.Horizontal, thinStyle);
canvas.AddLine (new (0, 4), -5, Orientation.Vertical, LineStyle.Heavy);
canvas.AddLine (new (5, 0), 5, Orientation.Vertical, LineStyle.Heavy);
canvas.AddLine (new (0, 2), 10, Orientation.Horizontal, thinStyle);
v.Draw ();
var looksLike =
@"
┎────┰───┒
┃ ┃ ┃
┠────╂───┨
┃ ┃ ┃
┖────┸───┚
";
DriverAssert.AssertDriverContentsAre (looksLike, output, driver);
v.Dispose ();
}
[Fact]
public void Top_Left_From_TopRight_LeftUp ()
{
var canvas = new LineCanvas ();
// Upper box
canvas.AddLine (Point.Empty, 2, Orientation.Horizontal, LineStyle.Single);
canvas.AddLine (new (0, 1), -2, Orientation.Vertical, LineStyle.Single);
var looksLike =
@"
┌─
│ ";
OutputAssert.AssertEqual (output, looksLike, $"{Environment.NewLine}{canvas}");
}
[Fact]
public void Top_With_1Down ()
{
var canvas = new LineCanvas ();
// Top ─
canvas.AddLine (Point.Empty, 1, Orientation.Horizontal, LineStyle.Single);
// Bottom ─
canvas.AddLine (new (1, 1), -1, Orientation.Horizontal, LineStyle.Single);
//// Right down
//canvas.AddLine (new Point (9, 0), 3, Orientation.Vertical, LineStyle.Single);
//// Bottom
//canvas.AddLine (new Point (9, 3), -10, Orientation.Horizontal, LineStyle.Single);
//// Left Up
//canvas.AddLine (new Point (0, 3), -3, Orientation.Vertical, LineStyle.Single);
Assert.Equal (new (0, 0, 2, 2), canvas.Bounds);
Dictionary<Point, Rune> map = canvas.GetMap ();
Assert.Equal (2, map.Count);
OutputAssert.AssertEqual (
output,
@"
─",
$"{Environment.NewLine}{canvas}"
);
}
[Fact]
public void ToString_Empty ()
{
var lc = new LineCanvas ();
OutputAssert.AssertEqual (output, string.Empty, lc.ToString ());
}
// 012
[InlineData (0, 0, "═══")]
[InlineData (1, 0, "═══")]
[InlineData (0, 1, "═══")]
[InlineData (1, 1, "═══")]
[InlineData (2, 2, "═══")]
[InlineData (-1, 0, "═══")]
[InlineData (0, -1, "═══")]
[InlineData (-1, -1, "═══")]
[InlineData (-2, -2, "═══")]
[Theory]
public void ToString_Positive_Horizontal_1Line_Offset (int x, int y, string expected)
{
var lc = new LineCanvas ();
lc.AddLine (new (x, y), 3, Orientation.Horizontal, LineStyle.Double);
OutputAssert.AssertEqual (output, expected, $"{lc}");
}
[InlineData (0, 0, 0, 0, "═══")]
[InlineData (1, 0, 1, 0, "═══")]
[InlineData (-1, 0, -1, 0, "═══")]
[InlineData (0, 0, 1, 0, "════")]
[InlineData (1, 0, 3, 0, "═════")]
[InlineData (1, 0, 4, 0, "══════")]
[InlineData (1, 0, 5, 0, "═══ ═══")]
[InlineData (0, 0, 0, 1, "\u2550\u2550\u2550\r\n\u2550\u2550\u2550")]
[InlineData (0, 0, 1, 1, "═══ \r\n ═══")]
[InlineData (0, 0, 2, 1, "═══ \r\n ═══")]
[InlineData (1, 0, 0, 1, " ═══\r\n═══ ")]
[InlineData (0, 1, 0, 1, "═══")]
[InlineData (1, 1, 0, 1, "════")]
[InlineData (2, 2, 0, 1, "═══ \r\n ═══")]
[Theory]
public void ToString_Positive_Horizontal_2Line_Offset (int x1, int y1, int x2, int y2, string expected)
{
var lc = new LineCanvas ();
lc.AddLine (new (x1, y1), 3, Orientation.Horizontal, LineStyle.Double);
lc.AddLine (new (x2, y2), 3, Orientation.Horizontal, LineStyle.Double);
OutputAssert.AssertEqual (output, expected, $"{lc}");
}
// [Fact, SetupFakeDriver]
// public void LeaveMargin_Top1_Left1 ()
// {
// var canvas = new LineCanvas ();
// // Upper box
// canvas.AddLine (Point.Empty, 9, Orientation.Horizontal, LineStyle.Single);
// canvas.AddLine (new Point (8, 0), 3, Orientation.Vertical, LineStyle.Single);
// canvas.AddLine (new Point (8, 3), -9, Orientation.Horizontal, LineStyle.Single);
// canvas.AddLine (new Point (0, 2), -3, Orientation.Vertical, LineStyle.Single);
// // Lower Box
// canvas.AddLine (new Point (5, 0), 2, Orientation.Vertical, LineStyle.Single);
// canvas.AddLine (new Point (0, 2), 9, Orientation.Horizontal, LineStyle.Single);
// string looksLike =
//@"
//┌────┬──┐
//│ │ │
//├────┼──┤
//└────┴──┘
//";
// Assert.Equal (looksLike, $"{Environment.NewLine}{canvas}");
// }
[InlineData (0, 0, 0, Orientation.Horizontal, LineStyle.Double, "═")]
[InlineData (0, 0, 0, Orientation.Vertical, LineStyle.Double, "║")]
[InlineData (0, 0, 0, Orientation.Horizontal, LineStyle.Single, "─")]
[InlineData (0, 0, 0, Orientation.Vertical, LineStyle.Single, "│")]
[InlineData (0, 0, 1, Orientation.Horizontal, LineStyle.Double, "═")]
[InlineData (0, 0, 1, Orientation.Vertical, LineStyle.Double, "║")]
[InlineData (0, 0, 1, Orientation.Horizontal, LineStyle.Single, "─")]
[InlineData (0, 0, 1, Orientation.Vertical, LineStyle.Single, "│")]
[InlineData (0, 0, 2, Orientation.Horizontal, LineStyle.Double, "══")]
[InlineData (0, 0, 2, Orientation.Vertical, LineStyle.Double, "║\n║")]
[InlineData (0, 0, 2, Orientation.Horizontal, LineStyle.Single, "──")]
[InlineData (0, 0, 2, Orientation.Vertical, LineStyle.Single, "│\n│")]
[Theory]
public void View_Draws_1LineTests (
int x1,
int y1,
int length,
Orientation o1,
LineStyle s1,
string expected
)
{
var driver = CreateFakeDriver ();
View v = GetCanvas (driver, out LineCanvas lc);
v.Width = 10;
v.Height = 10;
v.Viewport = new (0, 0, 10, 10);
lc.AddLine (new (x1, y1), length, o1, s1);
v.Draw ();
DriverAssert.AssertDriverContentsAre (expected, output, driver);
v.Dispose ();
}
/// <summary>This test demonstrates how to correctly trigger a corner. By overlapping the lines in the same cell</summary>
[Fact]
public void View_Draws_Corner_Correct ()
{
var driver = CreateFakeDriver ();
View v = GetCanvas (driver, out LineCanvas canvas);
canvas.AddLine (Point.Empty, 2, Orientation.Horizontal, LineStyle.Single);
canvas.AddLine (Point.Empty, 2, Orientation.Vertical, LineStyle.Single);
v.Draw ();
var looksLike =
@"
┌─
│";
DriverAssert.AssertDriverContentsAre (looksLike, output, driver);
v.Dispose ();
}
/// <summary>
/// This test demonstrates that corners are only drawn when lines overlap. Not when they terminate adjacent to one
/// another.
/// </summary>
[Fact]
public void View_Draws_Corner_NoOverlap ()
{
var driver = CreateFakeDriver ();
View v = GetCanvas (driver, out LineCanvas canvas);
canvas.AddLine (Point.Empty, 2, Orientation.Horizontal, LineStyle.Single);
canvas.AddLine (new (0, 1), 2, Orientation.Vertical, LineStyle.Single);
v.Draw ();
var looksLike =
@"
──
│";
DriverAssert.AssertDriverContentsAre (looksLike, output, driver);
v.Dispose ();
}
[InlineData (LineStyle.Single)]
[InlineData (LineStyle.Rounded)]
[Theory]
public void View_Draws_Horizontal (LineStyle style)
{
var driver = CreateFakeDriver ();
View v = GetCanvas (driver, out LineCanvas canvas);
canvas.AddLine (Point.Empty, 2, Orientation.Horizontal, style);
v.Draw ();
var looksLike =
@"
──";
DriverAssert.AssertDriverContentsAre (looksLike, output, driver);
v.Dispose ();
}
[Fact]
public void View_Draws_Horizontal_Double ()
{
var driver = CreateFakeDriver ();
View v = GetCanvas (driver, out LineCanvas canvas);
canvas.AddLine (Point.Empty, 2, Orientation.Horizontal, LineStyle.Double);
v.Draw ();
var looksLike =
@"
══";
DriverAssert.AssertDriverContentsAre (looksLike, output, driver);
v.Dispose ();
}
[InlineData (LineStyle.Single)]
[InlineData (LineStyle.Rounded)]
[Theory]
public void View_Draws_Vertical (LineStyle style)
{
var driver = CreateFakeDriver ();
View v = GetCanvas (driver, out LineCanvas canvas);
canvas.AddLine (Point.Empty, 2, Orientation.Vertical, style);
v.Draw ();
var looksLike =
@"
│";
DriverAssert.AssertDriverContentsAre (looksLike, output, driver);
v.Dispose ();
}
[Fact]
public void View_Draws_Vertical_Double ()
{
var driver = CreateFakeDriver ();
View v = GetCanvas (driver, out LineCanvas canvas);
canvas.AddLine (Point.Empty, 2, Orientation.Vertical, LineStyle.Double);
v.Draw ();
var looksLike =
@"
║";
DriverAssert.AssertDriverContentsAre (looksLike, output, driver);
v.Dispose ();
}
[Fact]
public void View_Draws_Window_Double ()
{
var driver = CreateFakeDriver ();
View v = GetCanvas (driver, out LineCanvas canvas);
// outer box
canvas.AddLine (Point.Empty, 10, Orientation.Horizontal, LineStyle.Double);
canvas.AddLine (new (9, 0), 5, Orientation.Vertical, LineStyle.Double);
canvas.AddLine (new (9, 4), -10, Orientation.Horizontal, LineStyle.Double);
canvas.AddLine (new (0, 4), -5, Orientation.Vertical, LineStyle.Double);
canvas.AddLine (new (5, 0), 5, Orientation.Vertical, LineStyle.Double);
canvas.AddLine (new (0, 2), 10, Orientation.Horizontal, LineStyle.Double);
v.Draw ();
var looksLike =
@"
╔════╦═══╗
║ ║ ║
╠════╬═══╣
║ ║ ║
╚════╩═══╝";
DriverAssert.AssertDriverContentsAre (looksLike, output, driver);
v.Dispose ();
}
[Theory]
[InlineData (LineStyle.Single)]
[InlineData (LineStyle.Rounded)]
public void View_Draws_Window_DoubleTop_SingleSides (LineStyle thinStyle)
{
var driver = CreateFakeDriver ();
View v = GetCanvas (driver, out LineCanvas canvas);
// outer box
canvas.AddLine (Point.Empty, 10, Orientation.Horizontal, LineStyle.Double);
canvas.AddLine (new (9, 0), 5, Orientation.Vertical, thinStyle);
canvas.AddLine (new (9, 4), -10, Orientation.Horizontal, LineStyle.Double);
canvas.AddLine (new (0, 4), -5, Orientation.Vertical, thinStyle);
canvas.AddLine (new (5, 0), 5, Orientation.Vertical, thinStyle);
canvas.AddLine (new (0, 2), 10, Orientation.Horizontal, LineStyle.Double);
v.Draw ();
var looksLike =
@"
╒════╤═══╕
│ │ │
╞════╪═══╡
│ │ │
╘════╧═══╛
";
DriverAssert.AssertDriverContentsAre (looksLike, output, driver);
v.Dispose ();
}
/// <summary>
/// Demonstrates when <see cref="LineStyle.Rounded"/> corners are used. Notice how not all lines declare rounded.
/// If there are 1+ lines intersecting and a corner is to be used then if any of them are rounded a rounded corner is
/// used.
/// </summary>
[Fact]
public void View_Draws_Window_Rounded ()
{
var driver = CreateFakeDriver ();
View v = GetCanvas (driver, out LineCanvas canvas);
// outer box
canvas.AddLine (Point.Empty, 10, Orientation.Horizontal, LineStyle.Rounded);
// LineStyle.Single is ignored because corner overlaps with the above line which is Rounded
// this results in a rounded corner being used.
canvas.AddLine (new (9, 0), 5, Orientation.Vertical, LineStyle.Single);
canvas.AddLine (new (9, 4), -10, Orientation.Horizontal, LineStyle.Rounded);
canvas.AddLine (new (0, 4), -5, Orientation.Vertical, LineStyle.Single);
// These lines say rounded but they will result in the T sections which are never rounded.
canvas.AddLine (new (5, 0), 5, Orientation.Vertical, LineStyle.Rounded);
canvas.AddLine (new (0, 2), 10, Orientation.Horizontal, LineStyle.Rounded);
v.Draw ();
var looksLike =
@"
╭────┬───╮
│ │ │
├────┼───┤
│ │ │
╰────┴───╯";
DriverAssert.AssertDriverContentsAre (looksLike, output, driver);
v.Dispose ();
}
[Theory]
[InlineData (LineStyle.Single)]
[InlineData (LineStyle.Rounded)]
public void View_Draws_Window_SingleTop_DoubleSides (LineStyle thinStyle)
{
var driver = CreateFakeDriver ();
View v = GetCanvas (driver, out LineCanvas canvas);
// outer box
canvas.AddLine (Point.Empty, 10, Orientation.Horizontal, thinStyle);
canvas.AddLine (new (9, 0), 5, Orientation.Vertical, LineStyle.Double);
canvas.AddLine (new (9, 4), -10, Orientation.Horizontal, thinStyle);
canvas.AddLine (new (0, 4), -5, Orientation.Vertical, LineStyle.Double);
canvas.AddLine (new (5, 0), 5, Orientation.Vertical, LineStyle.Double);
canvas.AddLine (new (0, 2), 10, Orientation.Horizontal, thinStyle);
v.Draw ();
var looksLike =
@"
╓────╥───╖
║ ║ ║
╟────╫───╢
║ ║ ║
╙────╨───╜
";
DriverAssert.AssertDriverContentsAre (looksLike, output, driver);
v.Dispose ();
}
[Fact]
public void Window ()
{
var canvas = new LineCanvas ();
// Frame
canvas.AddLine (Point.Empty, 10, Orientation.Horizontal, LineStyle.Single);
canvas.AddLine (new (9, 0), 5, Orientation.Vertical, LineStyle.Single);
canvas.AddLine (new (9, 4), -10, Orientation.Horizontal, LineStyle.Single);
canvas.AddLine (new (0, 4), -5, Orientation.Vertical, LineStyle.Single);
// Cross
canvas.AddLine (new (5, 0), 5, Orientation.Vertical, LineStyle.Single);
canvas.AddLine (new (0, 2), 10, Orientation.Horizontal, LineStyle.Single);
var looksLike =
@"
┌────┬───┐
│ │ │
├────┼───┤
│ │ │
└────┴───┘";
OutputAssert.AssertEqual (output, looksLike, $"{Environment.NewLine}{canvas}");
}
[Fact]
public void Zero_Length_Intersections ()
{
// Draw at 1,2 within client area of View (i.e. leave a top and left margin of 1)
// This proves we aren't drawing excess above
var x = 1;
var y = 2;
var width = 5;
var height = 2;
var lc = new LineCanvas ();
// ╔╡╞═════╗
// Add a short horiz line for ╔╡
lc.AddLine (new (x, y), 2, Orientation.Horizontal, LineStyle.Double);
//LHS line down
lc.AddLine (new (x, y), height, Orientation.Vertical, LineStyle.Double);
//Vertical line before Title, results in a ╡
lc.AddLine (new (x + 1, y), 0, Orientation.Vertical, LineStyle.Single);
//Vertical line after Title, results in a ╞
lc.AddLine (new (x + 2, y), 0, Orientation.Vertical, LineStyle.Single);
// remainder of top line
lc.AddLine (new (x + 2, y), width - 1, Orientation.Horizontal, LineStyle.Double);
//RHS line down
lc.AddLine (new (x + width, y), height, Orientation.Vertical, LineStyle.Double);
var looksLike = @"
╔╡╞══╗
║ ║";
OutputAssert.AssertEqual (output, looksLike, $"{Environment.NewLine}{lc}");
}
[Fact]
public void LineCanvas_UsesFillCorrectly ()
{
// Arrange
var foregroundColor = new Color (255, 0); // Red
var backgroundColor = new Color (0, 0); // Black
var foregroundFill = new SolidFill (foregroundColor);
var backgroundFill = new SolidFill (backgroundColor);
var fillPair = new FillPair (foregroundFill, backgroundFill);
var lineCanvas = new LineCanvas
{
Fill = fillPair
};
// Act
lineCanvas.AddLine (new (0, 0), 5, Orientation.Horizontal, LineStyle.Single);
Dictionary<Point, Cell?> cellMap = lineCanvas.GetCellMap ();
// Assert
foreach (Cell? cell in cellMap.Values)
{
Assert.NotNull (cell);
Assert.Equal (foregroundColor, cell.Value.Attribute!.Value.Foreground);
Assert.Equal (backgroundColor, cell.Value.Attribute.Value.Background);
}
}
[Fact]
public void LineCanvas_LineColorIgnoredBecauseOfFill ()
{
// Arrange
var foregroundColor = new Color (255, 0); // Red
var backgroundColor = new Color (0, 0); // Black
var lineColor = new Attribute (new Color (0, 255), new Color (255, 255, 255)); // Green on White
var foregroundFill = new SolidFill (foregroundColor);
var backgroundFill = new SolidFill (backgroundColor);
var fillPair = new FillPair (foregroundFill, backgroundFill);
var lineCanvas = new LineCanvas
{
Fill = fillPair
};
// Act
lineCanvas.AddLine (new (0, 0), 5, Orientation.Horizontal, LineStyle.Single, lineColor);
Dictionary<Point, Cell?> cellMap = lineCanvas.GetCellMap ();
// Assert
foreach (Cell? cell in cellMap.Values)
{
Assert.NotNull (cell);
Assert.Equal (foregroundColor, cell.Value.Attribute!.Value.Foreground);
Assert.Equal (backgroundColor, cell.Value.Attribute.Value.Background);
}
}
[Fact]
public void LineCanvas_IntersectingLinesUseFillCorrectly ()
{
// Arrange
var foregroundColor = new Color (255, 0); // Red
var backgroundColor = new Color (0, 0); // Black
var foregroundFill = new SolidFill (foregroundColor);
var backgroundFill = new SolidFill (backgroundColor);
var fillPair = new FillPair (foregroundFill, backgroundFill);
var lineCanvas = new LineCanvas
{
Fill = fillPair
};
// Act
lineCanvas.AddLine (new (0, 0), 5, Orientation.Horizontal, LineStyle.Single);
lineCanvas.AddLine (new (2, -2), 5, Orientation.Vertical, LineStyle.Single);
Dictionary<Point, Cell?> cellMap = lineCanvas.GetCellMap ();
// Assert
foreach (Cell? cell in cellMap.Values)
{
Assert.NotNull (cell);
Assert.Equal (foregroundColor, cell.Value.Attribute!.Value.Foreground);
Assert.Equal (backgroundColor, cell.Value.Attribute.Value.Background);
}
}
// TODO: Remove this and make all LineCanvas tests independent of View
/// <summary>
/// Creates a new <see cref="View"/> into which a <see cref="LineCanvas"/> is rendered at
/// <see cref="View.DrawComplete"/> time.
/// </summary>
/// <param name="canvas">The <see cref="LineCanvas"/> you can draw into.</param>
/// <param name="offsetX">How far to offset drawing in X</param>
/// <param name="offsetY">How far to offset drawing in Y</param>
/// <returns></returns>
private View GetCanvas (IDriver driver, out LineCanvas canvas, int offsetX = 0, int offsetY = 0)
{
var v = new View { Width = 10, Height = 5, Viewport = new (0, 0, 10, 5) };
v.Driver = driver;
LineCanvas canvasCopy = canvas = new ();
v.DrawComplete += (s, e) =>
{
v.FillRect (v.Viewport);
foreach (KeyValuePair<Point, Rune> p in canvasCopy.GetMap ())
{
v.AddRune (
offsetX + p.Key.X,
offsetY + p.Key.Y,
p.Value
);
}
canvasCopy.Clear ();
};
return v;
}
}