ApplicationTests.cs 39 KB

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