src/Pure/PIDE/command.scala
author wenzelm
Sat, 12 Nov 2011 17:52:28 +0100
changeset 45470 81b85d4ed269
parent 45455 4f974c0c5c2f
child 45644 8634b4e61b88
permissions -rw-r--r--
more precise type;
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
36676
ac7961d42ac3 some rearrangement of Scala sources;
wenzelm
parents: 36012
diff changeset
     1
/*  Title:      Pure/PIDE/command.scala
ac7961d42ac3 some rearrangement of Scala sources;
wenzelm
parents: 36012
diff changeset
     2
    Author:     Fabian Immler, TU Munich
ac7961d42ac3 some rearrangement of Scala sources;
wenzelm
parents: 36012
diff changeset
     3
    Author:     Makarius
ac7961d42ac3 some rearrangement of Scala sources;
wenzelm
parents: 36012
diff changeset
     4
ac7961d42ac3 some rearrangement of Scala sources;
wenzelm
parents: 36012
diff changeset
     5
Prover commands with semantic state.
ac7961d42ac3 some rearrangement of Scala sources;
wenzelm
parents: 36012
diff changeset
     6
*/
34407
aad6834ba380 added some headers and comments;
wenzelm
parents: 34401
diff changeset
     7
34871
e596a0b71f3c incorporate "proofdocument" part into main Isabelle/Pure.jar -- except for html_panel.scala, which depends on external library (Lobo/Cobra browser);
wenzelm
parents: 34865
diff changeset
     8
package isabelle
34318
c13e168a8ae6 original sources from Johannes Hölzl a48e0c6ab1aea77c52d596f7efc007a543d3d10c with minor modifications of directory layout;
wenzelm
parents:
diff changeset
     9
43520
cec9b95fa35d explicit import java.lang.System to prevent odd scope problems;
wenzelm
parents: 40572
diff changeset
    10
import java.lang.System
34451
3b9d0074ed44 command id via Isabelle.plugin;
wenzelm
parents: 34410
diff changeset
    11
38872
26c505765024 Command.results: ordered by serial number;
wenzelm
parents: 38723
diff changeset
    12
import scala.collection.immutable.SortedMap
26c505765024 Command.results: ordered by serial number;
wenzelm
parents: 38723
diff changeset
    13
26c505765024 Command.results: ordered by serial number;
wenzelm
parents: 38723
diff changeset
    14
34637
f3b5d6e248be added symbol_index (presently unused);
wenzelm
parents: 34603
diff changeset
    15
