src/Pure/Thy/sessions.scala
author wenzelm
Mon, 04 Jan 2021 13:23:51 +0100
changeset 73042 22f5a6283477
parent 73033 d2690444c00a
child 73310 6e155bb1516d
permissions -rw-r--r--
tuned signature;
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
72837
2c26c283f3ee PIDE support for session ROOTS;
wenzelm
parents: 72832
diff changeset
    22
  val ROOTS: Path = Path.explode("ROOTS")
72832
03803bbfdca3 tuned signature;
wenzelm
parents: 72816
diff changeset
    23
  val ROOT: Path = Path.explode("ROOT")
03803bbfdca3 tuned signature;
wenzelm
parents: 72816
diff changeset
    24
72837
2c26c283f3ee PIDE support for session ROOTS;
wenzelm
parents: 72832
diff changeset
    25
  val roots_name: String = "ROOTS"
67215
03d0c958d65a PIDE markup for session ROOT files;
wenzelm
parents: 67210
diff changeset
    26
  val root_name: String = "ROOT"
03d0c958d65a PIDE markup for session ROOT files;
wenzelm
parents: 67210
diff changeset
    27
  val theory_name: String = "Pure.Sessions"
03d0c958d65a PIDE markup for session ROOT files;
wenzelm
parents: 67210
diff changeset
    28
69762
58fb0d779583 support for session information via virtual file-system;
wenzelm
parents: 69671
diff changeset
    29
  val UNSORTED = "Unsorted"
65445
e9e7f5f5794c more qualifier treatment, but in the end it is still ignored;
wenzelm
parents: 65441
diff changeset
    30
  val DRAFT = "Draft"
e9e7f5f5794c more qualifier treatment, but in the end it is still ignored;
wenzelm
parents: 65441
diff changeset
    31
65360
wenzelm
parents: 65359
diff changeset
    32
  def is_pure(name: String): Boolean = name == Thy_Header.PURE
64856
5e9bf964510a clarified modules;
wenzelm
parents: 63996
diff changeset
    33
67284
0094d938c53b tuned signature;
wenzelm
parents: 67219
diff changeset
    34
0094d938c53b tuned signature;
wenzelm
parents: 67219
diff changeset
    35
  def exclude_session(name: String): Boolean = name == "" || name == DRAFT
0094d938c53b tuned signature;
wenzelm
parents: 67219
diff changeset
    36
67286
417e081322ae avoid clash with special files in HTML output;
wenzelm
parents: 67284
diff changeset
    37
  def exclude_theory(name: String): Boolean =
67290
98b6cd12f963 implicit thy_load context for bibtex files;
wenzelm
parents: 67286
diff changeset
    38
    name == root_name || name == "README" || name == "index" || name == "bib"
67284
0094d938c53b tuned signature;
wenzelm
parents: 67219
diff changeset
    39
0094d938c53b tuned signature;
wenzelm
parents: 67219
diff changeset
    40
72837
2c26c283f3ee PIDE support for session ROOTS;
wenzelm
parents: 72832
diff changeset
    41
  /* ROOTS file format */
2c26c283f3ee PIDE support for session ROOTS;
wenzelm
parents: 72832
diff changeset
    42
2c26c283f3ee PIDE support for session ROOTS;
wenzelm
parents: 72832
diff changeset
    43
  class File_Format extends isabelle.File_Format
2c26c283f3ee PIDE support for session ROOTS;
wenzelm
parents: 72832
diff changeset
    44
  {
2c26c283f3ee PIDE support for session ROOTS;
wenzelm
parents: 72832
diff changeset
    45
    val format_name: String = roots_name
2c26c283f3ee PIDE support for session ROOTS;
wenzelm
parents: 72832
diff changeset
    46
    val file_ext = ""
72839
a597300290de clarified File_Format.detect: needs to operate on full node name;
wenzelm
parents: 72837
diff changeset
    47
a597300290de clarified File_Format.detect: needs to operate on full node name;
wenzelm
parents: 72837
diff changeset
    48
    override def detect(name: String): Boolean =
a597300290de clarified File_Format.detect: needs to operate on full node name;
wenzelm
parents: 72837
diff changeset
    49
      Thy_Header.split_file_name(name) match {
a597300290de clarified File_Format.detect: needs to operate on full node name;
wenzelm
parents: 72837
diff changeset
    50
        case Some((_, file_name)) => file_name == roots_name
a597300290de clarified File_Format.detect: needs to operate on full node name;
wenzelm
parents: 72837
diff changeset
    51
        case None => false
a597300290de clarified File_Format.detect: needs to operate on full node name;
wenzelm
parents: 72837
diff changeset
    52
      }
72837
2c26c283f3ee PIDE support for session ROOTS;
wenzelm
parents: 72832
diff changeset
    53
2c26c283f3ee PIDE support for session ROOTS;
wenzelm
parents: 72832
diff changeset
    54
    override def theory_suffix: String = "ROOTS_file"
2c26c283f3ee PIDE support for session ROOTS;
wenzelm
parents: 72832
diff changeset
    55
    override def theory_content(name: String): String =
2c26c283f3ee PIDE support for session ROOTS;
wenzelm
parents: 72832
diff changeset
    56
      """theory "ROOTS" imports Pure begin ROOTS_file """ +
2c26c283f3ee PIDE support for session ROOTS;
wenzelm
parents: 72832
diff changeset
    57
        Outer_Syntax.quote_string(name) + """ end"""
2c26c283f3ee PIDE support for session ROOTS;
wenzelm
parents: 72832
diff changeset
    58
  }
2c26c283f3ee PIDE support for session ROOTS;
wenzelm
parents: 72832
diff changeset
    59
2c26c283f3ee PIDE support for session ROOTS;
wenzelm
parents: 72832
diff changeset
    60
67284
0094d938c53b tuned signature;
wenzelm
parents: 67219
diff changeset
    61
  /* base info and source dependencies */
0094d938c53b tuned signature;
wenzelm
parents: 67219
diff changeset
    62
65495
60d4fbed2b1f tuned signature;
wenzelm
parents: 65490
diff changeset
    63
  sealed case class Base(
66571
0fdeb24e535e clarified errors;
wenzelm
parents: 66243
diff changeset
    64
    pos: Position.T = Position.none,
70681
a6c0f2d106c8 disallow overlapping session directories;
wenzelm
parents: 70679
diff changeset
    65
    session_directories: Map[JFile, String] = Map.empty,
65495
60d4fbed2b1f tuned signature;
wenzelm
parents: 65490
diff changeset
    66
    global_theories: Map[String, String] = Map.empty,
72323
e36f94e2eb6b some support for document preparation in Isabelle/Scala;
wenzelm
parents: 72068
diff changeset
    67
    session_theories: List[Document.Node.Name] = Nil,
72600
2fa4f25d9d07 official support for document theories from other sessions;
wenzelm
parents: 72574
diff changeset
    68
    document_theories: List[Document.Node.Name] = Nil,
66717
67dbf5cdc056 more informative loaded_theories: dependencies and syntax;
wenzelm
parents: 66716
diff changeset
    69
    loaded_theories: Graph[String, Outer_Syntax] = Graph.string,
70687
086575316fd5 eliminated pointless theory graph (reverting parts of a56eab490f4e): it caused problems with loaded vs. non-loaded node names, e.g. for theory Pure (see also 29bb1ebb188f);
wenzelm
parents: 70686
diff changeset
    70
    used_theories: List[(Document.Node.Name, Options)] = Nil,
72816
ea4f86914cb2 support for PIDE markup for auxiliary files ("blobs");
wenzelm
parents: 72799
diff changeset
    71
    load_commands: Map[Document.Node.Name, List[Command_Span.Span]] = Map.empty,
70740
525c18b8ed53 clarified data structures;
wenzelm
parents: 70739
diff changeset
    72
    known_theories: Map[String, Document.Node.Entry] = Map.empty,
525c18b8ed53 clarified data structures;
wenzelm
parents: 70739
diff changeset
    73
    known_loaded_files: Map[String, List[Path]] = Map.empty,
66720
b07192253605 tuned signature;
wenzelm
parents: 66719
diff changeset
    74
    overall_syntax: Outer_Syntax = Outer_Syntax.empty,
66744
fec1504e5f03 persistent storage of imported_sources;
wenzelm
parents: 66743
diff changeset
    75
    imported_sources: List[(Path, SHA1.Digest)] = Nil,
65495
60d4fbed2b1f tuned signature;
wenzelm
parents: 65490
diff changeset
    76
    sources: List[(Path, SHA1.Digest)] = Nil,
66822
4642cf4a7ebb tuned signature;
wenzelm
parents: 66819
diff changeset
    77
    session_graph_display: Graph_Display.Graph = Graph_Display.empty_graph,
72064
ce844442e2ab obsolete (see 9cde8c4ea5a5);
wenzelm
parents: 72062
diff changeset
    78
    errors: List[String] = Nil)
65495
60d4fbed2b1f tuned signature;
wenzelm
parents: 65490
diff changeset
    79
  {
69102
4b06a20b13b5 tuned output -- avoid bombing of Scala toplevel, e.g. for AFP deps;
wenzelm
parents: 69080
diff changeset
    80
    override def toString: String =
4b06a20b13b5 tuned output -- avoid bombing of Scala toplevel, e.g. for AFP deps;
wenzelm
parents: 69080
diff changeset
    81
      "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
    82
        ", used_theories = " + used_theories.length + ")"
4b06a20b13b5 tuned output -- avoid bombing of Scala toplevel, e.g. for AFP deps;
wenzelm
parents: 69080
diff changeset
    83
66967
e365c91c72a9 synthesize session with all required theories from other session imports;
wenzelm
parents: 66966
diff changeset
    84
    def theory_qualifier(name: String): String =
e365c91c72a9 synthesize session with all required theories from other session imports;
wenzelm
parents: 66966
diff changeset
    85
      global_theories.getOrElse(name, Long_Name.qualifier(name))
e365c91c72a9 synthesize session with all required theories from other session imports;
wenzelm
parents: 66966
diff changeset
    86
    def theory_qualifier(name: Document.Node.Name): String = theory_qualifier(name.theory)
66966
f3f9a492bee6 clarified signature;
wenzelm
parents: 66965
diff changeset
    87
66717
67dbf5cdc056 more informative loaded_theories: dependencies and syntax;
wenzelm
parents: 66716
diff changeset
    88
    def loaded_theory(name: String): Boolean = loaded_theories.defined(name)
66712
4c98c929a12a session-qualified theory names are mandatory;
wenzelm
parents: 66701
diff changeset
    89
    def loaded_theory(name: Document.Node.Name): Boolean = loaded_theory(name.theory)
65432
wenzelm
parents: 65430
diff changeset
    90
66717
67dbf5cdc056 more informative loaded_theories: dependencies and syntax;
wenzelm
parents: 66716
diff changeset
    91
    def loaded_theory_syntax(name: String): Option[Outer_Syntax] =
67dbf5cdc056 more informative loaded_theories: dependencies and syntax;
wenzelm
parents: 66716
diff changeset
    92
      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
    93
    def loaded_theory_syntax(name: Document.Node.Name): Option[Outer_Syntax] =
67dbf5cdc056 more informative loaded_theories: dependencies and syntax;
wenzelm
parents: 66716
diff changeset
    94
      loaded_theory_syntax(name.theory)
67dbf5cdc056 more informative loaded_theories: dependencies and syntax;
wenzelm
parents: 66716
diff changeset
    95
72669
5e7916535860 generate theory HTML in Isabelle/Scala;
wenzelm
parents: 72666
diff changeset
    96
    def theory_syntax(name: Document.Node.Name): Outer_Syntax =
5e7916535860 generate theory HTML in Isabelle/Scala;
wenzelm
parents: 72666
diff changeset
    97
      loaded_theory_syntax(name) getOrElse overall_syntax
5e7916535860 generate theory HTML in Isabelle/Scala;
wenzelm
parents: 72666
diff changeset
    98
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
    99
    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
   100
      nodes(name).syntax orElse loaded_theory_syntax(name) getOrElse overall_syntax
65355
403eabd73c9a tuned signature;
wenzelm
parents: 65326
diff changeset
   101
  }
64856
5e9bf964510a clarified modules;
wenzelm
parents: 63996
diff changeset
   102
70686
9cde8c4ea5a5 discontinued obsolete "isabelle imports" and all_known data;
wenzelm
parents: 70685
diff changeset
   103
  sealed case class Deps(sessions_structure: Structure, session_bases: Map[String, Base])
65251
4b0a43afc3fb clarified modules;
wenzelm
parents: 64856
diff changeset
   104
  {
69102
4b06a20b13b5 tuned output -- avoid bombing of Scala toplevel, e.g. for AFP deps;
wenzelm
parents: 69080
diff changeset
   105
    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
   106
65463
104502de757c more informative known_files: known_theories within the local session directory come first;
wenzelm
parents: 65461
diff changeset
   107
    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
   108
    def apply(name: String): Base = session_bases(name)
66988
7f8c1dd7576a support alternative ancestor session;
wenzelm
parents: 66987
diff changeset
   109
    def get(name: String): Option[Base] = session_bases.get(name)
66744
fec1504e5f03 persistent storage of imported_sources;
wenzelm
parents: 66743
diff changeset
   110
fec1504e5f03 persistent storage of imported_sources;
wenzelm
parents: 66743
diff changeset
   111
    def imported_sources(name: String): List[SHA1.Digest] =
fec1504e5f03 persistent storage of imported_sources;
wenzelm
parents: 66743
diff changeset
   112
      session_bases(name).imported_sources.map(_._2)
fec1504e5f03 persistent storage of imported_sources;
wenzelm
parents: 66743
diff changeset
   113
fec1504e5f03 persistent storage of imported_sources;
wenzelm
parents: 66743
diff changeset
   114
    def sources(name: String): List[SHA1.Digest] =
fec1504e5f03 persistent storage of imported_sources;
wenzelm
parents: 66743
diff changeset
   115
      session_bases(name).sources.map(_._2)
66571
0fdeb24e535e clarified errors;
wenzelm
parents: 66243
diff changeset
   116
0fdeb24e535e clarified errors;
wenzelm
parents: 66243
diff changeset
   117
    def errors: List[String] =
0fdeb24e535e clarified errors;
wenzelm
parents: 66243
diff changeset
   118
      (for {
0fdeb24e535e clarified errors;
wenzelm
parents: 66243
diff changeset
   119
        (name, base) <- session_bases.iterator
0fdeb24e535e clarified errors;
wenzelm
parents: 66243
diff changeset
   120
        if base.errors.nonEmpty
0fdeb24e535e clarified errors;
wenzelm
parents: 66243
diff changeset
   121
      } yield cat_lines(base.errors) +
0fdeb24e535e clarified errors;
wenzelm
parents: 66243
diff changeset
   122
          "\nThe error(s) above occurred in session " + quote(name) + Position.here(base.pos)
0fdeb24e535e clarified errors;
wenzelm
parents: 66243
diff changeset
   123
      ).toList
0fdeb24e535e clarified errors;
wenzelm
parents: 66243
diff changeset
   124
0fdeb24e535e clarified errors;
wenzelm
parents: 66243
diff changeset
   125
    def check_errors: Deps =
0fdeb24e535e clarified errors;
wenzelm
parents: 66243
diff changeset
   126
      errors match {
0fdeb24e535e clarified errors;
wenzelm
parents: 66243
diff changeset
   127
        case Nil => this
0fdeb24e535e clarified errors;
wenzelm
parents: 66243
diff changeset
   128
        case errs => error(cat_lines(errs))
0fdeb24e535e clarified errors;
wenzelm
parents: 66243
diff changeset
   129
      }
65251
4b0a43afc3fb clarified modules;
wenzelm
parents: 64856
diff changeset
   130
  }
64856
5e9bf964510a clarified modules;
wenzelm
parents: 63996
diff changeset
   131
67052
caf87d4b9b61 tuned signature;
wenzelm
parents: 67029
diff changeset
   132
  def deps(sessions_structure: Structure,
71726
a5fda30edae2 clarified signature: more uniform treatment of stopped/interrupted state;
wenzelm
parents: 71642
diff changeset
   133
      progress: Progress = new Progress,
65251
4b0a43afc3fb clarified modules;
wenzelm
parents: 64856
diff changeset
   134
      inlined_files: Boolean = false,
4b0a43afc3fb clarified modules;
wenzelm
parents: 64856
diff changeset
   135
      verbose: Boolean = false,
4b0a43afc3fb clarified modules;
wenzelm
parents: 64856
diff changeset
   136
      list_files: Boolean = false,
66962
e1bde71bace6 clarified signature: global_theories is always required;
wenzelm
parents: 66960
diff changeset
   137
      check_keywords: Set[String] = Set.empty): Deps =
