ApplicationTests.cs 38 KB

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