EnumExtensionMethodsIncrementalGeneratorTests.cs 12 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328
  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. private const string AssemblyExtendedEnumTypeAttributeEnumPropertyName =
  53. $"{nameof (AssemblyExtendedEnumTypeAttribute)}.{nameof (AssemblyExtendedEnumTypeAttribute.EnumType)}";
  54. [Test]
  55. [Category("Attributes")]
  56. public void AssemblyExtendedEnumTypeAttribute_ExtensionClassHasExpectedReverseMappingAttribute ([ValueSource(nameof(GetAssemblyExtendedEnumTypeAttributes))]AssemblyExtendedEnumTypeAttribute attr)
  57. {
  58. Assume.That (attr, Is.Not.Null);
  59. Assume.That (attr.ExtensionClass, Is.Not.Null);
  60. Assume.That (attr.ExtensionClass.IsClass);
  61. Assume.That (attr.ExtensionClass.IsSealed);
  62. Assert.That (attr.ExtensionClass.IsDefined (typeof (ExtensionsForEnumTypeAttribute<>)));
  63. }
  64. [Test]
  65. [Category("Attributes")]
  66. public void ExtendedEnum_AssemblyHasMatchingAttribute ([ValueSource(nameof(GetExtendedEnum_EnumData))]EnumData enumData)
  67. {
  68. Assume.That (enumData, Is.Not.Null);
  69. Assume.That (enumData.EnumType, Is.Not.Null);
  70. Assume.That (enumData.EnumType.IsEnum);
  71. Assert.That (enumData.EnumType, Has.Attribute<GenerateEnumExtensionMethodsAttribute> ());
  72. }
  73. [Test]
  74. public void BoringEnum_DoesNotHaveExtensions ([ValueSource (nameof (_boringEnumTypes))] Type enumType)
  75. {
  76. Assume.That (enumType.IsEnum);
  77. Assert.That (enumType, Has.No.Attribute<GenerateEnumExtensionMethodsAttribute> ());
  78. }
  79. [Test]
  80. public void ExtendedEnum_FastIsDefinedFalse_DoesNotHaveFastIsDefined ([ValueSource (nameof (GetExtendedEnumTypes_FastIsDefinedFalse))] EnumData enumData)
  81. {
  82. Assume.That (enumData.EnumType.IsEnum);
  83. Assume.That (enumData.EnumType, Has.Attribute<GenerateEnumExtensionMethodsAttribute> ());
  84. Assume.That (enumData.GeneratorAttribute, Is.Not.Null);
  85. Assume.That (enumData.GeneratorAttribute, Is.EqualTo (enumData.EnumType.GetCustomAttribute<GenerateEnumExtensionMethodsAttribute> ()));
  86. Assume.That (enumData.GeneratorAttribute, Has.Property ("FastIsDefined").False);
  87. Assume.That (enumData.ExtensionClass, Is.Not.Null);
  88. Assert.That (enumData.ExtensionClass!.GetMethod ("FastIsDefined"), Is.Null);
  89. }
  90. [Test]
  91. public void ExtendedEnum_StaticExtensionClassExists ([ValueSource (nameof (ExtendedEnumTypes))] Type enumType)
  92. {
  93. Assume.That (enumType.IsEnum);
  94. Assume.That (enumType, Has.Attribute<GenerateEnumExtensionMethodsAttribute> ());
  95. ITypeInfo enumTypeInfo = new TypeWrapper (enumType);
  96. Assume.That (enumType, Has.Attribute<GenerateEnumExtensionMethodsAttribute> ());
  97. }
  98. [Test]
  99. public void ExtendedEnum_FastIsDefinedTrue_HasFastIsDefined ([ValueSource (nameof (GetExtendedEnumTypes_FastIsDefinedTrue))] EnumData enumData)
  100. {
  101. Assume.That (enumData.EnumType, Is.Not.Null);
  102. Assume.That (enumData.EnumType.IsEnum);
  103. Assume.That (enumData.EnumType, Has.Attribute<GenerateEnumExtensionMethodsAttribute> ());
  104. Assume.That (enumData.ExtensionClass, Is.Not.Null);
  105. ITypeInfo extensionClassTypeInfo = new TypeWrapper (enumData.ExtensionClass!);
  106. Assume.That (extensionClassTypeInfo.IsStaticClass);
  107. Assume.That (enumData.GeneratorAttribute, Is.Not.Null);
  108. Assume.That (enumData.GeneratorAttribute, Is.EqualTo (enumData.EnumType.GetCustomAttribute<GenerateEnumExtensionMethodsAttribute> ()));
  109. Assume.That (enumData.GeneratorAttribute, Has.Property ("FastIsDefined").True);
  110. MethodInfo? fastIsDefinedMethod = enumData.ExtensionClass!.GetMethod ("FastIsDefined");
  111. Assert.That (fastIsDefinedMethod, Is.Not.Null);
  112. Assert.That (fastIsDefinedMethod, Has.Attribute<ExtensionAttribute> ());
  113. IMethodInfo[] extensionMethods = extensionClassTypeInfo.GetMethodsWithAttribute<ExtensionAttribute> (false);
  114. }
  115. private static IEnumerable<EnumData> GetExtendedEnum_EnumData ()
  116. {
  117. _initializationLock.EnterUpgradeableReadLock ();
  118. try
  119. {
  120. if (!_isInitialized)
  121. {
  122. Initialize ();
  123. }
  124. return _extendedEnumTypeMappings.Values;
  125. }
  126. finally
  127. {
  128. _initializationLock.ExitUpgradeableReadLock ();
  129. }
  130. }
  131. private static IEnumerable<Type> GetBoringEnumTypes ()
  132. {
  133. _initializationLock.EnterUpgradeableReadLock ();
  134. try
  135. {
  136. if (!_isInitialized)
  137. {
  138. Initialize ();
  139. }
  140. return _boringEnumTypes;
  141. }
  142. finally
  143. {
  144. _initializationLock.ExitUpgradeableReadLock ();
  145. }
  146. }
  147. private static IEnumerable<EnumData> GetExtendedEnumTypes_FastIsDefinedFalse ()
  148. {
  149. _initializationLock.EnterUpgradeableReadLock ();
  150. try
  151. {
  152. if (!_isInitialized)
  153. {
  154. Initialize ();
  155. }
  156. return _extendedEnumTypeMappings.Values.Where (static t => t.GeneratorAttribute?.FastIsDefined is false);
  157. }
  158. finally
  159. {
  160. _initializationLock.ExitUpgradeableReadLock ();
  161. }
  162. }
  163. private static IEnumerable<EnumData> GetExtendedEnumTypes_FastIsDefinedTrue ()
  164. {
  165. _initializationLock.EnterUpgradeableReadLock ();
  166. try
  167. {
  168. if (!_isInitialized)
  169. {
  170. Initialize ();
  171. }
  172. return _extendedEnumTypeMappings.Values.Where (static t => t.GeneratorAttribute?.FastIsDefined is true);
  173. }
  174. finally
  175. {
  176. _initializationLock.ExitUpgradeableReadLock ();
  177. }
  178. }
  179. private static void Initialize ()
  180. {
  181. if (!_initializationLock.IsUpgradeableReadLockHeld || !_initializationLock.TryEnterWriteLock (5000))
  182. {
  183. return;
  184. }
  185. try
  186. {
  187. if (_isInitialized)
  188. {
  189. return;
  190. }
  191. _allEnumTypes.CollectionChanged += AllEnumTypes_CollectionChanged;
  192. _enumExtensionClasses.CollectionChanged += EnumExtensionClasses_OnCollectionChanged;
  193. Type [] allAssemblyTypes = Assembly
  194. .GetExecutingAssembly ()
  195. .GetTypes ();
  196. IEnumerable<Type> allEnumTypes = allAssemblyTypes.Where (IsDefinedEnum);
  197. foreach (Type type in allEnumTypes)
  198. {
  199. _allEnumTypes.Add (type);
  200. }
  201. foreach (Type type in allAssemblyTypes.Where (static t => t.IsClass && t.IsDefined (typeof (ExtensionsForEnumTypeAttribute<>))))
  202. {
  203. _enumExtensionClasses.Add (type);
  204. }
  205. _isInitialized = true;
  206. }
  207. finally
  208. {
  209. _initializationLock.ExitWriteLock ();
  210. }
  211. return;
  212. static bool IsDefinedEnum (Type t) { return t is { IsEnum: true, IsGenericType: false, IsConstructedGenericType: false, IsTypeDefinition: true }; }
  213. static void AllEnumTypes_CollectionChanged (object? sender, NotifyCollectionChangedEventArgs e)
  214. {
  215. if (e.Action is not NotifyCollectionChangedAction.Add and not NotifyCollectionChangedAction.Replace || e.NewItems is null)
  216. {
  217. return;
  218. }
  219. foreach (Type enumType in e.NewItems.OfType<Type> ())
  220. {
  221. if (enumType.GetCustomAttribute<GenerateEnumExtensionMethodsAttribute> () is not { } generatorAttribute)
  222. {
  223. _boringEnumTypes.Add (enumType);
  224. continue;
  225. }
  226. _extendedEnumTypeMappings.AddOrUpdate (
  227. enumType,
  228. CreateNewEnumData,
  229. UpdateGeneratorAttributeProperty,
  230. generatorAttribute);
  231. }
  232. }
  233. static EnumData CreateNewEnumData (Type tEnum, GenerateEnumExtensionMethodsAttribute attr) { return new (tEnum, attr); }
  234. static EnumData UpdateGeneratorAttributeProperty (Type tEnum, EnumData data, GenerateEnumExtensionMethodsAttribute attr)
  235. {
  236. data.GeneratorAttribute ??= attr;
  237. return data;
  238. }
  239. static void EnumExtensionClasses_OnCollectionChanged (object? sender, NotifyCollectionChangedEventArgs e)
  240. {
  241. if (e.Action != NotifyCollectionChangedAction.Add)
  242. {
  243. return;
  244. }
  245. foreach (Type extensionClassType in e.NewItems!.OfType<Type> ())
  246. {
  247. if (extensionClassType.GetCustomAttribute (typeof (ExtensionsForEnumTypeAttribute<>), false) is not IExtensionsForEnumTypeAttributes
  248. {
  249. EnumType.IsEnum: true
  250. } extensionForAttribute)
  251. {
  252. continue;
  253. }
  254. _extendedEnumTypeMappings [extensionForAttribute.EnumType].ExtensionClass ??= extensionClassType;
  255. }
  256. }
  257. }
  258. public sealed record EnumData (
  259. Type EnumType,
  260. GenerateEnumExtensionMethodsAttribute? GeneratorAttribute = null,
  261. Type? ExtensionClass = null,
  262. IExtensionsForEnumTypeAttributes? ExtensionForEnumTypeAttribute = null)
  263. {
  264. public Type? ExtensionClass { get; set; } = ExtensionClass;
  265. public IExtensionsForEnumTypeAttributes? ExtensionForEnumTypeAttribute { get; set; } = ExtensionForEnumTypeAttribute;
  266. public GenerateEnumExtensionMethodsAttribute? GeneratorAttribute { get; set; } = GeneratorAttribute;
  267. }
  268. }