namespace Terminal.Gui;
///
/// Represents the status of an ANSI escape sequence request made to the terminal using
/// .
///
///
public class EscSeqReqStatus
{
/// Creates a new state of escape sequence request.
/// The terminator.
/// The number of requests.
public EscSeqReqStatus (string terminator, int numReq)
{
Terminator = terminator;
NumRequests = NumOutstanding = numReq;
}
/// Gets the number of unfinished requests.
public int NumOutstanding { get; set; }
/// Gets the number of requests.
public int NumRequests { get; }
/// Gets the Escape Sequence Terminator (e.g. ESC[8t ... t is the terminator).
public string Terminator { get; }
}
// TODO: This class is a singleton. It should use the singleton pattern.
///
/// Manages ANSI Escape Sequence requests and responses. The list of contains the
/// status of the request. Each request is identified by the terminator (e.g. ESC[8t ... t is the terminator).
///
public class EscSeqRequests
{
/// Gets the list.
public List Statuses { get; } = new ();
///
/// Adds a new request for the ANSI Escape Sequence defined by . Adds a
/// instance to list.
///
/// The terminator.
/// The number of requests.
public void Add (string terminator, int numReq = 1)
{
lock (Statuses)
{
EscSeqReqStatus found = Statuses.Find (x => x.Terminator == terminator);
if (found is null)
{
Statuses.Add (new EscSeqReqStatus (terminator, numReq));
}
else if (found is { } && found.NumOutstanding < found.NumRequests)
{
found.NumOutstanding = Math.Min (found.NumOutstanding + numReq, found.NumRequests);
}
}
}
///
/// Indicates if a with the exists in the
/// list.
///
///
/// if exist, otherwise.
public bool HasResponse (string terminator)
{
lock (Statuses)
{
EscSeqReqStatus found = Statuses.Find (x => x.Terminator == terminator);
if (found is null)
{
return false;
}
if (found is { NumOutstanding: > 0 })
{
return true;
}
// BUGBUG: Why does an API that returns a bool remove the entry from the list?
// NetDriver and Unit tests never exercise this line of code. Maybe Curses does?
Statuses.Remove (found);
return false;
}
}
///
/// Removes a request defined by . If a matching is
/// found and the number of outstanding requests is greater than 0, the number of outstanding requests is decremented.
/// If the number of outstanding requests is 0, the is removed from
/// .
///
/// The terminating string.
public void Remove (string terminator)
{
lock (Statuses)
{
EscSeqReqStatus found = Statuses.Find (x => x.Terminator == terminator);
if (found is null)
{
return;
}
if (found is { } && found.NumOutstanding == 0)
{
Statuses.Remove (found);
}
else if (found is { } && found.NumOutstanding > 0)
{
found.NumOutstanding--;
if (found.NumOutstanding == 0)
{
Statuses.Remove (found);
}
}
}
}
}