ApplicationTests.cs 39 KB

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