Library project tweaks

Author: codeconscious

README.md

@@ -8,7 +8,7 @@ Additionally, your original audio files will be modified during selected operati
 
 ## Requirements
 
-- [.NET 9 runtime](https://dotnet.microsoft.com/en-us/download/dotnet/9.0)
+- [.NET 10 runtime](https://dotnet.microsoft.com/en-us/download/dotnet/10.0)
 - `settings.json` (See below)
 
 ## Running
@@ -36,24 +36,24 @@ dotnet run -- -r ~/Downloads/Audio/
 
 ## Flags
 
-| Flags | Description
+| Flags | Description |
 |---|---|
-| -v, --view | View full tag data.
-| -vs, --view-summary | View a summary of tag data.
-| -u, --update | Update tag data using filename patterns from the settings.
-| -u1, --update-single | Update a single tag in multiple files to a single, manually-specified value.
-| -ug, --update-genres | Update the genres in all files automatically using the CSV specified in the settings.
-| -um, --update-multiple | Update a single tag in multiple files with multiple values.
-| -uy, --update-year | Update the year using media files' own dates of creation. (Must do before other updates, lest the creation date be modified by those updates.)
-| -urt, --reverse-track-numbers | Reverse the track numbers of the given files.
-| -uea, --extract-artwork | Extracts artwork from directory files if they have the same artist and album, then deletes the artwork from the files containing it.
-| -ura, --remove-artwork | Removes artwork from files. (File size is not reduced, as padding remains.)
-| -rt, --rewrite-tags | Rewrites file tags. (Can be helping in reducing padding, such as from removed artwork.)
-| -r, --rename | Rename and reorganize files into folders based on tag data.
-| -d, --duplicates | List tracks with identical artists and titles. No files are modified or deleted.
-| -s, --stats | Display file statistics based on tag data.
-| -g, --genres | Save the primary genre for each artist to a genre file.
-| -p, --parse | Get a single tag value by parsing the data of another (generally Comments).
+| -v, --view | View full tag data. |
+| -vs, --view-summary | View a summary of tag data. |
+| -u, --update | Update tag data using filename patterns from the settings. |
+| -u1, --update-single | Update a single tag in multiple files to a single, manually-specified value. |
+| -ug, --update-genres | Update the genres in all files automatically using the CSV specified in the settings. |
+| -um, --update-multiple | Update a single tag in multiple files with multiple values. |
+| -uy, --update-year | Update the year using media files' own dates of creation. (Must do before other updates, lest the creation date be modified by those updates.) |
+| -urt, --reverse-track-numbers | Reverse the track numbers of the given files. |
+| -uea, --extract-artwork | Extracts artwork from directory files if they have the same artist and album, then deletes the artwork from the files containing it. |
+| -ura, --remove-artwork | Removes artwork from files. (File size is not reduced, as padding remains.) |
+| -rt, --rewrite-tags | Rewrites file tags. (Can be helping in reducing padding, such as from removed artwork.) |
+| -r, --rename | Rename and reorganize files into folders based on tag data. |
+| -d, --duplicates | List tracks with identical artists and titles. No files are modified or deleted. |
+| -s, --stats | Display file statistics based on tag data. |
+| -g, --genres | Save the primary genre for each artist to a genre file. |
+| -p, --parse | Get a single tag value by parsing the data of another (generally Comments). |
 
 Passing no arguments will also display these instructions.
 
@@ -72,7 +72,7 @@ A sample settings file, which can you copy and paste if you wish, follows:
       "(?:(?<albumArtists>.+) ≡ )?(?<album>.+?)(?: ?\\[(?<year>\\d{4})\\])? = (?<trackNo>\\d+) [–-] (?<artists>.+?) [–-] (?<title>.+)(?=\\.(?:m4a|opus))",
       "(?:(?<albumArtists>.+) ≡ )?(?<album>.+?)(?: ?\\[(?<year>\\d{4})\\])? = (?<trackNo>\\d{1,3}) [–-] (?<title>.+)(?=\\.(?:m4a|opus))",
       "(?:(?<albumArtists>.+) ≡ )(?<album>.+?)(?: ?\\[(?<year>\\d{4})\\])? = (?<artists>.+?) [–-] (?<title>.+)(?=\\.(?:m4a|opus))",
-      "(?:(?<albumArtists>.+) ≡ )?(?<album>.+?)(?: ?\\[(?<year>\\d{4})\\])? = (?<title>.+)(?=\\.(?:m4a|opus))",    ]
+      "(?:(?<albumArtists>.+) ≡ )?(?<album>.+?)(?: ?\\[(?<year>\\d{4})\\])? = (?<title>.+)(?=\\.(?:m4a|opus))" ]
   },
   "renaming": {
     "useAlbumDirectories": true,
@@ -99,7 +99,7 @@ A sample settings file, which can you copy and paste if you wish, follows:
     "exclusions": [
       { "artist": "Artist Name" },
       { "title": "Track Title" },
-      { "artist": "Artist Name", "title": "Track Title" },
+      { "artist": "Artist Name", "title": "Track Title" }
     ],
     "artistReplacements": [
       " ",
@@ -131,7 +131,7 @@ A sample settings file, which can you copy and paste if you wish, follows:
       ":",
       "："
     ]
-  },
+  }
 }
 ```
 

src/AudioTagger.Library/MediaFiles/MediaFileExtensionMethods.cs

@@ -2,39 +2,40 @@ namespace AudioTagger.Library.MediaFiles;
 
 public static class MediaFileExtensionMethods
 {
-    /// <summary>
-    /// Joins a collection into one string using a specified separator string.
-    /// </summary>
-    /// <param name="collection"></param>
-    /// <param name="separator"></param>
-    /// <returns>A joined string. Never returns null.</returns>
-    public static string Join(this IEnumerable<string> collection, string separator = "; ")
+    extension(IEnumerable<string> first)
     {
-        return string.Join(separator, collection);
-    }
+        /// <summary>
+        /// Joins a collection into one string using a specified separator string.
+        /// </summary>
+        /// <param name="separator"></param>
+        /// <returns>A joined string. Never returns null.</returns>
+        public string Join(string separator = "; ")
+        {
+            return string.Join(separator, first);
+        }
 
-    /// <summary>
-    /// Joins two collections into one formatted string. If their contents differ, then both will be included
-    /// with the second collection placed within parentheses after the first collection.
-    /// </summary>
-    /// <param name="first">This collection is given priority.</param>
-    /// <param name="second">This collection will not be added if it is identical to the primary one.</param>
-    /// <param name="separator">Applies to each collection separately.</param>
-    /// <returns>A combined string. Never returns null. Example: "first1; first2 (second1; second2)"</returns>
-    public static string JoinWith(this IEnumerable<string> first, IEnumerable<string> second, string separator = "; ")
-    {
-        string Joiner(IEnumerable<string> collection) => string.Join(separator, collection);
+        /// <summary>
+        /// Joins two collections into one formatted string. If their contents differ, then both will be included
+        /// with the second collection placed within parentheses after the first collection.
+        /// </summary>
+        /// <param name="second">This collection will not be added if it is identical to the primary one.</param>
+        /// <param name="separator">Applies to each collection separately.</param>
+        /// <returns>A combined string. Never returns null. Example: "first1; first2 (second1; second2)"</returns>
+        public string JoinWith(IEnumerable<string> second, string separator = "; ")
+        {
+            string Joiner(IEnumerable<string> collection1) => string.Join(separator, collection1);
 
-        if (first?.Any() != true)
-            return Joiner(second);
+            if (!first.Any())
+                return Joiner(second);
 
-        if (second?.Any() != true)
-            return Joiner(first);
+            if (!second.Any())
+                return Joiner(first);
 
-        if (first.Count() != second.Count())
-            return $"{Joiner(first)} ({Joiner(second)})";
+            if (first.Count() != second.Count())
+                return $"{Joiner(first)} ({Joiner(second)})";
 
-        return Joiner(first); // Identical collections of equal length, so only print the first.
+            return Joiner(first); // Identical collections of equal length, so only print the first.
+        }
     }
 
     /// <summary>

src/AudioTagger.Library/UpdatableFields.cs

@@ -20,7 +20,6 @@ public sealed class UpdatableFields
     /// Constructor that reads matched regex group names and
     /// maps the data to the correct tag name property.
     /// </summary>
-    /// <param name="matchedGroups"></param>
     public UpdatableFields(
         IEnumerable<Group> matchedGroups,
         IDictionary<string, string> artistsWithGenres)