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); } } } } }