* Adding the ability to clear cache

* Fixing defect with upload utils not working with parallel files
* Adding download util
* Edits to rate limits
  * Adding events
  * Adding pagination downloader
* Adding default verb for utils

Author: holycardboard

src/MangaDexSharp.Cli/Verbs/UploadVerb.cs

@@ -38,14 +38,16 @@ public override async Task<bool> Execute(UploadVerbOptions options, Cancellation
 
         _logger.LogInformation("Session ID: {id}", session.SessionId);
 
-        foreach (var file in files)
-        {
-            await session.UploadFile(file);
-        }
+        await Task.WhenAll(files.Select(t => session.UploadFile(t)));
+
+        //foreach (var file in files)
+        //{
+        //    await session.UploadFile(file);
+        //}
 
         var chapter = await session.Commit(new ChapterDraft
         {
-            Chapter = "1337",
+            Chapter = "1338",
             Title = "Automated Test Chapter - MDSharp",
             TranslatedLanguage = "en",
             Volume = "69"

src/MangaDexSharp.Utilities.Cli/AuthOptions.cs

@@ -3,17 +3,22 @@
 public class AuthOptions
 {
     [Option('a', "access-token", HelpText = "Your account access token, if you have one. (You can get this from your browser's dev tools.)")]
+    [Secret]
     public string? AccessToken { get; set; }
 
     [Option('c', "client-id", HelpText = "The client ID to use for the request. (You can get this from: https://mangadex.org/settings > API Clients)")]
+    [Secret]
     public string? ClientId { get; set; }
 
     [Option('s', "client-secret", HelpText = "The client secret to use for the request. (You can get this from: https://mangadex.org/settings > API Clients)")]
+    [Secret]
     public string? ClientSecret { get; set; }
 
     [Option('u', "username", HelpText = "The username of your MangaDex account.")]
+    [Secret]
     public string? Username { get; set; }
 
     [Option('p', "password", HelpText = "The password of your MangaDex account.")]
+    [Secret]
     public string? Password { get; set; }
 }

src/MangaDexSharp.Utilities.Cli/Extensions.cs

@@ -1,7 +1,22 @@
-namespace MangaDexSharp.Utilities.Cli;
+using Spectre.Console;
+
+namespace MangaDexSharp.Utilities.Cli;
 
 public static class Extensions
 {
+    public static string Trim(this string text, int maxLength, string replacer = "...")
+    {
+        if (text.Length > maxLength)
+            return text[..(maxLength - replacer.Length)] + replacer;
+        return text;
+    }
+
+    public static string Escape(this string text, int buffer = 5)
+    {
+        var maxLength = Console.WindowWidth - buffer;
+        return Markup.Escape(text.Trim(maxLength));
+    }
+
     public static IEnumerable<T[]> Batch<T>(this IEnumerable<T> input, int size)
     {
         var batch = new List<T>(size);
@@ -18,4 +33,21 @@ public static IEnumerable<T[]> Batch<T>(this IEnumerable<T> input, int size)
 
         yield return batch.ToArray();
     }
+
+    public static T ConsoleSelect<T>(this IEnumerable<T> items, string? prompt = null, Func<T, string>? display = null)
+        where T : notnull
+    {
+        if (items is null || !items.Any()) throw new NullReferenceException("Items cannot be null or empty.");
+
+        prompt = Escape(prompt ?? $"Please select a {typeof(T).Name}:");
+        display ??= item => item?.ToString() ?? string.Empty;
+
+        var select = new SelectionPrompt<T>()
+            .Title(prompt)
+            .PageSize(Console.WindowHeight - 5)
+            .MoreChoicesText("[grey](Move up and down to reveal more choices)[/]")
+            .UseConverter(t => display(t))
+            .AddChoices(items);
+        return AnsiConsole.Prompt(select);
+    }
 }

src/MangaDexSharp.Utilities.Cli/MangaDexSharp.Utilities.Cli.csproj

@@ -13,6 +13,7 @@
 		<PackageReference Include="CsvHelper" Version="33.0.1" />
 		<PackageReference Include="Serilog.Extensions.Logging" Version="8.0.0" />
 		<PackageReference Include="Serilog.Sinks.Console" Version="6.0.0" />
+		<PackageReference Include="Spectre.Console" Version="0.50.0" />
 	</ItemGroup>
 
 	<ItemGroup>

src/MangaDexSharp.Utilities.Cli/Program.cs

@@ -12,5 +12,8 @@
     .AddTransient<IExportReadListService, ExportReadListService>()
     .Cli(args, c =>
     {
-        c.Add<ExportReadListVerb>();
+        c.Add<ExportReadListVerb>()
+         .Add<CheckAuthVerb>()
+         .Add<DefaultVerb>()
+         .Add<DownloadVerb>();
     });

src/MangaDexSharp.Utilities.Cli/SecretAttribute.cs

@@ -0,0 +1,4 @@
+namespace MangaDexSharp.Utilities.Cli;
+
+[AttributeUsage(AttributeTargets.Property, AllowMultiple = false)]
+public class SecretAttribute : Attribute { }

src/MangaDexSharp.Utilities.Cli/Services/ExportReadListService.cs

@@ -1,5 +1,6 @@
 namespace MangaDexSharp.Utilities.Cli.Services;
 
+using CardboardBox.Extensions;
 using System.Text;
 using Writers;
 using MangaStatus = (Manga manga, ReadStatus status, Chapter? chapter);
@@ -137,7 +138,7 @@ public static CsvManga FromManga(MangaStatus m, string lang)
 
             return new CsvManga(
                 m.manga.Id,
-                m.manga.Attributes?.Title?.PreferedOrFirst(t => t.Key == lang).Value ?? string.Empty,
+                m.manga.Attributes?.Title?.PreferredOrFirst(t => t.Key == lang).Value ?? string.Empty,
                 coverUrl,
                 $"https://mangadex.org/title/{m.manga.Id}",
                 m.status.ToString(),

src/MangaDexSharp.Utilities.Cli/Verbs/CheckAuthVerb.cs

@@ -0,0 +1,30 @@
+namespace MangaDexSharp.Utilities.Cli.Verbs;
+
+using Services;
+
+[Verb("check-auth", HelpText = "Check to see if the given authentication is valid.")]
+public class CheckAuthOptions : AuthOptions
+{
+
+}
+
+internal class CheckAuthVerb(
+    ILogger<CheckAuthVerb> logger,
+    AuthOptionsCache _cache,
+    IMangaDex _md,
+    IMdJsonService _json) : BooleanVerb<CheckAuthOptions>(logger)
+{
+    public override async Task<bool> Execute(CheckAuthOptions options, CancellationToken token)
+    {
+        _cache.Auth = options;
+        var me = await _md.User.Me();
+        if (me.IsError(out var errors))
+        {
+            _logger.LogError("Authentication failed: {Errors}", string.Join(", ", errors));
+            return false;
+        }
+
+        _logger.LogInformation("Authentication successful! Profile: {profile}", _json.Pretty(me));
+        return true;
+    }
+}