src/Pure/System/session.scala
author wenzelm
Sat Aug 17 22:08:21 2013 +0200 (2013-08-17 ago)
changeset 53054 8365d7fca3de
parent 52931 ac6648c0c0fb
child 54442 c39972ddd672
permissions -rw-r--r--
public access for protocol handlers and protocol commands -- to be used within reason;
wenzelm@36676
     1
/*  Title:      Pure/System/session.scala
wenzelm@36676
     2
    Author:     Makarius
wenzelm@38221
     3
    Options:    :folding=explicit:collapseFolds=1:
wenzelm@36676
     4
wenzelm@43651
     5
Main Isabelle/Scala session, potentially with running prover process.
wenzelm@36676
     6
*/
wenzelm@34777
     7
wenzelm@34871
     8
package isabelle
wenzelm@34777
     9
wenzelm@44733
    10
wenzelm@43520
    11
import java.lang.System
wenzelm@44733
    12
import java.util.{Timer, TimerTask}
wenzelm@34777
    13
wenzelm@44733
    14
import scala.collection.mutable
wenzelm@46771
    15
import scala.collection.immutable.Queue
wenzelm@34820
    16
import scala.actors.TIMEOUT
wenzelm@34777
    17
import scala.actors.Actor._
wenzelm@34777
    18
wenzelm@34815
    19
wenzelm@34791
    20
object Session
wenzelm@34791
    21
{
wenzelm@34813
    22
  /* events */
wenzelm@34813
    23
wenzelm@43716
    24
  //{{{
wenzelm@50697
    25
  case class Statistics(props: Properties.T)
wenzelm@50117
    26
  case class Global_Options(options: Options)
wenzelm@44805
    27
  case object Caret_Focus
wenzelm@49196
    28
  case class Raw_Edits(edits: List[Document.Edit_Text])
wenzelm@52531
    29
  case class Dialog_Result(id: Document_ID.Generic, serial: Long, result: String)
wenzelm@47027
    30
  case class Commands_Changed(
wenzelm@47027
    31
    assignment: Boolean, nodes: Set[Document.Node.Name], commands: Set[Command])
wenzelm@39630
    32
wenzelm@39630
    33
  sealed abstract class Phase
wenzelm@39630
    34
  case object Inactive extends Phase
wenzelm@39701
    35
  case object Startup extends Phase  // transient
wenzelm@39701
    36
  case object Failed extends Phase
wenzelm@39630
    37
  case object Ready extends Phase
wenzelm@39701
    38
  case object Shutdown extends Phase  // transient
wenzelm@43716
    39
  //}}}
wenzelm@52111
    40
wenzelm@52111
    41
wenzelm@52111
    42
  /* protocol handlers */
wenzelm@52111
    43
wenzelm@52111
    44
  type Prover = Isabelle_Process with Protocol
wenzelm@52111
    45
wenzelm@52111
    46
  abstract class Protocol_Handler
wenzelm@52111
    47
  {
wenzelm@52111
    48
    def stop(prover: Prover): Unit = {}
wenzelm@52111
    49
    val functions: Map[String, (Prover, Isabelle_Process.Output) => Boolean]
wenzelm@52111
    50
  }
wenzelm@52111
    51
wenzelm@52111
    52
  class Protocol_Handlers(
wenzelm@52111
    53
    handlers: Map[String, Session.Protocol_Handler] = Map.empty,
wenzelm@52111
    54
    functions: Map[String, Isabelle_Process.Output => Boolean] = Map.empty)
wenzelm@52111
    55
  {
wenzelm@53054
    56
    def get(name: String): Option[Protocol_Handler] = handlers.get(name)
wenzelm@53054
    57
wenzelm@52111
    58
    def add(prover: Prover, name: String): Protocol_Handlers =
wenzelm@52111
    59
    {
wenzelm@52111
    60
      val (handlers1, functions1) =
wenzelm@52111
    61
        handlers.get(name) match {
wenzelm@52111
    62
          case Some(old_handler) =>
wenzelm@52111
    63
            System.err.println("Redefining protocol handler: " + name)
wenzelm@52111
    64
            old_handler.stop(prover)
wenzelm@52111
    65
            (handlers - name, functions -- old_handler.functions.keys)
wenzelm@52111
    66
          case None => (handlers, functions)
wenzelm@52111
    67
        }
wenzelm@52111
    68
wenzelm@52111
    69
      val (handlers2, functions2) =
wenzelm@52111
    70
        try {
wenzelm@52111
    71
          val new_handler = Class.forName(name).newInstance.asInstanceOf[Protocol_Handler]
wenzelm@52111
    72
          val new_functions =
wenzelm@52111
    73
            for ((a, f) <- new_handler.functions.toList) yield
wenzelm@52111
    74
              (a, (output: Isabelle_Process.Output) => f(prover, output))
wenzelm@52111
    75
wenzelm@52111
    76
          val dups = for ((a, _) <- new_functions if functions1.isDefinedAt(a)) yield a
wenzelm@52111
    77
          if (!dups.isEmpty) error("Duplicate protocol functions: " + commas_quote(dups))
wenzelm@52111
    78
wenzelm@52111
    79
          (handlers1 + (name -> new_handler), functions1 ++ new_functions)
wenzelm@52111
    80
        }
wenzelm@52111
    81
        catch {
wenzelm@52111
    82
          case exn: Throwable =>
wenzelm@52111
    83
            System.err.println("Failed to initialize protocol handler: " +
wenzelm@52111
    84
              name + "\n" + Exn.message(exn))
wenzelm@52111
    85
            (handlers1, functions1)
wenzelm@52111
    86
        }
wenzelm@52111
    87
wenzelm@52111
    88
      new Protocol_Handlers(handlers2, functions2)
wenzelm@52111
    89
    }
wenzelm@52111
    90
wenzelm@52111
    91
    def invoke(output: Isabelle_Process.Output): Boolean =
wenzelm@52111
    92
      output.properties match {
wenzelm@52111
    93
        case Markup.Function(a) if functions.isDefinedAt(a) =>
wenzelm@52111
    94
          try { functions(a)(output) }
wenzelm@52111
    95
          catch {
wenzelm@52111
    96
            case exn: Throwable =>
wenzelm@52111
    97
              System.err.println("Failed invocation of protocol function: " +
wenzelm@52111
    98
                quote(a) + "\n" + Exn.message(exn))
wenzelm@52111
    99
            false
wenzelm@52111
   100
          }
wenzelm@52111
   101
        case _ => false
wenzelm@52111
   102
      }
wenzelm@52113
   103
wenzelm@52113
   104
    def stop(prover: Prover): Protocol_Handlers =
wenzelm@52113
   105
    {
wenzelm@52113
   106
      for ((_, handler) <- handlers) handler.stop(prover)
wenzelm@52113
   107
      new Protocol_Handlers()
wenzelm@52113
   108
    }
wenzelm@52111
   109
  }
wenzelm@34791
   110
}
wenzelm@34791
   111
