Merge pull request #165 from AArnott/CallerArgumentExpression

Use `[CallerArgumentExpression]` to simplify calling patterns into `Requires` class

Author: AArnott

src/Microsoft.VisualStudio.Validation/Assumes.cs

@@ -6,6 +6,7 @@
 using System.Diagnostics.CodeAnalysis;
 using System.Globalization;
 using System.Runtime;
+using System.Runtime.CompilerServices;
 
 namespace Microsoft;
 
@@ -128,7 +129,7 @@ public static void Is<T>([NotNull] object? value)
     /// </summary>
     [DebuggerStepThrough]
     [TargetedPatchingOptOut("Performance critical to inline across NGen image boundaries")]
-    public static void False([DoesNotReturnIf(true)] bool condition, [Localizable(false)] string? message = null)
+    public static void False([DoesNotReturnIf(true)] bool condition, [CallerArgumentExpression(nameof(condition)), Localizable(false)] string? message = null)
     {
         if (condition)
         {
@@ -167,7 +168,7 @@ public static void False([DoesNotReturnIf(true)] bool condition, [Localizable(fa
     /// </summary>
     [DebuggerStepThrough]
     [TargetedPatchingOptOut("Performance critical to inline across NGen image boundaries")]
-    public static void True([DoesNotReturnIf(false)] bool condition, [Localizable(false)] string? message = null)
+    public static void True([DoesNotReturnIf(false)] bool condition, [CallerArgumentExpression(nameof(condition)), Localizable(false)] string? message = null)
     {
         if (!condition)
         {

src/Microsoft.VisualStudio.Validation/Microsoft.VisualStudio.Validation.csproj

@@ -1,6 +1,6 @@
 <Project Sdk="Microsoft.NET.Sdk">
   <PropertyGroup>
-    <TargetFramework>netstandard2.0</TargetFramework>
+    <TargetFrameworks>netstandard2.0;net6.0</TargetFrameworks>
     <RootNamespace>Microsoft</RootNamespace>
 
     <Description>Common input validation and state verification utility methods.</Description>

src/Microsoft.VisualStudio.Validation/Polyfill.cs

@@ -0,0 +1,20 @@
+// Copyright (c) Microsoft. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+
+#if !NET5_0_OR_GREATER
+
+#pragma warning disable SA1649 // File name should match first type name
+#pragma warning disable SA1600 // Elements should be documented
+
+namespace System.Runtime.CompilerServices
+{
+    [AttributeUsage(AttributeTargets.Parameter, AllowMultiple = false, Inherited = false)]
+    internal sealed class CallerArgumentExpressionAttribute : Attribute
+    {
+        internal CallerArgumentExpressionAttribute(string parameterName)
+        {
+        }
+    }
+}
+
+#endif