src/Pure/PIDE/session.scala
author wenzelm
Thu, 30 Jul 2015 14:02:19 +0200
changeset 60835 6512bb0b1ff4
parent 60749 f727b99faaf7
child 60900 11a0f333de6f
permissions -rw-r--r--
clarified management of (single) session; proper Debugger.Update events;
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
56210
c7c85cdb725d clarified module arrangement;
wenzelm
parents: 56208
diff changeset
     1
/*  Title:      Pure/PIDE/session.scala
36676
ac7961d42ac3 some rearrangement of Scala sources;
wenzelm
parents: 35013
diff changeset
     2
    Author:     Makarius
57923
cdae2467311d tuned comments;
wenzelm
parents: 57867
diff changeset
     3
    Options:    :folding=explicit:
36676
ac7961d42ac3 some rearrangement of Scala sources;
wenzelm
parents: 35013
diff changeset
     4
56210
c7c85cdb725d clarified module arrangement;
wenzelm
parents: 56208
diff changeset
     5
PIDE editor session, potentially with running prover process.
36676
ac7961d42ac3 some rearrangement of Scala sources;
wenzelm
parents: 35013
diff changeset
     6
*/
34777
91d6089cef88 class Session models full session, with or without prover process (cf. heaps, browser_info);
wenzelm
parents:
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: 34859
diff changeset
     8
package isabelle
34777
91d6089cef88 class Session models full session, with or without prover process (cf. heaps, browser_info);
wenzelm
parents:
diff changeset
     9
44733
329320fc88df buffer prover messages to prevent overloading of session_actor input channel -- which is critical due to synchronous messages wrt. GUI thread;
wenzelm
parents: 44732
diff changeset
    10
46771
06a9b24c4a36 explicit syslog_limit reduces danger of low-level message flooding;
wenzelm
parents: 46739
diff changeset
    11
import scala.collection.immutable.Queue
34777
91d6089cef88 class Session models full session, with or without prover process (cf. heaps, browser_info);
wenzelm
parents:
diff changeset
    12
34815
6bae73cd8e33 unified Command and Command_State, eliminated separate Accumulator;
wenzelm
parents: 34813
diff changeset
    13
34791
b97d5b38dea4 explicit object Session.Global_Settings;
wenzelm
parents: 34780
diff changeset
    14
