ApplicationTests.cs 37 KB

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071727374757677787980818283848586878889909192939495969798991001011021031041051061071081091101111121131141151161171181191201211221231241251261271281291301311321331341351361371381391401411421431441451461471481491501511521531541551561571581591601611621631641651661671681691701711721731741751761771781791801811821831841851861871881891901911921931941951961971981992002012022032042052062072082092102112122132142152162172182192202212222232242252262272282292302312322332342352362372382392402412422432442452462472482492502512522532542552562572582592602612622632642652662672682692702712722732742752762772782792802812822832842852862872882892902912922932942952962972982993003013023033043053063073083093103113123133143153163173183193203213223233243253263273283293303313323333343353363373383393403413423433443453463473483493503513523533543553563573583593603613623633643653663673683693703713723733743753763773783793803813823833843853863873883893903913923933943953963973983994004014024034044054064074084094104114124134144154164174184194204214224234244254264274284294304314324334344354364374384394404414424434444454464474484494504514524534544554564574584594604614624634644654664674684694704714724734744754764774784794804814824834844854864874884894904914924934944954964974984995005015025035045055065075085095105115125135145155165175185195205215225235245255265275285295305315325335345355365375385395405415425435445455465475485495505515525535545555565575585595605615625635645655665675685695705715725735745755765775785795805815825835845855865875885895905915925935945955965975985996006016026036046056066076086096106116126136146156166176186196206216226236246256266276286296306316326336346356366376386396406416426436446456466476486496506516526536546556566576586596606616626636646656666676686696706716726736746756766776786796806816826836846856866876886896906916926936946956966976986997007017027037047057067077087097107117127137147157167177187197207217227237247257267277287297307317327337347357367377387397407417427437447457467477487497507517527537547557567577587597607617627637647657667677687697707717727737747757767777787797807817827837847857867877887897907917927937947957967977987998008018028038048058068078088098108118128138148158168178188198208218228238248258268278288298308318328338348358368378388398408418428438448458468478488498508518528538548558568578588598608618628638648658668678688698708718728738748758768778788798808818828838848858868878888898908918928938948958968978988999009019029039049059069079089099109119129139149159169179189199209219229239249259269279289299309319329339349359369379389399409419429439449459469479489499509519529539549559569579589599609619629639649659669679689699709719729739749759769779789799809819829839849859869879889899909919929939949959969979989991000100110021003100410051006100710081009101010111012101310141015101610171018101910201021102210231024102510261027102810291030103110321033103410351036103710381039104010411042104310441045104610471048104910501051105210531054105510561057105810591060106110621063106410651066106710681069107010711072107310741075107610771078107910801081108210831084108510861087108810891090109110921093109410951096109710981099110011011102110311041105110611071108110911101111111211131114111511161117111811191120112111221123112411251126112711281129113011311132113311341135113611371138113911401141114211431144114511461147114811491150115111521153115411551156115711581159116011611162116311641165116611671168116911701171117211731174117511761177117811791180118111821183118411851186118711881189119011911192119311941195119611971198119912001201
  1. using System.Diagnostics;
  2. using Xunit.Abstractions;
  3. using static Terminal.Gui.Configuration.ConfigurationManager;
  4. // Alias Console to MockConsole so we don't accidentally use Console
  5. namespace UnitTests.ApplicationTests;
  6. public class ApplicationTests
  7. {
  8. public ApplicationTests (ITestOutputHelper output)
  9. {
  10. _output = output;
  11. ConsoleDriver.RunningUnitTests = true;
  12. #if DEBUG_IDISPOSABLE
  13. View.EnableDebugIDisposableAsserts = true;
  14. View.Instances.Clear ();
  15. RunState.Instances.Clear ();
  16. #endif
  17. }
  18. private readonly ITestOutputHelper _output;
  19. private object _timeoutLock;
  20. [Fact]
  21. public void AddTimeout_Fires ()
  22. {
  23. Assert.Null (_timeoutLock);
  24. _timeoutLock = new ();
  25. uint timeoutTime = 250;
  26. var initialized = false;
  27. var iteration = 0;
  28. var shutdown = false;
  29. object timeout = null;
  30. var timeoutCount = 0;
  31. Application.InitializedChanged += OnApplicationOnInitializedChanged;
  32. var a = new AutoInitShutdownAttribute ();
  33. a.Before (null);
  34. Assert.True (initialized);
  35. Assert.False (shutdown);
  36. _output.WriteLine ("Application.Run<Toplevel> ().Dispose ()..");
  37. Application.Run<Toplevel> ().Dispose ();
  38. _output.WriteLine ("Back from Application.Run<Toplevel> ().Dispose ()");
  39. Assert.True (initialized);
  40. Assert.False (shutdown);
  41. Assert.Equal (1, timeoutCount);
  42. Application.Shutdown ();
  43. Application.InitializedChanged -= OnApplicationOnInitializedChanged;
  44. lock (_timeoutLock)
  45. {
  46. if (timeout is { })
  47. {
  48. Application.RemoveTimeout (timeout);
  49. timeout = null;
  50. }
  51. }
  52. Assert.True (initialized);
  53. Assert.True (shutdown);
  54. #if DEBUG_IDISPOSABLE
  55. Assert.Empty (View.Instances);
  56. #endif
  57. lock (_timeoutLock)
  58. {
  59. _timeoutLock = null;
  60. }
  61. a.After (null);
  62. return;
  63. void OnApplicationOnInitializedChanged (object s, EventArgs<bool> a)
  64. {
  65. if (a.Value)
  66. {
  67. Application.Iteration += OnApplicationOnIteration;
  68. initialized = true;
  69. lock (_timeoutLock)
  70. {
  71. _output.WriteLine ($"Setting timeout for {timeoutTime}ms");
  72. timeout = Application.AddTimeout (TimeSpan.FromMilliseconds (timeoutTime), TimeoutCallback);
  73. }
  74. }
  75. else
  76. {
  77. Application.Iteration -= OnApplicationOnIteration;
  78. shutdown = true;
  79. }
  80. }
  81. bool TimeoutCallback ()
  82. {
  83. lock (_timeoutLock)
  84. {
  85. _output.WriteLine ($"TimeoutCallback. Count: {++timeoutCount}. Application Iteration: {iteration}");
  86. if (timeout is { })
  87. {
  88. _output.WriteLine (" Nulling timeout.");
  89. timeout = null;
  90. }
  91. }
  92. // False means "don't re-do timer and remove it"
  93. return false;
  94. }
  95. void OnApplicationOnIteration (object s, IterationEventArgs a)
  96. {
  97. lock (_timeoutLock)
  98. {
  99. if (timeoutCount > 0)
  100. {
  101. _output.WriteLine ($"Iteration #{iteration} - Timeout fired. Calling Application.RequestStop.");
  102. Application.RequestStop ();
  103. return;
  104. }
  105. }
  106. iteration++;
  107. // Simulate a delay
  108. Thread.Sleep ((int)timeoutTime / 10);
  109. // Worst case scenario - something went wrong
  110. if (Application.Initialized && iteration > 25)
  111. {
  112. _output.WriteLine ($"Too many iterations ({iteration}): Calling Application.RequestStop.");
  113. Application.RequestStop ();
  114. }
  115. }
  116. }
  117. [Fact]
  118. [AutoInitShutdown]
  119. public void Begin_Null_Toplevel_Throws ()
  120. {
  121. // Test null Toplevel
  122. Assert.Throws<ArgumentNullException> (() => Application.Begin (null));
  123. Application.Shutdown ();
  124. Assert.Null (Application.Top);
  125. Assert.Null (Application.Driver);
  126. }
  127. [Fact]
  128. [AutoInitShutdown (verifyShutdown: true)]
  129. public void Begin_Sets_Application_Top_To_Console_Size ()
  130. {
  131. Assert.Null (Application.Top);
  132. Application.Driver!.SetScreenSize (80, 25);
  133. Toplevel top = new ();
  134. Application.Begin (top);
  135. Assert.Equal (new (0, 0, 80, 25), Application.Top!.Frame);
  136. Application.Driver!.SetScreenSize (5, 5);
  137. Assert.Equal (new (0, 0, 5, 5), Application.Top!.Frame);
  138. top.Dispose ();
  139. }
  140. [Fact]
  141. [AutoInitShutdown]
  142. public void End_And_Shutdown_Should_Not_Dispose_ApplicationTop ()
  143. {
  144. Assert.Null (Application.Top);
  145. RunState rs = Application.Begin (new ());
  146. Application.Top!.Title = "End_And_Shutdown_Should_Not_Dispose_ApplicationTop";
  147. Assert.Equal (rs.Toplevel, Application.Top);
  148. Application.End (rs);
  149. #if DEBUG_IDISPOSABLE
  150. Assert.True (rs.WasDisposed);
  151. Assert.False (Application.Top!.WasDisposed); // Is true because the rs.Toplevel is the same as Application.Top
  152. #endif
  153. Assert.Null (rs.Toplevel);
  154. Toplevel top = Application.Top;
  155. #if DEBUG_IDISPOSABLE
  156. Exception exception = Record.Exception (Application.Shutdown);
  157. Assert.NotNull (exception);
  158. Assert.False (top.WasDisposed);
  159. top.Dispose ();
  160. Assert.True (top.WasDisposed);
  161. #endif
  162. Application.Shutdown ();
  163. Assert.Null (Application.Top);
  164. }
  165. [Fact]
  166. [AutoInitShutdown]
  167. public void Init_Begin_End_Cleans_Up ()
  168. {
  169. // Start stopwatch
  170. var stopwatch = new Stopwatch ();
  171. stopwatch.Start ();
  172. // Begin will cause Run() to be called, which will call Begin(). Thus will block the tests
  173. // if we don't stop
  174. Application.Iteration += (s, a) => { Application.RequestStop (); };
  175. RunState runstate = null;
  176. EventHandler<RunStateEventArgs> newRunStateFn = (s, e) =>
  177. {
  178. Assert.NotNull (e.State);
  179. runstate = e.State;
  180. };
  181. Application.NotifyNewRunState += newRunStateFn;
  182. var topLevel = new Toplevel ();
  183. RunState rs = Application.Begin (topLevel);
  184. Assert.NotNull (rs);
  185. Assert.NotNull (runstate);
  186. Assert.Equal (rs, runstate);
  187. Assert.Equal (topLevel, Application.Top);
  188. Application.NotifyNewRunState -= newRunStateFn;
  189. Application.End (runstate);
  190. Assert.NotNull (Application.Top);
  191. Assert.NotNull (Application.Driver);
  192. topLevel.Dispose ();
  193. Application.Shutdown ();
  194. Assert.Null (Application.Top);
  195. Assert.Null (Application.Driver);
  196. // Stop stopwatch
  197. stopwatch.Stop ();
  198. _output.WriteLine ($"Load took {stopwatch.ElapsedMilliseconds} ms");
  199. }
  200. // Legacy driver test - all InlineData commented out
  201. //[Theory]
  202. ////[InlineData (typeof (DotNetDriver))]
  203. ////[InlineData (typeof (ANSIDriver))]
  204. ////[InlineData (typeof (WindowsDriver))]
  205. ////[InlineData (typeof (UnixDriver))]
  206. //public void Init_DriverName_Should_Pick_Correct_Driver (Type driverType)
  207. //{
  208. // var driver = (IConsoleDriver)Activator.CreateInstance (driverType);
  209. // Application.Init (driverName: driverType.Name);
  210. // Assert.NotNull (Application.Driver);
  211. // Assert.NotEqual (driver, Application.Driver);
  212. // Assert.Equal (driverType, Application.Driver?.GetType ());
  213. // Application.Shutdown ();
  214. //}
  215. [Fact]
  216. public void Init_Null_Driver_Should_Pick_A_Driver ()
  217. {
  218. Application.Init ();
  219. Assert.NotNull (Application.Driver);
  220. Application.Shutdown ();
  221. }
  222. [Theory]
  223. [InlineData (typeof (FakeDriver))]
  224. //[InlineData (typeof (DotNetDriver))]
  225. //[InlineData (typeof (WindowsDriver))]
  226. //[InlineData (typeof (UnixDriver))]
  227. public void Init_ResetState_Resets_Properties (Type driverType)
  228. {
  229. ThrowOnJsonErrors = true;
  230. // For all the fields/properties of Application, check that they are reset to their default values
  231. // Set some values
  232. Application.Init (driverName: driverType.Name);
  233. // Application.IsInitialized = true;
  234. // Reset
  235. Application.ResetState ();
  236. void CheckReset ()
  237. {
  238. // Check that all fields and properties are set to their default values
  239. // Public Properties
  240. Assert.Null (Application.Top);
  241. Assert.Null (Application.Mouse.MouseGrabView);
  242. // Don't check Application.ForceDriver
  243. // Assert.Empty (Application.ForceDriver);
  244. // Don't check Application.Force16Colors
  245. //Assert.False (Application.Force16Colors);
  246. Assert.Null (Application.Driver);
  247. Assert.False (Application.EndAfterFirstIteration);
  248. // Commented out because if CM changed the defaults, those changes should
  249. // persist across Inits.
  250. //Assert.Equal (Key.Tab.WithShift, Application.PrevTabKey);
  251. //Assert.Equal (Key.Tab, Application.NextTabKey);
  252. //Assert.Equal (Key.F6.WithShift, Application.PrevTabGroupKey);
  253. //Assert.Equal (Key.F6, Application.NextTabGroupKey);
  254. //Assert.Equal (Key.Esc, Application.QuitKey);
  255. // Internal properties
  256. Assert.False (Application.Initialized);
  257. Assert.Equal (Application.GetSupportedCultures (), Application.SupportedCultures);
  258. Assert.Equal (Application.GetAvailableCulturesFromEmbeddedResources (), Application.SupportedCultures);
  259. Assert.False (Application._forceFakeConsole);
  260. Assert.Equal (-1, Application.MainThreadId);
  261. Assert.Empty (Application.TopLevels);
  262. Assert.Empty (Application.CachedViewsUnderMouse);
  263. // Mouse
  264. // Do not reset _lastMousePosition
  265. //Assert.Null (Application._lastMousePosition);
  266. // Navigation
  267. Assert.Null (Application.Navigation);
  268. // Popover
  269. Assert.Null (Application.Popover);
  270. // Events - Can't check
  271. //Assert.Null (Application.NotifyNewRunState);
  272. //Assert.Null (Application.NotifyNewRunState);
  273. //Assert.Null (Application.Iteration);
  274. //Assert.Null (Application.SizeChanging);
  275. //Assert.Null (Application.GrabbedMouse);
  276. //Assert.Null (Application.UnGrabbingMouse);
  277. //Assert.Null (Application.GrabbedMouse);
  278. //Assert.Null (Application.UnGrabbedMouse);
  279. //Assert.Null (Application.MouseEvent);
  280. //Assert.Null (Application.KeyDown);
  281. //Assert.Null (Application.KeyUp);
  282. }
  283. CheckReset ();
  284. // Set the values that can be set
  285. Application.Initialized = true;
  286. Application._forceFakeConsole = true;
  287. Application.MainThreadId = 1;
  288. //Application._topLevels = new List<Toplevel> ();
  289. Application.CachedViewsUnderMouse.Clear ();
  290. //Application.SupportedCultures = new List<CultureInfo> ();
  291. Application.Force16Colors = true;
  292. //Application.ForceDriver = "driver";
  293. Application.EndAfterFirstIteration = true;
  294. Application.PrevTabGroupKey = Key.A;
  295. Application.NextTabGroupKey = Key.B;
  296. Application.QuitKey = Key.C;
  297. Application.KeyBindings.Add (Key.D, Command.Cancel);
  298. Application.CachedViewsUnderMouse.Clear ();
  299. //Application.WantContinuousButtonPressedView = new View ();
  300. // Mouse
  301. Application.LastMousePosition = new Point (1, 1);
  302. Application.Navigation = new ();
  303. Application.ResetState ();
  304. CheckReset ();
  305. ThrowOnJsonErrors = false;
  306. }
  307. [Fact]
  308. public void Init_Shutdown_Cleans_Up ()
  309. {
  310. // Verify initial state is per spec
  311. //Pre_Init_State ();
  312. Application.Init (new FakeDriver ());
  313. // Verify post-Init state is correct
  314. //Post_Init_State ();
  315. Application.Shutdown ();
  316. // Verify state is back to initial
  317. //Pre_Init_State ();
  318. #if DEBUG_IDISPOSABLE
  319. // Validate there are no outstanding Responder-based instances
  320. // after a scenario was selected to run. This proves the main UI Catalog
  321. // 'app' closed cleanly.
  322. Assert.Empty (View.Instances);
  323. #endif
  324. }
  325. [Fact]
  326. public void Shutdown_Alone_Does_Nothing () { Application.Shutdown (); }
  327. [Theory]
  328. [InlineData (typeof (FakeDriver))]
  329. //[InlineData (typeof (DotNetDriver))]
  330. //[InlineData (typeof (WindowsDriver))]
  331. //[InlineData (typeof (UnixDriver))]
  332. public void Init_Shutdown_Fire_InitializedChanged (Type driverType)
  333. {
  334. var initialized = false;
  335. var shutdown = false;
  336. Application.InitializedChanged += OnApplicationOnInitializedChanged;
  337. Application.Init (driverName: driverType.Name);
  338. Assert.True (initialized);
  339. Assert.False (shutdown);
  340. Application.Shutdown ();
  341. Assert.True (initialized);
  342. Assert.True (shutdown);
  343. Application.InitializedChanged -= OnApplicationOnInitializedChanged;
  344. return;
  345. void OnApplicationOnInitializedChanged (object s, EventArgs<bool> a)
  346. {
  347. if (a.Value)
  348. {
  349. initialized = true;
  350. }
  351. else
  352. {
  353. shutdown = true;
  354. }
  355. }
  356. }
  357. [Fact]
  358. [AutoInitShutdown]
  359. public void Init_Unbalanced_Throws ()
  360. {
  361. Assert.Throws<InvalidOperationException> (() =>
  362. Application.Init (null, "fake")
  363. );
  364. Application.Shutdown ();
  365. Assert.Null (Application.Top);
  366. Assert.Null (Application.Driver);
  367. }
  368. [Fact]
  369. [AutoInitShutdown]
  370. public void Init_Unbalanced_Throws2 ()
  371. {
  372. // Now try the other way
  373. Assert.Throws<InvalidOperationException> (() => Application.Init (new FakeDriver ()));
  374. Application.Shutdown ();
  375. Assert.Null (Application.Top);
  376. Assert.Null (Application.Driver);
  377. }
  378. [Fact]
  379. public void Init_WithoutTopLevelFactory_Begin_End_Cleans_Up ()
  380. {
  381. // Begin will cause Run() to be called, which will call Begin(). Thus will block the tests
  382. // if we don't stop
  383. Application.Iteration += (s, a) => { Application.RequestStop (); };
  384. // NOTE: Run<T>, when called after Init has been called behaves differently than
  385. // when called if Init has not been called.
  386. Toplevel topLevel = new ();
  387. Application.Init (null, "fake");
  388. RunState runstate = null;
  389. EventHandler<RunStateEventArgs> newRunStateFn = (s, e) =>
  390. {
  391. Assert.NotNull (e.State);
  392. runstate = e.State;
  393. };
  394. Application.NotifyNewRunState += newRunStateFn;
  395. RunState rs = Application.Begin (topLevel);
  396. Assert.NotNull (rs);
  397. Assert.NotNull (runstate);
  398. Assert.Equal (rs, runstate);
  399. Assert.Equal (topLevel, Application.Top);
  400. Application.NotifyNewRunState -= newRunStateFn;
  401. Application.End (runstate);
  402. Assert.NotNull (Application.Top);
  403. Assert.NotNull (Application.Driver);
  404. topLevel.Dispose ();
  405. Application.Shutdown ();
  406. Assert.Null (Application.Top);
  407. Assert.Null (Application.Driver);
  408. }
  409. [Fact (Skip = "FakeDriver is not allowed, use AutoInitShutdown attribute instead")]
  410. public void Init_NoParam_ForceDriver_Works ()
  411. {
  412. Application.ForceDriver = "Fake";
  413. Application.Init ();
  414. //Assert.IsType<FakeConsoleInput>(Application.Drive);
  415. //Assert.IsType<FakeDriver> (Application.Driver);
  416. Application.ResetState ();
  417. }
  418. [Fact]
  419. public void Init_KeyBindings_Are_Not_Reset ()
  420. {
  421. Debug.Assert (!IsEnabled);
  422. try
  423. {
  424. // arrange
  425. ThrowOnJsonErrors = true;
  426. Application.QuitKey = Key.Q;
  427. Assert.Equal (Key.Q, Application.QuitKey);
  428. Application.Init (new FakeDriver ());
  429. Assert.Equal (Key.Q, Application.QuitKey);
  430. }
  431. finally
  432. {
  433. Application.ResetState ();
  434. }
  435. }
  436. [Fact]
  437. [AutoInitShutdown (verifyShutdown: true)]
  438. public void Internal_Properties_Correct ()
  439. {
  440. Assert.True (Application.Initialized);
  441. Assert.Null (Application.Top);
  442. RunState rs = Application.Begin (new ());
  443. Assert.Equal (Application.Top, rs.Toplevel);
  444. Assert.Null (Application.Mouse.MouseGrabView); // public
  445. Application.Top!.Dispose ();
  446. }
  447. // Invoke Tests
  448. // TODO: Test with threading scenarios
  449. [Fact]
  450. [AutoInitShutdown]
  451. public void Invoke_Adds_Idle ()
  452. {
  453. Toplevel top = new ();
  454. RunState rs = Application.Begin (top);
  455. var actionCalled = 0;
  456. Application.Invoke (() => { actionCalled++; });
  457. ApplicationImpl.Instance.TimedEvents!.RunTimers ();
  458. Assert.Equal (1, actionCalled);
  459. top.Dispose ();
  460. Application.Shutdown ();
  461. }
  462. [Fact]
  463. public void Run_Iteration_Fires ()
  464. {
  465. var iteration = 0;
  466. Application.Init (null, "fake");
  467. Application.Iteration += Application_Iteration;
  468. Application.Run<Toplevel> ().Dispose ();
  469. Assert.Equal (1, iteration);
  470. Application.Shutdown ();
  471. return;
  472. void Application_Iteration (object sender, IterationEventArgs e)
  473. {
  474. if (iteration > 0)
  475. {
  476. Assert.Fail ();
  477. }
  478. iteration++;
  479. Application.RequestStop ();
  480. }
  481. }
  482. [Fact]
  483. [AutoInitShutdown]
  484. public void Screen_Size_Changes ()
  485. {
  486. IConsoleDriver driver = Application.Driver;
  487. Application.Driver!.SetScreenSize (80, 25);
  488. Assert.Equal (new (0, 0, 80, 25), driver.Screen);
  489. Assert.Equal (new (0, 0, 80, 25), Application.Screen);
  490. // TODO: Should not be possible to manually change these at whim!
  491. driver.Cols = 100;
  492. driver.Rows = 30;
  493. // IConsoleDriver.Screen isn't assignable
  494. //driver.Screen = new (0, 0, driver.Cols, Rows);
  495. Application.Driver!.SetScreenSize (100, 30);
  496. Assert.Equal (new (0, 0, 100, 30), driver.Screen);
  497. // Assert does not make sense
  498. // Assert.NotEqual (new (0, 0, 100, 30), Application.Screen);
  499. // Assert.Equal (new (0, 0, 80, 25), Application.Screen);
  500. Application.Screen = new (0, 0, driver.Cols, driver.Rows);
  501. Assert.Equal (new (0, 0, 100, 30), driver.Screen);
  502. Application.Shutdown ();
  503. }
  504. [Fact]
  505. public void InitState_Throws_If_Driver_Is_Null () { Assert.Throws<ArgumentNullException> (static () => Application.SubscribeDriverEvents ()); }
  506. #region RunTests
  507. [Fact]
  508. [AutoInitShutdown]
  509. public void Run_T_After_InitWithDriver_with_TopLevel_Does_Not_Throws ()
  510. {
  511. Application.Iteration += (s, e) => Application.RequestStop ();
  512. // Run<Toplevel> when already initialized or not with a Driver will not throw (because Window is derived from Toplevel)
  513. // Using another type not derived from Toplevel will throws at compile time
  514. Application.Run<Window> ();
  515. Assert.True (Application.Top is Window);
  516. Application.Top!.Dispose ();
  517. Application.Shutdown ();
  518. Assert.Null (Application.Top);
  519. Assert.Null (Application.Driver);
  520. }
  521. [Fact]
  522. public void Run_T_After_InitWithDriver_with_TopLevel_and_Driver_Does_Not_Throws ()
  523. {
  524. Application.Iteration += (s, e) => Application.RequestStop ();
  525. // Run<Toplevel> when already initialized or not with a Driver will not throw (because Window is derived from Toplevel)
  526. // Using another type not derived from Toplevel will throws at compile time
  527. Application.Run<Window> (null, new FakeDriver ());
  528. Assert.True (Application.Top is Window);
  529. Application.Top!.Dispose ();
  530. // Run<Toplevel> when already initialized or not with a Driver will not throw (because Dialog is derived from Toplevel)
  531. Application.Run<Dialog> (null, new FakeDriver ());
  532. Assert.True (Application.Top is Dialog);
  533. Application.Top!.Dispose ();
  534. Application.Shutdown ();
  535. Assert.Null (Application.Top);
  536. Assert.Null (Application.Driver);
  537. }
  538. [Fact]
  539. [AutoInitShutdown]
  540. [TestRespondersDisposed]
  541. public void Run_T_After_Init_Does_Not_Disposes_Application_Top ()
  542. {
  543. // Init doesn't create a Toplevel and assigned it to Application.Top
  544. // but Begin does
  545. var initTop = new Toplevel ();
  546. Application.Iteration += (s, a) =>
  547. {
  548. Assert.NotEqual (initTop, Application.Top);
  549. #if DEBUG_IDISPOSABLE
  550. Assert.False (initTop.WasDisposed);
  551. #endif
  552. Application.RequestStop ();
  553. };
  554. Application.Run<Toplevel> ();
  555. #if DEBUG_IDISPOSABLE
  556. Assert.False (initTop.WasDisposed);
  557. initTop.Dispose ();
  558. Assert.True (initTop.WasDisposed);
  559. #endif
  560. Application.Top!.Dispose ();
  561. Application.Shutdown ();
  562. Assert.Null (Application.Top);
  563. Assert.Null (Application.Driver);
  564. }
  565. [Fact]
  566. [TestRespondersDisposed]
  567. [AutoInitShutdown]
  568. public void Run_T_After_InitWithDriver_with_TestTopLevel_DoesNotThrow ()
  569. {
  570. Application.Iteration += (s, a) => { Application.RequestStop (); };
  571. // Init has been called and we're passing no driver to Run<TestTopLevel>. This is ok.
  572. Application.Run<Toplevel> ();
  573. Application.Top!.Dispose ();
  574. Application.Shutdown ();
  575. Assert.Null (Application.Top);
  576. Assert.Null (Application.Driver);
  577. }
  578. [Fact]
  579. [TestRespondersDisposed]
  580. public void Run_T_After_InitNullDriver_with_TestTopLevel_DoesNotThrow ()
  581. {
  582. Application.ForceDriver = "FakeDriver";
  583. var a = new AutoInitShutdownAttribute ();
  584. a.Before (null);
  585. Application.Iteration += (s, a) => { Application.RequestStop (); };
  586. // Init has been called, selecting FakeDriver; we're passing no driver to Run<TestTopLevel>. Should be fine.
  587. Application.Run<Toplevel> ();
  588. Application.Top!.Dispose ();
  589. Application.Shutdown ();
  590. Assert.Null (Application.Top);
  591. Assert.Null (Application.Driver);
  592. a.After (null);
  593. }
  594. [Fact]
  595. [TestRespondersDisposed]
  596. [AutoInitShutdown]
  597. public void Run_T_Init_Driver_Cleared_with_TestTopLevel_Throws ()
  598. {
  599. Application.Driver = null;
  600. // Init has been called, but Driver has been set to null. Bad.
  601. Assert.Throws<InvalidOperationException> (() => Application.Run<Toplevel> ());
  602. Application.Shutdown ();
  603. Assert.Null (Application.Top);
  604. Assert.Null (Application.Driver);
  605. }
  606. [Fact (Skip = "FakeDriver is not allowed, use AutoInitShutdown attribute instead")]
  607. [TestRespondersDisposed]
  608. public void Run_T_NoInit_DoesNotThrow ()
  609. {
  610. Application.ForceDriver = "FakeDriver";
  611. Application.Iteration += (s, a) => { Application.RequestStop (); };
  612. Application.Run<Toplevel> ();
  613. Assert.Equal (typeof (FakeDriver), Application.Driver?.GetType ());
  614. Application.Top!.Dispose ();
  615. Application.Shutdown ();
  616. Assert.Null (Application.Top);
  617. Assert.Null (Application.Driver);
  618. }
  619. [Fact]
  620. [TestRespondersDisposed]
  621. public void Run_T_NoInit_WithDriver_DoesNotThrow ()
  622. {
  623. Application.Iteration += (s, a) => { Application.RequestStop (); };
  624. // Init has NOT been called and we're passing a valid driver to Run<TestTopLevel>. This is ok.
  625. Application.Run<Toplevel> (null, new FakeDriver ());
  626. Application.Top!.Dispose ();
  627. Application.Shutdown ();
  628. Assert.Null (Application.Top);
  629. Assert.Null (Application.Driver);
  630. }
  631. [Fact]
  632. [TestRespondersDisposed]
  633. [AutoInitShutdown]
  634. public void Run_RequestStop_Stops ()
  635. {
  636. var top = new Toplevel ();
  637. RunState rs = Application.Begin (top);
  638. Assert.NotNull (rs);
  639. Application.Iteration += (s, a) => { Application.RequestStop (); };
  640. Application.Run (top);
  641. top.Dispose ();
  642. Application.Shutdown ();
  643. Assert.Null (Application.Top);
  644. Assert.Null (Application.Driver);
  645. }
  646. [Fact]
  647. [AutoInitShutdown]
  648. public void Run_Sets_Running_True ()
  649. {
  650. var top = new Toplevel ();
  651. RunState rs = Application.Begin (top);
  652. Assert.NotNull (rs);
  653. Application.Iteration += (s, a) =>
  654. {
  655. Assert.True (top.Running);
  656. top.Running = false;
  657. };
  658. Application.Run (top);
  659. top.Dispose ();
  660. Application.Shutdown ();
  661. Assert.Null (Application.Top);
  662. Assert.Null (Application.Driver);
  663. }
  664. [Fact]
  665. [TestRespondersDisposed]
  666. [AutoInitShutdown]
  667. public void Run_RunningFalse_Stops ()
  668. {
  669. var top = new Toplevel ();
  670. RunState rs = Application.Begin (top);
  671. Assert.NotNull (rs);
  672. Application.Iteration += (s, a) => { top.Running = false; };
  673. Application.Run (top);
  674. top.Dispose ();
  675. Application.Shutdown ();
  676. Assert.Null (Application.Top);
  677. Assert.Null (Application.Driver);
  678. }
  679. [Fact]
  680. [AutoInitShutdown]
  681. [TestRespondersDisposed]
  682. public void Run_Loaded_Ready_Unloaded_Events ()
  683. {
  684. Toplevel top = new ();
  685. var count = 0;
  686. top.Loaded += (s, e) => count++;
  687. top.Ready += (s, e) => count++;
  688. top.Unloaded += (s, e) => count++;
  689. Application.Iteration += (s, a) => Application.RequestStop ();
  690. Application.Run (top);
  691. top.Dispose ();
  692. Application.Shutdown ();
  693. Assert.Equal (3, count);
  694. }
  695. // TODO: All Toplevel layout tests should be moved to ToplevelTests.cs
  696. [Fact]
  697. [AutoInitShutdown]
  698. public void Run_A_Modal_Toplevel_Refresh_Background_On_Moving ()
  699. {
  700. // Don't use Dialog here as it has more layout logic. Use Window instead.
  701. var w = new Window
  702. {
  703. Width = 5, Height = 5,
  704. Arrangement = ViewArrangement.Movable
  705. };
  706. Application.Driver!.SetScreenSize (10, 10);
  707. RunState rs = Application.Begin (w);
  708. // Don't use visuals to test as style of border can change over time.
  709. Assert.Equal (new (0, 0), w.Frame.Location);
  710. Application.RaiseMouseEvent (new () { Flags = MouseFlags.Button1Pressed });
  711. Assert.Equal (w.Border, Application.Mouse.MouseGrabView);
  712. Assert.Equal (new (0, 0), w.Frame.Location);
  713. // Move down and to the right.
  714. Application.RaiseMouseEvent (new () { ScreenPosition = new (1, 1), Flags = MouseFlags.Button1Pressed | MouseFlags.ReportMousePosition });
  715. Assert.Equal (new (1, 1), w.Frame.Location);
  716. Application.End (rs);
  717. w.Dispose ();
  718. Application.Shutdown ();
  719. }
  720. [Fact]
  721. [AutoInitShutdown]
  722. public void End_Does_Not_Dispose ()
  723. {
  724. var top = new Toplevel ();
  725. Window w = new ();
  726. w.Ready += (s, e) => Application.RequestStop (); // Causes `End` to be called
  727. Application.Run (w);
  728. #if DEBUG_IDISPOSABLE
  729. Assert.False (w.WasDisposed);
  730. #endif
  731. Assert.NotNull (w);
  732. Assert.Equal (string.Empty, w.Title); // Valid - w has not been disposed. The user may want to run it again
  733. Assert.NotNull (Application.Top);
  734. Assert.Equal (w, Application.Top);
  735. Assert.NotEqual (top, Application.Top);
  736. Application.Run (w); // Valid - w has not been disposed.
  737. #if DEBUG_IDISPOSABLE
  738. Assert.False (w.WasDisposed);
  739. Exception exception = Record.Exception (Application.Shutdown); // Invalid - w has not been disposed.
  740. Assert.NotNull (exception);
  741. w.Dispose ();
  742. Assert.True (w.WasDisposed);
  743. //exception = Record.Exception (
  744. // () => Application.Run (
  745. // w)); // Invalid - w has been disposed. Run it in debug mode will throw, otherwise the user may want to run it again
  746. //Assert.NotNull (exception);
  747. // TODO: Re-enable this when we are done debug logging of ctx.Source.Title in RaiseSelecting
  748. //exception = Record.Exception (() => Assert.Equal (string.Empty, w.Title)); // Invalid - w has been disposed and cannot be accessed
  749. //Assert.NotNull (exception);
  750. //exception = Record.Exception (() => w.Title = "NewTitle"); // Invalid - w has been disposed and cannot be accessed
  751. //Assert.NotNull (exception);
  752. #endif
  753. Application.Shutdown ();
  754. Assert.NotNull (w);
  755. Assert.NotNull (top);
  756. Assert.Null (Application.Top);
  757. }
  758. [Fact]
  759. public void Run_Creates_Top_Without_Init ()
  760. {
  761. var driver = new FakeDriver ();
  762. Assert.Null (Application.Top);
  763. Application.Iteration += (s, e) =>
  764. {
  765. Assert.NotNull (Application.Top);
  766. Application.RequestStop ();
  767. };
  768. Toplevel top = Application.Run (null, driver);
  769. #if DEBUG_IDISPOSABLE
  770. Assert.Equal (top, Application.Top);
  771. Assert.False (top.WasDisposed);
  772. Exception exception = Record.Exception (Application.Shutdown);
  773. Assert.NotNull (exception);
  774. Assert.False (top.WasDisposed);
  775. #endif
  776. // It's up to caller to dispose it
  777. top.Dispose ();
  778. #if DEBUG_IDISPOSABLE
  779. Assert.True (top.WasDisposed);
  780. #endif
  781. Assert.NotNull (Application.Top);
  782. Application.Shutdown ();
  783. Assert.Null (Application.Top);
  784. }
  785. [Fact]
  786. public void Run_T_Creates_Top_Without_Init ()
  787. {
  788. var driver = new FakeDriver ();
  789. Assert.Null (Application.Top);
  790. Application.Iteration += (s, e) =>
  791. {
  792. Assert.NotNull (Application.Top);
  793. Application.RequestStop ();
  794. };
  795. Application.Run<Toplevel> (null, driver);
  796. #if DEBUG_IDISPOSABLE
  797. Assert.False (Application.Top!.WasDisposed);
  798. Exception exception = Record.Exception (Application.Shutdown);
  799. Assert.NotNull (exception);
  800. Assert.False (Application.Top!.WasDisposed);
  801. // It's up to caller to dispose it
  802. Application.Top!.Dispose ();
  803. Assert.True (Application.Top!.WasDisposed);
  804. #endif
  805. Assert.NotNull (Application.Top);
  806. Application.Shutdown ();
  807. Assert.Null (Application.Top);
  808. }
  809. [Fact]
  810. public void Run_t_Does_Not_Creates_Top_Without_Init ()
  811. {
  812. // When a Toplevel is created it must already have all the Application configuration loaded
  813. // This is only possible by two ways:
  814. // 1 - Using Application.Init first
  815. // 2 - Using Application.Run() or Application.Run<T>()
  816. // The Application.Run(new(Toplevel)) must always call Application.Init() first because
  817. // the new(Toplevel) may be a derived class that is possible using Application static
  818. // properties that is only available after the Application.Init was called
  819. var driver = new FakeDriver ();
  820. Assert.Null (Application.Top);
  821. Assert.Throws<NotInitializedException> (() => Application.Run (new Toplevel ()));
  822. Application.Init (driver);
  823. Application.Iteration += (s, e) =>
  824. {
  825. Assert.NotNull (Application.Top);
  826. Application.RequestStop ();
  827. };
  828. Application.Run (new Toplevel ());
  829. #if DEBUG_IDISPOSABLE
  830. Assert.False (Application.Top!.WasDisposed);
  831. Exception exception = Record.Exception (Application.Shutdown);
  832. Assert.NotNull (exception);
  833. Assert.False (Application.Top!.WasDisposed);
  834. // It's up to caller to dispose it
  835. Application.Top!.Dispose ();
  836. Assert.True (Application.Top!.WasDisposed);
  837. #endif
  838. Assert.NotNull (Application.Top);
  839. Application.Shutdown ();
  840. Assert.Null (Application.Top);
  841. }
  842. private class TestToplevel : Toplevel
  843. { }
  844. private readonly object _forceDriverLock = new ();
  845. /*
  846. [Theory]
  847. // This test wants to Run which results in console handle errors, it wants to rely non drivers checking ConsoleDriver.RunningUnitTests
  848. // And suppressing things that might fail, this is anti pattern, instead we should test this kind of thing with Mocking
  849. // [InlineData ("v2win", typeof (ConsoleDriverFacade<WindowsConsole.InputRecord>))]
  850. // [InlineData ("v2net", typeof (ConsoleDriverFacade<ConsoleKeyInfo>))]
  851. // FakeDriver is not allowed, use AutoInitShutdown attribute instead
  852. //[InlineData ("FakeDriver", typeof (FakeDriver))]
  853. //[InlineData ("DotNetDriver", typeof (DotNetDriver))]
  854. //[InlineData ("WindowsDriver", typeof (WindowsDriver))]
  855. //[InlineData ("UnixDriver", typeof (UnixDriver))]
  856. public void Run_T_Call_Init_ForceDriver_Should_Pick_Correct_Driver (string driverName, Type expectedType)
  857. {
  858. Assert.True (ConsoleDriver.RunningUnitTests);
  859. var result = false;
  860. lock (_forceDriverLock)
  861. {
  862. Task.Run (() =>
  863. {
  864. while (!Application.Initialized)
  865. {
  866. Task.Delay (300).Wait ();
  867. }
  868. })
  869. .ContinueWith (
  870. (t, _) =>
  871. {
  872. // no longer loading
  873. Assert.True (Application.Initialized);
  874. Application.Invoke (() =>
  875. {
  876. result = true;
  877. Application.RequestStop ();
  878. });
  879. },
  880. TaskScheduler.FromCurrentSynchronizationContext ());
  881. }
  882. Application.ForceDriver = driverName;
  883. Application.Run<TestToplevel> ();
  884. Assert.NotNull (Application.Driver);
  885. Assert.Equal (expectedType, Application.Driver?.GetType ());
  886. Assert.NotNull (Application.Top);
  887. Assert.False (Application.Top!.Running);
  888. Application.Top!.Dispose ();
  889. Application.Shutdown ();
  890. Assert.True (result);
  891. }
  892. */
  893. [Fact]
  894. public void Run_T_With_Legacy_Driver_Does_Not_Call_ResetState_After_Init ()
  895. {
  896. Assert.False (Application.Initialized);
  897. Application.Init ();
  898. Assert.True (Application.Initialized);
  899. Application.Iteration += (_, _) => Application.RequestStop ();
  900. Application.Run<TestToplevel> ();
  901. Assert.NotNull (Application.Driver);
  902. Assert.NotNull (Application.Top);
  903. Assert.False (Application.Top!.Running);
  904. Application.Top!.Dispose ();
  905. Application.Shutdown ();
  906. }
  907. [Fact]
  908. public void Run_T_With_V2_Driver_Does_Not_Call_ResetState_After_Init ()
  909. {
  910. Assert.False (Application.Initialized);
  911. Application.Init (null, "v2net");
  912. Assert.True (Application.Initialized);
  913. Task.Run (() => { Task.Delay (300).Wait (); })
  914. .ContinueWith (
  915. (t, _) =>
  916. {
  917. // no longer loading
  918. Application.Invoke (() => { Application.RequestStop (); });
  919. },
  920. TaskScheduler.FromCurrentSynchronizationContext ());
  921. Application.Run<TestToplevel> ();
  922. Assert.NotNull (Application.Driver);
  923. Assert.NotNull (Application.Top);
  924. Assert.False (Application.Top!.Running);
  925. Application.Top!.Dispose ();
  926. Application.Shutdown ();
  927. }
  928. // TODO: Add tests for Run that test errorHandler
  929. #endregion
  930. #region ShutdownTests
  931. [Fact]
  932. public async Task Shutdown_Allows_Async ()
  933. {
  934. var isCompletedSuccessfully = false;
  935. async Task TaskWithAsyncContinuation ()
  936. {
  937. await Task.Yield ();
  938. await Task.Yield ();
  939. isCompletedSuccessfully = true;
  940. }
  941. Application.Shutdown ();
  942. Assert.False (isCompletedSuccessfully);
  943. await TaskWithAsyncContinuation ();
  944. Thread.Sleep (100);
  945. Assert.True (isCompletedSuccessfully);
  946. }
  947. [Fact]
  948. public void Shutdown_Resets_SyncContext ()
  949. {
  950. Application.Shutdown ();
  951. Assert.Null (SynchronizationContext.Current);
  952. }
  953. #endregion
  954. }