65372
b722ee40c26c refer to global_theories from all sessions, before selection;
wenzelm
parents: 65371
diff changeset
   138
  {
66743
ff05d922bc34 cache sources: invoke SHA1.digest at most once;
wenzelm
parents: 66742
diff changeset
   139
    var cache_sources = Map.empty[JFile, SHA1.Digest]
ff05d922bc34 cache sources: invoke SHA1.digest at most once;
wenzelm
parents: 66742
diff changeset
   140
    def check_sources(paths: List[Path]): List[(Path, SHA1.Digest)] =
ff05d922bc34 cache sources: invoke SHA1.digest at most once;
wenzelm
parents: 66742
diff changeset
   141
    {
ff05d922bc34 cache sources: invoke SHA1.digest at most once;
wenzelm
parents: 66742
diff changeset
   142
      for {
ff05d922bc34 cache sources: invoke SHA1.digest at most once;
wenzelm
parents: 66742
diff changeset
   143
        path <- paths
ff05d922bc34 cache sources: invoke SHA1.digest at most once;
wenzelm
parents: 66742
diff changeset
   144
        file = path.file
ff05d922bc34 cache sources: invoke SHA1.digest at most once;
wenzelm
parents: 66742
diff changeset
   145
        if cache_sources.isDefinedAt(file) || file.isFile
ff05d922bc34 cache sources: invoke SHA1.digest at most once;
wenzelm
parents: 66742
diff changeset
   146
      }
ff05d922bc34 cache sources: invoke SHA1.digest at most once;
wenzelm
parents: 66742
diff changeset
   147
      yield {
ff05d922bc34 cache sources: invoke SHA1.digest at most once;
wenzelm
parents: 66742
diff changeset
   148
        cache_sources.get(file) match {
ff05d922bc34 cache sources: invoke SHA1.digest at most once;
wenzelm
parents: 66742
diff changeset
   149
          case Some(digest) => (path, digest)
ff05d922bc34 cache sources: invoke SHA1.digest at most once;
wenzelm
parents: 66742
diff changeset
   150
          case None =>
ff05d922bc34 cache sources: invoke SHA1.digest at most once;
wenzelm
parents: 66742
diff changeset
   151
            val digest = SHA1.digest(file)
ff05d922bc34 cache sources: invoke SHA1.digest at most once;
wenzelm
parents: 66742
diff changeset
   152
            cache_sources = cache_sources + (file -> digest)
ff05d922bc34 cache sources: invoke SHA1.digest at most once;
wenzelm
parents: 66742
diff changeset
   153
            (path, digest)
ff05d922bc34 cache sources: invoke SHA1.digest at most once;
wenzelm
parents: 66742
diff changeset
   154
        }
ff05d922bc34 cache sources: invoke SHA1.digest at most once;
wenzelm
parents: 66742
diff changeset
   155
      }
ff05d922bc34 cache sources: invoke SHA1.digest at most once;
wenzelm
parents: 66742
diff changeset
   156
    }
ff05d922bc34 cache sources: invoke SHA1.digest at most once;
wenzelm
parents: 66742
diff changeset
   157
65463
104502de757c more informative known_files: known_theories within the local session directory come first;
wenzelm
parents: 65461
diff changeset
   158
    val session_bases =
72845
60f56f623be2 tuned signature;
wenzelm
parents: 72839
diff changeset
   159
      (Map("" -> sessions_structure.bootstrap) /: sessions_structure.imports_topological_order)({
67023
e27e05d6f2a7 tuned signature;
wenzelm
parents: 67018
diff changeset
   160
        case (session_bases, session_name) =>
67880
e59220a075de tuned signature;
wenzelm
parents: 67869
diff changeset
   161
          progress.expose_interrupt()
65251
4b0a43afc3fb clarified modules;
wenzelm
parents: 64856
diff changeset
   162
67024
wenzelm
parents: 67023
diff changeset
   163
          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
   164
          try {
72066
ba5b37671528 clarified signature;
wenzelm
parents: 72065
diff changeset
   165
            val deps_base = info.deps_base(session_bases)
ba5b37671528 clarified signature;
wenzelm
parents: 72065
diff changeset
   166
            val resources = new Resources(sessions_structure, deps_base)
65251
4b0a43afc3fb clarified modules;
wenzelm
parents: 64856
diff changeset
   167
65463
104502de757c more informative known_files: known_theories within the local session directory come first;
wenzelm
parents: 65461
diff changeset
   168
            if (verbose || list_files) {
104502de757c more informative known_files: known_theories within the local session directory come first;
wenzelm
parents: 65461
diff changeset
   169
              val groups =
104502de757c more informative known_files: known_theories within the local session directory come first;
wenzelm
parents: 65461
diff changeset
   170
                if (info.groups.isEmpty) ""
104502de757c more informative known_files: known_theories within the local session directory come first;
wenzelm
parents: 65461
diff changeset
   171
                else info.groups.mkString(" (", " ", ")")
72670
4db9411c859c tuned signature;
wenzelm
parents: 72669
diff changeset
   172
              progress.echo("Session " + info.chapter_session + groups)
65463
104502de757c more informative known_files: known_theories within the local session directory come first;
wenzelm
parents: 65461
diff changeset
   173
            }
65251
4b0a43afc3fb clarified modules;
wenzelm
parents: 64856
diff changeset
   174
69008
d55783ea6cf6 more detailed session dependencies, with conditions for theories;
wenzelm
parents: 68841
diff changeset
   175
            val dependencies = resources.session_dependencies(info)
65251
4b0a43afc3fb clarified modules;
wenzelm
parents: 64856
diff changeset
   176
67053
wenzelm
parents: 67052
diff changeset
   177
            val overall_syntax = dependencies.overall_syntax
65251
4b0a43afc3fb clarified modules;
wenzelm
parents: 64856
diff changeset
   178
72323
e36f94e2eb6b some support for document preparation in Isabelle/Scala;
wenzelm
parents: 72068
diff changeset
   179
            val session_theories =
72565
wenzelm
parents: 72375
diff changeset
   180
              dependencies.theories.filter(name => deps_base.theory_qualifier(name) == session_name)
72323
e36f94e2eb6b some support for document preparation in Isabelle/Scala;
wenzelm
parents: 72068
diff changeset
   181
67059
df7d728103f1 tuned signature;
wenzelm
parents: 67053
diff changeset
   182
            val theory_files = dependencies.theories.map(_.path)
72068
4768b1facec2 clarified errors: avoid hiding of import_errors/dir_errors by their consequences (file-access problems);
wenzelm
parents: 72067
diff changeset
   183
72816
ea4f86914cb2 support for PIDE markup for auxiliary files ("blobs");
wenzelm
parents: 72799
diff changeset
   184
            dependencies.load_commands
ea4f86914cb2 support for PIDE markup for auxiliary files ("blobs");
wenzelm
parents: 72799
diff changeset
   185
ea4f86914cb2 support for PIDE markup for auxiliary files ("blobs");
wenzelm
parents: 72799
diff changeset
   186
            val (load_commands, load_commands_errors) =
ea4f86914cb2 support for PIDE markup for auxiliary files ("blobs");
wenzelm
parents: 72799
diff changeset
   187
              try { if (inlined_files) (dependencies.load_commands, Nil) else (Nil, Nil) }
72068
4768b1facec2 clarified errors: avoid hiding of import_errors/dir_errors by their consequences (file-access problems);
wenzelm
parents: 72067
diff changeset
   188
              catch { case ERROR(msg) => (Nil, List(msg)) }
65251
4b0a43afc3fb clarified modules;
wenzelm
parents: 64856
diff changeset
   189
72816
ea4f86914cb2 support for PIDE markup for auxiliary files ("blobs");
wenzelm
parents: 72799
diff changeset
   190
            val loaded_files =
ea4f86914cb2 support for PIDE markup for auxiliary files ("blobs");
wenzelm
parents: 72799
diff changeset
   191
              load_commands.map({ case (name, spans) => dependencies.loaded_files(name, spans) })
ea4f86914cb2 support for PIDE markup for auxiliary files ("blobs");
wenzelm
parents: 72799
diff changeset
   192
66742
wenzelm
parents: 66737
diff changeset
   193
            val session_files =
66701
d181f8a0e857 maintain loaded_files for each theory;
wenzelm
parents: 66696
diff changeset
   194
              (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
   195
                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
   196
67053
wenzelm
parents: 67052
diff changeset
   197
            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
   198
65463
104502de757c more informative known_files: known_theories within the local session directory come first;
wenzelm
parents: 65461
diff changeset
   199
            if (list_files)
66742
wenzelm
parents: 66737
diff changeset
   200
              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
   201
66719
d37efafd55b5 clarified theory syntax vs. overall session syntax;
wenzelm
parents: 66718
diff changeset
   202
            if (check_keywords.nonEmpty) {
d37efafd55b5 clarified theory syntax vs. overall session syntax;
wenzelm
parents: 66718
diff changeset
   203
              Check_Keywords.check_keywords(
66720
b07192253605 tuned signature;
wenzelm
parents: 66719
diff changeset
   204
                progress, overall_syntax.keywords, check_keywords, theory_files)
66719
d37efafd55b5 clarified theory syntax vs. overall session syntax;
wenzelm
parents: 66718
diff changeset
   205
            }
65251
4b0a43afc3fb clarified modules;
wenzelm
parents: 64856
diff changeset
   206
66822
4642cf4a7ebb tuned signature;
wenzelm
parents: 66819
diff changeset
   207
            val session_graph_display: Graph_Display.Graph =
65507
decdb95bd007 clarified session graph: collapse theories from other sessions;
wenzelm
parents: 65500
diff changeset
   208
            {
decdb95bd007 clarified session graph: collapse theories from other sessions;
wenzelm
parents: 65500
diff changeset
   209
              def session_node(name: String): Graph_Display.Node =
decdb95bd007 clarified session graph: collapse theories from other sessions;
wenzelm
parents: 65500
diff changeset
   210
                Graph_Display.Node("[" + name + "]", "session." + name)
decdb95bd007 clarified session graph: collapse theories from other sessions;
wenzelm
parents: 65500
diff changeset
   211
decdb95bd007 clarified session graph: collapse theories from other sessions;
wenzelm
parents: 65500
diff changeset
   212
              def node(name: Document.Node.Name): Graph_Display.Node =
decdb95bd007 clarified session graph: collapse theories from other sessions;
wenzelm
parents: 65500
diff changeset
   213
              {
72066
ba5b37671528 clarified signature;
wenzelm
parents: 72065
diff changeset
   214
                val qualifier = deps_base.theory_qualifier(name)
66780
bf54ca580bf2 theory qualifier is always session name (see also 31e8a86971a8);
wenzelm
parents: 66770
diff changeset
   215
                if (qualifier == info.name)
65507
decdb95bd007 clarified session graph: collapse theories from other sessions;
wenzelm
parents: 65500
diff changeset
   216
                  Graph_Display.Node(name.theory_base_name, "theory." + name.theory)
65528
d15d302da7f0 proper theory_qualifier;
wenzelm
parents: 65525
diff changeset
   217
                else session_node(qualifier)
65507
decdb95bd007 clarified session graph: collapse theories from other sessions;
wenzelm
parents: 65500
diff changeset
   218
              }
decdb95bd007 clarified session graph: collapse theories from other sessions;
wenzelm
parents: 65500
diff changeset
   219
70946
79d23e6436d0 clarified session_graph_display: restrict sessions to actually required theories;
wenzelm
parents: 70869
diff changeset
   220
              val required_sessions =
79d23e6436d0 clarified session_graph_display: restrict sessions to actually required theories;
wenzelm
parents: 70869
diff changeset
   221
                dependencies.loaded_theories.all_preds(dependencies.theories.map(_.theory))
72066
ba5b37671528 clarified signature;
wenzelm
parents: 72065
diff changeset
   222
                  .map(theory => deps_base.theory_qualifier(theory))
71574
95460356d633 avoid premature crash due to missing session parents/imports;
wenzelm
parents: 71569
diff changeset
   223
                  .filter(name => name != info.name && sessions_structure.defined(name))
70946
79d23e6436d0 clarified session_graph_display: restrict sessions to actually required theories;
wenzelm
parents: 70869
diff changeset
   224
79d23e6436d0 clarified session_graph_display: restrict sessions to actually required theories;
wenzelm
parents: 70869
diff changeset
   225
              val required_subgraph =
79d23e6436d0 clarified session_graph_display: restrict sessions to actually required theories;
wenzelm
parents: 70869
diff changeset
   226
                sessions_structure.imports_graph
79d23e6436d0 clarified session_graph_display: restrict sessions to actually required theories;
wenzelm
parents: 70869
diff changeset
   227
                  .restrict(sessions_structure.imports_graph.all_preds(required_sessions).toSet)
79d23e6436d0 clarified session_graph_display: restrict sessions to actually required theories;
wenzelm
parents: 70869
diff changeset
   228
                  .transitive_closure
79d23e6436d0 clarified session_graph_display: restrict sessions to actually required theories;
wenzelm
parents: 70869
diff changeset
   229
                  .restrict(required_sessions.toSet)
79d23e6436d0 clarified session_graph_display: restrict sessions to actually required theories;
wenzelm
parents: 70869
diff changeset
   230
                  .transitive_reduction_acyclic
65507
decdb95bd007 clarified session graph: collapse theories from other sessions;
wenzelm
parents: 65500
diff changeset
   231
decdb95bd007 clarified session graph: collapse theories from other sessions;
wenzelm
parents: 65500
diff changeset
   232
              val graph0 =
70946
79d23e6436d0 clarified session_graph_display: restrict sessions to actually required theories;
wenzelm
parents: 70869
diff changeset
   233
                (Graph_Display.empty_graph /: required_subgraph.topological_order)(
65507
decdb95bd007 clarified session graph: collapse theories from other sessions;
wenzelm
parents: 65500
diff changeset
   234
                  { case (g, session) =>
decdb95bd007 clarified session graph: collapse theories from other sessions;
wenzelm
parents: 65500
diff changeset
   235
                      val a = session_node(session)
71601
97ccf48c2f0c misc tuning based on hints by IntelliJ IDEA;
wenzelm
parents: 71599
diff changeset
   236
                      val bs = required_subgraph.imm_preds(session).toList.map(session_node)
65507
decdb95bd007 clarified session graph: collapse theories from other sessions;
wenzelm
parents: 65500
diff changeset
   237
                      ((g /: (a :: bs))(_.default_node(_, Nil)) /: bs)(_.add_edge(_, a)) })
decdb95bd007 clarified session graph: collapse theories from other sessions;
wenzelm
parents: 65500
diff changeset
   238
67053
wenzelm
parents: 67052
diff changeset
   239
              (graph0 /: dependencies.entries)(
66714
9fc4e144693c tuned signature;
wenzelm
parents: 66712
diff changeset
   240
                { case (g, entry) =>
9fc4e144693c tuned signature;
wenzelm
parents: 66712
diff changeset
   241
                    val a = node(entry.name)
70638
f164cec7ac22 clarified signature: prefer operations without position;
wenzelm
parents: 70637
diff changeset
   242
                    val bs = entry.header.imports.map(node).filterNot(_ == a)
65507
decdb95bd007 clarified session graph: collapse theories from other sessions;
wenzelm
parents: 65500
diff changeset
   243
                    ((g /: (a :: bs))(_.default_node(_, Nil)) /: bs)(_.add_edge(_, a)) })
decdb95bd007 clarified session graph: collapse theories from other sessions;
wenzelm
parents: 65500
diff changeset
   244
            }
decdb95bd007 clarified session graph: collapse theories from other sessions;
wenzelm
parents: 65500
diff changeset
   245
70740
525c18b8ed53 clarified data structures;
wenzelm
parents: 70739
diff changeset
   246
            val known_theories =
72066
ba5b37671528 clarified signature;
wenzelm
parents: 72065
diff changeset
   247
              (deps_base.known_theories /:
70740
525c18b8ed53 clarified data structures;
wenzelm
parents: 70739
diff changeset
   248
                dependencies.entries.iterator.map(entry => entry.name.theory -> entry))(_ + _)
525c18b8ed53 clarified data structures;
wenzelm
parents: 70739
diff changeset
   249
72066
ba5b37671528 clarified signature;
wenzelm
parents: 72065
diff changeset
   250
            val known_loaded_files = deps_base.known_loaded_files ++ loaded_files
66701
d181f8a0e857 maintain loaded_files for each theory;
wenzelm
parents: 66696
diff changeset
   251
72067
17507b48b6f5 clarified errors: avoid accidental import from other session that happens to be within overall selection (notably "isabelle build -a");
wenzelm
parents: 72066
diff changeset
   252
            val import_errors =
17507b48b6f5 clarified errors: avoid accidental import from other session that happens to be within overall selection (notably "isabelle build -a");
wenzelm
parents: 72066
diff changeset
   253
            {
17507b48b6f5 clarified errors: avoid accidental import from other session that happens to be within overall selection (notably "isabelle build -a");
wenzelm
parents: 72066
diff changeset
   254
              val known_sessions =
17507b48b6f5 clarified errors: avoid accidental import from other session that happens to be within overall selection (notably "isabelle build -a");
wenzelm
parents: 72066
diff changeset
   255
                sessions_structure.imports_requirements(List(session_name)).toSet
17507b48b6f5 clarified errors: avoid accidental import from other session that happens to be within overall selection (notably "isabelle build -a");
wenzelm
parents: 72066
diff changeset
   256
              for {
17507b48b6f5 clarified errors: avoid accidental import from other session that happens to be within overall selection (notably "isabelle build -a");
wenzelm
parents: 72066
diff changeset
   257
                name <- dependencies.theories
17507b48b6f5 clarified errors: avoid accidental import from other session that happens to be within overall selection (notably "isabelle build -a");
wenzelm
parents: 72066
diff changeset
   258
                qualifier = deps_base.theory_qualifier(name)
17507b48b6f5 clarified errors: avoid accidental import from other session that happens to be within overall selection (notably "isabelle build -a");
wenzelm
parents: 72066
diff changeset
   259
                if !known_sessions(qualifier)
17507b48b6f5 clarified errors: avoid accidental import from other session that happens to be within overall selection (notably "isabelle build -a");
wenzelm
parents: 72066
diff changeset
   260
              } yield "Bad import of theory " + quote(name.toString) +
17507b48b6f5 clarified errors: avoid accidental import from other session that happens to be within overall selection (notably "isabelle build -a");
wenzelm
parents: 72066
diff changeset
   261
                ": need to include sessions " + quote(qualifier) + " in ROOT"
17507b48b6f5 clarified errors: avoid accidental import from other session that happens to be within overall selection (notably "isabelle build -a");
wenzelm
parents: 72066
diff changeset
   262
            }
17507b48b6f5 clarified errors: avoid accidental import from other session that happens to be within overall selection (notably "isabelle build -a");
wenzelm
parents: 72066
diff changeset
   263
72600
2fa4f25d9d07 official support for document theories from other sessions;
wenzelm
parents: 72574
diff changeset
   264
            val document_errors =
2fa4f25d9d07 official support for document theories from other sessions;
wenzelm
parents: 72574
diff changeset
   265
              info.document_theories.flatMap(
2fa4f25d9d07 official support for document theories from other sessions;
wenzelm
parents: 72574
diff changeset
   266
              {
2fa4f25d9d07 official support for document theories from other sessions;
wenzelm
parents: 72574
diff changeset
   267
                case (thy, pos) =>
72647
fd6dc1a4b9ca more robust, e.g. for "isabelle build_doc system";
wenzelm
parents: 72634
diff changeset
   268
                  val parent_sessions =
fd6dc1a4b9ca more robust, e.g. for "isabelle build_doc system";
wenzelm
parents: 72634
diff changeset
   269
                    if (sessions_structure.build_graph.defined(session_name)) {
fd6dc1a4b9ca more robust, e.g. for "isabelle build_doc system";
wenzelm
parents: 72634
diff changeset
   270
                      sessions_structure.build_requirements(List(session_name))
fd6dc1a4b9ca more robust, e.g. for "isabelle build_doc system";
wenzelm
parents: 72634
diff changeset
   271
                    }
fd6dc1a4b9ca more robust, e.g. for "isabelle build_doc system";
wenzelm
parents: 72634
diff changeset
   272
                    else Nil
72600
2fa4f25d9d07 official support for document theories from other sessions;
wenzelm
parents: 72574
diff changeset
   273
2fa4f25d9d07 official support for document theories from other sessions;
wenzelm
parents: 72574
diff changeset
   274
                  def err(msg: String): Option[String] =
2fa4f25d9d07 official support for document theories from other sessions;
wenzelm
parents: 72574
diff changeset
   275
                    Some(msg + " " + quote(thy) + Position.here(pos))
2fa4f25d9d07 official support for document theories from other sessions;
wenzelm
parents: 72574
diff changeset
   276
72604
wenzelm
parents: 72603
diff changeset
   277
                  known_theories.get(thy).map(_.name) match {
72600
2fa4f25d9d07 official support for document theories from other sessions;
wenzelm
parents: 72574
diff changeset
   278
                    case None => err("Unknown document theory")
72604
wenzelm
parents: 72603
diff changeset
   279
                    case Some(name) =>
wenzelm
parents: 72603
diff changeset
   280
                      val qualifier = deps_base.theory_qualifier(name)
wenzelm
parents: 72603
diff changeset
   281
                      if (session_theories.contains(name)) {
72600
2fa4f25d9d07 official support for document theories from other sessions;
wenzelm
parents: 72574
diff changeset
   282
                        err("Redundant document theory from this session:")
2fa4f25d9d07 official support for document theories from other sessions;
wenzelm
parents: 72574
diff changeset
   283
                      }
72604
wenzelm
parents: 72603
diff changeset
   284
                      else if (parent_sessions.contains(qualifier)) None
wenzelm
parents: 72603
diff changeset
   285
                      else if (dependencies.theories.contains(name)) None
72600
2fa4f25d9d07 official support for document theories from other sessions;
wenzelm
parents: 72574
diff changeset
   286
                      else err("Document theory from other session not imported properly:")
2fa4f25d9d07 official support for document theories from other sessions;
wenzelm
parents: 72574
diff changeset
   287
                  }
2fa4f25d9d07 official support for document theories from other sessions;
wenzelm
parents: 72574
diff changeset
   288
              })
2fa4f25d9d07 official support for document theories from other sessions;
wenzelm
parents: 72574
diff changeset
   289
            val document_theories =
2fa4f25d9d07 official support for document theories from other sessions;
wenzelm
parents: 72574
diff changeset
   290
              info.document_theories.map({ case (thy, _) => known_theories(thy).name })
2fa4f25d9d07 official support for document theories from other sessions;
wenzelm
parents: 72574
diff changeset
   291
70676
73812c598a26 check session directories;
wenzelm
parents: 70674
diff changeset
   292
            val dir_errors =
73812c598a26 check session directories;
wenzelm
parents: 70674
diff changeset
   293
            {
70681
a6c0f2d106c8 disallow overlapping session directories;
wenzelm
parents: 70679
diff changeset
   294
              val ok = info.dirs.map(_.canonical_file).toSet
70679
7b6e6d61204a clarified messages;
wenzelm
parents: 70678
diff changeset
   295
              val bad =
7b6e6d61204a clarified messages;
wenzelm
parents: 70678
diff changeset
   296
                (for {
72565
wenzelm
parents: 72375
diff changeset
   297
                  name <- session_theories.iterator
70719
b3f61e166763 more errors;
wenzelm
parents: 70715
diff changeset
   298
                  path = name.master_dir_path
70676
73812c598a26 check session directories;
wenzelm
parents: 70674
diff changeset
   299
                  if !ok(path.canonical_file)
70679
7b6e6d61204a clarified messages;
wenzelm
parents: 70678
diff changeset
   300
                  path1 = File.relative_path(info.dir.canonical, path).getOrElse(path)
7b6e6d61204a clarified messages;
wenzelm
parents: 70678
diff changeset
   301
                } yield (path1, name)).toList
71602
wenzelm
parents: 71601
diff changeset
   302
              val bad_dirs = (for { (path1, _) <- bad } yield path1.toString).distinct.sorted
70679
7b6e6d61204a clarified messages;
wenzelm
parents: 70678
diff changeset
   303
7b6e6d61204a clarified messages;
wenzelm
parents: 70678
diff changeset
   304
              val errs1 =
7b6e6d61204a clarified messages;
wenzelm
parents: 70678
diff changeset
   305
                for { (path1, name) <- bad }
7b6e6d61204a clarified messages;
wenzelm
parents: 70678
diff changeset
   306
                yield "Implicit use of directory " + path1 + " for theory " + quote(name.toString)
7b6e6d61204a clarified messages;
wenzelm
parents: 70678
diff changeset
   307
              val errs2 =
7b6e6d61204a clarified messages;
wenzelm
parents: 70678
diff changeset
   308
                if (bad_dirs.isEmpty) Nil
7b6e6d61204a clarified messages;
wenzelm
parents: 70678
diff changeset
   309
                else List("Implicit use of session directories: " + commas(bad_dirs))
70693
0fec12eabad0 session directories need to exist;
wenzelm
parents: 70687
diff changeset
   310
              val errs3 = for (p <- info.dirs if !p.is_dir) yield "No such directory: " + p
70719
b3f61e166763 more errors;
wenzelm
parents: 70715
diff changeset
   311
              val errs4 =
b3f61e166763 more errors;
wenzelm
parents: 70715
diff changeset
   312
                (for {
72565
wenzelm
parents: 72375
diff changeset
   313
                  name <- session_theories.iterator
70719
b3f61e166763 more errors;
wenzelm
parents: 70715
diff changeset
   314
                  name1 <- resources.find_theory_node(name.theory)
b3f61e166763 more errors;
wenzelm
parents: 70715
diff changeset
   315
                  if name.node != name1.node
b3f61e166763 more errors;
wenzelm
parents: 70715
diff changeset
   316
                } yield "Incoherent theory file import:\n  " + name.path + " vs. \n  " + name1.path)
b3f61e166763 more errors;
wenzelm
parents: 70715
diff changeset
   317
                .toList
70693
0fec12eabad0 session directories need to exist;
wenzelm
parents: 70687
diff changeset
   318
70719
b3f61e166763 more errors;
wenzelm
parents: 70715
diff changeset
   319
              errs1 ::: errs2 ::: errs3 ::: errs4
70676
73812c598a26 check session directories;
wenzelm
parents: 70674
diff changeset
   320
            }
73812c598a26 check session directories;
wenzelm
parents: 70674
diff changeset
   321
66743
ff05d922bc34 cache sources: invoke SHA1.digest at most once;
wenzelm
parents: 66742
diff changeset
   322
            val sources_errors =
ff05d922bc34 cache sources: invoke SHA1.digest at most once;
wenzelm
parents: 66742
diff changeset
   323
              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
   324
69904
6f5bd59f75f4 more sanity checks;
wenzelm
parents: 69857
diff changeset
   325
            val path_errors =
6f5bd59f75f4 more sanity checks;
wenzelm
parents: 69857
diff changeset
   326
              try { Path.check_case_insensitive(session_files ::: imported_files); Nil }
6f5bd59f75f4 more sanity checks;
wenzelm
parents: 69857
diff changeset
   327
              catch { case ERROR(msg) => List(msg) }
6f5bd59f75f4 more sanity checks;
wenzelm
parents: 69857
diff changeset
   328
67297
86a099f896fc formal check of @{cite} bibtex entries -- only in batch-mode session builds;
wenzelm
parents: 67290
diff changeset
   329
            val bibtex_errors =
86a099f896fc formal check of @{cite} bibtex entries -- only in batch-mode session builds;
wenzelm
parents: 67290
diff changeset
   330
              try { info.bibtex_entries; Nil }
86a099f896fc formal check of @{cite} bibtex entries -- only in batch-mode session builds;
wenzelm
parents: 67290
diff changeset
   331
              catch { case ERROR(msg) => List(msg) }
86a099f896fc formal check of @{cite} bibtex entries -- only in batch-mode session builds;
wenzelm
parents: 67290
diff changeset
   332
65463
104502de757c more informative known_files: known_theories within the local session directory come first;
wenzelm
parents: 65461
diff changeset
   333
            val base =
66571
0fdeb24e535e clarified errors;
wenzelm
parents: 66243
diff changeset
   334
              Base(
0fdeb24e535e clarified errors;
wenzelm
parents: 66243
diff changeset
   335
                pos = info.pos,
70673
b0172698d0d3 theory_name based on session_directories: no need for expensive all_known;
wenzelm
parents: 70672
diff changeset
   336
                session_directories = sessions_structure.session_directories,
70671
cb1776c8e216 clarified signature: retain global session information, unaffected by later restriction;
wenzelm
parents: 70668
diff changeset
   337
                global_theories = sessions_structure.global_theories,
72323
e36f94e2eb6b some support for document preparation in Isabelle/Scala;
wenzelm
parents: 72068
diff changeset
   338
                session_theories = session_theories,
72600
2fa4f25d9d07 official support for document theories from other sessions;
wenzelm
parents: 72574
diff changeset
   339
                document_theories = document_theories,
67053
wenzelm
parents: 67052
diff changeset
   340
                loaded_theories = dependencies.loaded_theories,
72062
d0909b5d88eb tuned signature;
wenzelm
parents: 71971
diff changeset
   341
                used_theories = dependencies.theories_adjunct,
72816
ea4f86914cb2 support for PIDE markup for auxiliary files ("blobs");
wenzelm
parents: 72799
diff changeset
   342
                load_commands = load_commands.toMap,
70740
525c18b8ed53 clarified data structures;
wenzelm
parents: 70739
diff changeset
   343
                known_theories = known_theories,
525c18b8ed53 clarified data structures;
wenzelm
parents: 70739
diff changeset
   344
                known_loaded_files = known_loaded_files,
66720
b07192253605 tuned signature;
wenzelm
parents: 66719
diff changeset
   345
                overall_syntax = overall_syntax,
66744
fec1504e5f03 persistent storage of imported_sources;
wenzelm
parents: 66743
diff changeset
   346
                imported_sources = check_sources(imported_files),
66743
ff05d922bc34 cache sources: invoke SHA1.digest at most once;
wenzelm
parents: 66742
diff changeset
   347
                sources = check_sources(session_files),
66822
4642cf4a7ebb tuned signature;
wenzelm
parents: 66819
diff changeset
   348
                session_graph_display = session_graph_display,
72816
ea4f86914cb2 support for PIDE markup for auxiliary files ("blobs");
wenzelm
parents: 72799
diff changeset
   349
                errors = dependencies.errors ::: load_commands_errors ::: import_errors :::
72600
2fa4f25d9d07 official support for document theories from other sessions;
wenzelm
parents: 72574
diff changeset
   350
                  document_errors ::: dir_errors ::: sources_errors ::: path_errors :::
2fa4f25d9d07 official support for document theories from other sessions;
wenzelm
parents: 72574
diff changeset
   351
                  bibtex_errors)
65251
4b0a43afc3fb clarified modules;
wenzelm
parents: 64856
diff changeset
   352
65519
d244d8f8e13f store Sessions.Info.name;
wenzelm
parents: 65517
diff changeset
   353
            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
   354
          }
104502de757c more informative known_files: known_theories within the local session directory come first;
wenzelm
parents: 65461
diff changeset
   355
          catch {
104502de757c more informative known_files: known_theories within the local session directory come first;
wenzelm
parents: 65461
diff changeset
   356
            case ERROR(msg) =>
104502de757c more informative known_files: known_theories within the local session directory come first;
wenzelm
parents: 65461
diff changeset
   357
              cat_error(msg, "The error(s) above occurred in session " +
65519
d244d8f8e13f store Sessions.Info.name;
wenzelm
parents: 65517
diff changeset
   358
                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
   359
          }
104502de757c more informative known_files: known_theories within the local session directory come first;
wenzelm
parents: 65461
diff changeset
   360
      })
65251
4b0a43afc3fb clarified modules;
wenzelm
parents: 64856
diff changeset
   361
70686
9cde8c4ea5a5 discontinued obsolete "isabelle imports" and all_known data;
wenzelm
parents: 70685
diff changeset
   362
    Deps(sessions_structure, session_bases)
65372
b722ee40c26c refer to global_theories from all sessions, before selection;
wenzelm
parents: 65371
diff changeset
   363
  }
65251
4b0a43afc3fb clarified modules;
wenzelm
parents: 64856
diff changeset
   364
66963
1c3d0c12bb51 clarified signature;
wenzelm
parents: 66962
diff changeset
   365
1c3d0c12bb51 clarified signature;
wenzelm
parents: 66962
diff changeset
   366
  /* base info */
1c3d0c12bb51 clarified signature;
wenzelm
parents: 66962
diff changeset
   367
66974
b14c24b31f45 avoid duplicate invocation of expensive Sessions.deps on full_sessions;
wenzelm
parents: 66970
diff changeset
   368
  sealed case class Base_Info(
b14c24b31f45 avoid duplicate invocation of expensive Sessions.deps on full_sessions;
wenzelm
parents: 66970
diff changeset
   369
    session: String,
67052
caf87d4b9b61 tuned signature;
wenzelm
parents: 67029
diff changeset
   370
    sessions_structure: Structure,
66975
ca73d44d51aa do not store bulky Session.Deps;
wenzelm
parents: 66974
diff changeset
   371
    errors: List[String],
66974
b14c24b31f45 avoid duplicate invocation of expensive Sessions.deps on full_sessions;
wenzelm
parents: 66970
diff changeset
   372
    base: Base,
b14c24b31f45 avoid duplicate invocation of expensive Sessions.deps on full_sessions;
wenzelm
parents: 66970
diff changeset
   373
    infos: List[Info])
b14c24b31f45 avoid duplicate invocation of expensive Sessions.deps on full_sessions;
wenzelm
parents: 66970
diff changeset
   374
  {
72627
8d83acc5062e clarified signature;
wenzelm
parents: 72626
diff changeset
   375
    def check: Base_Info = if (errors.isEmpty) this else error(cat_lines(errors))
66974
b14c24b31f45 avoid duplicate invocation of expensive Sessions.deps on full_sessions;
wenzelm
parents: 66970
diff changeset
   376
  }
b14c24b31f45 avoid duplicate invocation of expensive Sessions.deps on full_sessions;
wenzelm
parents: 66970
diff changeset
   377
67846
wenzelm
parents: 67493
diff changeset
   378
  def base_info(options: Options,
wenzelm
parents: 67493
diff changeset
   379
    session: String,
71726
a5fda30edae2 clarified signature: more uniform treatment of stopped/interrupted state;
wenzelm
parents: 71642
diff changeset
   380
    progress: Progress = new Progress,
65428
f8dd71a0791a support for all_known_theories of all sessions;
wenzelm
parents: 65427
diff changeset
   381
    dirs: List[Path] = Nil,
67922
9e668ae81f97 clarified signature: prefer selective include_sessions;
wenzelm
parents: 67880
diff changeset
   382
    include_sessions: List[String] = Nil,
68370
bcdc47c9d4af clarified signature;
wenzelm
parents: 68318
diff changeset
   383
    session_ancestor: Option[String] = None,
70683
8c7706b053c7 find theory files via session structure: much faster Prover IDE startup;
wenzelm
parents: 70681
diff changeset
   384
    session_requirements: Boolean = false): Base_Info =
65251
4b0a43afc3fb clarified modules;
wenzelm
parents: 64856
diff changeset
   385
  {
67026
687c822ee5e3 tuned signature;
wenzelm
parents: 67025
diff changeset
   386
    val full_sessions = load_structure(options, dirs = dirs)
65372
b722ee40c26c refer to global_theories from all sessions, before selection;
wenzelm
parents: 65371
diff changeset
   387
66990
b23adab22e67 allow unrelated ancestor;
wenzelm
parents: 66988
diff changeset
   388
    val selected_sessions =
68370
bcdc47c9d4af clarified signature;
wenzelm
parents: 68318
diff changeset
   389
      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
   390
    val info = selected_sessions(session)
68370
bcdc47c9d4af clarified signature;
wenzelm
parents: 68318
diff changeset
   391
    val ancestor = session_ancestor orElse info.parent
66963
1c3d0c12bb51 clarified signature;
wenzelm
parents: 66962
diff changeset
   392
66974
b14c24b31f45 avoid duplicate invocation of expensive Sessions.deps on full_sessions;
wenzelm
parents: 66970
diff changeset
   393
    val (session1, infos1) =
68370
bcdc47c9d4af clarified signature;
wenzelm
parents: 68318
diff changeset
   394
      if (session_requirements && ancestor.isDefined) {
70671
cb1776c8e216 clarified signature: retain global session information, unaffected by later restriction;
wenzelm
parents: 70668
diff changeset
   395
        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
   396
        val base = deps(session)
66968
9991671c98aa allow to augment session context via explicit session infos;
wenzelm
parents: 66967
diff changeset
   397
66988
7f8c1dd7576a support alternative ancestor session;
wenzelm
parents: 66987
diff changeset
   398
        val ancestor_loaded =
7f8c1dd7576a support alternative ancestor session;
wenzelm
parents: 66987
diff changeset
   399
          deps.get(ancestor.get) match {
66990
b23adab22e67 allow unrelated ancestor;
wenzelm
parents: 66988
diff changeset
   400
            case Some(ancestor_base)
b23adab22e67 allow unrelated ancestor;
wenzelm
parents: 66988
diff changeset
   401
            if !selected_sessions.imports_requirements(List(ancestor.get)).contains(session) =>
71601
97ccf48c2f0c misc tuning based on hints by IntelliJ IDEA;
wenzelm
parents: 71599
diff changeset
   402
              ancestor_base.loaded_theories.defined _
66990
b23adab22e67 allow unrelated ancestor;
wenzelm
parents: 66988
diff changeset
   403
            case _ =>
66988
7f8c1dd7576a support alternative ancestor session;
wenzelm
parents: 66987
diff changeset
   404
              error("Bad ancestor " + quote(ancestor.get) + " for session " + quote(session))
7f8c1dd7576a support alternative ancestor session;
wenzelm
parents: 66987
diff changeset
   405
          }
66974
b14c24b31f45 avoid duplicate invocation of expensive Sessions.deps on full_sessions;
wenzelm
parents: 66970
diff changeset
   406
b14c24b31f45 avoid duplicate invocation of expensive Sessions.deps on full_sessions;
wenzelm
parents: 66970
diff changeset
   407
        val required_theories =
66968
9991671c98aa allow to augment session context via explicit session infos;
wenzelm
parents: 66967
diff changeset
   408
          for {
9991671c98aa allow to augment session context via explicit session infos;
wenzelm
parents: 66967
diff changeset
   409
            thy <- base.loaded_theories.keys
66988
7f8c1dd7576a support alternative ancestor session;
wenzelm
parents: 66987
diff changeset
   410
            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
   411
          }
66974
b14c24b31f45 avoid duplicate invocation of expensive Sessions.deps on full_sessions;
wenzelm
parents: 66970
diff changeset
   412
          yield thy
66968
9991671c98aa allow to augment session context via explicit session infos;
wenzelm
parents: 66967
diff changeset
   413
66988
7f8c1dd7576a support alternative ancestor session;
wenzelm
parents: 66987
diff changeset
   414
        if (required_theories.isEmpty) (ancestor.get, Nil)
66968
9991671c98aa allow to augment session context via explicit session infos;
wenzelm
parents: 66967
diff changeset
   415
        else {
68370
bcdc47c9d4af clarified signature;
wenzelm
parents: 68318
diff changeset
   416
          val other_name = info.name + "_requirements(" + ancestor.get + ")"
71569
391ea80ff27c more robust re-use of $ISABELLE_TMP_PREFIX (amending c1597167563e);
wenzelm
parents: 70946
diff changeset
   417
          Isabelle_System.isabelle_tmp_prefix()
391ea80ff27c more robust re-use of $ISABELLE_TMP_PREFIX (amending c1597167563e);
wenzelm
parents: 70946
diff changeset
   418
66974
b14c24b31f45 avoid duplicate invocation of expensive Sessions.deps on full_sessions;
wenzelm
parents: 66970
diff changeset
   419
          (other_name,
66968
9991671c98aa allow to augment session context via explicit session infos;
wenzelm
parents: 66967
diff changeset
   420
            List(
9991671c98aa allow to augment session context via explicit session infos;
wenzelm
parents: 66967
diff changeset
   421
              make_info(info.options,
9991671c98aa allow to augment session context via explicit session infos;
wenzelm
parents: 66967
diff changeset
   422
                dir_selected = false,
70685
c1597167563e avoid duplicate directories wrt. synthetic session;
wenzelm
parents: 70684
diff changeset
   423
                dir = Path.explode("$ISABELLE_TMP_PREFIX"),
66968
9991671c98aa allow to augment session context via explicit session infos;
wenzelm
parents: 66967
diff changeset
   424
                chapter = info.chapter,
9991671c98aa allow to augment session context via explicit session infos;
wenzelm
parents: 66967
diff changeset
   425
                Session_Entry(
9991671c98aa allow to augment session context via explicit session infos;
wenzelm
parents: 66967
diff changeset
   426
                  pos = info.pos,
9991671c98aa allow to augment session context via explicit session infos;
wenzelm
parents: 66967
diff changeset
   427
                  name = other_name,
9991671c98aa allow to augment session context via explicit session infos;
wenzelm
parents: 66967
diff changeset
   428
                  groups = info.groups,
9991671c98aa allow to augment session context via explicit session infos;
wenzelm
parents: 66967
diff changeset
   429
                  path = ".",
66988
7f8c1dd7576a support alternative ancestor session;
wenzelm
parents: 66987
diff changeset
   430
                  parent = ancestor,
66974
b14c24b31f45 avoid duplicate invocation of expensive Sessions.deps on full_sessions;
wenzelm
parents: 66970
diff changeset
   431
                  description = "Required theory imports from other sessions",
66968
9991671c98aa allow to augment session context via explicit session infos;
wenzelm
parents: 66967
diff changeset
   432
                  options = Nil,
66991
fc87d3becd69 proper deps;
wenzelm
parents: 66990
diff changeset
   433
                  imports = info.deps,
70678
36c8c32346cb clarified syntax: 'directories' and 'theories' belong together;
wenzelm
parents: 70676
diff changeset
   434
                  directories = Nil,
66974
b14c24b31f45 avoid duplicate invocation of expensive Sessions.deps on full_sessions;
wenzelm
parents: 66970
diff changeset
   435
                  theories = List((Nil, required_theories.map(thy => ((thy, Position.none), false)))),
72600
2fa4f25d9d07 official support for document theories from other sessions;
wenzelm
parents: 72574
diff changeset
   436
                  document_theories = Nil,
68292
7ca0c23179e6 support 'export_files' in session ROOT;
wenzelm
parents: 68221
diff changeset
   437
                  document_files = Nil,
7ca0c23179e6 support 'export_files' in session ROOT;
wenzelm
parents: 68221
diff changeset
   438
                  export_files = Nil))))
66968
9991671c98aa allow to augment session context via explicit session infos;
wenzelm
parents: 66967
diff changeset
   439
        }
9991671c98aa allow to augment session context via explicit session infos;
wenzelm
parents: 66967
diff changeset
   440
      }
66974
b14c24b31f45 avoid duplicate invocation of expensive Sessions.deps on full_sessions;
wenzelm
parents: 66970
diff changeset
   441
      else (session, Nil)
66968
9991671c98aa allow to augment session context via explicit session infos;
wenzelm
parents: 66967
diff changeset
   442
66974
b14c24b31f45 avoid duplicate invocation of expensive Sessions.deps on full_sessions;
wenzelm
parents: 66970
diff changeset
   443
    val full_sessions1 =
b14c24b31f45 avoid duplicate invocation of expensive Sessions.deps on full_sessions;
wenzelm
parents: 66970
diff changeset
   444
      if (infos1.isEmpty) full_sessions
67026
687c822ee5e3 tuned signature;
wenzelm
parents: 67025
diff changeset
   445
      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
   446
352b23c97ac8 support focus_session, for much faster startup of Isabelle/jEdit;
wenzelm
parents: 66984
diff changeset
   447
    val selected_sessions1 =
70683
8c7706b053c7 find theory files via session structure: much faster Prover IDE startup;
wenzelm
parents: 70681
diff changeset
   448
      full_sessions1.selection(Selection(sessions = session1 :: session :: include_sessions))
66964
9f2de457b95e clarified signature;
wenzelm
parents: 66963
diff changeset
   449
70683
8c7706b053c7 find theory files via session structure: much faster Prover IDE startup;
wenzelm
parents: 70681
diff changeset
   450
    val deps1 = Sessions.deps(selected_sessions1, progress = progress)
66964
9f2de457b95e clarified signature;
wenzelm
parents: 66963
diff changeset
   451
71599
23d0a45a9283 clarified signature;
wenzelm
parents: 71595
diff changeset
   452
    Base_Info(session1, full_sessions1, deps1.errors, deps1(session1), infos1)
65251
4b0a43afc3fb clarified modules;
wenzelm
parents: 64856
diff changeset
   453
  }
4b0a43afc3fb clarified modules;
wenzelm
parents: 64856
diff changeset
   454
4b0a43afc3fb clarified modules;
wenzelm
parents: 64856
diff changeset
   455
65415
8cd54b18b68b clarified signature: tree structure is not essential;
wenzelm
parents: 65410
diff changeset
   456
  /* cumulative session info */
62631
c39614ddb80b clarified modules;
wenzelm
parents:
diff changeset
   457
c39614ddb80b clarified modules;
wenzelm
parents:
diff changeset
   458
  sealed case class Info(
65519
d244d8f8e13f store Sessions.Info.name;
wenzelm
parents: 65517
diff changeset
   459
    name: String,
62631
c39614ddb80b clarified modules;
wenzelm
parents:
diff changeset
   460
    chapter: String,
66829
5baca4c94737 tuned signature;
wenzelm
parents: 66828
diff changeset
   461
    dir_selected: Boolean,
62631
c39614ddb80b clarified modules;
wenzelm
parents:
diff changeset
   462
    pos: Position.T,
c39614ddb80b clarified modules;
wenzelm
parents:
diff changeset
   463
    groups: List[String],
c39614ddb80b clarified modules;
wenzelm
parents:
diff changeset
   464
    dir: Path,
c39614ddb80b clarified modules;
wenzelm
parents:
diff changeset
   465
    parent: Option[String],
c39614ddb80b clarified modules;
wenzelm
parents:
diff changeset
   466
    description: String,
70681
a6c0f2d106c8 disallow overlapping session directories;
wenzelm
parents: 70679
diff changeset
   467
    directories: List[Path],
62631
c39614ddb80b clarified modules;
wenzelm
parents:
diff changeset
   468
    options: Options,
65420
695d4e22345a support for static session imports, without affect build hierarchy;
wenzelm
parents: 65419
diff changeset
   469
    imports: List[String],
65517
1544e61e5314 more position information;
wenzelm
parents: 65507
diff changeset
   470
    theories: List[(Options, List[(String, Position.T)])],
65374
a5b38d8d3c1e tuned syntax;
wenzelm
parents: 65373
diff changeset
   471
    global_theories: List[String],
72600
2fa4f25d9d07 official support for document theories from other sessions;
wenzelm
parents: 72574
diff changeset
   472
    document_theories: List[(String, Position.T)],
62631
c39614ddb80b clarified modules;
wenzelm
parents:
diff changeset
   473
    document_files: List[(Path, Path)],
69671
2486792eaf61 support pruning of export names;
wenzelm
parents: 69560
diff changeset
   474
    export_files: List[(Path, Int, List[String])],
62631
c39614ddb80b clarified modules;
wenzelm
parents:
diff changeset
   475
    meta_digest: SHA1.Digest)
c39614ddb80b clarified modules;
wenzelm
parents:
diff changeset
   476
  {
72670
4db9411c859c tuned signature;
wenzelm
parents: 72669
diff changeset
   477
    def chapter_session: String = chapter + "/" + name
4db9411c859c tuned signature;
wenzelm
parents: 72669
diff changeset
   478
73042
22f5a6283477 tuned signature;
wenzelm
parents: 73033
diff changeset
   479
    def relative_path(info1: Info): String =
22f5a6283477 tuned signature;
wenzelm
parents: 73033
diff changeset
   480
      if (name == info1.name) ""
22f5a6283477 tuned signature;
wenzelm
parents: 73033
diff changeset
   481
      else if (chapter == info1.chapter) "../" + info1.name + "/"
22f5a6283477 tuned signature;
wenzelm
parents: 73033
diff changeset
   482
      else "../../" + info1.chapter_session + "/"
22f5a6283477 tuned signature;
wenzelm
parents: 73033
diff changeset
   483
66828
3c936ebebc23 tuned signature;
wenzelm
parents: 66823
diff changeset
   484
    def deps: List[String] = parent.toList ::: imports
3c936ebebc23 tuned signature;
wenzelm
parents: 66823
diff changeset
   485
72066
ba5b37671528 clarified signature;
wenzelm
parents: 72065
diff changeset
   486
    def deps_base(session_bases: String => Base): Base =
ba5b37671528 clarified signature;
wenzelm
parents: 72065
diff changeset
   487
    {
ba5b37671528 clarified signature;
wenzelm
parents: 72065
diff changeset
   488
      val parent_base = session_bases(parent.getOrElse(""))
ba5b37671528 clarified signature;
wenzelm
parents: 72065
diff changeset
   489
      val imports_bases = imports.map(session_bases)
ba5b37671528 clarified signature;
wenzelm
parents: 72065
diff changeset
   490
      parent_base.copy(
ba5b37671528 clarified signature;
wenzelm
parents: 72065
diff changeset
   491
        known_theories =
ba5b37671528 clarified signature;
wenzelm
parents: 72065
diff changeset
   492
          (parent_base.known_theories /:
ba5b37671528 clarified signature;
wenzelm
parents: 72065
diff changeset
   493
            (for {
ba5b37671528 clarified signature;
wenzelm
parents: 72065
diff changeset
   494
              base <- imports_bases.iterator
ba5b37671528 clarified signature;
wenzelm
parents: 72065
diff changeset
   495
              (_, entry) <- base.known_theories.iterator
ba5b37671528 clarified signature;
wenzelm
parents: 72065
diff changeset
   496
            } yield (entry.name.theory -> entry)))(_ + _),
ba5b37671528 clarified signature;
wenzelm
parents: 72065
diff changeset
   497
        known_loaded_files =
ba5b37671528 clarified signature;
wenzelm
parents: 72065
diff changeset
   498
          (parent_base.known_loaded_files /:
ba5b37671528 clarified signature;
wenzelm
parents: 72065
diff changeset
   499
            imports_bases.iterator.map(_.known_loaded_files))(_ ++ _))
ba5b37671528 clarified signature;
wenzelm
parents: 72065
diff changeset
   500
    }
ba5b37671528 clarified signature;
wenzelm
parents: 72065
diff changeset
   501
70681
a6c0f2d106c8 disallow overlapping session directories;
wenzelm
parents: 70679
diff changeset
   502
    def dirs: List[Path] = dir :: directories
70668
9cac4dec0da9 support for explicit session directories;
wenzelm
parents: 70650
diff changeset
   503
62631
c39614ddb80b clarified modules;
wenzelm
parents:
diff changeset
   504
    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
   505
72574
d892f6d66402 build documents in Isabelle/Scala, based on generated tex files as session exports;
wenzelm
parents: 72571
diff changeset
   506
    def document_enabled: Boolean =
d892f6d66402 build documents in Isabelle/Scala, based on generated tex files as session exports;
wenzelm
parents: 72571
diff changeset
   507
      options.string("document") match {
d892f6d66402 build documents in Isabelle/Scala, based on generated tex files as session exports;
wenzelm
parents: 72571
diff changeset
   508
        case "" | "false" => false
d892f6d66402 build documents in Isabelle/Scala, based on generated tex files as session exports;
wenzelm
parents: 72571
diff changeset
   509
        case "pdf" => true
d892f6d66402 build documents in Isabelle/Scala, based on generated tex files as session exports;
wenzelm
parents: 72571
diff changeset
   510
        case doc => error("Bad document specification " + quote(doc))
d892f6d66402 build documents in Isabelle/Scala, based on generated tex files as session exports;
wenzelm
parents: 72571
diff changeset
   511
      }
d892f6d66402 build documents in Isabelle/Scala, based on generated tex files as session exports;
wenzelm
parents: 72571
diff changeset
   512
72672
573ccec4dbac tuned signature;
wenzelm
parents: 72670
diff changeset
   513
    def document_variants: List[Presentation.Document_Variant] =
72574
d892f6d66402 build documents in Isabelle/Scala, based on generated tex files as session exports;
wenzelm
parents: 72571
diff changeset
   514
    {
d892f6d66402 build documents in Isabelle/Scala, based on generated tex files as session exports;
wenzelm
parents: 72571
diff changeset
   515
      val variants =
72649
4ba5b1b08dd5 clarified signature: more explicit types;
wenzelm
parents: 72648
diff changeset
   516
        Library.space_explode(':', options.string("document_variants")).
72652
07edf1952ab1 clarified modules;
wenzelm
parents: 72649
diff changeset
   517
          map(Presentation.Document_Variant.parse)
72649
4ba5b1b08dd5 clarified signature: more explicit types;
wenzelm
parents: 72648
diff changeset
   518
4ba5b1b08dd5 clarified signature: more explicit types;
wenzelm
parents: 72648
diff changeset
   519
      val dups = Library.duplicates(variants.map(_.name))
72574
d892f6d66402 build documents in Isabelle/Scala, based on generated tex files as session exports;
wenzelm
parents: 72571
diff changeset
   520
      if (dups.nonEmpty) error("Duplicate document variants: " + commas_quote(dups))
d892f6d66402 build documents in Isabelle/Scala, based on generated tex files as session exports;
wenzelm
parents: 72571
diff changeset
   521
72649
4ba5b1b08dd5 clarified signature: more explicit types;
wenzelm
parents: 72648
diff changeset
   522
      variants
4ba5b1b08dd5 clarified signature: more explicit types;
wenzelm
parents: 72648
diff changeset
   523
    }
4ba5b1b08dd5 clarified signature: more explicit types;
wenzelm
parents: 72648
diff changeset
   524
72652
07edf1952ab1 clarified modules;
wenzelm
parents: 72649
diff changeset
   525
    def documents: List[Presentation.Document_Variant] =
72649
4ba5b1b08dd5 clarified signature: more explicit types;
wenzelm
parents: 72648
diff changeset
   526
    {
72672
573ccec4dbac tuned signature;
wenzelm
parents: 72670
diff changeset
   527
      val variants = document_variants
72574
d892f6d66402 build documents in Isabelle/Scala, based on generated tex files as session exports;
wenzelm
parents: 72571
diff changeset
   528
      if (!document_enabled || document_files.isEmpty) Nil else variants
d892f6d66402 build documents in Isabelle/Scala, based on generated tex files as session exports;
wenzelm
parents: 72571
diff changeset
   529
    }
d892f6d66402 build documents in Isabelle/Scala, based on generated tex files as session exports;
wenzelm
parents: 72571
diff changeset
   530
d892f6d66402 build documents in Isabelle/Scala, based on generated tex files as session exports;
wenzelm
parents: 72571
diff changeset
   531
    def document_output: Option[Path] =
d892f6d66402 build documents in Isabelle/Scala, based on generated tex files as session exports;
wenzelm
parents: 72571
diff changeset
   532
      options.string("document_output") match {
d892f6d66402 build documents in Isabelle/Scala, based on generated tex files as session exports;
wenzelm
parents: 72571
diff changeset
   533
        case "" => None
d892f6d66402 build documents in Isabelle/Scala, based on generated tex files as session exports;
wenzelm
parents: 72571
diff changeset
   534
        case s => Some(dir + Path.explode(s))
d892f6d66402 build documents in Isabelle/Scala, based on generated tex files as session exports;
wenzelm
parents: 72571
diff changeset
   535
      }
d892f6d66402 build documents in Isabelle/Scala, based on generated tex files as session exports;
wenzelm
parents: 72571
diff changeset
   536
72648
1cbac4ae934d more explicit presentation directory;
wenzelm
parents: 72647
diff changeset
   537
    def browser_info: Boolean = options.bool("browser_info")
1cbac4ae934d more explicit presentation directory;
wenzelm
parents: 72647
diff changeset
   538
72613
d01ea9e3bd2d clarified bibtex_entries: refer to overall session structure;
wenzelm
parents: 72604
diff changeset
   539
    lazy val bibtex_entries: List[Text.Info[String]] =
67297
86a099f896fc formal check of @{cite} bibtex entries -- only in batch-mode session builds;
wenzelm
parents: 67290
diff changeset
   540
      (for {
86a099f896fc formal check of @{cite} bibtex entries -- only in batch-mode session builds;
wenzelm
parents: 67290
diff changeset
   541
        (document_dir, file) <- document_files.iterator
69366
b6dacf6eabe3 clarified signature;
wenzelm
parents: 69255
diff changeset
   542
        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
   543
        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
   544
      } yield info).toList
70859
6e6254bbce1f split into standard partitions, for improved scalability;
wenzelm
parents: 70796
diff changeset
   545
70869
1d063b7f7928 incorporate sessions with record_proofs;
wenzelm
parents: 70867
diff changeset
   546
    def record_proofs: Boolean = options.int("record_proofs") >= 2
1d063b7f7928 incorporate sessions with record_proofs;
wenzelm
parents: 70867
diff changeset
   547
70859
6e6254bbce1f split into standard partitions, for improved scalability;
wenzelm
parents: 70796
diff changeset
   548
    def is_afp: Boolean = chapter == AFP.chapter
6e6254bbce1f split into standard partitions, for improved scalability;
wenzelm
parents: 70796
diff changeset
   549
    def is_afp_bulky: Boolean = is_afp && groups.exists(AFP.groups_bulky.contains)
62631
c39614ddb80b clarified modules;
wenzelm
parents:
diff changeset
   550
  }
c39614ddb80b clarified modules;
wenzelm
parents:
diff changeset
   551
66967
e365c91c72a9 synthesize session with all required theories from other session imports;
wenzelm
parents: 66966
diff changeset
   552
  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
   553
    entry: Session_Entry): Info =
e365c91c72a9 synthesize session with all required theories from other session imports;
wenzelm
parents: 66966
diff changeset
   554
  {
e365c91c72a9 synthesize session with all required theories from other session imports;
wenzelm
parents: 66966
diff changeset
   555
    try {
e365c91c72a9 synthesize session with all required theories from other session imports;
wenzelm
parents: 66966
diff changeset
   556
      val name = entry.name
e365c91c72a9 synthesize session with all required theories from other session imports;
wenzelm
parents: 66966
diff changeset
   557
67284
0094d938c53b tuned signature;
wenzelm
parents: 67219
diff changeset
   558
      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
   559
      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
   560
      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
   561
70672
e4bba654d085 clarified session_directories: relative to session_path, with overlapping information;
wenzelm
parents: 70671
diff changeset
   562
      val session_path = dir + Path.explode(entry.path)
70681
a6c0f2d106c8 disallow overlapping session directories;
wenzelm
parents: 70679
diff changeset
   563
      val directories = entry.directories.map(dir => session_path + Path.explode(dir))
70668
9cac4dec0da9 support for explicit session directories;
wenzelm
parents: 70650
diff changeset
   564
66967
e365c91c72a9 synthesize session with all required theories from other session imports;
wenzelm
parents: 66966
diff changeset
   565
      val session_options = options ++ entry.options
e365c91c72a9 synthesize session with all required theories from other session imports;
wenzelm
parents: 66966
diff changeset
   566
e365c91c72a9 synthesize session with all required theories from other session imports;
wenzelm
parents: 66966
diff changeset
   567
      val theories =
67216
99815211970c disallow theory name "ROOT";
wenzelm
parents: 67215
diff changeset
   568
        entry.theories.map({ case (opts, thys) =>
99815211970c disallow theory name "ROOT";
wenzelm
parents: 67215
diff changeset
   569
          (session_options ++ opts,
99815211970c disallow theory name "ROOT";
wenzelm
parents: 67215
diff changeset
   570
            thys.map({ case ((thy, pos), _) =>
67284
0094d938c53b tuned signature;
wenzelm
parents: 67219
diff changeset
   571
              if (exclude_theory(thy))
67216
99815211970c disallow theory name "ROOT";
wenzelm
parents: 67215
diff changeset
   572
                error("Bad theory name " + quote(thy) + Position.here(pos))
99815211970c disallow theory name "ROOT";
wenzelm
parents: 67215
diff changeset
   573
              else (thy, pos) })) })
66967
e365c91c72a9 synthesize session with all required theories from other session imports;
wenzelm
parents: 66966
diff changeset
   574
e365c91c72a9 synthesize session with all required theories from other session imports;
wenzelm
parents: 66966
diff changeset
   575
      val global_theories =
e365c91c72a9 synthesize session with all required theories from other session imports;
wenzelm
parents: 66966
diff changeset
   576
        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
   577
        yield {
69366
b6dacf6eabe3 clarified signature;
wenzelm
parents: 69255
diff changeset
   578
          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
   579
          if (Long_Name.is_qualified(thy_name))
e365c91c72a9 synthesize session with all required theories from other session imports;
wenzelm
parents: 66966
diff changeset
   580
            error("Bad qualified name for global theory " +
e365c91c72a9 synthesize session with all required theories from other session imports;
wenzelm
parents: 66966
diff changeset
   581
              quote(thy_name) + Position.here(pos))
e365c91c72a9 synthesize session with all required theories from other session imports;
wenzelm
parents: 66966
diff changeset
   582
          else thy_name
e365c91c72a9 synthesize session with all required theories from other session imports;
wenzelm
parents: 66966
diff changeset
   583
        }
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 conditions =
e365c91c72a9 synthesize session with all required theories from other session imports;
wenzelm
parents: 66966
diff changeset
   586
        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
   587
          map(x => (x, Isabelle_System.getenv(x) != ""))
e365c91c72a9 synthesize session with all required theories from other session imports;
wenzelm
parents: 66966
diff changeset
   588
e365c91c72a9 synthesize session with all required theories from other session imports;
wenzelm
parents: 66966
diff changeset
   589
      val document_files =
e365c91c72a9 synthesize session with all required theories from other session imports;
wenzelm
parents: 66966
diff changeset
   590
        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
   591
68292
7ca0c23179e6 support 'export_files' in session ROOT;
wenzelm
parents: 68221
diff changeset
   592
      val export_files =
69671
2486792eaf61 support pruning of export names;
wenzelm
parents: 69560
diff changeset
   593
        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
   594
66967
e365c91c72a9 synthesize session with all required theories from other session imports;
wenzelm
parents: 66966
diff changeset
   595
      val meta_digest =
72600
2fa4f25d9d07 official support for document theories from other sessions;
wenzelm
parents: 72574
diff changeset
   596
        SHA1.digest(
2fa4f25d9d07 official support for document theories from other sessions;
wenzelm
parents: 72574
diff changeset
   597
          (name, chapter, entry.parent, entry.directories, entry.options, entry.imports,
72666
945cee776e79 proper meta_digest: avoid non-portable position information;
wenzelm
parents: 72653
diff changeset
   598
            entry.theories_no_position, conditions, entry.document_theories_no_position,
945cee776e79 proper meta_digest: avoid non-portable position information;
wenzelm
parents: 72653
diff changeset
   599
            entry.document_files)
72600
2fa4f25d9d07 official support for document theories from other sessions;
wenzelm
parents: 72574
diff changeset
   600
          .toString)
66967
e365c91c72a9 synthesize session with all required theories from other session imports;
wenzelm
parents: 66966
diff changeset
   601
70672
e4bba654d085 clarified session_directories: relative to session_path, with overlapping information;
wenzelm
parents: 70671
diff changeset
   602
      Info(name, chapter, dir_selected, entry.pos, entry.groups, session_path,
70668
9cac4dec0da9 support for explicit session directories;
wenzelm
parents: 70650
diff changeset
   603
        entry.parent, entry.description, directories, session_options,
72600
2fa4f25d9d07 official support for document theories from other sessions;
wenzelm
parents: 72574
diff changeset
   604
        entry.imports, theories, global_theories, entry.document_theories, document_files,
2fa4f25d9d07 official support for document theories from other sessions;
wenzelm
parents: 72574
diff changeset
   605
        export_files, meta_digest)
66967
e365c91c72a9 synthesize session with all required theories from other session imports;
wenzelm
parents: 66966
diff changeset
   606
    }
e365c91c72a9 synthesize session with all required theories from other session imports;
wenzelm
parents: 66966
diff changeset
   607
    catch {
e365c91c72a9 synthesize session with all required theories from other session imports;
wenzelm
parents: 66966
diff changeset
   608
      case ERROR(msg) =>
e365c91c72a9 synthesize session with all required theories from other session imports;
wenzelm
parents: 66966
diff changeset
   609
        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
   610
          quote(entry.name) + Position.here(entry.pos))
e365c91c72a9 synthesize session with all required theories from other session imports;
wenzelm
parents: 66966
diff changeset
   611
    }
e365c91c72a9 synthesize session with all required theories from other session imports;
wenzelm
parents: 66966
diff changeset
   612
  }
