Merge pull request #52 from Sergio0694/dev/requires-dynamic-code

Add [RequiresDynamicCode] polyfill

README.md

@@ -57,6 +57,7 @@ It also includes the following optional runtime-supported polyfills:
   - `[DynamicallyAccessedMembers]`
   - `[DynamicDependency]`
   - `[RequiresUnreferencedCode]`
+  - `[RequiresDynamicCode]`
   - `[UnconditionalSuppressMessage]`
 - `[StackTraceHidden]` (see [here](https://makolyte.com/csharp-exclude-exception-throw-helper-methods-from-the-stack-trace/))
 - `[UnmanagedCallersOnly]` (see [docs](https://learn.microsoft.com/dotnet/api/system.runtime.interopservices.unmanagedcallersonlyattribute)))

src/PolySharp.Package/README.md

@@ -55,6 +55,7 @@ It also includes the following optional runtime-supported polyfills:
   - `[DynamicallyAccessedMembers]`
   - `[DynamicDependency]`
   - `[RequiresUnreferencedCode]`
+  - `[RequiresDynamicCode]`
   - `[UnconditionalSuppressMessage]`
 - `[StackTraceHidden]` (see [here](https://makolyte.com/csharp-exclude-exception-throw-helper-methods-from-the-stack-trace/))
 - `[UnmanagedCallersOnly]` (see [docs](https://learn.microsoft.com/dotnet/api/system.runtime.interopservices.unmanagedcallersonlyattribute)))

src/PolySharp.SourceGenerators/EmbeddedResources/RuntimeSupported/System.Diagnostics.CodeAnalysis.RequiresDynamicCodeAttribute.cs

@@ -0,0 +1,47 @@
+// <auto-generated/>
+#pragma warning disable
+#nullable enable annotations
+
+// Licensed to the .NET Foundation under one or more agreements.
+// The .NET Foundation licenses this file to you under the MIT license.
+
+namespace System.Diagnostics.CodeAnalysis
+{
+    /// <summary>
+    /// Indicates that the specified method requires the ability to generate new code at runtime,
+    /// for example through <see cref="global::System.Reflection"/>.
+    /// </summary>
+    /// <remarks>
+    /// This allows tools to understand which methods are unsafe to call when compiling ahead of time.
+    /// </remarks>
+    [global::System.AttributeUsage(
+        global::System.AttributeTargets.Method |
+        global::System.AttributeTargets.Constructor |
+        global::System.AttributeTargets.Class,
+        Inherited = false)]
+    internal sealed class RequiresDynamicCodeAttribute : global::System.Attribute
+    {
+        /// <summary>
+        /// Initializes a new instance of the <see cref="global::System.Diagnostics.CodeAnalysis.RequiresDynamicCodeAttribute"/> class
+        /// with the specified message.
+        /// </summary>
+        /// <param name="message">
+        /// A message that contains information about the usage of dynamic code.
+        /// </param>
+        public RequiresDynamicCodeAttribute(string message)
+        {
+            Message = message;
+        }
+
+        /// <summary>
+        /// Gets a message that contains information about the usage of dynamic code.
+        /// </summary>
+        public string Message { get; }
+
+        /// <summary>
+        /// Gets or sets an optional URL that contains more information about the method,
+        /// why it requires dynamic code, and what options a consumer has to deal with it.
+        /// </summary>
+        public string? Url { get; set; }
+    }
+}

tests/PolySharp.Tests/RuntimeSupport.cs

@@ -71,4 +71,9 @@ public void SuppressEverything(Type type)
     {
         _ = type.GetProperties();
     }
+
+    [RequiresDynamicCode("This method creates some type at runtime")]
+    public void MakeUpSomeNewType()
+    {
+    }
 }