v1.0.2 is out - Release Notes are wrong

Author: mf366-dev

.editorconfig

@@ -0,0 +1,4 @@
+[*.{cs,vb}]
+
+# IDE0028: Simplify collection initialization
+dotnet_diagnostic.IDE0028.severity = none

RSML.CLI/Program.cs

@@ -103,12 +103,18 @@ static async Task Main(string[] args)
 				description: "Fallback for error scenarios",
 				getDefaultValue: () => null
 			);
+			var customRidOption = new Option<string?>(
+				aliases: ["--custom-rid", "-r", "--rid"],
+				description: "Custom RID to check against",
+				getDefaultValue: () => null
+			);
 
 			evaluateCommand.AddOption(printOnlyPrimaryOption);
+			evaluateCommand.AddOption(customRidOption);
 			evaluateCommand.AddOption(fallbackForErrorOption);
 			evaluateCommand.AddOption(fallbackForNullOption);
 
-			evaluateCommand.SetHandler(void (primaryOnly, nullFallback, errorFallback) =>
+			evaluateCommand.SetHandler(void (primaryOnly, nullFallback, errorFallback, customRid) =>
 			{
 
 				string? currentInState = Console.In.ReadToEnd();
@@ -143,7 +149,9 @@ static async Task Main(string[] args)
 				try
 				{
 
-					Console.WriteLine(document.EvaluateDocument() ?? ((nullFallback ?? "") == "" ? "[WARNING] No match was found." : nullFallback!));
+					Console.WriteLine(customRid is null
+						? document.EvaluateDocument() ?? ((nullFallback ?? "") == "" ? "[WARNING] No match was found." : nullFallback!)
+						: document.EvaluateDocument(customRid, null) ?? ((nullFallback ?? "") == "" ? "[WARNING] No match was found." : nullFallback!));
 
 				}
 				catch (RSMLRuntimeException ex)
@@ -156,7 +164,7 @@ static async Task Main(string[] args)
 
 				Environment.Exit(0);
 
-			}, printOnlyPrimaryOption, fallbackForNullOption, fallbackForErrorOption);
+			}, printOnlyPrimaryOption, fallbackForNullOption, fallbackForErrorOption, customRidOption);
 
 			evaluateCommand.AddAlias("eval");
 			evaluateCommand.AddAlias("parse");

RSML/Parser/RSParser.cs

@@ -217,12 +217,80 @@ protected byte HandleSpecialFunctionCall(string line)
 
 		}
 
+		/// <summary>
+		/// Handles a RSML action, using a custom RID.
+		/// </summary>
+		/// <param name="line">The RSML line</param>
+		/// <param name="operatorType">The operator (primary, secondary or tertiary - all of them must be defined)</param>
+		/// <param name="customRid">A custom RID to use as system identifier</param>
+		/// <returns>Null if there was no match or the return value/argument as a string (even if the action was not primary).</returns>
+		/// <exception cref="UndefinedActionException">At least one action is undefined.</exception>
+		protected string? HandleAction(string line, OperatorType operatorType, string customRid)
+		{
+
+			if (secondaryAction is null || tertiaryAction is null)
+			{
+
+				throw new UndefinedActionException("All actions must be defined for them to be handled, even if only primary ones are used.");
+
+			}
+
+			// split the line
+			string[] splitLine = line.Split(operatorType == OperatorType.Primary ?
+											primaryActionDelimiter : (operatorType == OperatorType.Secondary) ?
+											secondaryActionDelimiter : tertiaryActionDelimiter);
+
+			// not enough tokens, fuckersss
+			if (splitLine.Length < 2) return null; // ignore it like a comment
+
+			// get system name
+			string systemName = splitLine[0].Trim();
+
+			// quick evaluation
+			if (!Regex.IsMatch(customRid, $"^{systemName}$")) return null;
+
+			string returnValue = splitLine[1].Trim();
+
+			if (returnValue.Length < 3 || !(returnValue.StartsWith('"') && returnValue.EndsWith('"'))) // the quotes and the characters inside of it
+			{
+
+				return null; // commenttttttttt
+
+			}
+
+			string trimmedArgument = returnValue[1..^1];
+
+			switch (operatorType)
+			{
+
+				case OperatorType.Secondary:
+					secondaryAction.Invoke(this, trimmedArgument);
+					break;
+
+				case OperatorType.Tertiary:
+					tertiaryAction.Invoke(this, trimmedArgument);
+					break;
+
+			}
+
+			return trimmedArgument; // ignore the quotes
+
+		}
+
+		/// <summary>
+		/// Evaluate RSML.
+		/// </summary>
+		/// <param name="linesepChar">The line separation string to use (defaults to system line separation)</param>
+		/// <returns>The evaluated result (only for primary action; if there's a secondary/tertiary match, it's ignored) or null (no primary matches)</returns>
+		public string? EvaluateRSML(string? linesepChar = null) => EvaluateRSMLWithCustomRid(RuntimeInformation.RuntimeIdentifier, linesepChar);
+
 		/// <summary>
 		/// Evaluate RSML.
 		/// </summary>
