EnumExtensionMethodsIncrementalGeneratorTests.cs 12 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322
  1. using System.Collections.Concurrent;
  2. using System.Collections.ObjectModel;
  3. using System.Reflection;
  4. using NUnit.Framework.Interfaces;
  5. using NUnit.Framework.Internal;
  6. using Terminal.Gui.Analyzers.Internal.Attributes;
  7. using Terminal.Gui.Analyzers.Internal.Generators.EnumExtensions;
  8. // ReSharper disable InconsistentNaming
  9. namespace Terminal.Gui.Analyzers.Internal.Tests.Generators.EnumExtensions;
  10. [TestFixture]
  11. [Category ("Source Generators")]
  12. [TestOf (typeof (EnumExtensionMethodsIncrementalGenerator))]
  13. [Parallelizable (ParallelScope.Children)]
  14. public class EnumExtensionMethodsIncrementalGeneratorTests
  15. {
  16. private static bool _isInitialized;
  17. /// <summary>All enum types declared in the test assembly.</summary>
  18. private static readonly ObservableCollection<Type> _allEnumTypes = [];
  19. /// <summary>
  20. /// All enum types without a <see cref="GenerateEnumExtensionMethodsAttribute"/>, <see cref="_allEnumTypes"/>
  21. /// </summary>
  22. private static readonly HashSet<Type> _boringEnumTypes = [];
  23. /// <summary>All extension classes generated for enums with our attribute.</summary>
  24. private static readonly ObservableCollection<Type> _enumExtensionClasses = [];
  25. private static readonly ConcurrentDictionary<Type, EnumData> _extendedEnumTypeMappings = [];
  26. private static IEnumerable<Type> ExtendedEnumTypes => _extendedEnumTypeMappings.Keys;
  27. private static readonly ReaderWriterLockSlim _initializationLock = new ();
  28. private static IEnumerable<AssemblyExtendedEnumTypeAttribute> GetAssemblyExtendedEnumTypeAttributes () =>
  29. Assembly.GetExecutingAssembly ()
  30. .GetCustomAttributes<AssemblyExtendedEnumTypeAttribute> ();
  31. private static IEnumerable<TestCaseData> Get_AssemblyExtendedEnumTypeAttribute_EnumHasGeneratorAttribute_Cases ()
  32. {
  33. return GetAssemblyExtendedEnumTypeAttributes ()
  34. .Select (
  35. static attr => new TestCaseData (attr)
  36. {
  37. TestName = $"{nameof (AssemblyExtendedEnumTypeAttribute_EnumHasGeneratorAttribute)}({attr.EnumType.Name},{attr.ExtensionClass.Name})",
  38. HasExpectedResult = true,
  39. ExpectedResult = true
  40. });
  41. }
  42. [Test]
  43. [Category ("Attributes")]
  44. [TestCaseSource (nameof (Get_AssemblyExtendedEnumTypeAttribute_EnumHasGeneratorAttribute_Cases))]
  45. public bool AssemblyExtendedEnumTypeAttribute_EnumHasGeneratorAttribute (AssemblyExtendedEnumTypeAttribute attr)
  46. {
  47. Assume.That (attr, Is.Not.Null);
  48. Assume.That (attr.EnumType, Is.Not.Null);
  49. Assume.That (attr.EnumType.IsEnum);
  50. return attr.EnumType.IsDefined (typeof (GenerateEnumExtensionMethodsAttribute));
  51. }
  52. [Test]
  53. [Category("Attributes")]
  54. public void AssemblyExtendedEnumTypeAttribute_ExtensionClassHasExpectedReverseMappingAttribute ([ValueSource(nameof(GetAssemblyExtendedEnumTypeAttributes))]AssemblyExtendedEnumTypeAttribute attr)
  55. {
  56. Assume.That (attr, Is.Not.Null);
  57. Assume.That (attr.ExtensionClass, Is.Not.Null);
  58. Assume.That (attr.ExtensionClass.IsClass);
  59. Assume.That (attr.ExtensionClass.IsSealed);
  60. Assert.That (attr.ExtensionClass.IsDefined (typeof (ExtensionsForEnumTypeAttribute<>)));
  61. }
  62. [Test]
  63. [Category("Attributes")]
  64. public void ExtendedEnum_AssemblyHasMatchingAttribute ([ValueSource(nameof(GetExtendedEnum_EnumData))]EnumData enumData)
  65. {
  66. Assume.That (enumData, Is.Not.Null);
  67. Assume.That (enumData.EnumType, Is.Not.Null);
  68. Assume.That (enumData.EnumType.IsEnum);
  69. Assert.That (enumData.EnumType, Has.Attribute<GenerateEnumExtensionMethodsAttribute> ());
  70. }
  71. [Test]
  72. public void BoringEnum_DoesNotHaveExtensions ([ValueSource (nameof (_boringEnumTypes))] Type enumType)
  73. {
  74. Assume.That (enumType.IsEnum);
  75. Assert.That (enumType, Has.No.Attribute<GenerateEnumExtensionMethodsAttribute> ());
  76. }
  77. [Test]
  78. public void ExtendedEnum_FastIsDefinedFalse_DoesNotHaveFastIsDefined ([ValueSource (nameof (GetExtendedEnumTypes_FastIsDefinedFalse))] EnumData enumData)
  79. {
  80. Assume.That (enumData.EnumType.IsEnum);
  81. Assume.That (enumData.EnumType, Has.Attribute<GenerateEnumExtensionMethodsAttribute> ());
  82. Assume.That (enumData.GeneratorAttribute, Is.Not.Null);
  83. Assume.That (enumData.GeneratorAttribute, Is.EqualTo (enumData.EnumType.GetCustomAttribute<GenerateEnumExtensionMethodsAttribute> ()));
  84. Assume.That (enumData.GeneratorAttribute, Has.Property ("FastIsDefined").False);
  85. Assume.That (enumData.ExtensionClass, Is.Not.Null);
  86. Assert.That (enumData.ExtensionClass!.GetMethod ("FastIsDefined"), Is.Null);
  87. }
  88. [Test]
  89. public void ExtendedEnum_StaticExtensionClassExists ([ValueSource (nameof (ExtendedEnumTypes))] Type enumType)
  90. {
  91. Assume.That (enumType.IsEnum);
  92. Assume.That (enumType, Has.Attribute<GenerateEnumExtensionMethodsAttribute> ());
  93. Assume.That (enumType, Has.Attribute<GenerateEnumExtensionMethodsAttribute> ());
  94. }
  95. [Test]
  96. public void ExtendedEnum_FastIsDefinedTrue_HasFastIsDefined ([ValueSource (nameof (GetExtendedEnumTypes_FastIsDefinedTrue))] EnumData enumData)
  97. {
  98. Assume.That (enumData.EnumType, Is.Not.Null);
  99. Assume.That (enumData.EnumType.IsEnum);
  100. Assume.That (enumData.EnumType, Has.Attribute<GenerateEnumExtensionMethodsAttribute> ());
  101. Assume.That (enumData.ExtensionClass, Is.Not.Null);
  102. ITypeInfo extensionClassTypeInfo = new TypeWrapper (enumData.ExtensionClass!);
  103. Assume.That (extensionClassTypeInfo.IsStaticClass);
  104. Assume.That (enumData.GeneratorAttribute, Is.Not.Null);
  105. Assume.That (enumData.GeneratorAttribute, Is.EqualTo (enumData.EnumType.GetCustomAttribute<GenerateEnumExtensionMethodsAttribute> ()));
  106. Assume.That (enumData.GeneratorAttribute, Has.Property ("FastIsDefined").True);
  107. MethodInfo? fastIsDefinedMethod = enumData.ExtensionClass!.GetMethod ("FastIsDefined");
  108. Assert.That (fastIsDefinedMethod, Is.Not.Null);
  109. Assert.That (fastIsDefinedMethod, Has.Attribute<ExtensionAttribute> ());
  110. extensionClassTypeInfo.GetMethodsWithAttribute<ExtensionAttribute> (false);
  111. }
  112. private static IEnumerable<EnumData> GetExtendedEnum_EnumData ()
  113. {
  114. _initializationLock.EnterUpgradeableReadLock ();
  115. try
  116. {
  117. if (!_isInitialized)
  118. {
  119. Initialize ();
  120. }
  121. return _extendedEnumTypeMappings.Values;
  122. }
  123. finally
  124. {
  125. _initializationLock.ExitUpgradeableReadLock ();
  126. }
  127. }
  128. private static IEnumerable<Type> GetBoringEnumTypes ()
  129. {
  130. _initializationLock.EnterUpgradeableReadLock ();
  131. try
  132. {
  133. if (!_isInitialized)
  134. {
  135. Initialize ();
  136. }
  137. return _boringEnumTypes;
  138. }
  139. finally
  140. {
  141. _initializationLock.ExitUpgradeableReadLock ();
  142. }
  143. }
  144. private static IEnumerable<EnumData> GetExtendedEnumTypes_FastIsDefinedFalse ()
  145. {
  146. _initializationLock.EnterUpgradeableReadLock ();
  147. try
  148. {
  149. if (!_isInitialized)
  150. {
  151. Initialize ();
  152. }
  153. return _extendedEnumTypeMappings.Values.Where (static t => t.GeneratorAttribute?.FastIsDefined is false);
  154. }
  155. finally
  156. {
  157. _initializationLock.ExitUpgradeableReadLock ();
  158. }
  159. }
  160. private static IEnumerable<EnumData> GetExtendedEnumTypes_FastIsDefinedTrue ()
  161. {
  162. _initializationLock.EnterUpgradeableReadLock ();
  163. try
  164. {
  165. if (!_isInitialized)
  166. {
  167. Initialize ();
  168. }
  169. return _extendedEnumTypeMappings.Values.Where (static t => t.GeneratorAttribute?.FastIsDefined is true);
  170. }
  171. finally
  172. {
  173. _initializationLock.ExitUpgradeableReadLock ();
  174. }
  175. }
  176. private static void Initialize ()
  177. {
  178. if (!_initializationLock.IsUpgradeableReadLockHeld || !_initializationLock.TryEnterWriteLock (5000))
  179. {
  180. return;
  181. }
  182. try
  183. {
  184. if (_isInitialized)
  185. {
  186. return;
  187. }
  188. _allEnumTypes.CollectionChanged += AllEnumTypes_CollectionChanged;
  189. _enumExtensionClasses.CollectionChanged += EnumExtensionClasses_OnCollectionChanged;
  190. Type [] allAssemblyTypes = Assembly
  191. .GetExecutingAssembly ()
  192. .GetTypes ();
  193. foreach (Type type in allAssemblyTypes.Where (IsDefinedEnum))
  194. {
  195. _allEnumTypes.Add (type);
  196. }
  197. foreach (Type type in allAssemblyTypes.Where (static t => t.IsClass && t.IsDefined (typeof (ExtensionsForEnumTypeAttribute<>))))
  198. {
  199. _enumExtensionClasses.Add (type);
  200. }
  201. _isInitialized = true;
  202. }
  203. finally
  204. {
  205. _initializationLock.ExitWriteLock ();
  206. }
  207. return;
  208. static bool IsDefinedEnum (Type t) { return t is { IsEnum: true, IsGenericType: false, IsConstructedGenericType: false, IsTypeDefinition: true }; }
  209. static void AllEnumTypes_CollectionChanged (object? sender, NotifyCollectionChangedEventArgs e)
  210. {
  211. if (e.Action is not NotifyCollectionChangedAction.Add and not NotifyCollectionChangedAction.Replace || e.NewItems is null)
  212. {
  213. return;
  214. }
  215. foreach (Type enumType in e.NewItems.OfType<Type> ())
  216. {
  217. if (enumType.GetCustomAttribute<GenerateEnumExtensionMethodsAttribute> () is not { } generatorAttribute)
  218. {
  219. _boringEnumTypes.Add (enumType);
  220. continue;
  221. }
  222. _extendedEnumTypeMappings.AddOrUpdate (
  223. enumType,
  224. CreateNewEnumData,
  225. UpdateGeneratorAttributeProperty,
  226. generatorAttribute);
  227. }
  228. }
  229. static EnumData CreateNewEnumData (Type tEnum, GenerateEnumExtensionMethodsAttribute attr) { return new (tEnum, attr); }
  230. static EnumData UpdateGeneratorAttributeProperty (Type tEnum, EnumData data, GenerateEnumExtensionMethodsAttribute attr)
  231. {
  232. data.GeneratorAttribute ??= attr;
  233. return data;
  234. }
  235. static void EnumExtensionClasses_OnCollectionChanged (object? sender, NotifyCollectionChangedEventArgs e)
  236. {
  237. if (e.Action != NotifyCollectionChangedAction.Add)
  238. {
  239. return;
  240. }
  241. foreach (Type extensionClassType in e.NewItems!.OfType<Type> ())
  242. {
  243. if (extensionClassType.GetCustomAttribute (typeof (ExtensionsForEnumTypeAttribute<>), false) is not IExtensionsForEnumTypeAttributes
  244. {
  245. EnumType.IsEnum: true
  246. } extensionForAttribute)
  247. {
  248. continue;
  249. }
  250. _extendedEnumTypeMappings [extensionForAttribute.EnumType].ExtensionClass ??= extensionClassType;
  251. }
  252. }
  253. }
  254. public sealed record EnumData (
  255. Type EnumType,
  256. GenerateEnumExtensionMethodsAttribute? GeneratorAttribute = null,
  257. Type? ExtensionClass = null,
  258. IExtensionsForEnumTypeAttributes? ExtensionForEnumTypeAttribute = null)
  259. {
  260. public Type? ExtensionClass { get; set; } = ExtensionClass;
  261. public IExtensionsForEnumTypeAttributes? ExtensionForEnumTypeAttribute { get; set; } = ExtensionForEnumTypeAttribute;
  262. public GenerateEnumExtensionMethodsAttribute? GeneratorAttribute { get; set; } = GeneratorAttribute;
  263. }
  264. }