object Command
f3b5d6e248be added symbol_index (presently unused);
wenzelm
parents: 34603
diff changeset
    16
{
38361
b609d0b271fa specific command state;
wenzelm
parents: 38360
diff changeset
    17
  /** accumulated results from prover **/
b609d0b271fa specific command state;
wenzelm
parents: 38360
diff changeset
    18
43714
3749d1e6dde9 tuned signature;
wenzelm
parents: 43662
diff changeset
    19
  sealed case class State(
38361
b609d0b271fa specific command state;
wenzelm
parents: 38360
diff changeset
    20
    val command: Command,
38872
26c505765024 Command.results: ordered by serial number;
wenzelm
parents: 38723
diff changeset
    21
    val status: List[Markup] = Nil,
26c505765024 Command.results: ordered by serial number;
wenzelm
parents: 38723
diff changeset
    22
    val results: SortedMap[Long, XML.Tree] = SortedMap.empty,
26c505765024 Command.results: ordered by serial number;
wenzelm
parents: 38723
diff changeset
    23
    val markup: Markup_Tree = Markup_Tree.empty)
38361
b609d0b271fa specific command state;
wenzelm
parents: 38360
diff changeset
    24
  {
b609d0b271fa specific command state;
wenzelm
parents: 38360
diff changeset
    25
    /* content */
b609d0b271fa specific command state;
wenzelm
parents: 38360
diff changeset
    26
38714
31da698fc4e5 more precise Command.State accumulation;
wenzelm
parents: 38658
diff changeset
    27
    def add_status(st: Markup): State = copy(status = st :: status)
45455
4f974c0c5c2f prefer statically typed Text.Markup;
wenzelm
parents: 44959
diff changeset
    28
    def add_markup(m: Text.Markup): State = copy(markup = markup + m)
38872
26c505765024 Command.results: ordered by serial number;
wenzelm
parents: 38723
diff changeset
    29
    def add_result(serial: Long, result: XML.Tree): State =
26c505765024 Command.results: ordered by serial number;
wenzelm
parents: 38723
diff changeset
    30
      copy(results = results + (serial -> result))
38361
b609d0b271fa specific command state;
wenzelm
parents: 38360
diff changeset
    31
45455
4f974c0c5c2f prefer statically typed Text.Markup;
wenzelm
parents: 44959
diff changeset
    32
    def root_info: Text.Markup =
4f974c0c5c2f prefer statically typed Text.Markup;
wenzelm
parents: 44959
diff changeset
    33
      Text.Info(command.range,
38658
20d82e98bcd7 tuned root markup;
wenzelm
parents: 38637
diff changeset
    34
        XML.Elem(Markup(Markup.STATUS, Nil), status.reverse.map(XML.Elem(_, Nil))))
20d82e98bcd7 tuned root markup;
wenzelm
parents: 38637
diff changeset
    35
    def root_markup: Markup_Tree = markup + root_info
38361
b609d0b271fa specific command state;
wenzelm
parents: 38360
diff changeset
    36
b609d0b271fa specific command state;
wenzelm
parents: 38360
diff changeset
    37
b609d0b271fa specific command state;
wenzelm
parents: 38360
diff changeset
    38
    /* message dispatch */
b609d0b271fa specific command state;
wenzelm
parents: 38360
diff changeset
    39
38872
26c505765024 Command.results: ordered by serial number;
wenzelm
parents: 38723
diff changeset
    40
    def accumulate(message: XML.Elem): Command.State =
38361
b609d0b271fa specific command state;
wenzelm
parents: 38360
diff changeset
    41
      message match {
38714
31da698fc4e5 more precise Command.State accumulation;
wenzelm
parents: 38658
diff changeset
    42
        case XML.Elem(Markup(Markup.STATUS, _), msgs) =>
31da698fc4e5 more precise Command.State accumulation;
wenzelm
parents: 38658
diff changeset
    43
          (this /: msgs)((state, msg) =>
31da698fc4e5 more precise Command.State accumulation;
wenzelm
parents: 38658
diff changeset
    44
            msg match {
31da698fc4e5 more precise Command.State accumulation;
wenzelm
parents: 38658
diff changeset
    45
              case XML.Elem(markup, Nil) => state.add_status(markup)
31da698fc4e5 more precise Command.State accumulation;
wenzelm
parents: 38658
diff changeset
    46
              case _ => System.err.println("Ignored status message: " + msg); state
31da698fc4e5 more precise Command.State accumulation;
wenzelm
parents: 38658
diff changeset
    47
            })
38581
d503a0912e14 simplified Command.status again, reverting most of e5eed57913d0 (note that more complex information can be represented with full markup reports);
wenzelm
parents: 38579
diff changeset
    48
38572
0fe2c01ef7da Command.State: accumulate markup reports uniformly;
wenzelm
parents: 38564
diff changeset
    49
        case XML.Elem(Markup(Markup.REPORT, _), msgs) =>
0fe2c01ef7da Command.State: accumulate markup reports uniformly;
wenzelm
parents: 38564
diff changeset
    50
          (this /: msgs)((state, msg) =>
0fe2c01ef7da Command.State: accumulate markup reports uniformly;
wenzelm
parents: 38564
diff changeset
    51
            msg match {
39173
ed3946086358 Command.State.accumulate: check actual source range;
wenzelm
parents: 39172
diff changeset
    52
              case XML.Elem(Markup(name, atts @ Position.Id_Range(id, raw_range)), args)
ed3946086358 Command.State.accumulate: check actual source range;
wenzelm
parents: 39172
diff changeset
    53
              if id == command.id && command.range.contains(command.decode(raw_range)) =>
ed3946086358 Command.State.accumulate: check actual source range;
wenzelm
parents: 39172
diff changeset
    54
                val range = command.decode(raw_range)
38872
26c505765024 Command.results: ordered by serial number;
wenzelm
parents: 38723
diff changeset
    55
                val props = Position.purge(atts)
45455
4f974c0c5c2f prefer statically typed Text.Markup;
wenzelm
parents: 44959
diff changeset
    56
                val info: Text.Markup = Text.Info(range, XML.Elem(Markup(name, props), args))
38723
wenzelm
parents: 38722
diff changeset
    57
                state.add_markup(info)
40572
2315c3daee74 avoid spam;
wenzelm
parents: 40454
diff changeset
    58
              case _ =>
2315c3daee74 avoid spam;
wenzelm
parents: 40454
diff changeset
    59
                // FIXME System.err.println("Ignored report message: " + msg)
2315c3daee74 avoid spam;
wenzelm
parents: 40454
diff changeset
    60
                state
38361
b609d0b271fa specific command state;
wenzelm
parents: 38360
diff changeset
    61
            })
38872
26c505765024 Command.results: ordered by serial number;
wenzelm
parents: 38723
diff changeset
    62
        case XML.Elem(Markup(name, atts), body) =>
26c505765024 Command.results: ordered by serial number;
wenzelm
parents: 38723
diff changeset
    63
          atts match {
26c505765024 Command.results: ordered by serial number;
wenzelm
parents: 38723
diff changeset
    64
            case Markup.Serial(i) =>
38887
1261481ef5e5 Command.State: add reported positions to markup tree, according main message position or Markup.binding/entity/report occurrences in body;
wenzelm
parents: 38877
diff changeset
    65
              val result = XML.Elem(Markup(name, Position.purge(atts)), body)
39622
53365ba766ac Command.accumulate: refrain from adding tracing messages to markup tree -- potential scalability problem;
wenzelm
parents: 39441
diff changeset
    66
              val st0 = add_result(i, result)
39441
4110cc1b8f9f allow embedded reports in regular prover messages, to avoid side-effects for errors for example;
wenzelm
parents: 39173
diff changeset
    67
              val st1 =
39622
53365ba766ac Command.accumulate: refrain from adding tracing messages to markup tree -- potential scalability problem;
wenzelm
parents: 39441
diff changeset
    68
                if (Isar_Document.is_tracing(message)) st0
53365ba766ac Command.accumulate: refrain from adding tracing messages to markup tree -- potential scalability problem;
wenzelm
parents: 39441
diff changeset
    69
                else
53365ba766ac Command.accumulate: refrain from adding tracing messages to markup tree -- potential scalability problem;
wenzelm
parents: 39441
diff changeset
    70
                  (st0 /: Isar_Document.message_positions(command, message))(
53365ba766ac Command.accumulate: refrain from adding tracing messages to markup tree -- potential scalability problem;
wenzelm
parents: 39441
diff changeset
    71
                    (st, range) => st.add_markup(Text.Info(range, result)))
53365ba766ac Command.accumulate: refrain from adding tracing messages to markup tree -- potential scalability problem;
wenzelm
parents: 39441
diff changeset
    72
              val st2 = (st1 /: Isar_Document.message_reports(message))(_ accumulate _)
53365ba766ac Command.accumulate: refrain from adding tracing messages to markup tree -- potential scalability problem;
wenzelm
parents: 39441
diff changeset
    73
              st2
38872
26c505765024 Command.results: ordered by serial number;
wenzelm
parents: 38723
diff changeset
    74
            case _ => System.err.println("Ignored message without serial number: " + message); this
26c505765024 Command.results: ordered by serial number;
wenzelm
parents: 38723
diff changeset
    75
          }
38361
b609d0b271fa specific command state;
wenzelm
parents: 38360
diff changeset
    76
      }
b609d0b271fa specific command state;
wenzelm
parents: 38360
diff changeset
    77
  }
38367
f7d2574dc3a6 more basic notion of unparsed input;
wenzelm
parents: 38363
diff changeset
    78
f7d2574dc3a6 more basic notion of unparsed input;
wenzelm
parents: 38363
diff changeset
    79
40454
2516ea25a54b some support for nested source structure, based on section headings;
wenzelm
parents: 39622
diff changeset
    80
  /* dummy commands */
38367
f7d2574dc3a6 more basic notion of unparsed input;
wenzelm
parents: 38363
diff changeset
    81
40454
2516ea25a54b some support for nested source structure, based on section headings;
wenzelm
parents: 39622
diff changeset
    82
  def unparsed(source: String): Command =
44959
9476c856c4b9 Document.Node.Name convenience;
wenzelm
parents: 44615
diff changeset
    83
    new Command(Document.no_id, Document.Node.Name.empty,
44615
a4ff8a787202 more abstract Document.Node.Name;
wenzelm
parents: 44607
diff changeset
    84
      List(Token(Token.Kind.UNPARSED, source)))
40454
2516ea25a54b some support for nested source structure, based on section headings;
wenzelm
parents: 39622
diff changeset
    85
44615
a4ff8a787202 more abstract Document.Node.Name;
wenzelm
parents: 44607
diff changeset
    86
  def span(node_name: Document.Node.Name, toks: List[Token]): Command =
44607
274eff0ea12e maintain name of *the* enclosing node as part of command -- avoid full document traversal;
wenzelm
parents: 44474
diff changeset
    87
    new Command(Document.no_id, node_name, toks)
44384
8f6054a63f96 some support for editor perspective;
wenzelm
parents: 43714
diff changeset
    88
8f6054a63f96 some support for editor perspective;
wenzelm
parents: 43714
diff changeset
    89
8f6054a63f96 some support for editor perspective;
wenzelm
parents: 43714
diff changeset
    90
  /* perspective */
8f6054a63f96 some support for editor perspective;
wenzelm
parents: 43714
diff changeset
    91
44474
681447a9ffe5 slightly more abstract Command.Perspective;
wenzelm
parents: 44385
diff changeset
    92
  object Perspective
681447a9ffe5 slightly more abstract Command.Perspective;
wenzelm
parents: 44385
diff changeset
    93
  {
681447a9ffe5 slightly more abstract Command.Perspective;
wenzelm
parents: 44385
diff changeset
    94
    val empty: Perspective = Perspective(Nil)
681447a9ffe5 slightly more abstract Command.Perspective;
wenzelm
parents: 44385
diff changeset
    95
  }
44385
e7fdb008aa7d propagate editor perspective through document model;
wenzelm
parents: 44384
diff changeset
    96
44474
681447a9ffe5 slightly more abstract Command.Perspective;
wenzelm
parents: 44385
diff changeset
    97
  sealed case class Perspective(commands: List[Command])  // visible commands in canonical order
44385
e7fdb008aa7d propagate editor perspective through document model;
wenzelm
parents: 44384
diff changeset
    98
  {
44474
681447a9ffe5 slightly more abstract Command.Perspective;
wenzelm
parents: 44385
diff changeset
    99
    def same(that: Perspective): Boolean =
681447a9ffe5 slightly more abstract Command.Perspective;
wenzelm
parents: 44385
diff changeset
   100
    {
681447a9ffe5 slightly more abstract Command.Perspective;
wenzelm
parents: 44385
diff changeset
   101
      val cmds1 = this.commands
681447a9ffe5 slightly more abstract Command.Perspective;
wenzelm
parents: 44385
diff changeset
   102
      val cmds2 = that.commands
681447a9ffe5 slightly more abstract Command.Perspective;
wenzelm
parents: 44385
diff changeset
   103
      require(cmds1.forall(_.is_defined))
681447a9ffe5 slightly more abstract Command.Perspective;
wenzelm
parents: 44385
diff changeset
   104
      require(cmds2.forall(_.is_defined))
681447a9ffe5 slightly more abstract Command.Perspective;
wenzelm
parents: 44385
diff changeset
   105
      cmds1.length == cmds2.length &&
681447a9ffe5 slightly more abstract Command.Perspective;
wenzelm
parents: 44385
diff changeset
   106
        (cmds1.iterator zip cmds2.iterator).forall({ case (c1, c2) => c1.id == c2.id })
681447a9ffe5 slightly more abstract Command.Perspective;
wenzelm
parents: 44385
diff changeset
   107
    }
44385
e7fdb008aa7d propagate editor perspective through document model;
wenzelm
parents: 44384
diff changeset
   108
  }
34318
c13e168a8ae6 original sources from Johannes Hölzl a48e0c6ab1aea77c52d596f7efc007a543d3d10c with minor modifications of directory layout;
wenzelm
parents:
diff changeset
   109
}
c13e168a8ae6 original sources from Johannes Hölzl a48e0c6ab1aea77c52d596f7efc007a543d3d10c with minor modifications of directory layout;
wenzelm
parents:
diff changeset
   110