object Session
b97d5b38dea4 explicit object Session.Global_Settings;
wenzelm
parents: 34780
diff changeset
    15
{
56715
52125652e82a clarified Session.Consumer, with Session.Outlet managed by dispatcher thread;
wenzelm
parents: 56713
diff changeset
    16
  /* outlets */
52125652e82a clarified Session.Consumer, with Session.Outlet managed by dispatcher thread;
wenzelm
parents: 56713
diff changeset
    17
52125652e82a clarified Session.Consumer, with Session.Outlet managed by dispatcher thread;
wenzelm
parents: 56713
diff changeset
    18
  object Consumer
52125652e82a clarified Session.Consumer, with Session.Outlet managed by dispatcher thread;
wenzelm
parents: 56713
diff changeset
    19
  {
52125652e82a clarified Session.Consumer, with Session.Outlet managed by dispatcher thread;
wenzelm
parents: 56713
diff changeset
    20
    def apply[A](name: String)(consume: A => Unit): Consumer[A] =
52125652e82a clarified Session.Consumer, with Session.Outlet managed by dispatcher thread;
wenzelm
parents: 56713
diff changeset
    21
      new Consumer[A](name, consume)
52125652e82a clarified Session.Consumer, with Session.Outlet managed by dispatcher thread;
wenzelm
parents: 56713
diff changeset
    22
  }
52125652e82a clarified Session.Consumer, with Session.Outlet managed by dispatcher thread;
wenzelm
parents: 56713
diff changeset
    23
  final class Consumer[-A] private(val name: String, val consume: A => Unit)
52125652e82a clarified Session.Consumer, with Session.Outlet managed by dispatcher thread;
wenzelm
parents: 56713
diff changeset
    24
52125652e82a clarified Session.Consumer, with Session.Outlet managed by dispatcher thread;
wenzelm
parents: 56713
diff changeset
    25
  class Outlet[A](dispatcher: Consumer_Thread[() => Unit])
52125652e82a clarified Session.Consumer, with Session.Outlet managed by dispatcher thread;
wenzelm
parents: 56713
diff changeset
    26
  {
52125652e82a clarified Session.Consumer, with Session.Outlet managed by dispatcher thread;
wenzelm
parents: 56713
diff changeset
    27
    private val consumers = Synchronized(List.empty[Consumer[A]])
52125652e82a clarified Session.Consumer, with Session.Outlet managed by dispatcher thread;
wenzelm
parents: 56713
diff changeset
    28
52125652e82a clarified Session.Consumer, with Session.Outlet managed by dispatcher thread;
wenzelm
parents: 56713
diff changeset
    29
    def += (c: Consumer[A]) { consumers.change(Library.update(c)) }
52125652e82a clarified Session.Consumer, with Session.Outlet managed by dispatcher thread;
wenzelm
parents: 56713
diff changeset
    30
    def -= (c: Consumer[A]) { consumers.change(Library.remove(c)) }
52125652e82a clarified Session.Consumer, with Session.Outlet managed by dispatcher thread;
wenzelm
parents: 56713
diff changeset
    31
52125652e82a clarified Session.Consumer, with Session.Outlet managed by dispatcher thread;
wenzelm
parents: 56713
diff changeset
    32
    def post(a: A)
52125652e82a clarified Session.Consumer, with Session.Outlet managed by dispatcher thread;
wenzelm
parents: 56713
diff changeset
    33
    {
52125652e82a clarified Session.Consumer, with Session.Outlet managed by dispatcher thread;
wenzelm
parents: 56713
diff changeset
    34
      for (c <- consumers.value.iterator) {
52125652e82a clarified Session.Consumer, with Session.Outlet managed by dispatcher thread;
wenzelm
parents: 56713
diff changeset
    35
        dispatcher.send(() =>
52125652e82a clarified Session.Consumer, with Session.Outlet managed by dispatcher thread;
wenzelm
parents: 56713
diff changeset
    36
          try { c.consume(a) }
52125652e82a clarified Session.Consumer, with Session.Outlet managed by dispatcher thread;
wenzelm
parents: 56713
diff changeset
    37
          catch {
52125652e82a clarified Session.Consumer, with Session.Outlet managed by dispatcher thread;
wenzelm
parents: 56713
diff changeset
    38
            case exn: Throwable =>
56782
433cf57550fa more systematic Isabelle output, like in classic Isabelle/ML (without markup);
wenzelm
parents: 56775
diff changeset
    39
              Output.error_message("Consumer failed: " + quote(c.name) + "\n" + Exn.message(exn))
56715
52125652e82a clarified Session.Consumer, with Session.Outlet managed by dispatcher thread;
wenzelm
parents: 56713
diff changeset
    40
          })
52125652e82a clarified Session.Consumer, with Session.Outlet managed by dispatcher thread;
wenzelm
parents: 56713
diff changeset
    41
      }
52125652e82a clarified Session.Consumer, with Session.Outlet managed by dispatcher thread;
wenzelm
parents: 56713
diff changeset
    42
    }
52125652e82a clarified Session.Consumer, with Session.Outlet managed by dispatcher thread;
wenzelm
parents: 56713
diff changeset
    43
  }
52125652e82a clarified Session.Consumer, with Session.Outlet managed by dispatcher thread;
wenzelm
parents: 56713
diff changeset
    44
52125652e82a clarified Session.Consumer, with Session.Outlet managed by dispatcher thread;
wenzelm
parents: 56713
diff changeset
    45
56315
c20053f67093 tuned signature;
wenzelm
parents: 56210
diff changeset
    46
  /* change */
c20053f67093 tuned signature;
wenzelm
parents: 56210
diff changeset
    47
c20053f67093 tuned signature;
wenzelm
parents: 56210
diff changeset
    48
  sealed case class Change(
c20053f67093 tuned signature;
wenzelm
parents: 56210
diff changeset
    49
    previous: Document.Version,
59077
7e0d3da6e6d8 node-specific syntax, with base_syntax as default;
wenzelm
parents: 58928
diff changeset
    50
    syntax_changed: List[Document.Node.Name],
56316
b1cf8ddc2e04 propagate deps_changed, to resolve missing files without requiring jEdit events (e.g. buffer load/save);
wenzelm
parents: 56315
diff changeset
    51
    deps_changed: Boolean,
56315
c20053f67093 tuned signature;
wenzelm
parents: 56210
diff changeset
    52
    doc_edits: List[Document.Edit_Command],
c20053f67093 tuned signature;
wenzelm
parents: 56210
diff changeset
    53
    version: Document.Version)
c20053f67093 tuned signature;
wenzelm
parents: 56210
diff changeset
    54
57976
bf99106b6672 postpone changes in intermediate state between remove_versions/removed_versions, which is important for handle_change to refer to defined items on prover side;
wenzelm
parents: 57867
diff changeset
    55
  case object Change_Flush
bf99106b6672 postpone changes in intermediate state between remove_versions/removed_versions, which is important for handle_change to refer to defined items on prover side;
wenzelm
parents: 57867
diff changeset
    56
56315
c20053f67093 tuned signature;
wenzelm
parents: 56210
diff changeset
    57
34813
f0107bc96961 more explicit modeling of Command and Command_State as Session.Entity;
wenzelm
parents: 34810
diff changeset
    58
  /* events */
f0107bc96961 more explicit modeling of Command and Command_State as Session.Entity;
wenzelm
parents: 34810
diff changeset
    59
43716
1d64662c1bfd tuned source structure;
wenzelm
parents: 43697
diff changeset
    60
  //{{{
50697
82e9178e6a98 improved Monitor_Dockable, based on ML_Statistics operations;
wenzelm
parents: 50566
diff changeset
    61
  case class Statistics(props: Properties.T)
50117
32755e357a51 update options via protocol;
wenzelm
parents: 49524
diff changeset
    62
  case class Global_Options(options: Options)
44805
48a5c104d434 clarified terminology;
wenzelm
parents: 44775
diff changeset
    63
  case object Caret_Focus
54521
744ea0025e11 clarified Document.Blobs environment vs. actual edits of auxiliary files;
wenzelm
parents: 54519
diff changeset
    64
  case class Raw_Edits(doc_blobs: Document.Blobs, edits: List[Document.Edit_Text])
52531
21f8e0e151f5 tuned signature;
wenzelm
parents: 52530
diff changeset
    65
  case class Dialog_Result(id: Document_ID.Generic, serial: Long, result: String)
59364
3b5da177ae6b clarified build_theories;
wenzelm
parents: 59362
diff changeset
    66
  case class Build_Theories(id: String, master_dir: Path, theories: List[(Options, List[Path])])
47027
fc3bb6c02a3c explicit propagation of assignment event, even if changed command set is empty;
wenzelm
parents: 46944
diff changeset
    67
  case class Commands_Changed(
fc3bb6c02a3c explicit propagation of assignment event, even if changed command set is empty;
wenzelm
parents: 46944
diff changeset
    68
    assignment: Boolean, nodes: Set[Document.Node.Name], commands: Set[Command])
39630
44181423183a explicit Session.Phase indication with associated event bus;
wenzelm
parents: 39629
diff changeset
    69
44181423183a explicit Session.Phase indication with associated event bus;
wenzelm
parents: 39629
diff changeset
    70
  sealed abstract class Phase
44181423183a explicit Session.Phase indication with associated event bus;
wenzelm
parents: 39629
diff changeset
    71
  case object Inactive extends Phase
39701
7c351c1c0624 simplified / clarified Session.Phase;
wenzelm
parents: 39698
diff changeset
    72
  case object Startup extends Phase  // transient
7c351c1c0624 simplified / clarified Session.Phase;
wenzelm
parents: 39698
diff changeset
    73
  case object Failed extends Phase
39630
44181423183a explicit Session.Phase indication with associated event bus;
wenzelm
parents: 39629
diff changeset
    74
  case object Ready extends Phase
39701
7c351c1c0624 simplified / clarified Session.Phase;
wenzelm
parents: 39698
diff changeset
    75
  case object Shutdown extends Phase  // transient
43716
1d64662c1bfd tuned source structure;
wenzelm
parents: 43697
diff changeset
    76
  //}}}
52111
1fd184eaa310 explicit management of Session.Protocol_Handlers, with protocol state and functions;
wenzelm
parents: 52084
diff changeset
    77
1fd184eaa310 explicit management of Session.Protocol_Handlers, with protocol state and functions;
wenzelm
parents: 52084
diff changeset
    78
56775
59f70b89e5fd improved syslog performance -- avoid denial-of-service e.g. with threads_trace = 5 and active Syslog dockable;
wenzelm
parents: 56772
diff changeset
    79
  /* syslog */
59f70b89e5fd improved syslog performance -- avoid denial-of-service e.g. with threads_trace = 5 and active Syslog dockable;
wenzelm
parents: 56772
diff changeset
    80
59f70b89e5fd improved syslog performance -- avoid denial-of-service e.g. with threads_trace = 5 and active Syslog dockable;
wenzelm
parents: 56772
diff changeset
    81
  private[Session] class Syslog(limit: Int)
59f70b89e5fd improved syslog performance -- avoid denial-of-service e.g. with threads_trace = 5 and active Syslog dockable;
wenzelm
parents: 56772
diff changeset
    82
  {
59f70b89e5fd improved syslog performance -- avoid denial-of-service e.g. with threads_trace = 5 and active Syslog dockable;
wenzelm
parents: 56772
diff changeset
    83
    private var queue = Queue.empty[XML.Elem]
59f70b89e5fd improved syslog performance -- avoid denial-of-service e.g. with threads_trace = 5 and active Syslog dockable;
wenzelm
parents: 56772
diff changeset
    84
    private var length = 0
59f70b89e5fd improved syslog performance -- avoid denial-of-service e.g. with threads_trace = 5 and active Syslog dockable;
wenzelm
parents: 56772
diff changeset
    85
59f70b89e5fd improved syslog performance -- avoid denial-of-service e.g. with threads_trace = 5 and active Syslog dockable;
wenzelm
parents: 56772
diff changeset
    86
    def += (msg: XML.Elem): Unit = synchronized {
59f70b89e5fd improved syslog performance -- avoid denial-of-service e.g. with threads_trace = 5 and active Syslog dockable;
wenzelm
parents: 56772
diff changeset
    87
      queue = queue.enqueue(msg)
59f70b89e5fd improved syslog performance -- avoid denial-of-service e.g. with threads_trace = 5 and active Syslog dockable;
wenzelm
parents: 56772
diff changeset
    88
      length += 1
59f70b89e5fd improved syslog performance -- avoid denial-of-service e.g. with threads_trace = 5 and active Syslog dockable;
wenzelm
parents: 56772
diff changeset
    89
      if (length > limit) queue = queue.dequeue._2
59f70b89e5fd improved syslog performance -- avoid denial-of-service e.g. with threads_trace = 5 and active Syslog dockable;
wenzelm
parents: 56772
diff changeset
    90
    }
59f70b89e5fd improved syslog performance -- avoid denial-of-service e.g. with threads_trace = 5 and active Syslog dockable;
wenzelm
parents: 56772
diff changeset
    91
59f70b89e5fd improved syslog performance -- avoid denial-of-service e.g. with threads_trace = 5 and active Syslog dockable;
wenzelm
parents: 56772
diff changeset
    92
    def content: String = synchronized {
59f70b89e5fd improved syslog performance -- avoid denial-of-service e.g. with threads_trace = 5 and active Syslog dockable;
wenzelm
parents: 56772
diff changeset
    93
      cat_lines(queue.iterator.map(XML.content)) +
59f70b89e5fd improved syslog performance -- avoid denial-of-service e.g. with threads_trace = 5 and active Syslog dockable;
wenzelm
parents: 56772
diff changeset
    94
      (if (length > limit) "\n(A total of " + length + " messages...)" else "")
59f70b89e5fd improved syslog performance -- avoid denial-of-service e.g. with threads_trace = 5 and active Syslog dockable;
wenzelm
parents: 56772
diff changeset
    95
    }
59f70b89e5fd improved syslog performance -- avoid denial-of-service e.g. with threads_trace = 5 and active Syslog dockable;
wenzelm
parents: 56772
diff changeset
    96
  }
59f70b89e5fd improved syslog performance -- avoid denial-of-service e.g. with threads_trace = 5 and active Syslog dockable;
wenzelm
parents: 56772
diff changeset
    97
59f70b89e5fd improved syslog performance -- avoid denial-of-service e.g. with threads_trace = 5 and active Syslog dockable;
wenzelm
parents: 56772
diff changeset
    98
52111
1fd184eaa310 explicit management of Session.Protocol_Handlers, with protocol state and functions;
wenzelm
parents: 52084
diff changeset
    99
  /* protocol handlers */
1fd184eaa310 explicit management of Session.Protocol_Handlers, with protocol state and functions;
wenzelm
parents: 52084
diff changeset
   100
1fd184eaa310 explicit management of Session.Protocol_Handlers, with protocol state and functions;
wenzelm
parents: 52084
diff changeset
   101
  abstract class Protocol_Handler
1fd184eaa310 explicit management of Session.Protocol_Handlers, with protocol state and functions;
wenzelm
parents: 52084
diff changeset
   102
  {
56864
0446c7ac2e32 support print operations as asynchronous query;
wenzelm
parents: 56799
diff changeset
   103
    def start(prover: Prover): Unit = {}
52111
1fd184eaa310 explicit management of Session.Protocol_Handlers, with protocol state and functions;
wenzelm
parents: 52084
diff changeset
   104
    def stop(prover: Prover): Unit = {}
56385
76acce58aeab more general prover operations;
wenzelm
parents: 56335
diff changeset
   105
    val functions: Map[String, (Prover, Prover.Protocol_Output) => Boolean]
52111
1fd184eaa310 explicit management of Session.Protocol_Handlers, with protocol state and functions;
wenzelm
parents: 52084
diff changeset
   106
  }
1fd184eaa310 explicit management of Session.Protocol_Handlers, with protocol state and functions;
wenzelm
parents: 52084
diff changeset
   107
59367
6193bbbbe564 more type-safe handler interface;
wenzelm
parents: 59366
diff changeset
   108
  def bad_protocol_handler(exn: Throwable, name: String): Unit =
6193bbbbe564 more type-safe handler interface;
wenzelm
parents: 59366
diff changeset
   109
    Output.error_message(
6193bbbbe564 more type-safe handler interface;
wenzelm
parents: 59366
diff changeset
   110
      "Failed to initialize protocol handler: " + quote(name) + "\n" + Exn.message(exn))
6193bbbbe564 more type-safe handler interface;
wenzelm
parents: 59366
diff changeset
   111
59366
e94df7f6b608 clarified build_theories: proper protocol handler;
wenzelm
parents: 59364
diff changeset
   112
  private class Protocol_Handlers(
52111
1fd184eaa310 explicit management of Session.Protocol_Handlers, with protocol state and functions;
wenzelm
parents: 52084
diff changeset
   113
    handlers: Map[String, Session.Protocol_Handler] = Map.empty,
56385
76acce58aeab more general prover operations;
wenzelm
parents: 56335
diff changeset
   114
    functions: Map[String, Prover.Protocol_Output => Boolean] = Map.empty)
52111
1fd184eaa310 explicit management of Session.Protocol_Handlers, with protocol state and functions;
wenzelm
parents: 52084
diff changeset
   115
  {
53054
8365d7fca3de public access for protocol handlers and protocol commands -- to be used within reason;
wenzelm
parents: 52931
diff changeset
   116
    def get(name: String): Option[Protocol_Handler] = handlers.get(name)
8365d7fca3de public access for protocol handlers and protocol commands -- to be used within reason;
wenzelm
parents: 52931
diff changeset
   117
59367
6193bbbbe564 more type-safe handler interface;
wenzelm
parents: 59366
diff changeset
   118
    def add(prover: Prover, handler: Protocol_Handler): Protocol_Handlers =
52111
1fd184eaa310 explicit management of Session.Protocol_Handlers, with protocol state and functions;
wenzelm
parents: 52084
diff changeset
   119
    {
59367
6193bbbbe564 more type-safe handler interface;
wenzelm
parents: 59366
diff changeset
   120
      val name = handler.getClass.getName
6193bbbbe564 more type-safe handler interface;
wenzelm
parents: 59366
diff changeset
   121
52111
1fd184eaa310 explicit management of Session.Protocol_Handlers, with protocol state and functions;
wenzelm
parents: 52084
diff changeset
   122
      val (handlers1, functions1) =
1fd184eaa310 explicit management of Session.Protocol_Handlers, with protocol state and functions;
wenzelm
parents: 52084
diff changeset
   123
        handlers.get(name) match {
1fd184eaa310 explicit management of Session.Protocol_Handlers, with protocol state and functions;
wenzelm
parents: 52084
diff changeset
   124
          case Some(old_handler) =>
56782
433cf57550fa more systematic Isabelle output, like in classic Isabelle/ML (without markup);
wenzelm
parents: 56775
diff changeset
   125
            Output.warning("Redefining protocol handler: " + name)
52111
1fd184eaa310 explicit management of Session.Protocol_Handlers, with protocol state and functions;
wenzelm
parents: 52084
diff changeset
   126
            old_handler.stop(prover)
1fd184eaa310 explicit management of Session.Protocol_Handlers, with protocol state and functions;
wenzelm
parents: 52084
diff changeset
   127
            (handlers - name, functions -- old_handler.functions.keys)
1fd184eaa310 explicit management of Session.Protocol_Handlers, with protocol state and functions;
wenzelm
parents: 52084
diff changeset
   128
          case None => (handlers, functions)
1fd184eaa310 explicit management of Session.Protocol_Handlers, with protocol state and functions;
wenzelm
parents: 52084
diff changeset
   129
        }
1fd184eaa310 explicit management of Session.Protocol_Handlers, with protocol state and functions;
wenzelm
parents: 52084
diff changeset
   130
1fd184eaa310 explicit management of Session.Protocol_Handlers, with protocol state and functions;
wenzelm
parents: 52084
diff changeset
   131
      val (handlers2, functions2) =
1fd184eaa310 explicit management of Session.Protocol_Handlers, with protocol state and functions;
wenzelm
parents: 52084
diff changeset
   132
        try {
59367
6193bbbbe564 more type-safe handler interface;
wenzelm
parents: 59366
diff changeset
   133
          handler.start(prover)
56864
0446c7ac2e32 support print operations as asynchronous query;
wenzelm
parents: 56799
diff changeset
   134
52111
1fd184eaa310 explicit management of Session.Protocol_Handlers, with protocol state and functions;
wenzelm
parents: 52084
diff changeset
   135
          val new_functions =
59367
6193bbbbe564 more type-safe handler interface;
wenzelm
parents: 59366
diff changeset
   136
            for ((a, f) <- handler.functions.toList) yield
56385
76acce58aeab more general prover operations;
wenzelm
parents: 56335
diff changeset
   137
              (a, (msg: Prover.Protocol_Output) => f(prover, msg))
52111
1fd184eaa310 explicit management of Session.Protocol_Handlers, with protocol state and functions;
wenzelm
parents: 52084
diff changeset
   138
1fd184eaa310 explicit management of Session.Protocol_Handlers, with protocol state and functions;
wenzelm
parents: 52084
diff changeset
   139
          val dups = for ((a, _) <- new_functions if functions1.isDefinedAt(a)) yield a
59319
wenzelm
parents: 59086
diff changeset
   140
          if (dups.nonEmpty) error("Duplicate protocol functions: " + commas_quote(dups))
52111
1fd184eaa310 explicit management of Session.Protocol_Handlers, with protocol state and functions;
wenzelm
parents: 52084
diff changeset
   141
59367
6193bbbbe564 more type-safe handler interface;
wenzelm
parents: 59366
diff changeset
   142
          (handlers1 + (name -> handler), functions1 ++ new_functions)
52111
1fd184eaa310 explicit management of Session.Protocol_Handlers, with protocol state and functions;
wenzelm
parents: 52084
diff changeset
   143
        }
1fd184eaa310 explicit management of Session.Protocol_Handlers, with protocol state and functions;
wenzelm
parents: 52084
diff changeset
   144
        catch {
1fd184eaa310 explicit management of Session.Protocol_Handlers, with protocol state and functions;
wenzelm
parents: 52084
diff changeset
   145
          case exn: Throwable =>
59367
6193bbbbe564 more type-safe handler interface;
wenzelm
parents: 59366
diff changeset
   146
            Session.bad_protocol_handler(exn, name)
52111
1fd184eaa310 explicit management of Session.Protocol_Handlers, with protocol state and functions;
wenzelm
parents: 52084
diff changeset
   147
            (handlers1, functions1)
1fd184eaa310 explicit management of Session.Protocol_Handlers, with protocol state and functions;
wenzelm
parents: 52084
diff changeset
   148
        }
1fd184eaa310 explicit management of Session.Protocol_Handlers, with protocol state and functions;
wenzelm
parents: 52084
diff changeset
   149
1fd184eaa310 explicit management of Session.Protocol_Handlers, with protocol state and functions;
wenzelm
parents: 52084
diff changeset
   150
      new Protocol_Handlers(handlers2, functions2)
1fd184eaa310 explicit management of Session.Protocol_Handlers, with protocol state and functions;
wenzelm
parents: 52084
diff changeset
   151
    }
1fd184eaa310 explicit management of Session.Protocol_Handlers, with protocol state and functions;
wenzelm
parents: 52084
diff changeset
   152
56385
76acce58aeab more general prover operations;
wenzelm
parents: 56335
diff changeset
   153
    def invoke(msg: Prover.Protocol_Output): Boolean =
54442
c39972ddd672 more specific Protocol_Output: empty message.body, main content via bytes/text;
wenzelm
parents: 53054
diff changeset
   154
      msg.properties match {
52111
1fd184eaa310 explicit management of Session.Protocol_Handlers, with protocol state and functions;
wenzelm
parents: 52084
diff changeset
   155
        case Markup.Function(a) if functions.isDefinedAt(a) =>
54442
c39972ddd672 more specific Protocol_Output: empty message.body, main content via bytes/text;
wenzelm
parents: 53054
diff changeset
   156
          try { functions(a)(msg) }
52111
1fd184eaa310 explicit management of Session.Protocol_Handlers, with protocol state and functions;
wenzelm
parents: 52084
diff changeset
   157
          catch {
1fd184eaa310 explicit management of Session.Protocol_Handlers, with protocol state and functions;
wenzelm
parents: 52084
diff changeset
   158
            case exn: Throwable =>
56782
433cf57550fa more systematic Isabelle output, like in classic Isabelle/ML (without markup);
wenzelm
parents: 56775
diff changeset
   159
              Output.error_message(
433cf57550fa more systematic Isabelle output, like in classic Isabelle/ML (without markup);
wenzelm
parents: 56775
diff changeset
   160
                "Failed invocation of protocol function: " + quote(a) + "\n" + Exn.message(exn))
52111
1fd184eaa310 explicit management of Session.Protocol_Handlers, with protocol state and functions;
wenzelm
parents: 52084
diff changeset
   161
            false
1fd184eaa310 explicit management of Session.Protocol_Handlers, with protocol state and functions;
wenzelm
parents: 52084
diff changeset
   162
          }
1fd184eaa310 explicit management of Session.Protocol_Handlers, with protocol state and functions;
wenzelm
parents: 52084
diff changeset
   163
        case _ => false
1fd184eaa310 explicit management of Session.Protocol_Handlers, with protocol state and functions;
wenzelm
parents: 52084
diff changeset
   164
      }
52113
2d2b049429f3 stop protocol handlers as well;
wenzelm
parents: 52111
diff changeset
   165
2d2b049429f3 stop protocol handlers as well;
wenzelm
parents: 52111
diff changeset
   166
    def stop(prover: Prover): Protocol_Handlers =
2d2b049429f3 stop protocol handlers as well;
wenzelm
parents: 52111
diff changeset
   167
    {
2d2b049429f3 stop protocol handlers as well;
wenzelm
parents: 52111
diff changeset
   168
      for ((_, handler) <- handlers) handler.stop(prover)
2d2b049429f3 stop protocol handlers as well;
wenzelm
parents: 52111
diff changeset
   169
      new Protocol_Handlers()
2d2b049429f3 stop protocol handlers as well;
wenzelm
parents: 52111
diff changeset
   170
    }
52111
1fd184eaa310 explicit management of Session.Protocol_Handlers, with protocol state and functions;
wenzelm
parents: 52084
diff changeset
   171
  }
34791
b97d5b38dea4 explicit object Session.Global_Settings;
wenzelm
parents: 34780
diff changeset
   172
}
b97d5b38dea4 explicit object Session.Global_Settings;
wenzelm
parents: 34780
diff changeset
   173
