using ClawdDotNet.Core.Instances;

namespace ClawdDotNet.Web.Tests.Infrastructure;

/// <summary>
/// Ein Test, der nur dort etwas aussagt, wo der Instanz-Socket eine Datei ist.
///
/// <para>Unter Linux ist er ein Unix-Domain-Socket im Instanzverzeichnis und damit ein
/// Eintrag im Dateisystem — er überlebt den Prozess, er hat Rechte, er kann liegen
/// bleiben. Unter Windows ist er eine Named Pipe: kein Eintrag, keine Leiche, nichts
/// aufzuräumen.</para>
///
/// <para>Solche Tests unter Windows mitlaufen zu lassen hieße, sie grün zu sehen, ohne
/// dass irgendetwas geprüft wurde. Deshalb ein Übersprung mit Begründung statt eines
/// stillen <c>return</c>: Im Bericht ist dann sichtbar, dass hier etwas <em>nicht</em>
/// geprüft wurde. Dasselbe Muster wie <c>LinuxFactAttribute</c> in den Kern-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.";
    }
}