Use split mode for unique directory configurability per test (#760)

docs/naming.md

@@ -27,7 +27,7 @@ var settings = new VerifySettings();
 settings.UseDirectory("CustomDirectory");
 await Verify("valueUseDirectory", settings);
 ```
-<sup><a href='/src/Verify.Tests/Naming/NamerTests.cs#L179-L185' title='Snippet source file'>snippet source</a> | <a href='#snippet-usedirectory' title='Start of snippet'>anchor</a></sup>
+<sup><a href='/src/Verify.Tests/Naming/NamerTests.cs#L202-L208' title='Snippet source file'>snippet source</a> | <a href='#snippet-usedirectory' title='Start of snippet'>anchor</a></sup>
 <!-- endSnippet -->
 
 <!-- snippet: UseDirectoryFluent -->
@@ -36,7 +36,7 @@ await Verify("valueUseDirectory", settings);
 await Verify("valueUseDirectoryFluent")
     .UseDirectory("CustomDirectory");
 ```
-<sup><a href='/src/Verify.Tests/Naming/NamerTests.cs#L191-L196' title='Snippet source file'>snippet source</a> | <a href='#snippet-usedirectoryfluent' title='Start of snippet'>anchor</a></sup>
+<sup><a href='/src/Verify.Tests/Naming/NamerTests.cs#L214-L219' title='Snippet source file'>snippet source</a> | <a href='#snippet-usedirectoryfluent' title='Start of snippet'>anchor</a></sup>
 <!-- endSnippet -->
 
 Will result in `CustomDirectory/TypeName.MethodName.verified.txt`.
@@ -55,7 +55,7 @@ var settings = new VerifySettings();
 settings.UseTypeName("CustomTypeName");
 await Verify("valueUseTypeName", settings);
 ```
-<sup><a href='/src/Verify.Tests/Naming/NamerTests.cs#L290-L296' title='Snippet source file'>snippet source</a> | <a href='#snippet-usetypename' title='Start of snippet'>anchor</a></sup>
+<sup><a href='/src/Verify.Tests/Naming/NamerTests.cs#L313-L319' title='Snippet source file'>snippet source</a> | <a href='#snippet-usetypename' title='Start of snippet'>anchor</a></sup>
 <!-- endSnippet -->
 
 <!-- snippet: UseTypeNameFluent -->
@@ -64,7 +64,7 @@ await Verify("valueUseTypeName", settings);
 await Verify("valueUseTypeNameFluent")
     .UseTypeName("CustomTypeName");
 ```
-<sup><a href='/src/Verify.Tests/Naming/NamerTests.cs#L302-L307' title='Snippet source file'>snippet source</a> | <a href='#snippet-usetypenamefluent' title='Start of snippet'>anchor</a></sup>
+<sup><a href='/src/Verify.Tests/Naming/NamerTests.cs#L325-L330' title='Snippet source file'>snippet source</a> | <a href='#snippet-usetypenamefluent' title='Start of snippet'>anchor</a></sup>
 <!-- endSnippet -->
 
 Will result in `CustomTypeName.MethodName.verified.txt`.
@@ -81,7 +81,7 @@ var settings = new VerifySettings();
 settings.UseMethodName("CustomMethodName");
 await Verify("valueUseMethodName", settings);
 ```
-<sup><a href='/src/Verify.Tests/Naming/NamerTests.cs#L313-L319' title='Snippet source file'>snippet source</a> | <a href='#snippet-usemethodname' title='Start of snippet'>anchor</a></sup>
+<sup><a href='/src/Verify.Tests/Naming/NamerTests.cs#L336-L342' title='Snippet source file'>snippet source</a> | <a href='#snippet-usemethodname' title='Start of snippet'>anchor</a></sup>
 <!-- endSnippet -->
 
 Will result in `TestClass.CustomMethodName.verified.txt`.
@@ -92,7 +92,7 @@ Will result in `TestClass.CustomMethodName.verified.txt`.
 await Verify("valueUseMethodNameFluent")
     .UseMethodName("CustomMethodNameFluent");
 ```
-<sup><a href='/src/Verify.Tests/Naming/NamerTests.cs#L325-L330' title='Snippet source file'>snippet source</a> | <a href='#snippet-usemethodnamefluent' title='Start of snippet'>anchor</a></sup>
+<sup><a href='/src/Verify.Tests/Naming/NamerTests.cs#L348-L353' title='Snippet source file'>snippet source</a> | <a href='#snippet-usemethodnamefluent' title='Start of snippet'>anchor</a></sup>
 <!-- endSnippet -->
 
 Will result in `TestClass.CustomMethodNameFluent.verified.txt`.
@@ -129,7 +129,7 @@ var settings = new VerifySettings();
 settings.UseFileName("CustomFileName");
 await Verify("valueUseFileName", settings);
 ```
-<sup><a href='/src/Verify.Tests/Naming/NamerTests.cs#L147-L153' title='Snippet source file'>snippet source</a> | <a href='#snippet-usefilename' title='Start of snippet'>anchor</a></sup>
+<sup><a href='/src/Verify.Tests/Naming/NamerTests.cs#L170-L176' title='Snippet source file'>snippet source</a> | <a href='#snippet-usefilename' title='Start of snippet'>anchor</a></sup>
 <!-- endSnippet -->
 
 Will result in `CustomFileName.verified.txt`.
@@ -140,7 +140,7 @@ Will result in `CustomFileName.verified.txt`.
 await Verify("valueUseFileNameFluent")
     .UseFileName("CustomFileNameFluent");
 ```
-<sup><a href='/src/Verify.Tests/Naming/NamerTests.cs#L168-L173' title='Snippet source file'>snippet source</a> | <a href='#snippet-usefilenamefluent' title='Start of snippet'>anchor</a></sup>
+<sup><a href='/src/Verify.Tests/Naming/NamerTests.cs#L191-L196' title='Snippet source file'>snippet source</a> | <a href='#snippet-usefilenamefluent' title='Start of snippet'>anchor</a></sup>
 <!-- endSnippet -->
 
 Will result in `UseFileNameFluent.verified.txt`.
@@ -497,7 +497,7 @@ To access the current Namer `Runtime` or `RuntimeAndVersion` strings use:
 Debug.WriteLine(Namer.Runtime);
 Debug.WriteLine(Namer.RuntimeAndVersion);
 ```
-<sup><a href='/src/Verify.Tests/Naming/NamerTests.cs#L336-L341' title='Snippet source file'>snippet source</a> | <a href='#snippet-accessnamerruntimeandversion' title='Start of snippet'>anchor</a></sup>
+<sup><a href='/src/Verify.Tests/Naming/NamerTests.cs#L359-L364' title='Snippet source file'>snippet source</a> | <a href='#snippet-accessnamerruntimeandversion' title='Start of snippet'>anchor</a></sup>
 <!-- endSnippet -->
 
 
@@ -612,7 +612,7 @@ var settings = new VerifySettings();
 settings.UseUniqueDirectory();
 await Verify("TheValue", settings);
 ```
-<sup><a href='/src/Verify.Tests/Naming/NamerTests.cs#L202-L208' title='Snippet source file'>snippet source</a> | <a href='#snippet-useuniquedirectory' title='Start of snippet'>anchor</a></sup>
+<sup><a href='/src/Verify.Tests/Naming/NamerTests.cs#L225-L231' title='Snippet source file'>snippet source</a> | <a href='#snippet-useuniquedirectory' title='Start of snippet'>anchor</a></sup>
 <!-- endSnippet -->
 
 

docs/parameterised.md

@@ -381,7 +381,7 @@ public Task UseTextForParametersFluent(string arg) =>
     Verify(arg + "UseTextForParametersFluent")
         .UseTextForParameters(arg);
 ```
-<sup><a href='/src/Verify.Tests/Naming/NamerTests.cs#L370-L389' title='Snippet source file'>snippet source</a> | <a href='#snippet-usetextforparameters' title='Start of snippet'>anchor</a></sup>
+<sup><a href='/src/Verify.Tests/Naming/NamerTests.cs#L393-L412' title='Snippet source file'>snippet source</a> | <a href='#snippet-usetextforparameters' title='Start of snippet'>anchor</a></sup>
 <!-- endSnippet -->
 
 Results in:
@@ -416,7 +416,7 @@ public Task IgnoreParametersForVerifiedFluent(string arg) =>
     Verify("valueIgnoreParametersForVerifiedFluent")
         .IgnoreParametersForVerified(arg);
 ```
-<sup><a href='/src/Verify.Tests/Naming/NamerTests.cs#L442-L461' title='Snippet source file'>snippet source</a> | <a href='#snippet-ignoreparametersforverified' title='Start of snippet'>anchor</a></sup>
+<sup><a href='/src/Verify.Tests/Naming/NamerTests.cs#L465-L484' title='Snippet source file'>snippet source</a> | <a href='#snippet-ignoreparametersforverified' title='Start of snippet'>anchor</a></sup>
 <!-- endSnippet -->
 
 Results in:

src/SplitUniqueDirectoryMode/Tests.DontUseSplitModeForUniqueDirectory/target.verified.txt

@@ -0,0 +1 @@
+Value

src/SplitUniqueDirectoryMode/Tests.DontUseSplitModeForUniqueDirectory_Fluent/target.verified.txt

@@ -0,0 +1 @@
+Value

src/SplitUniqueDirectoryMode/Tests.cs

@@ -69,4 +69,27 @@ public class Tests
         Verify("FileName")
             .UseUniqueDirectory()
             .UseFileName("TheFileName");
+
+    #region DontUseSplitModeForUniqueDirectory
+
+    [Fact]
+    public Task DontUseSplitModeForUniqueDirectory()
+    {
+        var settings = new VerifySettings();
+        settings.UseUniqueDirectory();
+        settings.DontUseSplitModeForUniqueDirectory();
+        return Verify("Value", settings);
+    }
+
+    #endregion
+
+    #region DontUseSplitModeForUniqueDirectory_Fluent
+
+    [Fact]
+    public Task DontUseSplitModeForUniqueDirectory_Fluent() =>
+        Verify("Value")
+            .UseUniqueDirectory()
+            .DontUseSplitModeForUniqueDirectory();
+
+    #endregion
 }

