From 0adc1ae78d56b52337d633f4a28ed6472a8f130b Mon Sep 17 00:00:00 2001
From: Lamparter <71598437+Lamparter@users.noreply.github.com>
Date: Sat, 1 Mar 2025 19:12:58 +0000
Subject: [PATCH] `UnsafeAttribute`

---
 .../UnsafeAttribute.cs                        | 41 +++++++++++++++++++
 1 file changed, 41 insertions(+)
 create mode 100644 src/extensions/Riverside.Extensions.Accountability/UnsafeAttribute.cs

diff --git a/src/extensions/Riverside.Extensions.Accountability/UnsafeAttribute.cs b/src/extensions/Riverside.Extensions.Accountability/UnsafeAttribute.cs
new file mode 100644
index 0000000..baaa1ab
--- /dev/null
+++ b/src/extensions/Riverside.Extensions.Accountability/UnsafeAttribute.cs
@@ -0,0 +1,41 @@
+using System.Reflection;
+
+namespace Riverside.Extensions.Accountability;
+
+/// <summary>
+/// Indicates that a method, constructor, property, or field is unsafe. This class cannot be inherited.
+/// </summary>
+/// <remarks>
+/// This may imply that a method should not be used, or that a method should be used with caution.
+/// </remarks>
+[AttributeUsage(AttributeTargets.Method | AttributeTargets.Constructor | AttributeTargets.Property | AttributeTargets.Field, Inherited = false)]
+public sealed class UnsafeAttribute : Attribute
+{
+    /// <summary>
+    /// Initializes a new instance of the <see cref="UnsafeAttribute"/> class.
+    /// </summary>
+    public UnsafeAttribute()
+    {
+    }
+
+    /// <summary>
+    /// Initializes a new instance of the <see cref="UnsafeAttribute"/> class with a specified reason.
+    /// </summary>
+    /// <param name="reason">The reason why the member is considered unsafe.</param>
+    public UnsafeAttribute(string reason)
+    {
+        Reason = reason;
+    }
+
+    /// <summary>
+    /// The reason why the member is considered unsafe.
+    /// </summary>
+    public string? Reason { get; }
+
+    /// <summary>
+    /// Determines whether the specified method is marked with the <see cref="UnsafeAttribute"/>.
+    /// </summary>
+    /// <param name="method">The method to check.</param>
+    /// <returns><c>true</c> if the method is marked with the <see cref="UnsafeAttribute"/>; otherwise, <c>false</c>.</returns>
+    public static bool IsUnsafe(MethodBase method) => method.GetCustomAttribute<UnsafeAttribute>() != null;
+}