docs(tests): fix CommentChecker findings across tests/ — 13,392 → 0 (repo-wide scan clean)
Comment/XML-doc changes only: - add summaries to ~10k test methods, fixtures, fakes and helpers (+ <param> on theories, <returns> on async Task methods, <inheritdoc/> on interface implementations the checker can resolve) - strip ~2.6k project-tracking references (WP*, P*-*, row-NN, Task N, #NN, Component-0NN) from comments, keeping the explanatory text; reword false positives in comments only - real docs on fakes implementing BCL/library interfaces (IDisposable, ILogger, IOptionsMonitor, IAsyncLifetime) - reword the last 5 src/ false positives (CWE-1236, failures-1, year-0001, M365) Only non-comment edits: four one-line nested classes split across lines so members can carry docs. Build 0 errors / 0 warnings.
This commit is contained in:
+18
@@ -33,6 +33,7 @@ public class HighReviewRegressionTests : TestKit
|
||||
return ExpectMsg<DataConnectionHealthReport>();
|
||||
}
|
||||
|
||||
/// <summary>Verifies that a resolution tick does not duplicate an initial subscribe that is already in flight.</summary>
|
||||
[Fact]
|
||||
public void ResolutionTick_DoesNotDuplicateAnInitialSubscribeAlreadyInFlight()
|
||||
{
|
||||
@@ -56,6 +57,7 @@ public class HighReviewRegressionTests : TestKit
|
||||
finally { gate.SetResult(); }
|
||||
}
|
||||
|
||||
/// <summary>Verifies that an in-flight handle still serves a different instance after its original owner dies.</summary>
|
||||
[Fact]
|
||||
public void OriginalOwnerDies_InFlightHandleStillServesDifferentInstance()
|
||||
{
|
||||
@@ -79,6 +81,7 @@ public class HighReviewRegressionTests : TestKit
|
||||
Assert.DoesNotContain(adapter.ReceivedCalls(), c => c.GetMethodInfo().Name == "UnsubscribeAsync");
|
||||
}
|
||||
|
||||
/// <summary>Verifies that a subscriber terminating during subscribe releases the late handle without resurrecting the subscription.</summary>
|
||||
[Fact]
|
||||
public void SubscriberTermination_DuringSubscribe_ReleasesLateHandleWithoutResurrection()
|
||||
{
|
||||
@@ -97,6 +100,7 @@ public class HighReviewRegressionTests : TestKit
|
||||
Assert.Equal(0, Health(actor).ResolvedTags);
|
||||
}
|
||||
|
||||
/// <summary>Verifies that a replacement during subscribe adopts only the tags that are still requested.</summary>
|
||||
[Fact]
|
||||
public void Replacement_DuringSubscribe_AdoptsOnlyStillRequestedTags()
|
||||
{
|
||||
@@ -117,6 +121,7 @@ public class HighReviewRegressionTests : TestKit
|
||||
Assert.Equal(1, Health(actor).TotalSubscribedTags);
|
||||
}
|
||||
|
||||
/// <summary>Verifies that a subscriber terminating during resolution releases the late handle.</summary>
|
||||
[Fact]
|
||||
public void SubscriberTermination_DuringResolution_ReleasesLateHandle()
|
||||
{
|
||||
@@ -139,6 +144,7 @@ public class HighReviewRegressionTests : TestKit
|
||||
Assert.Equal(0, Health(actor).ResolvedTags);
|
||||
}
|
||||
|
||||
/// <summary>Verifies that retried subscribes while disconnected keep only the latest request.</summary>
|
||||
[Fact]
|
||||
public void DisconnectedSubscribeRetries_KeepOnlyLatestRequest()
|
||||
{
|
||||
@@ -154,6 +160,8 @@ public class HighReviewRegressionTests : TestKit
|
||||
Assert.Single(adapter.ReceivedCalls(), c => c.GetMethodInfo().Name == "SubscribeAsync");
|
||||
}
|
||||
|
||||
/// <summary>Verifies that writes while disconnected are rejected and never replayed after reconnect.</summary>
|
||||
/// <param name="reconnect">Whether the connection is re-established after the rejected write.</param>
|
||||
[Theory]
|
||||
[InlineData(false)]
|
||||
[InlineData(true)]
|
||||
@@ -180,6 +188,7 @@ public class HighReviewRegressionTests : TestKit
|
||||
Assert.DoesNotContain(adapter.ReceivedCalls(), c => c.GetMethodInfo().Name is "WriteAsync" or "WriteBatchAsync");
|
||||
}
|
||||
|
||||
/// <summary>Verifies that a subscriber terminating releases the handle of its last tag.</summary>
|
||||
[Fact]
|
||||
public void SubscriberTermination_ReleasesLastTagHandle()
|
||||
{
|
||||
@@ -192,6 +201,7 @@ public class HighReviewRegressionTests : TestKit
|
||||
AwaitCondition(() => adapter.ReceivedCalls().Any(c => c.GetMethodInfo().Name == "UnsubscribeAsync" && Equals(c.GetArguments()[0], "handle")), TimeSpan.FromSeconds(1));
|
||||
}
|
||||
|
||||
/// <summary>Verifies that an unsubscribe from the old owner does not remove the replacement's tags.</summary>
|
||||
[Fact]
|
||||
public void OldOwnerUnsubscribe_DoesNotRemoveReplacementTags()
|
||||
{
|
||||
@@ -213,6 +223,7 @@ public class HighReviewRegressionTests : TestKit
|
||||
Assert.DoesNotContain(adapter.ReceivedCalls(), c => c.GetMethodInfo().Name == "UnsubscribeAsync");
|
||||
}
|
||||
|
||||
/// <summary>Verifies that a duplicate completion with a live handle does not unsubscribe it.</summary>
|
||||
[Fact]
|
||||
public void DuplicateCompletion_WithLiveHandle_DoesNotUnsubscribeIt()
|
||||
{
|
||||
@@ -226,6 +237,7 @@ public class HighReviewRegressionTests : TestKit
|
||||
Assert.DoesNotContain(adapter.ReceivedCalls(), c => c.GetMethodInfo().Name == "UnsubscribeAsync");
|
||||
}
|
||||
|
||||
/// <summary>Verifies that a source-scoped snapshot end is not broadcast to other sources.</summary>
|
||||
[Fact]
|
||||
public void SourceScopedSnapshotEnd_IsNotBroadcastToOtherSources()
|
||||
{
|
||||
@@ -244,6 +256,8 @@ public class HighReviewRegressionTests : TestKit
|
||||
b.ExpectMsg<NativeAlarmTransitionUpdate>();
|
||||
a.ExpectNoMsg(TimeSpan.FromMilliseconds(200));
|
||||
}
|
||||
/// <summary>Verifies that a second subscriber receives the standing alarm snapshot.</summary>
|
||||
/// <param name="protocol">The data connection protocol under test.</param>
|
||||
[Theory]
|
||||
[InlineData("OpcUa")]
|
||||
[InlineData("MxGateway")]
|
||||
@@ -281,6 +295,8 @@ public class HighReviewRegressionTests : TestKit
|
||||
Assert.Contains(received.OfType<NativeAlarmTransitionUpdate>(), m => m.Transition.Kind == AlarmTransitionKind.SnapshotComplete);
|
||||
}
|
||||
|
||||
/// <summary>Verifies that a subscriber joining mid-snapshot receives the prefix already seen.</summary>
|
||||
/// <param name="scoped">Whether the snapshot is scoped to a single source.</param>
|
||||
[Theory]
|
||||
[InlineData(false)]
|
||||
[InlineData(true)]
|
||||
@@ -313,6 +329,8 @@ public class HighReviewRegressionTests : TestKit
|
||||
Assert.Equal(alarm.SnapshotId, end.Transition.SnapshotId);
|
||||
}
|
||||
|
||||
/// <summary>Verifies that replay rejects old-epoch rows and preserves a newer live clear.</summary>
|
||||
/// <param name="staleEpoch">Whether the replayed rows belong to a stale epoch.</param>
|
||||
[Theory]
|
||||
[InlineData(false)]
|
||||
[InlineData(true)]
|
||||
|
||||
Reference in New Issue
Block a user