Replaces 'IsLongRunning' by a 'IgnoreParallelism' and a 'Options' property

Author: bt-88

DeltaSight.SimpleBackgroundWorker.Tests/ParallelismTests.cs

@@ -38,9 +38,9 @@ public async Task Test_WithManyDegreesOfParallelism()
                     await Task.Delay(jobTimeMs, t);
                     ended.Add(DateTime.Now);
                     semaphore.Release();
-                }, $"Job {i}", e =>
+                }, name: $"Job {i}", errorCallback: ex =>
                 {
-                    Assert.Fail(e.Message);
+                    Assert.Fail(ex.Message);
 
                     return Task.CompletedTask;
                 }))
@@ -49,7 +49,7 @@ public async Task Test_WithManyDegreesOfParallelism()
         await bgWorker.QueueAsync(jobs);
 
         // Queue some long running jobs (that shouldn't interfere with max. degree of parallelism)
-        await bgWorker.QueueAsync(Enumerable.Range(1, 10).Select(x => new BackgroundWorkItem(t => Task.Delay(-1, t), isLongRunning:true)));
+        await bgWorker.QueueAsync(Enumerable.Range(1, 10).Select(x => BackgroundWorkItem.Create(t => Task.Delay(-1, t), ignoreParallelism:true)));
 
         var startAt = DateTime.Now;
 
@@ -62,7 +62,7 @@ public async Task Test_WithManyDegreesOfParallelism()
         Assert.Multiple(() =>
         {
             Assert.That(ended, Has.Count.EqualTo(count));
-            Assert.That((ended.Max() - startAt).TotalMilliseconds, Is.EqualTo(m * jobTimeMs).Within(jobTimeMs));
+            Assert.That((ended.Max() - startAt).TotalMilliseconds, Is.EqualTo(m * jobTimeMs).Within(2 * jobTimeMs));
         });
 
         await host.StopAsync();

DeltaSight.SimpleBackgroundWorker/BackgroundWorkItem.cs

@@ -4,13 +4,14 @@ namespace DeltaSight.SimpleBackgroundWorker;
 
 public struct BackgroundWorkItem
 {
-    public BackgroundWorkItem(Func<CancellationToken, Task> execute, string name = "Untitled", Func<Exception, Task>? onError = null, bool isLongRunning = false, TimeSpan? cancelAfter = null)
+    private BackgroundWorkItem(Func<CancellationToken, Task> execute, string name, Func<Exception, Task>? onError, bool ignoreParallelism, TaskCreationOptions options, TimeSpan? cancelAfter)
     {
         Name = name;
         Execute = execute;
         OnError = onError;
-        IsLongRunning = isLongRunning;
+        Options = options;
         CancelAfter = cancelAfter;
+        IgnoreParallelism = ignoreParallelism;
     }
 
     public Guid Guid { get; } = Guid.NewGuid();
@@ -19,24 +20,24 @@ public BackgroundWorkItem(Func<CancellationToken, Task> execute, string name = "
     public Func<CancellationToken, Task> Execute { get; }
     public Func<Exception, Task>? OnError { get; } = null;
 
-    /// <summary>
-    /// Flag to indicate the task is long running
-    /// <remarks>Long running tasks will not impact maximum degree of parallelism
-    /// </summary>
-    public bool IsLongRunning { get; }
+    public TaskCreationOptions Options { get; }
+    
+    public bool IgnoreParallelism { get; }
 
     /// <summary>
     /// If set, the job will be cancelled automatically if the execution takes longer
     /// </summary>
     public TimeSpan? CancelAfter { get; }
 
     public static BackgroundWorkItem Create(Func<CancellationToken, Task> executeWork,
-       [CallerArgumentExpression("executeWork")] string name = "Untitled",
+        string? name = null,
         Func<Exception, Task>? errorCallback = null,
-        bool isLongRunning = false,
-        TimeSpan? cancelAfter = null
-        )
+        bool ignoreParallelism = false,
+        TaskCreationOptions options = TaskCreationOptions.None,
+        TimeSpan? cancelAfter = null,
+        [CallerMemberName] string callerMemberName = "",
+        [CallerArgumentExpression("executeWork")] string callerArgumentExpression = "")
     {
-        return new BackgroundWorkItem(executeWork, name, errorCallback, isLongRunning, cancelAfter);
+        return new BackgroundWorkItem(executeWork, name ?? $"{callerMemberName}::{callerArgumentExpression}", errorCallback, ignoreParallelism, options, cancelAfter);
     }
 }

DeltaSight.SimpleBackgroundWorker/DeltaSight.SimpleBackgroundWorker.csproj

@@ -5,7 +5,7 @@
         <Nullable>enable</Nullable>
         <Title>DeltaSight.SimpleBackgroundWorker</Title>
         <Authors>Bas Timmermans</Authors>
-        <Version>2.2.0</Version>
+        <Version>3.0.0</Version>
         <Description>A very simple and light weight background worker queue that respects a maximum degree of parallelism.</Description>
         <Company>Deltasight</Company>
         <PackageProjectUrl>https://github.com/bt-88/Deltasight.SimpleBackgroundWorker</PackageProjectUrl>

DeltaSight.SimpleBackgroundWorker/SimpleBackgroundWorkerHost.cs

@@ -51,9 +51,7 @@ private async Task Run(BackgroundWorkItem workItem, CancellationToken stoppingTo
 
             var task = await Task.Factory.StartNew(
                     () => workItem.Execute(cts.Token),
-                    workItem.IsLongRunning
-                        ? TaskCreationOptions.None
-                        : TaskCreationOptions.LongRunning).ConfigureAwait(false);
+                    workItem.Options).ConfigureAwait(false);
 
             await task;
 
@@ -99,14 +97,14 @@ private async Task Run(BackgroundWorkItem workItem, CancellationToken stoppingTo
 
     private async ValueTask WaitForWorker(BackgroundWorkItem item, CancellationToken cancellationToken)
     {
-        if (item.IsLongRunning) return;
+        if (item.IgnoreParallelism) return;
 
         await _semaphore.WaitAsync(cancellationToken);
     }
 
     private void ReleaseWorker(BackgroundWorkItem item)
     {
-        if (item.IsLongRunning) return;
+        if (item.IgnoreParallelism) return;
 
         _semaphore.Release();
     }