Comic Rework (Part 1) (#2772)

API/Services/Tasks/Scanner/Parser/Parser.cs

@@ -106,6 +106,12 @@ public static class Parser
     private static readonly Regex NormalizeRegex = new Regex(@"[^\p{L}0-9\+!]",
         MatchOptions, RegexTimeout);
 
+    /// <summary>
+    /// Supports Batman (2020) or Batman (2)
+    /// </summary>
+    private static readonly Regex SeriesAndYearRegex = new Regex(@"^\D+\s\((?<Year>\d+)\)$",
+        MatchOptions, RegexTimeout);
+
     /// <summary>
     /// Recognizes the Special token only
     /// </summary>
@@ -698,8 +704,9 @@ public static class Parser
         return  MangaSpecialRegex.IsMatch(filePath);
     }
 
-    public static bool IsComicSpecial(string filePath)
+    public static bool IsComicSpecial(string? filePath)
     {
+        if (string.IsNullOrEmpty(filePath)) return false;
         filePath = ReplaceUnderscores(filePath);
         return ComicSpecialRegex.IsMatch(filePath);
     }
@@ -1125,13 +1132,32 @@ public static class Parser
 
             // NOTE: This is failing for //localhost:5000/api/book/29919/book-resources?file=OPS/images/tick1.jpg
             var importFile = match.Groups["Filename"].Value;
-            if (!importFile.Contains("?")) return importFile;
+            if (!importFile.Contains('?')) return importFile;
         }
 
         return null;
     }
 
-    public static string RemoveExtensionIfSupported(string? filename)
+    /// <summary>
+    /// If the name matches exactly Series (Volume digits)
+    /// </summary>
+    /// <param name="name"></param>
+    /// <returns></returns>
+    public static bool IsSeriesAndYear(string? name)
+    {
+        return !string.IsNullOrEmpty(name) && SeriesAndYearRegex.IsMatch(name);
+    }
+
+    public static string ParseYear(string? name)
+    {
+        if (string.IsNullOrEmpty(name)) return string.Empty;
+        var match = SeriesAndYearRegex.Match(name);
+        if (!match.Success) return string.Empty;
+
+        return match.Groups["Year"].Value;
+    }
+
+    public static string? RemoveExtensionIfSupported(string? filename)
     {
         if (string.IsNullOrEmpty(filename)) return filename;