34777
91d6089cef88 class Session models full session, with or without prover process (cf. heaps, browser_info);
wenzelm
parents:
diff changeset
   174
56208
06cc31dff138 clarifed module name;
wenzelm
parents: 55801
diff changeset
   175
class Session(val resources: Resources)
34777
91d6089cef88 class Session models full session, with or without prover process (cf. heaps, browser_info);
wenzelm
parents:
diff changeset
   176
{
47653
4605d4341b8b some builtin session timing;
wenzelm
parents: 47629
diff changeset
   177
  /* global flags */
4605d4341b8b some builtin session timing;
wenzelm
parents: 47629
diff changeset
   178
4605d4341b8b some builtin session timing;
wenzelm
parents: 47629
diff changeset
   179
  @volatile var timing: Boolean = false
4605d4341b8b some builtin session timing;
wenzelm
parents: 47629
diff changeset
   180
  @volatile var verbose: Boolean = false
4605d4341b8b some builtin session timing;
wenzelm
parents: 47629
diff changeset
   181
4605d4341b8b some builtin session timing;
wenzelm
parents: 47629
diff changeset
   182
49288
2c9272cb4568 more options;
wenzelm
parents: 49250
diff changeset
   183
  /* tuning parameters */
2c9272cb4568 more options;
wenzelm
parents: 49250
diff changeset
   184
2c9272cb4568 more options;
wenzelm
parents: 49250
diff changeset
   185
  def output_delay: Time = Time.seconds(0.1)  // prover output (markup, common messages)
57867
abae8aff6262 added system option editor_output_delay: lower value might help big sessions under low-memory situations;
wenzelm
parents: 57866
diff changeset
   186
  def prune_delay: Time = Time.seconds(60.0)  // prune history (delete old versions)
49293
afcccb9bfa3b prefer tuning parameters as public methods (again) -- to allow overriding in applications;
wenzelm
parents: 49288
diff changeset
   187
  def prune_size: Int = 0  // size of retained history
afcccb9bfa3b prefer tuning parameters as public methods (again) -- to allow overriding in applications;
wenzelm
parents: 49288
diff changeset
   188
  def syslog_limit: Int = 100
49524
68796a77c42b Thy_Syntax.consolidate_spans is subject to editor_reparse_limit, for improved experience of unbalanced comments etc.;
wenzelm
parents: 49523
diff changeset
   189
  def reparse_limit: Int = 0
37849
4f9de312cc23 Session: predefined real time parameters;
wenzelm
parents: 37689
diff changeset
   190
4f9de312cc23 Session: predefined real time parameters;
wenzelm
parents: 37689
diff changeset
   191
56715
52125652e82a clarified Session.Consumer, with Session.Outlet managed by dispatcher thread;
wenzelm
parents: 56713
diff changeset
   192
  /* outlets */
52125652e82a clarified Session.Consumer, with Session.Outlet managed by dispatcher thread;
wenzelm
parents: 56713
diff changeset
   193
52125652e82a clarified Session.Consumer, with Session.Outlet managed by dispatcher thread;
wenzelm
parents: 56713
diff changeset
   194
  private val dispatcher =
52125652e82a clarified Session.Consumer, with Session.Outlet managed by dispatcher thread;
wenzelm
parents: 56713
diff changeset
   195
    Consumer_Thread.fork[() => Unit]("Session.dispatcher", daemon = true) { case e => e(); true }
34809
0fed930f2992 misc tuning;
wenzelm
parents: 34808
diff changeset
   196
56715
52125652e82a clarified Session.Consumer, with Session.Outlet managed by dispatcher thread;
wenzelm
parents: 56713
diff changeset
   197
  val statistics = new Session.Outlet[Session.Statistics](dispatcher)
52125652e82a clarified Session.Consumer, with Session.Outlet managed by dispatcher thread;
wenzelm
parents: 56713
diff changeset
   198
  val global_options = new Session.Outlet[Session.Global_Options](dispatcher)
52125652e82a clarified Session.Consumer, with Session.Outlet managed by dispatcher thread;
wenzelm
parents: 56713
diff changeset
   199
  val caret_focus = new Session.Outlet[Session.Caret_Focus.type](dispatcher)
52125652e82a clarified Session.Consumer, with Session.Outlet managed by dispatcher thread;
wenzelm
parents: 56713
diff changeset
   200
  val raw_edits = new Session.Outlet[Session.Raw_Edits](dispatcher)
52125652e82a clarified Session.Consumer, with Session.Outlet managed by dispatcher thread;
wenzelm
parents: 56713
diff changeset
   201
  val commands_changed = new Session.Outlet[Session.Commands_Changed](dispatcher)
52125652e82a clarified Session.Consumer, with Session.Outlet managed by dispatcher thread;
wenzelm
parents: 56713
diff changeset
   202
  val phase_changed = new Session.Outlet[Session.Phase](dispatcher)
52125652e82a clarified Session.Consumer, with Session.Outlet managed by dispatcher thread;
wenzelm
parents: 56713
diff changeset
   203
  val syslog_messages = new Session.Outlet[Prover.Output](dispatcher)
52125652e82a clarified Session.Consumer, with Session.Outlet managed by dispatcher thread;
wenzelm
parents: 56713
diff changeset
   204
  val raw_output_messages = new Session.Outlet[Prover.Output](dispatcher)
52125652e82a clarified Session.Consumer, with Session.Outlet managed by dispatcher thread;
wenzelm
parents: 56713
diff changeset
   205
  val trace_events = new Session.Outlet[Simplifier_Trace.Event.type](dispatcher)
60835
6512bb0b1ff4 clarified management of (single) session;
wenzelm
parents: 60749
diff changeset
   206
  val debugger_updates = new Session.Outlet[Debugger.Update](dispatcher)
34809
0fed930f2992 misc tuning;
wenzelm
parents: 34808
diff changeset
   207
60749
f727b99faaf7 skeleton for interactive debugger;
wenzelm
parents: 60075
diff changeset
   208
  val all_messages = new Session.Outlet[Prover.Message](dispatcher)  // potential bottle-neck!
34809
0fed930f2992 misc tuning;
wenzelm
parents: 34808
diff changeset
   209
56706
f2f53f7046f4 converted main session manager to Consumer_Thread: messages need to be consumed immediately, postponed_changes replaces implicit actor mailbox scanning;
wenzelm
parents: 56705
diff changeset
   210
56799
wenzelm
parents: 56793
diff changeset
   211
  /** main protocol manager **/
45635
d9cf3520083c explicit change_parser thread, which avoids undirected Future.fork with its tendency towards hundreds of worker threads;
wenzelm
parents: 45633
diff changeset
   212
56799
wenzelm
parents: 56793
diff changeset
   213
  /* internal messages */
45635
d9cf3520083c explicit change_parser thread, which avoids undirected Future.fork with its tendency towards hundreds of worker threads;
wenzelm
parents: 45633
diff changeset
   214
56799
wenzelm
parents: 56793
diff changeset
   215
  private case class Start(name: String, args: List[String])
wenzelm
parents: 56793
diff changeset
   216
  private case object Stop
wenzelm
parents: 56793
diff changeset
   217
  private case class Cancel_Exec(exec_id: Document_ID.Exec)
wenzelm
parents: 56793
diff changeset
   218
  private case class Protocol_Command(name: String, args: List[String])
wenzelm
parents: 56793
diff changeset
   219
  private case class Update_Options(options: Options)
wenzelm
parents: 56793
diff changeset
   220
  private case object Prune_History
45635
d9cf3520083c explicit change_parser thread, which avoids undirected Future.fork with its tendency towards hundreds of worker threads;
wenzelm
parents: 45633
diff changeset
   221
38841
4df7b76249a0 include Document.History in Document.State -- just one universal session state maintained by main actor;
wenzelm
parents: 38722
diff changeset
   222
43651
511df47bcadc some support for theory files within Isabelle/Scala session;
wenzelm
parents: 43649
diff changeset
   223
  /* global state */
43644
ea08ce1c314b tuned signature;
wenzelm
parents: 43553
diff changeset
   224
56775
59f70b89e5fd improved syslog performance -- avoid denial-of-service e.g. with threads_trace = 5 and active Syslog dockable;
wenzelm
parents: 56772
diff changeset
   225
  private val syslog = new Session.Syslog(syslog_limit)
59f70b89e5fd improved syslog performance -- avoid denial-of-service e.g. with threads_trace = 5 and active Syslog dockable;
wenzelm
parents: 56772
diff changeset
   226
  def syslog_content(): String = syslog.content
39626
a5d0bcfb95a3 manage persistent syslog via Session, not Isabelle_Process;
wenzelm
parents: 39625
diff changeset
   227
39630
44181423183a explicit Session.Phase indication with associated event bus;
wenzelm
parents: 39629
diff changeset
   228
  @volatile private var _phase: Session.Phase = Session.Inactive
39633
26a28110ece5 simplified Session.Phase;
wenzelm
parents: 39630
diff changeset
   229
  private def phase_=(new_phase: Session.Phase)
39630
44181423183a explicit Session.Phase indication with associated event bus;
wenzelm
parents: 39629
diff changeset
   230
  {
44181423183a explicit Session.Phase indication with associated event bus;
wenzelm
parents: 39629
diff changeset
   231
    _phase = new_phase
56715
52125652e82a clarified Session.Consumer, with Session.Outlet managed by dispatcher thread;
wenzelm
parents: 56713
diff changeset
   232
    phase_changed.post(new_phase)
39630
44181423183a explicit Session.Phase indication with associated event bus;
wenzelm
parents: 39629
diff changeset
   233
  }
43716
1d64662c1bfd tuned source structure;
wenzelm
parents: 43697
diff changeset
   234
  def phase = _phase
43553
df80747342cb proper tokens only if session is ready;
wenzelm
parents: 43520
diff changeset
   235
  def is_ready: Boolean = phase == Session.Ready
39630
44181423183a explicit Session.Phase indication with associated event bus;
wenzelm
parents: 39629
diff changeset
   236
56690
69b31dc7256e eliminated redundant Volatile;
wenzelm
parents: 56687
diff changeset
   237
  private val global_state = Synchronized(Document.State.init)
56687
7fb98325722a tuned signature in accordance to ML version;
wenzelm
parents: 56671
diff changeset
   238
  def current_state(): Document.State = global_state.value
46944
9fc22eb6408c more recent recent_syntax, e.g. relevant for document rendering during startup;
wenzelm
parents: 46942
diff changeset
   239
59077
7e0d3da6e6d8 node-specific syntax, with base_syntax as default;
wenzelm
parents: 58928
diff changeset
   240
  def recent_syntax(name: Document.Node.Name): Prover.Syntax =
7e0d3da6e6d8 node-specific syntax, with base_syntax as default;
wenzelm
parents: 58928
diff changeset
   241
    current_state().recent_finished.version.get_finished.nodes(name).syntax getOrElse
7e0d3da6e6d8 node-specific syntax, with base_syntax as default;
wenzelm
parents: 58928
diff changeset
   242
    resources.base_syntax
34816
d33312514220 maintain generic session entities -- cover commands, states, etc. (but not yet documents);
wenzelm
parents: 34815
diff changeset
   243
43651
511df47bcadc some support for theory files within Isabelle/Scala session;
wenzelm
parents: 43649
diff changeset
   244
511df47bcadc some support for theory files within Isabelle/Scala session;
wenzelm
parents: 43649
diff changeset
   245
  /* theory files */
511df47bcadc some support for theory files within Isabelle/Scala session;
wenzelm
parents: 43649
diff changeset
   246
48707
ba531af91148 simplified Document.Node.Header -- internalized errors;
wenzelm
parents: 48422
diff changeset
   247
  def header_edit(name: Document.Node.Name, header: Document.Node.Header): Document.Edit_Text =
44442
cb18e4f09053 clarified norm_header/header_edit -- disallow update of loaded theories;
wenzelm
parents: 44436
diff changeset
   248
  {
48707
ba531af91148 simplified Document.Node.Header -- internalized errors;
wenzelm
parents: 48422
diff changeset
   249
    val header1 =
56208
06cc31dff138 clarifed module name;
wenzelm
parents: 55801
diff changeset
   250
      if (resources.loaded_theories(name.theory))
54559
39d91cac6e91 tuned messages;
wenzelm
parents: 54521
diff changeset
   251
        header.error("Cannot update finished theory " + quote(name.theory))
48707
ba531af91148 simplified Document.Node.Header -- internalized errors;
wenzelm
parents: 48422
diff changeset
   252
      else header
ba531af91148 simplified Document.Node.Header -- internalized errors;
wenzelm
parents: 48422
diff changeset
   253
    (name, Document.Node.Deps(header1))
44442
cb18e4f09053 clarified norm_header/header_edit -- disallow update of loaded theories;
wenzelm
parents: 44436
diff changeset
   254
  }
cb18e4f09053 clarified norm_header/header_edit -- disallow update of loaded theories;
wenzelm
parents: 44436
diff changeset
   255
43651
511df47bcadc some support for theory files within Isabelle/Scala session;
wenzelm
parents: 43649
diff changeset
   256
56799
wenzelm
parents: 56793
diff changeset
   257
  /* pipelined change parsing */
wenzelm
parents: 56793
diff changeset
   258
wenzelm
parents: 56793
diff changeset
   259
  private case class Text_Edits(
wenzelm
parents: 56793
diff changeset
   260
    previous: Future[Document.Version],
wenzelm
parents: 56793
diff changeset
   261
    doc_blobs: Document.Blobs,
wenzelm
parents: 56793
diff changeset
   262
    text_edits: List[Document.Edit_Text],
wenzelm
parents: 56793
diff changeset
   263
    version_result: Promise[Document.Version])
43651
511df47bcadc some support for theory files within Isabelle/Scala session;
wenzelm
parents: 43649
diff changeset
   264
56799
wenzelm
parents: 56793
diff changeset
   265
  private val change_parser = Consumer_Thread.fork[Text_Edits]("change_parser", daemon = true)
wenzelm
parents: 56793
diff changeset
   266
  {
wenzelm
parents: 56793
diff changeset
   267
    case Text_Edits(previous, doc_blobs, text_edits, version_result) =>
wenzelm
parents: 56793
diff changeset
   268
      val prev = previous.get_finished
wenzelm
parents: 56793
diff changeset
   269
      val change =
wenzelm
parents: 56793
diff changeset
   270
        Timing.timeit("parse_change", timing) {
wenzelm
parents: 56793
diff changeset
   271
          resources.parse_change(reparse_limit, prev, doc_blobs, text_edits)
wenzelm
parents: 56793
diff changeset
   272
        }
wenzelm
parents: 56793
diff changeset
   273
      version_result.fulfill(change.version)
wenzelm
parents: 56793
diff changeset
   274
      manager.send(change)
wenzelm
parents: 56793
diff changeset
   275
      true
wenzelm
parents: 56793
diff changeset
   276
  }
41534
f36cb6f233bd less verbosity;
wenzelm
parents: 40848
diff changeset
   277
56706
f2f53f7046f4 converted main session manager to Consumer_Thread: messages need to be consumed immediately, postponed_changes replaces implicit actor mailbox scanning;
wenzelm
parents: 56705
diff changeset
   278
56719
80eb2192516a simplified change_buffer (again, see 937826d702d5): no thread, just timer, rely on asynchronous commands_changed.post;
wenzelm
parents: 56715
diff changeset
   279
  /* buffered changes */
80eb2192516a simplified change_buffer (again, see 937826d702d5): no thread, just timer, rely on asynchronous commands_changed.post;
wenzelm
parents: 56715
diff changeset
   280
80eb2192516a simplified change_buffer (again, see 937826d702d5): no thread, just timer, rely on asynchronous commands_changed.post;
wenzelm
parents: 56715
diff changeset
   281
  private object change_buffer
80eb2192516a simplified change_buffer (again, see 937826d702d5): no thread, just timer, rely on asynchronous commands_changed.post;
wenzelm
parents: 56715
diff changeset
   282
  {
80eb2192516a simplified change_buffer (again, see 937826d702d5): no thread, just timer, rely on asynchronous commands_changed.post;
wenzelm
parents: 56715
diff changeset
   283
    private var assignment: Boolean = false
80eb2192516a simplified change_buffer (again, see 937826d702d5): no thread, just timer, rely on asynchronous commands_changed.post;
wenzelm
parents: 56715
diff changeset
   284
    private var nodes: Set[Document.Node.Name] = Set.empty
80eb2192516a simplified change_buffer (again, see 937826d702d5): no thread, just timer, rely on asynchronous commands_changed.post;
wenzelm
parents: 56715
diff changeset
   285
    private var commands: Set[Command] = Set.empty
80eb2192516a simplified change_buffer (again, see 937826d702d5): no thread, just timer, rely on asynchronous commands_changed.post;
wenzelm
parents: 56715
diff changeset
   286
80eb2192516a simplified change_buffer (again, see 937826d702d5): no thread, just timer, rely on asynchronous commands_changed.post;
wenzelm
parents: 56715
diff changeset
   287
    def flush(): Unit = synchronized {
59319
wenzelm
parents: 59086
diff changeset
   288
      if (assignment || nodes.nonEmpty || commands.nonEmpty)
56719
80eb2192516a simplified change_buffer (again, see 937826d702d5): no thread, just timer, rely on asynchronous commands_changed.post;
wenzelm
parents: 56715
diff changeset
   289
        commands_changed.post(Session.Commands_Changed(assignment, nodes, commands))
80eb2192516a simplified change_buffer (again, see 937826d702d5): no thread, just timer, rely on asynchronous commands_changed.post;
wenzelm
parents: 56715
diff changeset
   290
      assignment = false
80eb2192516a simplified change_buffer (again, see 937826d702d5): no thread, just timer, rely on asynchronous commands_changed.post;
wenzelm
parents: 56715
diff changeset
   291
      nodes = Set.empty
80eb2192516a simplified change_buffer (again, see 937826d702d5): no thread, just timer, rely on asynchronous commands_changed.post;
wenzelm
parents: 56715
diff changeset
   292
      commands = Set.empty
80eb2192516a simplified change_buffer (again, see 937826d702d5): no thread, just timer, rely on asynchronous commands_changed.post;
wenzelm
parents: 56715
diff changeset
   293
    }
56771
28d62a5b07e8 more systematic delay_first discipline for change_buffer and prune_history;
wenzelm
parents: 56735
diff changeset
   294
    private val delay_flush = Simple_Thread.delay_first(output_delay) { flush() }
56719
80eb2192516a simplified change_buffer (again, see 937826d702d5): no thread, just timer, rely on asynchronous commands_changed.post;
wenzelm
parents: 56715
diff changeset
   295
80eb2192516a simplified change_buffer (again, see 937826d702d5): no thread, just timer, rely on asynchronous commands_changed.post;
wenzelm
parents: 56715
diff changeset
   296
    def invoke(assign: Boolean, cmds: List[Command]): Unit = synchronized {
80eb2192516a simplified change_buffer (again, see 937826d702d5): no thread, just timer, rely on asynchronous commands_changed.post;
wenzelm
parents: 56715
diff changeset
   297
      assignment |= assign
80eb2192516a simplified change_buffer (again, see 937826d702d5): no thread, just timer, rely on asynchronous commands_changed.post;
wenzelm
parents: 56715
diff changeset
   298
      for (command <- cmds) {
80eb2192516a simplified change_buffer (again, see 937826d702d5): no thread, just timer, rely on asynchronous commands_changed.post;
wenzelm
parents: 56715
diff changeset
   299
        nodes += command.node_name
80eb2192516a simplified change_buffer (again, see 937826d702d5): no thread, just timer, rely on asynchronous commands_changed.post;
wenzelm
parents: 56715
diff changeset
   300
        commands += command
80eb2192516a simplified change_buffer (again, see 937826d702d5): no thread, just timer, rely on asynchronous commands_changed.post;
wenzelm
parents: 56715
diff changeset
   301
      }
56771
28d62a5b07e8 more systematic delay_first discipline for change_buffer and prune_history;
wenzelm
parents: 56735
diff changeset
   302
      delay_flush.invoke()
56719
80eb2192516a simplified change_buffer (again, see 937826d702d5): no thread, just timer, rely on asynchronous commands_changed.post;
wenzelm
parents: 56715
diff changeset
   303
    }
80eb2192516a simplified change_buffer (again, see 937826d702d5): no thread, just timer, rely on asynchronous commands_changed.post;
wenzelm
parents: 56715
diff changeset
   304
80eb2192516a simplified change_buffer (again, see 937826d702d5): no thread, just timer, rely on asynchronous commands_changed.post;
wenzelm
parents: 56715
diff changeset
   305
    def shutdown()
80eb2192516a simplified change_buffer (again, see 937826d702d5): no thread, just timer, rely on asynchronous commands_changed.post;
wenzelm
parents: 56715
diff changeset
   306
    {
56771
28d62a5b07e8 more systematic delay_first discipline for change_buffer and prune_history;
wenzelm
parents: 56735
diff changeset
   307
      delay_flush.revoke()
56719
80eb2192516a simplified change_buffer (again, see 937826d702d5): no thread, just timer, rely on asynchronous commands_changed.post;
wenzelm
parents: 56715
diff changeset
   308
      flush()
80eb2192516a simplified change_buffer (again, see 937826d702d5): no thread, just timer, rely on asynchronous commands_changed.post;
wenzelm
parents: 56715
diff changeset
   309
    }
80eb2192516a simplified change_buffer (again, see 937826d702d5): no thread, just timer, rely on asynchronous commands_changed.post;
wenzelm
parents: 56715
diff changeset
   310
  }
80eb2192516a simplified change_buffer (again, see 937826d702d5): no thread, just timer, rely on asynchronous commands_changed.post;
wenzelm
parents: 56715
diff changeset
   311
80eb2192516a simplified change_buffer (again, see 937826d702d5): no thread, just timer, rely on asynchronous commands_changed.post;
wenzelm
parents: 56715
diff changeset
   312
56706
f2f53f7046f4 converted main session manager to Consumer_Thread: messages need to be consumed immediately, postponed_changes replaces implicit actor mailbox scanning;
wenzelm
parents: 56705
diff changeset
   313
  /* postponed changes */
44733
329320fc88df buffer prover messages to prevent overloading of session_actor input channel -- which is critical due to synchronous messages wrt. GUI thread;
wenzelm
parents: 44732
diff changeset
   314
56706
f2f53f7046f4 converted main session manager to Consumer_Thread: messages need to be consumed immediately, postponed_changes replaces implicit actor mailbox scanning;
wenzelm
parents: 56705
diff changeset
   315
  private object postponed_changes
f2f53f7046f4 converted main session manager to Consumer_Thread: messages need to be consumed immediately, postponed_changes replaces implicit actor mailbox scanning;
wenzelm
parents: 56705
diff changeset
   316
  {
f2f53f7046f4 converted main session manager to Consumer_Thread: messages need to be consumed immediately, postponed_changes replaces implicit actor mailbox scanning;
wenzelm
parents: 56705
diff changeset
   317
    private var postponed: List[Session.Change] = Nil
f2f53f7046f4 converted main session manager to Consumer_Thread: messages need to be consumed immediately, postponed_changes replaces implicit actor mailbox scanning;
wenzelm
parents: 56705
diff changeset
   318
f2f53f7046f4 converted main session manager to Consumer_Thread: messages need to be consumed immediately, postponed_changes replaces implicit actor mailbox scanning;
wenzelm
parents: 56705
diff changeset
   319
    def store(change: Session.Change): Unit = synchronized { postponed ::= change }
56705
937826d702d5 simplified commands_changed_buffer (in contrast to a8331fb5c959): rely on better performance of Consumer_Thread/Mailbox and more direct Timer (like session_actor.receiver);
wenzelm
parents: 56704
diff changeset
   320
57976
bf99106b6672 postpone changes in intermediate state between remove_versions/removed_versions, which is important for handle_change to refer to defined items on prover side;
wenzelm
parents: 57867
diff changeset
   321
    def flush(state: Document.State): List[Session.Change] = synchronized {
56706
f2f53f7046f4 converted main session manager to Consumer_Thread: messages need to be consumed immediately, postponed_changes replaces implicit actor mailbox scanning;
wenzelm
parents: 56705
diff changeset
   322
      val (assigned, unassigned) = postponed.partition(change => state.is_assigned(change.previous))
f2f53f7046f4 converted main session manager to Consumer_Thread: messages need to be consumed immediately, postponed_changes replaces implicit actor mailbox scanning;
wenzelm
parents: 56705
diff changeset
   323
      postponed = unassigned
57976
bf99106b6672 postpone changes in intermediate state between remove_versions/removed_versions, which is important for handle_change to refer to defined items on prover side;
wenzelm
parents: 57867
diff changeset
   324
      assigned.reverse
56706
f2f53f7046f4 converted main session manager to Consumer_Thread: messages need to be consumed immediately, postponed_changes replaces implicit actor mailbox scanning;
wenzelm
parents: 56705
diff changeset
   325
    }
f2f53f7046f4 converted main session manager to Consumer_Thread: messages need to be consumed immediately, postponed_changes replaces implicit actor mailbox scanning;
wenzelm
parents: 56705
diff changeset
   326
  }
44733
329320fc88df buffer prover messages to prevent overloading of session_actor input channel -- which is critical due to synchronous messages wrt. GUI thread;
wenzelm
parents: 44732
diff changeset
   327
56706
f2f53f7046f4 converted main session manager to Consumer_Thread: messages need to be consumed immediately, postponed_changes replaces implicit actor mailbox scanning;
wenzelm
parents: 56705
diff changeset
   328
56793
d5ab6a8799ce more synchronized treatment of prover process, which might emit more messages before shutdown and requires manager to accept them;
wenzelm
parents: 56782
diff changeset
   329
  /* prover process */
d5ab6a8799ce more synchronized treatment of prover process, which might emit more messages before shutdown and requires manager to accept them;
wenzelm
parents: 56782
diff changeset
   330
d5ab6a8799ce more synchronized treatment of prover process, which might emit more messages before shutdown and requires manager to accept them;
wenzelm
parents: 56782
diff changeset
   331
  private object prover
d5ab6a8799ce more synchronized treatment of prover process, which might emit more messages before shutdown and requires manager to accept them;
wenzelm
parents: 56782
diff changeset
   332
  {
d5ab6a8799ce more synchronized treatment of prover process, which might emit more messages before shutdown and requires manager to accept them;
wenzelm
parents: 56782
diff changeset
   333
    private val variable = Synchronized(None: Option[Prover])
d5ab6a8799ce more synchronized treatment of prover process, which might emit more messages before shutdown and requires manager to accept them;
wenzelm
parents: 56782
diff changeset
   334
d5ab6a8799ce more synchronized treatment of prover process, which might emit more messages before shutdown and requires manager to accept them;
wenzelm
parents: 56782
diff changeset
   335
    def defined: Boolean = variable.value.isDefined
d5ab6a8799ce more synchronized treatment of prover process, which might emit more messages before shutdown and requires manager to accept them;
wenzelm
parents: 56782
diff changeset
   336
    def get: Prover = variable.value.get
d5ab6a8799ce more synchronized treatment of prover process, which might emit more messages before shutdown and requires manager to accept them;
wenzelm
parents: 56782
diff changeset
   337
    def set(p: Prover) { variable.change(_ => Some(p)) }
d5ab6a8799ce more synchronized treatment of prover process, which might emit more messages before shutdown and requires manager to accept them;
wenzelm
parents: 56782
diff changeset
   338
    def reset { variable.change(_ => None) }
d5ab6a8799ce more synchronized treatment of prover process, which might emit more messages before shutdown and requires manager to accept them;
wenzelm
parents: 56782
diff changeset
   339
    def await_reset() { variable.guarded_access({ case None => Some((), None) case _ => None }) }
d5ab6a8799ce more synchronized treatment of prover process, which might emit more messages before shutdown and requires manager to accept them;
wenzelm
parents: 56782
diff changeset
   340
  }
d5ab6a8799ce more synchronized treatment of prover process, which might emit more messages before shutdown and requires manager to accept them;
wenzelm
parents: 56782
diff changeset
   341
d5ab6a8799ce more synchronized treatment of prover process, which might emit more messages before shutdown and requires manager to accept them;
wenzelm
parents: 56782
diff changeset
   342
59366
e94df7f6b608 clarified build_theories: proper protocol handler;
wenzelm
parents: 59364
diff changeset
   343
  /* protocol handlers */
e94df7f6b608 clarified build_theories: proper protocol handler;
wenzelm
parents: 59364
diff changeset
   344
e94df7f6b608 clarified build_theories: proper protocol handler;
wenzelm
parents: 59364
diff changeset
   345
  private val _protocol_handlers = Synchronized(new Session.Protocol_Handlers)
e94df7f6b608 clarified build_theories: proper protocol handler;
wenzelm
parents: 59364
diff changeset
   346
e94df7f6b608 clarified build_theories: proper protocol handler;
wenzelm
parents: 59364
diff changeset
   347
  def get_protocol_handler(name: String): Option[Session.Protocol_Handler] =
e94df7f6b608 clarified build_theories: proper protocol handler;
wenzelm
parents: 59364
diff changeset
   348
    _protocol_handlers.value.get(name)
e94df7f6b608 clarified build_theories: proper protocol handler;
wenzelm
parents: 59364
diff changeset
   349
59367
6193bbbbe564 more type-safe handler interface;
wenzelm
parents: 59366
diff changeset
   350
  def add_protocol_handler(handler: Session.Protocol_Handler): Unit =
6193bbbbe564 more type-safe handler interface;
wenzelm
parents: 59366
diff changeset
   351
    _protocol_handlers.change(_.add(prover.get, handler))
59366
e94df7f6b608 clarified build_theories: proper protocol handler;
wenzelm
parents: 59364
diff changeset
   352
e94df7f6b608 clarified build_theories: proper protocol handler;
wenzelm
parents: 59364
diff changeset
   353
56706
f2f53f7046f4 converted main session manager to Consumer_Thread: messages need to be consumed immediately, postponed_changes replaces implicit actor mailbox scanning;
wenzelm
parents: 56705
diff changeset
   354
  /* manager thread */
44733
329320fc88df buffer prover messages to prevent overloading of session_actor input channel -- which is critical due to synchronous messages wrt. GUI thread;
wenzelm
parents: 44732
diff changeset
   355
56771
28d62a5b07e8 more systematic delay_first discipline for change_buffer and prune_history;
wenzelm
parents: 56735
diff changeset
   356
  private val delay_prune = Simple_Thread.delay_first(prune_delay) { manager.send(Prune_History) }
28d62a5b07e8 more systematic delay_first discipline for change_buffer and prune_history;
wenzelm
parents: 56735
diff changeset
   357
56706
f2f53f7046f4 converted main session manager to Consumer_Thread: messages need to be consumed immediately, postponed_changes replaces implicit actor mailbox scanning;
wenzelm
parents: 56705
diff changeset
   358
  private val manager: Consumer_Thread[Any] =
f2f53f7046f4 converted main session manager to Consumer_Thread: messages need to be consumed immediately, postponed_changes replaces implicit actor mailbox scanning;
wenzelm
parents: 56705
diff changeset
   359
  {
52649
f45ab3e8211b update_options with full update, e.g. required for re-assignment of Command.prints;
wenzelm
parents: 52563
diff changeset
   360
    /* raw edits */
f45ab3e8211b update_options with full update, e.g. required for re-assignment of Command.prints;
wenzelm
parents: 52563
diff changeset
   361
54521
744ea0025e11 clarified Document.Blobs environment vs. actual edits of auxiliary files;
wenzelm
parents: 54519
diff changeset
   362
    def handle_raw_edits(doc_blobs: Document.Blobs, edits: List[Document.Edit_Text])
52649
f45ab3e8211b update_options with full update, e.g. required for re-assignment of Command.prints;
wenzelm
parents: 52563
diff changeset
   363
    //{{{
f45ab3e8211b update_options with full update, e.g. required for re-assignment of Command.prints;
wenzelm
parents: 52563
diff changeset
   364
    {
56793
d5ab6a8799ce more synchronized treatment of prover process, which might emit more messages before shutdown and requires manager to accept them;
wenzelm
parents: 56782
diff changeset
   365
      require(prover.defined)
56712
c7cf653228ed more explicit checks;
wenzelm
parents: 56711
diff changeset
   366
52649
f45ab3e8211b update_options with full update, e.g. required for re-assignment of Command.prints;
wenzelm
parents: 52563
diff changeset
   367
      prover.get.discontinue_execution()
f45ab3e8211b update_options with full update, e.g. required for re-assignment of Command.prints;
wenzelm
parents: 52563
diff changeset
   368
56687
7fb98325722a tuned signature in accordance to ML version;
wenzelm
parents: 56671
diff changeset
   369
      val previous = global_state.value.history.tip.version
52649
f45ab3e8211b update_options with full update, e.g. required for re-assignment of Command.prints;
wenzelm
parents: 52563
diff changeset
   370
      val version = Future.promise[Document.Version]
56711
ef3d00153e3b tuned signature;
wenzelm
parents: 56710
diff changeset
   371
      global_state.change(_.continue_history(previous, edits, version))
52649
f45ab3e8211b update_options with full update, e.g. required for re-assignment of Command.prints;
wenzelm
parents: 52563
diff changeset
   372
56715
52125652e82a clarified Session.Consumer, with Session.Outlet managed by dispatcher thread;
wenzelm
parents: 56713
diff changeset
   373
      raw_edits.post(Session.Raw_Edits(doc_blobs, edits))
56704
c2f0ddd14747 simplified -- prefer Consumer_Thread over Actor;
wenzelm
parents: 56691
diff changeset
   374
      change_parser.send(Text_Edits(previous, doc_blobs, edits, version))
52649
f45ab3e8211b update_options with full update, e.g. required for re-assignment of Command.prints;
wenzelm
parents: 52563
diff changeset
   375
    }
f45ab3e8211b update_options with full update, e.g. required for re-assignment of Command.prints;
wenzelm
parents: 52563
diff changeset
   376
    //}}}
f45ab3e8211b update_options with full update, e.g. required for re-assignment of Command.prints;
wenzelm
parents: 52563
diff changeset
   377
f45ab3e8211b update_options with full update, e.g. required for re-assignment of Command.prints;
wenzelm
parents: 52563
diff changeset
   378
43716
1d64662c1bfd tuned source structure;
wenzelm
parents: 43697
diff changeset
   379
    /* resulting changes */
34809
0fed930f2992 misc tuning;
wenzelm
parents: 34808
diff changeset
   380
56315
c20053f67093 tuned signature;
wenzelm
parents: 56210
diff changeset
   381
    def handle_change(change: Session.Change)
38221
e0f00f0945b4 misc tuning and clarification;
wenzelm
parents: 38150
diff changeset
   382
    //{{{
34809
0fed930f2992 misc tuning;
wenzelm
parents: 34808
diff changeset
   383
    {
56793
d5ab6a8799ce more synchronized treatment of prover process, which might emit more messages before shutdown and requires manager to accept them;
wenzelm
parents: 56782
diff changeset
   384
      require(prover.defined)
56712
c7cf653228ed more explicit checks;
wenzelm
parents: 56711
diff changeset
   385
44383
f99906c2a1d3 discontinued redundant Edit_Command_ID;
wenzelm
parents: 44298
diff changeset
   386
      def id_command(command: Command)
43720
wenzelm
parents: 43719
diff changeset
   387
      {
54519
5fed81762406 maintain blobs within document state: digest + text in ML, digest-only in Scala;
wenzelm
parents: 54443
diff changeset
   388
        for {
57842
8e4ae2db1849 more direct access to persistent blobs (see also 8953d4cc060a), avoiding fragile digest lookup from later version (which might have removed unused blobs already);
wenzelm
parents: 57651
diff changeset
   389
          (name, digest) <- command.blobs_defined
56687
7fb98325722a tuned signature in accordance to ML version;
wenzelm
parents: 56671
diff changeset
   390
          if !global_state.value.defined_blob(digest)
54519
5fed81762406 maintain blobs within document state: digest + text in ML, digest-only in Scala;
wenzelm
parents: 54443
diff changeset
   391
        } {
57842
8e4ae2db1849 more direct access to persistent blobs (see also 8953d4cc060a), avoiding fragile digest lookup from later version (which might have removed unused blobs already);
wenzelm
parents: 57651
diff changeset
   392
          change.version.nodes(name).get_blob match {
54519
5fed81762406 maintain blobs within document state: digest + text in ML, digest-only in Scala;
wenzelm
parents: 54443
diff changeset
   393
            case Some(blob) =>
56687
7fb98325722a tuned signature in accordance to ML version;
wenzelm
parents: 56671
diff changeset
   394
              global_state.change(_.define_blob(digest))
56335
8953d4cc060a store blob content within document node: aux. files that were once open are made persistent;
wenzelm
parents: 56316
diff changeset
   395
              prover.get.define_blob(digest, blob.bytes)
55783
da0513d95155 more formal Document.Blobs;
wenzelm
parents: 55618
diff changeset
   396
            case None =>
57842
8e4ae2db1849 more direct access to persistent blobs (see also 8953d4cc060a), avoiding fragile digest lookup from later version (which might have removed unused blobs already);
wenzelm
parents: 57651
diff changeset
   397
              Output.error_message("Missing blob " + quote(name.toString))
54519
5fed81762406 maintain blobs within document state: digest + text in ML, digest-only in Scala;
wenzelm
parents: 54443
diff changeset
   398
          }
5fed81762406 maintain blobs within document state: digest + text in ML, digest-only in Scala;
wenzelm
parents: 54443
diff changeset
   399
        }
5fed81762406 maintain blobs within document state: digest + text in ML, digest-only in Scala;
wenzelm
parents: 54443
diff changeset
   400
56687
7fb98325722a tuned signature in accordance to ML version;
wenzelm
parents: 56671
diff changeset
   401
        if (!global_state.value.defined_command(command.id)) {
7fb98325722a tuned signature in accordance to ML version;
wenzelm
parents: 56671
diff changeset
   402
          global_state.change(_.define_command(command))
44644
317e4962dd0f clarified define_command: store name as structural information;
wenzelm
parents: 44616
diff changeset
   403
          prover.get.define_command(command)
43720
wenzelm
parents: 43719
diff changeset
   404
        }
wenzelm
parents: 43719
diff changeset
   405
      }
56315
c20053f67093 tuned signature;
wenzelm
parents: 56210
diff changeset
   406
      change.doc_edits foreach {
44383
f99906c2a1d3 discontinued redundant Edit_Command_ID;
wenzelm
parents: 44298
diff changeset
   407
        case (_, edit) =>
f99906c2a1d3 discontinued redundant Edit_Command_ID;
wenzelm
parents: 44298
diff changeset
   408
          edit foreach { case (c1, c2) => c1 foreach id_command; c2 foreach id_command }
f99906c2a1d3 discontinued redundant Edit_Command_ID;
wenzelm
parents: 44298
diff changeset
   409
      }
43722
9b5dadb0c28d propagate header changes to prover process;
wenzelm
parents: 43721
diff changeset
   410
56687
7fb98325722a tuned signature in accordance to ML version;
wenzelm
parents: 56671
diff changeset
   411
      val assignment = global_state.value.the_assignment(change.previous).check_finished
7fb98325722a tuned signature in accordance to ML version;
wenzelm
parents: 56671
diff changeset
   412
      global_state.change(_.define_version(change.version, assignment))
56315
c20053f67093 tuned signature;
wenzelm
parents: 56210
diff changeset
   413
      prover.get.update(change.previous.id, change.version.id, change.doc_edits)
56316
b1cf8ddc2e04 propagate deps_changed, to resolve missing files without requiring jEdit events (e.g. buffer load/save);
wenzelm
parents: 56315
diff changeset
   414
      resources.commit(change)
34809
0fed930f2992 misc tuning;
wenzelm
parents: 34808
diff changeset
   415
    }
38221
e0f00f0945b4 misc tuning and clarification;
wenzelm
parents: 38150
diff changeset
   416
    //}}}
34809
0fed930f2992 misc tuning;
wenzelm
parents: 34808
diff changeset
   417
0fed930f2992 misc tuning;
wenzelm
parents: 34808
diff changeset
   418
46772
be21f050eda4 tuned signature -- emphasize Isabelle_Process Input vs. Output;
wenzelm
parents: 46771
diff changeset
   419
    /* prover output */
34809
0fed930f2992 misc tuning;
wenzelm
parents: 34808
diff changeset
   420
56385
76acce58aeab more general prover operations;
wenzelm
parents: 56335
diff changeset
   421
    def handle_output(output: Prover.Output)
38221
e0f00f0945b4 misc tuning and clarification;
wenzelm
parents: 38150
diff changeset
   422
    //{{{
34809
0fed930f2992 misc tuning;
wenzelm
parents: 34808
diff changeset
   423
    {
51662
3391a493f39a just one timing protocol function, with 3 implementations: TTY/PG, PIDE/document, build;
wenzelm
parents: 51083
diff changeset
   424
      def bad_output()
43716
1d64662c1bfd tuned source structure;
wenzelm
parents: 43697
diff changeset
   425
      {
1d64662c1bfd tuned source structure;
wenzelm
parents: 43697
diff changeset
   426
        if (verbose)
56782
433cf57550fa more systematic Isabelle output, like in classic Isabelle/ML (without markup);
wenzelm
parents: 56775
diff changeset
   427
          Output.warning("Ignoring bad prover output: " + output.message.toString)
43716
1d64662c1bfd tuned source structure;
wenzelm
parents: 43697
diff changeset
   428
      }
1d64662c1bfd tuned source structure;
wenzelm
parents: 43697
diff changeset
   429
52531
21f8e0e151f5 tuned signature;
wenzelm
parents: 52530
diff changeset
   430
      def accumulate(state_id: Document_ID.Generic, message: XML.Elem)
51662
3391a493f39a just one timing protocol function, with 3 implementations: TTY/PG, PIDE/document, build;
wenzelm
parents: 51083
diff changeset
   431
      {
3391a493f39a just one timing protocol function, with 3 implementations: TTY/PG, PIDE/document, build;
wenzelm
parents: 51083
diff changeset
   432
        try {
56687
7fb98325722a tuned signature in accordance to ML version;
wenzelm
parents: 56671
diff changeset
   433
          val st = global_state.change_result(_.accumulate(state_id, message))
56719
80eb2192516a simplified change_buffer (again, see 937826d702d5): no thread, just timer, rely on asynchronous commands_changed.post;
wenzelm
parents: 56715
diff changeset
   434
          change_buffer.invoke(false, List(st.command))
51662
3391a493f39a just one timing protocol function, with 3 implementations: TTY/PG, PIDE/document, build;
wenzelm
parents: 51083
diff changeset
   435
        }
3391a493f39a just one timing protocol function, with 3 implementations: TTY/PG, PIDE/document, build;
wenzelm
parents: 51083
diff changeset
   436
        catch {
3391a493f39a just one timing protocol function, with 3 implementations: TTY/PG, PIDE/document, build;
wenzelm
parents: 51083
diff changeset
   437
          case _: Document.State.Fail => bad_output()
3391a493f39a just one timing protocol function, with 3 implementations: TTY/PG, PIDE/document, build;
wenzelm
parents: 51083
diff changeset
   438
        }
3391a493f39a just one timing protocol function, with 3 implementations: TTY/PG, PIDE/document, build;
wenzelm
parents: 51083
diff changeset
   439
      }
3391a493f39a just one timing protocol function, with 3 implementations: TTY/PG, PIDE/document, build;
wenzelm
parents: 51083
diff changeset
   440
54442
c39972ddd672 more specific Protocol_Output: empty message.body, main content via bytes/text;
wenzelm
parents: 53054
diff changeset
   441
      output match {
56385
76acce58aeab more general prover operations;
wenzelm
parents: 56335
diff changeset
   442
        case msg: Prover.Protocol_Output =>
59366
e94df7f6b608 clarified build_theories: proper protocol handler;
wenzelm
parents: 59364
diff changeset
   443
          val handled = _protocol_handlers.value.invoke(msg)
54442
c39972ddd672 more specific Protocol_Output: empty message.body, main content via bytes/text;
wenzelm
parents: 53054
diff changeset
   444
          if (!handled) {
c39972ddd672 more specific Protocol_Output: empty message.body, main content via bytes/text;
wenzelm
parents: 53054
diff changeset
   445
            msg.properties match {
56793
d5ab6a8799ce more synchronized treatment of prover process, which might emit more messages before shutdown and requires manager to accept them;
wenzelm
parents: 56782
diff changeset
   446
              case Markup.Protocol_Handler(name) if prover.defined =>
59367
6193bbbbe564 more type-safe handler interface;
wenzelm
parents: 59366
diff changeset
   447
                try {
6193bbbbe564 more type-safe handler interface;
wenzelm
parents: 59366
diff changeset
   448
                  val handler =
6193bbbbe564 more type-safe handler interface;
wenzelm
parents: 59366
diff changeset
   449
                    Class.forName(name).newInstance.asInstanceOf[Session.Protocol_Handler]
6193bbbbe564 more type-safe handler interface;
wenzelm
parents: 59366
diff changeset
   450
                  add_protocol_handler(handler)
6193bbbbe564 more type-safe handler interface;
wenzelm
parents: 59366
diff changeset
   451
                }
6193bbbbe564 more type-safe handler interface;
wenzelm
parents: 59366
diff changeset
   452
                catch { case exn: Throwable => Session.bad_protocol_handler(exn, name) }
54442
c39972ddd672 more specific Protocol_Output: empty message.body, main content via bytes/text;
wenzelm
parents: 53054
diff changeset
   453
56793
d5ab6a8799ce more synchronized treatment of prover process, which might emit more messages before shutdown and requires manager to accept them;
wenzelm
parents: 56782
diff changeset
   454
              case Protocol.Command_Timing(state_id, timing) if prover.defined =>
54442
c39972ddd672 more specific Protocol_Output: empty message.body, main content via bytes/text;
wenzelm
parents: 53054
diff changeset
   455
                val message = XML.elem(Markup.STATUS, List(XML.Elem(Markup.Timing(timing), Nil)))
c39972ddd672 more specific Protocol_Output: empty message.body, main content via bytes/text;
wenzelm
parents: 53054
diff changeset
   456
                accumulate(state_id, prover.get.xml_cache.elem(message))
46122
1e9ec1a44dfc prefer raw_message for protocol implementation;
wenzelm
parents: 46121
diff changeset
   457
54442
c39972ddd672 more specific Protocol_Output: empty message.body, main content via bytes/text;
wenzelm
parents: 53054
diff changeset
   458
              case Markup.Assign_Update =>
c39972ddd672 more specific Protocol_Output: empty message.body, main content via bytes/text;
wenzelm
parents: 53054
diff changeset
   459
                msg.text match {
c39972ddd672 more specific Protocol_Output: empty message.body, main content via bytes/text;
wenzelm
parents: 53054
diff changeset
   460
                  case Protocol.Assign_Update(id, update) =>
c39972ddd672 more specific Protocol_Output: empty message.body, main content via bytes/text;
wenzelm
parents: 53054
diff changeset
   461
                    try {
56687
7fb98325722a tuned signature in accordance to ML version;
wenzelm
parents: 56671
diff changeset
   462
                      val cmds = global_state.change_result(_.assign(id, update))
56719
80eb2192516a simplified change_buffer (again, see 937826d702d5): no thread, just timer, rely on asynchronous commands_changed.post;
wenzelm
parents: 56715
diff changeset
   463
                      change_buffer.invoke(true, cmds)
57976
bf99106b6672 postpone changes in intermediate state between remove_versions/removed_versions, which is important for handle_change to refer to defined items on prover side;
wenzelm
parents: 57867
diff changeset
   464
                      manager.send(Session.Change_Flush)
54442
c39972ddd672 more specific Protocol_Output: empty message.body, main content via bytes/text;
wenzelm
parents: 53054
diff changeset
   465
                    }
c39972ddd672 more specific Protocol_Output: empty message.body, main content via bytes/text;
wenzelm
parents: 53054
diff changeset
   466
                    catch { case _: Document.State.Fail => bad_output() }
c39972ddd672 more specific Protocol_Output: empty message.body, main content via bytes/text;
wenzelm
parents: 53054
diff changeset
   467
                  case _ => bad_output()
c39972ddd672 more specific Protocol_Output: empty message.body, main content via bytes/text;
wenzelm
parents: 53054
diff changeset
   468
                }
56771
28d62a5b07e8 more systematic delay_first discipline for change_buffer and prune_history;
wenzelm
parents: 56735
diff changeset
   469
                delay_prune.invoke()
46122
1e9ec1a44dfc prefer raw_message for protocol implementation;
wenzelm
parents: 46121
diff changeset
   470
54442
c39972ddd672 more specific Protocol_Output: empty message.body, main content via bytes/text;
wenzelm
parents: 53054
diff changeset
   471
              case Markup.Removed_Versions =>
c39972ddd672 more specific Protocol_Output: empty message.body, main content via bytes/text;
wenzelm
parents: 53054
diff changeset
   472
                msg.text match {
c39972ddd672 more specific Protocol_Output: empty message.body, main content via bytes/text;
wenzelm
parents: 53054
diff changeset
   473
                  case Protocol.Removed(removed) =>
c39972ddd672 more specific Protocol_Output: empty message.body, main content via bytes/text;
wenzelm
parents: 53054
diff changeset
   474
                    try {
56687
7fb98325722a tuned signature in accordance to ML version;
wenzelm
parents: 56671
diff changeset
   475
                      global_state.change(_.removed_versions(removed))
57976
bf99106b6672 postpone changes in intermediate state between remove_versions/removed_versions, which is important for handle_change to refer to defined items on prover side;
wenzelm
parents: 57867
diff changeset
   476
                      manager.send(Session.Change_Flush)
54442
c39972ddd672 more specific Protocol_Output: empty message.body, main content via bytes/text;
wenzelm
parents: 53054
diff changeset
   477
                    }
c39972ddd672 more specific Protocol_Output: empty message.body, main content via bytes/text;
wenzelm
parents: 53054
diff changeset
   478
                    catch { case _: Document.State.Fail => bad_output() }
c39972ddd672 more specific Protocol_Output: empty message.body, main content via bytes/text;
wenzelm
parents: 53054
diff changeset
   479
                  case _ => bad_output()
c39972ddd672 more specific Protocol_Output: empty message.body, main content via bytes/text;
wenzelm
parents: 53054
diff changeset
   480
                }
c39972ddd672 more specific Protocol_Output: empty message.body, main content via bytes/text;
wenzelm
parents: 53054
diff changeset
   481
c39972ddd672 more specific Protocol_Output: empty message.body, main content via bytes/text;
wenzelm
parents: 53054
diff changeset
   482
              case Markup.ML_Statistics(props) =>
56715
52125652e82a clarified Session.Consumer, with Session.Outlet managed by dispatcher thread;
wenzelm
parents: 56713
diff changeset
   483
                statistics.post(Session.Statistics(props))
54442
c39972ddd672 more specific Protocol_Output: empty message.body, main content via bytes/text;
wenzelm
parents: 53054
diff changeset
   484
c39972ddd672 more specific Protocol_Output: empty message.body, main content via bytes/text;
wenzelm
parents: 53054
diff changeset
   485
              case Markup.Task_Statistics(props) =>
c39972ddd672 more specific Protocol_Output: empty message.body, main content via bytes/text;
wenzelm
parents: 53054
diff changeset
   486
                // FIXME
52111
1fd184eaa310 explicit management of Session.Protocol_Handlers, with protocol state and functions;
wenzelm
parents: 52084
diff changeset
   487
54442
c39972ddd672 more specific Protocol_Output: empty message.body, main content via bytes/text;
wenzelm
parents: 53054
diff changeset
   488
              case _ => bad_output()
c39972ddd672 more specific Protocol_Output: empty message.body, main content via bytes/text;
wenzelm
parents: 53054
diff changeset
   489
            }
c39972ddd672 more specific Protocol_Output: empty message.body, main content via bytes/text;
wenzelm
parents: 53054
diff changeset
   490
          }
c39972ddd672 more specific Protocol_Output: empty message.body, main content via bytes/text;
wenzelm
parents: 53054
diff changeset
   491
        case _ =>
c39972ddd672 more specific Protocol_Output: empty message.body, main content via bytes/text;
wenzelm
parents: 53054
diff changeset
   492
          output.properties match {
c39972ddd672 more specific Protocol_Output: empty message.body, main content via bytes/text;
wenzelm
parents: 53054
diff changeset
   493
            case Position.Id(state_id) =>
c39972ddd672 more specific Protocol_Output: empty message.body, main content via bytes/text;
wenzelm
parents: 53054
diff changeset
   494
              accumulate(state_id, output.message)
56210
c7c85cdb725d clarified module arrangement;
wenzelm
parents: 56208
diff changeset
   495
54442
c39972ddd672 more specific Protocol_Output: empty message.body, main content via bytes/text;
wenzelm
parents: 53054
diff changeset
   496
            case _ if output.is_init =>
c39972ddd672 more specific Protocol_Output: empty message.body, main content via bytes/text;
wenzelm
parents: 53054
diff changeset
   497
              phase = Session.Ready
56210
c7c85cdb725d clarified module arrangement;
wenzelm
parents: 56208
diff changeset
   498
54442
c39972ddd672 more specific Protocol_Output: empty message.body, main content via bytes/text;
wenzelm
parents: 53054
diff changeset
   499
            case Markup.Return_Code(rc) if output.is_exit =>
c39972ddd672 more specific Protocol_Output: empty message.body, main content via bytes/text;
wenzelm
parents: 53054
diff changeset
   500
              if (rc == 0) phase = Session.Inactive
c39972ddd672 more specific Protocol_Output: empty message.body, main content via bytes/text;
wenzelm
parents: 53054
diff changeset
   501
              else phase = Session.Failed
56793
d5ab6a8799ce more synchronized treatment of prover process, which might emit more messages before shutdown and requires manager to accept them;
wenzelm
parents: 56782
diff changeset
   502
              prover.reset
56210
c7c85cdb725d clarified module arrangement;
wenzelm
parents: 56208
diff changeset
   503
56715
52125652e82a clarified Session.Consumer, with Session.Outlet managed by dispatcher thread;
wenzelm
parents: 56713
diff changeset
   504
            case _ => raw_output_messages.post(output)
44661
383c9d758a56 raw message function "assign_execs" avoids full overhead of decoding and caching message body;
wenzelm
parents: 44644
diff changeset
   505
          }
52111
1fd184eaa310 explicit management of Session.Protocol_Handlers, with protocol state and functions;
wenzelm
parents: 52084
diff changeset
   506
        }
34809
0fed930f2992 misc tuning;
wenzelm
parents: 34808
diff changeset
   507
    }
38221
e0f00f0945b4 misc tuning and clarification;
wenzelm
parents: 38150
diff changeset
   508
    //}}}
34809
0fed930f2992 misc tuning;
wenzelm
parents: 34808
diff changeset
   509
34820
a8ba6cde13e9 basic setup for synchronous / modal (!) prover startup;
wenzelm
parents: 34819
diff changeset
   510
56706
f2f53f7046f4 converted main session manager to Consumer_Thread: messages need to be consumed immediately, postponed_changes replaces implicit actor mailbox scanning;
wenzelm
parents: 56705
diff changeset
   511
    /* main thread */
f2f53f7046f4 converted main session manager to Consumer_Thread: messages need to be consumed immediately, postponed_changes replaces implicit actor mailbox scanning;
wenzelm
parents: 56705
diff changeset
   512
56710
8f102c18eab7 more uniform warning/error handling, potentially with propagation to send_wait caller;
wenzelm
parents: 56709
diff changeset
   513
    Consumer_Thread.fork[Any]("Session.manager", daemon = true)
56709
e83356e94380 more careful shutdown (amending f2f53f7046f4);
wenzelm
parents: 56706
diff changeset
   514
    {
e83356e94380 more careful shutdown (amending f2f53f7046f4);
wenzelm
parents: 56706
diff changeset
   515
      case arg: Any =>
e83356e94380 more careful shutdown (amending f2f53f7046f4);
wenzelm
parents: 56706
diff changeset
   516
        //{{{
e83356e94380 more careful shutdown (amending f2f53f7046f4);
wenzelm
parents: 56706
diff changeset
   517
        arg match {
56733
f7700146678d manager is direct receiver of prover output -- discontinued old performance tuning (329320fc88df, 1baa5d19ac44);
wenzelm
parents: 56719
diff changeset
   518
          case output: Prover.Output =>
56775
59f70b89e5fd improved syslog performance -- avoid denial-of-service e.g. with threads_trace = 5 and active Syslog dockable;
wenzelm
parents: 56772
diff changeset
   519
            if (output.is_stdout || output.is_stderr)
59f70b89e5fd improved syslog performance -- avoid denial-of-service e.g. with threads_trace = 5 and active Syslog dockable;
wenzelm
parents: 56772
diff changeset
   520
              raw_output_messages.post(output)
56733
f7700146678d manager is direct receiver of prover output -- discontinued old performance tuning (329320fc88df, 1baa5d19ac44);
wenzelm
parents: 56719
diff changeset
   521
            else handle_output(output)
56775
59f70b89e5fd improved syslog performance -- avoid denial-of-service e.g. with threads_trace = 5 and active Syslog dockable;
wenzelm
parents: 56772
diff changeset
   522
56733
f7700146678d manager is direct receiver of prover output -- discontinued old performance tuning (329320fc88df, 1baa5d19ac44);
wenzelm
parents: 56719
diff changeset
   523
            if (output.is_syslog) {
56775
59f70b89e5fd improved syslog performance -- avoid denial-of-service e.g. with threads_trace = 5 and active Syslog dockable;
wenzelm
parents: 56772
diff changeset
   524
              syslog += output.message
56733
f7700146678d manager is direct receiver of prover output -- discontinued old performance tuning (329320fc88df, 1baa5d19ac44);
wenzelm
parents: 56719
diff changeset
   525
              syslog_messages.post(output)
f7700146678d manager is direct receiver of prover output -- discontinued old performance tuning (329320fc88df, 1baa5d19ac44);
wenzelm
parents: 56719
diff changeset
   526
            }
56775
59f70b89e5fd improved syslog performance -- avoid denial-of-service e.g. with threads_trace = 5 and active Syslog dockable;
wenzelm
parents: 56772
diff changeset
   527
56733
f7700146678d manager is direct receiver of prover output -- discontinued old performance tuning (329320fc88df, 1baa5d19ac44);
wenzelm
parents: 56719
diff changeset
   528
            all_messages.post(output)
f7700146678d manager is direct receiver of prover output -- discontinued old performance tuning (329320fc88df, 1baa5d19ac44);
wenzelm
parents: 56719
diff changeset
   529
f7700146678d manager is direct receiver of prover output -- discontinued old performance tuning (329320fc88df, 1baa5d19ac44);
wenzelm
parents: 56719
diff changeset
   530
          case input: Prover.Input =>
f7700146678d manager is direct receiver of prover output -- discontinued old performance tuning (329320fc88df, 1baa5d19ac44);
wenzelm
parents: 56719
diff changeset
   531
            all_messages.post(input)
f7700146678d manager is direct receiver of prover output -- discontinued old performance tuning (329320fc88df, 1baa5d19ac44);
wenzelm
parents: 56719
diff changeset
   532
56793
d5ab6a8799ce more synchronized treatment of prover process, which might emit more messages before shutdown and requires manager to accept them;
wenzelm
parents: 56782
diff changeset
   533
          case Start(name, args) if !prover.defined =>
56709
e83356e94380 more careful shutdown (amending f2f53f7046f4);
wenzelm
parents: 56706
diff changeset
   534
            if (phase == Session.Inactive || phase == Session.Failed) {
e83356e94380 more careful shutdown (amending f2f53f7046f4);
wenzelm
parents: 56706
diff changeset
   535
              phase = Session.Startup
56793
d5ab6a8799ce more synchronized treatment of prover process, which might emit more messages before shutdown and requires manager to accept them;
wenzelm
parents: 56782
diff changeset
   536
              prover.set(resources.start_prover(manager.send(_), name, args))
56709
e83356e94380 more careful shutdown (amending f2f53f7046f4);
wenzelm
parents: 56706
diff changeset
   537
            }
56706
f2f53f7046f4 converted main session manager to Consumer_Thread: messages need to be consumed immediately, postponed_changes replaces implicit actor mailbox scanning;
wenzelm
parents: 56705
diff changeset
   538
56709
e83356e94380 more careful shutdown (amending f2f53f7046f4);
wenzelm
parents: 56706
diff changeset
   539
          case Stop =>
56793
d5ab6a8799ce more synchronized treatment of prover process, which might emit more messages before shutdown and requires manager to accept them;
wenzelm
parents: 56782
diff changeset
   540
            if (prover.defined && is_ready) {
59366
e94df7f6b608 clarified build_theories: proper protocol handler;
wenzelm
parents: 59364
diff changeset
   541
              _protocol_handlers.change(_.stop(prover.get))
56772
725a192f8081 tuned comments;
wenzelm
parents: 56771
diff changeset
   542
              global_state.change(_ => Document.State.init)
56709
e83356e94380 more careful shutdown (amending f2f53f7046f4);
wenzelm
parents: 56706
diff changeset
   543
              phase = Session.Shutdown
e83356e94380 more careful shutdown (amending f2f53f7046f4);
wenzelm
parents: 56706
diff changeset
   544
              prover.get.terminate
e83356e94380 more careful shutdown (amending f2f53f7046f4);
wenzelm
parents: 56706
diff changeset
   545
            }
56706
f2f53f7046f4 converted main session manager to Consumer_Thread: messages need to be consumed immediately, postponed_changes replaces implicit actor mailbox scanning;
wenzelm
parents: 56705
diff changeset
   546
56771
28d62a5b07e8 more systematic delay_first discipline for change_buffer and prune_history;
wenzelm
parents: 56735
diff changeset
   547
          case Prune_History =>
56793
d5ab6a8799ce more synchronized treatment of prover process, which might emit more messages before shutdown and requires manager to accept them;
wenzelm
parents: 56782
diff changeset
   548
            if (prover.defined) {
57976
bf99106b6672 postpone changes in intermediate state between remove_versions/removed_versions, which is important for handle_change to refer to defined items on prover side;
wenzelm
parents: 57867
diff changeset
   549
              val old_versions = global_state.change_result(_.remove_versions(prune_size))
59319
wenzelm
parents: 59086
diff changeset
   550
              if (old_versions.nonEmpty) prover.get.remove_versions(old_versions)
56771
28d62a5b07e8 more systematic delay_first discipline for change_buffer and prune_history;
wenzelm
parents: 56735
diff changeset
   551
            }
28d62a5b07e8 more systematic delay_first discipline for change_buffer and prune_history;
wenzelm
parents: 56735
diff changeset
   552
56709
e83356e94380 more careful shutdown (amending f2f53f7046f4);
wenzelm
parents: 56706
diff changeset
   553
          case Update_Options(options) =>
56793
d5ab6a8799ce more synchronized treatment of prover process, which might emit more messages before shutdown and requires manager to accept them;
wenzelm
parents: 56782
diff changeset
   554
            if (prover.defined && is_ready) {
56709
e83356e94380 more careful shutdown (amending f2f53f7046f4);
wenzelm
parents: 56706
diff changeset
   555
              prover.get.options(options)
e83356e94380 more careful shutdown (amending f2f53f7046f4);
wenzelm
parents: 56706
diff changeset
   556
              handle_raw_edits(Document.Blobs.empty, Nil)
e83356e94380 more careful shutdown (amending f2f53f7046f4);
wenzelm
parents: 56706
diff changeset
   557
            }
56715
52125652e82a clarified Session.Consumer, with Session.Outlet managed by dispatcher thread;
wenzelm
parents: 56713
diff changeset
   558
            global_options.post(Session.Global_Options(options))
34809
0fed930f2992 misc tuning;
wenzelm
parents: 34808
diff changeset
   559
56793
d5ab6a8799ce more synchronized treatment of prover process, which might emit more messages before shutdown and requires manager to accept them;
wenzelm
parents: 56782
diff changeset
   560
          case Cancel_Exec(exec_id) if prover.defined =>
56709
e83356e94380 more careful shutdown (amending f2f53f7046f4);
wenzelm
parents: 56706
diff changeset
   561
            prover.get.cancel_exec(exec_id)
56706
f2f53f7046f4 converted main session manager to Consumer_Thread: messages need to be consumed immediately, postponed_changes replaces implicit actor mailbox scanning;
wenzelm
parents: 56705
diff changeset
   562
56793
d5ab6a8799ce more synchronized treatment of prover process, which might emit more messages before shutdown and requires manager to accept them;
wenzelm
parents: 56782
diff changeset
   563
          case Session.Raw_Edits(doc_blobs, edits) if prover.defined =>
56709
e83356e94380 more careful shutdown (amending f2f53f7046f4);
wenzelm
parents: 56706
diff changeset
   564
            handle_raw_edits(doc_blobs, edits)
e83356e94380 more careful shutdown (amending f2f53f7046f4);
wenzelm
parents: 56706
diff changeset
   565
56793
d5ab6a8799ce more synchronized treatment of prover process, which might emit more messages before shutdown and requires manager to accept them;
wenzelm
parents: 56782
diff changeset
   566
          case Session.Dialog_Result(id, serial, result) if prover.defined =>
56709
e83356e94380 more careful shutdown (amending f2f53f7046f4);
wenzelm
parents: 56706
diff changeset
   567
            prover.get.dialog_result(serial, result)
e83356e94380 more careful shutdown (amending f2f53f7046f4);
wenzelm
parents: 56706
diff changeset
   568
            handle_output(new Prover.Output(Protocol.Dialog_Result(id, serial, result)))
56706
f2f53f7046f4 converted main session manager to Consumer_Thread: messages need to be consumed immediately, postponed_changes replaces implicit actor mailbox scanning;
wenzelm
parents: 56705
diff changeset
   569
59364
3b5da177ae6b clarified build_theories;
wenzelm
parents: 59362
diff changeset
   570
          case Session.Build_Theories(id, master_dir, theories) if prover.defined =>
3b5da177ae6b clarified build_theories;
wenzelm
parents: 59362
diff changeset
   571
            prover.get.build_theories(id, master_dir, theories)
59362
41f1645a4f63 some support for PIDE batch session;
wenzelm
parents: 59319
diff changeset
   572
56793
d5ab6a8799ce more synchronized treatment of prover process, which might emit more messages before shutdown and requires manager to accept them;
wenzelm
parents: 56782
diff changeset
   573
          case Protocol_Command(name, args) if prover.defined =>
56709
e83356e94380 more careful shutdown (amending f2f53f7046f4);
wenzelm
parents: 56706
diff changeset
   574
            prover.get.protocol_command(name, args:_*)
56706
f2f53f7046f4 converted main session manager to Consumer_Thread: messages need to be consumed immediately, postponed_changes replaces implicit actor mailbox scanning;
wenzelm
parents: 56705
diff changeset
   575
56793
d5ab6a8799ce more synchronized treatment of prover process, which might emit more messages before shutdown and requires manager to accept them;
wenzelm
parents: 56782
diff changeset
   576
          case change: Session.Change if prover.defined =>
57976
bf99106b6672 postpone changes in intermediate state between remove_versions/removed_versions, which is important for handle_change to refer to defined items on prover side;
wenzelm
parents: 57867
diff changeset
   577
            val state = global_state.value
bf99106b6672 postpone changes in intermediate state between remove_versions/removed_versions, which is important for handle_change to refer to defined items on prover side;
wenzelm
parents: 57867
diff changeset
   578
            if (!state.removing_versions && state.is_assigned(change.previous))
56709
e83356e94380 more careful shutdown (amending f2f53f7046f4);
wenzelm
parents: 56706
diff changeset
   579
              handle_change(change)
e83356e94380 more careful shutdown (amending f2f53f7046f4);
wenzelm
parents: 56706
diff changeset
   580
            else postponed_changes.store(change)
57651
10df45dd14da less warnings -- ignore potential prover startup/shutdown races;
wenzelm
parents: 56864
diff changeset
   581
57976
bf99106b6672 postpone changes in intermediate state between remove_versions/removed_versions, which is important for handle_change to refer to defined items on prover side;
wenzelm
parents: 57867
diff changeset
   582
          case Session.Change_Flush if prover.defined =>
bf99106b6672 postpone changes in intermediate state between remove_versions/removed_versions, which is important for handle_change to refer to defined items on prover side;
wenzelm
parents: 57867
diff changeset
   583
            val state = global_state.value
bf99106b6672 postpone changes in intermediate state between remove_versions/removed_versions, which is important for handle_change to refer to defined items on prover side;
wenzelm
parents: 57867
diff changeset
   584
            if (!state.removing_versions)
bf99106b6672 postpone changes in intermediate state between remove_versions/removed_versions, which is important for handle_change to refer to defined items on prover side;
wenzelm
parents: 57867
diff changeset
   585
              postponed_changes.flush(state).foreach(handle_change(_))
bf99106b6672 postpone changes in intermediate state between remove_versions/removed_versions, which is important for handle_change to refer to defined items on prover side;
wenzelm
parents: 57867
diff changeset
   586
57651
10df45dd14da less warnings -- ignore potential prover startup/shutdown races;
wenzelm
parents: 56864
diff changeset
   587
          case bad =>
10df45dd14da less warnings -- ignore potential prover startup/shutdown races;
wenzelm
parents: 56864
diff changeset
   588
            if (verbose) Output.warning("Ignoring bad message: " + bad.toString)
56706
f2f53f7046f4 converted main session manager to Consumer_Thread: messages need to be consumed immediately, postponed_changes replaces implicit actor mailbox scanning;
wenzelm
parents: 56705
diff changeset
   589
        }
56709
e83356e94380 more careful shutdown (amending f2f53f7046f4);
wenzelm
parents: 56706
diff changeset
   590
        true
e83356e94380 more careful shutdown (amending f2f53f7046f4);
wenzelm
parents: 56706
diff changeset
   591
        //}}}
e83356e94380 more careful shutdown (amending f2f53f7046f4);
wenzelm
parents: 56706
diff changeset
   592
    }
34777
91d6089cef88 class Session models full session, with or without prover process (cf. heaps, browser_info);
wenzelm
parents:
diff changeset
   593
  }
91d6089cef88 class Session models full session, with or without prover process (cf. heaps, browser_info);
wenzelm
parents:
diff changeset
   594
34809
0fed930f2992 misc tuning;
wenzelm
parents: 34808
diff changeset
   595
56799
wenzelm
parents: 56793
diff changeset
   596
  /* main operations */
wenzelm
parents: 56793
diff changeset
   597
wenzelm
parents: 56793
diff changeset
   598
  def snapshot(name: Document.Node.Name = Document.Node.Name.empty,
wenzelm
parents: 56793
diff changeset
   599
      pending_edits: List[Text.Edit] = Nil): Document.Snapshot =
wenzelm
parents: 56793
diff changeset
   600
    global_state.value.snapshot(name, pending_edits)
34809
0fed930f2992 misc tuning;
wenzelm
parents: 34808
diff changeset
   601
56387
d92eb5c3960d more general prover operations;
wenzelm
parents: 56385
diff changeset
   602
  def start(name: String, args: List[String])
56706
f2f53f7046f4 converted main session manager to Consumer_Thread: messages need to be consumed immediately, postponed_changes replaces implicit actor mailbox scanning;
wenzelm
parents: 56705
diff changeset
   603
  { manager.send(Start(name, args)) }
45076
dd803d319d5b tuned signature;
wenzelm
parents: 45075
diff changeset
   604
50117
32755e357a51 update options via protocol;
wenzelm
parents: 49524
diff changeset
   605
  def stop()
32755e357a51 update options via protocol;
wenzelm
parents: 49524
diff changeset
   606
  {
56709
e83356e94380 more careful shutdown (amending f2f53f7046f4);
wenzelm
parents: 56706
diff changeset
   607
    manager.send_wait(Stop)
56793
d5ab6a8799ce more synchronized treatment of prover process, which might emit more messages before shutdown and requires manager to accept them;
wenzelm
parents: 56782
diff changeset
   608
    prover.await_reset()
56704
c2f0ddd14747 simplified -- prefer Consumer_Thread over Actor;
wenzelm
parents: 56691
diff changeset
   609
    change_parser.shutdown()
56706
f2f53f7046f4 converted main session manager to Consumer_Thread: messages need to be consumed immediately, postponed_changes replaces implicit actor mailbox scanning;
wenzelm
parents: 56705
diff changeset
   610
    change_buffer.shutdown()
56771
28d62a5b07e8 more systematic delay_first discipline for change_buffer and prune_history;
wenzelm
parents: 56735
diff changeset
   611
    delay_prune.revoke()
56706
f2f53f7046f4 converted main session manager to Consumer_Thread: messages need to be consumed immediately, postponed_changes replaces implicit actor mailbox scanning;
wenzelm
parents: 56705
diff changeset
   612
    manager.shutdown()
56715
52125652e82a clarified Session.Consumer, with Session.Outlet managed by dispatcher thread;
wenzelm
parents: 56713
diff changeset
   613
    dispatcher.shutdown()
50117
32755e357a51 update options via protocol;
wenzelm
parents: 49524
diff changeset
   614
  }
38841
4df7b76249a0 include Document.History in Document.State -- just one universal session state maintained by main actor;
wenzelm
parents: 38722
diff changeset
   615
53054
8365d7fca3de public access for protocol handlers and protocol commands -- to be used within reason;
wenzelm
parents: 52931
diff changeset
   616
  def protocol_command(name: String, args: String*)
56706
f2f53f7046f4 converted main session manager to Consumer_Thread: messages need to be consumed immediately, postponed_changes replaces implicit actor mailbox scanning;
wenzelm
parents: 56705
diff changeset
   617
  { manager.send(Protocol_Command(name, args.toList)) }
53054
8365d7fca3de public access for protocol handlers and protocol commands -- to be used within reason;
wenzelm
parents: 52931
diff changeset
   618
56706
f2f53f7046f4 converted main session manager to Consumer_Thread: messages need to be consumed immediately, postponed_changes replaces implicit actor mailbox scanning;
wenzelm
parents: 56705
diff changeset
   619
  def cancel_exec(exec_id: Document_ID.Exec)
f2f53f7046f4 converted main session manager to Consumer_Thread: messages need to be consumed immediately, postponed_changes replaces implicit actor mailbox scanning;
wenzelm
parents: 56705
diff changeset
   620
  { manager.send(Cancel_Exec(exec_id)) }
52931
ac6648c0c0fb cancel_query via direct access to the exec_id of the running query process;
wenzelm
parents: 52800
diff changeset
   621
54521
744ea0025e11 clarified Document.Blobs environment vs. actual edits of auxiliary files;
wenzelm
parents: 54519
diff changeset
   622
  def update(doc_blobs: Document.Blobs, edits: List[Document.Edit_Text])
59319
wenzelm
parents: 59086
diff changeset
   623
  { if (edits.nonEmpty) manager.send_wait(Session.Raw_Edits(doc_blobs, edits)) }
50498
6647ba2775c1 support dialog via document content;
wenzelm
parents: 50433
diff changeset
   624
52084
573e80625c78 more explicit Session.update_options as source of Global_Options event;
wenzelm
parents: 51818
diff changeset
   625
  def update_options(options: Options)
56706
f2f53f7046f4 converted main session manager to Consumer_Thread: messages need to be consumed immediately, postponed_changes replaces implicit actor mailbox scanning;
wenzelm
parents: 56705
diff changeset
   626
  { manager.send_wait(Update_Options(options)) }
52084
573e80625c78 more explicit Session.update_options as source of Global_Options event;
wenzelm
parents: 51818
diff changeset
   627
52531
21f8e0e151f5 tuned signature;
wenzelm
parents: 52530
diff changeset
   628
  def dialog_result(id: Document_ID.Generic, serial: Long, result: String)
56706
f2f53f7046f4 converted main session manager to Consumer_Thread: messages need to be consumed immediately, postponed_changes replaces implicit actor mailbox scanning;
wenzelm
parents: 56705
diff changeset
   629
  { manager.send(Session.Dialog_Result(id, serial, result)) }
59362
41f1645a4f63 some support for PIDE batch session;
wenzelm
parents: 59319
diff changeset
   630
59364
3b5da177ae6b clarified build_theories;
wenzelm
parents: 59362
diff changeset
   631
  def build_theories(id: String, master_dir: Path, theories: List[(Options, List[Path])])
3b5da177ae6b clarified build_theories;
wenzelm
parents: 59362
diff changeset
   632
  { manager.send(Session.Build_Theories(id, master_dir, theories)) }
34777
91d6089cef88 class Session models full session, with or without prover process (cf. heaps, browser_info);
wenzelm
parents:
diff changeset
   633
}