.

Author: SimonCropp

docs/mdsource/temp-file.source.md

@@ -98,6 +98,58 @@ Result:
 snippet: TempFileTests.Scrubbing.verified.txt
 
 
+### Create Method
+
+Creates a new temporary file with optional extension and encoding.
+
+snippet: TempFileCreate
+
+
+#### With Extension
+
+Create a temporary file with a specific extension:
+
+snippet: TempFileCreateWithExtension
+
+
+#### With Encoding
+
+Create a temporary file with a specific text encoding and BOM:
+
+snippet: TempFileCreateWithEncoding
+
+
+### CreateText Method
+
+Creates a new temporary file with text content asynchronously.
+
+snippet: TempFileCreateText
+
+
+#### With Extension
+
+snippet: TempFileCreateTextWithExtension
+
+
+#### With Encoding
+
+Create a text file with specific encoding:
+
+snippet: TempFileCreateTextWithEncoding
+
+
+### CreateBinary Method
+
+Creates a new temporary file with binary content asynchronously.
+
+snippet: TempFileCreateBinary
+
+
+#### With Extension
+
+snippet: TempFileCreateBinaryWithExtension
+
+
 ### Debugging
 
 Given `TempFile` deletes the file on test completion (even failure), it can be difficult to debug what caused the failure.

docs/readme.md

@@ -50,6 +50,7 @@ To change this file edit the source file and then run MarkdownSnippets.
   * [Recording](/docs/recording.md)
   * [Explicit Targets](/docs/explicit-targets.md)
   * [TempDirectory](/docs/temp-directory.md)
+  * [TempFile](/docs/temp-file.md)
   * [FSharp Usage](/docs/fsharp.md)
   * [Compared to ApprovalTests](/docs/compared-to-approvaltests.md)
   * [Plugins](/docs/plugins.md)<!-- endInclude -->

docs/temp-file.md

@@ -224,6 +224,140 @@ Result:
 <!-- endSnippet -->
 
 
