Server.CaptureSnapshotAsync

{
  "sdk": {
    "version": "10.0.303",
    "rollForward": "disable",
    "allowPrerelease": false
  },
  "test": {
    "runner": "Microsoft.Testing.Platform"
  }
}

<?xml version="1.0" encoding="utf-8"?>
<configuration>
  <packageSources>
    <clear />
    <add key="libtmux-source" value="libtmux-source/artifacts/api-example-packages" />
    <add key="nuget.org" value="https://api.nuget.org/v3/index.json" />
  </packageSources>
  <packageSourceMapping>
    <clear />
    <packageSource key="libtmux-source">
      <package pattern="LibTmux" />
      <package pattern="LibTmux.*" />
    </packageSource>
    <packageSource key="nuget.org">
      <package pattern="*" />
    </packageSource>
  </packageSourceMapping>
</configuration>

<Project Sdk="Microsoft.NET.Sdk">
  <PropertyGroup>
    <OutputType>Exe</OutputType>
    <TargetFrameworks>net8.0;net10.0</TargetFrameworks>
    <LangVersion>12.0</LangVersion>
    <Nullable>enable</Nullable>
    <ImplicitUsings>disable</ImplicitUsings>
    <EnableDefaultCompileItems>false</EnableDefaultCompileItems>
    <TreatWarningsAsErrors>true</TreatWarningsAsErrors>
    <AnalysisLevel>10-recommended</AnalysisLevel>
  </PropertyGroup>
  <ItemGroup>
    <Compile Include="Program.cs" />
    <PackageReference Include="LibTmux" Version="[0.0.0-alpha.20]" />
  </ItemGroup>
</Project>

using System;
using System.Linq;
using System.Threading;
using LibTmux;

if (OperatingSystem.IsWindows())
{
    throw new PlatformNotSupportedException("This example requires tmux on Linux or macOS.");
}

using CancellationTokenSource deadline = new(TimeSpan.FromSeconds(10));
CancellationToken token = deadline.Token;
string binary = Environment.GetEnvironmentVariable("LIBTMUX_TMUX") ?? "tmux";
string socketName = "csharp-snapshotaccess-" + Guid.NewGuid().ToString("N");
ServerConnectionOptions options = new()
{
    SocketName = socketName,
    ConfigurationFile = "/dev/null",
    TmuxBinaryPath = binary,
};

await using OwnedServerScope owned = await Server.CreateOwnedAsync(options, token);
Server server;
await using (OwnedSessionScope session = await owned.Value.CreateOwnedSessionAsync(
    new NewSessionRequest { Name = "demo", Command = "/bin/cat" }, token))
{
    server = await Server.ConnectAsync(options, token);
    if (server.Sessions.IsCaptured)
    {
        throw new InvalidOperationException("Connecting must not capture the hierarchy.");
    }
    Console.WriteLine("Sessions have not been captured.");

    Server captured = await server.CaptureSnapshotAsync(SnapshotDepth.Panes, token);
    if (!captured.Sessions.IsCaptured)
    {
        throw new InvalidOperationException("The requested sessions were not captured.");
    }
    Session capturedSession = captured.Sessions.Single();
    if (!capturedSession.ActivePane.IsCaptured)
    {
        throw new InvalidOperationException("The active pane was not captured.");
    }
    Pane pane = capturedSession.ActivePane.Value;
    if (pane.CurrentPath is null || pane.CurrentCommand is null)
    {
        throw new InvalidOperationException("The running pane should report its path and command.");
    }
    Console.WriteLine("The captured active pane has a path and command.");
    if (server.Sessions.IsCaptured)
    {
        throw new InvalidOperationException("Capturing must return a new immutable handle.");
    }
    Console.WriteLine("The original handle is still uncaptured.");

    // Keep this private daemon alive after its only owned session is disposed.
    TmuxCommandResult result = await server.ExecuteCommandAsync(
        ["set-option", "-s", "exit-empty", "off"], token);
    if (result.ExitCode != 0)
    {
        throw new InvalidOperationException("Could not keep the empty server alive.");
    }
}
Server empty = await server.CaptureSnapshotAsync(SnapshotDepth.Sessions, token);
if (!empty.Sessions.IsCaptured || empty.Sessions.Count != 0)
{
    throw new InvalidOperationException("An empty captured relation differs from an uncaptured relation.");
}
Console.WriteLine("Captured sessions can be empty.");

Sessions have not been captured.
The captured active pane has a path and command.
The original handle is still uncaptured.
Captured sessions can be empty.