+		/// <param name="customRid">A custom RID to check against</param>
 		/// <param name="linesepChar">The line separation string to use (defaults to system line separation)</param>
 		/// <returns>The evaluated result (only for primary action; if there's a secondary/tertiary match, it's ignored) or null (no primary matches)</returns>
-		public string? EvaluateRSML(string? linesepChar = null)
+		public string? EvaluateRSMLWithCustomRid(string customRid, string? linesepChar = null)
 		{
 
 			foreach (string line in content.Split(linesepChar ?? Environment.NewLine))
@@ -260,7 +328,7 @@ protected byte HandleSpecialFunctionCall(string line)
 				else if (line.Contains(primaryActionDelimiter))
 				{
 
-					string? actionReturnValue = HandleAction(line);
+					string? actionReturnValue = HandleAction(line, OperatorType.Primary, customRid);
 
 					if (actionReturnValue is not null)
 					{
@@ -270,20 +338,24 @@ protected byte HandleSpecialFunctionCall(string line)
 					}
 
 				}
+
 #pragma warning disable IDE0058 // expression value unused
 				else if (line.Contains(secondaryActionDelimiter))
 				{
 
-					HandleAction(line, OperatorType.Secondary);
+					HandleAction(line, OperatorType.Secondary, customRid);
 
 				}
+
 				else if (line.Contains(tertiaryActionDelimiter))
 				{
 
-					HandleAction(line, OperatorType.Tertiary);
+					HandleAction(line, OperatorType.Tertiary, customRid);
 
 				}
+
 #pragma warning restore
+
 				else continue;
 
 			}

RSML/RSDocument.cs

@@ -80,6 +80,14 @@ public static RSDocument NewFromFile(string filepath)
 		/// <returns>Null if no priamry matches or a string matching the return value of the only primary match</returns>
 		public string? EvaluateDocument(string lineSeparation) => parser.EvaluateRSML(lineSeparation);
 
+		/// <summary>
+		/// Parses and evaluates the document.
+		/// </summary>
+		/// <param name="customRid">The custom RID to check against</param>
+		/// <param name="lineSeparation">The custom line separation character to use</param>
+		/// <returns>Null if no priamry matches or a string matching the return value of the only primary match</returns>
+		public string? EvaluateDocument(string customRid, string? lineSeparation = null) => parser.EvaluateRSMLWithCustomRid(customRid, lineSeparation);
+
 	}
 
 }

RSML/RSML.csproj

@@ -18,25 +18,31 @@
 		<PackageTags>Markup;Crossroad</PackageTags>
 		<PackageLicenseFile>LICENSE</PackageLicenseFile>
 		<PackageRequireLicenseAcceptance>True</PackageRequireLicenseAcceptance>
-		<Version>1.0.1</Version>
-		<FileVersion>1.0.0.2</FileVersion>
+		<Version>1.0.2</Version>
+		<FileVersion>1.0.0.3</FileVersion>
 		<InformationalVersion>$(Version)</InformationalVersion>
 
 		<!-- no source revision thank you -->
 		<SourceRevisionId></SourceRevisionId>
 		<Platforms>AnyCPU;x64;x86</Platforms>
+		<PackageReleaseNotes>
+			v1.0.3 added support for rid emulation.
+			From an OS, you may emulate the evaluation of RSML as if you were doing it from another.
+
+			In CLI: RSML.CLI evaluate --custom-rid
+		</PackageReleaseNotes>
 	</PropertyGroup>
 
 	<PropertyGroup Condition="'$(Configuration)|$(Platform)'=='Release|AnyCPU'">
 		<DebugType>none</DebugType>
 	</PropertyGroup>
 
 	<PropertyGroup Condition="'$(Configuration)|$(Platform)'=='Release|x86'">
-	  <DebugType>none</DebugType>
+		<DebugType>none</DebugType>
 	</PropertyGroup>
 
 	<PropertyGroup Condition="'$(Configuration)|$(Platform)'=='Release|x64'">
-	  <DebugType>none</DebugType>
+		<DebugType>none</DebugType>
 	</PropertyGroup>
 
 	<ItemGroup>

RedSeaMarkupLanguage.sln

@@ -9,6 +9,11 @@ Project("{F184B08F-C81C-45F6-A57F-5ABD9991F28F}") = "RSML.Docs", "RSML.Docs\RSML
 EndProject
 Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "RSML.CLI", "RSML.CLI\RSML.CLI.csproj", "{F365A776-5802-42A8-BF46-0A5046421B31}"
 EndProject
+Project("{2150E333-8FDC-42A3-9474-1A3956D46DE8}") = "Solution Items", "Solution Items", "{089100B1-113F-4E66-888A-E83F3999EAFD}"
+	ProjectSection(SolutionItems) = preProject
+		.editorconfig = .editorconfig
+	EndProjectSection
+EndProject
 Global
 	GlobalSection(SolutionConfigurationPlatforms) = preSolution
 		Debug|Any CPU = Debug|Any CPU