src/Pure/ML/ml_console.scala
author wenzelm
Tue, 23 Apr 2024 15:57:03 +0200
changeset 80145 0eff7d113549
parent 78178 a177f71dc79f
permissions -rw-r--r--
update Windows build host;
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
65477
64e61b0f6972 clarified directories;
wenzelm
parents: 65431
diff changeset
     1
/*  Title:      Pure/ML/ml_console.scala
62559
83e815849a91 isabelle console is based on Isabelle/Scala;
wenzelm
parents:
diff changeset
     2
    Author:     Makarius
83e815849a91 isabelle console is based on Isabelle/Scala;
wenzelm
parents:
diff changeset
     3
62588
cd266473b81b isabelle_process is superseded by "isabelle process" tool;
wenzelm
parents: 62586
diff changeset
     4
The raw ML process in interactive mode.
62559
83e815849a91 isabelle console is based on Isabelle/Scala;
wenzelm
parents:
diff changeset
     5
*/
83e815849a91 isabelle console is based on Isabelle/Scala;
wenzelm
parents:
diff changeset
     6
83e815849a91 isabelle console is based on Isabelle/Scala;
wenzelm
parents:
diff changeset
     7
package isabelle
83e815849a91 isabelle console is based on Isabelle/Scala;
wenzelm
parents:
diff changeset
     8
83e815849a91 isabelle console is based on Isabelle/Scala;
wenzelm
parents:
diff changeset
     9
75393
87ebf5a50283 clarified formatting, for the sake of scala3;
wenzelm
parents: 74306
diff changeset
    10
