src/Pure/PIDE/protocol_message.scala
author nipkow
Tue, 17 Jun 2025 14:11:40 +0200
changeset 82733 8b537e1af2ec
parent 81419 b242c7603e08
permissions -rw-r--r--
reinstated intersection of lists as inter_list_set
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
59713
6da3efec20ca clarified modules;
wenzelm
parents:
diff changeset
     1
/*  Title:      Pure/PIDE/protocol_message.scala
6da3efec20ca clarified modules;
wenzelm
parents:
diff changeset
     2
    Author:     Makarius
6da3efec20ca clarified modules;
wenzelm
parents:
diff changeset
     3
6da3efec20ca clarified modules;
wenzelm
parents:
diff changeset
     4
Auxiliary operations on protocol messages.
6da3efec20ca clarified modules;
wenzelm
parents:
diff changeset
     5
*/
6da3efec20ca clarified modules;
wenzelm
parents:
diff changeset
     6
6da3efec20ca clarified modules;
wenzelm
parents:
diff changeset
     7
package isabelle
6da3efec20ca clarified modules;
wenzelm
parents:
diff changeset
     8
6da3efec20ca clarified modules;
wenzelm
parents:
diff changeset
     9
75393
87ebf5a50283 clarified formatting, for the sake of scala3;
wenzelm
parents: 72692
diff changeset
    10
