Joseph Doherty
64e3fbe035
v2-ci / build (push) Failing after 1m43s
v2-ci / unit-tests (tests/Core/ZB.MOM.WW.OtOpcUa.Cluster.Tests) (push) Has been skipped
v2-ci / unit-tests (tests/Server/ZB.MOM.WW.OtOpcUa.ControlPlane.Tests) (push) Has been skipped
v2-ci / unit-tests (tests/Server/ZB.MOM.WW.OtOpcUa.OpcUaServer.Tests) (push) Has been skipped
v2-ci / unit-tests (tests/Server/ZB.MOM.WW.OtOpcUa.Runtime.Tests) (push) Has been skipped
v2-ci / unit-tests (tests/Server/ZB.MOM.WW.OtOpcUa.Security.Tests) (push) Has been skipped
v2-ci / integration (tests/Server/ZB.MOM.WW.OtOpcUa.Host.IntegrationTests) (push) Has been skipped
v2-ci / integration (tests/Server/ZB.MOM.WW.OtOpcUa.OpcUaServer.IntegrationTests) (push) Has been skipped
Adds <summary>, <param>, <typeparam>, and <inheritdoc/> tags to public members surfaced by commentchecker — resolves 5,847 of 5,869 issues (99.6%) across three /fixdocs passes.
66 lines
3.0 KiB
C#
66 lines
3.0 KiB
C#
using Shouldly;
|
|
using Xunit;
|
|
|
|
namespace ZB.MOM.WW.OtOpcUa.Driver.FOCAS.Cli.Tests;
|
|
|
|
/// <summary>
|
|
/// Driver.FOCAS.Cli-004: every FOCAS CLI command must own one disposal mechanism for
|
|
/// the <c>FocasDriver</c>, not two. The chosen mechanism is <c>await using var driver
|
|
/// = ...</c> — <c>FocasDriver.DisposeAsync</c> already calls <c>ShutdownAsync</c>, so
|
|
/// an additional explicit <c>driver.ShutdownAsync(...)</c> in a <c>finally</c> block
|
|
/// runs shutdown twice. These tests guard against that regression by scanning the
|
|
/// command source files.
|
|
/// </summary>
|
|
[Trait("Category", "Unit")]
|
|
public sealed class CommandDisposalConventionsTests
|
|
{
|
|
private static readonly string CommandsDir = LocateCommandsDir();
|
|
|
|
/// <summary>Verifies that a command does not explicitly call ShutdownAsync (relying on DisposeAsync instead).</summary>
|
|
/// <param name="commandFile">The command source file name to inspect.</param>
|
|
[Theory]
|
|
[InlineData("ProbeCommand.cs")]
|
|
[InlineData("ReadCommand.cs")]
|
|
[InlineData("WriteCommand.cs")]
|
|
[InlineData("SubscribeCommand.cs")]
|
|
public void Command_does_not_call_ShutdownAsync_explicitly(string commandFile)
|
|
{
|
|
var path = Path.Combine(CommandsDir, commandFile);
|
|
File.Exists(path).ShouldBeTrue($"Expected {path} to exist.");
|
|
var source = File.ReadAllText(path);
|
|
|
|
// The await-using statement is the single disposal mechanism. An explicit
|
|
// driver.ShutdownAsync(...) call (typically inside a finally block) re-invokes
|
|
// a shutdown path that DisposeAsync already runs and is the smell -004 flags.
|
|
source.ShouldNotContain("driver.ShutdownAsync(");
|
|
}
|
|
|
|
/// <summary>Verifies that a command uses await using for FocasDriver disposal.</summary>
|
|
/// <param name="commandFile">The command source file name to inspect.</param>
|
|
[Theory]
|
|
[InlineData("ProbeCommand.cs")]
|
|
[InlineData("ReadCommand.cs")]
|
|
[InlineData("WriteCommand.cs")]
|
|
[InlineData("SubscribeCommand.cs")]
|
|
public void Command_uses_await_using_for_FocasDriver(string commandFile)
|
|
{
|
|
var path = Path.Combine(CommandsDir, commandFile);
|
|
var source = File.ReadAllText(path);
|
|
|
|
source.ShouldContain("await using var driver = new FocasDriver(");
|
|
}
|
|
|
|
private static string LocateCommandsDir()
|
|
{
|
|
// Walk up from the test assembly bin/ folder to the repo root, then into the
|
|
// source project's Commands/ directory. The test-host puts CWD somewhere under
|
|
// bin/Debug/net10.0 so we resolve relative to AppContext.BaseDirectory.
|
|
var dir = new DirectoryInfo(AppContext.BaseDirectory);
|
|
while (dir is not null && !File.Exists(Path.Combine(dir.FullName, "ZB.MOM.WW.OtOpcUa.slnx")))
|
|
dir = dir.Parent;
|
|
dir.ShouldNotBeNull("Could not find solution root (ZB.MOM.WW.OtOpcUa.slnx).");
|
|
return Path.Combine(
|
|
dir!.FullName, "src", "Drivers", "Cli", "ZB.MOM.WW.OtOpcUa.Driver.FOCAS.Cli", "Commands");
|
|
}
|
|
}
|