Add new API to Verify a file outside a test

docs/verify-file.md

@@ -46,17 +46,13 @@ Use the functionality of VerifyTests outside of a unit test.
 ```cs
 public async Task VerifyExternalFile()
 {
-    var solutionDirectory = AttributeReader.GetSolutionDirectory();
     var settings = new VerifySettings();
     settings.DisableRequireUniquePrefix();
-
-    var sourceFile = Path.Combine(solutionDirectory, "Verify.Tests", "sample.txt");
-
-    using var verifier = new InnerVerifier(sourceFile, settings);
-    await verifier.VerifyFile(sourceFile, null, null);
+    using var verifier = new InnerVerifier(targetDirectory, "sample", settings);
+    await verifier.VerifyFile(filePath, null, null);
 }
 ```
-<sup><a href='/src/Verify.Tests/InnerVerifyTests.cs#L16-L30' title='Snippet source file'>snippet source</a> | <a href='#snippet-VerifyFileWithoutUnitTest' title='Start of snippet'>anchor</a></sup>
+<sup><a href='/src/Verify.Tests/InnerVerifyTests/InnerVerifyTests.cs#L15-L25' title='Snippet source file'>snippet source</a> | <a href='#snippet-VerifyFileWithoutUnitTest' title='Start of snippet'>anchor</a></sup>
 <!-- endSnippet -->
 
 

src/Directory.Build.props

@@ -2,7 +2,7 @@
 <Project>
   <PropertyGroup>
     <NoWarn>CS1591;CS0649;xUnit1026;xUnit1013;CS1573;VerifyTestsProjectDir;VerifySetParameters;PolyFillTargetsForNuget</NoWarn>
-    <Version>26.6.0</Version>
+    <Version>27.0.0-beta.1</Version>
     <ImplicitUsings>enable</ImplicitUsings>
     <LangVersion>preview</LangVersion>
     <AssemblyVersion>1.0.0</AssemblyVersion>

src/Verify.Tests/InnerVerifyTests/InnerVerifyTests.cs

@@ -0,0 +1,36 @@
+public class InnerVerifyTests
+{
+    static string filePath;
+    static string targetDirectory;
+
+    static InnerVerifyTests()
+    {
+        var solutionDirectory = AttributeReader.GetSolutionDirectory();
+        targetDirectory = Path.Combine(solutionDirectory, "Verify.Tests", "InnerVerifyTests");
+        filePath = Path.Combine(targetDirectory, "sample.txt");
+    }
+
+    [Fact]
+
+    #region VerifyFileWithoutUnitTest
+
+    public async Task VerifyExternalFile()
+    {
+        var settings = new VerifySettings();
+        settings.DisableRequireUniquePrefix();
+        using var verifier = new InnerVerifier(targetDirectory, "sample", settings);
+        await verifier.VerifyFile(filePath, null, null);
+    }
+
+    #endregion
+
+    [Fact]
+    public async Task VerifyExternalFileLocked()
+    {
+        var settings = new VerifySettings();
+        settings.DisableRequireUniquePrefix();
+        using var locker = new FileStream(filePath, FileMode.Open, FileAccess.Read, FileShare.Read);
+        using var verifier = new InnerVerifier(targetDirectory, "sample", settings);
+        await verifier.VerifyFile(filePath, null, null);
+    }
+}

src/Verify.Tests/InnerVerifyTests/sample.verified.txt

@@ -0,0 +1 @@
+Foo

src/Verify.Tests/Verify.Tests.csproj

@@ -38,6 +38,9 @@
       <ParentFile>InnerVerifyChecksTests</ParentFile>
       <DependentUpon>InnerVerifyChecksTests2.cs</DependentUpon>
     </None>
+    <None Update="InnerVerifyTests\sample.txt">
+      <CopyToOutputDirectory>PreserveNewest</CopyToOutputDirectory>
+    </None>
   </ItemGroup>
 
   <ItemGroup Condition="$(TargetFramework) != 'net8.0'">

src/Verify/Verifier/InnerVerifier.cs

@@ -72,6 +72,7 @@ public InnerVerifier(
     /// Initialize a new instance of the <see cref="InnerVerifier" /> class for verifying the entire file (not just a specific type)
     /// </summary>
     /// <remarks>This constructor is used by 3rd party clients</remarks>
+    [Obsolete("Use InnerVerifier(string directory, string name, VerifySettings settings)")]
     public InnerVerifier(string sourceFile, VerifySettings settings)
     {
         Guard.NotEmpty(sourceFile);
@@ -98,6 +99,42 @@ public InnerVerifier(string sourceFile, VerifySettings settings)
         getIndexedFileNames = (_, _) => throw new NotImplementedException();
     }
 
+    /// <summary>
+    /// Initialize a new instance of the <see cref="InnerVerifier" /> class for verifying the entire file (not just a specific type)
+    /// </summary>
+    /// <remarks>This constructor is used by 3rd party clients</remarks>
+    public InnerVerifier(string directory, string name, VerifySettings settings)
+    {
+        Guard.NotEmpty(directory);
+        Guard.NotEmpty(name);
+        this.settings = settings;
+        verifyHasBeenRun = true;
+        if (settings.Directory != null)
+        {
+            throw new("VerifySettings.Directory is not allowed for this API");
+        }
+
+        this.directory = directory;
+
+        counter = StartCounter(settings);
+
+        IoHelpers.CreateDirectory(directory);
+
+        var prefix = Path.Combine(directory, name);
+        ValidatePrefix(settings, directory);
+
+        verifiedFiles = MatchingFileFinder.FindVerified(name, directory);
+
+        getFileNames = target =>
+            new(
+                target.Extension,
+                $"{prefix}.received.{target.Extension}",
+                Path.Combine(directory, $"{prefix}.verified.{target.Extension}")
+            );
+
+        getIndexedFileNames = (_, _) => throw new NotImplementedException();
+    }
+
     static Counter StartCounter(VerifySettings settings) =>
         Counter.Start(
             settings.DateCountingEnable,