object Protocol_Message {
71620
5a4ccef7f310 more explicit type Protocol_Message.Marker;
wenzelm
parents: 59713
diff changeset
    11
  /* message markers */
5a4ccef7f310 more explicit type Protocol_Message.Marker;
wenzelm
parents: 59713
diff changeset
    12
75393
87ebf5a50283 clarified formatting, for the sake of scala3;
wenzelm
parents: 72692
diff changeset
    13
  object Marker {
71620
5a4ccef7f310 more explicit type Protocol_Message.Marker;
wenzelm
parents: 59713
diff changeset
    14
    def apply(a: String): Marker =
5a4ccef7f310 more explicit type Protocol_Message.Marker;
wenzelm
parents: 59713
diff changeset
    15
      new Marker { override def name: String = a }
71623
b3bddebe44ca clarified signature: more explicit type Protocol_Message.Marker;
wenzelm
parents: 71620
diff changeset
    16
b3bddebe44ca clarified signature: more explicit type Protocol_Message.Marker;
wenzelm
parents: 71620
diff changeset
    17
    def test(line: String): Boolean = line.startsWith("\f")
71620
5a4ccef7f310 more explicit type Protocol_Message.Marker;
wenzelm
parents: 59713
diff changeset
    18
  }
5a4ccef7f310 more explicit type Protocol_Message.Marker;
wenzelm
parents: 59713
diff changeset
    19
75393
87ebf5a50283 clarified formatting, for the sake of scala3;
wenzelm
parents: 72692
diff changeset
    20
  abstract class Marker private {
71620
5a4ccef7f310 more explicit type Protocol_Message.Marker;
wenzelm
parents: 59713
diff changeset
    21
    def name: String
5a4ccef7f310 more explicit type Protocol_Message.Marker;
wenzelm
parents: 59713
diff changeset
    22
    val prefix: String = "\f" + name + " = "
5a4ccef7f310 more explicit type Protocol_Message.Marker;
wenzelm
parents: 59713
diff changeset
    23
5a4ccef7f310 more explicit type Protocol_Message.Marker;
wenzelm
parents: 59713
diff changeset
    24
    def apply(text: String): String = prefix + Library.encode_lines(text)
5a4ccef7f310 more explicit type Protocol_Message.Marker;
wenzelm
parents: 59713
diff changeset
    25
    def apply(props: Properties.T): String = apply(YXML.string_of_body(XML.Encode.properties(props)))
5a4ccef7f310 more explicit type Protocol_Message.Marker;
wenzelm
parents: 59713
diff changeset
    26
5a4ccef7f310 more explicit type Protocol_Message.Marker;
wenzelm
parents: 59713
diff changeset
    27
    def test(line: String): Boolean = line.startsWith(prefix)
5a4ccef7f310 more explicit type Protocol_Message.Marker;
wenzelm
parents: 59713
diff changeset
    28
    def test_yxml(line: String): Boolean = test(line) && YXML.detect(line)
5a4ccef7f310 more explicit type Protocol_Message.Marker;
wenzelm
parents: 59713
diff changeset
    29
5a4ccef7f310 more explicit type Protocol_Message.Marker;
wenzelm
parents: 59713
diff changeset
    30
    def unapply(line: String): Option[String] =
5a4ccef7f310 more explicit type Protocol_Message.Marker;
wenzelm
parents: 59713
diff changeset
    31
      Library.try_unprefix(prefix, line).map(Library.decode_lines)
5a4ccef7f310 more explicit type Protocol_Message.Marker;
wenzelm
parents: 59713
diff changeset
    32
5a4ccef7f310 more explicit type Protocol_Message.Marker;
wenzelm
parents: 59713
diff changeset
    33
    override def toString: String = "Marker(" + quote(name) + ")"
5a4ccef7f310 more explicit type Protocol_Message.Marker;
wenzelm
parents: 59713
diff changeset
    34
  }
5a4ccef7f310 more explicit type Protocol_Message.Marker;
wenzelm
parents: 59713
diff changeset
    35
5a4ccef7f310 more explicit type Protocol_Message.Marker;
wenzelm
parents: 59713
diff changeset
    36
81414
ed4ff84e9b21 Document.Snapshot: support for multiple snippet_commands;
wenzelm
parents: 80872
diff changeset
    37
  /* message serial */
ed4ff84e9b21 Document.Snapshot: support for multiple snippet_commands;
wenzelm
parents: 80872
diff changeset
    38
81419
b242c7603e08 clarified signature;
wenzelm
parents: 81414
diff changeset
    39
  def get_serial(msg: XML.Elem): Long =
b242c7603e08 clarified signature;
wenzelm
parents: 81414
diff changeset
    40
    Markup.Serial.get(msg.markup.properties)
b242c7603e08 clarified signature;
wenzelm
parents: 81414
diff changeset
    41
81414
ed4ff84e9b21 Document.Snapshot: support for multiple snippet_commands;
wenzelm
parents: 80872
diff changeset
    42
  def provide_serial(msg: XML.Elem): XML.Elem =
81419
b242c7603e08 clarified signature;
wenzelm
parents: 81414
diff changeset
    43
    if (get_serial(msg) != 0L) msg
81414
ed4ff84e9b21 Document.Snapshot: support for multiple snippet_commands;
wenzelm
parents: 80872
diff changeset
    44
    else msg.copy(markup = msg.markup.update_properties(Markup.Serial(Document_ID.make())))
ed4ff84e9b21 Document.Snapshot: support for multiple snippet_commands;
wenzelm
parents: 80872
diff changeset
    45
ed4ff84e9b21 Document.Snapshot: support for multiple snippet_commands;
wenzelm
parents: 80872
diff changeset
    46
59713
6da3efec20ca clarified modules;
wenzelm
parents:
diff changeset
    47
  /* inlined reports */
6da3efec20ca clarified modules;
wenzelm
parents:
diff changeset
    48
80870
9a7de3f320d8 clarified signature;
wenzelm
parents: 80819
diff changeset
    49
  val report_elements: Markup.Elements = Markup.Elements(Markup.REPORT)
9a7de3f320d8 clarified signature;
wenzelm
parents: 80819
diff changeset
    50
  val no_report_elements: Markup.Elements = Markup.Elements(Markup.NO_REPORT)
9a7de3f320d8 clarified signature;
wenzelm
parents: 80819
diff changeset
    51
  val any_report_elements: Markup.Elements = Markup.Elements(Markup.REPORT, Markup.NO_REPORT)
59713
6da3efec20ca clarified modules;
wenzelm
parents:
diff changeset
    52
6da3efec20ca clarified modules;
wenzelm
parents:
diff changeset
    53
  def clean_reports(body: XML.Body): XML.Body =
80870
9a7de3f320d8 clarified signature;
wenzelm
parents: 80819
diff changeset
    54
    XML.filter_elements(body, remove = any_report_elements)
59713
6da3efec20ca clarified modules;
wenzelm
parents:
diff changeset
    55
6da3efec20ca clarified modules;
wenzelm
parents:
diff changeset
    56
  def reports(props: Properties.T, body: XML.Body): List[XML.Elem] =
6da3efec20ca clarified modules;
wenzelm
parents:
diff changeset
    57
    body flatMap {
6da3efec20ca clarified modules;
wenzelm
parents:
diff changeset
    58
      case XML.Wrapped_Elem(Markup(Markup.REPORT, ps), body, ts) =>
6da3efec20ca clarified modules;
wenzelm
parents:
diff changeset
    59
        List(XML.Wrapped_Elem(Markup(Markup.REPORT, props ::: ps), body, ts))
6da3efec20ca clarified modules;
wenzelm
parents:
diff changeset
    60
      case XML.Elem(Markup(Markup.REPORT, ps), ts) =>
6da3efec20ca clarified modules;
wenzelm
parents:
diff changeset
    61
        List(XML.Elem(Markup(Markup.REPORT, props ::: ps), ts))
80455
99e276c44121 minor performance tuning;
wenzelm
parents: 75393
diff changeset
    62
      case XML.Wrapped_Elem_Body(ts) => reports(props, ts)
59713
6da3efec20ca clarified modules;
wenzelm
parents:
diff changeset
    63
      case XML.Elem(_, ts) => reports(props, ts)
6da3efec20ca clarified modules;
wenzelm
parents:
diff changeset
    64
      case XML.Text(_) => Nil
6da3efec20ca clarified modules;
wenzelm
parents:
diff changeset
    65
    }
80817
e31ebb2be437 clarified signature;
wenzelm
parents: 80816
diff changeset
    66
e31ebb2be437 clarified signature;
wenzelm
parents: 80816
diff changeset
    67
e31ebb2be437 clarified signature;
wenzelm
parents: 80816
diff changeset
    68
  /* clean output */
e31ebb2be437 clarified signature;
wenzelm
parents: 80816
diff changeset
    69
80871
b71a040ab128 tuned signature: more operations;
wenzelm
parents: 80870
diff changeset
    70
  def clean_output(xml: XML.Body): XML.Body =
b71a040ab128 tuned signature: more operations;
wenzelm
parents: 80870
diff changeset
    71
    XML.filter_elements(xml, remove = report_elements, expose = no_report_elements)
b71a040ab128 tuned signature: more operations;
wenzelm
parents: 80870
diff changeset
    72
80817
e31ebb2be437 clarified signature;
wenzelm
parents: 80816
diff changeset
    73
  def clean_output(msg: String): String =
80871
b71a040ab128 tuned signature: more operations;
wenzelm
parents: 80870
diff changeset
    74
    try { XML.content(clean_output(YXML.parse_body(YXML.Source(msg)))) }
80817
e31ebb2be437 clarified signature;
wenzelm
parents: 80816
diff changeset
    75
    catch { case ERROR(_) => msg }
59713
6da3efec20ca clarified modules;
wenzelm
parents:
diff changeset
    76
}