ApplicationTests.cs 39 KB

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