feat: add simple overload for attaching artifacts with optional display name and description

TUnit.Core/Interfaces/ITestOutput.cs

@@ -47,6 +47,16 @@ public interface ITestOutput
     /// <param name="artifact">The artifact to attach</param>
     void AttachArtifact(Artifact artifact);
 
+    /// <summary>
+    /// Attaches a file as an artifact to this test.
+    /// Artifacts are preserved after test execution.
+    /// Thread-safe for concurrent calls.
+    /// </summary>
+    /// <param name="filePath">The path to the file to attach</param>
+    /// <param name="displayName">Optional display name for the artifact. Defaults to the file name.</param>
+    /// <param name="description">Optional description of the artifact</param>
+    void AttachArtifact(string filePath, string? displayName = null, string? description = null);
+
     /// <summary>
     /// Gets all standard output written during test execution as a single string.
     /// </summary>

TUnit.Core/TestContext.Output.cs

@@ -31,6 +31,17 @@ void ITestOutput.AttachArtifact(Artifact artifact)
         _artifactsBag.Add(artifact);
     }
 
+    void ITestOutput.AttachArtifact(string filePath, string? displayName, string? description)
+    {
+        var fileInfo = new FileInfo(filePath);
+        _artifactsBag.Add(new Artifact
+        {
+            File = fileInfo,
+            DisplayName = displayName ?? fileInfo.Name,
+            Description = description
+        });
+    }
+
     string ITestOutput.GetStandardOutput() => GetOutput();
     string ITestOutput.GetErrorOutput() => GetOutputError();
 

TUnit.PublicAPI/Tests.Core_Library_Has_No_API_Changes.DotNet10_0.verified.txt

@@ -2450,6 +2450,7 @@ namespace .Interfaces
         .TextWriter StandardOutput { get; }
         .<.Timing> Timings { get; }
         void AttachArtifact(.Artifact artifact);
+        void AttachArtifact(string filePath, string? displayName = null, string? description = null);
         string GetErrorOutput();
         string GetStandardOutput();
         void RecordTiming(.Timing timing);

TUnit.PublicAPI/Tests.Core_Library_Has_No_API_Changes.DotNet8_0.verified.txt

@@ -2450,6 +2450,7 @@ namespace .Interfaces
         .TextWriter StandardOutput { get; }
         .<.Timing> Timings { get; }
         void AttachArtifact(.Artifact artifact);
+        void AttachArtifact(string filePath, string? displayName = null, string? description = null);
         string GetErrorOutput();
         string GetStandardOutput();
         void RecordTiming(.Timing timing);

TUnit.PublicAPI/Tests.Core_Library_Has_No_API_Changes.DotNet9_0.verified.txt

@@ -2450,6 +2450,7 @@ namespace .Interfaces
         .TextWriter StandardOutput { get; }
         .<.Timing> Timings { get; }
         void AttachArtifact(.Artifact artifact);
+        void AttachArtifact(string filePath, string? displayName = null, string? description = null);
         string GetErrorOutput();
         string GetStandardOutput();
         void RecordTiming(.Timing timing);

TUnit.PublicAPI/Tests.Core_Library_Has_No_API_Changes.Net4_7.verified.txt

@@ -2380,6 +2380,7 @@ namespace .Interfaces
         .TextWriter StandardOutput { get; }
         .<.Timing> Timings { get; }
         void AttachArtifact(.Artifact artifact);
+        void AttachArtifact(string filePath, string? displayName = null, string? description = null);
         string GetErrorOutput();
         string GetStandardOutput();
         void RecordTiming(.Timing timing);

TUnit.TestProject/TestArtifactTests.cs

@@ -14,4 +14,22 @@ public void Artifact_Test()
             DisplayName = "Blah!"
         });
     }
+
+    [Test]
+    public void Artifact_Test_Simple_Overload()
+    {
+        // Simple overload - file name is used as display name
+        TestContext.Current!.Output.AttachArtifact("Data/Zip.zip");
+    }
+
+    [Test]
+    public void Artifact_Test_Simple_Overload_With_Name()
+    {
+        // Simple overload with custom display name and description
+        TestContext.Current!.Output.AttachArtifact(
+            "Data/Zip.zip",
+            displayName: "Test Zip File",
+            description: "A sample zip file for testing"
+        );
+    }
 }

docs/docs/test-lifecycle/artifacts.md

@@ -12,22 +12,42 @@ Attach files to individual tests using `TestContext.Current.Output.AttachArtifac
 
 ### Basic Usage
 
+The simplest way to attach an artifact is by providing just the file path:
+
 ```csharp
 [Test]
 public async Task MyIntegrationTest()
 {
     // Perform your test logic
     var result = await PerformOperation();
-
-    // Attach an artifact to this specific test
+
+    // Attach an artifact using the simple overload
+    TestContext.Current!.Output.AttachArtifact("path/to/logfile.log");
+
+    // Or with a custom display name and description
+    TestContext.Current!.Output.AttachArtifact(
+        "path/to/logfile.log",
+        displayName: "Application Logs",
+        description: "Logs captured during test execution"
+    );
+
+    await Assert.That(result).IsEqualTo(expected);
+}
+```
+
+For more control, you can create an `Artifact` object directly:
+
+```csharp
+[Test]
+public async Task MyIntegrationTest()
+{
+    // Attach an artifact using the full Artifact object
     TestContext.Current!.Output.AttachArtifact(new Artifact
     {
         File = new FileInfo("path/to/logfile.log"),
         DisplayName = "Application Logs",
         Description = "Logs captured during test execution"
     });
-
-    await Assert.That(result).IsEqualTo(expected);
 }
 ```