+### Create Method
+
+Creates a new temporary file with optional extension and encoding.
+
+<!-- snippet: TempFileCreate -->
+<a id='snippet-TempFileCreate'></a>
+```cs
+using var temp = TempFile.Create();
+
+File.WriteAllText(temp, "content");
+
+// file automatically deleted here
+```
+<sup><a href='/src/Verify.Tests/TempFileTests.cs#L620-L628' title='Snippet source file'>snippet source</a> | <a href='#snippet-TempFileCreate' title='Start of snippet'>anchor</a></sup>
+<!-- endSnippet -->
+
+
+#### With Extension
+
+Create a temporary file with a specific extension:
+
+<!-- snippet: TempFileCreateWithExtension -->
+<a id='snippet-TempFileCreateWithExtension'></a>
+```cs
+using var temp = TempFile.Create(".txt");
+
+File.WriteAllText(temp, "content");
+```
+<sup><a href='/src/Verify.Tests/TempFileTests.cs#L635-L641' title='Snippet source file'>snippet source</a> | <a href='#snippet-TempFileCreateWithExtension' title='Start of snippet'>anchor</a></sup>
+<!-- endSnippet -->
+
+
+#### With Encoding
+
+Create a temporary file with a specific text encoding and BOM:
+
+<!-- snippet: TempFileCreateWithEncoding -->
+<a id='snippet-TempFileCreateWithEncoding'></a>
+```cs
+using var temp = TempFile.Create(".txt", Encoding.UTF8);
+
+File.Exists(temp.Path);
+```
+<sup><a href='/src/Verify.Tests/TempFileTests.cs#L649-L655' title='Snippet source file'>snippet source</a> | <a href='#snippet-TempFileCreateWithEncoding' title='Start of snippet'>anchor</a></sup>
+<!-- endSnippet -->
+
+
+### CreateText Method
+
+Creates a new temporary file with text content asynchronously.
+
+<!-- snippet: TempFileCreateText -->
+<a id='snippet-TempFileCreateText'></a>
+```cs
+using var temp = await TempFile.CreateText("Hello, World!");
+
+var content = await File.ReadAllTextAsync(temp);
+Assert.Equal("Hello, World!", content);
+```
+<sup><a href='/src/Verify.Tests/TempFileTests.cs#L661-L668' title='Snippet source file'>snippet source</a> | <a href='#snippet-TempFileCreateText' title='Start of snippet'>anchor</a></sup>
+<!-- endSnippet -->
+
+
+#### With Extension
+
+<!-- snippet: TempFileCreateTextWithExtension -->
+<a id='snippet-TempFileCreateTextWithExtension'></a>
+```cs
+var json = """
+           {
+             "name": "test",
+             "value": 123
+           }
+           """;
+
+using var temp = await TempFile.CreateText(json, ".json");
+
+var content = await File.ReadAllTextAsync(temp);
+Assert.Equal(json, content);
+```
+<sup><a href='/src/Verify.Tests/TempFileTests.cs#L674-L688' title='Snippet source file'>snippet source</a> | <a href='#snippet-TempFileCreateTextWithExtension' title='Start of snippet'>anchor</a></sup>
+<!-- endSnippet -->
+
+
+#### With Encoding
+
+Create a text file with specific encoding:
+
+<!-- snippet: TempFileCreateTextWithEncoding -->
+<a id='snippet-TempFileCreateTextWithEncoding'></a>
+```cs
+using var temp = await TempFile.CreateText(
+    "Content with special chars: äöü",
+    ".txt",
+    Encoding.UTF8);
+
+var content = await File.ReadAllTextAsync(temp, Encoding.UTF8);
+Assert.Equal("Content with special chars: äöü", content);
+```
+<sup><a href='/src/Verify.Tests/TempFileTests.cs#L694-L704' title='Snippet source file'>snippet source</a> | <a href='#snippet-TempFileCreateTextWithEncoding' title='Start of snippet'>anchor</a></sup>
+<!-- endSnippet -->
+
+
+### CreateBinary Method
+
+Creates a new temporary file with binary content asynchronously.
+
+<!-- snippet: TempFileCreateBinary -->
+<a id='snippet-TempFileCreateBinary'></a>
+```cs
+byte[] data = [0x01, 0x02, 0x03, 0x04];
+
+using var temp = await TempFile.CreateBinary(data);
+
+var readData = await File.ReadAllBytesAsync(temp);
+Assert.Equal(data, readData);
+```
+<sup><a href='/src/Verify.Tests/TempFileTests.cs#L712-L721' title='Snippet source file'>snippet source</a> | <a href='#snippet-TempFileCreateBinary' title='Start of snippet'>anchor</a></sup>
+<!-- endSnippet -->
+
+
+#### With Extension
+
+<!-- snippet: TempFileCreateBinaryWithExtension -->
+<a id='snippet-TempFileCreateBinaryWithExtension'></a>
+```cs
+using var temp = await TempFile.CreateBinary(imageBinaryData, ".png");
+
+// Process the temporary image file
+```
+<sup><a href='/src/Verify.Tests/TempFileTests.cs#L729-L735' title='Snippet source file'>snippet source</a> | <a href='#snippet-TempFileCreateBinaryWithExtension' title='Start of snippet'>anchor</a></sup>
+<!-- endSnippet -->
+
+
 ### Debugging
 
 Given `TempFile` deletes the file on test completion (even failure), it can be difficult to debug what caused the failure.

readme.md

@@ -1112,6 +1112,7 @@ To opt out of this feature, include the following in the project file:
   * [Recording](/docs/recording.md)
   * [Explicit Targets](/docs/explicit-targets.md)
   * [TempDirectory](/docs/temp-directory.md)