e365c91c72a9 synthesize session with all required theories from other session imports;
wenzelm
parents: 66966
diff changeset
   613
65419
457e4fbed731 explicit Sessions.Selection;
wenzelm
parents: 65415
diff changeset
   614
  object Selection
457e4fbed731 explicit Sessions.Selection;
wenzelm
parents: 65415
diff changeset
   615
  {
65422
b606c98e6d10 tuned signature;
wenzelm
parents: 65420
diff changeset
   616
    val empty: Selection = Selection()
65525
360063716c71 more operations;
wenzelm
parents: 65524
diff changeset
   617
    val all: Selection = Selection(all_sessions = true)
70788
b254a95b6e77 tuned signature;
wenzelm
parents: 70740
diff changeset
   618
    def session(session: String): Selection = Selection(sessions = List(session))
65419
457e4fbed731 explicit Sessions.Selection;
wenzelm
parents: 65415
diff changeset
   619
  }
457e4fbed731 explicit Sessions.Selection;
wenzelm
parents: 65415
diff changeset
   620
457e4fbed731 explicit Sessions.Selection;
wenzelm
parents: 65415
diff changeset
   621
  sealed case class Selection(
457e4fbed731 explicit Sessions.Selection;
wenzelm
parents: 65415
diff changeset
   622
    requirements: Boolean = false,
457e4fbed731 explicit Sessions.Selection;
wenzelm
parents: 65415
diff changeset
   623
    all_sessions: Boolean = false,
66737
2edc0c42c883 option -B for "isabelle build" and "isabelle imports";
wenzelm
parents: 66736
diff changeset
   624
    base_sessions: List[String] = Nil,
65419
457e4fbed731 explicit Sessions.Selection;
wenzelm
parents: 65415
diff changeset
   625
    exclude_session_groups: List[String] = Nil,
457e4fbed731 explicit Sessions.Selection;
wenzelm
parents: 65415
diff changeset
   626
    exclude_sessions: List[String] = Nil,
457e4fbed731 explicit Sessions.Selection;
wenzelm
parents: 65415
diff changeset
   627
    session_groups: List[String] = Nil,
457e4fbed731 explicit Sessions.Selection;
wenzelm
parents: 65415
diff changeset
   628
    sessions: List[String] = Nil)
