Add support for multipart file uploads

Files bigger than 200MB are uploaded in 50MB chunks via the multipart
upload API.

The upload progress can now be monitored by providing an implementor for
`IProgress<UploadProgress>` with the `UploadOptions` struct.

Author: nickelc

Modio.Tests/Helpers/ByteRangesTest.cs

@@ -0,0 +1,30 @@
+namespace Modio;
+
+public class ByteRangesTest
+{
+    [Fact]
+    public void TestCreateByteRanges()
+    {
+        const long CHUNK_SIZE = 50 * 1024 * 1024; // 50MB
+        const long SIZE = 522 * 1024 * 1024;
+
+        (int, (long, long))[] expected = [
+            (0, (0, 52428799)),
+                (1, (52428800, 104857599)),
+                (2, (104857600, 157286399)),
+                (3, (157286400, 209715199)),
+                (4, (209715200, 262143999)),
+                (5, (262144000, 314572799)),
+                (6, (314572800, 367001599)),
+                (7, (367001600, 419430399)),
+                (8, (419430400, 471859199)),
+                (9, (471859200, 524287999)),
+                (10, (524288000, 547356671)),
+            ];
+
+        var ranges = new ByteRanges(SIZE, CHUNK_SIZE);
+
+        Assert.Equal(11, ranges.Length);
+        Assert.Equal(expected, ranges);
+    }
+}

Modio.Tests/Helpers/StreamsTest.cs

@@ -0,0 +1,54 @@
+namespace Modio;
+
+public class StreamsTest
+{
+    class Progress : IProgress<long>
+    {
+        public long Total = 0;
+        public void Report(long value)
+        {
+            Total += value;
+        }
+    }
+
+    public static TheoryData<long, long?, long, string> CopyBoundsData
+    {
+        get
+        {
+            return new TheoryData<long, long?, long, string>
+            { 
+                {0, 26, 26, "abcdefghijklmnopqrstuvwxyz"},
+                {0, null, 26, "abcdefghijklmnopqrstuvwxyz"},
+                {5, null, 21, "fghijklmnopqrstuvwxyz"},
+                {12, 10, 10, "mnopqrstuv"},
+            };
+        }
+    }
+
+    [Theory]
+    [MemberData(nameof(CopyBoundsData))]
+    public async Task TestCopyToAsync(long start, long? count, long total, string expected)
+    {
+        var token = TestContext.Current.CancellationToken;
+        var originalText = "abcdefghijklmnopqrstuvwxyz";
+
+        using (var innerStream = new MemoryStream())
+        using (var writer = new StreamWriter(innerStream))
+        using (var targetStream = new MemoryStream())
+        using (var reader = new StreamReader(targetStream))
+        {
+            await writer.WriteAsync(originalText);
+            await writer.FlushAsync(token);
+
+            var progress = new Progress();
+
+            innerStream.Position = start;
+            await Streams.CopyToAsync(innerStream, targetStream, count, bufferSize: 5, token, progress);
+
+            targetStream.Position = 0;
+            var text = await reader.ReadToEndAsync(token);
+            Assert.Equal(expected, text);
+            Assert.Equal(total, progress.Total);
+        }
+    }
+}

Modio/Clients/FilesClient.cs

@@ -46,14 +46,17 @@ public SearchClient<File> Search(Filter? filter = null)
         /// </summary>
         public async Task<File> Add(NewFile newFile, CancellationToken cancellationToken = default)
         {
-            using (var content = newFile.ToContent())
-            {
-                var (method, path) = Routes.AddFile(GameId, ModId);
-                var req = new Request(method, path, content);
+            return await Add(newFile, default, cancellationToken);
+        }
+
+        /// <summary>
+        /// Upload a file for the corresponding mod.
+        /// </summary>
+        public async Task<File> Add(NewFile newFile, UploadOptions options = default, CancellationToken cancellationToken = default)
+        {
+            UploadClient client = new(Connection, GameId, ModId);
 
-                var resp = await Connection.Send<File>(req, cancellationToken);
-                return resp.Body!;
-            }
+            return await client.UploadFile(newFile, options, cancellationToken);
         }
 
         /// <summary>