+  * [TempFile](/docs/temp-file.md)
   * [FSharp Usage](/docs/fsharp.md)
   * [Compared to ApprovalTests](/docs/compared-to-approvaltests.md)
   * [Plugins](/docs/plugins.md)<!-- endInclude -->

src/Verify.Tests/TempFileTests.CreateBinary_CanBeVerified.verified.bin

@@ -0,0 +1 @@
+


src/Verify.Tests/TempFileTests.CreateText_CanBeVerified.verified.txt

@@ -0,0 +1 @@
+test content

src/Verify.Tests/TempFileTests.cs

@@ -409,7 +409,7 @@ public async Task CreateText_WithExtension_CreatesFileWithExtensionAndContent()
     {
         var content = "Test content";
 
-         using var temp = await TempFile.CreateText(content, ".txt");
+        using var temp = await TempFile.CreateText(content, ".txt");
 
         Assert.EndsWith(".txt", temp.Path);
         Assert.True(File.Exists(temp.Path));
@@ -613,4 +613,125 @@ public async Task CreateText_WithXmlContent_CreatesValidXmlFile()
         var readContent = await File.ReadAllTextAsync(temp.Path);
         Assert.Equal(xmlContent, readContent);
     }
+
+    [Fact]
+    public void Create()
+    {
+        #region TempFileCreate
+
+        using var temp = TempFile.Create();
+
+        File.WriteAllText(temp, "content");
+
+        // file automatically deleted here
+
+        #endregion
+    }
+
+
+    [Fact]
+    public void CreateWithExtension()
+    {
+        #region TempFileCreateWithExtension
+
+        using var temp = TempFile.Create(".txt");
+
+        File.WriteAllText(temp, "content");
+
+        #endregion
+    }
+
+
+
+    [Fact]
+    public void CreateWithEncoding()
+    {
+        #region TempFileCreateWithEncoding
+
+        using var temp = TempFile.Create(".txt", Encoding.UTF8);
+
+        File.Exists(temp.Path);
+
+        #endregion
+    }
+
+    [Fact]
+    public async Task CreateText()
+    {
+        #region TempFileCreateText
+
+        using var temp = await TempFile.CreateText("Hello, World!");
+
+        var content = await File.ReadAllTextAsync(temp);
+        Assert.Equal("Hello, World!", content);
+
+        #endregion
+    }
+
+    [Fact]
+    public async Task CreateTextWithExtension()
+    {
+        #region TempFileCreateTextWithExtension
+
+        var json = """
+                   {
+                     "name": "test",
+                     "value": 123
+                   }
+                   """;
+
+        using var temp = await TempFile.CreateText(json, ".json");
+
+        var content = await File.ReadAllTextAsync(temp);
+        Assert.Equal(json, content);
+
+        #endregion
+    }
+
+    [Fact]
+    public async Task CreateTextWithEncoding()
+    {
+        #region TempFileCreateTextWithEncoding
+
+        using var temp = await TempFile.CreateText(
+            "Content with special chars: äöü",
+            ".txt",
+            Encoding.UTF8);
+
+        var content = await File.ReadAllTextAsync(temp, Encoding.UTF8);
+        Assert.Equal("Content with special chars: äöü", content);
+
+        #endregion
+    }
+
+
+
+    [Fact]
+    public async Task CreateBinary()
+    {
+        #region TempFileCreateBinary
+
+        byte[] data = [0x01, 0x02, 0x03, 0x04];
+
+        using var temp = await TempFile.CreateBinary(data);
+
+        var readData = await File.ReadAllBytesAsync(temp);
+        Assert.Equal(data, readData);
+
+        #endregion
+    }
+
+    [Fact]
+    public async Task CreateBinaryWithExtension()
+    {
+        var imageBinaryData = await File.ReadAllBytesAsync("source.png");
+
+        #region TempFileCreateBinaryWithExtension
+
+        using var temp = await TempFile.CreateBinary(imageBinaryData, ".png");
+
+        // Process the temporary image file
+
+        #endregion
+    }
 }