src/Pure/Thy/sessions.scala
author wenzelm
Sun, 08 Sep 2019 16:49:32 +0200
changeset 70676 73812c598a26
parent 70674 29bb1ebb188f
child 70678 36c8c32346cb
permissions -rw-r--r--
check session directories;
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
62631
c39614ddb80b clarified modules;
wenzelm
parents:
diff changeset
     1
/*  Title:      Pure/Thy/sessions.scala
c39614ddb80b clarified modules;
wenzelm
parents:
diff changeset
     2
    Author:     Makarius
c39614ddb80b clarified modules;
wenzelm
parents:
diff changeset
     3
65430
4433d189a77d tuned comment;
wenzelm
parents: 65429
diff changeset
     4
Cumulative session information.
62631
c39614ddb80b clarified modules;
wenzelm
parents:
diff changeset
     5
*/
c39614ddb80b clarified modules;
wenzelm
parents:
diff changeset
     6
c39614ddb80b clarified modules;
wenzelm
parents:
diff changeset
     7
package isabelle
c39614ddb80b clarified modules;
wenzelm
parents:
diff changeset
     8
65461
b6c2e30dc018 support for known theories files (according to multiple uses);
wenzelm
parents: 65457
diff changeset
     9
import java.io.{File => JFile}
62704
478b49f0d726 proper SHA1 digest as annex to heap file: Poly/ML reads precise segment length;
wenzelm
parents: 62637
diff changeset
    10
import java.nio.ByteBuffer
478b49f0d726 proper SHA1 digest as annex to heap file: Poly/ML reads precise segment length;
wenzelm
parents: 62637
diff changeset
    11
import java.nio.channels.FileChannel
478b49f0d726 proper SHA1 digest as annex to heap file: Poly/ML reads precise segment length;
wenzelm
parents: 62637
diff changeset
    12
import java.nio.file.StandardOpenOption
62631
c39614ddb80b clarified modules;
wenzelm
parents:
diff changeset
    13
69762
58fb0d779583 support for session information via virtual file-system;
wenzelm
parents: 69671
diff changeset
    14
import scala.collection.{SortedSet, SortedMap}
62631
c39614ddb80b clarified modules;
wenzelm
parents:
diff changeset
    15
import scala.collection.mutable
c39614ddb80b clarified modules;
wenzelm
parents:
diff changeset
    16
c39614ddb80b clarified modules;
wenzelm
parents:
diff changeset
    17
c39614ddb80b clarified modules;
wenzelm
parents:
diff changeset
    18