38361
b609d0b271fa specific command state;
wenzelm
parents: 38360
diff changeset
   111
34697
3d4874198e62 State: immutable;
wenzelm
parents: 34688
diff changeset
   112
class Command(
38150
67fc24df3721 simplified/refined document model: collection of named nodes, without proper dependencies yet;
wenzelm
parents: 37373
diff changeset
   113
    val id: Document.Command_ID,
44615
a4ff8a787202 more abstract Document.Node.Name;
wenzelm
parents: 44607
diff changeset
   114
    val node_name: Document.Node.Name,
38373
wenzelm
parents: 38370
diff changeset
   115
    val span: List[Token])
34451
3b9d0074ed44 command id via Isabelle.plugin;
wenzelm
parents: 34410
diff changeset
   116
{
34859
f986d84dd44b renamed Command.content to source;
wenzelm
parents: 34858
diff changeset
   117
  /* classification */
34500
384427c750c8 state_results: separate buffer for messages from running command;
wenzelm
parents: 34497
diff changeset
   118
44385
e7fdb008aa7d propagate editor perspective through document model;
wenzelm
parents: 44384
diff changeset
   119
  def is_defined: Boolean = id != Document.no_id
e7fdb008aa7d propagate editor perspective through document model;
wenzelm
parents: 44384
diff changeset
   120
36012
0614676f14d4 replaced some deprecated methods;
wenzelm
parents: 34871
diff changeset
   121
  def is_command: Boolean = !span.isEmpty && span.head.is_command
34865
104298db6abf Outer_Lex.is_ignored;
wenzelm
parents: 34860
diff changeset
   122
  def is_ignored: Boolean = span.forall(_.is_ignored)
34859
f986d84dd44b renamed Command.content to source;
wenzelm
parents: 34858
diff changeset
   123
  def is_malformed: Boolean = !is_command && !is_ignored
f986d84dd44b renamed Command.content to source;
wenzelm
parents: 34858
diff changeset
   124
36012
0614676f14d4 replaced some deprecated methods;
wenzelm
parents: 34871
diff changeset
   125
  def name: String = if (is_command) span.head.content else ""
37129
4c83696b340e Command.toString: include id for debugging;
wenzelm
parents: 36990
diff changeset
   126
  override def toString =
37373
25078ba44436 tuned Command.toString -- preserving uniqueness allows the Scala toplevel to print Linear_Set[Command] results without crashing;
wenzelm
parents: 37197
diff changeset
   127
    id + "/" + (if (is_command) name else if (is_ignored) "IGNORED" else "MALFORMED")
34495
722533c532da Command: added name field and toString;
wenzelm
parents: 34491
diff changeset
   128
34859
f986d84dd44b renamed Command.content to source;
wenzelm
parents: 34858
diff changeset
   129
f986d84dd44b renamed Command.content to source;
wenzelm
parents: 34858
diff changeset
   130
  /* source text */
34451
3b9d0074ed44 command id via Isabelle.plugin;
wenzelm
parents: 34410
diff changeset
   131
34859
f986d84dd44b renamed Command.content to source;
wenzelm
parents: 34858
diff changeset
   132
  val source: String = span.map(_.source).mkString
38426
2858ec7b6dd8 specific types Text.Offset and Text.Range;
wenzelm
parents: 38415
diff changeset
   133
  def source(range: Text.Range): String = source.substring(range.start, range.stop)
34859
f986d84dd44b renamed Command.content to source;
wenzelm
parents: 34858
diff changeset
   134
  def length: Int = source.length
38572
0fe2c01ef7da Command.State: accumulate markup reports uniformly;
wenzelm
parents: 38564
diff changeset
   135
38877
682c4932b3cc Command.newlines: account for physical newlines;
wenzelm
parents: 38872
diff changeset
   136
  val newlines =
682c4932b3cc Command.newlines: account for physical newlines;
wenzelm
parents: 38872
diff changeset
   137
    (0 /: Symbol.iterator(source)) {
682c4932b3cc Command.newlines: account for physical newlines;
wenzelm
parents: 38872
diff changeset
   138
      case (n, s) => if (Symbol.is_physical_newline(s)) n + 1 else n }
682c4932b3cc Command.newlines: account for physical newlines;
wenzelm
parents: 38872
diff changeset
   139
38479
e628da370072 more efficient Markup_Tree, based on branches sorted by quasi-order;
wenzelm
parents: 38476
diff changeset
   140
  val range: Text.Range = Text.Range(0, length)
34855
81d0410dc3ac iterators for ranges of commands/starts -- avoid extra array per document;
wenzelm
parents: 34835
diff changeset
   141
34859
f986d84dd44b renamed Command.content to source;
wenzelm
parents: 34858
diff changeset
   142
  lazy val symbol_index = new Symbol.Index(source)
38579
ce46a6f55bce tuned signature;
wenzelm
parents: 38577
diff changeset
   143
  def decode(i: Text.Offset): Text.Offset = symbol_index.decode(i)
ce46a6f55bce tuned signature;
wenzelm
parents: 38577
diff changeset
   144
  def decode(r: Text.Range): Text.Range = symbol_index.decode(r)
38370
8b15d0f98962 explicit Document.State value, instead of individual state variables in Session, Command, Document;
wenzelm
parents: 38367
diff changeset
   145
8b15d0f98962 explicit Document.State value, instead of individual state variables in Session, Command, Document;
wenzelm
parents: 38367
diff changeset
   146
8b15d0f98962 explicit Document.State value, instead of individual state variables in Session, Command, Document;
wenzelm
parents: 38367
diff changeset
   147
  /* accumulated results */
8b15d0f98962 explicit Document.State value, instead of individual state variables in Session, Command, Document;
wenzelm
parents: 38367
diff changeset
   148
38872
26c505765024 Command.results: ordered by serial number;
wenzelm
parents: 38723
diff changeset
   149
  val empty_state: Command.State = Command.State(this)
34676
9e725d34df7b Command and Command_State handle results from prover as Accumulator
immler@in.tum.de
parents: 34675
diff changeset
   150
}