ApplicationTests.cs 38 KB

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