object ML_Console {
62559
83e815849a91 isabelle console is based on Isabelle/Scala;
wenzelm
parents:
diff changeset
    11
  /* command line entry point */
83e815849a91 isabelle console is based on Isabelle/Scala;
wenzelm
parents:
diff changeset
    12
75393
87ebf5a50283 clarified formatting, for the sake of scala3;
wenzelm
parents: 74306
diff changeset
    13
  def main(args: Array[String]): Unit = {
62559
83e815849a91 isabelle console is based on Isabelle/Scala;
wenzelm
parents:
diff changeset
    14
    Command_Line.tool {
83e815849a91 isabelle console is based on Isabelle/Scala;
wenzelm
parents:
diff changeset
    15
      var dirs: List[Path] = Nil
68541
12b4b3bc585d command-line option for include_sessions;
wenzelm
parents: 68331
diff changeset
    16
      var include_sessions: List[String] = Nil
62559
83e815849a91 isabelle console is based on Isabelle/Scala;
wenzelm
parents:
diff changeset
    17
      var logic = Isabelle_System.getenv("ISABELLE_LOGIC")
83e815849a91 isabelle console is based on Isabelle/Scala;
wenzelm
parents:
diff changeset
    18
      var modes: List[String] = Nil
83e815849a91 isabelle console is based on Isabelle/Scala;
wenzelm
parents:
diff changeset
    19
      var no_build = false
83e815849a91 isabelle console is based on Isabelle/Scala;
wenzelm
parents:
diff changeset
    20
      var options = Options.init()
62643
6f7ac44365d7 eliminated without magic name;
wenzelm
parents: 62641
diff changeset
    21
      var raw_ml_system = false
62559
83e815849a91 isabelle console is based on Isabelle/Scala;
wenzelm
parents:
diff changeset
    22
83e815849a91 isabelle console is based on Isabelle/Scala;
wenzelm
parents:
diff changeset
    23
      val getopts = Getopts("""
83e815849a91 isabelle console is based on Isabelle/Scala;
wenzelm
parents:
diff changeset
    24
Usage: isabelle console [OPTIONS]
83e815849a91 isabelle console is based on Isabelle/Scala;
wenzelm
parents:
diff changeset
    25
83e815849a91 isabelle console is based on Isabelle/Scala;
wenzelm
parents:
diff changeset
    26
  Options are:
83e815849a91 isabelle console is based on Isabelle/Scala;
wenzelm
parents:
diff changeset
    27
    -d DIR       include session directory
68541
12b4b3bc585d command-line option for include_sessions;
wenzelm
parents: 68331
diff changeset
    28
    -i NAME      include session in name-space of theories
62559
83e815849a91 isabelle console is based on Isabelle/Scala;
wenzelm
parents:
diff changeset
    29
    -l NAME      logic session name (default ISABELLE_LOGIC=""" + quote(logic) + """)
83e815849a91 isabelle console is based on Isabelle/Scala;
wenzelm
parents:
diff changeset
    30
    -m MODE      add print mode for output
83e815849a91 isabelle console is based on Isabelle/Scala;
wenzelm
parents:
diff changeset
    31
    -n           no build of session image on startup
83e815849a91 isabelle console is based on Isabelle/Scala;
wenzelm
parents:
diff changeset
    32
    -o OPTION    override Isabelle system OPTION (via NAME=VAL or NAME)
62643
6f7ac44365d7 eliminated without magic name;
wenzelm
parents: 62641
diff changeset
    33
    -r           bootstrap from raw Poly/ML
62559
83e815849a91 isabelle console is based on Isabelle/Scala;
wenzelm
parents:
diff changeset
    34
62588
cd266473b81b isabelle_process is superseded by "isabelle process" tool;
wenzelm
parents: 62586
diff changeset
    35
  Build a logic session image and run the raw Isabelle ML process
cd266473b81b isabelle_process is superseded by "isabelle process" tool;
wenzelm
parents: 62586
diff changeset
    36
  in interactive mode, with line editor ISABELLE_LINE_EDITOR=""" +
cd266473b81b isabelle_process is superseded by "isabelle process" tool;
wenzelm
parents: 62586
diff changeset
    37
  quote(Isabelle_System.getenv("ISABELLE_LINE_EDITOR")) + """.
62559
83e815849a91 isabelle console is based on Isabelle/Scala;
wenzelm
parents:
diff changeset
    38
""",
83e815849a91 isabelle console is based on Isabelle/Scala;
wenzelm
parents:
diff changeset
    39
        "d:" -> (arg => dirs = dirs ::: List(Path.explode(arg))),
68541
12b4b3bc585d command-line option for include_sessions;
wenzelm
parents: 68331
diff changeset
    40
        "i:" -> (arg => include_sessions = include_sessions ::: List(arg)),
62559
83e815849a91 isabelle console is based on Isabelle/Scala;
wenzelm
parents:
diff changeset
    41
        "l:" -> (arg => logic = arg),
83e815849a91 isabelle console is based on Isabelle/Scala;
wenzelm
parents:
diff changeset
    42
        "m:" -> (arg => modes = arg :: modes),
72570
wenzelm
parents: 71713
diff changeset
    43
        "n" -> (_ => no_build = true),
62559
83e815849a91 isabelle console is based on Isabelle/Scala;
wenzelm
parents:
diff changeset
    44
        "o:" -> (arg => options = options + arg),
69854
cc0b3e177b49 system option "system_heaps" supersedes various command-line options for "system build mode";
wenzelm
parents: 68541
diff changeset
    45
        "r" -> (_ => raw_ml_system = true))
62559
83e815849a91 isabelle console is based on Isabelle/Scala;
wenzelm
parents:
diff changeset
    46
83e815849a91 isabelle console is based on Isabelle/Scala;
wenzelm
parents:
diff changeset
    47
      val more_args = getopts(args)
71383
8313dca6dee9 misc tuning, following hint by IntelliJ;
wenzelm
parents: 69854
diff changeset
    48
      if (more_args.nonEmpty) getopts.usage()
62559
83e815849a91 isabelle console is based on Isabelle/Scala;
wenzelm
parents:
diff changeset
    49
83e815849a91 isabelle console is based on Isabelle/Scala;
wenzelm
parents:
diff changeset
    50
78178
a177f71dc79f clarified modules;
wenzelm
parents: 77414
diff changeset
    51
      val store = Store(options)
71594
8a298184f3f9 clarified signature;
wenzelm
parents: 71383
diff changeset
    52
68305
5321218147d3 clarified signature;
wenzelm
parents: 68209
diff changeset
    53
      // build logic
5321218147d3 clarified signature;
wenzelm
parents: 68209
diff changeset
    54
      if (!no_build && !raw_ml_system) {
64115
wenzelm
parents: 62754
diff changeset
    55
        val progress = new Console_Progress()
68305
5321218147d3 clarified signature;
wenzelm
parents: 68209
diff changeset
    56
        val rc =
68331
7eaaa8f48331 clarified outermost progress.interrupt_handler;
wenzelm
parents: 68305
diff changeset
    57
          progress.interrupt_handler {
69854
cc0b3e177b49 system option "system_heaps" supersedes various command-line options for "system build mode";
wenzelm
parents: 68541
diff changeset
    58
            Build.build_logic(options, logic, build_heap = true, progress = progress, dirs = dirs)
68331
7eaaa8f48331 clarified outermost progress.interrupt_handler;
wenzelm
parents: 68305
diff changeset
    59
          }
74306
a117c076aa22 clarified signature;
wenzelm
parents: 74141
diff changeset
    60
        if (rc != Process_Result.RC.ok) sys.exit(rc)
62559
83e815849a91 isabelle console is based on Isabelle/Scala;
wenzelm
parents:
diff changeset
    61
      }
83e815849a91 isabelle console is based on Isabelle/Scala;
wenzelm
parents:
diff changeset
    62
76729
b045b40a65cc clarified signature;
wenzelm
parents: 76656
diff changeset
    63
      val session_background =
76655
b3d458a90aeb clarified signature;
wenzelm
parents: 75920
diff changeset
    64
        if (raw_ml_system) {
76656
a8f452f7c503 clarified names;
wenzelm
parents: 76655
diff changeset
    65
          Sessions.Background(
76655
b3d458a90aeb clarified signature;
wenzelm
parents: 75920
diff changeset
    66
            base = Sessions.Base.bootstrap,
b3d458a90aeb clarified signature;
wenzelm
parents: 75920
diff changeset
    67
            sessions_structure = Sessions.load_structure(options, dirs = dirs))
b3d458a90aeb clarified signature;
wenzelm
parents: 75920
diff changeset
    68
        }
b3d458a90aeb clarified signature;
wenzelm
parents: 75920
diff changeset
    69
        else {
76656
a8f452f7c503 clarified names;
wenzelm
parents: 76655
diff changeset
    70
          Sessions.background(
76655
b3d458a90aeb clarified signature;
wenzelm
parents: 75920
diff changeset
    71
            options, logic, dirs = dirs, include_sessions = include_sessions).check_errors
b3d458a90aeb clarified signature;
wenzelm
parents: 75920
diff changeset
    72
        }
b3d458a90aeb clarified signature;
wenzelm
parents: 75920
diff changeset
    73
77414
0d5994eef9e6 clarified signature: allow to provide session_heaps by different means, e.g. from tmp directory or alternative session structure;
wenzelm
parents: 76729
diff changeset
    74
      val session_heaps =
0d5994eef9e6 clarified signature: allow to provide session_heaps by different means, e.g. from tmp directory or alternative session structure;
wenzelm
parents: 76729
diff changeset
    75
        if (raw_ml_system) Nil
0d5994eef9e6 clarified signature: allow to provide session_heaps by different means, e.g. from tmp directory or alternative session structure;
wenzelm
parents: 76729
diff changeset
    76
        else ML_Process.session_heaps(store, session_background, logic = logic)
0d5994eef9e6 clarified signature: allow to provide session_heaps by different means, e.g. from tmp directory or alternative session structure;
wenzelm
parents: 76729
diff changeset
    77
62559
83e815849a91 isabelle console is based on Isabelle/Scala;
wenzelm
parents:
diff changeset
    78
      // process loop
83e815849a91 isabelle console is based on Isabelle/Scala;
wenzelm
parents:
diff changeset
    79
      val process =
77414
0d5994eef9e6 clarified signature: allow to provide session_heaps by different means, e.g. from tmp directory or alternative session structure;
wenzelm
parents: 76729
diff changeset
    80
        ML_Process(options, session_background, session_heaps, args = List("-i"), redirect = true,
0d5994eef9e6 clarified signature: allow to provide session_heaps by different means, e.g. from tmp directory or alternative session structure;
wenzelm
parents: 76729
diff changeset
    81
          modes = if (raw_ml_system) Nil else modes ::: List("ASCII"))
67802
32d76f08023f more general TTY loop;
wenzelm
parents: 66989
diff changeset
    82
73367
77ef8bef0593 clarified signature --- fewer warnings;
wenzelm
parents: 73340
diff changeset
    83
      POSIX_Interrupt.handler { process.interrupt() } {
74141
bba35ad317ab tuned signature;
wenzelm
parents: 73367
diff changeset
    84
        new TTY_Loop(process.stdin, process.stdout).join()
bba35ad317ab tuned signature;
wenzelm
parents: 73367
diff changeset
    85
        val rc = process.join()
74306
a117c076aa22 clarified signature;
wenzelm
parents: 74141
diff changeset
    86
        if (rc != Process_Result.RC.ok) sys.exit(rc)
62559
83e815849a91 isabelle console is based on Isabelle/Scala;
wenzelm
parents:
diff changeset
    87
      }
83e815849a91 isabelle console is based on Isabelle/Scala;
wenzelm
parents:
diff changeset
    88
    }
83e815849a91 isabelle console is based on Isabelle/Scala;
wenzelm
parents:
diff changeset
    89
  }
83e815849a91 isabelle console is based on Isabelle/Scala;
wenzelm
parents:
diff changeset
    90
}