457e4fbed731 explicit Sessions.Selection;
wenzelm
parents: 65415
diff changeset
   629
  {
66736
148891036469 more standard merge operation;
wenzelm
parents: 66722
diff changeset
   630
    def ++ (other: Selection): Selection =
65422
b606c98e6d10 tuned signature;
wenzelm
parents: 65420
diff changeset
   631
      Selection(
b606c98e6d10 tuned signature;
wenzelm
parents: 65420
diff changeset
   632
        requirements = requirements || other.requirements,
b606c98e6d10 tuned signature;
wenzelm
parents: 65420
diff changeset
   633
        all_sessions = all_sessions || other.all_sessions,
66737
2edc0c42c883 option -B for "isabelle build" and "isabelle imports";
wenzelm
parents: 66736
diff changeset
   634
        base_sessions = Library.merge(base_sessions, other.base_sessions),
66736
148891036469 more standard merge operation;
wenzelm
parents: 66722
diff changeset
   635
        exclude_session_groups = Library.merge(exclude_session_groups, other.exclude_session_groups),
148891036469 more standard merge operation;
wenzelm
parents: 66722
diff changeset
   636
        exclude_sessions = Library.merge(exclude_sessions, other.exclude_sessions),
148891036469 more standard merge operation;
wenzelm
parents: 66722
diff changeset
   637
        session_groups = Library.merge(session_groups, other.session_groups),
148891036469 more standard merge operation;
wenzelm
parents: 66722
diff changeset
   638
        sessions = Library.merge(sessions, other.sessions))
65419
457e4fbed731 explicit Sessions.Selection;
wenzelm
parents: 65415
diff changeset
   639
  }
457e4fbed731 explicit Sessions.Selection;
wenzelm
parents: 65415
diff changeset
   640
72855
e0f6fa6ff3d0 tuned signature;
wenzelm
parents: 72854
diff changeset
   641
  object Structure
