ClawdDotNet/tests/ClawdDotNet.Web.Tests/Infrastructure/PlatformFacts.cs

using ClawdDotNet.Core.Instances;

namespace ClawdDotNet.Web.Tests.Infrastructure;

/// <summary>
/// A test that only says something where the instance socket is a file.
///
/// <para>Under Linux it is a Unix domain socket in the instance directory and thus an
/// entry in the file system — it survives the process, it has rights, it can be left
/// behind. Under Windows it is a named pipe: no entry, no corpse, nothing
/// to clean up.</para>
///
/// <para>Letting such tests run along under Windows would mean seeing them green without
/// anything having been checked. Hence a skip with a reason instead of a
/// silent <c>return</c>: in the report it is then visible that something was <em>not</em>
/// checked here. The same pattern as <c>LinuxFactAttribute</c> in the core tests.</para>
/// </summary>
public sealed class SocketFileFactAttribute : FactAttribute
{
    public SocketFileFactAttribute()
    {
        if (InstanceEndpoint.UsesNamedPipe)
            Skip = "Nur dort aussagekräftig, wo der Socket eine Datei ist — "
                   + "unter Windows ist er eine Named Pipe.";
    }
}