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