wenzelm@34777
   112
wenzelm@48870
   113
class Session(val thy_load: Thy_Load)
wenzelm@34777
   114
{
wenzelm@47653
   115
  /* global flags */
wenzelm@47653
   116
wenzelm@47653
   117
  @volatile var timing: Boolean = false
wenzelm@47653
   118
  @volatile var verbose: Boolean = false
wenzelm@47653
   119
wenzelm@47653
   120
wenzelm@49288
   121
  /* tuning parameters */
wenzelm@49288
   122
wenzelm@49288
   123
  def output_delay: Time = Time.seconds(0.1)  // prover output (markup, common messages)
wenzelm@52800
   124
  def message_delay: Time = Time.seconds(0.1)  // prover input/output messages
wenzelm@49293
   125
  def prune_delay: Time = Time.seconds(60.0)  // prune history -- delete old versions
wenzelm@49293
   126
  def prune_size: Int = 0  // size of retained history
wenzelm@49293
   127
  def syslog_limit: Int = 100
wenzelm@49524
   128
  def reparse_limit: Int = 0
wenzelm@37849
   129
wenzelm@37849
   130
wenzelm@34809
   131
  /* pervasive event buses */
wenzelm@34809
   132
wenzelm@50433
   133
  val statistics = new Event_Bus[Session.Statistics]
wenzelm@50117
   134
  val global_options = new Event_Bus[Session.Global_Options]
wenzelm@44805
   135
  val caret_focus = new Event_Bus[Session.Caret_Focus.type]
wenzelm@49196
   136
  val raw_edits = new Event_Bus[Session.Raw_Edits]
wenzelm@43716
   137
  val commands_changed = new Event_Bus[Session.Commands_Changed]
wenzelm@43716
   138
  val phase_changed = new Event_Bus[Session.Phase]
wenzelm@46772
   139
  val syslog_messages = new Event_Bus[Isabelle_Process.Output]
wenzelm@46772
   140
  val raw_output_messages = new Event_Bus[Isabelle_Process.Output]
wenzelm@46774
   141
  val all_messages = new Event_Bus[Isabelle_Process.Message]  // potential bottle-neck
wenzelm@43716
   142
wenzelm@34809
   143
wenzelm@34809
   144
wenzelm@38841
   145
  /** buffered command changes (delay_first discipline) **/
wenzelm@38841
   146
wenzelm@43716
   147
  //{{{
wenzelm@38841
   148
  private case object Stop
wenzelm@38841
   149
wenzelm@44722
   150
  private val (_, commands_changed_buffer) =
wenzelm@44722
   151
    Simple_Thread.actor("commands_changed_buffer", daemon = true)
wenzelm@38841
   152
  {
wenzelm@38841
   153
    var finished = false
wenzelm@38841
   154
    while (!finished) {
wenzelm@44722
   155
      receive {
wenzelm@39630
   156
        case Stop => finished = true; reply(())
wenzelm@44722
   157
        case changed: Session.Commands_Changed => commands_changed.event(changed)
wenzelm@44722
   158
        case bad => System.err.println("commands_changed_buffer: ignoring bad message " + bad)
wenzelm@38841
   159
      }
wenzelm@38841
   160
    }
wenzelm@38841
   161
  }
wenzelm@38841
   162
  //}}}
wenzelm@38841
   163
wenzelm@38841
   164
wenzelm@45635
   165
  /** pipelined change parsing **/
wenzelm@45635
   166
wenzelm@45635
   167
  //{{{
wenzelm@45635
   168
  private case class Text_Edits(
wenzelm@45635
   169
    previous: Future[Document.Version],
wenzelm@45635
   170
    text_edits: List[Document.Edit_Text],
wenzelm@45635
   171
    version_result: Promise[Document.Version])
wenzelm@45635
   172
wenzelm@45635
   173
  private val (_, change_parser) = Simple_Thread.actor("change_parser", daemon = true)
wenzelm@45635
   174
  {
wenzelm@45635
   175
    var finished = false
wenzelm@45635
   176
    while (!finished) {
wenzelm@45635
   177
      receive {
wenzelm@45635
   178
        case Stop => finished = true; reply(())
wenzelm@45635
   179
wenzelm@47629
   180
        case Text_Edits(previous, text_edits, version_result) =>
wenzelm@45635
   181
          val prev = previous.get_finished
wenzelm@47653
   182
          val (doc_edits, version) =
wenzelm@50566
   183
            Timing.timeit("Thy_Load.text_edits", timing) {
wenzelm@50566
   184
              thy_load.text_edits(reparse_limit, prev, text_edits)
wenzelm@47653
   185
            }
wenzelm@45635
   186
          version_result.fulfill(version)
wenzelm@47629
   187
          sender ! Change(doc_edits, prev, version)
wenzelm@45635
   188
wenzelm@45635
   189
        case bad => System.err.println("change_parser: ignoring bad message " + bad)
wenzelm@45635
   190
      }
wenzelm@45635
   191
    }
wenzelm@45635
   192
  }
wenzelm@45635
   193
  //}}}
wenzelm@45635
   194
wenzelm@38841
   195
wenzelm@47653
   196
wenzelm@38841
   197
  /** main protocol actor **/
wenzelm@34809
   198
wenzelm@43651
   199
  /* global state */
wenzelm@43644
   200
wenzelm@46771
   201
  private val syslog = Volatile(Queue.empty[XML.Elem])
wenzelm@49416
   202
  def current_syslog(): String = cat_lines(syslog().iterator.map(XML.content))
wenzelm@39626
   203
wenzelm@39630
   204
  @volatile private var _phase: Session.Phase = Session.Inactive
wenzelm@39633
   205
  private def phase_=(new_phase: Session.Phase)
wenzelm@39630
   206
  {
wenzelm@39630
   207
    _phase = new_phase
wenzelm@39701
   208
    phase_changed.event(new_phase)
wenzelm@39630
   209
  }
wenzelm@43716
   210
  def phase = _phase
wenzelm@43553
   211
  def is_ready: Boolean = phase == Session.Ready
wenzelm@39630
   212
wenzelm@45248
   213
  private val global_state = Volatile(Document.State.init)
wenzelm@43719
   214
  def current_state(): Document.State = global_state()
wenzelm@46944
   215
wenzelm@46944
   216
  def recent_syntax(): Outer_Syntax =
wenzelm@46944
   217
  {
wenzelm@46944
   218
    val version = current_state().recent_finished.version.get_finished
wenzelm@48870
   219
    if (version.is_init) thy_load.base_syntax
wenzelm@46944
   220
    else version.syntax
wenzelm@46944
   221
  }
wenzelm@34816
   222
wenzelm@44960
   223
  def snapshot(name: Document.Node.Name = Document.Node.Name.empty,
wenzelm@44960
   224
      pending_edits: List[Text.Edit] = Nil): Document.Snapshot =
wenzelm@43719
   225
    global_state().snapshot(name, pending_edits)
wenzelm@43716
   226
wenzelm@43651
   227
wenzelm@53054
   228
  /* protocol handlers */
wenzelm@53054
   229
wenzelm@53054
   230
  @volatile private var _protocol_handlers = new Session.Protocol_Handlers()
wenzelm@53054
   231
wenzelm@53054
   232
  def protocol_handler(name: String): Option[Session.Protocol_Handler] =
wenzelm@53054
   233
    _protocol_handlers.get(name)
wenzelm@53054
   234
wenzelm@53054
   235
wenzelm@43651
   236
  /* theory files */
wenzelm@43651
   237
wenzelm@48707
   238
  def header_edit(name: Document.Node.Name, header: Document.Node.Header): Document.Edit_Text =
wenzelm@44442
   239
  {
wenzelm@48707
   240
    val header1 =
wenzelm@48870
   241
      if (thy_load.loaded_theories(name.theory))
wenzelm@48707
   242
        header.error("Attempt to update loaded theory " + quote(name.theory))
wenzelm@48707
   243
      else header
wenzelm@48707
   244
    (name, Document.Node.Deps(header1))
wenzelm@44442
   245
  }
wenzelm@44442
   246
wenzelm@43651
   247
wenzelm@43651
   248
  /* actor messages */
wenzelm@43651
   249
wenzelm@48870
   250
  private case class Start(args: List[String])
wenzelm@52931
   251
  private case class Cancel_Exec(exec_id: Document_ID.Exec)
wenzelm@47629
   252
  private case class Change(
wenzelm@43722
   253
    doc_edits: List[Document.Edit_Command],
wenzelm@43722
   254
    previous: Document.Version,
wenzelm@43722
   255
    version: Document.Version)
wenzelm@53054
   256
  private case class Protocol_Command(name: String, args: List[String])
wenzelm@44733
   257
  private case class Messages(msgs: List[Isabelle_Process.Message])
wenzelm@52084
   258
  private case class Update_Options(options: Options)
wenzelm@41534
   259
wenzelm@39572
   260
  private val (_, session_actor) = Simple_Thread.actor("session_actor", daemon = true)
wenzelm@38639
   261
  {
wenzelm@43648
   262
    val this_actor = self
wenzelm@34809
   263
wenzelm@52111
   264
    var prune_next = System.currentTimeMillis() + prune_delay.ms
wenzelm@49470
   265
wenzelm@34809
   266
wenzelm@44733
   267
    /* buffered prover messages */
wenzelm@44733
   268
wenzelm@44733
   269
    object receiver
wenzelm@44733
   270
    {
wenzelm@44733
   271
      private var buffer = new mutable.ListBuffer[Isabelle_Process.Message]
wenzelm@44733
   272
wenzelm@52800
   273
      private def flush(): Unit = synchronized {
wenzelm@44733
   274
        if (!buffer.isEmpty) {
wenzelm@44733
   275
          val msgs = buffer.toList
wenzelm@44733
   276
          this_actor ! Messages(msgs)
wenzelm@44733
   277
          buffer = new mutable.ListBuffer[Isabelle_Process.Message]
wenzelm@44733
   278
        }
wenzelm@44733
   279
      }
wenzelm@44733
   280
      def invoke(msg: Isabelle_Process.Message): Unit = synchronized {
wenzelm@44733
   281
        msg match {
wenzelm@52800
   282
          case _: Isabelle_Process.Input =>
wenzelm@52800
   283
            buffer += msg
wenzelm@46772
   284
          case output: Isabelle_Process.Output =>
wenzelm@52800
   285
            if (output.is_protocol && output.properties == Markup.Flush) flush()
wenzelm@52800
   286
            else {
wenzelm@52800
   287
              buffer += msg
wenzelm@52800
   288
              if (output.is_syslog)
wenzelm@52800
   289
                syslog >> (queue =>
wenzelm@52800
   290
                  {
wenzelm@52800
   291
                    val queue1 = queue.enqueue(output.message)
wenzelm@52800
   292
                    if (queue1.length > syslog_limit) queue1.dequeue._2 else queue1
wenzelm@52800
   293
                  })
wenzelm@52800
   294
            }
wenzelm@44733
   295
        }
wenzelm@44733
   296
      }
wenzelm@44733
   297
wenzelm@44733
   298
      private val timer = new Timer("session_actor.receiver", true)
wenzelm@44733
   299
      timer.schedule(new TimerTask { def run = flush }, message_delay.ms, message_delay.ms)
wenzelm@44733
   300
wenzelm@44733
   301
      def cancel() { timer.cancel() }
wenzelm@44733
   302
    }
wenzelm@44733
   303
wenzelm@52111
   304
    var prover: Option[Session.Prover] = None
wenzelm@44733
   305
wenzelm@44733
   306
wenzelm@44722
   307
    /* delayed command changes */
wenzelm@44722
   308
wenzelm@46570
   309
    object delay_commands_changed
wenzelm@44722
   310
    {
wenzelm@47027
   311
      private var changed_assignment: Boolean = false
wenzelm@44722
   312
      private var changed_nodes: Set[Document.Node.Name] = Set.empty
wenzelm@44722
   313
      private var changed_commands: Set[Command] = Set.empty
wenzelm@44722
   314
wenzelm@44722
   315
      private var flush_time: Option[Long] = None
wenzelm@44722
   316
wenzelm@44722
   317
      def flush_timeout: Long =
wenzelm@44722
   318
        flush_time match {
wenzelm@44722
   319
          case None => 5000L
wenzelm@44722
   320
          case Some(time) => (time - System.currentTimeMillis()) max 0
wenzelm@44722
   321
        }
wenzelm@44722
   322
wenzelm@44722
   323
      def flush()
wenzelm@44722
   324
      {
wenzelm@47027
   325
        if (changed_assignment || !changed_nodes.isEmpty || !changed_commands.isEmpty)
wenzelm@47027
   326
          commands_changed_buffer !
wenzelm@47027
   327
            Session.Commands_Changed(changed_assignment, changed_nodes, changed_commands)
wenzelm@47027
   328
        changed_assignment = false
wenzelm@44722
   329
        changed_nodes = Set.empty
wenzelm@44722
   330
        changed_commands = Set.empty
wenzelm@44722
   331
        flush_time = None
wenzelm@44722
   332
      }
wenzelm@44722
   333
wenzelm@47027
   334
      def invoke(assign: Boolean, commands: List[Command])
wenzelm@44722
   335
      {
wenzelm@47027
   336
        changed_assignment |= assign
wenzelm@47027
   337
        for (command <- commands) {
wenzelm@47027
   338
          changed_nodes += command.node_name
wenzelm@47027
   339
          changed_commands += command
wenzelm@47027
   340
        }
wenzelm@44722
   341
        val now = System.currentTimeMillis()
wenzelm@44722
   342
        flush_time match {
wenzelm@44722
   343
          case None => flush_time = Some(now + output_delay.ms)
wenzelm@44722
   344
          case Some(time) => if (now >= time) flush()
wenzelm@44722
   345
        }
wenzelm@44722
   346
      }
wenzelm@44722
   347
    }
wenzelm@44722
   348
wenzelm@44722
   349
wenzelm@52649
   350
    /* raw edits */
wenzelm@52649
   351
wenzelm@52649
   352
    def handle_raw_edits(edits: List[Document.Edit_Text])
wenzelm@52649
   353
    //{{{
wenzelm@52649
   354
    {
wenzelm@52649
   355
      prover.get.discontinue_execution()
wenzelm@52649
   356
wenzelm@52649
   357
      val previous = global_state().history.tip.version
wenzelm@52649
   358
      val version = Future.promise[Document.Version]
wenzelm@52649
   359
      val change = global_state >>> (_.continue_history(previous, edits, version))
wenzelm@52649
   360
wenzelm@52649
   361
      raw_edits.event(Session.Raw_Edits(edits))
wenzelm@52649
   362
      change_parser ! Text_Edits(previous, edits, version)
wenzelm@52649
   363
    }
wenzelm@52649
   364
    //}}}
wenzelm@52649
   365
wenzelm@52649
   366
wenzelm@43716
   367
    /* resulting changes */
wenzelm@34809
   368
wenzelm@47629
   369
    def handle_change(change: Change)
wenzelm@38221
   370
    //{{{
wenzelm@34809
   371
    {
wenzelm@43722
   372
      val previous = change.previous
wenzelm@43722
   373
      val version = change.version
wenzelm@43722
   374
      val doc_edits = change.doc_edits
wenzelm@38366
   375
wenzelm@44383
   376
      def id_command(command: Command)
wenzelm@43720
   377
      {
wenzelm@44582
   378
        if (!global_state().defined_command(command.id)) {
wenzelm@46687
   379
          global_state >> (_.define_command(command))
wenzelm@44644
   380
          prover.get.define_command(command)
wenzelm@43720
   381
        }
wenzelm@43720
   382
      }
wenzelm@44383
   383
      doc_edits foreach {
wenzelm@44383
   384
        case (_, edit) =>
wenzelm@44383
   385
          edit foreach { case (c1, c2) => c1 foreach id_command; c2 foreach id_command }
wenzelm@44383
   386
      }
wenzelm@43722
   387
wenzelm@44479
   388
      val assignment = global_state().the_assignment(previous).check_finished
wenzelm@46687
   389
      global_state >> (_.define_version(version, assignment))
wenzelm@44481
   390
      prover.get.update(previous.id, version.id, doc_edits)
wenzelm@34809
   391
    }
wenzelm@38221
   392
    //}}}
wenzelm@34809
   393
wenzelm@34809
   394
wenzelm@46772
   395
    /* prover output */
wenzelm@34809
   396
wenzelm@46772
   397
    def handle_output(output: Isabelle_Process.Output)
wenzelm@38221
   398
    //{{{
wenzelm@34809
   399
    {
wenzelm@51662
   400
      def bad_output()
wenzelm@43716
   401
      {
wenzelm@43716
   402
        if (verbose)
wenzelm@46772
   403
          System.err.println("Ignoring prover output: " + output.message.toString)
wenzelm@43716
   404
      }
wenzelm@43716
   405
wenzelm@52531
   406
      def accumulate(state_id: Document_ID.Generic, message: XML.Elem)
wenzelm@51662
   407
      {
wenzelm@51662
   408
        try {
wenzelm@51662
   409
          val st = global_state >>> (_.accumulate(state_id, message))
wenzelm@51662
   410
          delay_commands_changed.invoke(false, List(st.command))
wenzelm@51662
   411
        }
wenzelm@51662
   412
        catch {
wenzelm@51662
   413
          case _: Document.State.Fail => bad_output()
wenzelm@51662
   414
        }
wenzelm@51662
   415
      }
wenzelm@51662
   416
wenzelm@52111
   417
      if (output.is_protocol) {
wenzelm@53054
   418
        val handled = _protocol_handlers.invoke(output)
wenzelm@52111
   419
        if (!handled) {
wenzelm@52111
   420
          output.properties match {
wenzelm@52111
   421
            case Markup.Protocol_Handler(name) =>
wenzelm@53054
   422
              _protocol_handlers = _protocol_handlers.add(prover.get, name)
wenzelm@46122
   423
wenzelm@52111
   424
            case Protocol.Command_Timing(state_id, timing) =>
wenzelm@52111
   425
              val message = XML.elem(Markup.STATUS, List(XML.Elem(Markup.Timing(timing), Nil)))
wenzelm@52111
   426
              accumulate(state_id, prover.get.xml_cache.elem(message))
wenzelm@46122
   427
wenzelm@52563
   428
            case Markup.Assign_Update =>
wenzelm@52111
   429
              XML.content(output.body) match {
wenzelm@52563
   430
                case Protocol.Assign_Update(id, update) =>
wenzelm@52111
   431
                  try {
wenzelm@52563
   432
                    val cmds = global_state >>> (_.assign(id, update))
wenzelm@52111
   433
                    delay_commands_changed.invoke(true, cmds)
wenzelm@52111
   434
                  }
wenzelm@52111
   435
                  catch { case _: Document.State.Fail => bad_output() }
wenzelm@52111
   436
                case _ => bad_output()
wenzelm@52111
   437
              }
wenzelm@52111
   438
              // FIXME separate timeout event/message!?
wenzelm@52111
   439
              if (prover.isDefined && System.currentTimeMillis() > prune_next) {
wenzelm@52111
   440
                val old_versions = global_state >>> (_.prune_history(prune_size))
wenzelm@52111
   441
                if (!old_versions.isEmpty) prover.get.remove_versions(old_versions)
wenzelm@52111
   442
                prune_next = System.currentTimeMillis() + prune_delay.ms
wenzelm@47629
   443
              }
wenzelm@52111
   444
wenzelm@52111
   445
            case Markup.Removed_Versions =>
wenzelm@52111
   446
              XML.content(output.body) match {
wenzelm@52111
   447
                case Protocol.Removed(removed) =>
wenzelm@52111
   448
                  try {
wenzelm@52111
   449
                    global_state >> (_.removed_versions(removed))
wenzelm@52111
   450
                  }
wenzelm@52111
   451
                  catch { case _: Document.State.Fail => bad_output() }
wenzelm@52111
   452
                case _ => bad_output()
wenzelm@52111
   453
              }
wenzelm@52111
   454
wenzelm@52111
   455
            case Markup.ML_Statistics(props) =>
wenzelm@52111
   456
              statistics.event(Session.Statistics(props))
wenzelm@52111
   457
wenzelm@52111
   458
            case Markup.Task_Statistics(props) =>
wenzelm@52111
   459
              // FIXME
wenzelm@52111
   460
wenzelm@51662
   461
            case _ => bad_output()
wenzelm@44661
   462
          }
wenzelm@52111
   463
        }
wenzelm@52111
   464
      }
wenzelm@52111
   465
      else {
wenzelm@52111
   466
        output.properties match {
wenzelm@52111
   467
          case Position.Id(state_id) =>
wenzelm@52111
   468
            accumulate(state_id, output.message)
wenzelm@46122
   469
wenzelm@52111
   470
          case _ if output.is_init =>
wenzelm@52111
   471
            phase = Session.Ready
wenzelm@46122
   472
wenzelm@52111
   473
          case Markup.Return_Code(rc) if output.is_exit =>
wenzelm@52111
   474
            if (rc == 0) phase = Session.Inactive
wenzelm@52111
   475
            else phase = Session.Failed
wenzelm@50255
   476
wenzelm@52766
   477
          case _ => raw_output_messages.event(output)
wenzelm@52111
   478
        }
wenzelm@43748
   479
      }
wenzelm@34809
   480
    }
wenzelm@38221
   481
    //}}}
wenzelm@34809
   482
wenzelm@34820
   483
wenzelm@39630
   484
    /* main loop */
wenzelm@34809
   485
wenzelm@43716
   486
    //{{{
wenzelm@38639
   487
    var finished = false
wenzelm@38639
   488
    while (!finished) {
wenzelm@46570
   489
      receiveWithin(delay_commands_changed.flush_timeout) {
wenzelm@46570
   490
        case TIMEOUT => delay_commands_changed.flush()
wenzelm@44722
   491
wenzelm@48870
   492
        case Start(args) if prover.isEmpty =>
wenzelm@39701
   493
          if (phase == Session.Inactive || phase == Session.Failed) {
wenzelm@39701
   494
            phase = Session.Startup
wenzelm@48020
   495
            prover = Some(new Isabelle_Process(receiver.invoke _, args) with Protocol)
wenzelm@39701
   496
          }
wenzelm@38841
   497
wenzelm@39701
   498
        case Stop =>
wenzelm@39701
   499
          if (phase == Session.Ready) {
wenzelm@53054
   500
            _protocol_handlers = _protocol_handlers.stop(prover.get)
wenzelm@46687
   501
            global_state >> (_ => Document.State.init)  // FIXME event bus!?
wenzelm@39701
   502
            phase = Session.Shutdown
wenzelm@43649
   503
            prover.get.terminate
wenzelm@43717
   504
            prover = None
wenzelm@39701
   505
            phase = Session.Inactive
wenzelm@39701
   506
          }
wenzelm@39630
   507
          finished = true
wenzelm@44733
   508
          receiver.cancel()
wenzelm@39630
   509
          reply(())
wenzelm@38850
   510
wenzelm@52084
   511
        case Update_Options(options) if prover.isDefined =>
wenzelm@52649
   512
          if (is_ready) {
wenzelm@52649
   513
            prover.get.options(options)
wenzelm@52649
   514
            handle_raw_edits(Nil)
wenzelm@52649
   515
          }
wenzelm@52084
   516
          global_options.event(Session.Global_Options(options))
wenzelm@52084
   517
          reply(())
wenzelm@50117
   518
wenzelm@52931
   519
        case Cancel_Exec(exec_id) if prover.isDefined =>
wenzelm@52931
   520
          prover.get.cancel_exec(exec_id)
wenzelm@52931
   521
wenzelm@52649
   522
        case Session.Raw_Edits(edits) if prover.isDefined =>
wenzelm@52649
   523
          handle_raw_edits(edits)
wenzelm@43718
   524
          reply(())
wenzelm@43718
   525
wenzelm@50500
   526
        case Session.Dialog_Result(id, serial, result) if prover.isDefined =>
wenzelm@50500
   527
          prover.get.dialog_result(serial, result)
wenzelm@50501
   528
          handle_output(new Isabelle_Process.Output(Protocol.Dialog_Result(id, serial, result)))
wenzelm@50498
   529
wenzelm@53054
   530
        case Protocol_Command(name, args) if prover.isDefined =>
wenzelm@53054
   531
          prover.get.protocol_command(name, args:_*)
wenzelm@53054
   532
wenzelm@44733
   533
        case Messages(msgs) =>
wenzelm@44733
   534
          msgs foreach {
wenzelm@44733
   535
            case input: Isabelle_Process.Input =>
wenzelm@46774
   536
              all_messages.event(input)
wenzelm@43721
   537
wenzelm@46772
   538
            case output: Isabelle_Process.Output =>
wenzelm@48999
   539
              if (output.is_stdout || output.is_stderr) raw_output_messages.event(output)
wenzelm@48999
   540
              else handle_output(output)
wenzelm@46772
   541
              if (output.is_syslog) syslog_messages.event(output)
wenzelm@46774
   542
              all_messages.event(output)
wenzelm@44733
   543
          }
wenzelm@43716
   544
wenzelm@47629
   545
        case change: Change
wenzelm@45635
   546
        if prover.isDefined && global_state().is_assigned(change.previous) =>
wenzelm@45635
   547
          handle_change(change)
wenzelm@45635
   548
wenzelm@47629
   549
        case bad if !bad.isInstanceOf[Change] =>
wenzelm@45635
   550
          System.err.println("session_actor: ignoring bad message " + bad)
wenzelm@34777
   551
      }
wenzelm@34777
   552
    }
wenzelm@43716
   553
    //}}}
wenzelm@34777
   554
  }
wenzelm@34777
   555
wenzelm@34809
   556
wenzelm@43716
   557
  /* actions */
wenzelm@34809
   558
wenzelm@48870
   559
  def start(args: List[String])
wenzelm@50117
   560
  {
wenzelm@50117
   561
    session_actor ! Start(args)
wenzelm@50117
   562
  }
wenzelm@45076
   563
wenzelm@50117
   564
  def stop()
wenzelm@50117
   565
  {
wenzelm@50117
   566
    commands_changed_buffer !? Stop
wenzelm@50117
   567
    change_parser !? Stop
wenzelm@50117
   568
    session_actor !? Stop
wenzelm@50117
   569
  }
wenzelm@38841
   570
wenzelm@53054
   571
  def protocol_command(name: String, args: String*)
wenzelm@53054
   572
  { session_actor ! Protocol_Command(name, args.toList) }
wenzelm@53054
   573
wenzelm@52931
   574
  def cancel_exec(exec_id: Document_ID.Exec) { session_actor ! Cancel_Exec(exec_id) }
wenzelm@52931
   575
wenzelm@50363
   576
  def update(edits: List[Document.Edit_Text])
wenzelm@50745
   577
  { if (!edits.isEmpty) session_actor !? Session.Raw_Edits(edits) }
wenzelm@50498
   578
wenzelm@52084
   579
  def update_options(options: Options)
wenzelm@52084
   580
  { session_actor !? Update_Options(options) }
wenzelm@52084
   581
wenzelm@52531
   582
  def dialog_result(id: Document_ID.Generic, serial: Long, result: String)
wenzelm@50500
   583
  { session_actor ! Session.Dialog_Result(id, serial, result) }
wenzelm@34777
   584
}