docs(readme): update version to 0.2.24 and modify command line options description

refactor(XMLDiff, XMLPatch): enable ignoring unknown arguments and improve help output
refactor(XMLDiff): --only-full-path option replaced by --anywhere-is-allowed. And default behavior is to use full path.

Author: chemodun

README.md

@@ -23,7 +23,7 @@ If the `diff.xsd` file if it located in the "current" folder it will be used aut
 There is a command line help for the `XMLDiff` tool:
 
 ```shell
-XMLDiff 0.2.18
+XMLDiff 0.2.24
 Developed by Chem O`Dun
 
   -o, --original_xml      Required. Path to the original XML file or directory.
@@ -38,7 +38,7 @@ Developed by Chem O`Dun
 
   -a, --append-to-log     (Default: false) Append logs to the existing log file.
 
-  --only-full-path        (Default: false) Generate only full path.
+  --anywhere-is-allowed   (Default: false) Generate a path using the anywhere '//' construction, if possible. Instead of full path.
 
   --use-all-attributes    (Default: false) Use all attributes in XPath.
 
@@ -278,7 +278,9 @@ Please be aware - each release archive has an appropriate link to the [VirusTota
   - XMLDiff: XPath generation when the element has child elements, which can unique identify it.
 
 - Changed:
+  - XMLDiff: --only-full-path option replaced by --anywhere-is-allowed. And default behavior is to use full path.
   - Both utilities: log level of console will not be more detailed than for the log file.
+  - Both utilities: the unknown options will be ignored.
 
 - Fixed:
   - XMLDiff: doubling the first attribute in XPath for the elements, if more than one attribute is used.

XMLDiff/Program.cs

@@ -16,8 +16,18 @@ class XMLDiff
 
     static void Main(string[] args)
     {
-      Parser
-        .Default.ParseArguments<Options>(args)
+      if (args.Length == 0)
+        args = new[] { "--help" };
+      var parser = new Parser(config =>
+      {
+        config.IgnoreUnknownArguments = true; // Enable ignoring unknown arguments
+        config.AutoHelp = true; // Enable auto help
+        config.AutoVersion = true; // Enable auto version
+        config.CaseSensitive = true; // Enable case sensitivity
+        config.HelpWriter = Console.Out; // Set HelpWriter to Console.Out
+      });
+      parser
+        .ParseArguments<Options>(args)
         .WithParsed<Options>(opts => RunOptionsAndReturnExitCode(opts))
         .WithNotParsed<Options>((errs) => HandleParseError(errs));
     }
@@ -39,7 +49,7 @@ private static void RunOptionsAndReturnExitCode(Options opts)
       var modifiedXmlPath = opts.ModifiedXml;
       var diffXmlPath = opts.DiffXml;
       var diffXsdPath = opts.Xsd ?? "diff.xsd";
-      var pathOptions = new PathOptions { OnlyFullPath = opts.OnlyFullPath, UseAllAttributes = opts.UseAllAttributes };
+      var pathOptions = new PathOptions { AnywhereIsAllowed = opts.AnywhereIsAllowed, UseAllAttributes = opts.UseAllAttributes };
 
       bool originalIsDir = Directory.Exists(originalXmlPath);
       bool modifiedIsDir = Directory.Exists(modifiedXmlPath);
@@ -90,7 +100,7 @@ public class Options
       private string? diffXml;
       private string? xsd;
       private string? logToFile;
-      private bool onlyFullPath;
+      private bool anywhereIsAllowed;
       private bool useAllAttributes;
       private bool appendToLog;
 
@@ -145,11 +155,16 @@ public bool AppendToLog
         set => appendToLog = value;
       }
 
-      [Option("only-full-path", Required = false, HelpText = "Generate only full path.", Default = false)]
-      public bool OnlyFullPath
+      [Option(
+        "anywhere-is-allowed",
+        Required = false,
+        HelpText = "Generate a path using the anywhere '//' construction, if possible. Instead of full path.",
+        Default = false
+      )]
+      public bool AnywhereIsAllowed
       {
-        get => onlyFullPath;
-        set => onlyFullPath = value;
+        get => anywhereIsAllowed;
+        set => anywhereIsAllowed = value;
       }
 
       [Option("use-all-attributes", Required = false, HelpText = "Use all attributes in XPath.", Default = false)]
@@ -870,7 +885,7 @@ private static string GenerateXPath(XElement element, PathOptions pathOptions)
       if (root == null)
         return string.Empty;
       XDocument? doc = null;
-      if (!pathOptions.OnlyFullPath)
+      if (pathOptions.AnywhereIsAllowed)
       {
         doc = element.Document;
       }
@@ -1057,7 +1072,7 @@ private static bool ValidateXsdPath(string? xsdPath)
 
   public class PathOptions
   {
-    public bool OnlyFullPath { get; set; }
+    public bool AnywhereIsAllowed { get; set; }
     public bool UseAllAttributes { get; set; }
   }
 }

XMLPatch/Program.cs

@@ -18,8 +18,18 @@ class XMLPatch
     static void Main(string[] args)
     {
       var program = new XMLPatch();
-      Parser
-        .Default.ParseArguments<Options>(args)
+      if (args.Length == 0)
+        args = new[] { "--help" };
+      var parser = new Parser(config =>
+      {
+        config.IgnoreUnknownArguments = true; // Enable ignoring unknown arguments
+        config.AutoHelp = true; // Enable auto help
+        config.AutoVersion = true; // Enable auto version
+        config.CaseSensitive = true; // Enable case sensitivity
+        config.HelpWriter = Console.Out; // Set HelpWriter to Console.Out
+      });
+      parser
+        .ParseArguments<Options>(args)
         .WithParsed<Options>(opts => program.RunOptionsAndReturnExitCode(opts))
         .WithNotParsed<Options>((errs) => HandleParseError(errs));
     }