src/Verify.Tests/Naming/NamerTests.UseSplitModeForUniqueDirectory.verified/target.txt

@@ -0,0 +1 @@
+Value

src/Verify.Tests/Naming/NamerTests.UseSplitModeForUniqueDirectoryFluent.verified/target.txt

@@ -0,0 +1 @@
+Value

src/Verify.Tests/Naming/NamerTests.cs

@@ -71,6 +71,29 @@ public Task Runtime()
         return Verify(Namer.Runtime, settings);
     }
 
+    #region UseSplitModeForUniqueDirectoryForTest
+
+    [Fact]
+    public Task UseSplitModeForUniqueDirectory()
+    {
+        var settings = new VerifySettings();
+        settings.UseUniqueDirectory();
+        settings.UseSplitModeForUniqueDirectory();
+        return Verify("Value", settings);
+    }
+
+    #endregion
+
+    #region UseSplitModeForUniqueDirectoryForTestFluent
+
+    [Fact]
+    public Task UseSplitModeForUniqueDirectoryFluent() =>
+        Verify("Value")
+            .UseUniqueDirectory()
+            .UseSplitModeForUniqueDirectory();
+
+    #endregion
+
     [Fact]
     public Task RuntimeFluent() =>
         Verify(Namer.Runtime)

src/Verify/Naming/VerifySettings.cs

