ApplicationTests.cs 39 KB

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