62631
c39614ddb80b clarified modules;
wenzelm
parents:
diff changeset
   642
  {
72858
cb0c407fbc6e added "isabelle log": print messages from build database;
wenzelm
parents: 72855
diff changeset
   643
    val empty: Structure = make(Nil)
cb0c407fbc6e added "isabelle log": print messages from build database;
wenzelm
parents: 72855
diff changeset
   644
72855
e0f6fa6ff3d0 tuned signature;
wenzelm
parents: 72854
diff changeset
   645
    def make(infos: List[Info]): Structure =
65420
695d4e22345a support for static session imports, without affect build hierarchy;
wenzelm
parents: 65419
diff changeset
   646
    {
72855
e0f6fa6ff3d0 tuned signature;
wenzelm
parents: 72854
diff changeset
   647
      def add_edges(graph: Graph[String, Info], kind: String, edges: Info => Traversable[String])
e0f6fa6ff3d0 tuned signature;
wenzelm
parents: 72854
diff changeset
   648
        : Graph[String, Info] =
65420
695d4e22345a support for static session imports, without affect build hierarchy;
wenzelm
parents: 65419
diff changeset
   649
      {
72855
e0f6fa6ff3d0 tuned signature;
wenzelm
parents: 72854
diff changeset
   650
        def add_edge(pos: Position.T, name: String, g: Graph[String, Info], parent: String) =
e0f6fa6ff3d0 tuned signature;
wenzelm
parents: 72854
diff changeset
   651
        {
e0f6fa6ff3d0 tuned signature;
wenzelm
parents: 72854
diff changeset
   652
          if (!g.defined(parent))
e0f6fa6ff3d0 tuned signature;
wenzelm
parents: 72854
diff changeset
   653
            error("Bad " + kind + " session " + quote(parent) + " for " +
e0f6fa6ff3d0 tuned signature;
wenzelm
parents: 72854
diff changeset
   654
              quote(name) + Position.here(pos))
65420
695d4e22345a support for static session imports, without affect build hierarchy;
wenzelm
parents: 65419
diff changeset
   655
72855
e0f6fa6ff3d0 tuned signature;
wenzelm
parents: 72854
diff changeset
   656
          try { g.add_edge_acyclic(parent, name) }
e0f6fa6ff3d0 tuned signature;
wenzelm
parents: 72854
diff changeset
   657
          catch {
e0f6fa6ff3d0 tuned signature;
wenzelm
parents: 72854
diff changeset
   658
            case exn: Graph.Cycles[_] =>
e0f6fa6ff3d0 tuned signature;
wenzelm
parents: 72854
diff changeset
   659
              error(cat_lines(exn.cycles.map(cycle =>
e0f6fa6ff3d0 tuned signature;
wenzelm
parents: 72854
diff changeset
   660
                "Cyclic session dependency of " +
e0f6fa6ff3d0 tuned signature;
wenzelm
parents: 72854
diff changeset
   661
                  cycle.map(c => quote(c.toString)).mkString(" via "))) + Position.here(pos))
e0f6fa6ff3d0 tuned signature;
wenzelm
parents: 72854
diff changeset
   662
          }
e0f6fa6ff3d0 tuned signature;
wenzelm
parents: 72854
diff changeset
   663
        }
e0f6fa6ff3d0 tuned signature;
wenzelm
parents: 72854
diff changeset
   664
        (graph /: graph.iterator) {
e0f6fa6ff3d0 tuned signature;
wenzelm
parents: 72854
diff changeset
   665
          case (g, (name, (info, _))) => (g /: edges(info))(add_edge(info.pos, name, _, _))
65420
695d4e22345a support for static session imports, without affect build hierarchy;
wenzelm
parents: 65419
diff changeset
   666
        }
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
72855
e0f6fa6ff3d0 tuned signature;
wenzelm
parents: 72854
diff changeset
   669
      val info_graph =
e0f6fa6ff3d0 tuned signature;
wenzelm
parents: 72854
diff changeset
   670
        (Graph.string[Info] /: infos) {
e0f6fa6ff3d0 tuned signature;
wenzelm
parents: 72854
diff changeset
   671
          case (graph, info) =>
e0f6fa6ff3d0 tuned signature;
wenzelm
parents: 72854
diff changeset
   672
            if (graph.defined(info.name))
e0f6fa6ff3d0 tuned signature;
wenzelm
parents: 72854
diff changeset
   673
              error("Duplicate session " + quote(info.name) + Position.here(info.pos) +
e0f6fa6ff3d0 tuned signature;
wenzelm
parents: 72854
diff changeset
   674
                Position.here(graph.get_node(info.name).pos))
e0f6fa6ff3d0 tuned signature;
wenzelm
parents: 72854
diff changeset
   675
            else graph.new_node(info.name, info)
e0f6fa6ff3d0 tuned signature;
wenzelm
parents: 72854
diff changeset
   676
        }
e0f6fa6ff3d0 tuned signature;
wenzelm
parents: 72854
diff changeset
   677
      val build_graph = add_edges(info_graph, "parent", _.parent)
e0f6fa6ff3d0 tuned signature;
wenzelm
parents: 72854
diff changeset
   678
      val imports_graph = add_edges(build_graph, "imports", _.imports)
62631
c39614ddb80b clarified modules;
wenzelm
parents:
diff changeset
   679
72855
e0f6fa6ff3d0 tuned signature;
wenzelm
parents: 72854
diff changeset
   680
      val session_positions: List[(String, Position.T)] =
e0f6fa6ff3d0 tuned signature;
wenzelm
parents: 72854
diff changeset
   681
        (for ((name, (info, _)) <- info_graph.iterator) yield (name, info.pos)).toList
70683
8c7706b053c7 find theory files via session structure: much faster Prover IDE startup;
wenzelm
parents: 70681
diff changeset
   682
72855
e0f6fa6ff3d0 tuned signature;
wenzelm
parents: 72854
diff changeset
   683
      val session_directories: Map[JFile, String] =
e0f6fa6ff3d0 tuned signature;
wenzelm
parents: 72854
diff changeset
   684
        (Map.empty[JFile, String] /:
e0f6fa6ff3d0 tuned signature;
wenzelm
parents: 72854
diff changeset
   685
          (for {
e0f6fa6ff3d0 tuned signature;
wenzelm
parents: 72854
diff changeset
   686
            session <- imports_graph.topological_order.iterator
e0f6fa6ff3d0 tuned signature;
wenzelm
parents: 72854
diff changeset
   687
            info = info_graph.get_node(session)
e0f6fa6ff3d0 tuned signature;
wenzelm
parents: 72854
diff changeset
   688
            dir <- info.dirs.iterator
e0f6fa6ff3d0 tuned signature;
wenzelm
parents: 72854
diff changeset
   689
          } yield (info, dir)))({ case (dirs, (info, dir)) =>
e0f6fa6ff3d0 tuned signature;
wenzelm
parents: 72854
diff changeset
   690
              val session = info.name
e0f6fa6ff3d0 tuned signature;
wenzelm
parents: 72854
diff changeset
   691
              val canonical_dir = dir.canonical_file
e0f6fa6ff3d0 tuned signature;
wenzelm
parents: 72854
diff changeset
   692
              dirs.get(canonical_dir) match {
e0f6fa6ff3d0 tuned signature;
wenzelm
parents: 72854
diff changeset
   693
                case Some(session1) =>
e0f6fa6ff3d0 tuned signature;
wenzelm
parents: 72854
diff changeset
   694
                  val info1 = info_graph.get_node(session1)
e0f6fa6ff3d0 tuned signature;
wenzelm
parents: 72854
diff changeset
   695
                  error("Duplicate use of directory " + dir +
e0f6fa6ff3d0 tuned signature;
wenzelm
parents: 72854
diff changeset
   696
                    "\n  for session " + quote(session1) + Position.here(info1.pos) +
e0f6fa6ff3d0 tuned signature;
wenzelm
parents: 72854
diff changeset
   697
                    "\n  vs. session " + quote(session) + Position.here(info.pos))
e0f6fa6ff3d0 tuned signature;
wenzelm
parents: 72854
diff changeset
   698
                case None => dirs + (canonical_dir -> session)
e0f6fa6ff3d0 tuned signature;
wenzelm
parents: 72854
diff changeset
   699
              }
e0f6fa6ff3d0 tuned signature;
wenzelm
parents: 72854
diff changeset
   700
            })
70671
cb1776c8e216 clarified signature: retain global session information, unaffected by later restriction;
wenzelm
parents: 70668
diff changeset
   701
72855
e0f6fa6ff3d0 tuned signature;
wenzelm
parents: 72854
diff changeset
   702
      val global_theories: Map[String, String] =
e0f6fa6ff3d0 tuned signature;
wenzelm
parents: 72854
diff changeset
   703
        (Thy_Header.bootstrap_global_theories.toMap /:
e0f6fa6ff3d0 tuned signature;
wenzelm
parents: 72854
diff changeset
   704
          (for {
e0f6fa6ff3d0 tuned signature;
wenzelm
parents: 72854
diff changeset
   705
            session <- imports_graph.topological_order.iterator
e0f6fa6ff3d0 tuned signature;
wenzelm
parents: 72854
diff changeset
   706
            info = info_graph.get_node(session)
e0f6fa6ff3d0 tuned signature;
wenzelm
parents: 72854
diff changeset
   707
            thy <- info.global_theories.iterator }
e0f6fa6ff3d0 tuned signature;
wenzelm
parents: 72854
diff changeset
   708
           yield (info, thy)))({ case (global, (info, thy)) =>
e0f6fa6ff3d0 tuned signature;
wenzelm
parents: 72854
diff changeset
   709
              val qualifier = info.name
e0f6fa6ff3d0 tuned signature;
wenzelm
parents: 72854
diff changeset
   710
              global.get(thy) match {
e0f6fa6ff3d0 tuned signature;
wenzelm
parents: 72854
diff changeset
   711
                case Some(qualifier1) if qualifier != qualifier1 =>
e0f6fa6ff3d0 tuned signature;
wenzelm
parents: 72854
diff changeset
   712
                  error("Duplicate global theory " + quote(thy) + Position.here(info.pos))
e0f6fa6ff3d0 tuned signature;
wenzelm
parents: 72854
diff changeset
   713
                case _ => global + (thy -> qualifier)
e0f6fa6ff3d0 tuned signature;
wenzelm
parents: 72854
diff changeset
   714
              }
e0f6fa6ff3d0 tuned signature;
wenzelm
parents: 72854
diff changeset
   715
            })
70671
cb1776c8e216 clarified signature: retain global session information, unaffected by later restriction;
wenzelm
parents: 70668
diff changeset
   716
72855
e0f6fa6ff3d0 tuned signature;
wenzelm
parents: 72854
diff changeset
   717
      new Structure(
e0f6fa6ff3d0 tuned signature;
wenzelm
parents: 72854
diff changeset
   718
        session_positions, session_directories, global_theories, build_graph, imports_graph)
e0f6fa6ff3d0 tuned signature;
wenzelm
parents: 72854
diff changeset
   719
    }
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
72845
60f56f623be2 tuned signature;
wenzelm
parents: 72839
diff changeset
   731
    def bootstrap: Base =
60f56f623be2 tuned signature;
wenzelm
parents: 72839
diff changeset
   732
      Base(
60f56f623be2 tuned signature;
wenzelm
parents: 72839
diff changeset
   733
        session_directories = session_directories,
60f56f623be2 tuned signature;
wenzelm
parents: 72839
diff changeset
   734
        global_theories = global_theories,
60f56f623be2 tuned signature;
wenzelm
parents: 72839
diff changeset
   735
        overall_syntax = Thy_Header.bootstrap_syntax)
60f56f623be2 tuned signature;
wenzelm
parents: 72839
diff changeset
   736
70683
8c7706b053c7 find theory files via session structure: much faster Prover IDE startup;
wenzelm
parents: 70681
diff changeset
   737
    def dest_session_directories: List[(String, String)] =
8c7706b053c7 find theory files via session structure: much faster Prover IDE startup;
wenzelm
parents: 70681
diff changeset
   738
      for ((file, session) <- session_directories.toList)
8c7706b053c7 find theory files via session structure: much faster Prover IDE startup;
wenzelm
parents: 70681
diff changeset
   739
        yield (File.standard_path(file), session)
8c7706b053c7 find theory files via session structure: much faster Prover IDE startup;
wenzelm
parents: 70681
diff changeset
   740
69762
58fb0d779583 support for session information via virtual file-system;
wenzelm
parents: 69671
diff changeset
   741
    lazy val chapters: SortedMap[String, List[Info]] =
58fb0d779583 support for session information via virtual file-system;
wenzelm
parents: 69671
diff changeset
   742
      (SortedMap.empty[String, List[Info]] /: build_graph.iterator)(
58fb0d779583 support for session information via virtual file-system;
wenzelm
parents: 69671
diff changeset
   743
        { case (chs, (_, (info, _))) =>
58fb0d779583 support for session information via virtual file-system;
wenzelm
parents: 69671
diff changeset
   744
            chs + (info.chapter -> (info :: chs.getOrElse(info.chapter, Nil))) })
58fb0d779583 support for session information via virtual file-system;
wenzelm
parents: 69671
diff changeset
   745
66823
f529719cc47d operations for graph display;
wenzelm
parents: 66822
diff changeset
   746
    def build_graph_display: Graph_Display.Graph = Graph_Display.make_graph(build_graph)
f529719cc47d operations for graph display;
wenzelm
parents: 66822
diff changeset
   747
    def imports_graph_display: Graph_Display.Graph = Graph_Display.make_graph(imports_graph)
f529719cc47d operations for graph display;
wenzelm
parents: 66822
diff changeset
   748
67025
961285f581e6 clarifified selection: always wrt. build_graph structure;
wenzelm
parents: 67024
diff changeset
   749
    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
   750
    def apply(name: String): Info = imports_graph.get_node(name)
67025
961285f581e6 clarifified selection: always wrt. build_graph structure;
wenzelm
parents: 67024
diff changeset
   751
    def get(name: String): Option[Info] = if (defined(name)) Some(apply(name)) else None
62631
c39614ddb80b clarified modules;
wenzelm
parents:
diff changeset
   752
70859
6e6254bbce1f split into standard partitions, for improved scalability;
wenzelm
parents: 70796
diff changeset
   753
    def theory_qualifier(name: String): String =
6e6254bbce1f split into standard partitions, for improved scalability;
wenzelm
parents: 70796
diff changeset
   754
      global_theories.getOrElse(name, Long_Name.qualifier(name))
6e6254bbce1f split into standard partitions, for improved scalability;
wenzelm
parents: 70796
diff changeset
   755
68542
02df6c68a8cb clarified error;
wenzelm
parents: 68523
diff changeset
   756
    def check_sessions(names: List[String])
02df6c68a8cb clarified error;
wenzelm
parents: 68523
diff changeset
   757
    {
71601
97ccf48c2f0c misc tuning based on hints by IntelliJ IDEA;
wenzelm
parents: 71599
diff changeset
   758
      val bad_sessions = SortedSet(names.filterNot(defined): _*).toList
68542
02df6c68a8cb clarified error;
wenzelm
parents: 68523
diff changeset
   759
      if (bad_sessions.nonEmpty)
02df6c68a8cb clarified error;
wenzelm
parents: 68523
diff changeset
   760
        error("Undefined session(s): " + commas_quote(bad_sessions))
02df6c68a8cb clarified error;
wenzelm
parents: 68523
diff changeset
   761
    }
02df6c68a8cb clarified error;
wenzelm
parents: 68523
diff changeset
   762
68733
76e339ef60e3 more uniform checks;
wenzelm
parents: 68732
diff changeset
   763
    def check_sessions(sel: Selection): Unit =
76e339ef60e3 more uniform checks;
wenzelm
parents: 68732
diff changeset
   764
      check_sessions(sel.base_sessions ::: sel.exclude_sessions ::: sel.sessions)
76e339ef60e3 more uniform checks;
wenzelm
parents: 68732
diff changeset
   765
68732
5472f4409fe6 tuned signature;
wenzelm
parents: 68542
diff changeset
   766
    private def selected(graph: Graph[String, Info], sel: Selection): List[String] =
5472f4409fe6 tuned signature;
wenzelm
parents: 68542
diff changeset
   767
    {
68733
76e339ef60e3 more uniform checks;
wenzelm
parents: 68732
diff changeset
   768
      check_sessions(sel)
76e339ef60e3 more uniform checks;
wenzelm
parents: 68732
diff changeset
   769
68732
5472f4409fe6 tuned signature;
wenzelm
parents: 68542
diff changeset
   770
      val select_group = sel.session_groups.toSet
68734
c14a2cc9b5ef isabelle build options -c -x -B refer to imports_graph;
wenzelm
parents: 68733
diff changeset
   771
      val select_session = sel.sessions.toSet ++ imports_graph.all_succs(sel.base_sessions)
68732
5472f4409fe6 tuned signature;
wenzelm
parents: 68542
diff changeset
   772
5472f4409fe6 tuned signature;
wenzelm
parents: 68542
diff changeset
   773
      val selected0 =
5472f4409fe6 tuned signature;
wenzelm
parents: 68542
diff changeset
   774
        if (sel.all_sessions) graph.keys
5472f4409fe6 tuned signature;
wenzelm
parents: 68542
diff changeset
   775
        else {
5472f4409fe6 tuned signature;
wenzelm
parents: 68542
diff changeset
   776
          (for {
5472f4409fe6 tuned signature;
wenzelm
parents: 68542
diff changeset
   777
            (name, (info, _)) <- graph.iterator
5472f4409fe6 tuned signature;
wenzelm
parents: 68542
diff changeset
   778
            if info.dir_selected || select_session(name) ||
5472f4409fe6 tuned signature;
wenzelm
parents: 68542
diff changeset
   779
              graph.get_node(name).groups.exists(select_group)
5472f4409fe6 tuned signature;
wenzelm
parents: 68542
diff changeset
   780
          } yield name).toList
5472f4409fe6 tuned signature;
wenzelm
parents: 68542
diff changeset
   781
        }
5472f4409fe6 tuned signature;
wenzelm
parents: 68542
diff changeset
   782
5472f4409fe6 tuned signature;
wenzelm
parents: 68542
diff changeset
   783
      if (sel.requirements) (graph.all_preds(selected0).toSet -- selected0).toList
5472f4409fe6 tuned signature;
wenzelm
parents: 68542
diff changeset
   784
      else selected0
5472f4409fe6 tuned signature;
wenzelm
parents: 68542
diff changeset
   785
    }
5472f4409fe6 tuned signature;
wenzelm
parents: 68542
diff changeset
   786
67052
caf87d4b9b61 tuned signature;
wenzelm
parents: 67029
diff changeset
   787
    def selection(sel: Selection): Structure =
62631
c39614ddb80b clarified modules;
wenzelm
parents:
diff changeset
   788
    {
68733
76e339ef60e3 more uniform checks;
wenzelm
parents: 68732
diff changeset
   789
      check_sessions(sel)
67025
961285f581e6 clarifified selection: always wrt. build_graph structure;
wenzelm
parents: 67024
diff changeset
   790
68732
5472f4409fe6 tuned signature;
wenzelm
parents: 68542
diff changeset
   791
      val excluded =
5472f4409fe6 tuned signature;
wenzelm
parents: 68542
diff changeset
   792
      {
5472f4409fe6 tuned signature;
wenzelm
parents: 68542
diff changeset
   793
        val exclude_group = sel.exclude_session_groups.toSet
5472f4409fe6 tuned signature;
wenzelm
parents: 68542
diff changeset
   794
        val exclude_group_sessions =
5472f4409fe6 tuned signature;
wenzelm
parents: 68542
diff changeset
   795
          (for {
68734
c14a2cc9b5ef isabelle build options -c -x -B refer to imports_graph;
wenzelm
parents: 68733
diff changeset
   796
            (name, (info, _)) <- imports_graph.iterator
c14a2cc9b5ef isabelle build options -c -x -B refer to imports_graph;
wenzelm
parents: 68733
diff changeset
   797
            if imports_graph.get_node(name).groups.exists(exclude_group)
68732
5472f4409fe6 tuned signature;
wenzelm
parents: 68542
diff changeset
   798
          } yield name).toList
68734
c14a2cc9b5ef isabelle build options -c -x -B refer to imports_graph;
wenzelm
parents: 68733
diff changeset
   799
        imports_graph.all_succs(exclude_group_sessions ::: sel.exclude_sessions).toSet
68732
5472f4409fe6 tuned signature;
wenzelm
parents: 68542
diff changeset
   800
      }
67027
wenzelm
parents: 67026
diff changeset
   801
67025
961285f581e6 clarifified selection: always wrt. build_graph structure;
wenzelm
parents: 67024
diff changeset
   802
      def restrict(graph: Graph[String, Info]): Graph[String, Info] =
961285f581e6 clarifified selection: always wrt. build_graph structure;
wenzelm
parents: 67024
diff changeset
   803
      {
68732
5472f4409fe6 tuned signature;
wenzelm
parents: 68542
diff changeset
   804
        val sessions = graph.all_preds(selected(graph, sel)).filterNot(excluded)
67029
d6d9fd2559ce clarified signature (again);
wenzelm
parents: 67028
diff changeset
   805
        graph.restrict(graph.all_preds(sessions).toSet)
67025
961285f581e6 clarifified selection: always wrt. build_graph structure;
wenzelm
parents: 67024
diff changeset
   806
      }
961285f581e6 clarifified selection: always wrt. build_graph structure;
wenzelm
parents: 67024
diff changeset
   807
70671
cb1776c8e216 clarified signature: retain global session information, unaffected by later restriction;
wenzelm
parents: 70668
diff changeset
   808
      new Structure(
70683
8c7706b053c7 find theory files via session structure: much faster Prover IDE startup;
wenzelm
parents: 70681
diff changeset
   809
        session_positions, session_directories, global_theories,
8c7706b053c7 find theory files via session structure: much faster Prover IDE startup;
wenzelm
parents: 70681
diff changeset
   810
        restrict(build_graph), restrict(imports_graph))
62631
c39614ddb80b clarified modules;
wenzelm
parents:
diff changeset
   811
    }
c39614ddb80b clarified modules;
wenzelm
parents:
diff changeset
   812
72571
ab4a0b19648a tuned signature;
wenzelm
parents: 72565
diff changeset
   813
    def selection(session: String): Structure = selection(Selection.session(session))
ab4a0b19648a tuned signature;
wenzelm
parents: 72565
diff changeset
   814
69524
fa94f2b2a877 clarified sessions_deps, according to Isabelle/MMT usage;
wenzelm
parents: 69393
diff changeset
   815
    def selection_deps(
fa94f2b2a877 clarified sessions_deps, according to Isabelle/MMT usage;
wenzelm
parents: 69393
diff changeset
   816
      selection: Selection,
71726
a5fda30edae2 clarified signature: more uniform treatment of stopped/interrupted state;
wenzelm
parents: 71642
diff changeset
   817
      progress: Progress = new Progress,
69524
fa94f2b2a877 clarified sessions_deps, according to Isabelle/MMT usage;
wenzelm
parents: 69393
diff changeset
   818
      loading_sessions: Boolean = false,
68304
09270aa40884 tuned signature;
wenzelm
parents: 68294
diff changeset
   819
      inlined_files: Boolean = false,
09270aa40884 tuned signature;
wenzelm
parents: 68294
diff changeset
   820
      verbose: Boolean = false): Deps =
09270aa40884 tuned signature;
wenzelm
parents: 68294
diff changeset
   821
    {
69524
fa94f2b2a877 clarified sessions_deps, according to Isabelle/MMT usage;
wenzelm
parents: 69393
diff changeset
   822
      val deps =
70869
1d063b7f7928 incorporate sessions with record_proofs;
wenzelm
parents: 70867
diff changeset
   823
        Sessions.deps(sessions_structure.selection(selection),
69524
fa94f2b2a877 clarified sessions_deps, according to Isabelle/MMT usage;
wenzelm
parents: 69393
diff changeset
   824
          progress = progress, inlined_files = inlined_files, verbose = verbose)
fa94f2b2a877 clarified sessions_deps, according to Isabelle/MMT usage;
wenzelm
parents: 69393
diff changeset
   825
fa94f2b2a877 clarified sessions_deps, according to Isabelle/MMT usage;
wenzelm
parents: 69393
diff changeset
   826
      if (loading_sessions) {
fa94f2b2a877 clarified sessions_deps, according to Isabelle/MMT usage;
wenzelm
parents: 69393
diff changeset
   827
        val selection_size = deps.sessions_structure.build_graph.size
fa94f2b2a877 clarified sessions_deps, according to Isabelle/MMT usage;
wenzelm
parents: 69393
diff changeset
   828
        if (selection_size > 1) progress.echo("Loading " + selection_size + " sessions ...")
fa94f2b2a877 clarified sessions_deps, according to Isabelle/MMT usage;
wenzelm
parents: 69393
diff changeset
   829
      }
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
      deps
68304
09270aa40884 tuned signature;
wenzelm
parents: 68294
diff changeset
   832
    }
09270aa40884 tuned signature;
wenzelm
parents: 68294
diff changeset
   833
72854
6c660f05f70c clarified signature;
wenzelm
parents: 72847
diff changeset
   834
    def hierarchy(session: String): List[String] = build_graph.all_preds(List(session))
6c660f05f70c clarified signature;
wenzelm
parents: 72847
diff changeset
   835
68732
5472f4409fe6 tuned signature;
wenzelm
parents: 68542
diff changeset
   836
    def build_selection(sel: Selection): List[String] = selected(build_graph, sel)
67029
d6d9fd2559ce clarified signature (again);
wenzelm
parents: 67028
diff changeset
   837
    def build_descendants(ss: List[String]): List[String] = build_graph.all_succs(ss)
72065
11dc8929832d clarified order --- proper sorting of requirements;
wenzelm
parents: 72064
diff changeset
   838
    def build_requirements(ss: List[String]): List[String] = build_graph.all_preds_rev(ss)
67029
d6d9fd2559ce clarified signature (again);
wenzelm
parents: 67028
diff changeset
   839
    def build_topological_order: List[String] = build_graph.topological_order
62631
c39614ddb80b clarified modules;
wenzelm
parents:
diff changeset
   840
68732
5472f4409fe6 tuned signature;
wenzelm
parents: 68542
diff changeset
   841
    def imports_selection(sel: Selection): List[String] = selected(imports_graph, sel)
67029
d6d9fd2559ce clarified signature (again);
wenzelm
parents: 67028
diff changeset
   842
    def imports_descendants(ss: List[String]): List[String] = imports_graph.all_succs(ss)
72065
11dc8929832d clarified order --- proper sorting of requirements;
wenzelm
parents: 72064
diff changeset
   843
    def imports_requirements(ss: List[String]): List[String] = imports_graph.all_preds_rev(ss)
67029
d6d9fd2559ce clarified signature (again);
wenzelm
parents: 67028
diff changeset
   844
    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
   845
72613
d01ea9e3bd2d clarified bibtex_entries: refer to overall session structure;
wenzelm
parents: 72604
diff changeset
   846
    def bibtex_entries: List[(String, List[String])] =
d01ea9e3bd2d clarified bibtex_entries: refer to overall session structure;
wenzelm
parents: 72604
diff changeset
   847
      build_topological_order.flatMap(name =>
d01ea9e3bd2d clarified bibtex_entries: refer to overall session structure;
wenzelm
parents: 72604
diff changeset
   848
        apply(name).bibtex_entries match {
d01ea9e3bd2d clarified bibtex_entries: refer to overall session structure;
wenzelm
parents: 72604
diff changeset
   849
          case Nil => None
d01ea9e3bd2d clarified bibtex_entries: refer to overall session structure;
wenzelm
parents: 72604
diff changeset
   850
          case entries => Some(name -> entries.map(_.info))
d01ea9e3bd2d clarified bibtex_entries: refer to overall session structure;
wenzelm
parents: 72604
diff changeset
   851
        })
d01ea9e3bd2d clarified bibtex_entries: refer to overall session structure;
wenzelm
parents: 72604
diff changeset
   852
72616
217e6cf61453 refer to session structure from resources;
wenzelm
parents: 72613
diff changeset
   853
    def session_chapters: List[(String, String)] =
72626
5a616815cc44 clarified signature: theory imports could be from other sessions;
wenzelm
parents: 72622
diff changeset
   854
      imports_topological_order.map(name => name -> apply(name).chapter)
72616
217e6cf61453 refer to session structure from resources;
wenzelm
parents: 72613
diff changeset
   855
65420
695d4e22345a support for static session imports, without affect build hierarchy;
wenzelm
parents: 65419
diff changeset
   856
    override def toString: String =
67052
caf87d4b9b61 tuned signature;
wenzelm
parents: 67029
diff changeset
   857
      imports_graph.keys_iterator.mkString("Sessions.Structure(", ", ", ")")
62631
c39614ddb80b clarified modules;
wenzelm
parents:
diff changeset
   858
  }
c39614ddb80b clarified modules;
wenzelm
parents:
diff changeset
   859
c39614ddb80b clarified modules;
wenzelm
parents:
diff changeset
   860
c39614ddb80b clarified modules;
wenzelm
parents:
diff changeset
   861
  /* parser */
c39614ddb80b clarified modules;
wenzelm
parents:
diff changeset
   862
c39614ddb80b clarified modules;
wenzelm
parents:
diff changeset
   863
  private val CHAPTER = "chapter"
c39614ddb80b clarified modules;
wenzelm
parents:
diff changeset
   864
  private val SESSION = "session"
c39614ddb80b clarified modules;
wenzelm
parents:
diff changeset
   865
  private val IN = "in"
c39614ddb80b clarified modules;
wenzelm
parents:
diff changeset
   866
  private val DESCRIPTION = "description"
70668
9cac4dec0da9 support for explicit session directories;
wenzelm
parents: 70650
diff changeset
   867
  private val DIRECTORIES = "directories"
62631
c39614ddb80b clarified modules;
wenzelm
parents:
diff changeset
   868
  private val OPTIONS = "options"
65420
695d4e22345a support for static session imports, without affect build hierarchy;
wenzelm
parents: 65419
diff changeset
   869
  private val SESSIONS = "sessions"
62631
c39614ddb80b clarified modules;
wenzelm
parents:
diff changeset
   870
  private val THEORIES = "theories"
65374
a5b38d8d3c1e tuned syntax;
wenzelm
parents: 65373
diff changeset
   871
  private val GLOBAL = "global"
72600
2fa4f25d9d07 official support for document theories from other sessions;
wenzelm
parents: 72574
diff changeset
   872
  private val DOCUMENT_THEORIES = "document_theories"
62631
c39614ddb80b clarified modules;
wenzelm
parents:
diff changeset
   873
  private val DOCUMENT_FILES = "document_files"
68292
7ca0c23179e6 support 'export_files' in session ROOT;
wenzelm
parents: 68221
diff changeset
   874
  private val EXPORT_FILES = "export_files"
62631
c39614ddb80b clarified modules;
wenzelm
parents:
diff changeset
   875
71601
97ccf48c2f0c misc tuning based on hints by IntelliJ IDEA;
wenzelm
parents: 71599
diff changeset
   876
  val root_syntax: Outer_Syntax =
70668
9cac4dec0da9 support for explicit session directories;
wenzelm
parents: 70650
diff changeset
   877
    Outer_Syntax.empty + "(" + ")" + "+" + "," + "=" + "[" + "]" +
70681
a6c0f2d106c8 disallow overlapping session directories;
wenzelm
parents: 70679
diff changeset
   878
      GLOBAL + IN +
63443
c037248d54e8 clarified keywords;
wenzelm
parents: 63022
diff changeset
   879
      (CHAPTER, Keyword.THY_DECL) +
c037248d54e8 clarified keywords;
wenzelm
parents: 63022
diff changeset
   880
      (SESSION, Keyword.THY_DECL) +
c037248d54e8 clarified keywords;
wenzelm
parents: 63022
diff changeset
   881
      (DESCRIPTION, Keyword.QUASI_COMMAND) +
70668
9cac4dec0da9 support for explicit session directories;
wenzelm
parents: 70650
diff changeset
   882
      (DIRECTORIES, Keyword.QUASI_COMMAND) +
63443
c037248d54e8 clarified keywords;
wenzelm
parents: 63022
diff changeset
   883
      (OPTIONS, Keyword.QUASI_COMMAND) +
65420
695d4e22345a support for static session imports, without affect build hierarchy;
wenzelm
parents: 65419
diff changeset
   884
      (SESSIONS, Keyword.QUASI_COMMAND) +
63443
c037248d54e8 clarified keywords;
wenzelm
parents: 63022
diff changeset
   885
      (THEORIES, Keyword.QUASI_COMMAND) +
72600
2fa4f25d9d07 official support for document theories from other sessions;
wenzelm
parents: 72574
diff changeset
   886
      (DOCUMENT_THEORIES, Keyword.QUASI_COMMAND) +
68292
7ca0c23179e6 support 'export_files' in session ROOT;
wenzelm
parents: 68221
diff changeset
   887
      (DOCUMENT_FILES, Keyword.QUASI_COMMAND) +
7ca0c23179e6 support 'export_files' in session ROOT;
wenzelm
parents: 68221
diff changeset
   888
      (EXPORT_FILES, Keyword.QUASI_COMMAND)
62631
c39614ddb80b clarified modules;
wenzelm
parents:
diff changeset
   889
66818
5bc903a60932 clarified signature: public access to ROOT file syntax;
wenzelm
parents: 66780
diff changeset
   890
  abstract class Entry
5bc903a60932 clarified signature: public access to ROOT file syntax;
wenzelm
parents: 66780
diff changeset
   891
  sealed case class Chapter(name: String) extends Entry
5bc903a60932 clarified signature: public access to ROOT file syntax;
wenzelm
parents: 66780
diff changeset
   892
  sealed case class Session_Entry(
5bc903a60932 clarified signature: public access to ROOT file syntax;
wenzelm
parents: 66780
diff changeset
   893
    pos: Position.T,
5bc903a60932 clarified signature: public access to ROOT file syntax;
wenzelm
parents: 66780
diff changeset
   894
    name: String,
5bc903a60932 clarified signature: public access to ROOT file syntax;
wenzelm
parents: 66780
diff changeset
   895
    groups: List[String],
5bc903a60932 clarified signature: public access to ROOT file syntax;
wenzelm
parents: 66780
diff changeset
   896
    path: String,
5bc903a60932 clarified signature: public access to ROOT file syntax;
wenzelm
parents: 66780
diff changeset
   897
    parent: Option[String],
5bc903a60932 clarified signature: public access to ROOT file syntax;
wenzelm
parents: 66780
diff changeset
   898
    description: String,
5bc903a60932 clarified signature: public access to ROOT file syntax;
wenzelm
parents: 66780
diff changeset
   899
    options: List[Options.Spec],
5bc903a60932 clarified signature: public access to ROOT file syntax;
wenzelm
parents: 66780
diff changeset
   900
    imports: List[String],
70681
a6c0f2d106c8 disallow overlapping session directories;
wenzelm
parents: 70679
diff changeset
   901
    directories: List[String],
66818
5bc903a60932 clarified signature: public access to ROOT file syntax;
wenzelm
parents: 66780
diff changeset
   902
    theories: List[(List[Options.Spec], List[((String, Position.T), Boolean)])],
72600
2fa4f25d9d07 official support for document theories from other sessions;
wenzelm
parents: 72574
diff changeset
   903
    document_theories: List[(String, Position.T)],
68292
7ca0c23179e6 support 'export_files' in session ROOT;
wenzelm
parents: 68221
diff changeset
   904
    document_files: List[(String, String)],
69671
2486792eaf61 support pruning of export names;
wenzelm
parents: 69560
diff changeset
   905
    export_files: List[(String, Int, List[String])]) extends Entry
66818
5bc903a60932 clarified signature: public access to ROOT file syntax;
wenzelm
parents: 66780
diff changeset
   906
  {
5bc903a60932 clarified signature: public access to ROOT file syntax;
wenzelm
parents: 66780
diff changeset
   907
    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
   908
      theories.map({ case (a, b) => (a, b.map({ case ((c, _), d) => (c, d) })) })
72666
945cee776e79 proper meta_digest: avoid non-portable position information;
wenzelm
parents: 72653
diff changeset
   909
    def document_theories_no_position: List[String] =
945cee776e79 proper meta_digest: avoid non-portable position information;
wenzelm
parents: 72653
diff changeset
   910
      document_theories.map(_._1)
66818
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
72600
2fa4f25d9d07 official support for document theories from other sessions;
wenzelm
parents: 72574
diff changeset
   939
      val document_theories =
2fa4f25d9d07 official support for document theories from other sessions;
wenzelm
parents: 72574
diff changeset
   940
        $$$(DOCUMENT_THEORIES) ~! rep1(position(name)) ^^ { case _ ~ x => x }
2fa4f25d9d07 official support for document theories from other sessions;
wenzelm
parents: 72574
diff changeset
   941
62631
c39614ddb80b clarified modules;
wenzelm
parents:
diff changeset
   942
      val document_files =
c39614ddb80b clarified modules;
wenzelm
parents:
diff changeset
   943
        $$$(DOCUMENT_FILES) ~!
68292
7ca0c23179e6 support 'export_files' in session ROOT;
wenzelm
parents: 68221
diff changeset
   944
          ((in_path | success("document")) ~ rep1(path)) ^^ { case _ ~ (x ~ y) => y.map((x, _)) }
7ca0c23179e6 support 'export_files' in session ROOT;
wenzelm
parents: 68221
diff changeset
   945
69671
2486792eaf61 support pruning of export names;
wenzelm
parents: 69560
diff changeset
   946
      val prune = $$$("[") ~! (nat ~ $$$("]")) ^^ { case _ ~ (x ~ _) => x } | success(0)
2486792eaf61 support pruning of export names;
wenzelm
parents: 69560
diff changeset
   947
68292
7ca0c23179e6 support 'export_files' in session ROOT;
wenzelm
parents: 68221
diff changeset
   948
      val export_files =
69671
2486792eaf61 support pruning of export names;
wenzelm
parents: 69560
diff changeset
   949
        $$$(EXPORT_FILES) ~! ((in_path | success("export")) ~ prune ~ rep1(embedded)) ^^
2486792eaf61 support pruning of export names;
wenzelm
parents: 69560
diff changeset
   950
          { case _ ~ (x ~ y ~ z) => (x, y, z) }
62631
c39614ddb80b clarified modules;
wenzelm
parents:
diff changeset
   951
c39614ddb80b clarified modules;
wenzelm
parents:
diff changeset
   952
      command(SESSION) ~!
c39614ddb80b clarified modules;
wenzelm
parents:
diff changeset
   953
        (position(session_name) ~
c39614ddb80b clarified modules;
wenzelm
parents:
diff changeset
   954
          (($$$("(") ~! (rep1(name) <~ $$$(")")) ^^ { case _ ~ x => x }) | success(Nil)) ~
c39614ddb80b clarified modules;
wenzelm
parents:
diff changeset
   955
          (($$$(IN) ~! path ^^ { case _ ~ x => x }) | success(".")) ~
c39614ddb80b clarified modules;
wenzelm
parents:
diff changeset
   956
          ($$$("=") ~!
c39614ddb80b clarified modules;
wenzelm
parents:
diff changeset
   957
            (opt(session_name ~! $$$("+") ^^ { case x ~ _ => x }) ~
c39614ddb80b clarified modules;
wenzelm
parents:
diff changeset
   958
              (($$$(DESCRIPTION) ~! text ^^ { case _ ~ x => x }) | success("")) ~
c39614ddb80b clarified modules;
wenzelm
parents:
diff changeset
   959
              (($$$(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
   960
              (($$$(SESSIONS) ~! rep1(session_name)  ^^ { case _ ~ x => x }) | success(Nil)) ~
70681
a6c0f2d106c8 disallow overlapping session directories;
wenzelm
parents: 70679
diff changeset
   961
              (($$$(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
   962
              rep(theories) ~
72600
2fa4f25d9d07 official support for document theories from other sessions;
wenzelm
parents: 72574
diff changeset
   963
              (opt(document_theories) ^^ (x => x.getOrElse(Nil))) ~
68292
7ca0c23179e6 support 'export_files' in session ROOT;
wenzelm
parents: 68221
diff changeset
   964
              (rep(document_files) ^^ (x => x.flatten)) ~
72600
2fa4f25d9d07 official support for document theories from other sessions;
wenzelm
parents: 72574
diff changeset
   965
              rep(export_files)))) ^^
2fa4f25d9d07 official support for document theories from other sessions;
wenzelm
parents: 72574
diff changeset
   966
        { case _ ~ ((a, pos) ~ b ~ c ~ (_ ~ (d ~ e ~ f ~ g ~ h ~ i ~ j ~ k ~ l))) =>
2fa4f25d9d07 official support for document theories from other sessions;
wenzelm
parents: 72574
diff changeset
   967
            Session_Entry(pos, a, b, c, d, e, f, g, h, i, j, k, l) }
62631
c39614ddb80b clarified modules;
wenzelm
parents:
diff changeset
   968
    }
c39614ddb80b clarified modules;
wenzelm
parents:
diff changeset
   969
66819
wenzelm
parents: 66818
diff changeset
   970
    def parse_root(path: Path): List[Entry] =
62631
c39614ddb80b clarified modules;
wenzelm
parents:
diff changeset
   971
    {
66764
006deaf5c3dc process ROOT files only once, which allows duplicate (or overlapping) session root directories;
wenzelm
parents: 66759
diff changeset
   972
      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
   973
      val start = Token.Pos.file(path.implode)
62631
c39614ddb80b clarified modules;
wenzelm
parents:
diff changeset
   974
66764
006deaf5c3dc process ROOT files only once, which allows duplicate (or overlapping) session root directories;
wenzelm
parents: 66759
diff changeset
   975
      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
   976
        case Success(result, _) => result
66764
006deaf5c3dc process ROOT files only once, which allows duplicate (or overlapping) session root directories;
wenzelm
parents: 66759
diff changeset
   977
        case bad => error(bad.toString)
62631
c39614ddb80b clarified modules;
wenzelm
parents:
diff changeset
   978
      }
c39614ddb80b clarified modules;
wenzelm
parents:
diff changeset
   979
    }
c39614ddb80b clarified modules;
wenzelm
parents:
diff changeset
   980
  }
c39614ddb80b clarified modules;
wenzelm
parents:
diff changeset
   981
66819
wenzelm
parents: 66818
diff changeset
   982
  def parse_root(path: Path): List[Entry] = Parser.parse_root(path)
wenzelm
parents: 66818
diff changeset
   983
wenzelm
parents: 66818
diff changeset
   984
  def parse_root_entries(path: Path): List[Session_Entry] =
wenzelm
parents: 66818
diff changeset
   985
    for (entry <- Parser.parse_root(path) if entry.isInstanceOf[Session_Entry])
wenzelm
parents: 66818
diff changeset
   986
    yield entry.asInstanceOf[Session_Entry]
66818
5bc903a60932 clarified signature: public access to ROOT file syntax;
wenzelm
parents: 66780
diff changeset
   987
66960
d62f1f03868a tuned signature;
wenzelm
parents: 66959
diff changeset
   988
  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
   989
  {
69762
58fb0d779583 support for session information via virtual file-system;
wenzelm
parents: 69671
diff changeset
   990
    var entry_chapter = UNSORTED
66960
d62f1f03868a tuned signature;
wenzelm
parents: 66959
diff changeset
   991
    val infos = new mutable.ListBuffer[Info]
66819
wenzelm
parents: 66818
diff changeset
   992
    parse_root(path).foreach {
66818
5bc903a60932 clarified signature: public access to ROOT file syntax;
wenzelm
parents: 66780
diff changeset
   993
      case Chapter(name) => entry_chapter = name
66967
e365c91c72a9 synthesize session with all required theories from other session imports;
wenzelm
parents: 66966
diff changeset
   994
      case entry: Session_Entry =>
e365c91c72a9 synthesize session with all required theories from other session imports;
wenzelm
parents: 66966
diff changeset
   995
        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
   996
    }
5bc903a60932 clarified signature: public access to ROOT file syntax;
wenzelm
parents: 66780
diff changeset
   997
    infos.toList
5bc903a60932 clarified signature: public access to ROOT file syntax;
wenzelm
parents: 66780
diff changeset
   998
  }
5bc903a60932 clarified signature: public access to ROOT file syntax;
wenzelm
parents: 66780
diff changeset
   999
5bc903a60932 clarified signature: public access to ROOT file syntax;
wenzelm
parents: 66780
diff changeset
  1000
  def parse_roots(roots: Path): List[String] =
5bc903a60932 clarified signature: public access to ROOT file syntax;
wenzelm
parents: 66780
diff changeset
  1001
  {
5bc903a60932 clarified signature: public access to ROOT file syntax;
wenzelm
parents: 66780
diff changeset
  1002
    for {
5bc903a60932 clarified signature: public access to ROOT file syntax;
wenzelm
parents: 66780
diff changeset
  1003
      line <- split_lines(File.read(roots))
5bc903a60932 clarified signature: public access to ROOT file syntax;
wenzelm
parents: 66780
diff changeset
  1004
      if !(line == "" || line.startsWith("#"))
5bc903a60932 clarified signature: public access to ROOT file syntax;
wenzelm
parents: 66780
diff changeset
  1005
    } yield line
5bc903a60932 clarified signature: public access to ROOT file syntax;
wenzelm
parents: 66780
diff changeset
  1006
  }
5bc903a60932 clarified signature: public access to ROOT file syntax;
wenzelm
parents: 66780
diff changeset
  1007
62631
c39614ddb80b clarified modules;
wenzelm
parents:
diff changeset
  1008
62635
4854a38061de tuned signature;
wenzelm
parents: 62633
diff changeset
  1009
  /* load sessions from certain directories */
62631
c39614ddb80b clarified modules;
wenzelm
parents:
diff changeset
  1010
c39614ddb80b clarified modules;
wenzelm
parents:
diff changeset
  1011
  private def is_session_dir(dir: Path): Boolean =
c39614ddb80b clarified modules;
wenzelm
parents:
diff changeset
  1012
    (dir + ROOT).is_file || (dir + ROOTS).is_file
c39614ddb80b clarified modules;
wenzelm
parents:
diff changeset
  1013
c39614ddb80b clarified modules;
wenzelm
parents:
diff changeset
  1014
  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
  1015
    if (is_session_dir(dir)) File.pwd() + dir.expand
62631
c39614ddb80b clarified modules;
wenzelm
parents:
diff changeset
  1016
    else error("Bad session root directory: " + dir.toString)
c39614ddb80b clarified modules;
wenzelm
parents:
diff changeset
  1017
65561
741b1d3930c0 support for Mercurial manifest check;
wenzelm
parents: 65560
diff changeset
  1018
  def directories(dirs: List[Path], select_dirs: List[Path]): List[(Boolean, Path)] =
741b1d3930c0 support for Mercurial manifest check;
wenzelm
parents: 65560
diff changeset
  1019
  {
71601
97ccf48c2f0c misc tuning based on hints by IntelliJ IDEA;
wenzelm
parents: 71599
diff changeset
  1020
    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
  1021
    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
  1022
    yield (select, dir.canonical)
65561
741b1d3930c0 support for Mercurial manifest check;
wenzelm
parents: 65560
diff changeset
  1023
  }
741b1d3930c0 support for Mercurial manifest check;
wenzelm
parents: 65560
diff changeset
  1024
67026
687c822ee5e3 tuned signature;
wenzelm
parents: 67025
diff changeset
  1025
  def load_structure(options: Options,
66968
9991671c98aa allow to augment session context via explicit session infos;
wenzelm
parents: 66967
diff changeset
  1026
    dirs: List[Path] = Nil,
9991671c98aa allow to augment session context via explicit session infos;
wenzelm
parents: 66967
diff changeset
  1027
    select_dirs: List[Path] = Nil,
67052
caf87d4b9b61 tuned signature;
wenzelm
parents: 67029
diff changeset
  1028
    infos: List[Info] = Nil): Structure =
62631
c39614ddb80b clarified modules;
wenzelm
parents:
diff changeset
  1029
  {
66764
006deaf5c3dc process ROOT files only once, which allows duplicate (or overlapping) session root directories;
wenzelm
parents: 66759
diff changeset
  1030
    def load_dir(select: Boolean, dir: Path): List[(Boolean, Path)] =
62635
4854a38061de tuned signature;
wenzelm
parents: 62633
diff changeset
  1031
      load_root(select, dir) ::: load_roots(select, dir)
62631
c39614ddb80b clarified modules;
wenzelm
parents:
diff changeset
  1032
66764
006deaf5c3dc process ROOT files only once, which allows duplicate (or overlapping) session root directories;
wenzelm
parents: 66759
diff changeset
  1033
    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
  1034
    {
006deaf5c3dc process ROOT files only once, which allows duplicate (or overlapping) session root directories;
wenzelm
parents: 66759
diff changeset
  1035
      val root = dir + ROOT
006deaf5c3dc process ROOT files only once, which allows duplicate (or overlapping) session root directories;
wenzelm
parents: 66759
diff changeset
  1036
      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
  1037
    }
62631
c39614ddb80b clarified modules;
wenzelm
parents:
diff changeset
  1038
66764
006deaf5c3dc process ROOT files only once, which allows duplicate (or overlapping) session root directories;
wenzelm
parents: 66759
diff changeset
  1039
    def load_roots(select: Boolean, dir: Path): List[(Boolean, Path)] =
62631
c39614ddb80b clarified modules;
wenzelm
parents:
diff changeset
  1040
    {
c39614ddb80b clarified modules;
wenzelm
parents:
diff changeset
  1041
      val roots = dir + ROOTS
c39614ddb80b clarified modules;
wenzelm
parents:
diff changeset
  1042
      if (roots.is_file) {
c39614ddb80b clarified modules;
wenzelm
parents:
diff changeset
  1043
        for {
66818
5bc903a60932 clarified signature: public access to ROOT file syntax;
wenzelm
parents: 66780
diff changeset
  1044
          entry <- parse_roots(roots)
62631
c39614ddb80b clarified modules;
wenzelm
parents:
diff changeset
  1045
          dir1 =
66818
5bc903a60932 clarified signature: public access to ROOT file syntax;
wenzelm
parents: 66780
diff changeset
  1046
            try { check_session_dir(dir + Path.explode(entry)) }
62631
c39614ddb80b clarified modules;
wenzelm
parents:
diff changeset
  1047
            catch {
c39614ddb80b clarified modules;
wenzelm
parents:
diff changeset
  1048
              case ERROR(msg) =>
c39614ddb80b clarified modules;
wenzelm
parents:
diff changeset
  1049
                error(msg + "\nThe error(s) above occurred in session catalog " + roots.toString)
c39614ddb80b clarified modules;
wenzelm
parents:
diff changeset
  1050
            }
66764
006deaf5c3dc process ROOT files only once, which allows duplicate (or overlapping) session root directories;
wenzelm
parents: 66759
diff changeset
  1051
          res <- load_dir(select, dir1)
006deaf5c3dc process ROOT files only once, which allows duplicate (or overlapping) session root directories;
wenzelm
parents: 66759
diff changeset
  1052
        } yield res
62631
c39614ddb80b clarified modules;
wenzelm
parents:
diff changeset
  1053
      }
c39614ddb80b clarified modules;
wenzelm
parents:
diff changeset
  1054
      else Nil
c39614ddb80b clarified modules;
wenzelm
parents:
diff changeset
  1055
    }
c39614ddb80b clarified modules;
wenzelm
parents:
diff changeset
  1056
66764
006deaf5c3dc process ROOT files only once, which allows duplicate (or overlapping) session root directories;
wenzelm
parents: 66759
diff changeset
  1057
    val roots =
62631
c39614ddb80b clarified modules;
wenzelm
parents:
diff changeset
  1058
      for {
65561
741b1d3930c0 support for Mercurial manifest check;
wenzelm
parents: 65560
diff changeset
  1059
        (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
  1060
        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
  1061
      } yield res
006deaf5c3dc process ROOT files only once, which allows duplicate (or overlapping) session root directories;
wenzelm
parents: 66759
diff changeset
  1062
006deaf5c3dc process ROOT files only once, which allows duplicate (or overlapping) session root directories;
wenzelm
parents: 66759
diff changeset
  1063
    val unique_roots =
006deaf5c3dc process ROOT files only once, which allows duplicate (or overlapping) session root directories;
wenzelm
parents: 66759
diff changeset
  1064
      ((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
  1065
        val file = path.canonical_file
006deaf5c3dc process ROOT files only once, which allows duplicate (or overlapping) session root directories;
wenzelm
parents: 66759
diff changeset
  1066
        m.get(file) match {
006deaf5c3dc process ROOT files only once, which allows duplicate (or overlapping) session root directories;
wenzelm
parents: 66759
diff changeset
  1067
          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
  1068
          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
  1069
        }
006deaf5c3dc process ROOT files only once, which allows duplicate (or overlapping) session root directories;
wenzelm
parents: 66759
diff changeset
  1070
      }).toList.map(_._2)
006deaf5c3dc process ROOT files only once, which allows duplicate (or overlapping) session root directories;
wenzelm
parents: 66759
diff changeset
  1071
72855
e0f6fa6ff3d0 tuned signature;
wenzelm
parents: 72854
diff changeset
  1072
    Structure.make(unique_roots.flatMap(p => read_root(options, p._1, p._2)) ::: infos)
62631
c39614ddb80b clarified modules;
wenzelm
parents:
diff changeset
  1073
  }
62632
cd991ba01ffd clarified modules;
wenzelm
parents: 62631
diff changeset
  1074
cd991ba01ffd clarified modules;
wenzelm
parents: 62631
diff changeset
  1075
71808
e2ad50885887 added "isabelle sessions" tool;
wenzelm
parents: 71726
diff changeset
  1076
  /* Isabelle tool wrapper */
e2ad50885887 added "isabelle sessions" tool;
wenzelm
parents: 71726
diff changeset
  1077
72763
3cc73d00553c added document antiquotation @{tool};
wenzelm
parents: 72760
diff changeset
  1078
  val isabelle_tool = Isabelle_Tool("sessions", "explore structure of Isabelle sessions",
3cc73d00553c added document antiquotation @{tool};
wenzelm
parents: 72760
diff changeset
  1079
    Scala_Project.here, args =>
71808
e2ad50885887 added "isabelle sessions" tool;
wenzelm
parents: 71726
diff changeset
  1080
  {
e2ad50885887 added "isabelle sessions" tool;
wenzelm
parents: 71726
diff changeset
  1081
    var base_sessions: List[String] = Nil
e2ad50885887 added "isabelle sessions" tool;
wenzelm
parents: 71726
diff changeset
  1082
    var select_dirs: List[Path] = Nil
e2ad50885887 added "isabelle sessions" tool;
wenzelm
parents: 71726
diff changeset
  1083
    var requirements = false
e2ad50885887 added "isabelle sessions" tool;
wenzelm
parents: 71726
diff changeset
  1084
    var exclude_session_groups: List[String] = Nil
e2ad50885887 added "isabelle sessions" tool;
wenzelm
parents: 71726
diff changeset
  1085
    var all_sessions = false
e2ad50885887 added "isabelle sessions" tool;
wenzelm
parents: 71726
diff changeset
  1086
    var dirs: List[Path] = Nil
e2ad50885887 added "isabelle sessions" tool;
wenzelm
parents: 71726
diff changeset
  1087
    var session_groups: List[String] = Nil
e2ad50885887 added "isabelle sessions" tool;
wenzelm
parents: 71726
diff changeset
  1088
    var exclude_sessions: List[String] = Nil
e2ad50885887 added "isabelle sessions" tool;
wenzelm
parents: 71726
diff changeset
  1089
e2ad50885887 added "isabelle sessions" tool;
wenzelm
parents: 71726
diff changeset
  1090
    val getopts = Getopts("""
e2ad50885887 added "isabelle sessions" tool;
wenzelm
parents: 71726
diff changeset
  1091
Usage: isabelle sessions [OPTIONS] [SESSIONS ...]
e2ad50885887 added "isabelle sessions" tool;
wenzelm
parents: 71726
diff changeset
  1092
e2ad50885887 added "isabelle sessions" tool;
wenzelm
parents: 71726
diff changeset
  1093
  Options are:
e2ad50885887 added "isabelle sessions" tool;
wenzelm
parents: 71726
diff changeset
  1094
    -B NAME      include session NAME and all descendants
e2ad50885887 added "isabelle sessions" tool;
wenzelm
parents: 71726
diff changeset
  1095
    -D DIR       include session directory and select its sessions
e2ad50885887 added "isabelle sessions" tool;
wenzelm
parents: 71726
diff changeset
  1096
    -R           refer to requirements of selected sessions
e2ad50885887 added "isabelle sessions" tool;
wenzelm
parents: 71726
diff changeset
  1097
    -X NAME      exclude sessions from group NAME and all descendants
e2ad50885887 added "isabelle sessions" tool;
wenzelm
parents: 71726
diff changeset
  1098
    -a           select all sessions
e2ad50885887 added "isabelle sessions" tool;
wenzelm
parents: 71726
diff changeset
  1099
    -d DIR       include session directory
e2ad50885887 added "isabelle sessions" tool;
wenzelm
parents: 71726
diff changeset
  1100
    -g NAME      select session group NAME
e2ad50885887 added "isabelle sessions" tool;
wenzelm
parents: 71726
diff changeset
  1101
    -x NAME      exclude session NAME and all descendants
e2ad50885887 added "isabelle sessions" tool;
wenzelm
parents: 71726
diff changeset
  1102
e2ad50885887 added "isabelle sessions" tool;
wenzelm
parents: 71726
diff changeset
  1103
  Explore the structure of Isabelle sessions and print result names in
e2ad50885887 added "isabelle sessions" tool;
wenzelm
parents: 71726
diff changeset
  1104
  topological order (on stdout).
e2ad50885887 added "isabelle sessions" tool;
wenzelm
parents: 71726
diff changeset
  1105
""",
e2ad50885887 added "isabelle sessions" tool;
wenzelm
parents: 71726
diff changeset
  1106
      "B:" -> (arg => base_sessions = base_sessions ::: List(arg)),
e2ad50885887 added "isabelle sessions" tool;
wenzelm
parents: 71726
diff changeset
  1107
      "D:" -> (arg => select_dirs = select_dirs ::: List(Path.explode(arg))),
e2ad50885887 added "isabelle sessions" tool;
wenzelm
parents: 71726
diff changeset
  1108
      "R" -> (_ => requirements = true),
e2ad50885887 added "isabelle sessions" tool;
wenzelm
parents: 71726
diff changeset
  1109
      "X:" -> (arg => exclude_session_groups = exclude_session_groups ::: List(arg)),
e2ad50885887 added "isabelle sessions" tool;
wenzelm
parents: 71726
diff changeset
  1110
      "a" -> (_ => all_sessions = true),
e2ad50885887 added "isabelle sessions" tool;
wenzelm
parents: 71726
diff changeset
  1111
      "d:" -> (arg => dirs = dirs ::: List(Path.explode(arg))),
e2ad50885887 added "isabelle sessions" tool;
wenzelm
parents: 71726
diff changeset
  1112
      "g:" -> (arg => session_groups = session_groups ::: List(arg)),
e2ad50885887 added "isabelle sessions" tool;
wenzelm
parents: 71726
diff changeset
  1113
      "x:" -> (arg => exclude_sessions = exclude_sessions ::: List(arg)))
e2ad50885887 added "isabelle sessions" tool;
wenzelm
parents: 71726
diff changeset
  1114
e2ad50885887 added "isabelle sessions" tool;
wenzelm
parents: 71726
diff changeset
  1115
    val sessions = getopts(args)
e2ad50885887 added "isabelle sessions" tool;
wenzelm
parents: 71726
diff changeset
  1116
e2ad50885887 added "isabelle sessions" tool;
wenzelm
parents: 71726
diff changeset
  1117
    val options = Options.init()
e2ad50885887 added "isabelle sessions" tool;
wenzelm
parents: 71726
diff changeset
  1118
e2ad50885887 added "isabelle sessions" tool;
wenzelm
parents: 71726
diff changeset
  1119
    val selection =
e2ad50885887 added "isabelle sessions" tool;
wenzelm
parents: 71726
diff changeset
  1120
      Selection(requirements = requirements, all_sessions = all_sessions, base_sessions = base_sessions,
e2ad50885887 added "isabelle sessions" tool;
wenzelm
parents: 71726
diff changeset
  1121
        exclude_session_groups = exclude_session_groups, exclude_sessions = exclude_sessions,
e2ad50885887 added "isabelle sessions" tool;
wenzelm
parents: 71726
diff changeset
  1122
        session_groups = session_groups, sessions = sessions)
e2ad50885887 added "isabelle sessions" tool;
wenzelm
parents: 71726
diff changeset
  1123
    val sessions_structure =
e2ad50885887 added "isabelle sessions" tool;
wenzelm
parents: 71726
diff changeset
  1124
      load_structure(options, dirs = dirs, select_dirs = select_dirs).selection(selection)
e2ad50885887 added "isabelle sessions" tool;
wenzelm
parents: 71726
diff changeset
  1125
e2ad50885887 added "isabelle sessions" tool;
wenzelm
parents: 71726
diff changeset
  1126
    for (name <- sessions_structure.imports_topological_order) {
e2ad50885887 added "isabelle sessions" tool;
wenzelm
parents: 71726
diff changeset
  1127
      Output.writeln(name, stdout = true)
e2ad50885887 added "isabelle sessions" tool;
wenzelm
parents: 71726
diff changeset
  1128
    }
e2ad50885887 added "isabelle sessions" tool;
wenzelm
parents: 71726
diff changeset
  1129
  })
e2ad50885887 added "isabelle sessions" tool;
wenzelm
parents: 71726
diff changeset
  1130
e2ad50885887 added "isabelle sessions" tool;
wenzelm
parents: 71726
diff changeset
  1131
62637
0189fe0f6452 support for Poly/ML heap hierarchy, which saves a lot of disk space;
wenzelm
parents: 62636
diff changeset
  1132
62704
478b49f0d726 proper SHA1 digest as annex to heap file: Poly/ML reads precise segment length;
wenzelm
parents: 62637
diff changeset
  1133
  /** 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
  1134
478b49f0d726 proper SHA1 digest as annex to heap file: Poly/ML reads precise segment length;
wenzelm
parents: 62637
diff changeset
  1135
  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
  1136
478b49f0d726 proper SHA1 digest as annex to heap file: Poly/ML reads precise segment length;
wenzelm
parents: 62637
diff changeset
  1137
  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
  1138
  {
478b49f0d726 proper SHA1 digest as annex to heap file: Poly/ML reads precise segment length;
wenzelm
parents: 62637
diff changeset
  1139
    if (heap.is_file) {
69393
ed0824ef337e static type for Library.using: avoid Java 11 warnings on "Illegal reflective access";
wenzelm
parents: 69366
diff changeset
  1140
      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
  1141
      {
62704
478b49f0d726 proper SHA1 digest as annex to heap file: Poly/ML reads precise segment length;
wenzelm
parents: 62637
diff changeset
  1142
        val len = file.size
478b49f0d726 proper SHA1 digest as annex to heap file: Poly/ML reads precise segment length;
wenzelm
parents: 62637
diff changeset
  1143
        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
  1144
        if (len >= n) {
478b49f0d726 proper SHA1 digest as annex to heap file: Poly/ML reads precise segment length;
wenzelm
parents: 62637
diff changeset
  1145
          file.position(len - n)
478b49f0d726 proper SHA1 digest as annex to heap file: Poly/ML reads precise segment length;
wenzelm
parents: 62637
diff changeset
  1146
478b49f0d726 proper SHA1 digest as annex to heap file: Poly/ML reads precise segment length;
wenzelm
parents: 62637
diff changeset
  1147
          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
  1148
          var i = 0
478b49f0d726 proper SHA1 digest as annex to heap file: Poly/ML reads precise segment length;
wenzelm
parents: 62637
diff changeset
  1149
          var m = 0
478b49f0d726 proper SHA1 digest as annex to heap file: Poly/ML reads precise segment length;
wenzelm
parents: 62637
diff changeset
  1150
          do {
478b49f0d726 proper SHA1 digest as annex to heap file: Poly/ML reads precise segment length;
wenzelm
parents: 62637
diff changeset
  1151
            m = file.read(buf)
478b49f0d726 proper SHA1 digest as annex to heap file: Poly/ML reads precise segment length;
wenzelm
parents: 62637
diff changeset
  1152
            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
  1153
          }
478b49f0d726 proper SHA1 digest as annex to heap file: Poly/ML reads precise segment length;
wenzelm
parents: 62637
diff changeset
  1154
          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
  1155
478b49f0d726 proper SHA1 digest as annex to heap file: Poly/ML reads precise segment length;
wenzelm
parents: 62637
diff changeset
  1156
          if (i == n) {
478b49f0d726 proper SHA1 digest as annex to heap file: Poly/ML reads precise segment length;
wenzelm
parents: 62637
diff changeset
  1157
            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
  1158
            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
  1159
            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
  1160
          }
478b49f0d726 proper SHA1 digest as annex to heap file: Poly/ML reads precise segment length;
wenzelm
parents: 62637
diff changeset
  1161
          else None
478b49f0d726 proper SHA1 digest as annex to heap file: Poly/ML reads precise segment length;
wenzelm
parents: 62637
diff changeset
  1162
        }
478b49f0d726 proper SHA1 digest as annex to heap file: Poly/ML reads precise segment length;
wenzelm
parents: 62637
diff changeset
  1163
        else None
69393
ed0824ef337e static type for Library.using: avoid Java 11 warnings on "Illegal reflective access";
wenzelm
parents: 69366
diff changeset
  1164
      })
62704
478b49f0d726 proper SHA1 digest as annex to heap file: Poly/ML reads precise segment length;
wenzelm
parents: 62637
diff changeset
  1165
    }
478b49f0d726 proper SHA1 digest as annex to heap file: Poly/ML reads precise segment length;
wenzelm
parents: 62637
diff changeset
  1166
    else None
478b49f0d726 proper SHA1 digest as annex to heap file: Poly/ML reads precise segment length;
wenzelm
parents: 62637
diff changeset
  1167
  }
478b49f0d726 proper SHA1 digest as annex to heap file: Poly/ML reads precise segment length;
wenzelm
parents: 62637
diff changeset
  1168
478b49f0d726 proper SHA1 digest as annex to heap file: Poly/ML reads precise segment length;
wenzelm
parents: 62637
diff changeset
  1169
  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
  1170
    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
  1171
      case None =>
478b49f0d726 proper SHA1 digest as annex to heap file: Poly/ML reads precise segment length;
wenzelm
parents: 62637
diff changeset
  1172
        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
  1173
        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
  1174
        s
478b49f0d726 proper SHA1 digest as annex to heap file: Poly/ML reads precise segment length;
wenzelm
parents: 62637
diff changeset
  1175
      case Some(s) => s
478b49f0d726 proper SHA1 digest as annex to heap file: Poly/ML reads precise segment length;
wenzelm
parents: 62637
diff changeset
  1176
    }
478b49f0d726 proper SHA1 digest as annex to heap file: Poly/ML reads precise segment length;
wenzelm
parents: 62637
diff changeset
  1177
478b49f0d726 proper SHA1 digest as annex to heap file: Poly/ML reads precise segment length;
wenzelm
parents: 62637
diff changeset
  1178
478b49f0d726 proper SHA1 digest as annex to heap file: Poly/ML reads precise segment length;
wenzelm
parents: 62637
diff changeset
  1179
62637
0189fe0f6452 support for Poly/ML heap hierarchy, which saves a lot of disk space;
wenzelm
parents: 62636
diff changeset
  1180
  /** persistent store **/
62632
cd991ba01ffd clarified modules;
wenzelm
parents: 62631
diff changeset
  1181
65296
a71db30f3b2d tuned signature;
wenzelm
parents: 65295
diff changeset
  1182
  object Session_Info
a71db30f3b2d tuned signature;
wenzelm
parents: 65295
diff changeset
  1183
  {
66857
f8f42289c4df tuned signature;
wenzelm
parents: 66848
diff changeset
  1184
    val session_name = SQL.Column.string("session_name").make_primary_key
65326
cb7cb57c7ce1 proper primary key;
wenzelm
parents: 65324
diff changeset
  1185
65296
a71db30f3b2d tuned signature;
wenzelm
parents: 65295
diff changeset
  1186
    // Build_Log.Session_Info
a71db30f3b2d tuned signature;
wenzelm
parents: 65295
diff changeset
  1187
    val session_timing = SQL.Column.bytes("session_timing")
a71db30f3b2d tuned signature;
wenzelm
parents: 65295
diff changeset
  1188
    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
  1189
    val theory_timings = SQL.Column.bytes("theory_timings")
65296
a71db30f3b2d tuned signature;
wenzelm
parents: 65295
diff changeset
  1190
    val ml_statistics = SQL.Column.bytes("ml_statistics")
a71db30f3b2d tuned signature;
wenzelm
parents: 65295
diff changeset
  1191
    val task_statistics = SQL.Column.bytes("task_statistics")
65934
5f202ba9f590 store errors in build db;
wenzelm
parents: 65857
diff changeset
  1192
    val errors = SQL.Column.bytes("errors")
65296
a71db30f3b2d tuned signature;
wenzelm
parents: 65295
diff changeset
  1193
    val build_log_columns =
66873
9953ae603a23 provide theory timing information, similar to command timing but always considered relevant;
wenzelm
parents: 66857
diff changeset
  1194
      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
  1195
        ml_statistics, task_statistics, errors)
65296
a71db30f3b2d tuned signature;
wenzelm
parents: 65295
diff changeset
  1196
a71db30f3b2d tuned signature;
wenzelm
parents: 65295
diff changeset
  1197
    // Build.Session_Info
a71db30f3b2d tuned signature;
wenzelm
parents: 65295
diff changeset
  1198
    val sources = SQL.Column.string("sources")
a71db30f3b2d tuned signature;
wenzelm
parents: 65295
diff changeset
  1199
    val input_heaps = SQL.Column.string("input_heaps")
a71db30f3b2d tuned signature;
wenzelm
parents: 65295
diff changeset
  1200
    val output_heap = SQL.Column.string("output_heap")
a71db30f3b2d tuned signature;
wenzelm
parents: 65295
diff changeset
  1201
    val return_code = SQL.Column.int("return_code")
66746
888a51e77c6e sources_stamp refers to full sources;
wenzelm
parents: 66744
diff changeset
  1202
    val build_columns = List(sources, input_heaps, output_heap, return_code)
65296
a71db30f3b2d tuned signature;
wenzelm
parents: 65295
diff changeset
  1203
a71db30f3b2d tuned signature;
wenzelm
parents: 65295
diff changeset
  1204
    val table = SQL.Table("isabelle_session_info", build_log_columns ::: build_columns)
a71db30f3b2d tuned signature;
wenzelm
parents: 65295
diff changeset
  1205
  }
a71db30f3b2d tuned signature;
wenzelm
parents: 65295
diff changeset
  1206
72682
e0443773ef1a clarified modules;
wenzelm
parents: 72672
diff changeset
  1207
  class Database_Context private[Sessions](
e0443773ef1a clarified modules;
wenzelm
parents: 72672
diff changeset
  1208
    val store: Sessions.Store,
e0443773ef1a clarified modules;
wenzelm
parents: 72672
diff changeset
  1209
    database_server: Option[SQL.Database]) extends AutoCloseable
e0443773ef1a clarified modules;
wenzelm
parents: 72672
diff changeset
  1210
  {
73031
f93f0597f4fb clarified signature: absorb XZ.Cache into XML.Cache;
wenzelm
parents: 73024
diff changeset
  1211
    def cache: XML.Cache = store.cache
72683
b5e6f0d137a7 clarified signature: prefer Database_Context;
wenzelm
parents: 72682
diff changeset
  1212
72682
e0443773ef1a clarified modules;
wenzelm
parents: 72672
diff changeset
  1213
    def close { database_server.foreach(_.close) }
e0443773ef1a clarified modules;
wenzelm
parents: 72672
diff changeset
  1214
72715
2615b8c05337 clarified signature --- avoid repeated open_database on server;
wenzelm
parents: 72696
diff changeset
  1215
    def output_database[A](session: String)(f: SQL.Database => A): A =
2615b8c05337 clarified signature --- avoid repeated open_database on server;
wenzelm
parents: 72696
diff changeset
  1216
      database_server match {
2615b8c05337 clarified signature --- avoid repeated open_database on server;
wenzelm
parents: 72696
diff changeset
  1217
        case Some(db) => f(db)
2615b8c05337 clarified signature --- avoid repeated open_database on server;
wenzelm
parents: 72696
diff changeset
  1218
        case None => using(store.open_database(session, output = true))(f)
2615b8c05337 clarified signature --- avoid repeated open_database on server;
wenzelm
parents: 72696
diff changeset
  1219
      }
2615b8c05337 clarified signature --- avoid repeated open_database on server;
wenzelm
parents: 72696
diff changeset
  1220
72716
7cef6b1a6682 clarified signature;
wenzelm
parents: 72715
diff changeset
  1221
    def input_database[A](session: String)(f: (SQL.Database, String) => Option[A]): Option[A] =
7cef6b1a6682 clarified signature;
wenzelm
parents: 72715
diff changeset
  1222
      database_server match {
7cef6b1a6682 clarified signature;
wenzelm
parents: 72715
diff changeset
  1223
        case Some(db) => f(db, session)
7cef6b1a6682 clarified signature;
wenzelm
parents: 72715
diff changeset
  1224
        case None =>
7cef6b1a6682 clarified signature;
wenzelm
parents: 72715
diff changeset
  1225
          store.try_open_database(session) match {
7cef6b1a6682 clarified signature;
wenzelm
parents: 72715
diff changeset
  1226
            case Some(db) => using(db)(f(_, session))
7cef6b1a6682 clarified signature;
wenzelm
parents: 72715
diff changeset
  1227
            case None => None
7cef6b1a6682 clarified signature;
wenzelm
parents: 72715
diff changeset
  1228
          }
7cef6b1a6682 clarified signature;
wenzelm
parents: 72715
diff changeset
  1229
      }
7cef6b1a6682 clarified signature;
wenzelm
parents: 72715
diff changeset
  1230
72854
6c660f05f70c clarified signature;
wenzelm
parents: 72847
diff changeset
  1231
    def read_export(
6c660f05f70c clarified signature;
wenzelm
parents: 72847
diff changeset
  1232
      sessions: List[String], theory_name: String, name: String): Option[Export.Entry] =
72682
e0443773ef1a clarified modules;
wenzelm
parents: 72672
diff changeset
  1233
    {
e0443773ef1a clarified modules;
wenzelm
parents: 72672
diff changeset
  1234
      val attempts =
e0443773ef1a clarified modules;
wenzelm
parents: 72672
diff changeset
  1235
        database_server match {
e0443773ef1a clarified modules;
wenzelm
parents: 72672
diff changeset
  1236
          case Some(db) =>
72854
6c660f05f70c clarified signature;
wenzelm
parents: 72847
diff changeset
  1237
            sessions.view.map(session_name =>
73031
f93f0597f4fb clarified signature: absorb XZ.Cache into XML.Cache;
wenzelm
parents: 73024
diff changeset
  1238
              Export.read_entry(db, store.cache, session_name, theory_name, name))
72682
e0443773ef1a clarified modules;
wenzelm
parents: 72672
diff changeset
  1239
          case None =>
72854
6c660f05f70c clarified signature;
wenzelm
parents: 72847
diff changeset
  1240
            sessions.view.map(session_name =>
72682
e0443773ef1a clarified modules;
wenzelm
parents: 72672
diff changeset
  1241
              store.try_open_database(session_name) match {
72847
9dda93a753b1 clarified signature: provide XZ.Cache where Export.Entry is created;
wenzelm
parents: 72845
diff changeset
  1242
                case Some(db) =>
73031
f93f0597f4fb clarified signature: absorb XZ.Cache into XML.Cache;
wenzelm
parents: 73024
diff changeset
  1243
                  using(db)(Export.read_entry(_, store.cache, session_name, theory_name, name))
72682
e0443773ef1a clarified modules;
wenzelm
parents: 72672
diff changeset
  1244
                case None => None
e0443773ef1a clarified modules;
wenzelm
parents: 72672
diff changeset
  1245
              })
e0443773ef1a clarified modules;
wenzelm
parents: 72672
diff changeset
  1246
        }
e0443773ef1a clarified modules;
wenzelm
parents: 72672
diff changeset
  1247
      attempts.collectFirst({ case Some(entry) => entry })
e0443773ef1a clarified modules;
wenzelm
parents: 72672
diff changeset
  1248
    }
e0443773ef1a clarified modules;
wenzelm
parents: 72672
diff changeset
  1249
72854
6c660f05f70c clarified signature;
wenzelm
parents: 72847
diff changeset
  1250
    def get_export(
6c660f05f70c clarified signature;
wenzelm
parents: 72847
diff changeset
  1251
        session_hierarchy: List[String], theory_name: String, name: String): Export.Entry =
6c660f05f70c clarified signature;
wenzelm
parents: 72847
diff changeset
  1252
      read_export(session_hierarchy, theory_name, name) getOrElse
6c660f05f70c clarified signature;
wenzelm
parents: 72847
diff changeset
  1253
        Export.empty_entry(theory_name, name)
72682
e0443773ef1a clarified modules;
wenzelm
parents: 72672
diff changeset
  1254
e0443773ef1a clarified modules;
wenzelm
parents: 72672
diff changeset
  1255
    override def toString: String =
e0443773ef1a clarified modules;
wenzelm
parents: 72672
diff changeset
  1256
    {
e0443773ef1a clarified modules;
wenzelm
parents: 72672
diff changeset
  1257
      val s =
e0443773ef1a clarified modules;
wenzelm
parents: 72672
diff changeset
  1258
        database_server match {
e0443773ef1a clarified modules;
wenzelm
parents: 72672
diff changeset
  1259
          case Some(db) => db.toString
e0443773ef1a clarified modules;
wenzelm
parents: 72672
diff changeset
  1260
          case None => "input_dirs = " + store.input_dirs.map(_.absolute).mkString(", ")
e0443773ef1a clarified modules;
wenzelm
parents: 72672
diff changeset
  1261
        }
e0443773ef1a clarified modules;
wenzelm
parents: 72672
diff changeset
  1262
      "Database_Context(" + s + ")"
e0443773ef1a clarified modules;
wenzelm
parents: 72672
diff changeset
  1263
    }
e0443773ef1a clarified modules;
wenzelm
parents: 72672
diff changeset
  1264
  }
e0443773ef1a clarified modules;
wenzelm
parents: 72672
diff changeset
  1265
73031
f93f0597f4fb clarified signature: absorb XZ.Cache into XML.Cache;
wenzelm
parents: 73024
diff changeset
  1266
  def store(options: Options, cache: XML.Cache = XML.Cache.make()): Store =
f93f0597f4fb clarified signature: absorb XZ.Cache into XML.Cache;
wenzelm
parents: 73024
diff changeset
  1267
    new Store(options, cache)
62632
cd991ba01ffd clarified modules;
wenzelm
parents: 62631
diff changeset
  1268
73031
f93f0597f4fb clarified signature: absorb XZ.Cache into XML.Cache;
wenzelm
parents: 73024
diff changeset
  1269
  class Store private[Sessions](val options: Options, val cache: XML.Cache)
62632
cd991ba01ffd clarified modules;
wenzelm
parents: 62631
diff changeset
  1270
  {
72634
5cea0993ee4f clarified access to single database server vs. collection of database files;
wenzelm
parents: 72627
diff changeset
  1271
    store =>
5cea0993ee4f clarified access to single database server vs. collection of database files;
wenzelm
parents: 72627
diff changeset
  1272
5cea0993ee4f clarified access to single database server vs. collection of database files;
wenzelm
parents: 72627
diff changeset
  1273
    override def toString: String = "Store(output_dir = " + output_dir.absolute + ")"
68219
c0341c0080e2 clarified store directories;
wenzelm
parents: 68218
diff changeset
  1274
c0341c0080e2 clarified store directories;
wenzelm
parents: 68218
diff changeset
  1275
c0341c0080e2 clarified store directories;
wenzelm
parents: 68218
diff changeset
  1276
    /* directories */
c0341c0080e2 clarified store directories;
wenzelm
parents: 68218
diff changeset
  1277
68523
ccacc84e0251 clarified settings -- avoid hard-wired directories;
wenzelm
parents: 68483
diff changeset
  1278
    val system_output_dir: Path = Path.explode("$ISABELLE_HEAPS_SYSTEM/$ML_IDENTIFIER")
ccacc84e0251 clarified settings -- avoid hard-wired directories;
wenzelm
parents: 68483
diff changeset
  1279
    val user_output_dir: Path = Path.explode("$ISABELLE_HEAPS/$ML_IDENTIFIER")
68219
c0341c0080e2 clarified store directories;
wenzelm
parents: 68218
diff changeset
  1280
69854
cc0b3e177b49 system option "system_heaps" supersedes various command-line options for "system build mode";
wenzelm
parents: 69812
diff changeset
  1281
    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
  1282
68221
dbef88c2b6c5 support for build_database_server (PostgreSQL);
wenzelm
parents: 68220
diff changeset
  1283
    val output_dir: Path =
69854
cc0b3e177b49 system option "system_heaps" supersedes various command-line options for "system build mode";
wenzelm
parents: 69812
diff changeset
  1284
      if (system_heaps) system_output_dir else user_output_dir
68219
c0341c0080e2 clarified store directories;
wenzelm
parents: 68218
diff changeset
  1285
68221
dbef88c2b6c5 support for build_database_server (PostgreSQL);
wenzelm
parents: 68220
diff changeset
  1286
    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
  1287
      if (system_heaps) List(system_output_dir)
68219
c0341c0080e2 clarified store directories;
wenzelm
parents: 68218
diff changeset
  1288
      else List(user_output_dir, system_output_dir)
62632
cd991ba01ffd clarified modules;
wenzelm
parents: 62631
diff changeset
  1289
72648
1cbac4ae934d more explicit presentation directory;
wenzelm
parents: 72647
diff changeset
  1290
    def presentation_dir: Path =
69854
cc0b3e177b49 system option "system_heaps" supersedes various command-line options for "system build mode";
wenzelm
parents: 69812
diff changeset
  1291
      if (system_heaps) Path.explode("$ISABELLE_BROWSER_INFO_SYSTEM")
62632
cd991ba01ffd clarified modules;
wenzelm
parents: 62631
diff changeset
  1292
      else Path.explode("$ISABELLE_BROWSER_INFO")
cd991ba01ffd clarified modules;
wenzelm
parents: 62631
diff changeset
  1293
62637
0189fe0f6452 support for Poly/ML heap hierarchy, which saves a lot of disk space;
wenzelm
parents: 62636
diff changeset
  1294
68221
dbef88c2b6c5 support for build_database_server (PostgreSQL);
wenzelm
parents: 68220
diff changeset
  1295
    /* file names */
65298
wenzelm
parents: 65297
diff changeset
  1296
68221
dbef88c2b6c5 support for build_database_server (PostgreSQL);
wenzelm
parents: 68220
diff changeset
  1297
    def heap(name: String): Path = Path.basic(name)
dbef88c2b6c5 support for build_database_server (PostgreSQL);
wenzelm
parents: 68220
diff changeset
  1298
    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
  1299
    def log(name: String): Path = Path.basic("log") + Path.basic(name)
dbef88c2b6c5 support for build_database_server (PostgreSQL);
wenzelm
parents: 68220
diff changeset
  1300
    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
  1301
68221
dbef88c2b6c5 support for build_database_server (PostgreSQL);
wenzelm
parents: 68220
diff changeset
  1302
    def output_heap(name: String): Path = output_dir + heap(name)
dbef88c2b6c5 support for build_database_server (PostgreSQL);
wenzelm
parents: 68220
diff changeset
  1303
    def output_database(name: String): Path = output_dir + database(name)
68086
9e1c670301b8 cleanup session output before starting build job;
wenzelm
parents: 68018
diff changeset
  1304
    def output_log(name: String): Path = output_dir + log(name)
9e1c670301b8 cleanup session output before starting build job;
wenzelm
parents: 68018
diff changeset
  1305
    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
  1306
72375
e48d93811ed7 clarified signature;
wenzelm
parents: 72323
diff changeset
  1307
    def prepare_output_dir() { Isabelle_System.make_directory(output_dir + Path.basic("log")) }
68220
8fc4e3d1df86 clarified store.clean_output: cleanup user_output_dir even in system_mode;
wenzelm
parents: 68219
diff changeset
  1308
62637
0189fe0f6452 support for Poly/ML heap hierarchy, which saves a lot of disk space;
wenzelm
parents: 62636
diff changeset
  1309
68221
dbef88c2b6c5 support for build_database_server (PostgreSQL);
wenzelm
parents: 68220
diff changeset
  1310
    /* heap */
62637
0189fe0f6452 support for Poly/ML heap hierarchy, which saves a lot of disk space;
wenzelm
parents: 62636
diff changeset
  1311
68212
5a59fded83c7 clarified heap vs. database operations: discontinued correlation of directory;
wenzelm
parents: 68210
diff changeset
  1312
    def find_heap(name: String): Option[Path] =
68221
dbef88c2b6c5 support for build_database_server (PostgreSQL);
wenzelm
parents: 68220
diff changeset
  1313
      input_dirs.map(_ + heap(name)).find(_.is_file)
68212
5a59fded83c7 clarified heap vs. database operations: discontinued correlation of directory;
wenzelm
parents: 68210
diff changeset
  1314
5a59fded83c7 clarified heap vs. database operations: discontinued correlation of directory;
wenzelm
parents: 68210
diff changeset
  1315
    def find_heap_digest(name: String): Option[String] =
71601
97ccf48c2f0c misc tuning based on hints by IntelliJ IDEA;
wenzelm
parents: 71599
diff changeset
  1316
      find_heap(name).flatMap(read_heap_digest)
62632
cd991ba01ffd clarified modules;
wenzelm
parents: 62631
diff changeset
  1317
68221
dbef88c2b6c5 support for build_database_server (PostgreSQL);
wenzelm
parents: 68220
diff changeset
  1318
    def the_heap(name: String): Path =
dbef88c2b6c5 support for build_database_server (PostgreSQL);
wenzelm
parents: 68220
diff changeset
  1319
      find_heap(name) getOrElse
dbef88c2b6c5 support for build_database_server (PostgreSQL);
wenzelm
parents: 68220
diff changeset
  1320
        error("Missing heap image for session " + quote(name) + " -- expected in:\n" +
dbef88c2b6c5 support for build_database_server (PostgreSQL);
wenzelm
parents: 68220
diff changeset
  1321
          cat_lines(input_dirs.map(dir => "  " + dir.expand.implode)))
dbef88c2b6c5 support for build_database_server (PostgreSQL);
wenzelm
parents: 68220
diff changeset
  1322
dbef88c2b6c5 support for build_database_server (PostgreSQL);
wenzelm
parents: 68220
diff changeset
  1323
dbef88c2b6c5 support for build_database_server (PostgreSQL);
wenzelm
parents: 68220
diff changeset
  1324
    /* database */
dbef88c2b6c5 support for build_database_server (PostgreSQL);
wenzelm
parents: 68220
diff changeset
  1325
72634
5cea0993ee4f clarified access to single database server vs. collection of database files;
wenzelm
parents: 72627
diff changeset
  1326
    def database_server: Boolean = options.bool("build_database_server")
65281
c70e7d24a16d SQL database operations for combined session info;
wenzelm
parents: 65278
diff changeset
  1327
72634
5cea0993ee4f clarified access to single database server vs. collection of database files;
wenzelm
parents: 72627
diff changeset
  1328
    def open_database_server(): SQL.Database =
5cea0993ee4f clarified access to single database server vs. collection of database files;
wenzelm
parents: 72627
diff changeset
  1329
      PostgreSQL.open_database(
5cea0993ee4f clarified access to single database server vs. collection of database files;
wenzelm
parents: 72627
diff changeset
  1330
        user = options.string("build_database_user"),
5cea0993ee4f clarified access to single database server vs. collection of database files;
wenzelm
parents: 72627
diff changeset
  1331
        password = options.string("build_database_password"),
5cea0993ee4f clarified access to single database server vs. collection of database files;
wenzelm
parents: 72627
diff changeset
  1332
        database = options.string("build_database_name"),
5cea0993ee4f clarified access to single database server vs. collection of database files;
wenzelm
parents: 72627
diff changeset
  1333
        host = options.string("build_database_host"),
5cea0993ee4f clarified access to single database server vs. collection of database files;
wenzelm
parents: 72627
diff changeset
  1334
        port = options.int("build_database_port"),
5cea0993ee4f clarified access to single database server vs. collection of database files;
wenzelm
parents: 72627
diff changeset
  1335
        ssh =
5cea0993ee4f clarified access to single database server vs. collection of database files;
wenzelm
parents: 72627
diff changeset
  1336
          options.proper_string("build_database_ssh_host").map(ssh_host =>
5cea0993ee4f clarified access to single database server vs. collection of database files;
wenzelm
parents: 72627
diff changeset
  1337
            SSH.open_session(options,
5cea0993ee4f clarified access to single database server vs. collection of database files;
wenzelm
parents: 72627
diff changeset
  1338
              host = ssh_host,
5cea0993ee4f clarified access to single database server vs. collection of database files;
wenzelm
parents: 72627
diff changeset
  1339
              user = options.string("build_database_ssh_user"),
5cea0993ee4f clarified access to single database server vs. collection of database files;
wenzelm
parents: 72627
diff changeset
  1340
              port = options.int("build_database_ssh_port"))),
5cea0993ee4f clarified access to single database server vs. collection of database files;
wenzelm
parents: 72627
diff changeset
  1341
        ssh_close = true)
5cea0993ee4f clarified access to single database server vs. collection of database files;
wenzelm
parents: 72627
diff changeset
  1342
72854
6c660f05f70c clarified signature;
wenzelm
parents: 72847
diff changeset
  1343
    def open_database_context(): Database_Context =
6c660f05f70c clarified signature;
wenzelm
parents: 72847
diff changeset
  1344
      new Database_Context(store, if (database_server) Some(open_database_server()) else None)
72682
e0443773ef1a clarified modules;
wenzelm
parents: 72672
diff changeset
  1345
72634
5cea0993ee4f clarified access to single database server vs. collection of database files;
wenzelm
parents: 72627
diff changeset
  1346
    def try_open_database(name: String, output: Boolean = false): Option[SQL.Database] =
68221
dbef88c2b6c5 support for build_database_server (PostgreSQL);
wenzelm
parents: 68220
diff changeset
  1347
    {
72634
5cea0993ee4f clarified access to single database server vs. collection of database files;
wenzelm
parents: 72627
diff changeset
  1348
      def check(db: SQL.Database): Option[SQL.Database] =
5cea0993ee4f clarified access to single database server vs. collection of database files;
wenzelm
parents: 72627
diff changeset
  1349
        if (output || session_info_exists(db)) Some(db) else { db.close; None }
5cea0993ee4f clarified access to single database server vs. collection of database files;
wenzelm
parents: 72627
diff changeset
  1350
5cea0993ee4f clarified access to single database server vs. collection of database files;
wenzelm
parents: 72627
diff changeset
  1351
      if (database_server) check(open_database_server())
5cea0993ee4f clarified access to single database server vs. collection of database files;
wenzelm
parents: 72627
diff changeset
  1352
      else if (output) Some(SQLite.open_database(output_database(name)))
5cea0993ee4f clarified access to single database server vs. collection of database files;
wenzelm
parents: 72627
diff changeset
  1353
      else {
5cea0993ee4f clarified access to single database server vs. collection of database files;
wenzelm
parents: 72627
diff changeset
  1354
        (for {
5cea0993ee4f clarified access to single database server vs. collection of database files;
wenzelm
parents: 72627
diff changeset
  1355
          dir <- input_dirs.view
5cea0993ee4f clarified access to single database server vs. collection of database files;
wenzelm
parents: 72627
diff changeset
  1356
          path = dir + database(name) if path.is_file
5cea0993ee4f clarified access to single database server vs. collection of database files;
wenzelm
parents: 72627
diff changeset
  1357
          db <- check(SQLite.open_database(path))
5cea0993ee4f clarified access to single database server vs. collection of database files;
wenzelm
parents: 72627
diff changeset
  1358
        } yield db).headOption
68221
dbef88c2b6c5 support for build_database_server (PostgreSQL);
wenzelm
parents: 68220
diff changeset
  1359
      }
dbef88c2b6c5 support for build_database_server (PostgreSQL);
wenzelm
parents: 68220
diff changeset
  1360
    }
68212
5a59fded83c7 clarified heap vs. database operations: discontinued correlation of directory;
wenzelm
parents: 68210
diff changeset
  1361
68221
dbef88c2b6c5 support for build_database_server (PostgreSQL);
wenzelm
parents: 68220
diff changeset
  1362
    def open_database(name: String, output: Boolean = false): SQL.Database =
72634
5cea0993ee4f clarified access to single database server vs. collection of database files;
wenzelm
parents: 72627
diff changeset
  1363
      try_open_database(name, output = output) getOrElse
68221
dbef88c2b6c5 support for build_database_server (PostgreSQL);
wenzelm
parents: 68220
diff changeset
  1364
        error("Missing build database for session " + quote(name))
68205
9a8949f71fd4 tuned signature;
wenzelm
parents: 68204
diff changeset
  1365
68221
dbef88c2b6c5 support for build_database_server (PostgreSQL);
wenzelm
parents: 68220
diff changeset
  1366
    def clean_output(name: String): (Boolean, Boolean) =
dbef88c2b6c5 support for build_database_server (PostgreSQL);
wenzelm
parents: 68220
diff changeset
  1367
    {
dbef88c2b6c5 support for build_database_server (PostgreSQL);
wenzelm
parents: 68220
diff changeset
  1368
      val relevant_db =
dbef88c2b6c5 support for build_database_server (PostgreSQL);
wenzelm
parents: 68220
diff changeset
  1369
        database_server &&
dbef88c2b6c5 support for build_database_server (PostgreSQL);
wenzelm
parents: 68220
diff changeset
  1370
        {
72634
5cea0993ee4f clarified access to single database server vs. collection of database files;
wenzelm
parents: 72627
diff changeset
  1371
          try_open_database(name) match {
68221
dbef88c2b6c5 support for build_database_server (PostgreSQL);
wenzelm
parents: 68220
diff changeset
  1372
            case Some(db) =>
dbef88c2b6c5 support for build_database_server (PostgreSQL);
wenzelm
parents: 68220
diff changeset
  1373
              try {
dbef88c2b6c5 support for build_database_server (PostgreSQL);
wenzelm
parents: 68220
diff changeset
  1374
                db.transaction {
72634
5cea0993ee4f clarified access to single database server vs. collection of database files;
wenzelm
parents: 72627
diff changeset
  1375
                  val relevant_db = session_info_defined(db, name)
68221
dbef88c2b6c5 support for build_database_server (PostgreSQL);
wenzelm
parents: 68220
diff changeset
  1376
                  init_session_info(db, name)
dbef88c2b6c5 support for build_database_server (PostgreSQL);
wenzelm
parents: 68220
diff changeset
  1377
                  relevant_db
dbef88c2b6c5 support for build_database_server (PostgreSQL);
wenzelm
parents: 68220
diff changeset
  1378
                }
dbef88c2b6c5 support for build_database_server (PostgreSQL);
wenzelm
parents: 68220
diff changeset
  1379
              } finally { db.close }
dbef88c2b6c5 support for build_database_server (PostgreSQL);
wenzelm
parents: 68220
diff changeset
  1380
            case None => false
dbef88c2b6c5 support for build_database_server (PostgreSQL);
wenzelm
parents: 68220
diff changeset
  1381
          }
dbef88c2b6c5 support for build_database_server (PostgreSQL);
wenzelm
parents: 68220
diff changeset
  1382
        }
68212
5a59fded83c7 clarified heap vs. database operations: discontinued correlation of directory;
wenzelm
parents: 68210
diff changeset
  1383
68221
dbef88c2b6c5 support for build_database_server (PostgreSQL);
wenzelm
parents: 68220
diff changeset
  1384
      val del =
dbef88c2b6c5 support for build_database_server (PostgreSQL);
wenzelm
parents: 68220
diff changeset
  1385
        for {
69854
cc0b3e177b49 system option "system_heaps" supersedes various command-line options for "system build mode";
wenzelm
parents: 69812
diff changeset
  1386
          dir <-
cc0b3e177b49 system option "system_heaps" supersedes various command-line options for "system build mode";
wenzelm
parents: 69812
diff changeset
  1387
            (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
  1388
          file <- List(heap(name), database(name), log(name), log_gz(name))
dbef88c2b6c5 support for build_database_server (PostgreSQL);
wenzelm
parents: 68220
diff changeset
  1389
          path = dir + file if path.is_file
dbef88c2b6c5 support for build_database_server (PostgreSQL);
wenzelm
parents: 68220
diff changeset
  1390
        } yield path.file.delete
dbef88c2b6c5 support for build_database_server (PostgreSQL);
wenzelm
parents: 68220
diff changeset
  1391
dbef88c2b6c5 support for build_database_server (PostgreSQL);
wenzelm
parents: 68220
diff changeset
  1392
      val relevant = relevant_db || del.nonEmpty
dbef88c2b6c5 support for build_database_server (PostgreSQL);
wenzelm
parents: 68220
diff changeset
  1393
      val ok = del.forall(b => b)
dbef88c2b6c5 support for build_database_server (PostgreSQL);
wenzelm
parents: 68220
diff changeset
  1394
      (relevant, ok)
dbef88c2b6c5 support for build_database_server (PostgreSQL);
wenzelm
parents: 68220
diff changeset
  1395
    }
65287
75999f2a0c38 tuned message;
wenzelm
parents: 65286
diff changeset
  1396
75999f2a0c38 tuned message;
wenzelm
parents: 65286
diff changeset
  1397
68218
wenzelm
parents: 68217
diff changeset
  1398
    /* SQL database content */
wenzelm
parents: 68217
diff changeset
  1399
wenzelm
parents: 68217
diff changeset
  1400
    def read_bytes(db: SQL.Database, name: String, column: SQL.Column): Bytes =
wenzelm
parents: 68217
diff changeset
  1401
      db.using_statement(Session_Info.table.select(List(column),
wenzelm
parents: 68217
diff changeset
  1402
        Session_Info.session_name.where_equal(name)))(stmt =>
wenzelm
parents: 68217
diff changeset
  1403
      {
wenzelm
parents: 68217
diff changeset
  1404
        val res = stmt.execute_query()
wenzelm
parents: 68217
diff changeset
  1405
        if (!res.next()) Bytes.empty else res.bytes(column)
wenzelm
parents: 68217
diff changeset
  1406
      })
wenzelm
parents: 68217
diff changeset
  1407
wenzelm
parents: 68217
diff changeset
  1408
    def read_properties(db: SQL.Database, name: String, column: SQL.Column): List[Properties.T] =
73031
f93f0597f4fb clarified signature: absorb XZ.Cache into XML.Cache;
wenzelm
parents: 73024
diff changeset
  1409
      Properties.uncompress(read_bytes(db, name, column), cache = cache)
68218
wenzelm
parents: 68217
diff changeset
  1410
wenzelm
parents: 68217
diff changeset
  1411
65296
a71db30f3b2d tuned signature;
wenzelm
parents: 65295
diff changeset
  1412
    /* session info */
65281
c70e7d24a16d SQL database operations for combined session info;
wenzelm
parents: 65278
diff changeset
  1413
68086
9e1c670301b8 cleanup session output before starting build job;
wenzelm
parents: 68018
diff changeset
  1414
    def init_session_info(db: SQL.Database, name: String)
9e1c670301b8 cleanup session output before starting build job;
wenzelm
parents: 68018
diff changeset
  1415
    {
9e1c670301b8 cleanup session output before starting build job;
wenzelm
parents: 68018
diff changeset
  1416
      db.transaction {
9e1c670301b8 cleanup session output before starting build job;
wenzelm
parents: 68018
diff changeset
  1417
        db.create_table(Session_Info.table)
9e1c670301b8 cleanup session output before starting build job;
wenzelm
parents: 68018
diff changeset
  1418
        db.using_statement(
9e1c670301b8 cleanup session output before starting build job;
wenzelm
parents: 68018
diff changeset
  1419
          Session_Info.table.delete(Session_Info.session_name.where_equal(name)))(_.execute)
68221
dbef88c2b6c5 support for build_database_server (PostgreSQL);
wenzelm
parents: 68220
diff changeset
  1420
dbef88c2b6c5 support for build_database_server (PostgreSQL);
wenzelm
parents: 68220
diff changeset
  1421
        db.create_table(Export.Data.table)
dbef88c2b6c5 support for build_database_server (PostgreSQL);
wenzelm
parents: 68220
diff changeset
  1422
        db.using_statement(
dbef88c2b6c5 support for build_database_server (PostgreSQL);
wenzelm
parents: 68220
diff changeset
  1423
          Export.Data.table.delete(Export.Data.session_name.where_equal(name)))(_.execute)
72653
ea35afdb1366 store documents within session database, instead of browser_info directory;
wenzelm
parents: 72652
diff changeset
  1424
ea35afdb1366 store documents within session database, instead of browser_info directory;
wenzelm
parents: 72652
diff changeset
  1425
        db.create_table(Presentation.Data.table)
ea35afdb1366 store documents within session database, instead of browser_info directory;
wenzelm
parents: 72652
diff changeset
  1426
        db.using_statement(
ea35afdb1366 store documents within session database, instead of browser_info directory;
wenzelm
parents: 72652
diff changeset
  1427
          Presentation.Data.table.delete(
ea35afdb1366 store documents within session database, instead of browser_info directory;
wenzelm
parents: 72652
diff changeset
  1428
            Presentation.Data.session_name.where_equal(name)))(_.execute)
68221
dbef88c2b6c5 support for build_database_server (PostgreSQL);
wenzelm
parents: 68220
diff changeset
  1429
      }
dbef88c2b6c5 support for build_database_server (PostgreSQL);
wenzelm
parents: 68220
diff changeset
  1430
    }
dbef88c2b6c5 support for build_database_server (PostgreSQL);
wenzelm
parents: 68220
diff changeset
  1431
72634
5cea0993ee4f clarified access to single database server vs. collection of database files;
wenzelm
parents: 72627
diff changeset
  1432
    def session_info_exists(db: SQL.Database): Boolean =
68221
dbef88c2b6c5 support for build_database_server (PostgreSQL);
wenzelm
parents: 68220
diff changeset
  1433
    {
72634
5cea0993ee4f clarified access to single database server vs. collection of database files;
wenzelm
parents: 72627
diff changeset
  1434
      val tables = db.tables
5cea0993ee4f clarified access to single database server vs. collection of database files;
wenzelm
parents: 72627
diff changeset
  1435
      tables.contains(Session_Info.table.name) &&
5cea0993ee4f clarified access to single database server vs. collection of database files;
wenzelm
parents: 72627
diff changeset
  1436
      tables.contains(Export.Data.table.name)
5cea0993ee4f clarified access to single database server vs. collection of database files;
wenzelm
parents: 72627
diff changeset
  1437
    }
5cea0993ee4f clarified access to single database server vs. collection of database files;
wenzelm
parents: 72627
diff changeset
  1438
5cea0993ee4f clarified access to single database server vs. collection of database files;
wenzelm
parents: 72627
diff changeset
  1439
    def session_info_defined(db: SQL.Database, name: String): Boolean =
68221
dbef88c2b6c5 support for build_database_server (PostgreSQL);
wenzelm
parents: 68220
diff changeset
  1440
      db.transaction {
72634
5cea0993ee4f clarified access to single database server vs. collection of database files;
wenzelm
parents: 72627
diff changeset
  1441
        session_info_exists(db) &&
68221
dbef88c2b6c5 support for build_database_server (PostgreSQL);
wenzelm
parents: 68220
diff changeset
  1442
        {
dbef88c2b6c5 support for build_database_server (PostgreSQL);
wenzelm
parents: 68220
diff changeset
  1443
          db.using_statement(
dbef88c2b6c5 support for build_database_server (PostgreSQL);
wenzelm
parents: 68220
diff changeset
  1444
            Session_Info.table.select(List(Session_Info.session_name),
dbef88c2b6c5 support for build_database_server (PostgreSQL);
wenzelm
parents: 68220
diff changeset
  1445
              Session_Info.session_name.where_equal(name)))(stmt => stmt.execute_query().next())
dbef88c2b6c5 support for build_database_server (PostgreSQL);
wenzelm
parents: 68220
diff changeset
  1446
        }
68086
9e1c670301b8 cleanup session output before starting build job;
wenzelm
parents: 68018
diff changeset
  1447
      }
9e1c670301b8 cleanup session output before starting build job;
wenzelm
parents: 68018
diff changeset
  1448
65296
a71db30f3b2d tuned signature;
wenzelm
parents: 65295
diff changeset
  1449
    def write_session_info(
65318
342efc382558 eliminated somewhat redundant inlined name (despite a7aa17a1f721);
wenzelm
parents: 65298
diff changeset
  1450
      db: SQL.Database,
65320
52861eebf58d access table via session_name: db may in principle contain multiple entries;
wenzelm
parents: 65318
diff changeset
  1451
      name: String,
65318
342efc382558 eliminated somewhat redundant inlined name (despite a7aa17a1f721);
wenzelm
parents: 65298
diff changeset
  1452
      build_log: Build_Log.Session_Info,
342efc382558 eliminated somewhat redundant inlined name (despite a7aa17a1f721);
wenzelm
parents: 65298
diff changeset
  1453
      build: Build.Session_Info)
65281
c70e7d24a16d SQL database operations for combined session info;
wenzelm
parents: 65278
diff changeset
  1454
    {
c70e7d24a16d SQL database operations for combined session info;
wenzelm
parents: 65278
diff changeset
  1455
      db.transaction {
65698
38139b2067cf clarified signature;
wenzelm
parents: 65619
diff changeset
  1456
        db.using_statement(Session_Info.table.insert())(stmt =>
65281
c70e7d24a16d SQL database operations for combined session info;
wenzelm
parents: 65278
diff changeset
  1457
        {
65748
1f4a80e80c88 tuned signature;
wenzelm
parents: 65740
diff changeset
  1458
          stmt.string(1) = name
65857
5d29d93766ef clarified use of XML.Cache;
wenzelm
parents: 65833
diff changeset
  1459
          stmt.bytes(2) = Properties.encode(build_log.session_timing)
73031
f93f0597f4fb clarified signature: absorb XZ.Cache into XML.Cache;
wenzelm
parents: 73024
diff changeset
  1460
          stmt.bytes(3) = Properties.compress(build_log.command_timings, cache = cache.xz)
f93f0597f4fb clarified signature: absorb XZ.Cache into XML.Cache;
wenzelm
parents: 73024
diff changeset
  1461
          stmt.bytes(4) = Properties.compress(build_log.theory_timings, cache = cache.xz)
f93f0597f4fb clarified signature: absorb XZ.Cache into XML.Cache;
wenzelm
parents: 73024
diff changeset
  1462
          stmt.bytes(5) = Properties.compress(build_log.ml_statistics, cache = cache.xz)
f93f0597f4fb clarified signature: absorb XZ.Cache into XML.Cache;
wenzelm
parents: 73024
diff changeset
  1463
          stmt.bytes(6) = Properties.compress(build_log.task_statistics, cache = cache.xz)
f93f0597f4fb clarified signature: absorb XZ.Cache into XML.Cache;
wenzelm
parents: 73024
diff changeset
  1464
          stmt.bytes(7) = Build_Log.compress_errors(build_log.errors, cache = cache.xz)
66873
9953ae603a23 provide theory timing information, similar to command timing but always considered relevant;
wenzelm
parents: 66857
diff changeset
  1465
          stmt.string(8) = build.sources
9953ae603a23 provide theory timing information, similar to command timing but always considered relevant;
wenzelm
parents: 66857
diff changeset
  1466
          stmt.string(9) = cat_lines(build.input_heaps)
9953ae603a23 provide theory timing information, similar to command timing but always considered relevant;
wenzelm
parents: 66857
diff changeset
  1467
          stmt.string(10) = build.output_heap getOrElse ""
9953ae603a23 provide theory timing information, similar to command timing but always considered relevant;
wenzelm
parents: 66857
diff changeset
  1468
          stmt.int(11) = build.return_code
65281
c70e7d24a16d SQL database operations for combined session info;
wenzelm
parents: 65278
diff changeset
  1469
          stmt.execute()
c70e7d24a16d SQL database operations for combined session info;
wenzelm
parents: 65278
diff changeset
  1470
        })
c70e7d24a16d SQL database operations for combined session info;
wenzelm
parents: 65278
diff changeset
  1471
      }
c70e7d24a16d SQL database operations for combined session info;
wenzelm
parents: 65278
diff changeset
  1472
    }
c70e7d24a16d SQL database operations for combined session info;
wenzelm
parents: 65278
diff changeset
  1473
65320
52861eebf58d access table via session_name: db may in principle contain multiple entries;
wenzelm
parents: 65318
diff changeset
  1474
    def read_session_timing(db: SQL.Database, name: String): Properties.T =
73031
f93f0597f4fb clarified signature: absorb XZ.Cache into XML.Cache;
wenzelm
parents: 73024
diff changeset
  1475
      Properties.decode(read_bytes(db, name, Session_Info.session_timing), cache = cache)
65286
b661543a0de6 clarified signature;
wenzelm
parents: 65285
diff changeset
  1476
65320
52861eebf58d access table via session_name: db may in principle contain multiple entries;
wenzelm
parents: 65318
diff changeset
  1477
    def read_command_timings(db: SQL.Database, name: String): List[Properties.T] =
52861eebf58d access table via session_name: db may in principle contain multiple entries;
wenzelm
parents: 65318
diff changeset
  1478
      read_properties(db, name, Session_Info.command_timings)
65286
b661543a0de6 clarified signature;
wenzelm
parents: 65285
diff changeset
  1479
66873
9953ae603a23 provide theory timing information, similar to command timing but always considered relevant;
wenzelm
parents: 66857
diff changeset
  1480
    def read_theory_timings(db: SQL.Database, name: String): List[Properties.T] =
9953ae603a23 provide theory timing information, similar to command timing but always considered relevant;
wenzelm
parents: 66857
diff changeset
  1481
      read_properties(db, name, Session_Info.theory_timings)
9953ae603a23 provide theory timing information, similar to command timing but always considered relevant;
wenzelm
parents: 66857
diff changeset
  1482
65320
52861eebf58d access table via session_name: db may in principle contain multiple entries;
wenzelm
parents: 65318
diff changeset
  1483
    def read_ml_statistics(db: SQL.Database, name: String): List[Properties.T] =
52861eebf58d access table via session_name: db may in principle contain multiple entries;
wenzelm
parents: 65318
diff changeset
  1484
      read_properties(db, name, Session_Info.ml_statistics)
65286
b661543a0de6 clarified signature;
wenzelm
parents: 65285
diff changeset
  1485
65320
52861eebf58d access table via session_name: db may in principle contain multiple entries;
wenzelm
parents: 65318
diff changeset
  1486
    def read_task_statistics(db: SQL.Database, name: String): List[Properties.T] =
52861eebf58d access table via session_name: db may in principle contain multiple entries;
wenzelm
parents: 65318
diff changeset
  1487
      read_properties(db, name, Session_Info.task_statistics)
65286
b661543a0de6 clarified signature;
wenzelm
parents: 65285
diff changeset
  1488
72738
a4d7da18ac5c store timings for used_theories in canonical order, with reconstructed store.read_theories;
wenzelm
parents: 72716
diff changeset
  1489
    def read_theories(db: SQL.Database, name: String): List[String] =
a4d7da18ac5c store timings for used_theories in canonical order, with reconstructed store.read_theories;
wenzelm
parents: 72716
diff changeset
  1490
      read_theory_timings(db, name).flatMap(Markup.Name.unapply)
a4d7da18ac5c store timings for used_theories in canonical order, with reconstructed store.read_theories;
wenzelm
parents: 72716
diff changeset
  1491
65937
fde7b5d209d5 store errors in build_history logs and database;
wenzelm
parents: 65934
diff changeset
  1492
    def read_errors(db: SQL.Database, name: String): List[String] =
73033
d2690444c00a clarified caching;
wenzelm
parents: 73031
diff changeset
  1493
      Build_Log.uncompress_errors(read_bytes(db, name, Session_Info.errors), cache = cache)
65937
fde7b5d209d5 store errors in build_history logs and database;
wenzelm
parents: 65934
diff changeset
  1494
65320
52861eebf58d access table via session_name: db may in principle contain multiple entries;
wenzelm
parents: 65318
diff changeset
  1495
    def read_build(db: SQL.Database, name: String): Option[Build.Session_Info] =
66744
fec1504e5f03 persistent storage of imported_sources;
wenzelm
parents: 66743
diff changeset
  1496
    {
66957
82d13ba817b2 more permissive: db could be empty after hard crash;
wenzelm
parents: 66914
diff changeset
  1497
      if (db.tables.contains(Session_Info.table.name)) {
82d13ba817b2 more permissive: db could be empty after hard crash;
wenzelm
parents: 66914
diff changeset
  1498
        db.using_statement(Session_Info.table.select(Session_Info.build_columns,
82d13ba817b2 more permissive: db could be empty after hard crash;
wenzelm
parents: 66914
diff changeset
  1499
          Session_Info.session_name.where_equal(name)))(stmt =>
82d13ba817b2 more permissive: db could be empty after hard crash;
wenzelm
parents: 66914
diff changeset
  1500
        {
82d13ba817b2 more permissive: db could be empty after hard crash;
wenzelm
parents: 66914
diff changeset
  1501
          val res = stmt.execute_query()
82d13ba817b2 more permissive: db could be empty after hard crash;
wenzelm
parents: 66914
diff changeset
  1502
          if (!res.next()) None
82d13ba817b2 more permissive: db could be empty after hard crash;
wenzelm
parents: 66914
diff changeset
  1503
          else {
82d13ba817b2 more permissive: db could be empty after hard crash;
wenzelm
parents: 66914
diff changeset
  1504
            Some(
82d13ba817b2 more permissive: db could be empty after hard crash;
wenzelm
parents: 66914
diff changeset
  1505
              Build.Session_Info(
82d13ba817b2 more permissive: db could be empty after hard crash;
wenzelm
parents: 66914
diff changeset
  1506
                res.string(Session_Info.sources),
82d13ba817b2 more permissive: db could be empty after hard crash;
wenzelm
parents: 66914
diff changeset
  1507
                split_lines(res.string(Session_Info.input_heaps)),
82d13ba817b2 more permissive: db could be empty after hard crash;
wenzelm
parents: 66914
diff changeset
  1508
                res.string(Session_Info.output_heap) match { case "" => None case s => Some(s) },
82d13ba817b2 more permissive: db could be empty after hard crash;
wenzelm
parents: 66914
diff changeset
  1509
                res.int(Session_Info.return_code)))
82d13ba817b2 more permissive: db could be empty after hard crash;
wenzelm
parents: 66914
diff changeset
  1510
          }
82d13ba817b2 more permissive: db could be empty after hard crash;
wenzelm
parents: 66914
diff changeset
  1511
        })
82d13ba817b2 more permissive: db could be empty after hard crash;
wenzelm
parents: 66914
diff changeset
  1512
      }
82d13ba817b2 more permissive: db could be empty after hard crash;
wenzelm
parents: 66914
diff changeset
  1513
      else None
66744
fec1504e5f03 persistent storage of imported_sources;
wenzelm
parents: 66743
diff changeset
  1514
    }
65281
c70e7d24a16d SQL database operations for combined session info;
wenzelm
parents: 65278
diff changeset
  1515
  }
62631
c39614ddb80b clarified modules;
wenzelm
parents:
diff changeset
  1516
}