Play a recording on phone, and record it in a window

A phone function key names a wav file instead of words, which is what N1MM's
own SSB file holds: `F1 CQ,{WAVDIR}\Cq.wav`. `{WAVDIR}` is the folder named
after whoever is at the microphone, a name is taken relative to `Wav`, and
commas play several files in a row. An SSB `.mc` file written for N1MM plays
here.

Window ▸ Voice Keyer lists every recording the messages name, says which of
them are there for the operator picked at the top, plays one, and records over
one. The recording is written beside the wanted file and moved over it at the
end, so a recorder that will not start takes nothing away.

`CommandSoundCard` runs `aplay` and `arecord`, and both commands are settings:
the audio path belongs to whatever the station runs, and a library would pick
one of them for the operator. A recorder is stopped with an interrupt so it
closes its wav file, and killed only if it ignores that. PTT is cwdaemon's
`<ESC>a` for as long as the recording plays, off for a station on VOX.

Two things follow. The QTC window sends on SSB: N1MM's four recordings on the
Ready, Agn, Cfm and Close buttons, with the lines still read out by the
operator. And alternating CQ duels on phone, because the voice keyer says when
a recording has finished — which it had to, since the CQ message is picked by
the radio's mode and would otherwise have been keyed as Morse.

Nothing here has been played on a radio: this machine has no sound card, so
what is tested is the program being run, the file filled in, the exit code and
the interrupt, with shell commands standing in for the two.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_0157i7PiZyqBkquxS9A6FTdQ

tests/Nonemm.Session.Tests/AlternatingCqTests.cs

@@ -34,7 +34,7 @@ public class AlternatingCqTests
 
     private static AlternatingCq Driving(FakeKeyer keyer, List<int> called) =>
         new(
-            keyer,
+            [keyer],
             radio =>
             {
                 called.Add(radio);
@@ -154,13 +154,37 @@ public class AlternatingCqTests
         Assert.Empty(called);
     }
 
+    /// There is a keyer per mode, and a CQ that goes out through the voice
+    /// keyer has to carry the alternation on the same way a CW one does.
+    [Fact]
+    public void AMessageFinishingAtAnyOfTheKeyersMovesTheCq()
+    {
+        FakeKeyer cw = new();
+        FakeKeyer voice = new();
+        List<int> called = [];
+        using AlternatingCq cq = new(
+            [cw, voice],
+            radio =>
+            {
+                called.Add(radio);
+                return Task.CompletedTask;
+            },
+            TimeSpan.Zero,
+            NoWait);
+
+        cq.Start(1);
+        voice.FinishMessage();
+
+        Assert.Equal([1, 2], called);
+    }
+
     [Fact]
     public void AKeyerThatHasGoneAwayStopsTheWholeThing()
     {
         FakeKeyer keyer = new();
         List<string> reasons = [];
         using AlternatingCq cq = new(
-            keyer,
+            [keyer],
             _ => throw new InvalidOperationException("could not reach cwdaemon at 127.0.0.1:6789"),
             TimeSpan.Zero,
             NoWait);

tests/Nonemm.Session.Tests/VoiceLinesTests.cs

@@ -0,0 +1,69 @@
+using Nonemm.Session;
+
+namespace Nonemm.Session.Tests;
+
+/// What the voice keyer window lists: the recordings the phone function keys
+/// name, for one operator.
+public class VoiceLinesTests
+{
+    private static MessageFile Phone(string text) => MessageFile.Parse(text);
+
+    [Fact]
+    public void AKeyIsListedUnderTheFileItNames()
+    {
+        IReadOnlyList<VoiceLine> lines = VoiceLines.For(
+            Phone(@"F1 CQ,{WAVDIR}\Cq.wav"),
+            "om3kff");
+
+        VoiceLine cq = lines[0];
+        Assert.Equal("F1 run, F1 S&P", cq.Where);
+        Assert.Equal("CQ", cq.Says);
+        Assert.Equal(@"OM3KFF\Cq.wav", cq.Name);
+    }
+
+    /// Two keys naming one file are one line: there is one recording to make.
+    [Fact]
+    public void TheSameFileOnTwoKeysIsOneLine()
+    {
+        IReadOnlyList<VoiceLine> lines = VoiceLines.For(
+            Phone($"F1 CQ,Cq.wav\n{Blank(11)}F1 S&P CQ,Cq.wav"),
+            "");
+
+        VoiceLine cq = Assert.Single(lines, line => line.Name == "Cq.wav");
+        Assert.Equal("F1 run, F1 S&P", cq.Where);
+    }
+
+    /// With nobody at the microphone the recordings are the ones in the `Wav`
+    /// folder itself, not a path starting at the root.
+    [Fact]
+    public void WithNoOperatorTheFolderGoesAway()
+    {
+        IReadOnlyList<VoiceLine> lines = VoiceLines.For(Phone(@"F1 CQ,{WAVDIR}\Cq.wav"), "");
+
+        Assert.Equal("Cq.wav", lines[0].Name);
+    }
+
+    [Fact]
+    public void AKeyThatIsWordsRatherThanARecordingIsNotListed()
+    {
+        IReadOnlyList<VoiceLine> lines = VoiceLines.For(Phone("F1 CQ,CQ CONTEST OM5M"), "OM5M");
+
+        Assert.DoesNotContain(lines, line => line.Where.StartsWith("F1"));
+    }
+
+    /// WAE's four are always there: the QTC window plays them, and they are in
+    /// the `Wav` folder rather than an operator's, which is where N1MM keeps
+    /// them.
+    [Fact]
+    public void TheQtcRecordingsAreListedWhateverTheMessagesSay()
+    {
+        IReadOnlyList<VoiceLine> lines = VoiceLines.For(Phone("F1 CQ,"), "OM3KFF");
+
+        Assert.Equal(
+            [VoiceLines.QtcReady, VoiceLines.QtcAgain, VoiceLines.QtcConfirm, VoiceLines.QtcThanks],
+            lines.Select(line => line.Name));
+        Assert.All(lines, line => Assert.Equal("QTC window", line.Where));
+    }
+
+    private static string Blank(int lines) => string.Concat(Enumerable.Repeat("\n", lines));
+}