@@ -173,4 +173,20 @@ void ThrowIfMethodOrTypeNameDefined()
     /// </summary>
     public void DisableRequireUniquePrefix() =>
         UniquePrefixDisabled = true;
+
+    /// <summary>
+    /// Use the current runtime to make the test results unique.
+    /// Used when a test produces different results based on runtime.
+    /// </summary>
+    public void UseSplitModeForUniqueDirectory() =>
+        UseUniqueDirectorySplitMode = true;
+
+    /// <summary>
+    /// Dont use the current runtime to make the test results unique.
+    /// Overrides <see cref="VerifierSettings.UseSplitModeForUniqueDirectory"/>.
+    /// </summary>
+    public void DontUseSplitModeForUniqueDirectory() =>
+        UseUniqueDirectorySplitMode = false;
+
+    internal bool? UseUniqueDirectorySplitMode;
 }

src/Verify/SettingsTask.cs

@@ -292,6 +292,26 @@ public SettingsTask UseTextForParameters(string parametersText)
         return this;
     }
 
+    /// <summary>
+    /// Use the current runtime to make the test results unique.
+    /// Used when a test produces different results based on runtime.
+    /// </summary>
+    public SettingsTask UseSplitModeForUniqueDirectory()
+    {
+        CurrentSettings.UseSplitModeForUniqueDirectory();
+        return this;
+    }
+
+    /// <summary>
+    /// Dont use the current runtime to make the test results unique.
+    /// Overrides <see cref="VerifierSettings.UseSplitModeForUniqueDirectory"/>.
+    /// </summary>
+    public SettingsTask DontUseSplitModeForUniqueDirectory()
+    {
+        CurrentSettings.DontUseSplitModeForUniqueDirectory();
+        return this;
+    }
+
     public VerifySettings CurrentSettings => settings ??= new();
 
     public Task<VerifyResult> ToTask() =>

src/Verify/Verifier/InnerVerifier.cs

@@ -87,7 +87,7 @@ void InitForDirectoryConvention(string uniquenessVerified, string typeAndMethod,
             verifiedPrefix = $"{typeAndMethod}{parameters}{uniquenessVerified}";
         }
 
-        if (VerifierSettings.UseUniqueDirectorySplitMode)
+        if (ShouldUseUniqueDirectorySplitMode(settings))
         {
             var directoryPrefix = Path.Combine(directory, verifiedPrefix);
             var verifiedDirectory = $"{directoryPrefix}.verified";
@@ -145,6 +145,16 @@ void InitForDirectoryConvention(string uniquenessVerified, string typeAndMethod,
         }
     }
 
+    static bool ShouldUseUniqueDirectorySplitMode(VerifySettings settings)
+    {
+        if (settings.UseUniqueDirectorySplitMode == null)
+        {
+            return VerifierSettings.UseUniqueDirectorySplitMode;
+        }
+
+        return settings.UseUniqueDirectorySplitMode.Value;
+    }
+
     void InitForFileConvention(string sharedUniqueness, Namer namer, string uniquenessVerified, string typeAndMethod, string parameters)
     {
         var uniquenessReceived = sharedUniqueness;

src/Verify/VerifySettings.cs

@@ -28,6 +28,7 @@ public VerifySettings(VerifySettings? settings)
         parametersText = settings.parametersText;
         fileName = settings.fileName;
         UniquePrefixDisabled = settings.UniquePrefixDisabled;
+        UseUniqueDirectorySplitMode = settings.UseUniqueDirectorySplitMode;
         Namer = new(settings.Namer);
         foreach (var append in settings.Appends)
         {