Add public API for MonoMod switches with tests

Co-authored-by: pardeike <[email protected]>

Author: Copilot

Harmony/Public/Harmony.cs

@@ -333,5 +333,56 @@ public static MethodBase GetOriginalMethodFromStackframe(StackFrame frame)
 		///
 		public static Dictionary<string, Version> VersionInfo(out Version currentVersion)
 			=> PatchProcessor.VersionInfo(out currentVersion);
+
+		/// <summary>Sets a MonoMod switch value (e.g., "DMDDebug", "DMDDumpTo")</summary>
+		/// <param name="name">The switch name</param>
+		/// <param name="value">The value to set (bool, string, etc.)</param>
+		///
+		public static void SetSwitch(string name, object value)
+		{
+			var switchesType = AccessTools.TypeByName("MonoMod.Switches");
+			var method = AccessTools.Method(switchesType, "SetSwitchValue");
+			method.Invoke(null, [name, value]);
+		}
+
+		/// <summary>Clears a MonoMod switch value</summary>
+		/// <param name="name">The switch name</param>
+		///
+		public static void ClearSwitch(string name)
+		{
+			var switchesType = AccessTools.TypeByName("MonoMod.Switches");
+			var method = AccessTools.Method(switchesType, "ClearSwitchValue");
+			method.Invoke(null, [name]);
+		}
+
+		/// <summary>Tries to get a MonoMod switch value</summary>
+		/// <param name="name">The switch name</param>
+		/// <param name="value">The switch value if found</param>
+		/// <returns>True if the switch was found, false otherwise</returns>
+		///
+		public static bool TryGetSwitch(string name, out object value)
+		{
+			var switchesType = AccessTools.TypeByName("MonoMod.Switches");
+			var method = AccessTools.Method(switchesType, "TryGetSwitchValue");
+			var args = new object[] { name, null };
+			var result = (bool)method.Invoke(null, args);
+			value = args[1];
+			return result;
+		}
+
+		/// <summary>Tries to determine if a MonoMod switch is enabled</summary>
+		/// <param name="name">The switch name</param>
+		/// <param name="isEnabled">True if the switch is enabled, false otherwise</param>
+		/// <returns>True if the switch enablement state could be determined, false otherwise</returns>
+		///
+		public static bool TryIsSwitchEnabled(string name, out bool isEnabled)
+		{
+			var switchesType = AccessTools.TypeByName("MonoMod.Switches");
+			var method = AccessTools.Method(switchesType, "TryGetSwitchEnabled");
+			var args = new object[] { name, false };
+			var result = (bool)method.Invoke(null, args);
+			isEnabled = (bool)args[1];
+			return result;
+		}
 	}
 }

HarmonyTests/Tools/TestSwitches.cs

@@ -0,0 +1,71 @@
+using HarmonyLib;
+using NUnit.Framework;
+
+namespace HarmonyLibTests.Tools
+{
+	[TestFixture, NonParallelizable]
+	public class Test_Switches : TestLogger
+	{
+		[Test]
+		public void Test_SetAndGetSwitch()
+		{
+			Harmony.SetSwitch("DMDDebug", true);
+			var result = Harmony.TryGetSwitch("DMDDebug", out var value);
+			Assert.IsTrue(result);
+			Assert.IsTrue(value is bool);
+			Assert.IsTrue((bool)value);
+		}
+
+		[Test]
+		public void Test_SetAndGetStringSwitch()
+		{
+			var testPath = "Path\\To\\Dir\\Where\\Should\\Go";
+			Harmony.SetSwitch("DMDDumpTo", testPath);
+			var result = Harmony.TryGetSwitch("DMDDumpTo", out var value);
+			Assert.IsTrue(result);
+			Assert.IsTrue(value is string);
+			Assert.AreEqual(testPath, (string)value);
+		}
+
+		[Test]
+		public void Test_ClearSwitch()
+		{
+			Harmony.SetSwitch("DMDDebug", true);
+			var resultBefore = Harmony.TryGetSwitch("DMDDebug", out var valueBefore);
+			Assert.IsTrue(resultBefore);
+			Assert.IsNotNull(valueBefore);
+
+			Harmony.ClearSwitch("DMDDebug");
+			var resultAfter = Harmony.TryGetSwitch("DMDDebug", out var valueAfter);
+			Assert.IsFalse(resultAfter);
+		}
+
+		[Test]
+		public void Test_TryIsSwitchEnabled()
+		{
+			Harmony.SetSwitch("DMDDebug", true);
+			var result = Harmony.TryIsSwitchEnabled("DMDDebug", out var isEnabled);
+			Assert.IsTrue(result);
+			Assert.IsTrue(isEnabled);
+
+			Harmony.SetSwitch("DMDDebug", false);
+			result = Harmony.TryIsSwitchEnabled("DMDDebug", out isEnabled);
+			Assert.IsTrue(result);
+			Assert.IsFalse(isEnabled);
+		}
+
+		[Test]
+		public void Test_GetNonExistentSwitch()
+		{
+			var result = Harmony.TryGetSwitch("NonExistentSwitch", out var value);
+			Assert.IsFalse(result);
+		}
+
+		[Test]
+		public void Test_IsSwitchEnabledNonExistent()
+		{
+			var result = Harmony.TryIsSwitchEnabled("NonExistentSwitch", out var isEnabled);
+			Assert.IsFalse(result);
+		}
+	}
+}