ApplicationTests.cs 39 KB

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