object Sessions
c39614ddb80b clarified modules;
wenzelm
parents:
diff changeset
    19
{
67284
0094d938c53b tuned signature;
wenzelm
parents: 67219
diff changeset
    20
  /* session and theory names */
62883
b04e9fe29223 clarified ML bootstrap;
wenzelm
parents: 62864
diff changeset
    21
67215
03d0c958d65a PIDE markup for session ROOT files;
wenzelm
parents: 67210
diff changeset
    22
  val root_name: String = "ROOT"
03d0c958d65a PIDE markup for session ROOT files;
wenzelm
parents: 67210
diff changeset
    23
  val theory_name: String = "Pure.Sessions"
03d0c958d65a PIDE markup for session ROOT files;
wenzelm
parents: 67210
diff changeset
    24
69762
58fb0d779583 support for session information via virtual file-system;
wenzelm
parents: 69671
diff changeset
    25
  val UNSORTED = "Unsorted"
65445
e9e7f5f5794c more qualifier treatment, but in the end it is still ignored;
wenzelm
parents: 65441
diff changeset
    26
  val DRAFT = "Draft"
e9e7f5f5794c more qualifier treatment, but in the end it is still ignored;
wenzelm
parents: 65441
diff changeset
    27
65360
wenzelm
parents: 65359
diff changeset
    28
  def is_pure(name: String): Boolean = name == Thy_Header.PURE
64856
5e9bf964510a clarified modules;
wenzelm
parents: 63996
diff changeset
    29
67284
0094d938c53b tuned signature;
wenzelm
parents: 67219
diff changeset
    30
0094d938c53b tuned signature;
wenzelm
parents: 67219
diff changeset
    31
  def exclude_session(name: String): Boolean = name == "" || name == DRAFT
0094d938c53b tuned signature;
wenzelm
parents: 67219
diff changeset
    32
67286
417e081322ae avoid clash with special files in HTML output;
wenzelm
parents: 67284
diff changeset
    33
  def exclude_theory(name: String): Boolean =
67290
98b6cd12f963 implicit thy_load context for bibtex files;
wenzelm
parents: 67286
diff changeset
    34
    name == root_name || name == "README" || name == "index" || name == "bib"
67284
0094d938c53b tuned signature;
wenzelm
parents: 67219
diff changeset
    35
0094d938c53b tuned signature;
wenzelm
parents: 67219
diff changeset
    36
0094d938c53b tuned signature;
wenzelm
parents: 67219
diff changeset
    37
  /* base info and source dependencies */
0094d938c53b tuned signature;
wenzelm
parents: 67219
diff changeset
    38
65495
60d4fbed2b1f tuned signature;
wenzelm
parents: 65490
diff changeset
    39
  object Known
64856
5e9bf964510a clarified modules;
wenzelm
parents: 63996
diff changeset
    40
  {
65495
60d4fbed2b1f tuned signature;
wenzelm
parents: 65490
diff changeset
    41
    val empty: Known = Known()
65360
wenzelm
parents: 65359
diff changeset
    42
66701
d181f8a0e857 maintain loaded_files for each theory;
wenzelm
parents: 66696
diff changeset
    43
    def make(local_dir: Path, bases: List[Base],
67493
c4e9e0c50487 treat sessions as entities with defining position;
wenzelm
parents: 67471
diff changeset
    44
      sessions: List[(String, Position.T)] = Nil,
68306
d575281e18d0 clarified signature: Known.theories retains Document.Node.Entry (with header);
wenzelm
parents: 68304
diff changeset
    45
      theories: List[Document.Node.Entry] = Nil,
66701
d181f8a0e857 maintain loaded_files for each theory;
wenzelm
parents: 66696
diff changeset
    46
      loaded_files: List[(String, List[Path])] = Nil): Known =
65427
wenzelm
parents: 65426
diff changeset
    47
    {
65463
104502de757c more informative known_files: known_theories within the local session directory come first;
wenzelm
parents: 65461
diff changeset
    48
      def bases_iterator(local: Boolean) =
104502de757c more informative known_files: known_theories within the local session directory come first;
wenzelm
parents: 65461
diff changeset
    49
        for {
104502de757c more informative known_files: known_theories within the local session directory come first;
wenzelm
parents: 65461
diff changeset
    50
          base <- bases.iterator
68306
d575281e18d0 clarified signature: Known.theories retains Document.Node.Entry (with header);
wenzelm
parents: 68304
diff changeset
    51
          (_, entry) <- (if (local) base.known.theories_local else base.known.theories).iterator
d575281e18d0 clarified signature: Known.theories retains Document.Node.Entry (with header);
wenzelm
parents: 68304
diff changeset
    52
        } yield entry
65463
104502de757c more informative known_files: known_theories within the local session directory come first;
wenzelm
parents: 65461
diff changeset
    53
104502de757c more informative known_files: known_theories within the local session directory come first;
wenzelm
parents: 65461
diff changeset
    54
      def local_theories_iterator =
104502de757c more informative known_files: known_theories within the local session directory come first;
wenzelm
parents: 65461
diff changeset
    55
      {
65833
95fd3b9888e6 tuned signature;
wenzelm
parents: 65748
diff changeset
    56
        val local_path = local_dir.canonical_file.toPath
68306
d575281e18d0 clarified signature: Known.theories retains Document.Node.Entry (with header);
wenzelm
parents: 68304
diff changeset
    57
        theories.iterator.filter(entry =>
d575281e18d0 clarified signature: Known.theories retains Document.Node.Entry (with header);
wenzelm
parents: 68304
diff changeset
    58
          entry.name.path.canonical_file.toPath.startsWith(local_path))
65463
104502de757c more informative known_files: known_theories within the local session directory come first;
wenzelm
parents: 65461
diff changeset
    59
      }
65427
wenzelm
parents: 65426
diff changeset
    60
67219
81e9804b2014 added document antiquotation @{session name};
wenzelm
parents: 67216
diff changeset
    61
      val known_sessions =
67493
c4e9e0c50487 treat sessions as entities with defining position;
wenzelm
parents: 67471
diff changeset
    62
        (sessions.toMap /: bases)({ case (known, base) => known ++ base.known.sessions })
67219
81e9804b2014 added document antiquotation @{session name};
wenzelm
parents: 67216
diff changeset
    63
65461
b6c2e30dc018 support for known theories files (according to multiple uses);
wenzelm
parents: 65457
diff changeset
    64
      val known_theories =
68306
d575281e18d0 clarified signature: Known.theories retains Document.Node.Entry (with header);
wenzelm
parents: 68304
diff changeset
    65
        (Map.empty[String, Document.Node.Entry] /: (bases_iterator(false) ++ theories.iterator))({
d575281e18d0 clarified signature: Known.theories retains Document.Node.Entry (with header);
wenzelm
parents: 68304
diff changeset
    66
          case (known, entry) =>
d575281e18d0 clarified signature: Known.theories retains Document.Node.Entry (with header);
wenzelm
parents: 68304
diff changeset
    67
            known.get(entry.name.theory) match {
d575281e18d0 clarified signature: Known.theories retains Document.Node.Entry (with header);
wenzelm
parents: 68304
diff changeset
    68
              case Some(entry1) if entry.name != entry1.name =>
d575281e18d0 clarified signature: Known.theories retains Document.Node.Entry (with header);
wenzelm
parents: 68304
diff changeset
    69
                error("Duplicate theory " + quote(entry.name.node) + " vs. " +
d575281e18d0 clarified signature: Known.theories retains Document.Node.Entry (with header);
wenzelm
parents: 68304
diff changeset
    70
                  quote(entry1.name.node))
d575281e18d0 clarified signature: Known.theories retains Document.Node.Entry (with header);
wenzelm
parents: 68304
diff changeset
    71
              case _ => known + (entry.name.theory -> entry)
65461
b6c2e30dc018 support for known theories files (according to multiple uses);
wenzelm
parents: 65457
diff changeset
    72
            }
b6c2e30dc018 support for known theories files (according to multiple uses);
wenzelm
parents: 65457
diff changeset
    73
          })
65463
104502de757c more informative known_files: known_theories within the local session directory come first;
wenzelm
parents: 65461
diff changeset
    74
      val known_theories_local =
68306
d575281e18d0 clarified signature: Known.theories retains Document.Node.Entry (with header);
wenzelm
parents: 68304
diff changeset
    75
        (Map.empty[String, Document.Node.Entry] /:
65463
104502de757c more informative known_files: known_theories within the local session directory come first;
wenzelm
parents: 65461
diff changeset
    76
            (bases_iterator(true) ++ local_theories_iterator))({
68306
d575281e18d0 clarified signature: Known.theories retains Document.Node.Entry (with header);
wenzelm
parents: 68304
diff changeset
    77
          case (known, entry) => known + (entry.name.theory -> entry)
65463
104502de757c more informative known_files: known_theories within the local session directory come first;
wenzelm
parents: 65461
diff changeset
    78
        })
65461
b6c2e30dc018 support for known theories files (according to multiple uses);
wenzelm
parents: 65457
diff changeset
    79
      val known_files =
65463
104502de757c more informative known_files: known_theories within the local session directory come first;
wenzelm
parents: 65461
diff changeset
    80
        (Map.empty[JFile, List[Document.Node.Name]] /:
104502de757c more informative known_files: known_theories within the local session directory come first;
wenzelm
parents: 65461
diff changeset
    81
            (bases_iterator(true) ++ bases_iterator(false) ++ theories.iterator))({
68306
d575281e18d0 clarified signature: Known.theories retains Document.Node.Entry (with header);
wenzelm
parents: 68304
diff changeset
    82
          case (known, entry) =>
d575281e18d0 clarified signature: Known.theories retains Document.Node.Entry (with header);
wenzelm
parents: 68304
diff changeset
    83
            val name = entry.name
66716
8737b866bd1c tuned signature;
wenzelm
parents: 66715
diff changeset
    84
            val file = name.path.canonical_file
65463
104502de757c more informative known_files: known_theories within the local session directory come first;
wenzelm
parents: 65461
diff changeset
    85
            val theories1 = known.getOrElse(file, Nil)
104502de757c more informative known_files: known_theories within the local session directory come first;
wenzelm
parents: 65461
diff changeset
    86
            if (theories1.exists(name1 => name.node == name1.node && name.theory == name1.theory))
65461
b6c2e30dc018 support for known theories files (according to multiple uses);
wenzelm
parents: 65457
diff changeset
    87
              known
65463
104502de757c more informative known_files: known_theories within the local session directory come first;
wenzelm
parents: 65461
diff changeset
    88
            else known + (file -> (name :: theories1))
65427
wenzelm
parents: 65426
diff changeset
    89
        })
66701
d181f8a0e857 maintain loaded_files for each theory;
wenzelm
parents: 66696
diff changeset
    90
d181f8a0e857 maintain loaded_files for each theory;
wenzelm
parents: 66696
diff changeset
    91
      val known_loaded_files =
d181f8a0e857 maintain loaded_files for each theory;
wenzelm
parents: 66696
diff changeset
    92
        (loaded_files.toMap /: bases.map(base => base.known.loaded_files))(_ ++ _)
d181f8a0e857 maintain loaded_files for each theory;
wenzelm
parents: 66696
diff changeset
    93
67219
81e9804b2014 added document antiquotation @{session name};
wenzelm
parents: 67216
diff changeset
    94
      Known(
81e9804b2014 added document antiquotation @{session name};
wenzelm
parents: 67216
diff changeset
    95
        known_sessions,
68306
d575281e18d0 clarified signature: Known.theories retains Document.Node.Entry (with header);
wenzelm
parents: 68304
diff changeset
    96
        known_theories,
d575281e18d0 clarified signature: Known.theories retains Document.Node.Entry (with header);
wenzelm
parents: 68304
diff changeset
    97
        known_theories_local,
66701
d181f8a0e857 maintain loaded_files for each theory;
wenzelm
parents: 66696
diff changeset
    98
        known_files.iterator.map(p => (p._1, p._2.reverse)).toMap,
d181f8a0e857 maintain loaded_files for each theory;
wenzelm
parents: 66696
diff changeset
    99
        known_loaded_files)
65427
wenzelm
parents: 65426
diff changeset
   100
    }
64856
5e9bf964510a clarified modules;
wenzelm
parents: 63996
diff changeset
   101
  }
5e9bf964510a clarified modules;
wenzelm
parents: 63996
diff changeset
   102
65495
60d4fbed2b1f tuned signature;
wenzelm
parents: 65490
diff changeset
   103
  sealed case class Known(
67493
c4e9e0c50487 treat sessions as entities with defining position;
wenzelm
parents: 67471
diff changeset
   104
    sessions: Map[String, Position.T] = Map.empty,
68306
d575281e18d0 clarified signature: Known.theories retains Document.Node.Entry (with header);
wenzelm
parents: 68304
diff changeset
   105
    theories: Map[String, Document.Node.Entry] = Map.empty,
d575281e18d0 clarified signature: Known.theories retains Document.Node.Entry (with header);
wenzelm
parents: 68304
diff changeset
   106
    theories_local: Map[String, Document.Node.Entry] = Map.empty,
66701
d181f8a0e857 maintain loaded_files for each theory;
wenzelm
parents: 66696
diff changeset
   107
    files: Map[JFile, List[Document.Node.Name]] = Map.empty,
d181f8a0e857 maintain loaded_files for each theory;
wenzelm
parents: 66696
diff changeset
   108
    loaded_files: Map[String, List[Path]] = Map.empty)
65355
403eabd73c9a tuned signature;
wenzelm
parents: 65326
diff changeset
   109
  {
65495
60d4fbed2b1f tuned signature;
wenzelm
parents: 65490
diff changeset
   110
    def platform_path: Known =
65499
fc7f03cbccbc tuned signature;
wenzelm
parents: 65498
diff changeset
   111
      copy(theories = for ((a, b) <- theories) yield (a, b.map(File.platform_path(_))),
fc7f03cbccbc tuned signature;
wenzelm
parents: 65498
diff changeset
   112
        theories_local = for ((a, b) <- theories_local) yield (a, b.map(File.platform_path(_))),
fc7f03cbccbc tuned signature;
wenzelm
parents: 65498
diff changeset
   113
        files = for ((a, b) <- files) yield (a, b.map(c => c.map(File.platform_path(_)))))
65524
0910f1733909 tuned signature;
wenzelm
parents: 65520
diff changeset
   114
66668
6019cfb8256c proper standard_path to revert platform_path in JEdit_Sessions.session_base;
wenzelm
parents: 66604
diff changeset
   115
    def standard_path: Known =
6019cfb8256c proper standard_path to revert platform_path in JEdit_Sessions.session_base;
wenzelm
parents: 66604
diff changeset
   116
      copy(theories = for ((a, b) <- theories) yield (a, b.map(File.standard_path(_))),
6019cfb8256c proper standard_path to revert platform_path in JEdit_Sessions.session_base;
wenzelm
parents: 66604
diff changeset
   117
        theories_local = for ((a, b) <- theories_local) yield (a, b.map(File.standard_path(_))),
6019cfb8256c proper standard_path to revert platform_path in JEdit_Sessions.session_base;
wenzelm
parents: 66604
diff changeset
   118
        files = for ((a, b) <- files) yield (a, b.map(c => c.map(File.standard_path(_)))))
6019cfb8256c proper standard_path to revert platform_path in JEdit_Sessions.session_base;
wenzelm
parents: 66604
diff changeset
   119
68306
d575281e18d0 clarified signature: Known.theories retains Document.Node.Entry (with header);
wenzelm
parents: 68304
diff changeset
   120
    def theory_names: List[Document.Node.Name] = theories.iterator.map(p => p._2.name).toList
d575281e18d0 clarified signature: Known.theories retains Document.Node.Entry (with header);
wenzelm
parents: 68304
diff changeset
   121
70674
29bb1ebb188f clarified signature: proper Document.Node.Ordering conforming to equality (e.g. required in situations where theory names are ambiguous due to overlapping session directories);
wenzelm
parents: 70673
diff changeset
   122
    lazy val theory_graph: Document.Node.Name.Graph[Unit] =
29bb1ebb188f clarified signature: proper Document.Node.Ordering conforming to equality (e.g. required in situations where theory names are ambiguous due to overlapping session directories);
wenzelm
parents: 70673
diff changeset
   123
      Document.Node.Name.make_graph(
68307
812546f20c5c more accurate theory_graph: avoid imports of loaded_theories with incomplete node name;
wenzelm
parents: 68306
diff changeset
   124
        for ((_, entry) <- theories.toList)
70647
3047b7671279 tuned signature;
wenzelm
parents: 70645
diff changeset
   125
        yield ((entry.name, ()), entry.header.imports.map(imp => theories(imp.theory).name)))
68306
d575281e18d0 clarified signature: Known.theories retains Document.Node.Entry (with header);
wenzelm
parents: 68304
diff changeset
   126
66195
bb886f13623a proper bootstrap_name (amending b42743f5b595);
wenzelm
parents: 65999
diff changeset
   127
    def get_file(file: JFile, bootstrap: Boolean = false): Option[Document.Node.Name] =
bb886f13623a proper bootstrap_name (amending b42743f5b595);
wenzelm
parents: 65999
diff changeset
   128
    {
66234
836898197296 clarified platform file operations;
wenzelm
parents: 66195
diff changeset
   129
      val res = files.getOrElse(File.canonical(file), Nil).headOption
66195
bb886f13623a proper bootstrap_name (amending b42743f5b595);
wenzelm
parents: 65999
diff changeset
   130
      if (bootstrap) res.map(_.map_theory(Thy_Header.bootstrap_name(_))) else res
bb886f13623a proper bootstrap_name (amending b42743f5b595);
wenzelm
parents: 65999
diff changeset
   131
    }
65495
60d4fbed2b1f tuned signature;
wenzelm
parents: 65490
diff changeset
   132
  }
60d4fbed2b1f tuned signature;
wenzelm
parents: 65490
diff changeset
   133
60d4fbed2b1f tuned signature;
wenzelm
parents: 65490
diff changeset
   134
  object Base
60d4fbed2b1f tuned signature;
wenzelm
parents: 65490
diff changeset
   135
  {
70673
b0172698d0d3 theory_name based on session_directories: no need for expensive all_known;
wenzelm
parents: 70672
diff changeset
   136
    def bootstrap(
b0172698d0d3 theory_name based on session_directories: no need for expensive all_known;
wenzelm
parents: 70672
diff changeset
   137
        session_directories: Map[JFile, (String, Boolean)],
b0172698d0d3 theory_name based on session_directories: no need for expensive all_known;
wenzelm
parents: 70672
diff changeset
   138
        global_theories: Map[String, String]): Base =
65495
60d4fbed2b1f tuned signature;
wenzelm
parents: 65490
diff changeset
   139
      Base(
70673
b0172698d0d3 theory_name based on session_directories: no need for expensive all_known;
wenzelm
parents: 70672
diff changeset
   140
        session_directories = session_directories,
65495
60d4fbed2b1f tuned signature;
wenzelm
parents: 65490
diff changeset
   141
        global_theories = global_theories,
66720
b07192253605 tuned signature;
wenzelm
parents: 66719
diff changeset
   142
        overall_syntax = Thy_Header.bootstrap_syntax)
65495
60d4fbed2b1f tuned signature;
wenzelm
parents: 65490
diff changeset
   143
  }
60d4fbed2b1f tuned signature;
wenzelm
parents: 65490
diff changeset
   144
60d4fbed2b1f tuned signature;
wenzelm
parents: 65490
diff changeset
   145
  sealed case class Base(
66571
0fdeb24e535e clarified errors;
wenzelm
parents: 66243
diff changeset
   146
    pos: Position.T = Position.none,
67471
bddfa23a4ea9 formal treatment of documentation names;
wenzelm
parents: 67297
diff changeset
   147
    doc_names: List[String] = Nil,
70673
b0172698d0d3 theory_name based on session_directories: no need for expensive all_known;
wenzelm
parents: 70672
diff changeset
   148
    session_directories: Map[JFile, (String, Boolean)] = Map.empty,
65495
60d4fbed2b1f tuned signature;
wenzelm
parents: 65490
diff changeset
   149
    global_theories: Map[String, String] = Map.empty,
66717
67dbf5cdc056 more informative loaded_theories: dependencies and syntax;
wenzelm
parents: 66716
diff changeset
   150
    loaded_theories: Graph[String, Outer_Syntax] = Graph.string,
70636
a56eab490f4e clarified signature: full dependency graph;
wenzelm
parents: 70634
diff changeset
   151
    used_theories: List[((Document.Node.Name, Options), List[Document.Node.Name])] = Nil,
70645
fc27cecb66d8 clarified signature;
wenzelm
parents: 70639
diff changeset
   152
    dump_checkpoints: Set[Document.Node.Name] = Set.empty,
65495
60d4fbed2b1f tuned signature;
wenzelm
parents: 65490
diff changeset
   153
    known: Known = Known.empty,
66720
b07192253605 tuned signature;
wenzelm
parents: 66719
diff changeset
   154
    overall_syntax: Outer_Syntax = Outer_Syntax.empty,
66744
fec1504e5f03 persistent storage of imported_sources;
wenzelm
parents: 66743
diff changeset
   155
    imported_sources: List[(Path, SHA1.Digest)] = Nil,
65495
60d4fbed2b1f tuned signature;
wenzelm
parents: 65490
diff changeset
   156
    sources: List[(Path, SHA1.Digest)] = Nil,
66822
4642cf4a7ebb tuned signature;
wenzelm
parents: 66819
diff changeset
   157
    session_graph_display: Graph_Display.Graph = Graph_Display.empty_graph,
66694
41177b124067 tuned signature -- more readable output as Scala value;
wenzelm
parents: 66668
diff changeset
   158
    errors: List[String] = Nil,
41177b124067 tuned signature -- more readable output as Scala value;
wenzelm
parents: 66668
diff changeset
   159
    imports: Option[Base] = None)
65495
60d4fbed2b1f tuned signature;
wenzelm
parents: 65490
diff changeset
   160
  {
69102
4b06a20b13b5 tuned output -- avoid bombing of Scala toplevel, e.g. for AFP deps;
wenzelm
parents: 69080
diff changeset
   161
    override def toString: String =
4b06a20b13b5 tuned output -- avoid bombing of Scala toplevel, e.g. for AFP deps;
wenzelm
parents: 69080
diff changeset
   162
      "Sessions.Base(loaded_theories = " + loaded_theories.size +
4b06a20b13b5 tuned output -- avoid bombing of Scala toplevel, e.g. for AFP deps;
wenzelm
parents: 69080
diff changeset
   163
        ", used_theories = " + used_theories.length + ")"
4b06a20b13b5 tuned output -- avoid bombing of Scala toplevel, e.g. for AFP deps;
wenzelm
parents: 69080
diff changeset
   164
65495
60d4fbed2b1f tuned signature;
wenzelm
parents: 65490
diff changeset
   165
    def platform_path: Base = copy(known = known.platform_path)
66668
6019cfb8256c proper standard_path to revert platform_path in JEdit_Sessions.session_base;
wenzelm
parents: 66604
diff changeset
   166
    def standard_path: Base = copy(known = known.standard_path)
65463
104502de757c more informative known_files: known_theories within the local session directory come first;
wenzelm
parents: 65461
diff changeset
   167
66967
e365c91c72a9 synthesize session with all required theories from other session imports;
wenzelm
parents: 66966
diff changeset
   168
    def theory_qualifier(name: String): String =
e365c91c72a9 synthesize session with all required theories from other session imports;
wenzelm
parents: 66966
diff changeset
   169
      global_theories.getOrElse(name, Long_Name.qualifier(name))
e365c91c72a9 synthesize session with all required theories from other session imports;
wenzelm
parents: 66966
diff changeset
   170
    def theory_qualifier(name: Document.Node.Name): String = theory_qualifier(name.theory)
66966
f3f9a492bee6 clarified signature;
wenzelm
parents: 66965
diff changeset
   171
66717
67dbf5cdc056 more informative loaded_theories: dependencies and syntax;
wenzelm
parents: 66716
diff changeset
   172
    def loaded_theory(name: String): Boolean = loaded_theories.defined(name)
66712
4c98c929a12a session-qualified theory names are mandatory;
wenzelm
parents: 66701
diff changeset
   173
    def loaded_theory(name: Document.Node.Name): Boolean = loaded_theory(name.theory)
65432
wenzelm
parents: 65430
diff changeset
   174
66717
67dbf5cdc056 more informative loaded_theories: dependencies and syntax;
wenzelm
parents: 66716
diff changeset
   175
    def loaded_theory_syntax(name: String): Option[Outer_Syntax] =
67dbf5cdc056 more informative loaded_theories: dependencies and syntax;
wenzelm
parents: 66716
diff changeset
   176
      if (loaded_theory(name)) Some(loaded_theories.get_node(name)) else None
67dbf5cdc056 more informative loaded_theories: dependencies and syntax;
wenzelm
parents: 66716
diff changeset
   177
    def loaded_theory_syntax(name: Document.Node.Name): Option[Outer_Syntax] =
67dbf5cdc056 more informative loaded_theories: dependencies and syntax;
wenzelm
parents: 66716
diff changeset
   178
      loaded_theory_syntax(name.theory)
67dbf5cdc056 more informative loaded_theories: dependencies and syntax;
wenzelm
parents: 66716
diff changeset
   179
66770
122df1fde073 clarified node_syntax (amending ae38b8c0fdd9): default to overall_syntax, e.g. relevant for command spans wrt. bad header;
wenzelm
parents: 66764
diff changeset
   180
    def node_syntax(nodes: Document.Nodes, name: Document.Node.Name): Outer_Syntax =
122df1fde073 clarified node_syntax (amending ae38b8c0fdd9): default to overall_syntax, e.g. relevant for command spans wrt. bad header;
wenzelm
parents: 66764
diff changeset
   181
      nodes(name).syntax orElse loaded_theory_syntax(name) getOrElse overall_syntax
66721
ae38b8c0fdd9 more accurate node_syntax: avoid overall_syntax for PIDE edits;
wenzelm
parents: 66720
diff changeset
   182
65498
2af863e28204 tuned signature;
wenzelm
parents: 65496
diff changeset
   183
    def known_theory(name: String): Option[Document.Node.Name] =
68306
d575281e18d0 clarified signature: Known.theories retains Document.Node.Entry (with header);
wenzelm
parents: 68304
diff changeset
   184
      known.theories.get(name).map(_.name)
65498
2af863e28204 tuned signature;
wenzelm
parents: 65496
diff changeset
   185
65432
wenzelm
parents: 65430
diff changeset
   186
    def dest_known_theories: List[(String, String)] =
68306
d575281e18d0 clarified signature: Known.theories retains Document.Node.Entry (with header);
wenzelm
parents: 68304
diff changeset
   187
      for ((theory, entry) <- known.theories.toList)
d575281e18d0 clarified signature: Known.theories retains Document.Node.Entry (with header);
wenzelm
parents: 68304
diff changeset
   188
        yield (theory, entry.name.node)
66694
41177b124067 tuned signature -- more readable output as Scala value;
wenzelm
parents: 66668
diff changeset
   189
70673
b0172698d0d3 theory_name based on session_directories: no need for expensive all_known;
wenzelm
parents: 70672
diff changeset
   190
    def get_imports: Base =
b0172698d0d3 theory_name based on session_directories: no need for expensive all_known;
wenzelm
parents: 70672
diff changeset
   191
      imports getOrElse Base.bootstrap(session_directories, global_theories)
65355
403eabd73c9a tuned signature;
wenzelm
parents: 65326
diff changeset
   192
  }
64856
5e9bf964510a clarified modules;
wenzelm
parents: 63996
diff changeset
   193
68204
a554da2811f2 clarified signature;
wenzelm
parents: 68169
diff changeset
   194
  sealed case class Deps(
a554da2811f2 clarified signature;
wenzelm
parents: 68169
diff changeset
   195
    sessions_structure: Structure, session_bases: Map[String, Base], all_known: Known)
65251
4b0a43afc3fb clarified modules;
wenzelm
parents: 64856
diff changeset
   196
  {
69102
4b06a20b13b5 tuned output -- avoid bombing of Scala toplevel, e.g. for AFP deps;
wenzelm
parents: 69080
diff changeset
   197
    override def toString: String = "Sessions.Deps(" + sessions_structure + ")"
4b06a20b13b5 tuned output -- avoid bombing of Scala toplevel, e.g. for AFP deps;
wenzelm
parents: 69080
diff changeset
   198
65463
104502de757c more informative known_files: known_theories within the local session directory come first;
wenzelm
parents: 65461
diff changeset
   199
    def is_empty: Boolean = session_bases.isEmpty
104502de757c more informative known_files: known_theories within the local session directory come first;
wenzelm
parents: 65461
diff changeset
   200
    def apply(name: String): Base = session_bases(name)
66988
7f8c1dd7576a support alternative ancestor session;
wenzelm
parents: 66987
diff changeset
   201
    def get(name: String): Option[Base] = session_bases.get(name)
66744
fec1504e5f03 persistent storage of imported_sources;
wenzelm
parents: 66743
diff changeset
   202
fec1504e5f03 persistent storage of imported_sources;
wenzelm
parents: 66743
diff changeset
   203
    def imported_sources(name: String): List[SHA1.Digest] =
fec1504e5f03 persistent storage of imported_sources;
wenzelm
parents: 66743
diff changeset
   204
      session_bases(name).imported_sources.map(_._2)
fec1504e5f03 persistent storage of imported_sources;
wenzelm
parents: 66743
diff changeset
   205
70645
fc27cecb66d8 clarified signature;
wenzelm
parents: 70639
diff changeset
   206
    def dump_checkpoints: Set[Document.Node.Name] =
70634
0f8742b5a9e8 more scalable isabelle dump (and derivatives): mark individual theories to share common data in ML;
wenzelm
parents: 69904
diff changeset
   207
      (for {
0f8742b5a9e8 more scalable isabelle dump (and derivatives): mark individual theories to share common data in ML;
wenzelm
parents: 69904
diff changeset
   208
        (_, base) <- session_bases.iterator
70645
fc27cecb66d8 clarified signature;
wenzelm
parents: 70639
diff changeset
   209
        name <- base.dump_checkpoints.iterator
fc27cecb66d8 clarified signature;
wenzelm
parents: 70639
diff changeset
   210
      } yield name).toSet
70634
0f8742b5a9e8 more scalable isabelle dump (and derivatives): mark individual theories to share common data in ML;
wenzelm
parents: 69904
diff changeset
   211
70674
29bb1ebb188f clarified signature: proper Document.Node.Ordering conforming to equality (e.g. required in situations where theory names are ambiguous due to overlapping session directories);
wenzelm
parents: 70673
diff changeset
   212
    def used_theories_condition(default_options: Options, progress: Progress = No_Progress)
29bb1ebb188f clarified signature: proper Document.Node.Ordering conforming to equality (e.g. required in situations where theory names are ambiguous due to overlapping session directories);
wenzelm
parents: 70673
diff changeset
   213
      : Document.Node.Name.Graph[Options] =
69025
fa7a1be0fab2 tuned signature;
wenzelm
parents: 69014
diff changeset
   214
    {
69026
6e2f9f62aafd suppress some theories to allow "isabelle dump -o skip_proofs";
wenzelm
parents: 69025
diff changeset
   215
      val default_skip_proofs = default_options.bool("skip_proofs")
70674
29bb1ebb188f clarified signature: proper Document.Node.Ordering conforming to equality (e.g. required in situations where theory names are ambiguous due to overlapping session directories);
wenzelm
parents: 70673
diff changeset
   216
      Document.Node.Name.make_graph(
70647
3047b7671279 tuned signature;
wenzelm
parents: 70645
diff changeset
   217
        permissive = true,
3047b7671279 tuned signature;
wenzelm
parents: 70645
diff changeset
   218
        entries =
3047b7671279 tuned signature;
wenzelm
parents: 70645
diff changeset
   219
          for {
3047b7671279 tuned signature;
wenzelm
parents: 70645
diff changeset
   220
            session_name <- sessions_structure.build_topological_order
3047b7671279 tuned signature;
wenzelm
parents: 70645
diff changeset
   221
            entry @ ((name, options), _) <- session_bases(session_name).used_theories
3047b7671279 tuned signature;
wenzelm
parents: 70645
diff changeset
   222
            if {
3047b7671279 tuned signature;
wenzelm
parents: 70645
diff changeset
   223
              def warn(msg: String): Unit =
3047b7671279 tuned signature;
wenzelm
parents: 70645
diff changeset
   224
                progress.echo_warning("Skipping theory " + name + "  (" + msg + ")")
69026
6e2f9f62aafd suppress some theories to allow "isabelle dump -o skip_proofs";
wenzelm
parents: 69025
diff changeset
   225
70647
3047b7671279 tuned signature;
wenzelm
parents: 70645
diff changeset
   226
              val conditions =
3047b7671279 tuned signature;
wenzelm
parents: 70645
diff changeset
   227
                space_explode(',', options.string("condition")).
3047b7671279 tuned signature;
wenzelm
parents: 70645
diff changeset
   228
                  filter(cond => Isabelle_System.getenv(cond) == "")
3047b7671279 tuned signature;
wenzelm
parents: 70645
diff changeset
   229
              if (conditions.nonEmpty) {
3047b7671279 tuned signature;
wenzelm
parents: 70645
diff changeset
   230
                warn("undefined " + conditions.mkString(", "))
3047b7671279 tuned signature;
wenzelm
parents: 70645
diff changeset
   231
                false
3047b7671279 tuned signature;
wenzelm
parents: 70645
diff changeset
   232
              }
3047b7671279 tuned signature;
wenzelm
parents: 70645
diff changeset
   233
              else if (default_skip_proofs && !options.bool("skip_proofs")) {
3047b7671279 tuned signature;
wenzelm
parents: 70645
diff changeset
   234
                warn("option skip_proofs")
3047b7671279 tuned signature;
wenzelm
parents: 70645
diff changeset
   235
                false
3047b7671279 tuned signature;
wenzelm
parents: 70645
diff changeset
   236
              }
3047b7671279 tuned signature;
wenzelm
parents: 70645
diff changeset
   237
              else true
70636
a56eab490f4e clarified signature: full dependency graph;
wenzelm
parents: 70634
diff changeset
   238
            }
70647
3047b7671279 tuned signature;
wenzelm
parents: 70645
diff changeset
   239
          } yield entry)
69025
fa7a1be0fab2 tuned signature;
wenzelm
parents: 69014
diff changeset
   240
    }
69008
d55783ea6cf6 more detailed session dependencies, with conditions for theories;
wenzelm
parents: 68841
diff changeset
   241
66744
fec1504e5f03 persistent storage of imported_sources;
wenzelm
parents: 66743
diff changeset
   242
    def sources(name: String): List[SHA1.Digest] =
fec1504e5f03 persistent storage of imported_sources;
wenzelm
parents: 66743
diff changeset
   243
      session_bases(name).sources.map(_._2)
66571
0fdeb24e535e clarified errors;
wenzelm
parents: 66243
diff changeset
   244
0fdeb24e535e clarified errors;
wenzelm
parents: 66243
diff changeset
   245
    def errors: List[String] =
0fdeb24e535e clarified errors;
wenzelm
parents: 66243
diff changeset
   246
      (for {
0fdeb24e535e clarified errors;
wenzelm
parents: 66243
diff changeset
   247
        (name, base) <- session_bases.iterator
0fdeb24e535e clarified errors;
wenzelm
parents: 66243
diff changeset
   248
        if base.errors.nonEmpty
0fdeb24e535e clarified errors;
wenzelm
parents: 66243
diff changeset
   249
      } yield cat_lines(base.errors) +
0fdeb24e535e clarified errors;
wenzelm
parents: 66243
diff changeset
   250
          "\nThe error(s) above occurred in session " + quote(name) + Position.here(base.pos)
0fdeb24e535e clarified errors;
wenzelm
parents: 66243
diff changeset
   251
      ).toList
0fdeb24e535e clarified errors;
wenzelm
parents: 66243
diff changeset
   252
0fdeb24e535e clarified errors;
wenzelm
parents: 66243
diff changeset
   253
    def check_errors: Deps =
0fdeb24e535e clarified errors;
wenzelm
parents: 66243
diff changeset
   254
      errors match {
0fdeb24e535e clarified errors;
wenzelm
parents: 66243
diff changeset
   255
        case Nil => this
0fdeb24e535e clarified errors;
wenzelm
parents: 66243
diff changeset
   256
        case errs => error(cat_lines(errs))
0fdeb24e535e clarified errors;
wenzelm
parents: 66243
diff changeset
   257
      }
65251
4b0a43afc3fb clarified modules;
wenzelm
parents: 64856
diff changeset
   258
  }
64856
5e9bf964510a clarified modules;
wenzelm
parents: 63996
diff changeset
   259
67052
caf87d4b9b61 tuned signature;
wenzelm
parents: 67029
diff changeset
   260
  def deps(sessions_structure: Structure,
65251
4b0a43afc3fb clarified modules;
wenzelm
parents: 64856
diff changeset
   261
      progress: Progress = No_Progress,
4b0a43afc3fb clarified modules;
wenzelm
parents: 64856
diff changeset
   262
      inlined_files: Boolean = false,
4b0a43afc3fb clarified modules;
wenzelm
parents: 64856
diff changeset
   263
      verbose: Boolean = false,
4b0a43afc3fb clarified modules;
wenzelm
parents: 64856
diff changeset
   264
      list_files: Boolean = false,
66962
e1bde71bace6 clarified signature: global_theories is always required;
wenzelm
parents: 66960
diff changeset
   265
      check_keywords: Set[String] = Set.empty): Deps =
65372
b722ee40c26c refer to global_theories from all sessions, before selection;
wenzelm
parents: 65371
diff changeset
   266
  {
66743
ff05d922bc34 cache sources: invoke SHA1.digest at most once;
wenzelm
parents: 66742
diff changeset
   267
    var cache_sources = Map.empty[JFile, SHA1.Digest]
ff05d922bc34 cache sources: invoke SHA1.digest at most once;
wenzelm
parents: 66742
diff changeset
   268
    def check_sources(paths: List[Path]): List[(Path, SHA1.Digest)] =
ff05d922bc34 cache sources: invoke SHA1.digest at most once;
wenzelm
parents: 66742
diff changeset
   269
    {
ff05d922bc34 cache sources: invoke SHA1.digest at most once;
wenzelm
parents: 66742
diff changeset
   270
      for {
ff05d922bc34 cache sources: invoke SHA1.digest at most once;
wenzelm
parents: 66742
diff changeset
   271
        path <- paths
ff05d922bc34 cache sources: invoke SHA1.digest at most once;
wenzelm
parents: 66742
diff changeset
   272
        file = path.file
ff05d922bc34 cache sources: invoke SHA1.digest at most once;
wenzelm
parents: 66742
diff changeset
   273
        if cache_sources.isDefinedAt(file) || file.isFile
ff05d922bc34 cache sources: invoke SHA1.digest at most once;
wenzelm
parents: 66742
diff changeset
   274
      }
ff05d922bc34 cache sources: invoke SHA1.digest at most once;
wenzelm
parents: 66742
diff changeset
   275
      yield {
ff05d922bc34 cache sources: invoke SHA1.digest at most once;
wenzelm
parents: 66742
diff changeset
   276
        cache_sources.get(file) match {
ff05d922bc34 cache sources: invoke SHA1.digest at most once;
wenzelm
parents: 66742
diff changeset
   277
          case Some(digest) => (path, digest)
ff05d922bc34 cache sources: invoke SHA1.digest at most once;
wenzelm
parents: 66742
diff changeset
   278
          case None =>
ff05d922bc34 cache sources: invoke SHA1.digest at most once;
wenzelm
parents: 66742
diff changeset
   279
            val digest = SHA1.digest(file)
ff05d922bc34 cache sources: invoke SHA1.digest at most once;
wenzelm
parents: 66742
diff changeset
   280
            cache_sources = cache_sources + (file -> digest)
ff05d922bc34 cache sources: invoke SHA1.digest at most once;
wenzelm
parents: 66742
diff changeset
   281
            (path, digest)
ff05d922bc34 cache sources: invoke SHA1.digest at most once;
wenzelm
parents: 66742
diff changeset
   282
        }
ff05d922bc34 cache sources: invoke SHA1.digest at most once;
wenzelm
parents: 66742
diff changeset
   283
      }
ff05d922bc34 cache sources: invoke SHA1.digest at most once;
wenzelm
parents: 66742
diff changeset
   284
    }
ff05d922bc34 cache sources: invoke SHA1.digest at most once;
wenzelm
parents: 66742
diff changeset
   285
67471
bddfa23a4ea9 formal treatment of documentation names;
wenzelm
parents: 67297
diff changeset
   286
    val doc_names = Doc.doc_names()
bddfa23a4ea9 formal treatment of documentation names;
wenzelm
parents: 67297
diff changeset
   287
65463
104502de757c more informative known_files: known_theories within the local session directory come first;
wenzelm
parents: 65461
diff changeset
   288
    val session_bases =
67024
wenzelm
parents: 67023
diff changeset
   289
      (Map.empty[String, Base] /: sessions_structure.imports_topological_order)({
67023
e27e05d6f2a7 tuned signature;
wenzelm
parents: 67018
diff changeset
   290
        case (session_bases, session_name) =>
67880
e59220a075de tuned signature;
wenzelm
parents: 67869
diff changeset
   291
          progress.expose_interrupt()
65251
4b0a43afc3fb clarified modules;
wenzelm
parents: 64856
diff changeset
   292
67024
wenzelm
parents: 67023
diff changeset
   293
          val info = sessions_structure(session_name)
65463
104502de757c more informative known_files: known_theories within the local session directory come first;
wenzelm
parents: 65461
diff changeset
   294
          try {
65496
ca8dcb2a500c proper imports_base, notably for thy_deps;
wenzelm
parents: 65495
diff changeset
   295
            val parent_base: Sessions.Base =
65463
104502de757c more informative known_files: known_theories within the local session directory come first;
wenzelm
parents: 65461
diff changeset
   296
              info.parent match {
70673
b0172698d0d3 theory_name based on session_directories: no need for expensive all_known;
wenzelm
parents: 70672
diff changeset
   297
                case None =>
b0172698d0d3 theory_name based on session_directories: no need for expensive all_known;
wenzelm
parents: 70672
diff changeset
   298
                  Base.bootstrap(
b0172698d0d3 theory_name based on session_directories: no need for expensive all_known;
wenzelm
parents: 70672
diff changeset
   299
                    sessions_structure.session_directories,
b0172698d0d3 theory_name based on session_directories: no need for expensive all_known;
wenzelm
parents: 70672
diff changeset
   300
                    sessions_structure.global_theories)
65463
104502de757c more informative known_files: known_theories within the local session directory come first;
wenzelm
parents: 65461
diff changeset
   301
                case Some(parent) => session_bases(parent)
104502de757c more informative known_files: known_theories within the local session directory come first;
wenzelm
parents: 65461
diff changeset
   302
              }
65496
ca8dcb2a500c proper imports_base, notably for thy_deps;
wenzelm
parents: 65495
diff changeset
   303
            val imports_base: Sessions.Base =
ca8dcb2a500c proper imports_base, notably for thy_deps;
wenzelm
parents: 65495
diff changeset
   304
              parent_base.copy(known =
66701
d181f8a0e857 maintain loaded_files for each theory;
wenzelm
parents: 66696
diff changeset
   305
                Known.make(info.dir, parent_base :: info.imports.map(session_bases(_))))
65496
ca8dcb2a500c proper imports_base, notably for thy_deps;
wenzelm
parents: 65495
diff changeset
   306
65532
febfd9f78bd4 eliminated default_qualifier: just a constant;
wenzelm
parents: 65528
diff changeset
   307
            val resources = new Resources(imports_base)
65251
4b0a43afc3fb clarified modules;
wenzelm
parents: 64856
diff changeset
   308
65463
104502de757c more informative known_files: known_theories within the local session directory come first;
wenzelm
parents: 65461
diff changeset
   309
            if (verbose || list_files) {
104502de757c more informative known_files: known_theories within the local session directory come first;
wenzelm
parents: 65461
diff changeset
   310
              val groups =
104502de757c more informative known_files: known_theories within the local session directory come first;
wenzelm
parents: 65461
diff changeset
   311
                if (info.groups.isEmpty) ""
104502de757c more informative known_files: known_theories within the local session directory come first;
wenzelm
parents: 65461
diff changeset
   312
                else info.groups.mkString(" (", " ", ")")
65519
d244d8f8e13f store Sessions.Info.name;
wenzelm
parents: 65517
diff changeset
   313
              progress.echo("Session " + info.chapter + "/" + info.name + groups)
65463
104502de757c more informative known_files: known_theories within the local session directory come first;
wenzelm
parents: 65461
diff changeset
   314
            }
65251
4b0a43afc3fb clarified modules;
wenzelm
parents: 64856
diff changeset
   315
69008
d55783ea6cf6 more detailed session dependencies, with conditions for theories;
wenzelm
parents: 68841
diff changeset
   316
            val dependencies = resources.session_dependencies(info)
65251
4b0a43afc3fb clarified modules;
wenzelm
parents: 64856
diff changeset
   317
70645
fc27cecb66d8 clarified signature;
wenzelm
parents: 70639
diff changeset
   318
            val dump_checkpoints = resources.dump_checkpoints(info)
70634
0f8742b5a9e8 more scalable isabelle dump (and derivatives): mark individual theories to share common data in ML;
wenzelm
parents: 69904
diff changeset
   319
67053
wenzelm
parents: 67052
diff changeset
   320
            val overall_syntax = dependencies.overall_syntax
65251
4b0a43afc3fb clarified modules;
wenzelm
parents: 64856
diff changeset
   321
67059
df7d728103f1 tuned signature;
wenzelm
parents: 67053
diff changeset
   322
            val theory_files = dependencies.theories.map(_.path)
65463
104502de757c more informative known_files: known_theories within the local session directory come first;
wenzelm
parents: 65461
diff changeset
   323
            val loaded_files =
69560
195371990820 clarified signature;
wenzelm
parents: 69524
diff changeset
   324
              if (inlined_files) dependencies.loaded_files(Sessions.is_pure(info.name))
65463
104502de757c more informative known_files: known_theories within the local session directory come first;
wenzelm
parents: 65461
diff changeset
   325
              else Nil
65251
4b0a43afc3fb clarified modules;
wenzelm
parents: 64856
diff changeset
   326
66742
wenzelm
parents: 66737
diff changeset
   327
            val session_files =
66701
d181f8a0e857 maintain loaded_files for each theory;
wenzelm
parents: 66696
diff changeset
   328
              (theory_files ::: loaded_files.flatMap(_._2) :::
65463
104502de757c more informative known_files: known_theories within the local session directory come first;
wenzelm
parents: 65461
diff changeset
   329
                info.document_files.map(file => info.dir + file._1 + file._2)).map(_.expand)
104502de757c more informative known_files: known_theories within the local session directory come first;
wenzelm
parents: 65461
diff changeset
   330
67053
wenzelm
parents: 67052
diff changeset
   331
            val imported_files = if (inlined_files) dependencies.imported_files else Nil
66743
ff05d922bc34 cache sources: invoke SHA1.digest at most once;
wenzelm
parents: 66742
diff changeset
   332
65463
104502de757c more informative known_files: known_theories within the local session directory come first;
wenzelm
parents: 65461
diff changeset
   333
            if (list_files)
66742
wenzelm
parents: 66737
diff changeset
   334
              progress.echo(cat_lines(session_files.map(_.implode).sorted.map("  " + _)))
65463
104502de757c more informative known_files: known_theories within the local session directory come first;
wenzelm
parents: 65461
diff changeset
   335
66719
d37efafd55b5 clarified theory syntax vs. overall session syntax;
wenzelm
parents: 66718
diff changeset
   336
            if (check_keywords.nonEmpty) {
d37efafd55b5 clarified theory syntax vs. overall session syntax;
wenzelm
parents: 66718
diff changeset
   337
              Check_Keywords.check_keywords(
66720
b07192253605 tuned signature;
wenzelm
parents: 66719
diff changeset
   338
                progress, overall_syntax.keywords, check_keywords, theory_files)
66719
d37efafd55b5 clarified theory syntax vs. overall session syntax;
wenzelm
parents: 66718
diff changeset
   339
            }
65251
4b0a43afc3fb clarified modules;
wenzelm
parents: 64856
diff changeset
   340
66822
4642cf4a7ebb tuned signature;
wenzelm
parents: 66819
diff changeset
   341
            val session_graph_display: Graph_Display.Graph =
65507
decdb95bd007 clarified session graph: collapse theories from other sessions;
wenzelm
parents: 65500
diff changeset
   342
            {
decdb95bd007 clarified session graph: collapse theories from other sessions;
wenzelm
parents: 65500
diff changeset
   343
              def session_node(name: String): Graph_Display.Node =
decdb95bd007 clarified session graph: collapse theories from other sessions;
wenzelm
parents: 65500
diff changeset
   344
                Graph_Display.Node("[" + name + "]", "session." + name)
decdb95bd007 clarified session graph: collapse theories from other sessions;
wenzelm
parents: 65500
diff changeset
   345
decdb95bd007 clarified session graph: collapse theories from other sessions;
wenzelm
parents: 65500
diff changeset
   346
              def node(name: Document.Node.Name): Graph_Display.Node =
decdb95bd007 clarified session graph: collapse theories from other sessions;
wenzelm
parents: 65500
diff changeset
   347
              {
66966
f3f9a492bee6 clarified signature;
wenzelm
parents: 66965
diff changeset
   348
                val qualifier = imports_base.theory_qualifier(name)
66780
bf54ca580bf2 theory qualifier is always session name (see also 31e8a86971a8);
wenzelm
parents: 66770
diff changeset
   349
                if (qualifier == info.name)
65507
decdb95bd007 clarified session graph: collapse theories from other sessions;
wenzelm
parents: 65500
diff changeset
   350
                  Graph_Display.Node(name.theory_base_name, "theory." + name.theory)
65528
d15d302da7f0 proper theory_qualifier;
wenzelm
parents: 65525
diff changeset
   351
                else session_node(qualifier)
65507
decdb95bd007 clarified session graph: collapse theories from other sessions;
wenzelm
parents: 65500
diff changeset
   352
              }
decdb95bd007 clarified session graph: collapse theories from other sessions;
wenzelm
parents: 65500
diff changeset
   353
decdb95bd007 clarified session graph: collapse theories from other sessions;
wenzelm
parents: 65500
diff changeset
   354
              val imports_subgraph =
67024
wenzelm
parents: 67023
diff changeset
   355
                sessions_structure.imports_graph.
wenzelm
parents: 67023
diff changeset
   356
                  restrict(sessions_structure.imports_graph.all_preds(info.deps).toSet)
65507
decdb95bd007 clarified session graph: collapse theories from other sessions;
wenzelm
parents: 65500
diff changeset
   357
decdb95bd007 clarified session graph: collapse theories from other sessions;
wenzelm
parents: 65500
diff changeset
   358
              val graph0 =
decdb95bd007 clarified session graph: collapse theories from other sessions;
wenzelm
parents: 65500
diff changeset
   359
                (Graph_Display.empty_graph /: imports_subgraph.topological_order)(
decdb95bd007 clarified session graph: collapse theories from other sessions;
wenzelm
parents: 65500
diff changeset
   360
                  { case (g, session) =>
decdb95bd007 clarified session graph: collapse theories from other sessions;
wenzelm
parents: 65500
diff changeset
   361
                      val a = session_node(session)
decdb95bd007 clarified session graph: collapse theories from other sessions;
wenzelm
parents: 65500
diff changeset
   362
                      val bs = imports_subgraph.imm_preds(session).toList.map(session_node(_))
decdb95bd007 clarified session graph: collapse theories from other sessions;
wenzelm
parents: 65500
diff changeset
   363
                      ((g /: (a :: bs))(_.default_node(_, Nil)) /: bs)(_.add_edge(_, a)) })
decdb95bd007 clarified session graph: collapse theories from other sessions;
wenzelm
parents: 65500
diff changeset
   364
67053
wenzelm
parents: 67052
diff changeset
   365
              (graph0 /: dependencies.entries)(
66714
9fc4e144693c tuned signature;
wenzelm
parents: 66712
diff changeset
   366
                { case (g, entry) =>
9fc4e144693c tuned signature;
wenzelm
parents: 66712
diff changeset
   367
                    val a = node(entry.name)
70638
f164cec7ac22 clarified signature: prefer operations without position;
wenzelm
parents: 70637
diff changeset
   368
                    val bs = entry.header.imports.map(node).filterNot(_ == a)
65507
decdb95bd007 clarified session graph: collapse theories from other sessions;
wenzelm
parents: 65500
diff changeset
   369
                    ((g /: (a :: bs))(_.default_node(_, Nil)) /: bs)(_.add_edge(_, a)) })
decdb95bd007 clarified session graph: collapse theories from other sessions;
wenzelm
parents: 65500
diff changeset
   370
            }
decdb95bd007 clarified session graph: collapse theories from other sessions;
wenzelm
parents: 65500
diff changeset
   371
66701
d181f8a0e857 maintain loaded_files for each theory;
wenzelm
parents: 66696
diff changeset
   372
            val known =
d181f8a0e857 maintain loaded_files for each theory;
wenzelm
parents: 66696
diff changeset
   373
              Known.make(info.dir, List(imports_base),
67493
c4e9e0c50487 treat sessions as entities with defining position;
wenzelm
parents: 67471
diff changeset
   374
                sessions = List(info.name -> info.pos),
68306
d575281e18d0 clarified signature: Known.theories retains Document.Node.Entry (with header);
wenzelm
parents: 68304
diff changeset
   375
                theories = dependencies.entries,
66701
d181f8a0e857 maintain loaded_files for each theory;
wenzelm
parents: 66696
diff changeset
   376
                loaded_files = loaded_files)
d181f8a0e857 maintain loaded_files for each theory;
wenzelm
parents: 66696
diff changeset
   377
70636
a56eab490f4e clarified signature: full dependency graph;
wenzelm
parents: 70634
diff changeset
   378
            val used_theories =
a56eab490f4e clarified signature: full dependency graph;
wenzelm
parents: 70634
diff changeset
   379
              for ((options, name) <- dependencies.adjunct_theories)
70638
f164cec7ac22 clarified signature: prefer operations without position;
wenzelm
parents: 70637
diff changeset
   380
              yield ((name, options), known.theories(name.theory).header.imports)
70636
a56eab490f4e clarified signature: full dependency graph;
wenzelm
parents: 70634
diff changeset
   381
70676
73812c598a26 check session directories;
wenzelm
parents: 70674
diff changeset
   382
            val dir_errors =
73812c598a26 check session directories;
wenzelm
parents: 70674
diff changeset
   383
            {
73812c598a26 check session directories;
wenzelm
parents: 70674
diff changeset
   384
              val ok = (for { (dir, _) <- info.dirs } yield dir.canonical_file).toSet
73812c598a26 check session directories;
wenzelm
parents: 70674
diff changeset
   385
              (for {
73812c598a26 check session directories;
wenzelm
parents: 70674
diff changeset
   386
                  ((name, _), _) <- used_theories.iterator
73812c598a26 check session directories;
wenzelm
parents: 70674
diff changeset
   387
                  if imports_base.theory_qualifier(name) == session_name
73812c598a26 check session directories;
wenzelm
parents: 70674
diff changeset
   388
                  val path = name.master_dir_path
73812c598a26 check session directories;
wenzelm
parents: 70674
diff changeset
   389
                  if !ok(path.canonical_file)
73812c598a26 check session directories;
wenzelm
parents: 70674
diff changeset
   390
                } yield {
73812c598a26 check session directories;
wenzelm
parents: 70674
diff changeset
   391
                  val path1 = File.relative_path(info.dir.canonical, path).getOrElse(path)
73812c598a26 check session directories;
wenzelm
parents: 70674
diff changeset
   392
                  "Implicit use of directory " + path1 + " for theory " + quote(name.toString)
73812c598a26 check session directories;
wenzelm
parents: 70674
diff changeset
   393
                }
73812c598a26 check session directories;
wenzelm
parents: 70674
diff changeset
   394
              ).toList
73812c598a26 check session directories;
wenzelm
parents: 70674
diff changeset
   395
            }
73812c598a26 check session directories;
wenzelm
parents: 70674
diff changeset
   396
66743
ff05d922bc34 cache sources: invoke SHA1.digest at most once;
wenzelm
parents: 66742
diff changeset
   397
            val sources_errors =
ff05d922bc34 cache sources: invoke SHA1.digest at most once;
wenzelm
parents: 66742
diff changeset
   398
              for (p <- session_files if !p.is_file) yield "No such file: " + p
66604
1af360d1cad2 tolerate more errors (cf. 1e5ae735e026);
wenzelm
parents: 66575
diff changeset
   399
69904
6f5bd59f75f4 more sanity checks;
wenzelm
parents: 69857
diff changeset
   400
            val path_errors =
6f5bd59f75f4 more sanity checks;
wenzelm
parents: 69857
diff changeset
   401
              try { Path.check_case_insensitive(session_files ::: imported_files); Nil }
6f5bd59f75f4 more sanity checks;
wenzelm
parents: 69857
diff changeset
   402
              catch { case ERROR(msg) => List(msg) }
6f5bd59f75f4 more sanity checks;
wenzelm
parents: 69857
diff changeset
   403
67297
86a099f896fc formal check of @{cite} bibtex entries -- only in batch-mode session builds;
wenzelm
parents: 67290
diff changeset
   404
            val bibtex_errors =
86a099f896fc formal check of @{cite} bibtex entries -- only in batch-mode session builds;
wenzelm
parents: 67290
diff changeset
   405
              try { info.bibtex_entries; Nil }
86a099f896fc formal check of @{cite} bibtex entries -- only in batch-mode session builds;
wenzelm
parents: 67290
diff changeset
   406
              catch { case ERROR(msg) => List(msg) }
86a099f896fc formal check of @{cite} bibtex entries -- only in batch-mode session builds;
wenzelm
parents: 67290
diff changeset
   407
65463
104502de757c more informative known_files: known_theories within the local session directory come first;
wenzelm
parents: 65461
diff changeset
   408
            val base =
66571
0fdeb24e535e clarified errors;
wenzelm
parents: 66243
diff changeset
   409
              Base(
0fdeb24e535e clarified errors;
wenzelm
parents: 66243
diff changeset
   410
                pos = info.pos,
67471
bddfa23a4ea9 formal treatment of documentation names;
wenzelm
parents: 67297
diff changeset
   411
                doc_names = doc_names,
70673
b0172698d0d3 theory_name based on session_directories: no need for expensive all_known;
wenzelm
parents: 70672
diff changeset
   412
                session_directories = sessions_structure.session_directories,
70671
cb1776c8e216 clarified signature: retain global session information, unaffected by later restriction;
wenzelm
parents: 70668
diff changeset
   413
                global_theories = sessions_structure.global_theories,
67053
wenzelm
parents: 67052
diff changeset
   414
                loaded_theories = dependencies.loaded_theories,
70636
a56eab490f4e clarified signature: full dependency graph;
wenzelm
parents: 70634
diff changeset
   415
                used_theories = used_theories,
70645
fc27cecb66d8 clarified signature;
wenzelm
parents: 70639
diff changeset
   416
                dump_checkpoints = dump_checkpoints,
66701
d181f8a0e857 maintain loaded_files for each theory;
wenzelm
parents: 66696
diff changeset
   417
                known = known,
66720
b07192253605 tuned signature;
wenzelm
parents: 66719
diff changeset
   418
                overall_syntax = overall_syntax,
66744
fec1504e5f03 persistent storage of imported_sources;
wenzelm
parents: 66743
diff changeset
   419
                imported_sources = check_sources(imported_files),
66743
ff05d922bc34 cache sources: invoke SHA1.digest at most once;
wenzelm
parents: 66742
diff changeset
   420
                sources = check_sources(session_files),
66822
4642cf4a7ebb tuned signature;
wenzelm
parents: 66819
diff changeset
   421
                session_graph_display = session_graph_display,
70676
73812c598a26 check session directories;
wenzelm
parents: 70674
diff changeset
   422
                errors = dependencies.errors ::: dir_errors ::: sources_errors :::
73812c598a26 check session directories;
wenzelm
parents: 70674
diff changeset
   423
                  path_errors ::: bibtex_errors,
66694
41177b124067 tuned signature -- more readable output as Scala value;
wenzelm
parents: 66668
diff changeset
   424
                imports = Some(imports_base))
65251
4b0a43afc3fb clarified modules;
wenzelm
parents: 64856
diff changeset
   425
65519
d244d8f8e13f store Sessions.Info.name;
wenzelm
parents: 65517
diff changeset
   426
            session_bases + (info.name -> base)
65463
104502de757c more informative known_files: known_theories within the local session directory come first;
wenzelm
parents: 65461
diff changeset
   427
          }
104502de757c more informative known_files: known_theories within the local session directory come first;
wenzelm
parents: 65461
diff changeset
   428
          catch {
104502de757c more informative known_files: known_theories within the local session directory come first;
wenzelm
parents: 65461
diff changeset
   429
            case ERROR(msg) =>
104502de757c more informative known_files: known_theories within the local session directory come first;
wenzelm
parents: 65461
diff changeset
   430
              cat_error(msg, "The error(s) above occurred in session " +
65519
d244d8f8e13f store Sessions.Info.name;
wenzelm
parents: 65517
diff changeset
   431
                quote(info.name) + Position.here(info.pos))
65463
104502de757c more informative known_files: known_theories within the local session directory come first;
wenzelm
parents: 65461
diff changeset
   432
          }
104502de757c more informative known_files: known_theories within the local session directory come first;
wenzelm
parents: 65461
diff changeset
   433
      })
65251
4b0a43afc3fb clarified modules;
wenzelm
parents: 64856
diff changeset
   434
68307
812546f20c5c more accurate theory_graph: avoid imports of loaded_theories with incomplete node name;
wenzelm
parents: 68306
diff changeset
   435
    val all_known =
812546f20c5c more accurate theory_graph: avoid imports of loaded_theories with incomplete node name;
wenzelm
parents: 68306
diff changeset
   436
      Known.make(Path.current, sessions_structure.imports_topological_order.map(session_bases(_)))
812546f20c5c more accurate theory_graph: avoid imports of loaded_theories with incomplete node name;
wenzelm
parents: 68306
diff changeset
   437
812546f20c5c more accurate theory_graph: avoid imports of loaded_theories with incomplete node name;
wenzelm
parents: 68306
diff changeset
   438
    Deps(sessions_structure, session_bases, all_known)
65372
b722ee40c26c refer to global_theories from all sessions, before selection;
wenzelm
parents: 65371
diff changeset
   439
  }
65251
4b0a43afc3fb clarified modules;
wenzelm
parents: 64856
diff changeset
   440
66963
1c3d0c12bb51 clarified signature;
wenzelm
parents: 66962
diff changeset
   441
1c3d0c12bb51 clarified signature;
wenzelm
parents: 66962
diff changeset
   442
  /* base info */
1c3d0c12bb51 clarified signature;
wenzelm
parents: 66962
diff changeset
   443
66974
b14c24b31f45 avoid duplicate invocation of expensive Sessions.deps on full_sessions;
wenzelm
parents: 66970
diff changeset
   444
  sealed case class Base_Info(
67869
8cb4fef58379 support for "session_start";
wenzelm
parents: 67852
diff changeset
   445
    options: Options,
8cb4fef58379 support for "session_start";
wenzelm
parents: 67852
diff changeset
   446
    dirs: List[Path],
66974
b14c24b31f45 avoid duplicate invocation of expensive Sessions.deps on full_sessions;
wenzelm
parents: 66970
diff changeset
   447
    session: String,
67052
caf87d4b9b61 tuned signature;
wenzelm
parents: 67029
diff changeset
   448
    sessions_structure: Structure,
66975
ca73d44d51aa do not store bulky Session.Deps;
wenzelm
parents: 66974
diff changeset
   449
    errors: List[String],
66974
b14c24b31f45 avoid duplicate invocation of expensive Sessions.deps on full_sessions;
wenzelm
parents: 66970
diff changeset
   450
    base: Base,
b14c24b31f45 avoid duplicate invocation of expensive Sessions.deps on full_sessions;
wenzelm
parents: 66970
diff changeset
   451
    infos: List[Info])
b14c24b31f45 avoid duplicate invocation of expensive Sessions.deps on full_sessions;
wenzelm
parents: 66970
diff changeset
   452
  {
b14c24b31f45 avoid duplicate invocation of expensive Sessions.deps on full_sessions;
wenzelm
parents: 66970
diff changeset
   453
    def check_base: Base = if (errors.isEmpty) base else error(cat_lines(errors))
b14c24b31f45 avoid duplicate invocation of expensive Sessions.deps on full_sessions;
wenzelm
parents: 66970
diff changeset
   454
  }
b14c24b31f45 avoid duplicate invocation of expensive Sessions.deps on full_sessions;
wenzelm
parents: 66970
diff changeset
   455
67846
wenzelm
parents: 67493
diff changeset
   456
  def base_info(options: Options,
wenzelm
parents: 67493
diff changeset
   457
    session: String,
67852
f701a1d5d852 allow cancellation of Sessions.deps/base_info via progress.stopped (progress.echo only happens for options like "verbose");
wenzelm
parents: 67846
diff changeset
   458
    progress: Progress = No_Progress,
65428
f8dd71a0791a support for all_known_theories of all sessions;
wenzelm
parents: 65427
diff changeset
   459
    dirs: List[Path] = Nil,
67922
9e668ae81f97 clarified signature: prefer selective include_sessions;
wenzelm
parents: 67880
diff changeset
   460
    include_sessions: List[String] = Nil,
68370
bcdc47c9d4af clarified signature;
wenzelm
parents: 68318
diff changeset
   461
    session_ancestor: Option[String] = None,
bcdc47c9d4af clarified signature;
wenzelm
parents: 68318
diff changeset
   462
    session_requirements: Boolean = false,
bcdc47c9d4af clarified signature;
wenzelm
parents: 68318
diff changeset
   463
    session_focus: Boolean = false,
bcdc47c9d4af clarified signature;
wenzelm
parents: 68318
diff changeset
   464
    all_known: Boolean = false): Base_Info =
65251
4b0a43afc3fb clarified modules;
wenzelm
parents: 64856
diff changeset
   465
  {
67026
687c822ee5e3 tuned signature;
wenzelm
parents: 67025
diff changeset
   466
    val full_sessions = load_structure(options, dirs = dirs)
65372
b722ee40c26c refer to global_theories from all sessions, before selection;
wenzelm
parents: 65371
diff changeset
   467
66990
b23adab22e67 allow unrelated ancestor;
wenzelm
parents: 66988
diff changeset
   468
    val selected_sessions =
68370
bcdc47c9d4af clarified signature;
wenzelm
parents: 68318
diff changeset
   469
      full_sessions.selection(Selection(sessions = session :: session_ancestor.toList))
66974
b14c24b31f45 avoid duplicate invocation of expensive Sessions.deps on full_sessions;
wenzelm
parents: 66970
diff changeset
   470
    val info = selected_sessions(session)
68370
bcdc47c9d4af clarified signature;
wenzelm
parents: 68318
diff changeset
   471
    val ancestor = session_ancestor orElse info.parent
66963
1c3d0c12bb51 clarified signature;
wenzelm
parents: 66962
diff changeset
   472
66974
b14c24b31f45 avoid duplicate invocation of expensive Sessions.deps on full_sessions;
wenzelm
parents: 66970
diff changeset
   473
    val (session1, infos1) =
68370
bcdc47c9d4af clarified signature;
wenzelm
parents: 68318
diff changeset
   474
      if (session_requirements && ancestor.isDefined) {
70671
cb1776c8e216 clarified signature: retain global session information, unaffected by later restriction;
wenzelm
parents: 70668
diff changeset
   475
        val deps = Sessions.deps(selected_sessions, progress = progress)
66974
b14c24b31f45 avoid duplicate invocation of expensive Sessions.deps on full_sessions;
wenzelm
parents: 66970
diff changeset
   476
        val base = deps(session)
66968
9991671c98aa allow to augment session context via explicit session infos;
wenzelm
parents: 66967
diff changeset
   477
66988
7f8c1dd7576a support alternative ancestor session;
wenzelm
parents: 66987
diff changeset
   478
        val ancestor_loaded =
7f8c1dd7576a support alternative ancestor session;
wenzelm
parents: 66987
diff changeset
   479
          deps.get(ancestor.get) match {
66990
b23adab22e67 allow unrelated ancestor;
wenzelm
parents: 66988
diff changeset
   480
            case Some(ancestor_base)
b23adab22e67 allow unrelated ancestor;
wenzelm
parents: 66988
diff changeset
   481
            if !selected_sessions.imports_requirements(List(ancestor.get)).contains(session) =>
b23adab22e67 allow unrelated ancestor;
wenzelm
parents: 66988
diff changeset
   482
              ancestor_base.loaded_theories.defined(_)
b23adab22e67 allow unrelated ancestor;
wenzelm
parents: 66988
diff changeset
   483
            case _ =>
66988
7f8c1dd7576a support alternative ancestor session;
wenzelm
parents: 66987
diff changeset
   484
              error("Bad ancestor " + quote(ancestor.get) + " for session " + quote(session))
7f8c1dd7576a support alternative ancestor session;
wenzelm
parents: 66987
diff changeset
   485
          }
66974
b14c24b31f45 avoid duplicate invocation of expensive Sessions.deps on full_sessions;
wenzelm
parents: 66970
diff changeset
   486
b14c24b31f45 avoid duplicate invocation of expensive Sessions.deps on full_sessions;
wenzelm
parents: 66970
diff changeset
   487
        val required_theories =
66968
9991671c98aa allow to augment session context via explicit session infos;
wenzelm
parents: 66967
diff changeset
   488
          for {
9991671c98aa allow to augment session context via explicit session infos;
wenzelm
parents: 66967
diff changeset
   489
            thy <- base.loaded_theories.keys
66988
7f8c1dd7576a support alternative ancestor session;
wenzelm
parents: 66987
diff changeset
   490
            if !ancestor_loaded(thy) && base.theory_qualifier(thy) != session
66968
9991671c98aa allow to augment session context via explicit session infos;
wenzelm
parents: 66967
diff changeset
   491
          }
66974
b14c24b31f45 avoid duplicate invocation of expensive Sessions.deps on full_sessions;
wenzelm
parents: 66970
diff changeset
   492
          yield thy
66968
9991671c98aa allow to augment session context via explicit session infos;
wenzelm
parents: 66967
diff changeset
   493
66988
7f8c1dd7576a support alternative ancestor session;
wenzelm
parents: 66987
diff changeset
   494
        if (required_theories.isEmpty) (ancestor.get, Nil)
66968
9991671c98aa allow to augment session context via explicit session infos;
wenzelm
parents: 66967
diff changeset
   495
        else {
68370
bcdc47c9d4af clarified signature;
wenzelm
parents: 68318
diff changeset
   496
          val other_name = info.name + "_requirements(" + ancestor.get + ")"
66974
b14c24b31f45 avoid duplicate invocation of expensive Sessions.deps on full_sessions;
wenzelm
parents: 66970
diff changeset
   497
          (other_name,
66968
9991671c98aa allow to augment session context via explicit session infos;
wenzelm
parents: 66967
diff changeset
   498
            List(
9991671c98aa allow to augment session context via explicit session infos;
wenzelm
parents: 66967
diff changeset
   499
              make_info(info.options,
9991671c98aa allow to augment session context via explicit session infos;
wenzelm
parents: 66967
diff changeset
   500
                dir_selected = false,
9991671c98aa allow to augment session context via explicit session infos;
wenzelm
parents: 66967
diff changeset
   501
                dir = info.dir,
9991671c98aa allow to augment session context via explicit session infos;
wenzelm
parents: 66967
diff changeset
   502
                chapter = info.chapter,
9991671c98aa allow to augment session context via explicit session infos;
wenzelm
parents: 66967
diff changeset
   503
                Session_Entry(
9991671c98aa allow to augment session context via explicit session infos;
wenzelm
parents: 66967
diff changeset
   504
                  pos = info.pos,
9991671c98aa allow to augment session context via explicit session infos;
wenzelm
parents: 66967
diff changeset
   505
                  name = other_name,
9991671c98aa allow to augment session context via explicit session infos;
wenzelm
parents: 66967
diff changeset
   506
                  groups = info.groups,
9991671c98aa allow to augment session context via explicit session infos;
wenzelm
parents: 66967
diff changeset
   507
                  path = ".",
66988
7f8c1dd7576a support alternative ancestor session;
wenzelm
parents: 66987
diff changeset
   508
                  parent = ancestor,
66974
b14c24b31f45 avoid duplicate invocation of expensive Sessions.deps on full_sessions;
wenzelm
parents: 66970
diff changeset
   509
                  description = "Required theory imports from other sessions",
70668
9cac4dec0da9 support for explicit session directories;
wenzelm
parents: 70650
diff changeset
   510
                  directories = Nil,
66968
9991671c98aa allow to augment session context via explicit session infos;
wenzelm
parents: 66967
diff changeset
   511
                  options = Nil,
66991
fc87d3becd69 proper deps;
wenzelm
parents: 66990
diff changeset
   512
                  imports = info.deps,
66974
b14c24b31f45 avoid duplicate invocation of expensive Sessions.deps on full_sessions;
wenzelm
parents: 66970
diff changeset
   513
                  theories = List((Nil, required_theories.map(thy => ((thy, Position.none), false)))),
68292
7ca0c23179e6 support 'export_files' in session ROOT;
wenzelm
parents: 68221
diff changeset
   514
                  document_files = Nil,
7ca0c23179e6 support 'export_files' in session ROOT;
wenzelm
parents: 68221
diff changeset
   515
                  export_files = Nil))))
66968
9991671c98aa allow to augment session context via explicit session infos;
wenzelm
parents: 66967
diff changeset
   516
        }
9991671c98aa allow to augment session context via explicit session infos;
wenzelm
parents: 66967
diff changeset
   517
      }
66974
b14c24b31f45 avoid duplicate invocation of expensive Sessions.deps on full_sessions;
wenzelm
parents: 66970
diff changeset
   518
      else (session, Nil)
66968
9991671c98aa allow to augment session context via explicit session infos;
wenzelm
parents: 66967
diff changeset
   519
66974
b14c24b31f45 avoid duplicate invocation of expensive Sessions.deps on full_sessions;
wenzelm
parents: 66970
diff changeset
   520
    val full_sessions1 =
b14c24b31f45 avoid duplicate invocation of expensive Sessions.deps on full_sessions;
wenzelm
parents: 66970
diff changeset
   521
      if (infos1.isEmpty) full_sessions
67026
687c822ee5e3 tuned signature;
wenzelm
parents: 67025
diff changeset
   522
      else load_structure(options, dirs = dirs, infos = infos1)
66987
352b23c97ac8 support focus_session, for much faster startup of Isabelle/jEdit;
wenzelm
parents: 66984
diff changeset
   523
352b23c97ac8 support focus_session, for much faster startup of Isabelle/jEdit;
wenzelm
parents: 66984
diff changeset
   524
    val selected_sessions1 =
67922
9e668ae81f97 clarified signature: prefer selective include_sessions;
wenzelm
parents: 67880
diff changeset
   525
    {
68483
087d32a40129 include target sessions as well: avoid default "Draft" qualification;
wenzelm
parents: 68370
diff changeset
   526
      val sel_sessions1 = session1 :: session :: include_sessions
67922
9e668ae81f97 clarified signature: prefer selective include_sessions;
wenzelm
parents: 67880
diff changeset
   527
      val select_sessions1 =
68542
02df6c68a8cb clarified error;
wenzelm
parents: 68523
diff changeset
   528
        if (session_focus) {
02df6c68a8cb clarified error;
wenzelm
parents: 68523
diff changeset
   529
          full_sessions1.check_sessions(sel_sessions1)
02df6c68a8cb clarified error;
wenzelm
parents: 68523
diff changeset
   530
          full_sessions1.imports_descendants(sel_sessions1)
02df6c68a8cb clarified error;
wenzelm
parents: 68523
diff changeset
   531
        }
02df6c68a8cb clarified error;
wenzelm
parents: 68523
diff changeset
   532
        else sel_sessions1
67025
961285f581e6 clarifified selection: always wrt. build_graph structure;
wenzelm
parents: 67024
diff changeset
   533
      full_sessions1.selection(Selection(sessions = select_sessions1))
67922
9e668ae81f97 clarified signature: prefer selective include_sessions;
wenzelm
parents: 67880
diff changeset
   534
    }
66964
9f2de457b95e clarified signature;
wenzelm
parents: 66963
diff changeset
   535
66974
b14c24b31f45 avoid duplicate invocation of expensive Sessions.deps on full_sessions;
wenzelm
parents: 66970
diff changeset
   536
    val sessions1 = if (all_known) full_sessions1 else selected_sessions1
70671
cb1776c8e216 clarified signature: retain global session information, unaffected by later restriction;
wenzelm
parents: 70668
diff changeset
   537
    val deps1 = Sessions.deps(sessions1, progress = progress)
67922
9e668ae81f97 clarified signature: prefer selective include_sessions;
wenzelm
parents: 67880
diff changeset
   538
    val base1 = deps1(session1).copy(known = deps1.all_known)
66964
9f2de457b95e clarified signature;
wenzelm
parents: 66963
diff changeset
   539
68204
a554da2811f2 clarified signature;
wenzelm
parents: 68169
diff changeset
   540
    Base_Info(options, dirs, session1, deps1.sessions_structure, deps1.errors, base1, infos1)
65251
4b0a43afc3fb clarified modules;
wenzelm
parents: 64856
diff changeset
   541
  }
4b0a43afc3fb clarified modules;
wenzelm
parents: 64856
diff changeset
   542
4b0a43afc3fb clarified modules;
wenzelm
parents: 64856
diff changeset
   543
65415
8cd54b18b68b clarified signature: tree structure is not essential;
wenzelm
parents: 65410
diff changeset
   544
  /* cumulative session info */
62631
c39614ddb80b clarified modules;
wenzelm
parents:
diff changeset
   545
c39614ddb80b clarified modules;
wenzelm
parents:
diff changeset
   546
  sealed case class Info(
65519
d244d8f8e13f store Sessions.Info.name;
wenzelm
parents: 65517
diff changeset
   547
    name: String,
62631
c39614ddb80b clarified modules;
wenzelm
parents:
diff changeset
   548
    chapter: String,
66829
5baca4c94737 tuned signature;
wenzelm
parents: 66828
diff changeset
   549
    dir_selected: Boolean,
62631
c39614ddb80b clarified modules;
wenzelm
parents:
diff changeset
   550
    pos: Position.T,
c39614ddb80b clarified modules;
wenzelm
parents:
diff changeset
   551
    groups: List[String],
c39614ddb80b clarified modules;
wenzelm
parents:
diff changeset
   552
    dir: Path,
c39614ddb80b clarified modules;
wenzelm
parents:
diff changeset
   553
    parent: Option[String],
c39614ddb80b clarified modules;
wenzelm
parents:
diff changeset
   554
    description: String,
70668
9cac4dec0da9 support for explicit session directories;
wenzelm
parents: 70650
diff changeset
   555
    directories: List[(Path, Boolean)],
62631
c39614ddb80b clarified modules;
wenzelm
parents:
diff changeset
   556
    options: Options,
65420
695d4e22345a support for static session imports, without affect build hierarchy;
wenzelm
parents: 65419
diff changeset
   557
    imports: List[String],
65517
1544e61e5314 more position information;
wenzelm
parents: 65507
diff changeset
   558
    theories: List[(Options, List[(String, Position.T)])],
65374
a5b38d8d3c1e tuned syntax;
wenzelm
parents: 65373
diff changeset
   559
    global_theories: List[String],
62631
c39614ddb80b clarified modules;
wenzelm
parents:
diff changeset
   560
    document_files: List[(Path, Path)],
69671
2486792eaf61 support pruning of export names;
wenzelm
parents: 69560
diff changeset
   561
    export_files: List[(Path, Int, List[String])],
62631
c39614ddb80b clarified modules;
wenzelm
parents:
diff changeset
   562
    meta_digest: SHA1.Digest)
c39614ddb80b clarified modules;
wenzelm
parents:
diff changeset
   563
  {
66828
3c936ebebc23 tuned signature;
wenzelm
parents: 66823
diff changeset
   564
    def deps: List[String] = parent.toList ::: imports
3c936ebebc23 tuned signature;
wenzelm
parents: 66823
diff changeset
   565
70672
e4bba654d085 clarified session_directories: relative to session_path, with overlapping information;
wenzelm
parents: 70671
diff changeset
   566
    def dirs: List[(Path, Boolean)] = (dir, false) :: directories
70668
9cac4dec0da9 support for explicit session directories;
wenzelm
parents: 70650
diff changeset
   567
62631
c39614ddb80b clarified modules;
wenzelm
parents:
diff changeset
   568
    def timeout: Time = Time.seconds(options.real("timeout") * options.real("timeout_scale"))
67297
86a099f896fc formal check of @{cite} bibtex entries -- only in batch-mode session builds;
wenzelm
parents: 67290
diff changeset
   569
86a099f896fc formal check of @{cite} bibtex entries -- only in batch-mode session builds;
wenzelm
parents: 67290
diff changeset
   570
    def bibtex_entries: List[Text.Info[String]] =
86a099f896fc formal check of @{cite} bibtex entries -- only in batch-mode session builds;
wenzelm
parents: 67290
diff changeset
   571
      (for {
86a099f896fc formal check of @{cite} bibtex entries -- only in batch-mode session builds;
wenzelm
parents: 67290
diff changeset
   572
        (document_dir, file) <- document_files.iterator
69366
b6dacf6eabe3 clarified signature;
wenzelm
parents: 69255
diff changeset
   573
        if Bibtex.is_bibtex(file.file_name)
67297
86a099f896fc formal check of @{cite} bibtex entries -- only in batch-mode session builds;
wenzelm
parents: 67290
diff changeset
   574
        info <- Bibtex.entries(File.read(dir + document_dir + file)).iterator
86a099f896fc formal check of @{cite} bibtex entries -- only in batch-mode session builds;
wenzelm
parents: 67290
diff changeset
   575
      } yield info).toList
62631
c39614ddb80b clarified modules;
wenzelm
parents:
diff changeset
   576
  }
c39614ddb80b clarified modules;
wenzelm
parents:
diff changeset
   577
66967
e365c91c72a9 synthesize session with all required theories from other session imports;
wenzelm
parents: 66966
diff changeset
   578
  def make_info(options: Options, dir_selected: Boolean, dir: Path, chapter: String,
e365c91c72a9 synthesize session with all required theories from other session imports;
wenzelm
parents: 66966
diff changeset
   579
    entry: Session_Entry): Info =
e365c91c72a9 synthesize session with all required theories from other session imports;
wenzelm
parents: 66966
diff changeset
   580
  {
e365c91c72a9 synthesize session with all required theories from other session imports;
wenzelm
parents: 66966
diff changeset
   581
    try {
e365c91c72a9 synthesize session with all required theories from other session imports;
wenzelm
parents: 66966
diff changeset
   582
      val name = entry.name
e365c91c72a9 synthesize session with all required theories from other session imports;
wenzelm
parents: 66966
diff changeset
   583
67284
0094d938c53b tuned signature;
wenzelm
parents: 67219
diff changeset
   584
      if (exclude_session(name)) error("Bad session name")
66967
e365c91c72a9 synthesize session with all required theories from other session imports;
wenzelm
parents: 66966
diff changeset
   585
      if (is_pure(name) && entry.parent.isDefined) error("Illegal parent session")
e365c91c72a9 synthesize session with all required theories from other session imports;
wenzelm
parents: 66966
diff changeset
   586
      if (!is_pure(name) && !entry.parent.isDefined) error("Missing parent session")
e365c91c72a9 synthesize session with all required theories from other session imports;
wenzelm
parents: 66966
diff changeset
   587
70672
e4bba654d085 clarified session_directories: relative to session_path, with overlapping information;
wenzelm
parents: 70671
diff changeset
   588
      val session_path = dir + Path.explode(entry.path)
70668
9cac4dec0da9 support for explicit session directories;
wenzelm
parents: 70650
diff changeset
   589
      val directories =
70672
e4bba654d085 clarified session_directories: relative to session_path, with overlapping information;
wenzelm
parents: 70671
diff changeset
   590
        for { (dir, overlapping) <- entry.directories }
e4bba654d085 clarified session_directories: relative to session_path, with overlapping information;
wenzelm
parents: 70671
diff changeset
   591
        yield (session_path + Path.explode(dir), overlapping)
70668
9cac4dec0da9 support for explicit session directories;
wenzelm
parents: 70650
diff changeset
   592
66967
e365c91c72a9 synthesize session with all required theories from other session imports;
wenzelm
parents: 66966
diff changeset
   593
      val session_options = options ++ entry.options
e365c91c72a9 synthesize session with all required theories from other session imports;
wenzelm
parents: 66966
diff changeset
   594
e365c91c72a9 synthesize session with all required theories from other session imports;
wenzelm
parents: 66966
diff changeset
   595
      val theories =
67216
99815211970c disallow theory name "ROOT";
wenzelm
parents: 67215
diff changeset
   596
        entry.theories.map({ case (opts, thys) =>
99815211970c disallow theory name "ROOT";
wenzelm
parents: 67215
diff changeset
   597
          (session_options ++ opts,
99815211970c disallow theory name "ROOT";
wenzelm
parents: 67215
diff changeset
   598
            thys.map({ case ((thy, pos), _) =>
67284
0094d938c53b tuned signature;
wenzelm
parents: 67219
diff changeset
   599
              if (exclude_theory(thy))
67216
99815211970c disallow theory name "ROOT";
wenzelm
parents: 67215
diff changeset
   600
                error("Bad theory name " + quote(thy) + Position.here(pos))
99815211970c disallow theory name "ROOT";
wenzelm
parents: 67215
diff changeset
   601
              else (thy, pos) })) })
66967
e365c91c72a9 synthesize session with all required theories from other session imports;
wenzelm
parents: 66966
diff changeset
   602
e365c91c72a9 synthesize session with all required theories from other session imports;
wenzelm
parents: 66966
diff changeset
   603
      val global_theories =
e365c91c72a9 synthesize session with all required theories from other session imports;
wenzelm
parents: 66966
diff changeset
   604
        for { (_, thys) <- entry.theories; ((thy, pos), global) <- thys if global }
e365c91c72a9 synthesize session with all required theories from other session imports;
wenzelm
parents: 66966
diff changeset
   605
        yield {
69366
b6dacf6eabe3 clarified signature;
wenzelm
parents: 69255
diff changeset
   606
          val thy_name = Path.explode(thy).file_name
66967
e365c91c72a9 synthesize session with all required theories from other session imports;
wenzelm
parents: 66966
diff changeset
   607
          if (Long_Name.is_qualified(thy_name))
e365c91c72a9 synthesize session with all required theories from other session imports;
wenzelm
parents: 66966
diff changeset
   608
            error("Bad qualified name for global theory " +
e365c91c72a9 synthesize session with all required theories from other session imports;
wenzelm
parents: 66966
diff changeset
   609
              quote(thy_name) + Position.here(pos))
e365c91c72a9 synthesize session with all required theories from other session imports;
wenzelm
parents: 66966
diff changeset
   610
          else thy_name
e365c91c72a9 synthesize session with all required theories from other session imports;
wenzelm
parents: 66966
diff changeset
   611
        }
e365c91c72a9 synthesize session with all required theories from other session imports;
wenzelm
parents: 66966
diff changeset
   612
e365c91c72a9 synthesize session with all required theories from other session imports;
wenzelm
parents: 66966
diff changeset
   613
      val conditions =
e365c91c72a9 synthesize session with all required theories from other session imports;
wenzelm
parents: 66966
diff changeset
   614
        theories.flatMap(thys => space_explode(',', thys._1.string("condition"))).distinct.sorted.
e365c91c72a9 synthesize session with all required theories from other session imports;
wenzelm
parents: 66966
diff changeset
   615
          map(x => (x, Isabelle_System.getenv(x) != ""))
e365c91c72a9 synthesize session with all required theories from other session imports;
wenzelm
parents: 66966
diff changeset
   616
e365c91c72a9 synthesize session with all required theories from other session imports;
wenzelm
parents: 66966
diff changeset
   617
      val document_files =
e365c91c72a9 synthesize session with all required theories from other session imports;
wenzelm
parents: 66966
diff changeset
   618
        entry.document_files.map({ case (s1, s2) => (Path.explode(s1), Path.explode(s2)) })
e365c91c72a9 synthesize session with all required theories from other session imports;
wenzelm
parents: 66966
diff changeset
   619
68292
7ca0c23179e6 support 'export_files' in session ROOT;
wenzelm
parents: 68221
diff changeset
   620
      val export_files =
69671
2486792eaf61 support pruning of export names;
wenzelm
parents: 69560
diff changeset
   621
        entry.export_files.map({ case (dir, prune, pats) => (Path.explode(dir), prune, pats) })
68292
7ca0c23179e6 support 'export_files' in session ROOT;
wenzelm
parents: 68221
diff changeset
   622
66967
e365c91c72a9 synthesize session with all required theories from other session imports;
wenzelm
parents: 66966
diff changeset
   623
      val meta_digest =
70668
9cac4dec0da9 support for explicit session directories;
wenzelm
parents: 70650
diff changeset
   624
        SHA1.digest((name, chapter, entry.parent, entry.directories, entry.options, entry.imports,
69812
9487788a94c1 clarified meta_digest: export_files is a directive for physical output from existing build database;
wenzelm
parents: 69762
diff changeset
   625
          entry.theories_no_position, conditions, entry.document_files).toString)
66967
e365c91c72a9 synthesize session with all required theories from other session imports;
wenzelm
parents: 66966
diff changeset
   626
70672
e4bba654d085 clarified session_directories: relative to session_path, with overlapping information;
wenzelm
parents: 70671
diff changeset
   627
      Info(name, chapter, dir_selected, entry.pos, entry.groups, session_path,
70668
9cac4dec0da9 support for explicit session directories;
wenzelm
parents: 70650
diff changeset
   628
        entry.parent, entry.description, directories, session_options,
68292
7ca0c23179e6 support 'export_files' in session ROOT;
wenzelm
parents: 68221
diff changeset
   629
        entry.imports, theories, global_theories, document_files, export_files, meta_digest)
66967
e365c91c72a9 synthesize session with all required theories from other session imports;
wenzelm
parents: 66966
diff changeset
   630
    }
e365c91c72a9 synthesize session with all required theories from other session imports;
wenzelm
parents: 66966
diff changeset
   631
    catch {
e365c91c72a9 synthesize session with all required theories from other session imports;
wenzelm
parents: 66966
diff changeset
   632
      case ERROR(msg) =>
e365c91c72a9 synthesize session with all required theories from other session imports;
wenzelm
parents: 66966
diff changeset
   633
        error(msg + "\nThe error(s) above occurred in session entry " +
e365c91c72a9 synthesize session with all required theories from other session imports;
wenzelm
parents: 66966
diff changeset
   634
          quote(entry.name) + Position.here(entry.pos))
e365c91c72a9 synthesize session with all required theories from other session imports;
wenzelm
parents: 66966
diff changeset
   635
    }
e365c91c72a9 synthesize session with all required theories from other session imports;
wenzelm
parents: 66966
diff changeset
   636
  }
e365c91c72a9 synthesize session with all required theories from other session imports;
wenzelm
parents: 66966
diff changeset
   637
65419
457e4fbed731 explicit Sessions.Selection;
wenzelm
parents: 65415
diff changeset
   638
  object Selection
457e4fbed731 explicit Sessions.Selection;
wenzelm
parents: 65415
diff changeset
   639
  {
65422
b606c98e6d10 tuned signature;
wenzelm
parents: 65420
diff changeset
   640
    val empty: Selection = Selection()
65525
360063716c71 more operations;
wenzelm
parents: 65524
diff changeset
   641
    val all: Selection = Selection(all_sessions = true)
65419
457e4fbed731 explicit Sessions.Selection;
wenzelm
parents: 65415
diff changeset
   642
  }
457e4fbed731 explicit Sessions.Selection;
wenzelm
parents: 65415
diff changeset
   643
457e4fbed731 explicit Sessions.Selection;
wenzelm
parents: 65415
diff changeset
   644
  sealed case class Selection(
457e4fbed731 explicit Sessions.Selection;
wenzelm
parents: 65415
diff changeset
   645
    requirements: Boolean = false,
457e4fbed731 explicit Sessions.Selection;
wenzelm
parents: 65415
diff changeset
   646
    all_sessions: Boolean = false,
66737
2edc0c42c883 option -B for "isabelle build" and "isabelle imports";
wenzelm
parents: 66736
diff changeset
   647
    base_sessions: List[String] = Nil,
65419
457e4fbed731 explicit Sessions.Selection;
wenzelm
parents: 65415
diff changeset
   648
    exclude_session_groups: List[String] = Nil,
457e4fbed731 explicit Sessions.Selection;
wenzelm
parents: 65415
diff changeset
   649
    exclude_sessions: List[String] = Nil,
457e4fbed731 explicit Sessions.Selection;
wenzelm
parents: 65415
diff changeset
   650
    session_groups: List[String] = Nil,
457e4fbed731 explicit Sessions.Selection;
wenzelm
parents: 65415
diff changeset
   651
    sessions: List[String] = Nil)
457e4fbed731 explicit Sessions.Selection;
wenzelm
parents: 65415
diff changeset
   652
  {
66736
148891036469 more standard merge operation;
wenzelm
parents: 66722
diff changeset
   653
    def ++ (other: Selection): Selection =
65422
b606c98e6d10 tuned signature;
wenzelm
parents: 65420
diff changeset
   654
      Selection(
b606c98e6d10 tuned signature;
wenzelm
parents: 65420
diff changeset
   655
        requirements = requirements || other.requirements,
b606c98e6d10 tuned signature;
wenzelm
parents: 65420
diff changeset
   656
        all_sessions = all_sessions || other.all_sessions,
66737
2edc0c42c883 option -B for "isabelle build" and "isabelle imports";
wenzelm
parents: 66736
diff changeset
   657
        base_sessions = Library.merge(base_sessions, other.base_sessions),
66736
148891036469 more standard merge operation;
wenzelm
parents: 66722
diff changeset
   658
        exclude_session_groups = Library.merge(exclude_session_groups, other.exclude_session_groups),
148891036469 more standard merge operation;
wenzelm
parents: 66722
diff changeset
   659
        exclude_sessions = Library.merge(exclude_sessions, other.exclude_sessions),
148891036469 more standard merge operation;
wenzelm
parents: 66722
diff changeset
   660
        session_groups = Library.merge(session_groups, other.session_groups),
148891036469 more standard merge operation;
wenzelm
parents: 66722
diff changeset
   661
        sessions = Library.merge(sessions, other.sessions))
65419
457e4fbed731 explicit Sessions.Selection;
wenzelm
parents: 65415
diff changeset
   662
  }
457e4fbed731 explicit Sessions.Selection;
wenzelm
parents: 65415
diff changeset
   663
67052
caf87d4b9b61 tuned signature;
wenzelm
parents: 67029
diff changeset
   664
  def make(infos: List[Info]): Structure =
62631
c39614ddb80b clarified modules;
wenzelm
parents:
diff changeset
   665
  {
65420
695d4e22345a support for static session imports, without affect build hierarchy;
wenzelm
parents: 65419
diff changeset
   666
    def add_edges(graph: Graph[String, Info], kind: String, edges: Info => Traversable[String])
695d4e22345a support for static session imports, without affect build hierarchy;
wenzelm
parents: 65419
diff changeset
   667
      : Graph[String, Info] =
695d4e22345a support for static session imports, without affect build hierarchy;
wenzelm
parents: 65419
diff changeset
   668
    {
695d4e22345a support for static session imports, without affect build hierarchy;
wenzelm
parents: 65419
diff changeset
   669
      def add_edge(pos: Position.T, name: String, g: Graph[String, Info], parent: String) =
695d4e22345a support for static session imports, without affect build hierarchy;
wenzelm
parents: 65419
diff changeset
   670
      {
695d4e22345a support for static session imports, without affect build hierarchy;
wenzelm
parents: 65419
diff changeset
   671
        if (!g.defined(parent))
695d4e22345a support for static session imports, without affect build hierarchy;
wenzelm
parents: 65419
diff changeset
   672
          error("Bad " + kind + " session " + quote(parent) + " for " +
695d4e22345a support for static session imports, without affect build hierarchy;
wenzelm
parents: 65419
diff changeset
   673
            quote(name) + Position.here(pos))
695d4e22345a support for static session imports, without affect build hierarchy;
wenzelm
parents: 65419
diff changeset
   674
695d4e22345a support for static session imports, without affect build hierarchy;
wenzelm
parents: 65419
diff changeset
   675
        try { g.add_edge_acyclic(parent, name) }
695d4e22345a support for static session imports, without affect build hierarchy;
wenzelm
parents: 65419
diff changeset
   676
        catch {
695d4e22345a support for static session imports, without affect build hierarchy;
wenzelm
parents: 65419
diff changeset
   677
          case exn: Graph.Cycles[_] =>
695d4e22345a support for static session imports, without affect build hierarchy;
wenzelm
parents: 65419
diff changeset
   678
            error(cat_lines(exn.cycles.map(cycle =>
695d4e22345a support for static session imports, without affect build hierarchy;
wenzelm
parents: 65419
diff changeset
   679
              "Cyclic session dependency of " +
695d4e22345a support for static session imports, without affect build hierarchy;
wenzelm
parents: 65419
diff changeset
   680
                cycle.map(c => quote(c.toString)).mkString(" via "))) + Position.here(pos))
695d4e22345a support for static session imports, without affect build hierarchy;
wenzelm
parents: 65419
diff changeset
   681
        }
695d4e22345a support for static session imports, without affect build hierarchy;
wenzelm
parents: 65419
diff changeset
   682
      }
695d4e22345a support for static session imports, without affect build hierarchy;
wenzelm
parents: 65419
diff changeset
   683
      (graph /: graph.iterator) {
695d4e22345a support for static session imports, without affect build hierarchy;
wenzelm
parents: 65419
diff changeset
   684
        case (g, (name, (info, _))) => (g /: edges(info))(add_edge(info.pos, name, _, _))
695d4e22345a support for static session imports, without affect build hierarchy;
wenzelm
parents: 65419
diff changeset
   685
      }
695d4e22345a support for static session imports, without affect build hierarchy;
wenzelm
parents: 65419
diff changeset
   686
    }
695d4e22345a support for static session imports, without affect build hierarchy;
wenzelm
parents: 65419
diff changeset
   687
70671
cb1776c8e216 clarified signature: retain global session information, unaffected by later restriction;
wenzelm
parents: 70668
diff changeset
   688
    val info_graph =
65415
8cd54b18b68b clarified signature: tree structure is not essential;
wenzelm
parents: 65410
diff changeset
   689
      (Graph.string[Info] /: infos) {
66960
d62f1f03868a tuned signature;
wenzelm
parents: 66959
diff changeset
   690
        case (graph, info) =>
d62f1f03868a tuned signature;
wenzelm
parents: 66959
diff changeset
   691
          if (graph.defined(info.name))
d62f1f03868a tuned signature;
wenzelm
parents: 66959
diff changeset
   692
            error("Duplicate session " + quote(info.name) + Position.here(info.pos) +
d62f1f03868a tuned signature;
wenzelm
parents: 66959
diff changeset
   693
              Position.here(graph.get_node(info.name).pos))
d62f1f03868a tuned signature;
wenzelm
parents: 66959
diff changeset
   694
          else graph.new_node(info.name, info)
65415
8cd54b18b68b clarified signature: tree structure is not essential;
wenzelm
parents: 65410
diff changeset
   695
      }
70671
cb1776c8e216 clarified signature: retain global session information, unaffected by later restriction;
wenzelm
parents: 70668
diff changeset
   696
    val build_graph = add_edges(info_graph, "parent", _.parent)
cb1776c8e216 clarified signature: retain global session information, unaffected by later restriction;
wenzelm
parents: 70668
diff changeset
   697
    val imports_graph = add_edges(build_graph, "imports", _.imports)
62631
c39614ddb80b clarified modules;
wenzelm
parents:
diff changeset
   698
70672
e4bba654d085 clarified session_directories: relative to session_path, with overlapping information;
wenzelm
parents: 70671
diff changeset
   699
    val session_directories: Map[JFile, (String, Boolean)] =
e4bba654d085 clarified session_directories: relative to session_path, with overlapping information;
wenzelm
parents: 70671
diff changeset
   700
      (Map.empty[JFile, (String, Boolean)] /:
70671
cb1776c8e216 clarified signature: retain global session information, unaffected by later restriction;
wenzelm
parents: 70668
diff changeset
   701
        (for {
cb1776c8e216 clarified signature: retain global session information, unaffected by later restriction;
wenzelm
parents: 70668
diff changeset
   702
          session <- imports_graph.topological_order.iterator
cb1776c8e216 clarified signature: retain global session information, unaffected by later restriction;
wenzelm
parents: 70668
diff changeset
   703
          info = info_graph.get_node(session)
70672
e4bba654d085 clarified session_directories: relative to session_path, with overlapping information;
wenzelm
parents: 70671
diff changeset
   704
          dir_overlapping <- info.dirs.iterator
e4bba654d085 clarified session_directories: relative to session_path, with overlapping information;
wenzelm
parents: 70671
diff changeset
   705
        } yield (info, dir_overlapping)))({ case (dirs, (info, (dir, overlapping))) =>
70671
cb1776c8e216 clarified signature: retain global session information, unaffected by later restriction;
wenzelm
parents: 70668
diff changeset
   706
            val session = info.name
cb1776c8e216 clarified signature: retain global session information, unaffected by later restriction;
wenzelm
parents: 70668
diff changeset
   707
            val canonical_dir = dir.canonical_file
70672
e4bba654d085 clarified session_directories: relative to session_path, with overlapping information;
wenzelm
parents: 70671
diff changeset
   708
            def update(over: Boolean) = dirs + (canonical_dir -> (session -> over))
70671
cb1776c8e216 clarified signature: retain global session information, unaffected by later restriction;
wenzelm
parents: 70668
diff changeset
   709
            dirs.get(canonical_dir) match {
70672
e4bba654d085 clarified session_directories: relative to session_path, with overlapping information;
wenzelm
parents: 70671
diff changeset
   710
              case Some((session1, overlapping1)) =>
e4bba654d085 clarified session_directories: relative to session_path, with overlapping information;
wenzelm
parents: 70671
diff changeset
   711
                if (session == session1) update(overlapping || overlapping1)
e4bba654d085 clarified session_directories: relative to session_path, with overlapping information;
wenzelm
parents: 70671
diff changeset
   712
                else if (overlapping && !overlapping1) dirs
e4bba654d085 clarified session_directories: relative to session_path, with overlapping information;
wenzelm
parents: 70671
diff changeset
   713
                else if (!overlapping && overlapping1) update(overlapping)
e4bba654d085 clarified session_directories: relative to session_path, with overlapping information;
wenzelm
parents: 70671
diff changeset
   714
                else {
e4bba654d085 clarified session_directories: relative to session_path, with overlapping information;
wenzelm
parents: 70671
diff changeset
   715
                  val info1 = info_graph.get_node(session1)
e4bba654d085 clarified session_directories: relative to session_path, with overlapping information;
wenzelm
parents: 70671
diff changeset
   716
                  error("Duplicate use of directory " + dir +
e4bba654d085 clarified session_directories: relative to session_path, with overlapping information;
wenzelm
parents: 70671
diff changeset
   717
                    "\n  for session " + quote(session1) + Position.here(info1.pos) +
e4bba654d085 clarified session_directories: relative to session_path, with overlapping information;
wenzelm
parents: 70671
diff changeset
   718
                    "\n  vs. session " + quote(session) + Position.here(info.pos))
e4bba654d085 clarified session_directories: relative to session_path, with overlapping information;
wenzelm
parents: 70671
diff changeset
   719
                }
e4bba654d085 clarified session_directories: relative to session_path, with overlapping information;
wenzelm
parents: 70671
diff changeset
   720
              case None => update(overlapping)
70671
cb1776c8e216 clarified signature: retain global session information, unaffected by later restriction;
wenzelm
parents: 70668
diff changeset
   721
            }
cb1776c8e216 clarified signature: retain global session information, unaffected by later restriction;
wenzelm
parents: 70668
diff changeset
   722
          })
cb1776c8e216 clarified signature: retain global session information, unaffected by later restriction;
wenzelm
parents: 70668
diff changeset
   723
cb1776c8e216 clarified signature: retain global session information, unaffected by later restriction;
wenzelm
parents: 70668
diff changeset
   724
    val global_theories: Map[String, String] =
cb1776c8e216 clarified signature: retain global session information, unaffected by later restriction;
wenzelm
parents: 70668
diff changeset
   725
      (Thy_Header.bootstrap_global_theories.toMap /:
cb1776c8e216 clarified signature: retain global session information, unaffected by later restriction;
wenzelm
parents: 70668
diff changeset
   726
        (for {
cb1776c8e216 clarified signature: retain global session information, unaffected by later restriction;
wenzelm
parents: 70668
diff changeset
   727
          session <- imports_graph.topological_order.iterator
cb1776c8e216 clarified signature: retain global session information, unaffected by later restriction;
wenzelm
parents: 70668
diff changeset
   728
          info = info_graph.get_node(session)
cb1776c8e216 clarified signature: retain global session information, unaffected by later restriction;
wenzelm
parents: 70668
diff changeset
   729
          thy <- info.global_theories.iterator }
cb1776c8e216 clarified signature: retain global session information, unaffected by later restriction;
wenzelm
parents: 70668
diff changeset
   730
         yield (info, thy)))({ case (global, (info, thy)) =>
cb1776c8e216 clarified signature: retain global session information, unaffected by later restriction;
wenzelm
parents: 70668
diff changeset
   731
            val qualifier = info.name
cb1776c8e216 clarified signature: retain global session information, unaffected by later restriction;
wenzelm
parents: 70668
diff changeset
   732
            global.get(thy) match {
cb1776c8e216 clarified signature: retain global session information, unaffected by later restriction;
wenzelm
parents: 70668
diff changeset
   733
              case Some(qualifier1) if qualifier != qualifier1 =>
cb1776c8e216 clarified signature: retain global session information, unaffected by later restriction;
wenzelm
parents: 70668
diff changeset
   734
                error("Duplicate global theory " + quote(thy) + Position.here(info.pos))
cb1776c8e216 clarified signature: retain global session information, unaffected by later restriction;
wenzelm
parents: 70668
diff changeset
   735
              case _ => global + (thy -> qualifier)
cb1776c8e216 clarified signature: retain global session information, unaffected by later restriction;
wenzelm
parents: 70668
diff changeset
   736
            }
cb1776c8e216 clarified signature: retain global session information, unaffected by later restriction;
wenzelm
parents: 70668
diff changeset
   737
          })
cb1776c8e216 clarified signature: retain global session information, unaffected by later restriction;
wenzelm
parents: 70668
diff changeset
   738
70672
e4bba654d085 clarified session_directories: relative to session_path, with overlapping information;
wenzelm
parents: 70671
diff changeset
   739
    new Structure(session_directories, global_theories, build_graph, imports_graph)
62631
c39614ddb80b clarified modules;
wenzelm
parents:
diff changeset
   740
  }
c39614ddb80b clarified modules;
wenzelm
parents:
diff changeset
   741
67052
caf87d4b9b61 tuned signature;
wenzelm
parents: 67029
diff changeset
   742
  final class Structure private[Sessions](
70672
e4bba654d085 clarified session_directories: relative to session_path, with overlapping information;
wenzelm
parents: 70671
diff changeset
   743
      val session_directories: Map[JFile, (String, Boolean)],
70671
cb1776c8e216 clarified signature: retain global session information, unaffected by later restriction;
wenzelm
parents: 70668
diff changeset
   744
      val global_theories: Map[String, String],
65420
695d4e22345a support for static session imports, without affect build hierarchy;
wenzelm
parents: 65419
diff changeset
   745
      val build_graph: Graph[String, Info],
695d4e22345a support for static session imports, without affect build hierarchy;
wenzelm
parents: 65419
diff changeset
   746
      val imports_graph: Graph[String, Info])
62631
c39614ddb80b clarified modules;
wenzelm
parents:
diff changeset
   747
  {
69524
fa94f2b2a877 clarified sessions_deps, according to Isabelle/MMT usage;
wenzelm
parents: 69393
diff changeset
   748
    sessions_structure =>
fa94f2b2a877 clarified sessions_deps, according to Isabelle/MMT usage;
wenzelm
parents: 69393
diff changeset
   749
69762
58fb0d779583 support for session information via virtual file-system;
wenzelm
parents: 69671
diff changeset
   750
    lazy val chapters: SortedMap[String, List[Info]] =
58fb0d779583 support for session information via virtual file-system;
wenzelm
parents: 69671
diff changeset
   751
      (SortedMap.empty[String, List[Info]] /: build_graph.iterator)(
58fb0d779583 support for session information via virtual file-system;
wenzelm
parents: 69671
diff changeset
   752
        { case (chs, (_, (info, _))) =>
58fb0d779583 support for session information via virtual file-system;
wenzelm
parents: 69671
diff changeset
   753
            chs + (info.chapter -> (info :: chs.getOrElse(info.chapter, Nil))) })
58fb0d779583 support for session information via virtual file-system;
wenzelm
parents: 69671
diff changeset
   754
66823
f529719cc47d operations for graph display;
wenzelm
parents: 66822
diff changeset
   755
    def build_graph_display: Graph_Display.Graph = Graph_Display.make_graph(build_graph)
f529719cc47d operations for graph display;
wenzelm
parents: 66822
diff changeset
   756
    def imports_graph_display: Graph_Display.Graph = Graph_Display.make_graph(imports_graph)
f529719cc47d operations for graph display;
wenzelm
parents: 66822
diff changeset
   757
67025
961285f581e6 clarifified selection: always wrt. build_graph structure;
wenzelm
parents: 67024
diff changeset
   758
    def defined(name: String): Boolean = imports_graph.defined(name)
65420
695d4e22345a support for static session imports, without affect build hierarchy;
wenzelm
parents: 65419
diff changeset
   759
    def apply(name: String): Info = imports_graph.get_node(name)
67025
961285f581e6 clarifified selection: always wrt. build_graph structure;
wenzelm
parents: 67024
diff changeset
   760
    def get(name: String): Option[Info] = if (defined(name)) Some(apply(name)) else None
62631
c39614ddb80b clarified modules;
wenzelm
parents:
diff changeset
   761
68542
02df6c68a8cb clarified error;
wenzelm
parents: 68523
diff changeset
   762
    def check_sessions(names: List[String])
02df6c68a8cb clarified error;
wenzelm
parents: 68523
diff changeset
   763
    {
02df6c68a8cb clarified error;
wenzelm
parents: 68523
diff changeset
   764
      val bad_sessions = SortedSet(names.filterNot(defined(_)): _*).toList
02df6c68a8cb clarified error;
wenzelm
parents: 68523
diff changeset
   765
      if (bad_sessions.nonEmpty)
02df6c68a8cb clarified error;
wenzelm
parents: 68523
diff changeset
   766
        error("Undefined session(s): " + commas_quote(bad_sessions))
02df6c68a8cb clarified error;
wenzelm
parents: 68523
diff changeset
   767
    }
02df6c68a8cb clarified error;
wenzelm
parents: 68523
diff changeset
   768
68733
76e339ef60e3 more uniform checks;
wenzelm
parents: 68732
diff changeset
   769
    def check_sessions(sel: Selection): Unit =
76e339ef60e3 more uniform checks;
wenzelm
parents: 68732
diff changeset
   770
      check_sessions(sel.base_sessions ::: sel.exclude_sessions ::: sel.sessions)
76e339ef60e3 more uniform checks;
wenzelm
parents: 68732
diff changeset
   771
68732
5472f4409fe6 tuned signature;
wenzelm
parents: 68542
diff changeset
   772
    private def selected(graph: Graph[String, Info], sel: Selection): List[String] =
5472f4409fe6 tuned signature;
wenzelm
parents: 68542
diff changeset
   773
    {
68733
76e339ef60e3 more uniform checks;
wenzelm
parents: 68732
diff changeset
   774
      check_sessions(sel)
76e339ef60e3 more uniform checks;
wenzelm
parents: 68732
diff changeset
   775
68732
5472f4409fe6 tuned signature;
wenzelm
parents: 68542
diff changeset
   776
      val select_group = sel.session_groups.toSet
68734
c14a2cc9b5ef isabelle build options -c -x -B refer to imports_graph;
wenzelm
parents: 68733
diff changeset
   777
      val select_session = sel.sessions.toSet ++ imports_graph.all_succs(sel.base_sessions)
68732
5472f4409fe6 tuned signature;
wenzelm
parents: 68542
diff changeset
   778
5472f4409fe6 tuned signature;
wenzelm
parents: 68542
diff changeset
   779
      val selected0 =
5472f4409fe6 tuned signature;
wenzelm
parents: 68542
diff changeset
   780
        if (sel.all_sessions) graph.keys
5472f4409fe6 tuned signature;
wenzelm
parents: 68542
diff changeset
   781
        else {
5472f4409fe6 tuned signature;
wenzelm
parents: 68542
diff changeset
   782
          (for {
5472f4409fe6 tuned signature;
wenzelm
parents: 68542
diff changeset
   783
            (name, (info, _)) <- graph.iterator
5472f4409fe6 tuned signature;
wenzelm
parents: 68542
diff changeset
   784
            if info.dir_selected || select_session(name) ||
5472f4409fe6 tuned signature;
wenzelm
parents: 68542
diff changeset
   785
              graph.get_node(name).groups.exists(select_group)
5472f4409fe6 tuned signature;
wenzelm
parents: 68542
diff changeset
   786
          } yield name).toList
5472f4409fe6 tuned signature;
wenzelm
parents: 68542
diff changeset
   787
        }
5472f4409fe6 tuned signature;
wenzelm
parents: 68542
diff changeset
   788
5472f4409fe6 tuned signature;
wenzelm
parents: 68542
diff changeset
   789
      if (sel.requirements) (graph.all_preds(selected0).toSet -- selected0).toList
5472f4409fe6 tuned signature;
wenzelm
parents: 68542
diff changeset
   790
      else selected0
5472f4409fe6 tuned signature;
wenzelm
parents: 68542
diff changeset
   791
    }
5472f4409fe6 tuned signature;
wenzelm
parents: 68542
diff changeset
   792
67052
caf87d4b9b61 tuned signature;
wenzelm
parents: 67029
diff changeset
   793
    def selection(sel: Selection): Structure =
62631
c39614ddb80b clarified modules;
wenzelm
parents:
diff changeset
   794
    {
68733
76e339ef60e3 more uniform checks;
wenzelm
parents: 68732
diff changeset
   795
      check_sessions(sel)
67025
961285f581e6 clarifified selection: always wrt. build_graph structure;
wenzelm
parents: 67024
diff changeset
   796
68732
5472f4409fe6 tuned signature;
wenzelm
parents: 68542
diff changeset
   797
      val excluded =
5472f4409fe6 tuned signature;
wenzelm
parents: 68542
diff changeset
   798
      {
5472f4409fe6 tuned signature;
wenzelm
parents: 68542
diff changeset
   799
        val exclude_group = sel.exclude_session_groups.toSet
5472f4409fe6 tuned signature;
wenzelm
parents: 68542
diff changeset
   800
        val exclude_group_sessions =
5472f4409fe6 tuned signature;
wenzelm
parents: 68542
diff changeset
   801
          (for {
68734
c14a2cc9b5ef isabelle build options -c -x -B refer to imports_graph;
wenzelm
parents: 68733
diff changeset
   802
            (name, (info, _)) <- imports_graph.iterator
c14a2cc9b5ef isabelle build options -c -x -B refer to imports_graph;
wenzelm
parents: 68733
diff changeset
   803
            if imports_graph.get_node(name).groups.exists(exclude_group)
68732
5472f4409fe6 tuned signature;
wenzelm
parents: 68542
diff changeset
   804
          } yield name).toList
68734
c14a2cc9b5ef isabelle build options -c -x -B refer to imports_graph;
wenzelm
parents: 68733
diff changeset
   805
        imports_graph.all_succs(exclude_group_sessions ::: sel.exclude_sessions).toSet
68732
5472f4409fe6 tuned signature;
wenzelm
parents: 68542
diff changeset
   806
      }
67027
wenzelm
parents: 67026
diff changeset
   807
67025
961285f581e6 clarifified selection: always wrt. build_graph structure;
wenzelm
parents: 67024
diff changeset
   808
      def restrict(graph: Graph[String, Info]): Graph[String, Info] =
961285f581e6 clarifified selection: always wrt. build_graph structure;
wenzelm
parents: 67024
diff changeset
   809
      {
68732
5472f4409fe6 tuned signature;
wenzelm
parents: 68542
diff changeset
   810
        val sessions = graph.all_preds(selected(graph, sel)).filterNot(excluded)
67029
d6d9fd2559ce clarified signature (again);
wenzelm
parents: 67028
diff changeset
   811
        graph.restrict(graph.all_preds(sessions).toSet)
67025
961285f581e6 clarifified selection: always wrt. build_graph structure;
wenzelm
parents: 67024
diff changeset
   812
      }
961285f581e6 clarifified selection: always wrt. build_graph structure;
wenzelm
parents: 67024
diff changeset
   813
70671
cb1776c8e216 clarified signature: retain global session information, unaffected by later restriction;
wenzelm
parents: 70668
diff changeset
   814
      new Structure(
70672
e4bba654d085 clarified session_directories: relative to session_path, with overlapping information;
wenzelm
parents: 70671
diff changeset
   815
        session_directories, global_theories, restrict(build_graph), restrict(imports_graph))
62631
c39614ddb80b clarified modules;
wenzelm
parents:
diff changeset
   816
    }
c39614ddb80b clarified modules;
wenzelm
parents:
diff changeset
   817
69524
fa94f2b2a877 clarified sessions_deps, according to Isabelle/MMT usage;
wenzelm
parents: 69393
diff changeset
   818
    def selection_deps(
fa94f2b2a877 clarified sessions_deps, according to Isabelle/MMT usage;
wenzelm
parents: 69393
diff changeset
   819
      options: Options,
fa94f2b2a877 clarified sessions_deps, according to Isabelle/MMT usage;
wenzelm
parents: 69393
diff changeset
   820
      selection: Selection,
68304
09270aa40884 tuned signature;
wenzelm
parents: 68294
diff changeset
   821
      progress: Progress = No_Progress,
69524
fa94f2b2a877 clarified sessions_deps, according to Isabelle/MMT usage;
wenzelm
parents: 69393
diff changeset
   822
      uniform_session: Boolean = false,
fa94f2b2a877 clarified sessions_deps, according to Isabelle/MMT usage;
wenzelm
parents: 69393
diff changeset
   823
      loading_sessions: Boolean = false,
68304
09270aa40884 tuned signature;
wenzelm
parents: 68294
diff changeset
   824
      inlined_files: Boolean = false,
09270aa40884 tuned signature;
wenzelm
parents: 68294
diff changeset
   825
      verbose: Boolean = false): Deps =
09270aa40884 tuned signature;
wenzelm
parents: 68294
diff changeset
   826
    {
69524
fa94f2b2a877 clarified sessions_deps, according to Isabelle/MMT usage;
wenzelm
parents: 69393
diff changeset
   827
      val selection1 =
fa94f2b2a877 clarified sessions_deps, according to Isabelle/MMT usage;
wenzelm
parents: 69393
diff changeset
   828
        if (uniform_session) {
fa94f2b2a877 clarified sessions_deps, according to Isabelle/MMT usage;
wenzelm
parents: 69393
diff changeset
   829
          val sessions_structure1 = sessions_structure.selection(selection)
fa94f2b2a877 clarified sessions_deps, according to Isabelle/MMT usage;
wenzelm
parents: 69393
diff changeset
   830
fa94f2b2a877 clarified sessions_deps, according to Isabelle/MMT usage;
wenzelm
parents: 69393
diff changeset
   831
          val default_record_proofs = options.int("record_proofs")
fa94f2b2a877 clarified sessions_deps, according to Isabelle/MMT usage;
wenzelm
parents: 69393
diff changeset
   832
          val sessions_record_proofs =
fa94f2b2a877 clarified sessions_deps, according to Isabelle/MMT usage;
wenzelm
parents: 69393
diff changeset
   833
            for {
fa94f2b2a877 clarified sessions_deps, according to Isabelle/MMT usage;
wenzelm
parents: 69393
diff changeset
   834
              name <- sessions_structure1.build_topological_order
fa94f2b2a877 clarified sessions_deps, according to Isabelle/MMT usage;
wenzelm
parents: 69393
diff changeset
   835
              info <- sessions_structure1.get(name)
fa94f2b2a877 clarified sessions_deps, according to Isabelle/MMT usage;
wenzelm
parents: 69393
diff changeset
   836
              if info.options.int("record_proofs") > default_record_proofs
fa94f2b2a877 clarified sessions_deps, according to Isabelle/MMT usage;
wenzelm
parents: 69393
diff changeset
   837
            } yield name
fa94f2b2a877 clarified sessions_deps, according to Isabelle/MMT usage;
wenzelm
parents: 69393
diff changeset
   838
fa94f2b2a877 clarified sessions_deps, according to Isabelle/MMT usage;
wenzelm
parents: 69393
diff changeset
   839
          val excluded =
fa94f2b2a877 clarified sessions_deps, according to Isabelle/MMT usage;
wenzelm
parents: 69393
diff changeset
   840
            for (name <- sessions_structure1.build_descendants(sessions_record_proofs))
fa94f2b2a877 clarified sessions_deps, according to Isabelle/MMT usage;
wenzelm
parents: 69393
diff changeset
   841
            yield {
fa94f2b2a877 clarified sessions_deps, according to Isabelle/MMT usage;
wenzelm
parents: 69393
diff changeset
   842
              progress.echo_warning("Skipping session " + name + "  (option record_proofs)")
fa94f2b2a877 clarified sessions_deps, according to Isabelle/MMT usage;
wenzelm
parents: 69393
diff changeset
   843
              name
fa94f2b2a877 clarified sessions_deps, according to Isabelle/MMT usage;
wenzelm
parents: 69393
diff changeset
   844
            }
fa94f2b2a877 clarified sessions_deps, according to Isabelle/MMT usage;
wenzelm
parents: 69393
diff changeset
   845
fa94f2b2a877 clarified sessions_deps, according to Isabelle/MMT usage;
wenzelm
parents: 69393
diff changeset
   846
          selection.copy(exclude_sessions = excluded ::: selection.exclude_sessions)
fa94f2b2a877 clarified sessions_deps, according to Isabelle/MMT usage;
wenzelm
parents: 69393
diff changeset
   847
        }
fa94f2b2a877 clarified sessions_deps, according to Isabelle/MMT usage;
wenzelm
parents: 69393
diff changeset
   848
        else selection
fa94f2b2a877 clarified sessions_deps, according to Isabelle/MMT usage;
wenzelm
parents: 69393
diff changeset
   849
fa94f2b2a877 clarified sessions_deps, according to Isabelle/MMT usage;
wenzelm
parents: 69393
diff changeset
   850
      val deps =
70671
cb1776c8e216 clarified signature: retain global session information, unaffected by later restriction;
wenzelm
parents: 70668
diff changeset
   851
        Sessions.deps(sessions_structure.selection(selection1),
69524
fa94f2b2a877 clarified sessions_deps, according to Isabelle/MMT usage;
wenzelm
parents: 69393
diff changeset
   852
          progress = progress, inlined_files = inlined_files, verbose = verbose)
fa94f2b2a877 clarified sessions_deps, according to Isabelle/MMT usage;
wenzelm
parents: 69393
diff changeset
   853
fa94f2b2a877 clarified sessions_deps, according to Isabelle/MMT usage;
wenzelm
parents: 69393
diff changeset
   854
      if (loading_sessions) {
fa94f2b2a877 clarified sessions_deps, according to Isabelle/MMT usage;
wenzelm
parents: 69393
diff changeset
   855
        val selection_size = deps.sessions_structure.build_graph.size
fa94f2b2a877 clarified sessions_deps, according to Isabelle/MMT usage;
wenzelm
parents: 69393
diff changeset
   856
        if (selection_size > 1) progress.echo("Loading " + selection_size + " sessions ...")
fa94f2b2a877 clarified sessions_deps, according to Isabelle/MMT usage;
wenzelm
parents: 69393
diff changeset
   857
      }
fa94f2b2a877 clarified sessions_deps, according to Isabelle/MMT usage;
wenzelm
parents: 69393
diff changeset
   858
fa94f2b2a877 clarified sessions_deps, according to Isabelle/MMT usage;
wenzelm
parents: 69393
diff changeset
   859
      deps
68304
09270aa40884 tuned signature;
wenzelm
parents: 68294
diff changeset
   860
    }
09270aa40884 tuned signature;
wenzelm
parents: 68294
diff changeset
   861
68732
5472f4409fe6 tuned signature;
wenzelm
parents: 68542
diff changeset
   862
    def build_selection(sel: Selection): List[String] = selected(build_graph, sel)
67029
d6d9fd2559ce clarified signature (again);
wenzelm
parents: 67028
diff changeset
   863
    def build_descendants(ss: List[String]): List[String] = build_graph.all_succs(ss)
d6d9fd2559ce clarified signature (again);
wenzelm
parents: 67028
diff changeset
   864
    def build_requirements(ss: List[String]): List[String] = build_graph.all_preds(ss).reverse
d6d9fd2559ce clarified signature (again);
wenzelm
parents: 67028
diff changeset
   865
    def build_topological_order: List[String] = build_graph.topological_order
62631
c39614ddb80b clarified modules;
wenzelm
parents:
diff changeset
   866
68732
5472f4409fe6 tuned signature;
wenzelm
parents: 68542
diff changeset
   867
    def imports_selection(sel: Selection): List[String] = selected(imports_graph, sel)
67029
d6d9fd2559ce clarified signature (again);
wenzelm
parents: 67028
diff changeset
   868
    def imports_descendants(ss: List[String]): List[String] = imports_graph.all_succs(ss)
d6d9fd2559ce clarified signature (again);
wenzelm
parents: 67028
diff changeset
   869
    def imports_requirements(ss: List[String]): List[String] = imports_graph.all_preds(ss).reverse
d6d9fd2559ce clarified signature (again);
wenzelm
parents: 67028
diff changeset
   870
    def imports_topological_order: List[String] = imports_graph.topological_order
65420
695d4e22345a support for static session imports, without affect build hierarchy;
wenzelm
parents: 65419
diff changeset
   871
695d4e22345a support for static session imports, without affect build hierarchy;
wenzelm
parents: 65419
diff changeset
   872
    override def toString: String =
67052
caf87d4b9b61 tuned signature;
wenzelm
parents: 67029
diff changeset
   873
      imports_graph.keys_iterator.mkString("Sessions.Structure(", ", ", ")")
62631
c39614ddb80b clarified modules;
wenzelm
parents:
diff changeset
   874
  }
c39614ddb80b clarified modules;
wenzelm
parents:
diff changeset
   875
c39614ddb80b clarified modules;
wenzelm
parents:
diff changeset
   876
c39614ddb80b clarified modules;
wenzelm
parents:
diff changeset
   877
  /* parser */
c39614ddb80b clarified modules;
wenzelm
parents:
diff changeset
   878
62864
wenzelm
parents: 62769
diff changeset
   879
  val ROOT = Path.explode("ROOT")
wenzelm
parents: 62769
diff changeset
   880
  val ROOTS = Path.explode("ROOTS")
wenzelm
parents: 62769
diff changeset
   881
62631
c39614ddb80b clarified modules;
wenzelm
parents:
diff changeset
   882
  private val CHAPTER = "chapter"
c39614ddb80b clarified modules;
wenzelm
parents:
diff changeset
   883
  private val SESSION = "session"
c39614ddb80b clarified modules;
wenzelm
parents:
diff changeset
   884
  private val IN = "in"
c39614ddb80b clarified modules;
wenzelm
parents:
diff changeset
   885
  private val DESCRIPTION = "description"
70668
9cac4dec0da9 support for explicit session directories;
wenzelm
parents: 70650
diff changeset
   886
  private val DIRECTORIES = "directories"
9cac4dec0da9 support for explicit session directories;
wenzelm
parents: 70650
diff changeset
   887
  private val OVERLAPPING = "overlapping"
62631
c39614ddb80b clarified modules;
wenzelm
parents:
diff changeset
   888
  private val OPTIONS = "options"
65420
695d4e22345a support for static session imports, without affect build hierarchy;
wenzelm
parents: 65419
diff changeset
   889
  private val SESSIONS = "sessions"
62631
c39614ddb80b clarified modules;
wenzelm
parents:
diff changeset
   890
  private val THEORIES = "theories"
65374
a5b38d8d3c1e tuned syntax;
wenzelm
parents: 65373
diff changeset
   891
  private val GLOBAL = "global"
62631
c39614ddb80b clarified modules;
wenzelm
parents:
diff changeset
   892
  private val DOCUMENT_FILES = "document_files"
68292
7ca0c23179e6 support 'export_files' in session ROOT;
wenzelm
parents: 68221
diff changeset
   893
  private val EXPORT_FILES = "export_files"
62631
c39614ddb80b clarified modules;
wenzelm
parents:
diff changeset
   894
67004
af72fa58f71b clarified lazy Completion within Outer_Syntax: measurable speedup of Sessions.deps;
wenzelm
parents: 66991
diff changeset
   895
  val root_syntax =
70668
9cac4dec0da9 support for explicit session directories;
wenzelm
parents: 70650
diff changeset
   896
    Outer_Syntax.empty + "(" + ")" + "+" + "," + "=" + "[" + "]" +
9cac4dec0da9 support for explicit session directories;
wenzelm
parents: 70650
diff changeset
   897
      GLOBAL + IN + OVERLAPPING +
63443
c037248d54e8 clarified keywords;
wenzelm
parents: 63022
diff changeset
   898
      (CHAPTER, Keyword.THY_DECL) +
c037248d54e8 clarified keywords;
wenzelm
parents: 63022
diff changeset
   899
      (SESSION, Keyword.THY_DECL) +
c037248d54e8 clarified keywords;
wenzelm
parents: 63022
diff changeset
   900
      (DESCRIPTION, Keyword.QUASI_COMMAND) +
70668
9cac4dec0da9 support for explicit session directories;
wenzelm
parents: 70650
diff changeset
   901
      (DIRECTORIES, Keyword.QUASI_COMMAND) +
63443
c037248d54e8 clarified keywords;
wenzelm
parents: 63022
diff changeset
   902
      (OPTIONS, Keyword.QUASI_COMMAND) +
65420
695d4e22345a support for static session imports, without affect build hierarchy;
wenzelm
parents: 65419
diff changeset
   903
      (SESSIONS, Keyword.QUASI_COMMAND) +
63443
c037248d54e8 clarified keywords;
wenzelm
parents: 63022
diff changeset
   904
      (THEORIES, Keyword.QUASI_COMMAND) +
68292
7ca0c23179e6 support 'export_files' in session ROOT;
wenzelm
parents: 68221
diff changeset
   905
      (DOCUMENT_FILES, Keyword.QUASI_COMMAND) +
7ca0c23179e6 support 'export_files' in session ROOT;
wenzelm
parents: 68221
diff changeset
   906
      (EXPORT_FILES, Keyword.QUASI_COMMAND)
62631
c39614ddb80b clarified modules;
wenzelm
parents:
diff changeset
   907
66818
5bc903a60932 clarified signature: public access to ROOT file syntax;
wenzelm
parents: 66780
diff changeset
   908
  abstract class Entry
5bc903a60932 clarified signature: public access to ROOT file syntax;
wenzelm
parents: 66780
diff changeset
   909
  sealed case class Chapter(name: String) extends Entry
5bc903a60932 clarified signature: public access to ROOT file syntax;
wenzelm
parents: 66780
diff changeset
   910
  sealed case class Session_Entry(
5bc903a60932 clarified signature: public access to ROOT file syntax;
wenzelm
parents: 66780
diff changeset
   911
    pos: Position.T,
5bc903a60932 clarified signature: public access to ROOT file syntax;
wenzelm
parents: 66780
diff changeset
   912
    name: String,
5bc903a60932 clarified signature: public access to ROOT file syntax;
wenzelm
parents: 66780
diff changeset
   913
    groups: List[String],
5bc903a60932 clarified signature: public access to ROOT file syntax;
wenzelm
parents: 66780
diff changeset
   914
    path: String,
5bc903a60932 clarified signature: public access to ROOT file syntax;
wenzelm
parents: 66780
diff changeset
   915
    parent: Option[String],
5bc903a60932 clarified signature: public access to ROOT file syntax;
wenzelm
parents: 66780
diff changeset
   916
    description: String,
70668
9cac4dec0da9 support for explicit session directories;
wenzelm
parents: 70650
diff changeset
   917
    directories: List[(String, Boolean)],
66818
5bc903a60932 clarified signature: public access to ROOT file syntax;
wenzelm
parents: 66780
diff changeset
   918
    options: List[Options.Spec],
5bc903a60932 clarified signature: public access to ROOT file syntax;
wenzelm
parents: 66780
diff changeset
   919
    imports: List[String],
5bc903a60932 clarified signature: public access to ROOT file syntax;
wenzelm
parents: 66780
diff changeset
   920
    theories: List[(List[Options.Spec], List[((String, Position.T), Boolean)])],
68292
7ca0c23179e6 support 'export_files' in session ROOT;
wenzelm
parents: 68221
diff changeset
   921
    document_files: List[(String, String)],
69671
2486792eaf61 support pruning of export names;
wenzelm
parents: 69560
diff changeset
   922
    export_files: List[(String, Int, List[String])]) extends Entry
66818
5bc903a60932 clarified signature: public access to ROOT file syntax;
wenzelm
parents: 66780
diff changeset
   923
  {
5bc903a60932 clarified signature: public access to ROOT file syntax;
wenzelm
parents: 66780
diff changeset
   924
    def theories_no_position: List[(List[Options.Spec], List[(String, Boolean)])] =
5bc903a60932 clarified signature: public access to ROOT file syntax;
wenzelm
parents: 66780
diff changeset
   925
      theories.map({ case (a, b) => (a, b.map({ case ((c, _), d) => (c, d) })) })
5bc903a60932 clarified signature: public access to ROOT file syntax;
wenzelm
parents: 66780
diff changeset
   926
  }
5bc903a60932 clarified signature: public access to ROOT file syntax;
wenzelm
parents: 66780
diff changeset
   927
68841
252b43600737 clarified signature;
wenzelm
parents: 68808
diff changeset
   928
  private object Parser extends Options.Parser
62631
c39614ddb80b clarified modules;
wenzelm
parents:
diff changeset
   929
  {
c39614ddb80b clarified modules;
wenzelm
parents:
diff changeset
   930
    private val chapter: Parser[Chapter] =
c39614ddb80b clarified modules;
wenzelm
parents:
diff changeset
   931
    {
c39614ddb80b clarified modules;
wenzelm
parents:
diff changeset
   932
      val chapter_name = atom("chapter name", _.is_name)
c39614ddb80b clarified modules;
wenzelm
parents:
diff changeset
   933
c39614ddb80b clarified modules;
wenzelm
parents:
diff changeset
   934
      command(CHAPTER) ~! chapter_name ^^ { case _ ~ a => Chapter(a) }
c39614ddb80b clarified modules;
wenzelm
parents:
diff changeset
   935
    }
c39614ddb80b clarified modules;
wenzelm
parents:
diff changeset
   936
c39614ddb80b clarified modules;
wenzelm
parents:
diff changeset
   937
    private val session_entry: Parser[Session_Entry] =
c39614ddb80b clarified modules;
wenzelm
parents:
diff changeset
   938
    {
c39614ddb80b clarified modules;
wenzelm
parents:
diff changeset
   939
      val option =
67210
wenzelm
parents: 67097
diff changeset
   940
        option_name ~ opt($$$("=") ~! option_value ^^ { case _ ~ x => x }) ^^
wenzelm
parents: 67097
diff changeset
   941
          { case x ~ y => (x, y) }
62631
c39614ddb80b clarified modules;
wenzelm
parents:
diff changeset
   942
      val options = $$$("[") ~> rep1sep(option, $$$(",")) <~ $$$("]")
c39614ddb80b clarified modules;
wenzelm
parents:
diff changeset
   943
70668
9cac4dec0da9 support for explicit session directories;
wenzelm
parents: 70650
diff changeset
   944
      def directories =
9cac4dec0da9 support for explicit session directories;
wenzelm
parents: 70650
diff changeset
   945
        rep1(path ~ opt_keyword(OVERLAPPING) ^^ { case x ~ y => (x, y) })
65374
a5b38d8d3c1e tuned syntax;
wenzelm
parents: 65373
diff changeset
   946
a5b38d8d3c1e tuned syntax;
wenzelm
parents: 65373
diff changeset
   947
      val theory_entry =
70668
9cac4dec0da9 support for explicit session directories;
wenzelm
parents: 70650
diff changeset
   948
        position(theory_name) ~ opt_keyword(GLOBAL) ^^ { case x ~ y => (x, y) }
65374
a5b38d8d3c1e tuned syntax;
wenzelm
parents: 65373
diff changeset
   949
62631
c39614ddb80b clarified modules;
wenzelm
parents:
diff changeset
   950
      val theories =
65374
a5b38d8d3c1e tuned syntax;
wenzelm
parents: 65373
diff changeset
   951
        $$$(THEORIES) ~!
66970
13857f49d215 clarified ROOT syntax: 'sessions' and 'theories' are optional, but need to be non-empty;
wenzelm
parents: 66969
diff changeset
   952
          ((options | success(Nil)) ~ rep1(theory_entry)) ^^
65374
a5b38d8d3c1e tuned syntax;
wenzelm
parents: 65373
diff changeset
   953
          { case _ ~ (x ~ y) => (x, y) }
62631
c39614ddb80b clarified modules;
wenzelm
parents:
diff changeset
   954
68292
7ca0c23179e6 support 'export_files' in session ROOT;
wenzelm
parents: 68221
diff changeset
   955
      val in_path = $$$("(") ~! ($$$(IN) ~ path ~ $$$(")")) ^^ { case _ ~ (_ ~ x ~ _) => x }
7ca0c23179e6 support 'export_files' in session ROOT;
wenzelm
parents: 68221
diff changeset
   956
62631
c39614ddb80b clarified modules;
wenzelm
parents:
diff changeset
   957
      val document_files =
c39614ddb80b clarified modules;
wenzelm
parents:
diff changeset
   958
        $$$(DOCUMENT_FILES) ~!
68292
7ca0c23179e6 support 'export_files' in session ROOT;
wenzelm
parents: 68221
diff changeset
   959
          ((in_path | success("document")) ~ rep1(path)) ^^ { case _ ~ (x ~ y) => y.map((x, _)) }
7ca0c23179e6 support 'export_files' in session ROOT;
wenzelm
parents: 68221
diff changeset
   960
69671
2486792eaf61 support pruning of export names;
wenzelm
parents: 69560
diff changeset
   961
      val prune = $$$("[") ~! (nat ~ $$$("]")) ^^ { case _ ~ (x ~ _) => x } | success(0)
2486792eaf61 support pruning of export names;
wenzelm
parents: 69560
diff changeset
   962
68292
7ca0c23179e6 support 'export_files' in session ROOT;
wenzelm
parents: 68221
diff changeset
   963
      val export_files =
69671
2486792eaf61 support pruning of export names;
wenzelm
parents: 69560
diff changeset
   964
        $$$(EXPORT_FILES) ~! ((in_path | success("export")) ~ prune ~ rep1(embedded)) ^^
2486792eaf61 support pruning of export names;
wenzelm
parents: 69560
diff changeset
   965
          { case _ ~ (x ~ y ~ z) => (x, y, z) }
62631
c39614ddb80b clarified modules;
wenzelm
parents:
diff changeset
   966
c39614ddb80b clarified modules;
wenzelm
parents:
diff changeset
   967
      command(SESSION) ~!
c39614ddb80b clarified modules;
wenzelm
parents:
diff changeset
   968
        (position(session_name) ~
c39614ddb80b clarified modules;
wenzelm
parents:
diff changeset
   969
          (($$$("(") ~! (rep1(name) <~ $$$(")")) ^^ { case _ ~ x => x }) | success(Nil)) ~
c39614ddb80b clarified modules;
wenzelm
parents:
diff changeset
   970
          (($$$(IN) ~! path ^^ { case _ ~ x => x }) | success(".")) ~
c39614ddb80b clarified modules;
wenzelm
parents:
diff changeset
   971
          ($$$("=") ~!
c39614ddb80b clarified modules;
wenzelm
parents:
diff changeset
   972
            (opt(session_name ~! $$$("+") ^^ { case x ~ _ => x }) ~
c39614ddb80b clarified modules;
wenzelm
parents:
diff changeset
   973
              (($$$(DESCRIPTION) ~! text ^^ { case _ ~ x => x }) | success("")) ~
70668
9cac4dec0da9 support for explicit session directories;
wenzelm
parents: 70650
diff changeset
   974
              (($$$(DIRECTORIES) ~! directories ^^ { case _ ~ x => x }) | success(Nil)) ~
62631
c39614ddb80b clarified modules;
wenzelm
parents:
diff changeset
   975
              (($$$(OPTIONS) ~! options ^^ { case _ ~ x => x }) | success(Nil)) ~
66970
13857f49d215 clarified ROOT syntax: 'sessions' and 'theories' are optional, but need to be non-empty;
wenzelm
parents: 66969
diff changeset
   976
              (($$$(SESSIONS) ~! rep1(session_name)  ^^ { case _ ~ x => x }) | success(Nil)) ~
13857f49d215 clarified ROOT syntax: 'sessions' and 'theories' are optional, but need to be non-empty;
wenzelm
parents: 66969
diff changeset
   977
              rep(theories) ~
68292
7ca0c23179e6 support 'export_files' in session ROOT;
wenzelm
parents: 68221
diff changeset
   978
              (rep(document_files) ^^ (x => x.flatten)) ~
7ca0c23179e6 support 'export_files' in session ROOT;
wenzelm
parents: 68221
diff changeset
   979
              (rep(export_files))))) ^^
70668
9cac4dec0da9 support for explicit session directories;
wenzelm
parents: 70650
diff changeset
   980
        { case _ ~ ((a, pos) ~ b ~ c ~ (_ ~ (d ~ e ~ f ~ g ~ h ~ i ~ j ~ k))) =>
9cac4dec0da9 support for explicit session directories;
wenzelm
parents: 70650
diff changeset
   981
            Session_Entry(pos, a, b, c, d, e, f, g, h, i, j, k) }
62631
c39614ddb80b clarified modules;
wenzelm
parents:
diff changeset
   982
    }
c39614ddb80b clarified modules;
wenzelm
parents:
diff changeset
   983
66819
wenzelm
parents: 66818
diff changeset
   984
    def parse_root(path: Path): List[Entry] =
62631
c39614ddb80b clarified modules;
wenzelm
parents:
diff changeset
   985
    {
66764
006deaf5c3dc process ROOT files only once, which allows duplicate (or overlapping) session root directories;
wenzelm
parents: 66759
diff changeset
   986
      val toks = Token.explode(root_syntax.keywords, File.read(path))
006deaf5c3dc process ROOT files only once, which allows duplicate (or overlapping) session root directories;
wenzelm
parents: 66759
diff changeset
   987
      val start = Token.Pos.file(path.implode)
62631
c39614ddb80b clarified modules;
wenzelm
parents:
diff changeset
   988
66764
006deaf5c3dc process ROOT files only once, which allows duplicate (or overlapping) session root directories;
wenzelm
parents: 66759
diff changeset
   989
      parse_all(rep(chapter | session_entry), Token.reader(toks, start)) match {
66818
5bc903a60932 clarified signature: public access to ROOT file syntax;
wenzelm
parents: 66780
diff changeset
   990
        case Success(result, _) => result
66764
006deaf5c3dc process ROOT files only once, which allows duplicate (or overlapping) session root directories;
wenzelm
parents: 66759
diff changeset
   991
        case bad => error(bad.toString)
62631
c39614ddb80b clarified modules;
wenzelm
parents:
diff changeset
   992
      }
c39614ddb80b clarified modules;
wenzelm
parents:
diff changeset
   993
    }
c39614ddb80b clarified modules;
wenzelm
parents:
diff changeset
   994
  }
c39614ddb80b clarified modules;
wenzelm
parents:
diff changeset
   995
66819
wenzelm
parents: 66818
diff changeset
   996
  def parse_root(path: Path): List[Entry] = Parser.parse_root(path)
wenzelm
parents: 66818
diff changeset
   997
wenzelm
parents: 66818
diff changeset
   998
  def parse_root_entries(path: Path): List[Session_Entry] =
wenzelm
parents: 66818
diff changeset
   999
    for (entry <- Parser.parse_root(path) if entry.isInstanceOf[Session_Entry])
wenzelm
parents: 66818
diff changeset
  1000
    yield entry.asInstanceOf[Session_Entry]
66818
5bc903a60932 clarified signature: public access to ROOT file syntax;
wenzelm
parents: 66780
diff changeset
  1001
66960
d62f1f03868a tuned signature;
wenzelm
parents: 66959
diff changeset
  1002
  def read_root(options: Options, select: Boolean, path: Path): List[Info] =
66818
5bc903a60932 clarified signature: public access to ROOT file syntax;
wenzelm
parents: 66780
diff changeset
  1003
  {
69762
58fb0d779583 support for session information via virtual file-system;
wenzelm
parents: 69671
diff changeset
  1004
    var entry_chapter = UNSORTED
66960
d62f1f03868a tuned signature;
wenzelm
parents: 66959
diff changeset
  1005
    val infos = new mutable.ListBuffer[Info]
66819
wenzelm
parents: 66818
diff changeset
  1006
    parse_root(path).foreach {
66818
5bc903a60932 clarified signature: public access to ROOT file syntax;
wenzelm
parents: 66780
diff changeset
  1007
      case Chapter(name) => entry_chapter = name
66967
e365c91c72a9 synthesize session with all required theories from other session imports;
wenzelm
parents: 66966
diff changeset
  1008
      case entry: Session_Entry =>
e365c91c72a9 synthesize session with all required theories from other session imports;
wenzelm
parents: 66966
diff changeset
  1009
        infos += make_info(options, select, path.dir, entry_chapter, entry)
66818
5bc903a60932 clarified signature: public access to ROOT file syntax;
wenzelm
parents: 66780
diff changeset
  1010
    }
5bc903a60932 clarified signature: public access to ROOT file syntax;
wenzelm
parents: 66780
diff changeset
  1011
    infos.toList
5bc903a60932 clarified signature: public access to ROOT file syntax;
wenzelm
parents: 66780
diff changeset
  1012
  }
5bc903a60932 clarified signature: public access to ROOT file syntax;
wenzelm
parents: 66780
diff changeset
  1013
5bc903a60932 clarified signature: public access to ROOT file syntax;
wenzelm
parents: 66780
diff changeset
  1014
  def parse_roots(roots: Path): List[String] =
5bc903a60932 clarified signature: public access to ROOT file syntax;
wenzelm
parents: 66780
diff changeset
  1015
  {
5bc903a60932 clarified signature: public access to ROOT file syntax;
wenzelm
parents: 66780
diff changeset
  1016
    for {
5bc903a60932 clarified signature: public access to ROOT file syntax;
wenzelm
parents: 66780
diff changeset
  1017
      line <- split_lines(File.read(roots))
5bc903a60932 clarified signature: public access to ROOT file syntax;
wenzelm
parents: 66780
diff changeset
  1018
      if !(line == "" || line.startsWith("#"))
5bc903a60932 clarified signature: public access to ROOT file syntax;
wenzelm
parents: 66780
diff changeset
  1019
    } yield line
5bc903a60932 clarified signature: public access to ROOT file syntax;
wenzelm
parents: 66780
diff changeset
  1020
  }
5bc903a60932 clarified signature: public access to ROOT file syntax;
wenzelm
parents: 66780
diff changeset
  1021
62631
c39614ddb80b clarified modules;
wenzelm
parents:
diff changeset
  1022
62635
4854a38061de tuned signature;
wenzelm
parents: 62633
diff changeset
  1023
  /* load sessions from certain directories */
62631
c39614ddb80b clarified modules;
wenzelm
parents:
diff changeset
  1024
c39614ddb80b clarified modules;
wenzelm
parents:
diff changeset
  1025
  private def is_session_dir(dir: Path): Boolean =
c39614ddb80b clarified modules;
wenzelm
parents:
diff changeset
  1026
    (dir + ROOT).is_file || (dir + ROOTS).is_file
c39614ddb80b clarified modules;
wenzelm
parents:
diff changeset
  1027
c39614ddb80b clarified modules;
wenzelm
parents:
diff changeset
  1028
  private def check_session_dir(dir: Path): Path =
65468
c41791ad75c3 early check and normalization of session directory, e.g. relevant for path information passed to ML process, which may have a different CWD;
wenzelm
parents: 65463
diff changeset
  1029
    if (is_session_dir(dir)) File.pwd() + dir.expand
62631
c39614ddb80b clarified modules;
wenzelm
parents:
diff changeset
  1030
    else error("Bad session root directory: " + dir.toString)
c39614ddb80b clarified modules;
wenzelm
parents:
diff changeset
  1031
65561
741b1d3930c0 support for Mercurial manifest check;
wenzelm
parents: 65560
diff changeset
  1032
  def directories(dirs: List[Path], select_dirs: List[Path]): List[(Boolean, Path)] =
741b1d3930c0 support for Mercurial manifest check;
wenzelm
parents: 65560
diff changeset
  1033
  {
741b1d3930c0 support for Mercurial manifest check;
wenzelm
parents: 65560
diff changeset
  1034
    val default_dirs = Isabelle_System.components().filter(is_session_dir(_))
68746
f95e2f145ea5 canonical session directories in correspondence to Known.files;
wenzelm
parents: 68734
diff changeset
  1035
    for { (select, dir) <- (default_dirs ::: dirs).map((false, _)) ::: select_dirs.map((true, _)) }
f95e2f145ea5 canonical session directories in correspondence to Known.files;
wenzelm
parents: 68734
diff changeset
  1036
    yield (select, dir.canonical)
65561
741b1d3930c0 support for Mercurial manifest check;
wenzelm
parents: 65560
diff changeset
  1037
  }
741b1d3930c0 support for Mercurial manifest check;
wenzelm
parents: 65560
diff changeset
  1038
67026
687c822ee5e3 tuned signature;
wenzelm
parents: 67025
diff changeset
  1039
  def load_structure(options: Options,
66968
9991671c98aa allow to augment session context via explicit session infos;
wenzelm
parents: 66967
diff changeset
  1040
    dirs: List[Path] = Nil,
9991671c98aa allow to augment session context via explicit session infos;
wenzelm
parents: 66967
diff changeset
  1041
    select_dirs: List[Path] = Nil,
67052
caf87d4b9b61 tuned signature;
wenzelm
parents: 67029
diff changeset
  1042
    infos: List[Info] = Nil): Structure =
62631
c39614ddb80b clarified modules;
wenzelm
parents:
diff changeset
  1043
  {
66764
006deaf5c3dc process ROOT files only once, which allows duplicate (or overlapping) session root directories;
wenzelm
parents: 66759
diff changeset
  1044
    def load_dir(select: Boolean, dir: Path): List[(Boolean, Path)] =
62635
4854a38061de tuned signature;
wenzelm
parents: 62633
diff changeset
  1045
      load_root(select, dir) ::: load_roots(select, dir)
62631
c39614ddb80b clarified modules;
wenzelm
parents:
diff changeset
  1046
66764
006deaf5c3dc process ROOT files only once, which allows duplicate (or overlapping) session root directories;
wenzelm
parents: 66759
diff changeset
  1047
    def load_root(select: Boolean, dir: Path): List[(Boolean, Path)] =
006deaf5c3dc process ROOT files only once, which allows duplicate (or overlapping) session root directories;
wenzelm
parents: 66759
diff changeset
  1048
    {
006deaf5c3dc process ROOT files only once, which allows duplicate (or overlapping) session root directories;
wenzelm
parents: 66759
diff changeset
  1049
      val root = dir + ROOT
006deaf5c3dc process ROOT files only once, which allows duplicate (or overlapping) session root directories;
wenzelm
parents: 66759
diff changeset
  1050
      if (root.is_file) List((select, root)) else Nil
006deaf5c3dc process ROOT files only once, which allows duplicate (or overlapping) session root directories;
wenzelm
parents: 66759
diff changeset
  1051
    }
62631
c39614ddb80b clarified modules;
wenzelm
parents:
diff changeset
  1052
66764
006deaf5c3dc process ROOT files only once, which allows duplicate (or overlapping) session root directories;
wenzelm
parents: 66759
diff changeset
  1053
    def load_roots(select: Boolean, dir: Path): List[(Boolean, Path)] =
62631
c39614ddb80b clarified modules;
wenzelm
parents:
diff changeset
  1054
    {
c39614ddb80b clarified modules;
wenzelm
parents:
diff changeset
  1055
      val roots = dir + ROOTS
c39614ddb80b clarified modules;
wenzelm
parents:
diff changeset
  1056
      if (roots.is_file) {
c39614ddb80b clarified modules;
wenzelm
parents:
diff changeset
  1057
        for {
66818
5bc903a60932 clarified signature: public access to ROOT file syntax;
wenzelm
parents: 66780
diff changeset
  1058
          entry <- parse_roots(roots)
62631
c39614ddb80b clarified modules;
wenzelm
parents:
diff changeset
  1059
          dir1 =
66818
5bc903a60932 clarified signature: public access to ROOT file syntax;
wenzelm
parents: 66780
diff changeset
  1060
            try { check_session_dir(dir + Path.explode(entry)) }
62631
c39614ddb80b clarified modules;
wenzelm
parents:
diff changeset
  1061
            catch {
c39614ddb80b clarified modules;
wenzelm
parents:
diff changeset
  1062
              case ERROR(msg) =>
c39614ddb80b clarified modules;
wenzelm
parents:
diff changeset
  1063
                error(msg + "\nThe error(s) above occurred in session catalog " + roots.toString)
c39614ddb80b clarified modules;
wenzelm
parents:
diff changeset
  1064
            }
66764
006deaf5c3dc process ROOT files only once, which allows duplicate (or overlapping) session root directories;
wenzelm
parents: 66759
diff changeset
  1065
          res <- load_dir(select, dir1)
006deaf5c3dc process ROOT files only once, which allows duplicate (or overlapping) session root directories;
wenzelm
parents: 66759
diff changeset
  1066
        } yield res
62631
c39614ddb80b clarified modules;
wenzelm
parents:
diff changeset
  1067
      }
c39614ddb80b clarified modules;
wenzelm
parents:
diff changeset
  1068
      else Nil
c39614ddb80b clarified modules;
wenzelm
parents:
diff changeset
  1069
    }
c39614ddb80b clarified modules;
wenzelm
parents:
diff changeset
  1070
66764
006deaf5c3dc process ROOT files only once, which allows duplicate (or overlapping) session root directories;
wenzelm
parents: 66759
diff changeset
  1071
    val roots =
62631
c39614ddb80b clarified modules;
wenzelm
parents:
diff changeset
  1072
      for {
65561
741b1d3930c0 support for Mercurial manifest check;
wenzelm
parents: 65560
diff changeset
  1073
        (select, dir) <- directories(dirs, select_dirs)
66764
006deaf5c3dc process ROOT files only once, which allows duplicate (or overlapping) session root directories;
wenzelm
parents: 66759
diff changeset
  1074
        res <- load_dir(select, check_session_dir(dir))
006deaf5c3dc process ROOT files only once, which allows duplicate (or overlapping) session root directories;
wenzelm
parents: 66759
diff changeset
  1075
      } yield res
006deaf5c3dc process ROOT files only once, which allows duplicate (or overlapping) session root directories;
wenzelm
parents: 66759
diff changeset
  1076
006deaf5c3dc process ROOT files only once, which allows duplicate (or overlapping) session root directories;
wenzelm
parents: 66759
diff changeset
  1077
    val unique_roots =
006deaf5c3dc process ROOT files only once, which allows duplicate (or overlapping) session root directories;
wenzelm
parents: 66759
diff changeset
  1078
      ((Map.empty[JFile, (Boolean, Path)] /: roots) { case (m, (select, path)) =>
006deaf5c3dc process ROOT files only once, which allows duplicate (or overlapping) session root directories;
wenzelm
parents: 66759
diff changeset
  1079
        val file = path.canonical_file
006deaf5c3dc process ROOT files only once, which allows duplicate (or overlapping) session root directories;
wenzelm
parents: 66759
diff changeset
  1080
        m.get(file) match {
006deaf5c3dc process ROOT files only once, which allows duplicate (or overlapping) session root directories;
wenzelm
parents: 66759
diff changeset
  1081
          case None => m + (file -> (select, path))
006deaf5c3dc process ROOT files only once, which allows duplicate (or overlapping) session root directories;
wenzelm
parents: 66759
diff changeset
  1082
          case Some((select1, path1)) => m + (file -> (select1 || select, path1))
006deaf5c3dc process ROOT files only once, which allows duplicate (or overlapping) session root directories;
wenzelm
parents: 66759
diff changeset
  1083
        }
006deaf5c3dc process ROOT files only once, which allows duplicate (or overlapping) session root directories;
wenzelm
parents: 66759
diff changeset
  1084
      }).toList.map(_._2)
006deaf5c3dc process ROOT files only once, which allows duplicate (or overlapping) session root directories;
wenzelm
parents: 66759
diff changeset
  1085
66968
9991671c98aa allow to augment session context via explicit session infos;
wenzelm
parents: 66967
diff changeset
  1086
    make(unique_roots.flatMap(p => read_root(options, p._1, p._2)) ::: infos)
62631
c39614ddb80b clarified modules;
wenzelm
parents:
diff changeset
  1087
  }
62632
cd991ba01ffd clarified modules;
wenzelm
parents: 62631
diff changeset
  1088
cd991ba01ffd clarified modules;
wenzelm
parents: 62631
diff changeset
  1089
62637
0189fe0f6452 support for Poly/ML heap hierarchy, which saves a lot of disk space;
wenzelm
parents: 62636
diff changeset
  1090
62704
478b49f0d726 proper SHA1 digest as annex to heap file: Poly/ML reads precise segment length;
wenzelm
parents: 62637
diff changeset
  1091
  /** heap file with SHA1 digest **/
478b49f0d726 proper SHA1 digest as annex to heap file: Poly/ML reads precise segment length;
wenzelm
parents: 62637
diff changeset
  1092
478b49f0d726 proper SHA1 digest as annex to heap file: Poly/ML reads precise segment length;
wenzelm
parents: 62637
diff changeset
  1093
  private val sha1_prefix = "SHA1:"
478b49f0d726 proper SHA1 digest as annex to heap file: Poly/ML reads precise segment length;
wenzelm
parents: 62637
diff changeset
  1094
478b49f0d726 proper SHA1 digest as annex to heap file: Poly/ML reads precise segment length;
wenzelm
parents: 62637
diff changeset
  1095
  def read_heap_digest(heap: Path): Option[String] =
478b49f0d726 proper SHA1 digest as annex to heap file: Poly/ML reads precise segment length;
wenzelm
parents: 62637
diff changeset
  1096
  {
478b49f0d726 proper SHA1 digest as annex to heap file: Poly/ML reads precise segment length;
wenzelm
parents: 62637
diff changeset
  1097
    if (heap.is_file) {
69393
ed0824ef337e static type for Library.using: avoid Java 11 warnings on "Illegal reflective access";
wenzelm
parents: 69366
diff changeset
  1098
      using(FileChannel.open(heap.file.toPath, StandardOpenOption.READ))(file =>
ed0824ef337e static type for Library.using: avoid Java 11 warnings on "Illegal reflective access";
wenzelm
parents: 69366
diff changeset
  1099
      {
62704
478b49f0d726 proper SHA1 digest as annex to heap file: Poly/ML reads precise segment length;
wenzelm
parents: 62637
diff changeset
  1100
        val len = file.size
478b49f0d726 proper SHA1 digest as annex to heap file: Poly/ML reads precise segment length;
wenzelm
parents: 62637
diff changeset
  1101
        val n = sha1_prefix.length + SHA1.digest_length
478b49f0d726 proper SHA1 digest as annex to heap file: Poly/ML reads precise segment length;
wenzelm
parents: 62637
diff changeset
  1102
        if (len >= n) {
478b49f0d726 proper SHA1 digest as annex to heap file: Poly/ML reads precise segment length;
wenzelm
parents: 62637
diff changeset
  1103
          file.position(len - n)
478b49f0d726 proper SHA1 digest as annex to heap file: Poly/ML reads precise segment length;
wenzelm
parents: 62637
diff changeset
  1104
478b49f0d726 proper SHA1 digest as annex to heap file: Poly/ML reads precise segment length;
wenzelm
parents: 62637
diff changeset
  1105
          val buf = ByteBuffer.allocate(n)
478b49f0d726 proper SHA1 digest as annex to heap file: Poly/ML reads precise segment length;
wenzelm
parents: 62637
diff changeset
  1106
          var i = 0
478b49f0d726 proper SHA1 digest as annex to heap file: Poly/ML reads precise segment length;
wenzelm
parents: 62637
diff changeset
  1107
          var m = 0
478b49f0d726 proper SHA1 digest as annex to heap file: Poly/ML reads precise segment length;
wenzelm
parents: 62637
diff changeset
  1108
          do {
478b49f0d726 proper SHA1 digest as annex to heap file: Poly/ML reads precise segment length;
wenzelm
parents: 62637
diff changeset
  1109
            m = file.read(buf)
478b49f0d726 proper SHA1 digest as annex to heap file: Poly/ML reads precise segment length;
wenzelm
parents: 62637
diff changeset
  1110
            if (m != -1) i += m
478b49f0d726 proper SHA1 digest as annex to heap file: Poly/ML reads precise segment length;
wenzelm
parents: 62637
diff changeset
  1111
          }
478b49f0d726 proper SHA1 digest as annex to heap file: Poly/ML reads precise segment length;
wenzelm
parents: 62637
diff changeset
  1112
          while (m != -1 && n > i)
478b49f0d726 proper SHA1 digest as annex to heap file: Poly/ML reads precise segment length;
wenzelm
parents: 62637
diff changeset
  1113
478b49f0d726 proper SHA1 digest as annex to heap file: Poly/ML reads precise segment length;
wenzelm
parents: 62637
diff changeset
  1114
          if (i == n) {
478b49f0d726 proper SHA1 digest as annex to heap file: Poly/ML reads precise segment length;
wenzelm
parents: 62637
diff changeset
  1115
            val prefix = new String(buf.array(), 0, sha1_prefix.length, UTF8.charset)
478b49f0d726 proper SHA1 digest as annex to heap file: Poly/ML reads precise segment length;
wenzelm
parents: 62637
diff changeset
  1116
            val s = new String(buf.array(), sha1_prefix.length, SHA1.digest_length, UTF8.charset)
478b49f0d726 proper SHA1 digest as annex to heap file: Poly/ML reads precise segment length;
wenzelm
parents: 62637
diff changeset
  1117
            if (prefix == sha1_prefix) Some(s) else None
478b49f0d726 proper SHA1 digest as annex to heap file: Poly/ML reads precise segment length;
wenzelm
parents: 62637
diff changeset
  1118
          }
478b49f0d726 proper SHA1 digest as annex to heap file: Poly/ML reads precise segment length;
wenzelm
parents: 62637
diff changeset
  1119
          else None
478b49f0d726 proper SHA1 digest as annex to heap file: Poly/ML reads precise segment length;
wenzelm
parents: 62637
diff changeset
  1120
        }
478b49f0d726 proper SHA1 digest as annex to heap file: Poly/ML reads precise segment length;
wenzelm
parents: 62637
diff changeset
  1121
        else None
69393
ed0824ef337e static type for Library.using: avoid Java 11 warnings on "Illegal reflective access";
wenzelm
parents: 69366
diff changeset
  1122
      })
62704
478b49f0d726 proper SHA1 digest as annex to heap file: Poly/ML reads precise segment length;
wenzelm
parents: 62637
diff changeset
  1123
    }
478b49f0d726 proper SHA1 digest as annex to heap file: Poly/ML reads precise segment length;
wenzelm
parents: 62637
diff changeset
  1124
    else None
478b49f0d726 proper SHA1 digest as annex to heap file: Poly/ML reads precise segment length;
wenzelm
parents: 62637
diff changeset
  1125
  }
478b49f0d726 proper SHA1 digest as annex to heap file: Poly/ML reads precise segment length;
wenzelm
parents: 62637
diff changeset
  1126
478b49f0d726 proper SHA1 digest as annex to heap file: Poly/ML reads precise segment length;
wenzelm
parents: 62637
diff changeset
  1127
  def write_heap_digest(heap: Path): String =
478b49f0d726 proper SHA1 digest as annex to heap file: Poly/ML reads precise segment length;
wenzelm
parents: 62637
diff changeset
  1128
    read_heap_digest(heap) match {
478b49f0d726 proper SHA1 digest as annex to heap file: Poly/ML reads precise segment length;
wenzelm
parents: 62637
diff changeset
  1129
      case None =>
478b49f0d726 proper SHA1 digest as annex to heap file: Poly/ML reads precise segment length;
wenzelm
parents: 62637
diff changeset
  1130
        val s = SHA1.digest(heap).rep
478b49f0d726 proper SHA1 digest as annex to heap file: Poly/ML reads precise segment length;
wenzelm
parents: 62637
diff changeset
  1131
        File.append(heap, sha1_prefix + s)
478b49f0d726 proper SHA1 digest as annex to heap file: Poly/ML reads precise segment length;
wenzelm
parents: 62637
diff changeset
  1132
        s
478b49f0d726 proper SHA1 digest as annex to heap file: Poly/ML reads precise segment length;
wenzelm
parents: 62637
diff changeset
  1133
      case Some(s) => s
478b49f0d726 proper SHA1 digest as annex to heap file: Poly/ML reads precise segment length;
wenzelm
parents: 62637
diff changeset
  1134
    }
478b49f0d726 proper SHA1 digest as annex to heap file: Poly/ML reads precise segment length;
wenzelm
parents: 62637
diff changeset
  1135
478b49f0d726 proper SHA1 digest as annex to heap file: Poly/ML reads precise segment length;
wenzelm
parents: 62637
diff changeset
  1136
478b49f0d726 proper SHA1 digest as annex to heap file: Poly/ML reads precise segment length;
wenzelm
parents: 62637
diff changeset
  1137
62637
0189fe0f6452 support for Poly/ML heap hierarchy, which saves a lot of disk space;
wenzelm
parents: 62636
diff changeset
  1138
  /** persistent store **/
62632
cd991ba01ffd clarified modules;
wenzelm
parents: 62631
diff changeset
  1139
65296
a71db30f3b2d tuned signature;
wenzelm
parents: 65295
diff changeset
  1140
  object Session_Info
a71db30f3b2d tuned signature;
wenzelm
parents: 65295
diff changeset
  1141
  {
66857
f8f42289c4df tuned signature;
wenzelm
parents: 66848
diff changeset
  1142
    val session_name = SQL.Column.string("session_name").make_primary_key
65326
cb7cb57c7ce1 proper primary key;
wenzelm
parents: 65324
diff changeset
  1143
65296
a71db30f3b2d tuned signature;
wenzelm
parents: 65295
diff changeset
  1144
    // Build_Log.Session_Info
a71db30f3b2d tuned signature;
wenzelm
parents: 65295
diff changeset
  1145
    val session_timing = SQL.Column.bytes("session_timing")
a71db30f3b2d tuned signature;
wenzelm
parents: 65295
diff changeset
  1146
    val command_timings = SQL.Column.bytes("command_timings")
66873
9953ae603a23 provide theory timing information, similar to command timing but always considered relevant;
wenzelm
parents: 66857
diff changeset
  1147
    val theory_timings = SQL.Column.bytes("theory_timings")
65296
a71db30f3b2d tuned signature;
wenzelm
parents: 65295
diff changeset
  1148
    val ml_statistics = SQL.Column.bytes("ml_statistics")
a71db30f3b2d tuned signature;
wenzelm
parents: 65295
diff changeset
  1149
    val task_statistics = SQL.Column.bytes("task_statistics")
65934
5f202ba9f590 store errors in build db;
wenzelm
parents: 65857
diff changeset
  1150
    val errors = SQL.Column.bytes("errors")
65296
a71db30f3b2d tuned signature;
wenzelm
parents: 65295
diff changeset
  1151
    val build_log_columns =
66873
9953ae603a23 provide theory timing information, similar to command timing but always considered relevant;
wenzelm
parents: 66857
diff changeset
  1152
      List(session_name, session_timing, command_timings, theory_timings,
9953ae603a23 provide theory timing information, similar to command timing but always considered relevant;
wenzelm
parents: 66857
diff changeset
  1153
        ml_statistics, task_statistics, errors)
65296
a71db30f3b2d tuned signature;
wenzelm
parents: 65295
diff changeset
  1154
a71db30f3b2d tuned signature;
wenzelm
parents: 65295
diff changeset
  1155
    // Build.Session_Info
a71db30f3b2d tuned signature;
wenzelm
parents: 65295
diff changeset
  1156
    val sources = SQL.Column.string("sources")
a71db30f3b2d tuned signature;
wenzelm
parents: 65295
diff changeset
  1157
    val input_heaps = SQL.Column.string("input_heaps")
a71db30f3b2d tuned signature;
wenzelm
parents: 65295
diff changeset
  1158
    val output_heap = SQL.Column.string("output_heap")
a71db30f3b2d tuned signature;
wenzelm
parents: 65295
diff changeset
  1159
    val return_code = SQL.Column.int("return_code")
66746
888a51e77c6e sources_stamp refers to full sources;
wenzelm
parents: 66744
diff changeset
  1160
    val build_columns = List(sources, input_heaps, output_heap, return_code)
65296
a71db30f3b2d tuned signature;
wenzelm
parents: 65295
diff changeset
  1161
a71db30f3b2d tuned signature;
wenzelm
parents: 65295
diff changeset
  1162
    val table = SQL.Table("isabelle_session_info", build_log_columns ::: build_columns)
a71db30f3b2d tuned signature;
wenzelm
parents: 65295
diff changeset
  1163
  }
a71db30f3b2d tuned signature;
wenzelm
parents: 65295
diff changeset
  1164
69854
cc0b3e177b49 system option "system_heaps" supersedes various command-line options for "system build mode";
wenzelm
parents: 69812
diff changeset
  1165
  def store(options: Options): Store = new Store(options)
62632
cd991ba01ffd clarified modules;
wenzelm
parents: 62631
diff changeset
  1166
69854
cc0b3e177b49 system option "system_heaps" supersedes various command-line options for "system build mode";
wenzelm
parents: 69812
diff changeset
  1167
  class Store private[Sessions](val options: Options)
62632
cd991ba01ffd clarified modules;
wenzelm
parents: 62631
diff changeset
  1168
  {
68219
c0341c0080e2 clarified store directories;
wenzelm
parents: 68218
diff changeset
  1169
    override def toString: String = "Store(output_dir = " + output_dir.expand + ")"
c0341c0080e2 clarified store directories;
wenzelm
parents: 68218
diff changeset
  1170
c0341c0080e2 clarified store directories;
wenzelm
parents: 68218
diff changeset
  1171
c0341c0080e2 clarified store directories;
wenzelm
parents: 68218
diff changeset
  1172
    /* directories */
c0341c0080e2 clarified store directories;
wenzelm
parents: 68218
diff changeset
  1173
68523
ccacc84e0251 clarified settings -- avoid hard-wired directories;
wenzelm
parents: 68483
diff changeset
  1174
    val system_output_dir: Path = Path.explode("$ISABELLE_HEAPS_SYSTEM/$ML_IDENTIFIER")
ccacc84e0251 clarified settings -- avoid hard-wired directories;
wenzelm
parents: 68483
diff changeset
  1175
    val user_output_dir: Path = Path.explode("$ISABELLE_HEAPS/$ML_IDENTIFIER")
68219
c0341c0080e2 clarified store directories;
wenzelm
parents: 68218
diff changeset
  1176
69854
cc0b3e177b49 system option "system_heaps" supersedes various command-line options for "system build mode";
wenzelm
parents: 69812
diff changeset
  1177
    def system_heaps: Boolean = options.bool("system_heaps")
cc0b3e177b49 system option "system_heaps" supersedes various command-line options for "system build mode";
wenzelm
parents: 69812
diff changeset
  1178
68221
dbef88c2b6c5 support for build_database_server (PostgreSQL);
wenzelm
parents: 68220
diff changeset
  1179
    val output_dir: Path =
69854
cc0b3e177b49 system option "system_heaps" supersedes various command-line options for "system build mode";
wenzelm
parents: 69812
diff changeset
  1180
      if (system_heaps) system_output_dir else user_output_dir
68219
c0341c0080e2 clarified store directories;
wenzelm
parents: 68218
diff changeset
  1181
68221
dbef88c2b6c5 support for build_database_server (PostgreSQL);
wenzelm
parents: 68220
diff changeset
  1182
    val input_dirs: List[Path] =
69854
cc0b3e177b49 system option "system_heaps" supersedes various command-line options for "system build mode";
wenzelm
parents: 69812
diff changeset
  1183
      if (system_heaps) List(system_output_dir)
68219
c0341c0080e2 clarified store directories;
wenzelm
parents: 68218
diff changeset
  1184
      else List(user_output_dir, system_output_dir)
62632
cd991ba01ffd clarified modules;
wenzelm
parents: 62631
diff changeset
  1185
cd991ba01ffd clarified modules;
wenzelm
parents: 62631
diff changeset
  1186
    val browser_info: Path =
69854
cc0b3e177b49 system option "system_heaps" supersedes various command-line options for "system build mode";
wenzelm
parents: 69812
diff changeset
  1187
      if (system_heaps) Path.explode("$ISABELLE_BROWSER_INFO_SYSTEM")
62632
cd991ba01ffd clarified modules;
wenzelm
parents: 62631
diff changeset
  1188
      else Path.explode("$ISABELLE_BROWSER_INFO")
cd991ba01ffd clarified modules;
wenzelm
parents: 62631
diff changeset
  1189
62637
0189fe0f6452 support for Poly/ML heap hierarchy, which saves a lot of disk space;
wenzelm
parents: 62636
diff changeset
  1190
68221
dbef88c2b6c5 support for build_database_server (PostgreSQL);
wenzelm
parents: 68220
diff changeset
  1191
    /* file names */
65298
wenzelm
parents: 65297
diff changeset
  1192
68221
dbef88c2b6c5 support for build_database_server (PostgreSQL);
wenzelm
parents: 68220
diff changeset
  1193
    def heap(name: String): Path = Path.basic(name)
dbef88c2b6c5 support for build_database_server (PostgreSQL);
wenzelm
parents: 68220
diff changeset
  1194
    def database(name: String): Path = Path.basic("log") + Path.basic(name).ext("db")
dbef88c2b6c5 support for build_database_server (PostgreSQL);
wenzelm
parents: 68220
diff changeset
  1195
    def log(name: String): Path = Path.basic("log") + Path.basic(name)
dbef88c2b6c5 support for build_database_server (PostgreSQL);
wenzelm
parents: 68220
diff changeset
  1196
    def log_gz(name: String): Path = log(name).ext("gz")
62637
0189fe0f6452 support for Poly/ML heap hierarchy, which saves a lot of disk space;
wenzelm
parents: 62636
diff changeset
  1197
68221
dbef88c2b6c5 support for build_database_server (PostgreSQL);
wenzelm
parents: 68220
diff changeset
  1198
    def output_heap(name: String): Path = output_dir + heap(name)
dbef88c2b6c5 support for build_database_server (PostgreSQL);
wenzelm
parents: 68220
diff changeset
  1199
    def output_database(name: String): Path = output_dir + database(name)
68086
9e1c670301b8 cleanup session output before starting build job;
wenzelm
parents: 68018
diff changeset
  1200
    def output_log(name: String): Path = output_dir + log(name)
9e1c670301b8 cleanup session output before starting build job;
wenzelm
parents: 68018
diff changeset
  1201
    def output_log_gz(name: String): Path = output_dir + log_gz(name)
9e1c670301b8 cleanup session output before starting build job;
wenzelm
parents: 68018
diff changeset
  1202
68221
dbef88c2b6c5 support for build_database_server (PostgreSQL);
wenzelm
parents: 68220
diff changeset
  1203
    def prepare_output_dir() { Isabelle_System.mkdirs(output_dir + Path.basic("log")) }
68220
8fc4e3d1df86 clarified store.clean_output: cleanup user_output_dir even in system_mode;
wenzelm
parents: 68219
diff changeset
  1204
62637
0189fe0f6452 support for Poly/ML heap hierarchy, which saves a lot of disk space;
wenzelm
parents: 62636
diff changeset
  1205
68221
dbef88c2b6c5 support for build_database_server (PostgreSQL);
wenzelm
parents: 68220
diff changeset
  1206
    /* heap */
62637
0189fe0f6452 support for Poly/ML heap hierarchy, which saves a lot of disk space;
wenzelm
parents: 62636
diff changeset
  1207
68212
5a59fded83c7 clarified heap vs. database operations: discontinued correlation of directory;
wenzelm
parents: 68210
diff changeset
  1208
    def find_heap(name: String): Option[Path] =
68221
dbef88c2b6c5 support for build_database_server (PostgreSQL);
wenzelm
parents: 68220
diff changeset
  1209
      input_dirs.map(_ + heap(name)).find(_.is_file)
68212
5a59fded83c7 clarified heap vs. database operations: discontinued correlation of directory;
wenzelm
parents: 68210
diff changeset
  1210
5a59fded83c7 clarified heap vs. database operations: discontinued correlation of directory;
wenzelm
parents: 68210
diff changeset
  1211
    def find_heap_digest(name: String): Option[String] =
5a59fded83c7 clarified heap vs. database operations: discontinued correlation of directory;
wenzelm
parents: 68210
diff changeset
  1212
      find_heap(name).flatMap(read_heap_digest(_))
62632
cd991ba01ffd clarified modules;
wenzelm
parents: 62631
diff changeset
  1213
68221
dbef88c2b6c5 support for build_database_server (PostgreSQL);
wenzelm
parents: 68220
diff changeset
  1214
    def the_heap(name: String): Path =
dbef88c2b6c5 support for build_database_server (PostgreSQL);
wenzelm
parents: 68220
diff changeset
  1215
      find_heap(name) getOrElse
dbef88c2b6c5 support for build_database_server (PostgreSQL);
wenzelm
parents: 68220
diff changeset
  1216
        error("Missing heap image for session " + quote(name) + " -- expected in:\n" +
dbef88c2b6c5 support for build_database_server (PostgreSQL);
wenzelm
parents: 68220
diff changeset
  1217
          cat_lines(input_dirs.map(dir => "  " + dir.expand.implode)))
dbef88c2b6c5 support for build_database_server (PostgreSQL);
wenzelm
parents: 68220
diff changeset
  1218
dbef88c2b6c5 support for build_database_server (PostgreSQL);
wenzelm
parents: 68220
diff changeset
  1219
dbef88c2b6c5 support for build_database_server (PostgreSQL);
wenzelm
parents: 68220
diff changeset
  1220
    /* database */
dbef88c2b6c5 support for build_database_server (PostgreSQL);
wenzelm
parents: 68220
diff changeset
  1221
dbef88c2b6c5 support for build_database_server (PostgreSQL);
wenzelm
parents: 68220
diff changeset
  1222
    private def database_server: Boolean = options.bool("build_database_server")
65281
c70e7d24a16d SQL database operations for combined session info;
wenzelm
parents: 65278
diff changeset
  1223
68221
dbef88c2b6c5 support for build_database_server (PostgreSQL);
wenzelm
parents: 68220
diff changeset
  1224
    def access_database(name: String, output: Boolean = false): Option[SQL.Database] =
dbef88c2b6c5 support for build_database_server (PostgreSQL);
wenzelm
parents: 68220
diff changeset
  1225
    {
dbef88c2b6c5 support for build_database_server (PostgreSQL);
wenzelm
parents: 68220
diff changeset
  1226
      if (database_server) {
dbef88c2b6c5 support for build_database_server (PostgreSQL);
wenzelm
parents: 68220
diff changeset
  1227
        val db =
dbef88c2b6c5 support for build_database_server (PostgreSQL);
wenzelm
parents: 68220
diff changeset
  1228
          PostgreSQL.open_database(
dbef88c2b6c5 support for build_database_server (PostgreSQL);
wenzelm
parents: 68220
diff changeset
  1229
            user = options.string("build_database_user"),
dbef88c2b6c5 support for build_database_server (PostgreSQL);
wenzelm
parents: 68220
diff changeset
  1230
            password = options.string("build_database_password"),
dbef88c2b6c5 support for build_database_server (PostgreSQL);
wenzelm
parents: 68220
diff changeset
  1231
            database = options.string("build_database_name"),
dbef88c2b6c5 support for build_database_server (PostgreSQL);
wenzelm
parents: 68220
diff changeset
  1232
            host = options.string("build_database_host"),
dbef88c2b6c5 support for build_database_server (PostgreSQL);
wenzelm
parents: 68220
diff changeset
  1233
            port = options.int("build_database_port"),
dbef88c2b6c5 support for build_database_server (PostgreSQL);
wenzelm
parents: 68220
diff changeset
  1234
            ssh =
69074
787f3db8e313 tuned signature;
wenzelm
parents: 69026
diff changeset
  1235
              options.proper_string("build_database_ssh_host").map(ssh_host =>
68221
dbef88c2b6c5 support for build_database_server (PostgreSQL);
wenzelm
parents: 68220
diff changeset
  1236
                SSH.open_session(options,
dbef88c2b6c5 support for build_database_server (PostgreSQL);
wenzelm
parents: 68220
diff changeset
  1237
                  host = ssh_host,
dbef88c2b6c5 support for build_database_server (PostgreSQL);
wenzelm
parents: 68220
diff changeset
  1238
                  user = options.string("build_database_ssh_user"),
dbef88c2b6c5 support for build_database_server (PostgreSQL);
wenzelm
parents: 68220
diff changeset
  1239
                  port = options.int("build_database_ssh_port"))),
dbef88c2b6c5 support for build_database_server (PostgreSQL);
wenzelm
parents: 68220
diff changeset
  1240
            ssh_close = true)
dbef88c2b6c5 support for build_database_server (PostgreSQL);
wenzelm
parents: 68220
diff changeset
  1241
        if (output || has_session_info(db, name)) Some(db) else { db.close; None }
dbef88c2b6c5 support for build_database_server (PostgreSQL);
wenzelm
parents: 68220
diff changeset
  1242
      }
dbef88c2b6c5 support for build_database_server (PostgreSQL);
wenzelm
parents: 68220
diff changeset
  1243
      else if (output) Some(SQLite.open_database(output_database(name)))
dbef88c2b6c5 support for build_database_server (PostgreSQL);
wenzelm
parents: 68220
diff changeset
  1244
      else input_dirs.map(_ + database(name)).find(_.is_file).map(SQLite.open_database(_))
dbef88c2b6c5 support for build_database_server (PostgreSQL);
wenzelm
parents: 68220
diff changeset
  1245
    }
68212
5a59fded83c7 clarified heap vs. database operations: discontinued correlation of directory;
wenzelm
parents: 68210
diff changeset
  1246
68221
dbef88c2b6c5 support for build_database_server (PostgreSQL);
wenzelm
parents: 68220
diff changeset
  1247
    def open_database(name: String, output: Boolean = false): SQL.Database =
dbef88c2b6c5 support for build_database_server (PostgreSQL);
wenzelm
parents: 68220
diff changeset
  1248
      access_database(name, output = output) getOrElse
dbef88c2b6c5 support for build_database_server (PostgreSQL);
wenzelm
parents: 68220
diff changeset
  1249
        error("Missing build database for session " + quote(name))
68205
9a8949f71fd4 tuned signature;
wenzelm
parents: 68204
diff changeset
  1250
68221
dbef88c2b6c5 support for build_database_server (PostgreSQL);
wenzelm
parents: 68220
diff changeset
  1251
    def clean_output(name: String): (Boolean, Boolean) =
dbef88c2b6c5 support for build_database_server (PostgreSQL);
wenzelm
parents: 68220
diff changeset
  1252
    {
dbef88c2b6c5 support for build_database_server (PostgreSQL);
wenzelm
parents: 68220
diff changeset
  1253
      val relevant_db =
dbef88c2b6c5 support for build_database_server (PostgreSQL);
wenzelm
parents: 68220
diff changeset
  1254
        database_server &&
dbef88c2b6c5 support for build_database_server (PostgreSQL);
wenzelm
parents: 68220
diff changeset
  1255
        {
dbef88c2b6c5 support for build_database_server (PostgreSQL);
wenzelm
parents: 68220
diff changeset
  1256
          access_database(name) match {
dbef88c2b6c5 support for build_database_server (PostgreSQL);
wenzelm
parents: 68220
diff changeset
  1257
            case Some(db) =>
dbef88c2b6c5 support for build_database_server (PostgreSQL);
wenzelm
parents: 68220
diff changeset
  1258
              try {