KnownReference: Add support for testing for referenced libraries

analyzers/src/SonarAnalyzer.Common/Helpers/CompilationExtensions.cs

@@ -31,5 +31,8 @@ public static class CompilationExtensions
             // There's no direct way of checking compilation target framework yet (09/2020).
             // See https://github.com/dotnet/roslyn/issues/3798
             compilation.ObjectType.ContainingAssembly.Name == "mscorlib";
+
+        public static bool References(this Compilation compilation, KnownReference reference)
+            => reference.IsReferencedBy(compilation);
     }
 }

analyzers/src/SonarAnalyzer.Common/Helpers/KnownReference.Predicates.cs

@@ -0,0 +1,74 @@
+/*
+ * SonarAnalyzer for .NET
+ * Copyright (C) 2015-2023 SonarSource SA
+ * mailto: contact AT sonarsource DOT com
+ *
+ * This program is free software; you can redistribute it and/or
+ * modify it under the terms of the GNU Lesser General Public
+ * License as published by the Free Software Foundation; either
+ * version 3 of the License, or (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
+ * Lesser General Public License for more details.
+ *
+ * You should have received a copy of the GNU Lesser General Public License
+ * along with this program; if not, write to the Free Software Foundation,
+ * Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301, USA.
+ */
+
+namespace SonarAnalyzer.Helpers;
+
+public sealed partial class KnownReference
+{
+    internal static Func<AssemblyIdentity, bool> NameIs(string name) =>
+        x => x.Name.Equals(name);
+
+    internal static Func<AssemblyIdentity, bool> StartsWith(string name) =>
+        x => x.Name.StartsWith(name);
+
+    internal static Func<AssemblyIdentity, bool> EndsWith(string name) =>
+        x => x.Name.EndsWith(name);
+
+    internal static Func<AssemblyIdentity, bool> Contains(string name) =>
+        x => x.Name.Contains(name);
+
+    internal static Func<AssemblyIdentity, bool> VersionLowerThen(string version) =>
+        VersionLowerThen(Version.Parse(version));
+
+    internal static Func<AssemblyIdentity, bool> VersionLowerThen(Version version) =>
+        x => x.Version < version;
+
+    internal static Func<AssemblyIdentity, bool> VersionGreaterOrEqual(string version) =>
+        VersionGreaterOrEqual(Version.Parse(version));
+
+    internal static Func<AssemblyIdentity, bool> VersionGreaterOrEqual(Version version) =>
+        x => x.Version >= version;
+
+    internal static Func<AssemblyIdentity, bool> VersionBetween(string from, string to) =>
+        VersionBetween(Version.Parse(from), Version.Parse(to));
+
+    internal static Func<AssemblyIdentity, bool> VersionBetween(Version from, Version to) =>
+        x => x.Version >= from && x.Version <= to;
+
+    internal static Func<AssemblyIdentity, bool> OptionalPublicKeyTokenIs(string key) =>
+        x => !x.HasPublicKey || PublicKeyEqualHex(x, key);
+
+    internal static Func<AssemblyIdentity, bool> PublicKeyTokenIs(string key) =>
+        x => x.HasPublicKey && PublicKeyEqualHex(x, key);
+
+    private static bool PublicKeyEqualHex(AssemblyIdentity identity, string hexString)
+    {
+        var normalizedHexString = hexString.Replace("-", string.Empty);
+        return ArraysEqual(identity.PublicKeyToken.ToArray(), normalizedHexString) || ArraysEqual(identity.PublicKey.ToArray(), normalizedHexString);
+
+        static bool ArraysEqual(byte[] key, string hexString) =>
+            BitConverter.ToString(key).Replace("-", string.Empty).Equals(hexString, StringComparison.OrdinalIgnoreCase);
+    }
+
+    internal static Func<IEnumerable<AssemblyIdentity>, bool> Any(Func<AssemblyIdentity, bool> predicate) =>
+        predicate is null
+            ? throw new ArgumentNullException(nameof(predicate))
+            : identities => identities.Any(predicate);
+}

analyzers/src/SonarAnalyzer.Common/Helpers/KnownReference.cs

@@ -0,0 +1,41 @@
+/*
+ * SonarAnalyzer for .NET
+ * Copyright (C) 2015-2023 SonarSource SA
+ * mailto: contact AT sonarsource DOT com
+ *
+ * This program is free software; you can redistribute it and/or
+ * modify it under the terms of the GNU Lesser General Public
+ * License as published by the Free Software Foundation; either
+ * version 3 of the License, or (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
+ * Lesser General Public License for more details.
+ *
+ * You should have received a copy of the GNU Lesser General Public License
+ * along with this program; if not, write to the Free Software Foundation,
+ * Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301, USA.
+ */
+
+namespace SonarAnalyzer.Helpers
+{
+    public sealed partial class KnownReference
+    {
+        private readonly Func<IEnumerable<AssemblyIdentity>, bool> predicate;
+
+        internal KnownReference(Func<AssemblyIdentity, bool> predicate) : this(Any(predicate))
+        {
+        }
+
+        internal KnownReference(Func<IEnumerable<AssemblyIdentity>, bool> predicate)
+        {
+            this.predicate = predicate ?? throw new ArgumentNullException(nameof(predicate));
+        }
+
+        public static KnownReference XUnit_Assert { get; } = new(NameIs("xunit.assert").Or(NameIs("xunit").And(VersionLowerThen("2.0"))));
+
+        public bool IsReferencedBy(Compilation compilation) =>
+            predicate(compilation.ReferencedAssemblyNames);
+    }
+}

analyzers/src/SonarAnalyzer.Common/Helpers/KnownReferenceExtensions.cs

@@ -0,0 +1,30 @@
+/*
+ * SonarAnalyzer for .NET
+ * Copyright (C) 2015-2023 SonarSource SA
+ * mailto: contact AT sonarsource DOT com
+ *
+ * This program is free software; you can redistribute it and/or
+ * modify it under the terms of the GNU Lesser General Public
+ * License as published by the Free Software Foundation; either
+ * version 3 of the License, or (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
+ * Lesser General Public License for more details.
+ *
+ * You should have received a copy of the GNU Lesser General Public License
+ * along with this program; if not, write to the Free Software Foundation,
+ * Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301, USA.
+ */
+
+namespace SonarAnalyzer.Helpers;
+
+internal static class KnownReferenceExtensions
+{
+    internal static Func<AssemblyIdentity, bool> And(this Func<AssemblyIdentity, bool> @this, Func<AssemblyIdentity, bool> predicate)
+        => identity => @this(identity) && predicate(identity);
+
+    internal static Func<AssemblyIdentity, bool> Or(this Func<AssemblyIdentity, bool> @this, Func<AssemblyIdentity, bool> predicate)
+        => identity => @this(identity) || predicate(identity);
+}