ApplicationTests.cs 38 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844845846847848849850851852853854855856857858859860861862863864865866867868869870871872873874875876877878879880881882883884885886887888889890891892893894895896897898899900901902903904905906907908909910911912913914915916917918919920921922923924925926927928929930931932933934935936937938939940941942943944945946947948949950951952953954955956957958959960961962963964965966967968969970971972973974975976977978979980981982983984985986987988989990991992993994995996997998999100010011002100310041005100610071008100910101011101210131014101510161017101810191020102110221023102410251026102710281029103010311032103310341035103610371038103910401041104210431044104510461047104810491050105110521053105410551056105710581059106010611062106310641065106610671068106910701071107210731074107510761077107810791080108110821083108410851086108710881089109010911092109310941095109610971098109911001101110211031104110511061107110811091110111111121113111411151116111711181119112011211122112311241125112611271128112911301131113211331134113511361137113811391140114111421143114411451146114711481149115011511152115311541155115611571158115911601161116211631164116511661167116811691170117111721173117411751176117711781179118011811182118311841185118611871188118911901191119211931194119511961197119811991200120112021203120412051206120712081209121012111212
  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.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.MainThreadId = 1;
  290. //Application._topLevels = new List<Toplevel> ();
  291. Application.CachedViewsUnderMouse.Clear ();
  292. //Application.SupportedCultures = new List<CultureInfo> ();
  293. Application.Force16Colors = true;
  294. //Application.ForceDriver = "driver";
  295. Application.EndAfterFirstIteration = true;
  296. Application.PrevTabGroupKey = Key.A;
  297. Application.NextTabGroupKey = Key.B;
  298. Application.QuitKey = Key.C;
  299. Application.KeyBindings.Add (Key.D, Command.Cancel);
  300. Application.CachedViewsUnderMouse.Clear ();
  301. //Application.WantContinuousButtonPressedView = new View ();
  302. // Mouse
  303. Application.LastMousePosition = new Point (1, 1);
  304. Application.Navigation = new ();
  305. Application.ResetState ();
  306. CheckReset ();
  307. ThrowOnJsonErrors = false;
  308. }
  309. [Fact]
  310. public void Init_Shutdown_Cleans_Up ()
  311. {
  312. // Verify initial state is per spec
  313. //Pre_Init_State ();
  314. Application.Init (new FakeDriver ());
  315. // Verify post-Init state is correct
  316. //Post_Init_State ();
  317. Application.Shutdown ();
  318. // Verify state is back to initial
  319. //Pre_Init_State ();
  320. #if DEBUG_IDISPOSABLE
  321. // Validate there are no outstanding Responder-based instances
  322. // after a scenario was selected to run. This proves the main UI Catalog
  323. // 'app' closed cleanly.
  324. Assert.Empty (View.Instances);
  325. #endif
  326. }
  327. [Fact]
  328. public void Shutdown_Alone_Does_Nothing () { Application.Shutdown (); }
  329. [Theory]
  330. [InlineData (typeof (FakeDriver))]
  331. //[InlineData (typeof (DotNetDriver))]
  332. //[InlineData (typeof (WindowsDriver))]
  333. //[InlineData (typeof (UnixDriver))]
  334. public void Init_Shutdown_Fire_InitializedChanged (Type driverType)
  335. {
  336. var initialized = false;
  337. var shutdown = false;
  338. Application.InitializedChanged += OnApplicationOnInitializedChanged;
  339. Application.Init (driverName: driverType.Name);
  340. Assert.True (initialized);
  341. Assert.False (shutdown);
  342. Application.Shutdown ();
  343. Assert.True (initialized);
  344. Assert.True (shutdown);
  345. Application.InitializedChanged -= OnApplicationOnInitializedChanged;
  346. return;
  347. void OnApplicationOnInitializedChanged (object s, EventArgs<bool> a)
  348. {
  349. if (a.Value)
  350. {
  351. initialized = true;
  352. }
  353. else
  354. {
  355. shutdown = true;
  356. }
  357. }
  358. }
  359. [Fact]
  360. [AutoInitShutdown]
  361. public void Init_Unbalanced_Throws ()
  362. {
  363. Assert.Throws<InvalidOperationException> (
  364. () =>
  365. Application.InternalInit (
  366. new FakeDriver ()
  367. )
  368. );
  369. Application.Shutdown ();
  370. Assert.Null (Application.Top);
  371. Assert.Null (Application.Driver);
  372. }
  373. [Fact]
  374. [AutoInitShutdown]
  375. public void Init_Unbalanced_Throws2 ()
  376. {
  377. // Now try the other way
  378. Assert.Throws<InvalidOperationException> (() => Application.Init (new FakeDriver ()));
  379. Application.Shutdown ();
  380. Assert.Null (Application.Top);
  381. Assert.Null (Application.Driver);
  382. }
  383. [Fact]
  384. public void Init_WithoutTopLevelFactory_Begin_End_Cleans_Up ()
  385. {
  386. // Begin will cause Run() to be called, which will call Begin(). Thus will block the tests
  387. // if we don't stop
  388. Application.Iteration += (s, a) => { Application.RequestStop (); };
  389. // NOTE: Run<T>, when called after Init has been called behaves differently than
  390. // when called if Init has not been called.
  391. Toplevel topLevel = new ();
  392. Application.InternalInit (new FakeDriver ());
  393. RunState runstate = null;
  394. EventHandler<RunStateEventArgs> newRunStateFn = (s, e) =>
  395. {
  396. Assert.NotNull (e.State);
  397. runstate = e.State;
  398. };
  399. Application.NotifyNewRunState += newRunStateFn;
  400. RunState rs = Application.Begin (topLevel);
  401. Assert.NotNull (rs);
  402. Assert.NotNull (runstate);
  403. Assert.Equal (rs, runstate);
  404. Assert.Equal (topLevel, Application.Top);
  405. Application.NotifyNewRunState -= newRunStateFn;
  406. Application.End (runstate);
  407. Assert.NotNull (Application.Top);
  408. Assert.NotNull (Application.Driver);
  409. topLevel.Dispose ();
  410. Application.Shutdown ();
  411. Assert.Null (Application.Top);
  412. Assert.Null (Application.Driver);
  413. }
  414. [Fact (Skip = "FakeDriver is not allowed, use AutoInitShutdown attribute instead")]
  415. public void Init_NoParam_ForceDriver_Works ()
  416. {
  417. Application.ForceDriver = "Fake";
  418. Application.Init ();
  419. //Assert.IsType<FakeConsoleInput>(Application.Drive);
  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.Mouse.MouseGrabView); // public
  450. Application.Top!.Dispose ();
  451. }
  452. // Invoke Tests
  453. // TODO: Test with threading scenarios
  454. [Fact]
  455. [AutoInitShutdown]
  456. public void Invoke_Adds_Idle ()
  457. {
  458. Toplevel top = new ();
  459. RunState rs = Application.Begin (top);
  460. var actionCalled = 0;
  461. Application.Invoke (() => { actionCalled++; });
  462. ApplicationImpl.Instance.TimedEvents!.RunTimers ();
  463. Assert.Equal (1, actionCalled);
  464. top.Dispose ();
  465. Application.Shutdown ();
  466. }
  467. [Fact]
  468. public void Run_Iteration_Fires ()
  469. {
  470. var iteration = 0;
  471. Application.Init (null, driverName: "fake");
  472. Application.Iteration += Application_Iteration;
  473. Application.Run<Toplevel> ().Dispose ();
  474. Assert.Equal (1, iteration);
  475. Application.Shutdown ();
  476. return;
  477. void Application_Iteration (object sender, IterationEventArgs e)
  478. {
  479. if (iteration > 0)
  480. {
  481. Assert.Fail ();
  482. }
  483. iteration++;
  484. Application.RequestStop ();
  485. }
  486. }
  487. [Fact]
  488. [AutoInitShutdown]
  489. public void Screen_Size_Changes ()
  490. {
  491. var driver = Application.Driver;
  492. AutoInitShutdownAttribute.FakeResize (new Size (80,25));
  493. Assert.Equal (new (0, 0, 80, 25), driver.Screen);
  494. Assert.Equal (new (0, 0, 80, 25), Application.Screen);
  495. // TODO: Should not be possible to manually change these at whim!
  496. driver.Cols = 100;
  497. driver.Rows = 30;
  498. // IConsoleDriver.Screen isn't assignable
  499. //driver.Screen = new (0, 0, driver.Cols, Rows);
  500. AutoInitShutdownAttribute.FakeResize (new Size (100, 30));
  501. Assert.Equal (new (0, 0, 100, 30), driver.Screen);
  502. // Assert does not make sense
  503. // Assert.NotEqual (new (0, 0, 100, 30), Application.Screen);
  504. // Assert.Equal (new (0, 0, 80, 25), Application.Screen);
  505. Application.Screen = new (0, 0, driver.Cols, driver.Rows);
  506. Assert.Equal (new (0, 0, 100, 30), driver.Screen);
  507. Application.Shutdown ();
  508. }
  509. [Fact]
  510. public void InitState_Throws_If_Driver_Is_Null ()
  511. {
  512. Assert.Throws<ArgumentNullException> (static () => Application.SubscribeDriverEvents ());
  513. }
  514. #region RunTests
  515. [Fact]
  516. [AutoInitShutdown]
  517. public void Run_T_After_InitWithDriver_with_TopLevel_Does_Not_Throws ()
  518. {
  519. Application.Iteration += (s, e) => Application.RequestStop ();
  520. // Run<Toplevel> when already initialized or not with a Driver will not throw (because Window is derived from Toplevel)
  521. // Using another type not derived from Toplevel will throws at compile time
  522. Application.Run<Window> ();
  523. Assert.True (Application.Top is Window);
  524. Application.Top!.Dispose ();
  525. Application.Shutdown ();
  526. Assert.Null (Application.Top);
  527. Assert.Null (Application.Driver);
  528. }
  529. [Fact]
  530. public void Run_T_After_InitWithDriver_with_TopLevel_and_Driver_Does_Not_Throws ()
  531. {
  532. Application.Iteration += (s, e) => Application.RequestStop ();
  533. // Run<Toplevel> when already initialized or not with a Driver will not throw (because Window is derived from Toplevel)
  534. // Using another type not derived from Toplevel will throws at compile time
  535. Application.Run<Window> (null, new FakeDriver ());
  536. Assert.True (Application.Top is Window);
  537. Application.Top!.Dispose ();
  538. // Run<Toplevel> when already initialized or not with a Driver will not throw (because Dialog is derived from Toplevel)
  539. Application.Run<Dialog> (null, new FakeDriver ());
  540. Assert.True (Application.Top is Dialog);
  541. Application.Top!.Dispose ();
  542. Application.Shutdown ();
  543. Assert.Null (Application.Top);
  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.Driver);
  572. }
  573. [Fact]
  574. [TestRespondersDisposed]
  575. [AutoInitShutdown]
  576. public void Run_T_After_InitWithDriver_with_TestTopLevel_DoesNotThrow ()
  577. {
  578. Application.Iteration += (s, a) => { Application.RequestStop (); };
  579. // Init has been called and we're passing no driver to Run<TestTopLevel>. This is ok.
  580. Application.Run<Toplevel> ();
  581. Application.Top!.Dispose ();
  582. Application.Shutdown ();
  583. Assert.Null (Application.Top);
  584. Assert.Null (Application.Driver);
  585. }
  586. [Fact]
  587. [TestRespondersDisposed]
  588. public void Run_T_After_InitNullDriver_with_TestTopLevel_DoesNotThrow ()
  589. {
  590. Application.ForceDriver = "FakeDriver";
  591. var a = new AutoInitShutdownAttribute ();
  592. a.Before (null);
  593. Application.Iteration += (s, a) => { Application.RequestStop (); };
  594. // Init has been called, selecting FakeDriver; we're passing no driver to Run<TestTopLevel>. Should be fine.
  595. Application.Run<Toplevel> ();
  596. Application.Top!.Dispose ();
  597. Application.Shutdown ();
  598. Assert.Null (Application.Top);
  599. Assert.Null (Application.Driver);
  600. a.After (null);
  601. }
  602. [Fact]
  603. [TestRespondersDisposed]
  604. [AutoInitShutdown]
  605. public void Run_T_Init_Driver_Cleared_with_TestTopLevel_Throws ()
  606. {
  607. Application.Driver = null;
  608. // Init has been called, but Driver has been set to null. Bad.
  609. Assert.Throws<InvalidOperationException> (() => Application.Run<Toplevel> ());
  610. Application.Shutdown ();
  611. Assert.Null (Application.Top);
  612. Assert.Null (Application.Driver);
  613. }
  614. [Fact(Skip = "FakeDriver is not allowed, use AutoInitShutdown attribute instead")]
  615. [TestRespondersDisposed]
  616. public void Run_T_NoInit_DoesNotThrow ()
  617. {
  618. Application.ForceDriver = "FakeDriver";
  619. Application.Iteration += (s, a) => { Application.RequestStop (); };
  620. Application.Run<Toplevel> ();
  621. Assert.Equal (typeof (FakeDriver), Application.Driver?.GetType ());
  622. Application.Top!.Dispose ();
  623. Application.Shutdown ();
  624. Assert.Null (Application.Top);
  625. Assert.Null (Application.Driver);
  626. }
  627. [Fact]
  628. [TestRespondersDisposed]
  629. public void Run_T_NoInit_WithDriver_DoesNotThrow ()
  630. {
  631. Application.Iteration += (s, a) => { Application.RequestStop (); };
  632. // Init has NOT been called and we're passing a valid driver to Run<TestTopLevel>. This is ok.
  633. Application.Run<Toplevel> (null, new FakeDriver ());
  634. Application.Top!.Dispose ();
  635. Application.Shutdown ();
  636. Assert.Null (Application.Top);
  637. Assert.Null (Application.Driver);
  638. }
  639. [Fact]
  640. [TestRespondersDisposed]
  641. [AutoInitShutdown]
  642. public void Run_RequestStop_Stops ()
  643. {
  644. var top = new Toplevel ();
  645. RunState rs = Application.Begin (top);
  646. Assert.NotNull (rs);
  647. Application.Iteration += (s, a) => { Application.RequestStop (); };
  648. Application.Run (top);
  649. top.Dispose ();
  650. Application.Shutdown ();
  651. Assert.Null (Application.Top);
  652. Assert.Null (Application.Driver);
  653. }
  654. [Fact]
  655. [AutoInitShutdown]
  656. public void Run_Sets_Running_True ()
  657. {
  658. var top = new Toplevel ();
  659. RunState rs = Application.Begin (top);
  660. Assert.NotNull (rs);
  661. Application.Iteration += (s, a) =>
  662. {
  663. Assert.True (top.Running);
  664. top.Running = false;
  665. };
  666. Application.Run (top);
  667. top.Dispose ();
  668. Application.Shutdown ();
  669. Assert.Null (Application.Top);
  670. Assert.Null (Application.Driver);
  671. }
  672. [Fact]
  673. [TestRespondersDisposed]
  674. [AutoInitShutdown]
  675. public void Run_RunningFalse_Stops ()
  676. {
  677. var top = new Toplevel ();
  678. RunState rs = Application.Begin (top);
  679. Assert.NotNull (rs);
  680. Application.Iteration += (s, a) => { top.Running = false; };
  681. Application.Run (top);
  682. top.Dispose ();
  683. Application.Shutdown ();
  684. Assert.Null (Application.Top);
  685. Assert.Null (Application.Driver);
  686. }
  687. [Fact]
  688. [AutoInitShutdown]
  689. [TestRespondersDisposed]
  690. public void Run_Loaded_Ready_Unloaded_Events ()
  691. {
  692. Toplevel top = new ();
  693. var count = 0;
  694. top.Loaded += (s, e) => count++;
  695. top.Ready += (s, e) => count++;
  696. top.Unloaded += (s, e) => count++;
  697. Application.Iteration += (s, a) => Application.RequestStop ();
  698. Application.Run (top);
  699. top.Dispose ();
  700. Application.Shutdown ();
  701. Assert.Equal (3, count);
  702. }
  703. // TODO: All Toplevel layout tests should be moved to ToplevelTests.cs
  704. [Fact]
  705. [AutoInitShutdown]
  706. public void Run_A_Modal_Toplevel_Refresh_Background_On_Moving ()
  707. {
  708. // Don't use Dialog here as it has more layout logic. Use Window instead.
  709. var w = new Window
  710. {
  711. Width = 5, Height = 5,
  712. Arrangement = ViewArrangement.Movable
  713. };
  714. AutoInitShutdownAttribute.FakeResize (new Size (10, 10));
  715. RunState rs = Application.Begin (w);
  716. // Don't use visuals to test as style of border can change over time.
  717. Assert.Equal (new (0, 0), w.Frame.Location);
  718. Application.RaiseMouseEvent (new () { Flags = MouseFlags.Button1Pressed });
  719. Assert.Equal (w.Border, Application.Mouse.MouseGrabView);
  720. Assert.Equal (new (0, 0), w.Frame.Location);
  721. // Move down and to the right.
  722. Application.RaiseMouseEvent (new () { ScreenPosition = new (1, 1), Flags = MouseFlags.Button1Pressed | MouseFlags.ReportMousePosition });
  723. Assert.Equal (new (1, 1), w.Frame.Location);
  724. Application.End (rs);
  725. w.Dispose ();
  726. Application.Shutdown ();
  727. }
  728. [Fact]
  729. [AutoInitShutdown]
  730. public void End_Does_Not_Dispose ()
  731. {
  732. var top = new Toplevel ();
  733. Window w = new ();
  734. w.Ready += (s, e) => Application.RequestStop (); // Causes `End` to be called
  735. Application.Run (w);
  736. #if DEBUG_IDISPOSABLE
  737. Assert.False (w.WasDisposed);
  738. #endif
  739. Assert.NotNull (w);
  740. Assert.Equal (string.Empty, w.Title); // Valid - w has not been disposed. The user may want to run it again
  741. Assert.NotNull (Application.Top);
  742. Assert.Equal (w, Application.Top);
  743. Assert.NotEqual (top, Application.Top);
  744. Application.Run (w); // Valid - w has not been disposed.
  745. #if DEBUG_IDISPOSABLE
  746. Assert.False (w.WasDisposed);
  747. Exception exception = Record.Exception (Application.Shutdown); // Invalid - w has not been disposed.
  748. Assert.NotNull (exception);
  749. w.Dispose ();
  750. Assert.True (w.WasDisposed);
  751. //exception = Record.Exception (
  752. // () => Application.Run (
  753. // w)); // Invalid - w has been disposed. Run it in debug mode will throw, otherwise the user may want to run it again
  754. //Assert.NotNull (exception);
  755. // TODO: Re-enable this when we are done debug logging of ctx.Source.Title in RaiseSelecting
  756. //exception = Record.Exception (() => Assert.Equal (string.Empty, w.Title)); // Invalid - w has been disposed and cannot be accessed
  757. //Assert.NotNull (exception);
  758. //exception = Record.Exception (() => w.Title = "NewTitle"); // Invalid - w has been disposed and cannot be accessed
  759. //Assert.NotNull (exception);
  760. #endif
  761. Application.Shutdown ();
  762. Assert.NotNull (w);
  763. Assert.NotNull (top);
  764. Assert.Null (Application.Top);
  765. }
  766. [Fact]
  767. public void Run_Creates_Top_Without_Init ()
  768. {
  769. var driver = new FakeDriver ();
  770. Assert.Null (Application.Top);
  771. Application.Iteration += (s, e) =>
  772. {
  773. Assert.NotNull (Application.Top);
  774. Application.RequestStop ();
  775. };
  776. Toplevel top = Application.Run (null, driver);
  777. #if DEBUG_IDISPOSABLE
  778. Assert.Equal (top, Application.Top);
  779. Assert.False (top.WasDisposed);
  780. Exception exception = Record.Exception (Application.Shutdown);
  781. Assert.NotNull (exception);
  782. Assert.False (top.WasDisposed);
  783. #endif
  784. // It's up to caller to dispose it
  785. top.Dispose ();
  786. #if DEBUG_IDISPOSABLE
  787. Assert.True (top.WasDisposed);
  788. #endif
  789. Assert.NotNull (Application.Top);
  790. Application.Shutdown ();
  791. Assert.Null (Application.Top);
  792. }
  793. [Fact]
  794. public void Run_T_Creates_Top_Without_Init ()
  795. {
  796. var driver = new FakeDriver ();
  797. Assert.Null (Application.Top);
  798. Application.Iteration += (s, e) =>
  799. {
  800. Assert.NotNull (Application.Top);
  801. Application.RequestStop ();
  802. };
  803. Application.Run<Toplevel> (null, driver);
  804. #if DEBUG_IDISPOSABLE
  805. Assert.False (Application.Top!.WasDisposed);
  806. Exception exception = Record.Exception (Application.Shutdown);
  807. Assert.NotNull (exception);
  808. Assert.False (Application.Top!.WasDisposed);
  809. // It's up to caller to dispose it
  810. Application.Top!.Dispose ();
  811. Assert.True (Application.Top!.WasDisposed);
  812. #endif
  813. Assert.NotNull (Application.Top);
  814. Application.Shutdown ();
  815. Assert.Null (Application.Top);
  816. }
  817. [Fact]
  818. public void Run_t_Does_Not_Creates_Top_Without_Init ()
  819. {
  820. // When a Toplevel is created it must already have all the Application configuration loaded
  821. // This is only possible by two ways:
  822. // 1 - Using Application.Init first
  823. // 2 - Using Application.Run() or Application.Run<T>()
  824. // The Application.Run(new(Toplevel)) must always call Application.Init() first because
  825. // the new(Toplevel) may be a derived class that is possible using Application static
  826. // properties that is only available after the Application.Init was called
  827. var driver = new FakeDriver ();
  828. Assert.Null (Application.Top);
  829. Assert.Throws<NotInitializedException> (() => Application.Run (new Toplevel ()));
  830. Application.Init (driver);
  831. Application.Iteration += (s, e) =>
  832. {
  833. Assert.NotNull (Application.Top);
  834. Application.RequestStop ();
  835. };
  836. Application.Run (new Toplevel ());
  837. #if DEBUG_IDISPOSABLE
  838. Assert.False (Application.Top!.WasDisposed);
  839. Exception exception = Record.Exception (Application.Shutdown);
  840. Assert.NotNull (exception);
  841. Assert.False (Application.Top!.WasDisposed);
  842. // It's up to caller to dispose it
  843. Application.Top!.Dispose ();
  844. Assert.True (Application.Top!.WasDisposed);
  845. #endif
  846. Assert.NotNull (Application.Top);
  847. Application.Shutdown ();
  848. Assert.Null (Application.Top);
  849. }
  850. private class TestToplevel : Toplevel { }
  851. private readonly object _forceDriverLock = new ();
  852. /*
  853. [Theory]
  854. // This test wants to Run which results in console handle errors, it wants to rely non drivers checking ConsoleDriver.RunningUnitTests
  855. // And suppressing things that might fail, this is anti pattern, instead we should test this kind of thing with Mocking
  856. // [InlineData ("v2win", typeof (ConsoleDriverFacade<WindowsConsole.InputRecord>))]
  857. // [InlineData ("v2net", typeof (ConsoleDriverFacade<ConsoleKeyInfo>))]
  858. // FakeDriver is not allowed, use AutoInitShutdown attribute instead
  859. //[InlineData ("FakeDriver", typeof (FakeDriver))]
  860. //[InlineData ("DotNetDriver", typeof (DotNetDriver))]
  861. //[InlineData ("WindowsDriver", typeof (WindowsDriver))]
  862. //[InlineData ("UnixDriver", typeof (UnixDriver))]
  863. public void Run_T_Call_Init_ForceDriver_Should_Pick_Correct_Driver (string driverName, Type expectedType)
  864. {
  865. Assert.True (ConsoleDriver.RunningUnitTests);
  866. var result = false;
  867. lock (_forceDriverLock)
  868. {
  869. Task.Run (() =>
  870. {
  871. while (!Application.Initialized)
  872. {
  873. Task.Delay (300).Wait ();
  874. }
  875. })
  876. .ContinueWith (
  877. (t, _) =>
  878. {
  879. // no longer loading
  880. Assert.True (Application.Initialized);
  881. Application.Invoke (() =>
  882. {
  883. result = true;
  884. Application.RequestStop ();
  885. });
  886. },
  887. TaskScheduler.FromCurrentSynchronizationContext ());
  888. }
  889. Application.ForceDriver = driverName;
  890. Application.Run<TestToplevel> ();
  891. Assert.NotNull (Application.Driver);
  892. Assert.Equal (expectedType, Application.Driver?.GetType ());
  893. Assert.NotNull (Application.Top);
  894. Assert.False (Application.Top!.Running);
  895. Application.Top!.Dispose ();
  896. Application.Shutdown ();
  897. Assert.True (result);
  898. }
  899. */
  900. [Fact]
  901. public void Run_T_With_Legacy_Driver_Does_Not_Call_ResetState_After_Init ()
  902. {
  903. Assert.False (Application.Initialized);
  904. Application.Init ();
  905. Assert.True (Application.Initialized);
  906. Application.Iteration += (_, _) => Application.RequestStop ();
  907. Application.Run<TestToplevel> ();
  908. Assert.NotNull (Application.Driver);
  909. Assert.NotNull (Application.Top);
  910. Assert.False (Application.Top!.Running);
  911. Application.Top!.Dispose ();
  912. Application.Shutdown ();
  913. }
  914. [Fact]
  915. public void Run_T_With_V2_Driver_Does_Not_Call_ResetState_After_Init ()
  916. {
  917. Assert.False (Application.Initialized);
  918. Application.Init (null, "v2net");
  919. Assert.True (Application.Initialized);
  920. Task.Run (() =>
  921. {
  922. Task.Delay (300).Wait ();
  923. }).ContinueWith (
  924. (t, _) =>
  925. {
  926. // no longer loading
  927. Application.Invoke (() =>
  928. {
  929. Application.RequestStop ();
  930. });
  931. },
  932. TaskScheduler.FromCurrentSynchronizationContext ());
  933. Application.Run<TestToplevel> ();
  934. Assert.NotNull (Application.Driver);
  935. Assert.NotNull (Application.Top);
  936. Assert.False (Application.Top!.Running);
  937. Application.Top!.Dispose ();
  938. Application.Shutdown ();
  939. }
  940. // TODO: Add tests for Run that test errorHandler
  941. #endregion
  942. #region ShutdownTests
  943. [Fact]
  944. public async Task Shutdown_Allows_Async ()
  945. {
  946. var isCompletedSuccessfully = false;
  947. async Task TaskWithAsyncContinuation ()
  948. {
  949. await Task.Yield ();
  950. await Task.Yield ();
  951. isCompletedSuccessfully = true;
  952. }
  953. Application.Shutdown ();
  954. Assert.False (isCompletedSuccessfully);
  955. await TaskWithAsyncContinuation ();
  956. Thread.Sleep (100);
  957. Assert.True (isCompletedSuccessfully);
  958. }
  959. [Fact]
  960. public void Shutdown_Resets_SyncContext ()
  961. {
  962. Application.Shutdown ();
  963. Assert.Null (SynchronizationContext.Current);
  964. }
  965. #endregion
  966. }