src/Pure/System/isabelle_process.scala
author wenzelm
Fri, 27 Mar 2020 12:03:20 +0100
changeset 71594 8a298184f3f9
parent 69572 09a6a7c04b45
child 71597 d025735a4090
permissions -rw-r--r--
clarified signature;
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
43283
446e6621762d updated headers;
wenzelm
parents: 40848
diff changeset
     1
/*  Title:      Pure/System/isabelle_process.scala
27949
6eb0327c0b9b Isabelle process management -- always reactive due to multi-threaded I/O.
wenzelm
parents:
diff changeset
     2
    Author:     Makarius
6eb0327c0b9b Isabelle process management -- always reactive due to multi-threaded I/O.
wenzelm
parents:
diff changeset
     3
57916
2c2c24dbf0a4 generic process wrapping in Prover;
wenzelm
parents: 57915
diff changeset
     4
Isabelle process wrapper.
27949
6eb0327c0b9b Isabelle process management -- always reactive due to multi-threaded I/O.
wenzelm
parents:
diff changeset
     5
*/
6eb0327c0b9b Isabelle process management -- always reactive due to multi-threaded I/O.
wenzelm
parents:
diff changeset
     6
6eb0327c0b9b Isabelle process management -- always reactive due to multi-threaded I/O.
wenzelm
parents:
diff changeset
     7
package isabelle
6eb0327c0b9b Isabelle process management -- always reactive due to multi-threaded I/O.
wenzelm
parents:
diff changeset
     8
55618
995162143ef4 tuned imports;
wenzelm
parents: 54443
diff changeset
     9
65310
da9f1ef8ef7c more process arguments;
wenzelm
parents: 65225
diff changeset
    10
import java.io.{File => JFile}
da9f1ef8ef7c more process arguments;
wenzelm
parents: 65225
diff changeset
    11
da9f1ef8ef7c more process arguments;
wenzelm
parents: 65225
diff changeset
    12
57917
8ce97e5d545f tuned signature;
wenzelm
parents: 57916
diff changeset
    13
