ApplicationTests.cs 34 KB

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