object Isabelle_Process
8ce97e5d545f tuned signature;
wenzelm
parents: 57916
diff changeset
    14
{
71594
8a298184f3f9 clarified signature;
wenzelm
parents: 69572
diff changeset
    15
  def start(
8a298184f3f9 clarified signature;
wenzelm
parents: 69572
diff changeset
    16
    session: Session,
65216
060a8a1f2dec tuned signature;
wenzelm
parents: 62754
diff changeset
    17
    options: Options,
71594
8a298184f3f9 clarified signature;
wenzelm
parents: 69572
diff changeset
    18
    sessions_structure: Sessions.Structure,
65216
060a8a1f2dec tuned signature;
wenzelm
parents: 62754
diff changeset
    19
    logic: String = "",
060a8a1f2dec tuned signature;
wenzelm
parents: 62754
diff changeset
    20
    args: List[String] = Nil,
060a8a1f2dec tuned signature;
wenzelm
parents: 62754
diff changeset
    21
    modes: List[String] = Nil,
65310
da9f1ef8ef7c more process arguments;
wenzelm
parents: 65225
diff changeset
    22
    cwd: JFile = null,
da9f1ef8ef7c more process arguments;
wenzelm
parents: 65225
diff changeset
    23
    env: Map[String, String] = Isabelle_System.settings(),
68209
aeffd8f1f079 support Store with options;
wenzelm
parents: 68204
diff changeset
    24
    store: Option[Sessions.Store] = None,
65225
ec9ec04546fc support for permanent phase_changed watcher;
wenzelm
parents: 65218
diff changeset
    25
    phase_changed: Session.Phase => Unit = null)
65216
060a8a1f2dec tuned signature;
wenzelm
parents: 62754
diff changeset
    26
  {
65225
ec9ec04546fc support for permanent phase_changed watcher;
wenzelm
parents: 65218
diff changeset
    27
    if (phase_changed != null)
ec9ec04546fc support for permanent phase_changed watcher;
wenzelm
parents: 65218
diff changeset
    28
      session.phase_changed += Session.Consumer("Isabelle_Process")(phase_changed)
ec9ec04546fc support for permanent phase_changed watcher;
wenzelm
parents: 65218
diff changeset
    29
65216
060a8a1f2dec tuned signature;
wenzelm
parents: 62754
diff changeset
    30
    session.start(receiver =>
71594
8a298184f3f9 clarified signature;
wenzelm
parents: 69572
diff changeset
    31
      Isabelle_Process(options, sessions_structure, logic = logic, args = args, modes = modes,
8a298184f3f9 clarified signature;
wenzelm
parents: 69572
diff changeset
    32
        cwd = cwd, env = env, receiver = receiver, xml_cache = session.xml_cache, store = store))
65216
060a8a1f2dec tuned signature;
wenzelm
parents: 62754
diff changeset
    33
  }
060a8a1f2dec tuned signature;
wenzelm
parents: 62754
diff changeset
    34
57917
8ce97e5d545f tuned signature;
wenzelm
parents: 57916
diff changeset
    35
  def apply(
62556
c115e69f457f more abstract Session.start, without prover command-line;
wenzelm
parents: 62555
diff changeset
    36
    options: Options,
71594
8a298184f3f9 clarified signature;
wenzelm
parents: 69572
diff changeset
    37
    sessions_structure: Sessions.Structure,
62634
aa3b47b32100 less physical "logic" argument, with option -l like "isabelle console" etc.;
wenzelm
parents: 62633
diff changeset
    38
    logic: String = "",
62556
c115e69f457f more abstract Session.start, without prover command-line;
wenzelm
parents: 62555
diff changeset
    39
    args: List[String] = Nil,
c115e69f457f more abstract Session.start, without prover command-line;
wenzelm
parents: 62555
diff changeset
    40
    modes: List[String] = Nil,
65310
da9f1ef8ef7c more process arguments;
wenzelm
parents: 65225
diff changeset
    41
    cwd: JFile = null,
da9f1ef8ef7c more process arguments;
wenzelm
parents: 65225
diff changeset
    42
    env: Map[String, String] = Isabelle_System.settings(),
67178
70576478bda9 avoid println with its extra CR on Windows;
wenzelm
parents: 67052
diff changeset
    43
    receiver: Prover.Receiver = (msg: Prover.Message) => Output.writeln(msg.toString, stdout = true),
68169
395432e7516e tuned signature;
wenzelm
parents: 67178
diff changeset
    44
    xml_cache: XML.Cache = XML.make_cache(),
68209
aeffd8f1f079 support Store with options;
wenzelm
parents: 68204
diff changeset
    45
    store: Option[Sessions.Store] = None): Prover =
57917
8ce97e5d545f tuned signature;
wenzelm
parents: 57916
diff changeset
    46
  {
62556
c115e69f457f more abstract Session.start, without prover command-line;
wenzelm
parents: 62555
diff changeset
    47
    val channel = System_Channel()
c115e69f457f more abstract Session.start, without prover command-line;
wenzelm
parents: 62555
diff changeset
    48
    val process =
57916
2c2c24dbf0a4 generic process wrapping in Prover;
wenzelm
parents: 57915
diff changeset
    49
      try {
69572
09a6a7c04b45 more robust system channel via options that are private to the user;
wenzelm
parents: 68209
diff changeset
    50
        val channel_options =
09a6a7c04b45 more robust system channel via options that are private to the user;
wenzelm
parents: 68209
diff changeset
    51
          options.string.update("system_channel_address", channel.address).
09a6a7c04b45 more robust system channel via options that are private to the user;
wenzelm
parents: 68209
diff changeset
    52
            string.update("system_channel_password", channel.password)
71594
8a298184f3f9 clarified signature;
wenzelm
parents: 69572
diff changeset
    53
        ML_Process(
8a298184f3f9 clarified signature;
wenzelm
parents: 69572
diff changeset
    54
          channel_options, sessions_structure, logic = logic, args = args, modes = modes,
8a298184f3f9 clarified signature;
wenzelm
parents: 69572
diff changeset
    55
          cwd = cwd, env = env, store = store)
57916
2c2c24dbf0a4 generic process wrapping in Prover;
wenzelm
parents: 57915
diff changeset
    56
      }
69572
09a6a7c04b45 more robust system channel via options that are private to the user;
wenzelm
parents: 68209
diff changeset
    57
      catch { case exn @ ERROR(_) => channel.shutdown(); throw exn }
62556
c115e69f457f more abstract Session.start, without prover command-line;
wenzelm
parents: 62555
diff changeset
    58
    process.stdin.close
57917
8ce97e5d545f tuned signature;
wenzelm
parents: 57916
diff changeset
    59
65345
2fdd4431b30e clarified YXML vs. symbol encoding: operate on whole message;
wenzelm
parents: 65316
diff changeset
    60
    new Prover(receiver, xml_cache, channel, process)
57917
8ce97e5d545f tuned signature;
wenzelm
parents: 57916
diff changeset
    61
  }
57916
2c2c24dbf0a4 generic process wrapping in Prover;
wenzelm
parents: 57915
diff changeset
    62
}