author | wenzelm |
Mon, 28 May 2018 11:15:17 +0200 | |
changeset 68304 | 09270aa40884 |
parent 68294 | 0f513ae3db77 |
child 68306 | d575281e18d0 |
permissions | -rw-r--r-- |
62631 | 1 |
/* Title: Pure/Thy/sessions.scala |
2 |
Author: Makarius |
|
3 |
||
65430 | 4 |
Cumulative session information. |
62631 | 5 |
*/ |
6 |
||
7 |
package isabelle |
|
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 | 13 |
|
14 |
import scala.collection.SortedSet |
|
15 |
import scala.collection.mutable |
|
16 |
||
17 |
||
18 |
object Sessions |
|
19 |
{ |
|
67284 | 20 |
/* session and theory names */ |
62883 | 21 |
|
67215 | 22 |
val root_name: String = "ROOT" |
23 |
val theory_name: String = "Pure.Sessions" |
|
24 |
||
65445
e9e7f5f5794c
more qualifier treatment, but in the end it is still ignored;
wenzelm
parents:
65441
diff
changeset
|
25 |
val DRAFT = "Draft" |
e9e7f5f5794c
more qualifier treatment, but in the end it is still ignored;
wenzelm
parents:
65441
diff
changeset
|
26 |
|
65360 | 27 |
def is_pure(name: String): Boolean = name == Thy_Header.PURE |
64856 | 28 |
|
67284 | 29 |
|
30 |
def exclude_session(name: String): Boolean = name == "" || name == DRAFT |
|
31 |
||
67286 | 32 |
def exclude_theory(name: String): Boolean = |
67290 | 33 |
name == root_name || name == "README" || name == "index" || name == "bib" |
67284 | 34 |
|
35 |
||
36 |
/* base info and source dependencies */ |
|
37 |
||
65495 | 38 |
object Known |
64856 | 39 |
{ |
65495 | 40 |
val empty: Known = Known() |
65360 | 41 |
|
66701 | 42 |
def make(local_dir: Path, bases: List[Base], |
67493
c4e9e0c50487
treat sessions as entities with defining position;
wenzelm
parents:
67471
diff
changeset
|
43 |
sessions: List[(String, Position.T)] = Nil, |
66701 | 44 |
theories: List[Document.Node.Name] = Nil, |
45 |
loaded_files: List[(String, List[Path])] = Nil): Known = |
|
65427 | 46 |
{ |
65463
104502de757c
more informative known_files: known_theories within the local session directory come first;
wenzelm
parents:
65461
diff
changeset
|
47 |
def bases_iterator(local: Boolean) = |
104502de757c
more informative known_files: known_theories within the local session directory come first;
wenzelm
parents:
65461
diff
changeset
|
48 |
for { |
104502de757c
more informative known_files: known_theories within the local session directory come first;
wenzelm
parents:
65461
diff
changeset
|
49 |
base <- bases.iterator |
65499 | 50 |
(_, name) <- (if (local) base.known.theories_local else base.known.theories).iterator |
65463
104502de757c
more informative known_files: known_theories within the local session directory come first;
wenzelm
parents:
65461
diff
changeset
|
51 |
} yield name |
104502de757c
more informative known_files: known_theories within the local session directory come first;
wenzelm
parents:
65461
diff
changeset
|
52 |
|
104502de757c
more informative known_files: known_theories within the local session directory come first;
wenzelm
parents:
65461
diff
changeset
|
53 |
def local_theories_iterator = |
104502de757c
more informative known_files: known_theories within the local session directory come first;
wenzelm
parents:
65461
diff
changeset
|
54 |
{ |
65833 | 55 |
val local_path = local_dir.canonical_file.toPath |
66716 | 56 |
theories.iterator.filter(name => name.path.canonical_file.toPath.startsWith(local_path)) |
65463
104502de757c
more informative known_files: known_theories within the local session directory come first;
wenzelm
parents:
65461
diff
changeset
|
57 |
} |
65427 | 58 |
|
67219 | 59 |
val known_sessions = |
67493
c4e9e0c50487
treat sessions as entities with defining position;
wenzelm
parents:
67471
diff
changeset
|
60 |
(sessions.toMap /: bases)({ case (known, base) => known ++ base.known.sessions }) |
67219 | 61 |
|
65461
b6c2e30dc018
support for known theories files (according to multiple uses);
wenzelm
parents:
65457
diff
changeset
|
62 |
val known_theories = |
65463
104502de757c
more informative known_files: known_theories within the local session directory come first;
wenzelm
parents:
65461
diff
changeset
|
63 |
(Map.empty[String, Document.Node.Name] /: (bases_iterator(false) ++ theories.iterator))({ |
65461
b6c2e30dc018
support for known theories files (according to multiple uses);
wenzelm
parents:
65457
diff
changeset
|
64 |
case (known, name) => |
b6c2e30dc018
support for known theories files (according to multiple uses);
wenzelm
parents:
65457
diff
changeset
|
65 |
known.get(name.theory) match { |
b6c2e30dc018
support for known theories files (according to multiple uses);
wenzelm
parents:
65457
diff
changeset
|
66 |
case Some(name1) if name != name1 => |
b6c2e30dc018
support for known theories files (according to multiple uses);
wenzelm
parents:
65457
diff
changeset
|
67 |
error("Duplicate theory " + quote(name.node) + " vs. " + quote(name1.node)) |
b6c2e30dc018
support for known theories files (according to multiple uses);
wenzelm
parents:
65457
diff
changeset
|
68 |
case _ => known + (name.theory -> name) |
b6c2e30dc018
support for known theories files (according to multiple uses);
wenzelm
parents:
65457
diff
changeset
|
69 |
} |
b6c2e30dc018
support for known theories files (according to multiple uses);
wenzelm
parents:
65457
diff
changeset
|
70 |
}) |
65463
104502de757c
more informative known_files: known_theories within the local session directory come first;
wenzelm
parents:
65461
diff
changeset
|
71 |
val known_theories_local = |
104502de757c
more informative known_files: known_theories within the local session directory come first;
wenzelm
parents:
65461
diff
changeset
|
72 |
(Map.empty[String, Document.Node.Name] /: |
104502de757c
more informative known_files: known_theories within the local session directory come first;
wenzelm
parents:
65461
diff
changeset
|
73 |
(bases_iterator(true) ++ local_theories_iterator))({ |
104502de757c
more informative known_files: known_theories within the local session directory come first;
wenzelm
parents:
65461
diff
changeset
|
74 |
case (known, name) => known + (name.theory -> name) |
104502de757c
more informative known_files: known_theories within the local session directory come first;
wenzelm
parents:
65461
diff
changeset
|
75 |
}) |
65461
b6c2e30dc018
support for known theories files (according to multiple uses);
wenzelm
parents:
65457
diff
changeset
|
76 |
val known_files = |
65463
104502de757c
more informative known_files: known_theories within the local session directory come first;
wenzelm
parents:
65461
diff
changeset
|
77 |
(Map.empty[JFile, List[Document.Node.Name]] /: |
104502de757c
more informative known_files: known_theories within the local session directory come first;
wenzelm
parents:
65461
diff
changeset
|
78 |
(bases_iterator(true) ++ bases_iterator(false) ++ theories.iterator))({ |
65461
b6c2e30dc018
support for known theories files (according to multiple uses);
wenzelm
parents:
65457
diff
changeset
|
79 |
case (known, name) => |
66716 | 80 |
val file = name.path.canonical_file |
65463
104502de757c
more informative known_files: known_theories within the local session directory come first;
wenzelm
parents:
65461
diff
changeset
|
81 |
val theories1 = known.getOrElse(file, Nil) |
104502de757c
more informative known_files: known_theories within the local session directory come first;
wenzelm
parents:
65461
diff
changeset
|
82 |
if (theories1.exists(name1 => name.node == name1.node && name.theory == name1.theory)) |
65461
b6c2e30dc018
support for known theories files (according to multiple uses);
wenzelm
parents:
65457
diff
changeset
|
83 |
known |
65463
104502de757c
more informative known_files: known_theories within the local session directory come first;
wenzelm
parents:
65461
diff
changeset
|
84 |
else known + (file -> (name :: theories1)) |
65427 | 85 |
}) |
66701 | 86 |
|
87 |
val known_loaded_files = |
|
88 |
(loaded_files.toMap /: bases.map(base => base.known.loaded_files))(_ ++ _) |
|
89 |
||
67219 | 90 |
Known( |
91 |
known_sessions, |
|
92 |
known_theories, known_theories_local, |
|
66701 | 93 |
known_files.iterator.map(p => (p._1, p._2.reverse)).toMap, |
94 |
known_loaded_files) |
|
65427 | 95 |
} |
64856 | 96 |
} |
97 |
||
65495 | 98 |
sealed case class Known( |
67493
c4e9e0c50487
treat sessions as entities with defining position;
wenzelm
parents:
67471
diff
changeset
|
99 |
sessions: Map[String, Position.T] = Map.empty, |
65499 | 100 |
theories: Map[String, Document.Node.Name] = Map.empty, |
101 |
theories_local: Map[String, Document.Node.Name] = Map.empty, |
|
66701 | 102 |
files: Map[JFile, List[Document.Node.Name]] = Map.empty, |
103 |
loaded_files: Map[String, List[Path]] = Map.empty) |
|
65355 | 104 |
{ |
65495 | 105 |
def platform_path: Known = |
65499 | 106 |
copy(theories = for ((a, b) <- theories) yield (a, b.map(File.platform_path(_))), |
107 |
theories_local = for ((a, b) <- theories_local) yield (a, b.map(File.platform_path(_))), |
|
108 |
files = for ((a, b) <- files) yield (a, b.map(c => c.map(File.platform_path(_))))) |
|
65524 | 109 |
|
66668
6019cfb8256c
proper standard_path to revert platform_path in JEdit_Sessions.session_base;
wenzelm
parents:
66604
diff
changeset
|
110 |
def standard_path: Known = |
6019cfb8256c
proper standard_path to revert platform_path in JEdit_Sessions.session_base;
wenzelm
parents:
66604
diff
changeset
|
111 |
copy(theories = for ((a, b) <- theories) yield (a, b.map(File.standard_path(_))), |
6019cfb8256c
proper standard_path to revert platform_path in JEdit_Sessions.session_base;
wenzelm
parents:
66604
diff
changeset
|
112 |
theories_local = for ((a, b) <- theories_local) yield (a, b.map(File.standard_path(_))), |
6019cfb8256c
proper standard_path to revert platform_path in JEdit_Sessions.session_base;
wenzelm
parents:
66604
diff
changeset
|
113 |
files = for ((a, b) <- files) yield (a, b.map(c => c.map(File.standard_path(_))))) |
6019cfb8256c
proper standard_path to revert platform_path in JEdit_Sessions.session_base;
wenzelm
parents:
66604
diff
changeset
|
114 |
|
66195 | 115 |
def get_file(file: JFile, bootstrap: Boolean = false): Option[Document.Node.Name] = |
116 |
{ |
|
66234 | 117 |
val res = files.getOrElse(File.canonical(file), Nil).headOption |
66195 | 118 |
if (bootstrap) res.map(_.map_theory(Thy_Header.bootstrap_name(_))) else res |
119 |
} |
|
65495 | 120 |
} |
121 |
||
122 |
object Base |
|
123 |
{ |
|
124 |
def bootstrap(global_theories: Map[String, String]): Base = |
|
125 |
Base( |
|
126 |
global_theories = global_theories, |
|
66720 | 127 |
overall_syntax = Thy_Header.bootstrap_syntax) |
65495 | 128 |
} |
129 |
||
130 |
sealed case class Base( |
|
66571 | 131 |
pos: Position.T = Position.none, |
67471 | 132 |
doc_names: List[String] = Nil, |
65495 | 133 |
global_theories: Map[String, String] = Map.empty, |
66717
67dbf5cdc056
more informative loaded_theories: dependencies and syntax;
wenzelm
parents:
66716
diff
changeset
|
134 |
loaded_theories: Graph[String, Outer_Syntax] = Graph.string, |
65495 | 135 |
known: Known = Known.empty, |
66720 | 136 |
overall_syntax: Outer_Syntax = Outer_Syntax.empty, |
66744 | 137 |
imported_sources: List[(Path, SHA1.Digest)] = Nil, |
65495 | 138 |
sources: List[(Path, SHA1.Digest)] = Nil, |
66822 | 139 |
session_graph_display: Graph_Display.Graph = Graph_Display.empty_graph, |
66694
41177b124067
tuned signature -- more readable output as Scala value;
wenzelm
parents:
66668
diff
changeset
|
140 |
errors: List[String] = Nil, |
41177b124067
tuned signature -- more readable output as Scala value;
wenzelm
parents:
66668
diff
changeset
|
141 |
imports: Option[Base] = None) |
65495 | 142 |
{ |
143 |
def platform_path: Base = copy(known = known.platform_path) |
|
66668
6019cfb8256c
proper standard_path to revert platform_path in JEdit_Sessions.session_base;
wenzelm
parents:
66604
diff
changeset
|
144 |
def standard_path: Base = copy(known = known.standard_path) |
65463
104502de757c
more informative known_files: known_theories within the local session directory come first;
wenzelm
parents:
65461
diff
changeset
|
145 |
|
66967
e365c91c72a9
synthesize session with all required theories from other session imports;
wenzelm
parents:
66966
diff
changeset
|
146 |
def theory_qualifier(name: String): String = |
e365c91c72a9
synthesize session with all required theories from other session imports;
wenzelm
parents:
66966
diff
changeset
|
147 |
global_theories.getOrElse(name, Long_Name.qualifier(name)) |
e365c91c72a9
synthesize session with all required theories from other session imports;
wenzelm
parents:
66966
diff
changeset
|
148 |
def theory_qualifier(name: Document.Node.Name): String = theory_qualifier(name.theory) |
66966 | 149 |
|
66717
67dbf5cdc056
more informative loaded_theories: dependencies and syntax;
wenzelm
parents:
66716
diff
changeset
|
150 |
def loaded_theory(name: String): Boolean = loaded_theories.defined(name) |
66712 | 151 |
def loaded_theory(name: Document.Node.Name): Boolean = loaded_theory(name.theory) |
65432 | 152 |
|
66717
67dbf5cdc056
more informative loaded_theories: dependencies and syntax;
wenzelm
parents:
66716
diff
changeset
|
153 |
def loaded_theory_syntax(name: String): Option[Outer_Syntax] = |
67dbf5cdc056
more informative loaded_theories: dependencies and syntax;
wenzelm
parents:
66716
diff
changeset
|
154 |
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
|
155 |
def loaded_theory_syntax(name: Document.Node.Name): Option[Outer_Syntax] = |
67dbf5cdc056
more informative loaded_theories: dependencies and syntax;
wenzelm
parents:
66716
diff
changeset
|
156 |
loaded_theory_syntax(name.theory) |
67dbf5cdc056
more informative loaded_theories: dependencies and syntax;
wenzelm
parents:
66716
diff
changeset
|
157 |
|
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
|
158 |
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
|
159 |
nodes(name).syntax orElse loaded_theory_syntax(name) getOrElse overall_syntax |
66721
ae38b8c0fdd9
more accurate node_syntax: avoid overall_syntax for PIDE edits;
wenzelm
parents:
66720
diff
changeset
|
160 |
|
65498 | 161 |
def known_theory(name: String): Option[Document.Node.Name] = |
65499 | 162 |
known.theories.get(name) |
65498 | 163 |
|
65432 | 164 |
def dest_known_theories: List[(String, String)] = |
65499 | 165 |
for ((theory, node_name) <- known.theories.toList) |
65432 | 166 |
yield (theory, node_name.node) |
66694
41177b124067
tuned signature -- more readable output as Scala value;
wenzelm
parents:
66668
diff
changeset
|
167 |
|
41177b124067
tuned signature -- more readable output as Scala value;
wenzelm
parents:
66668
diff
changeset
|
168 |
def get_imports: Base = imports getOrElse Base.bootstrap(global_theories) |
65355 | 169 |
} |
64856 | 170 |
|
68204 | 171 |
sealed case class Deps( |
172 |
sessions_structure: Structure, session_bases: Map[String, Base], all_known: Known) |
|
65251 | 173 |
{ |
65463
104502de757c
more informative known_files: known_theories within the local session directory come first;
wenzelm
parents:
65461
diff
changeset
|
174 |
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
|
175 |
def apply(name: String): Base = session_bases(name) |
66988 | 176 |
def get(name: String): Option[Base] = session_bases.get(name) |
66744 | 177 |
|
178 |
def imported_sources(name: String): List[SHA1.Digest] = |
|
179 |
session_bases(name).imported_sources.map(_._2) |
|
180 |
||
181 |
def sources(name: String): List[SHA1.Digest] = |
|
182 |
session_bases(name).sources.map(_._2) |
|
66571 | 183 |
|
184 |
def errors: List[String] = |
|
185 |
(for { |
|
186 |
(name, base) <- session_bases.iterator |
|
187 |
if base.errors.nonEmpty |
|
188 |
} yield cat_lines(base.errors) + |
|
189 |
"\nThe error(s) above occurred in session " + quote(name) + Position.here(base.pos) |
|
190 |
).toList |
|
191 |
||
192 |
def check_errors: Deps = |
|
193 |
errors match { |
|
194 |
case Nil => this |
|
195 |
case errs => error(cat_lines(errs)) |
|
196 |
} |
|
65251 | 197 |
} |
64856 | 198 |
|
67052 | 199 |
def deps(sessions_structure: Structure, |
66962
e1bde71bace6
clarified signature: global_theories is always required;
wenzelm
parents:
66960
diff
changeset
|
200 |
global_theories: Map[String, String], |
65251 | 201 |
progress: Progress = No_Progress, |
202 |
inlined_files: Boolean = false, |
|
203 |
verbose: Boolean = false, |
|
204 |
list_files: Boolean = false, |
|
66962
e1bde71bace6
clarified signature: global_theories is always required;
wenzelm
parents:
66960
diff
changeset
|
205 |
check_keywords: Set[String] = Set.empty): Deps = |
65372
b722ee40c26c
refer to global_theories from all sessions, before selection;
wenzelm
parents:
65371
diff
changeset
|
206 |
{ |
66743 | 207 |
var cache_sources = Map.empty[JFile, SHA1.Digest] |
208 |
def check_sources(paths: List[Path]): List[(Path, SHA1.Digest)] = |
|
209 |
{ |
|
210 |
for { |
|
211 |
path <- paths |
|
212 |
file = path.file |
|
213 |
if cache_sources.isDefinedAt(file) || file.isFile |
|
214 |
} |
|
215 |
yield { |
|
216 |
cache_sources.get(file) match { |
|
217 |
case Some(digest) => (path, digest) |
|
218 |
case None => |
|
219 |
val digest = SHA1.digest(file) |
|
220 |
cache_sources = cache_sources + (file -> digest) |
|
221 |
(path, digest) |
|
222 |
} |
|
223 |
} |
|
224 |
} |
|
225 |
||
67471 | 226 |
val doc_names = Doc.doc_names() |
227 |
||
65463
104502de757c
more informative known_files: known_theories within the local session directory come first;
wenzelm
parents:
65461
diff
changeset
|
228 |
val session_bases = |
67024 | 229 |
(Map.empty[String, Base] /: sessions_structure.imports_topological_order)({ |
67023 | 230 |
case (session_bases, session_name) => |
67880 | 231 |
progress.expose_interrupt() |
65251 | 232 |
|
67024 | 233 |
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
|
234 |
try { |
65496 | 235 |
val parent_base: Sessions.Base = |
65463
104502de757c
more informative known_files: known_theories within the local session directory come first;
wenzelm
parents:
65461
diff
changeset
|
236 |
info.parent match { |
65475 | 237 |
case None => Base.bootstrap(global_theories) |
65463
104502de757c
more informative known_files: known_theories within the local session directory come first;
wenzelm
parents:
65461
diff
changeset
|
238 |
case Some(parent) => session_bases(parent) |
104502de757c
more informative known_files: known_theories within the local session directory come first;
wenzelm
parents:
65461
diff
changeset
|
239 |
} |
65496 | 240 |
val imports_base: Sessions.Base = |
241 |
parent_base.copy(known = |
|
66701 | 242 |
Known.make(info.dir, parent_base :: info.imports.map(session_bases(_)))) |
65496 | 243 |
|
65532 | 244 |
val resources = new Resources(imports_base) |
65251 | 245 |
|
65463
104502de757c
more informative known_files: known_theories within the local session directory come first;
wenzelm
parents:
65461
diff
changeset
|
246 |
if (verbose || list_files) { |
104502de757c
more informative known_files: known_theories within the local session directory come first;
wenzelm
parents:
65461
diff
changeset
|
247 |
val groups = |
104502de757c
more informative known_files: known_theories within the local session directory come first;
wenzelm
parents:
65461
diff
changeset
|
248 |
if (info.groups.isEmpty) "" |
104502de757c
more informative known_files: known_theories within the local session directory come first;
wenzelm
parents:
65461
diff
changeset
|
249 |
else info.groups.mkString(" (", " ", ")") |
65519 | 250 |
progress.echo("Session " + info.chapter + "/" + info.name + groups) |
65463
104502de757c
more informative known_files: known_theories within the local session directory come first;
wenzelm
parents:
65461
diff
changeset
|
251 |
} |
65251 | 252 |
|
67053 | 253 |
val dependencies = |
66959 | 254 |
resources.dependencies( |
66742 | 255 |
for { (_, thys) <- info.theories; (thy, pos) <- thys } |
66780
bf54ca580bf2
theory qualifier is always session name (see also 31e8a86971a8);
wenzelm
parents:
66770
diff
changeset
|
256 |
yield (resources.import_name(info.name, info.dir.implode, thy), pos)) |
65251 | 257 |
|
67053 | 258 |
val overall_syntax = dependencies.overall_syntax |
65251 | 259 |
|
67059 | 260 |
val theory_files = dependencies.theories.map(_.path) |
65463
104502de757c
more informative known_files: known_theories within the local session directory come first;
wenzelm
parents:
65461
diff
changeset
|
261 |
val loaded_files = |
104502de757c
more informative known_files: known_theories within the local session directory come first;
wenzelm
parents:
65461
diff
changeset
|
262 |
if (inlined_files) { |
66701 | 263 |
if (Sessions.is_pure(info.name)) { |
67097 | 264 |
val pure_files = resources.pure_files(overall_syntax, info.dir) |
265 |
dependencies.loaded_files.map({ case (name, files) => |
|
266 |
(name, if (name == Thy_Header.PURE) pure_files ::: files else files) }) |
|
66701 | 267 |
} |
67053 | 268 |
else dependencies.loaded_files |
65463
104502de757c
more informative known_files: known_theories within the local session directory come first;
wenzelm
parents:
65461
diff
changeset
|
269 |
} |
104502de757c
more informative known_files: known_theories within the local session directory come first;
wenzelm
parents:
65461
diff
changeset
|
270 |
else Nil |
65251 | 271 |
|
66742 | 272 |
val session_files = |
66701 | 273 |
(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
|
274 |
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
|
275 |
|
67053 | 276 |
val imported_files = if (inlined_files) dependencies.imported_files else Nil |
66743 | 277 |
|
65463
104502de757c
more informative known_files: known_theories within the local session directory come first;
wenzelm
parents:
65461
diff
changeset
|
278 |
if (list_files) |
66742 | 279 |
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
|
280 |
|
66719
d37efafd55b5
clarified theory syntax vs. overall session syntax;
wenzelm
parents:
66718
diff
changeset
|
281 |
if (check_keywords.nonEmpty) { |
d37efafd55b5
clarified theory syntax vs. overall session syntax;
wenzelm
parents:
66718
diff
changeset
|
282 |
Check_Keywords.check_keywords( |
66720 | 283 |
progress, overall_syntax.keywords, check_keywords, theory_files) |
66719
d37efafd55b5
clarified theory syntax vs. overall session syntax;
wenzelm
parents:
66718
diff
changeset
|
284 |
} |
65251 | 285 |
|
66822 | 286 |
val session_graph_display: Graph_Display.Graph = |
65507
decdb95bd007
clarified session graph: collapse theories from other sessions;
wenzelm
parents:
65500
diff
changeset
|
287 |
{ |
decdb95bd007
clarified session graph: collapse theories from other sessions;
wenzelm
parents:
65500
diff
changeset
|
288 |
def session_node(name: String): Graph_Display.Node = |
decdb95bd007
clarified session graph: collapse theories from other sessions;
wenzelm
parents:
65500
diff
changeset
|
289 |
Graph_Display.Node("[" + name + "]", "session." + name) |
decdb95bd007
clarified session graph: collapse theories from other sessions;
wenzelm
parents:
65500
diff
changeset
|
290 |
|
decdb95bd007
clarified session graph: collapse theories from other sessions;
wenzelm
parents:
65500
diff
changeset
|
291 |
def node(name: Document.Node.Name): Graph_Display.Node = |
decdb95bd007
clarified session graph: collapse theories from other sessions;
wenzelm
parents:
65500
diff
changeset
|
292 |
{ |
66966 | 293 |
val qualifier = imports_base.theory_qualifier(name) |
66780
bf54ca580bf2
theory qualifier is always session name (see also 31e8a86971a8);
wenzelm
parents:
66770
diff
changeset
|
294 |
if (qualifier == info.name) |
65507
decdb95bd007
clarified session graph: collapse theories from other sessions;
wenzelm
parents:
65500
diff
changeset
|
295 |
Graph_Display.Node(name.theory_base_name, "theory." + name.theory) |
65528 | 296 |
else session_node(qualifier) |
65507
decdb95bd007
clarified session graph: collapse theories from other sessions;
wenzelm
parents:
65500
diff
changeset
|
297 |
} |
decdb95bd007
clarified session graph: collapse theories from other sessions;
wenzelm
parents:
65500
diff
changeset
|
298 |
|
decdb95bd007
clarified session graph: collapse theories from other sessions;
wenzelm
parents:
65500
diff
changeset
|
299 |
val imports_subgraph = |
67024 | 300 |
sessions_structure.imports_graph. |
301 |
restrict(sessions_structure.imports_graph.all_preds(info.deps).toSet) |
|
65507
decdb95bd007
clarified session graph: collapse theories from other sessions;
wenzelm
parents:
65500
diff
changeset
|
302 |
|
decdb95bd007
clarified session graph: collapse theories from other sessions;
wenzelm
parents:
65500
diff
changeset
|
303 |
val graph0 = |
decdb95bd007
clarified session graph: collapse theories from other sessions;
wenzelm
parents:
65500
diff
changeset
|
304 |
(Graph_Display.empty_graph /: imports_subgraph.topological_order)( |
decdb95bd007
clarified session graph: collapse theories from other sessions;
wenzelm
parents:
65500
diff
changeset
|
305 |
{ case (g, session) => |
decdb95bd007
clarified session graph: collapse theories from other sessions;
wenzelm
parents:
65500
diff
changeset
|
306 |
val a = session_node(session) |
decdb95bd007
clarified session graph: collapse theories from other sessions;
wenzelm
parents:
65500
diff
changeset
|
307 |
val bs = imports_subgraph.imm_preds(session).toList.map(session_node(_)) |
decdb95bd007
clarified session graph: collapse theories from other sessions;
wenzelm
parents:
65500
diff
changeset
|
308 |
((g /: (a :: bs))(_.default_node(_, Nil)) /: bs)(_.add_edge(_, a)) }) |
decdb95bd007
clarified session graph: collapse theories from other sessions;
wenzelm
parents:
65500
diff
changeset
|
309 |
|
67053 | 310 |
(graph0 /: dependencies.entries)( |
66714 | 311 |
{ case (g, entry) => |
312 |
val a = node(entry.name) |
|
65507
decdb95bd007
clarified session graph: collapse theories from other sessions;
wenzelm
parents:
65500
diff
changeset
|
313 |
val bs = |
66714 | 314 |
entry.header.imports.map({ case (name, _) => node(name) }). |
65507
decdb95bd007
clarified session graph: collapse theories from other sessions;
wenzelm
parents:
65500
diff
changeset
|
315 |
filterNot(_ == a) |
decdb95bd007
clarified session graph: collapse theories from other sessions;
wenzelm
parents:
65500
diff
changeset
|
316 |
((g /: (a :: bs))(_.default_node(_, Nil)) /: bs)(_.add_edge(_, a)) }) |
decdb95bd007
clarified session graph: collapse theories from other sessions;
wenzelm
parents:
65500
diff
changeset
|
317 |
} |
decdb95bd007
clarified session graph: collapse theories from other sessions;
wenzelm
parents:
65500
diff
changeset
|
318 |
|
66701 | 319 |
val known = |
320 |
Known.make(info.dir, List(imports_base), |
|
67493
c4e9e0c50487
treat sessions as entities with defining position;
wenzelm
parents:
67471
diff
changeset
|
321 |
sessions = List(info.name -> info.pos), |
67059 | 322 |
theories = dependencies.theories, |
66701 | 323 |
loaded_files = loaded_files) |
324 |
||
66743 | 325 |
val sources_errors = |
326 |
for (p <- session_files if !p.is_file) yield "No such file: " + p |
|
66604 | 327 |
|
67297
86a099f896fc
formal check of @{cite} bibtex entries -- only in batch-mode session builds;
wenzelm
parents:
67290
diff
changeset
|
328 |
val bibtex_errors = |
86a099f896fc
formal check of @{cite} bibtex entries -- only in batch-mode session builds;
wenzelm
parents:
67290
diff
changeset
|
329 |
try { info.bibtex_entries; Nil } |
86a099f896fc
formal check of @{cite} bibtex entries -- only in batch-mode session builds;
wenzelm
parents:
67290
diff
changeset
|
330 |
catch { case ERROR(msg) => List(msg) } |
86a099f896fc
formal check of @{cite} bibtex entries -- only in batch-mode session builds;
wenzelm
parents:
67290
diff
changeset
|
331 |
|
65463
104502de757c
more informative known_files: known_theories within the local session directory come first;
wenzelm
parents:
65461
diff
changeset
|
332 |
val base = |
66571 | 333 |
Base( |
334 |
pos = info.pos, |
|
67471 | 335 |
doc_names = doc_names, |
65540
2b73ed8bf4d9
proper imports_resources for import_name: avoid self-referential name resolution;
wenzelm
parents:
65532
diff
changeset
|
336 |
global_theories = global_theories, |
67053 | 337 |
loaded_theories = dependencies.loaded_theories, |
66701 | 338 |
known = known, |
66720 | 339 |
overall_syntax = overall_syntax, |
66744 | 340 |
imported_sources = check_sources(imported_files), |
66743 | 341 |
sources = check_sources(session_files), |
66822 | 342 |
session_graph_display = session_graph_display, |
67297
86a099f896fc
formal check of @{cite} bibtex entries -- only in batch-mode session builds;
wenzelm
parents:
67290
diff
changeset
|
343 |
errors = dependencies.errors ::: sources_errors ::: bibtex_errors, |
66694
41177b124067
tuned signature -- more readable output as Scala value;
wenzelm
parents:
66668
diff
changeset
|
344 |
imports = Some(imports_base)) |
65251 | 345 |
|
65519 | 346 |
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
|
347 |
} |
104502de757c
more informative known_files: known_theories within the local session directory come first;
wenzelm
parents:
65461
diff
changeset
|
348 |
catch { |
104502de757c
more informative known_files: known_theories within the local session directory come first;
wenzelm
parents:
65461
diff
changeset
|
349 |
case ERROR(msg) => |
104502de757c
more informative known_files: known_theories within the local session directory come first;
wenzelm
parents:
65461
diff
changeset
|
350 |
cat_error(msg, "The error(s) above occurred in session " + |
65519 | 351 |
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
|
352 |
} |
104502de757c
more informative known_files: known_theories within the local session directory come first;
wenzelm
parents:
65461
diff
changeset
|
353 |
}) |
65251 | 354 |
|
68204 | 355 |
Deps(sessions_structure, session_bases, Known.make(Path.current, session_bases.toList.map(_._2))) |
65372
b722ee40c26c
refer to global_theories from all sessions, before selection;
wenzelm
parents:
65371
diff
changeset
|
356 |
} |
65251 | 357 |
|
66963 | 358 |
|
359 |
/* base info */ |
|
360 |
||
66974
b14c24b31f45
avoid duplicate invocation of expensive Sessions.deps on full_sessions;
wenzelm
parents:
66970
diff
changeset
|
361 |
sealed case class Base_Info( |
67869 | 362 |
options: Options, |
363 |
dirs: List[Path], |
|
66974
b14c24b31f45
avoid duplicate invocation of expensive Sessions.deps on full_sessions;
wenzelm
parents:
66970
diff
changeset
|
364 |
session: String, |
67052 | 365 |
sessions_structure: Structure, |
66975 | 366 |
errors: List[String], |
66974
b14c24b31f45
avoid duplicate invocation of expensive Sessions.deps on full_sessions;
wenzelm
parents:
66970
diff
changeset
|
367 |
base: Base, |
b14c24b31f45
avoid duplicate invocation of expensive Sessions.deps on full_sessions;
wenzelm
parents:
66970
diff
changeset
|
368 |
infos: List[Info]) |
b14c24b31f45
avoid duplicate invocation of expensive Sessions.deps on full_sessions;
wenzelm
parents:
66970
diff
changeset
|
369 |
{ |
b14c24b31f45
avoid duplicate invocation of expensive Sessions.deps on full_sessions;
wenzelm
parents:
66970
diff
changeset
|
370 |
def check_base: Base = if (errors.isEmpty) base else error(cat_lines(errors)) |
b14c24b31f45
avoid duplicate invocation of expensive Sessions.deps on full_sessions;
wenzelm
parents:
66970
diff
changeset
|
371 |
} |
b14c24b31f45
avoid duplicate invocation of expensive Sessions.deps on full_sessions;
wenzelm
parents:
66970
diff
changeset
|
372 |
|
67846 | 373 |
def base_info(options: Options, |
374 |
session: String, |
|
67852
f701a1d5d852
allow cancellation of Sessions.deps/base_info via progress.stopped (progress.echo only happens for options like "verbose");
wenzelm
parents:
67846
diff
changeset
|
375 |
progress: Progress = No_Progress, |
65428 | 376 |
dirs: List[Path] = Nil, |
67922
9e668ae81f97
clarified signature: prefer selective include_sessions;
wenzelm
parents:
67880
diff
changeset
|
377 |
include_sessions: List[String] = Nil, |
66988 | 378 |
ancestor_session: Option[String] = None, |
66968
9991671c98aa
allow to augment session context via explicit session infos;
wenzelm
parents:
66967
diff
changeset
|
379 |
all_known: Boolean = false, |
66987
352b23c97ac8
support focus_session, for much faster startup of Isabelle/jEdit;
wenzelm
parents:
66984
diff
changeset
|
380 |
focus_session: Boolean = false, |
66968
9991671c98aa
allow to augment session context via explicit session infos;
wenzelm
parents:
66967
diff
changeset
|
381 |
required_session: Boolean = false): Base_Info = |
65251 | 382 |
{ |
67026 | 383 |
val full_sessions = load_structure(options, dirs = dirs) |
65428 | 384 |
val global_theories = full_sessions.global_theories |
65372
b722ee40c26c
refer to global_theories from all sessions, before selection;
wenzelm
parents:
65371
diff
changeset
|
385 |
|
66990 | 386 |
val selected_sessions = |
67025
961285f581e6
clarifified selection: always wrt. build_graph structure;
wenzelm
parents:
67024
diff
changeset
|
387 |
full_sessions.selection(Selection(sessions = session :: ancestor_session.toList)) |
66974
b14c24b31f45
avoid duplicate invocation of expensive Sessions.deps on full_sessions;
wenzelm
parents:
66970
diff
changeset
|
388 |
val info = selected_sessions(session) |
66988 | 389 |
val ancestor = ancestor_session orElse info.parent |
66963 | 390 |
|
66974
b14c24b31f45
avoid duplicate invocation of expensive Sessions.deps on full_sessions;
wenzelm
parents:
66970
diff
changeset
|
391 |
val (session1, infos1) = |
66988 | 392 |
if (required_session && ancestor.isDefined) { |
67852
f701a1d5d852
allow cancellation of Sessions.deps/base_info via progress.stopped (progress.echo only happens for options like "verbose");
wenzelm
parents:
67846
diff
changeset
|
393 |
val deps = Sessions.deps(selected_sessions, global_theories, progress = progress) |
66974
b14c24b31f45
avoid duplicate invocation of expensive Sessions.deps on full_sessions;
wenzelm
parents:
66970
diff
changeset
|
394 |
val base = deps(session) |
66968
9991671c98aa
allow to augment session context via explicit session infos;
wenzelm
parents:
66967
diff
changeset
|
395 |
|
66988 | 396 |
val ancestor_loaded = |
397 |
deps.get(ancestor.get) match { |
|
66990 | 398 |
case Some(ancestor_base) |
399 |
if !selected_sessions.imports_requirements(List(ancestor.get)).contains(session) => |
|
400 |
ancestor_base.loaded_theories.defined(_) |
|
401 |
case _ => |
|
66988 | 402 |
error("Bad ancestor " + quote(ancestor.get) + " for session " + quote(session)) |
403 |
} |
|
66974
b14c24b31f45
avoid duplicate invocation of expensive Sessions.deps on full_sessions;
wenzelm
parents:
66970
diff
changeset
|
404 |
|
b14c24b31f45
avoid duplicate invocation of expensive Sessions.deps on full_sessions;
wenzelm
parents:
66970
diff
changeset
|
405 |
val required_theories = |
66968
9991671c98aa
allow to augment session context via explicit session infos;
wenzelm
parents:
66967
diff
changeset
|
406 |
for { |
9991671c98aa
allow to augment session context via explicit session infos;
wenzelm
parents:
66967
diff
changeset
|
407 |
thy <- base.loaded_theories.keys |
66988 | 408 |
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
|
409 |
} |
66974
b14c24b31f45
avoid duplicate invocation of expensive Sessions.deps on full_sessions;
wenzelm
parents:
66970
diff
changeset
|
410 |
yield thy |
66968
9991671c98aa
allow to augment session context via explicit session infos;
wenzelm
parents:
66967
diff
changeset
|
411 |
|
66988 | 412 |
if (required_theories.isEmpty) (ancestor.get, Nil) |
66968
9991671c98aa
allow to augment session context via explicit session infos;
wenzelm
parents:
66967
diff
changeset
|
413 |
else { |
66988 | 414 |
val other_name = info.name + "_base(" + ancestor.get + ")" |
66974
b14c24b31f45
avoid duplicate invocation of expensive Sessions.deps on full_sessions;
wenzelm
parents:
66970
diff
changeset
|
415 |
(other_name, |
66968
9991671c98aa
allow to augment session context via explicit session infos;
wenzelm
parents:
66967
diff
changeset
|
416 |
List( |
9991671c98aa
allow to augment session context via explicit session infos;
wenzelm
parents:
66967
diff
changeset
|
417 |
make_info(info.options, |
9991671c98aa
allow to augment session context via explicit session infos;
wenzelm
parents:
66967
diff
changeset
|
418 |
dir_selected = false, |
9991671c98aa
allow to augment session context via explicit session infos;
wenzelm
parents:
66967
diff
changeset
|
419 |
dir = info.dir, |
9991671c98aa
allow to augment session context via explicit session infos;
wenzelm
parents:
66967
diff
changeset
|
420 |
chapter = info.chapter, |
9991671c98aa
allow to augment session context via explicit session infos;
wenzelm
parents:
66967
diff
changeset
|
421 |
Session_Entry( |
9991671c98aa
allow to augment session context via explicit session infos;
wenzelm
parents:
66967
diff
changeset
|
422 |
pos = info.pos, |
9991671c98aa
allow to augment session context via explicit session infos;
wenzelm
parents:
66967
diff
changeset
|
423 |
name = other_name, |
9991671c98aa
allow to augment session context via explicit session infos;
wenzelm
parents:
66967
diff
changeset
|
424 |
groups = info.groups, |
9991671c98aa
allow to augment session context via explicit session infos;
wenzelm
parents:
66967
diff
changeset
|
425 |
path = ".", |
66988 | 426 |
parent = ancestor, |
66974
b14c24b31f45
avoid duplicate invocation of expensive Sessions.deps on full_sessions;
wenzelm
parents:
66970
diff
changeset
|
427 |
description = "Required theory imports from other sessions", |
66968
9991671c98aa
allow to augment session context via explicit session infos;
wenzelm
parents:
66967
diff
changeset
|
428 |
options = Nil, |
66991 | 429 |
imports = info.deps, |
66974
b14c24b31f45
avoid duplicate invocation of expensive Sessions.deps on full_sessions;
wenzelm
parents:
66970
diff
changeset
|
430 |
theories = List((Nil, required_theories.map(thy => ((thy, Position.none), false)))), |
68292 | 431 |
document_files = Nil, |
432 |
export_files = Nil)))) |
|
66968
9991671c98aa
allow to augment session context via explicit session infos;
wenzelm
parents:
66967
diff
changeset
|
433 |
} |
9991671c98aa
allow to augment session context via explicit session infos;
wenzelm
parents:
66967
diff
changeset
|
434 |
} |
66974
b14c24b31f45
avoid duplicate invocation of expensive Sessions.deps on full_sessions;
wenzelm
parents:
66970
diff
changeset
|
435 |
else (session, Nil) |
66968
9991671c98aa
allow to augment session context via explicit session infos;
wenzelm
parents:
66967
diff
changeset
|
436 |
|
66974
b14c24b31f45
avoid duplicate invocation of expensive Sessions.deps on full_sessions;
wenzelm
parents:
66970
diff
changeset
|
437 |
val full_sessions1 = |
b14c24b31f45
avoid duplicate invocation of expensive Sessions.deps on full_sessions;
wenzelm
parents:
66970
diff
changeset
|
438 |
if (infos1.isEmpty) full_sessions |
67026 | 439 |
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
|
440 |
|
352b23c97ac8
support focus_session, for much faster startup of Isabelle/jEdit;
wenzelm
parents:
66984
diff
changeset
|
441 |
val selected_sessions1 = |
67922
9e668ae81f97
clarified signature: prefer selective include_sessions;
wenzelm
parents:
67880
diff
changeset
|
442 |
{ |
9e668ae81f97
clarified signature: prefer selective include_sessions;
wenzelm
parents:
67880
diff
changeset
|
443 |
val sel_sessions1 = session1 :: include_sessions |
9e668ae81f97
clarified signature: prefer selective include_sessions;
wenzelm
parents:
67880
diff
changeset
|
444 |
val select_sessions1 = |
9e668ae81f97
clarified signature: prefer selective include_sessions;
wenzelm
parents:
67880
diff
changeset
|
445 |
if (focus_session) full_sessions1.imports_descendants(sel_sessions1) else sel_sessions1 |
67025
961285f581e6
clarifified selection: always wrt. build_graph structure;
wenzelm
parents:
67024
diff
changeset
|
446 |
full_sessions1.selection(Selection(sessions = select_sessions1)) |
67922
9e668ae81f97
clarified signature: prefer selective include_sessions;
wenzelm
parents:
67880
diff
changeset
|
447 |
} |
66964 | 448 |
|
66974
b14c24b31f45
avoid duplicate invocation of expensive Sessions.deps on full_sessions;
wenzelm
parents:
66970
diff
changeset
|
449 |
val sessions1 = if (all_known) full_sessions1 else selected_sessions1 |
67852
f701a1d5d852
allow cancellation of Sessions.deps/base_info via progress.stopped (progress.echo only happens for options like "verbose");
wenzelm
parents:
67846
diff
changeset
|
450 |
val deps1 = Sessions.deps(sessions1, global_theories, progress = progress) |
67922
9e668ae81f97
clarified signature: prefer selective include_sessions;
wenzelm
parents:
67880
diff
changeset
|
451 |
val base1 = deps1(session1).copy(known = deps1.all_known) |
66964 | 452 |
|
68204 | 453 |
Base_Info(options, dirs, session1, deps1.sessions_structure, deps1.errors, base1, infos1) |
65251 | 454 |
} |
455 |
||
456 |
||
65415
8cd54b18b68b
clarified signature: tree structure is not essential;
wenzelm
parents:
65410
diff
changeset
|
457 |
/* cumulative session info */ |
62631 | 458 |
|
459 |
sealed case class Info( |
|
65519 | 460 |
name: String, |
62631 | 461 |
chapter: String, |
66829 | 462 |
dir_selected: Boolean, |
62631 | 463 |
pos: Position.T, |
464 |
groups: List[String], |
|
465 |
dir: Path, |
|
466 |
parent: Option[String], |
|
467 |
description: String, |
|
468 |
options: Options, |
|
65420
695d4e22345a
support for static session imports, without affect build hierarchy;
wenzelm
parents:
65419
diff
changeset
|
469 |
imports: List[String], |
65517 | 470 |
theories: List[(Options, List[(String, Position.T)])], |
65374 | 471 |
global_theories: List[String], |
62631 | 472 |
document_files: List[(Path, Path)], |
68292 | 473 |
export_files: List[(Path, List[String])], |
62631 | 474 |
meta_digest: SHA1.Digest) |
475 |
{ |
|
66828 | 476 |
def deps: List[String] = parent.toList ::: imports |
477 |
||
62631 | 478 |
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
|
479 |
|
86a099f896fc
formal check of @{cite} bibtex entries -- only in batch-mode session builds;
wenzelm
parents:
67290
diff
changeset
|
480 |
def bibtex_entries: List[Text.Info[String]] = |
86a099f896fc
formal check of @{cite} bibtex entries -- only in batch-mode session builds;
wenzelm
parents:
67290
diff
changeset
|
481 |
(for { |
86a099f896fc
formal check of @{cite} bibtex entries -- only in batch-mode session builds;
wenzelm
parents:
67290
diff
changeset
|
482 |
(document_dir, file) <- document_files.iterator |
86a099f896fc
formal check of @{cite} bibtex entries -- only in batch-mode session builds;
wenzelm
parents:
67290
diff
changeset
|
483 |
if Bibtex.is_bibtex(file.base_name) |
86a099f896fc
formal check of @{cite} bibtex entries -- only in batch-mode session builds;
wenzelm
parents:
67290
diff
changeset
|
484 |
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
|
485 |
} yield info).toList |
62631 | 486 |
} |
487 |
||
66967
e365c91c72a9
synthesize session with all required theories from other session imports;
wenzelm
parents:
66966
diff
changeset
|
488 |
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
|
489 |
entry: Session_Entry): Info = |
e365c91c72a9
synthesize session with all required theories from other session imports;
wenzelm
parents:
66966
diff
changeset
|
490 |
{ |
e365c91c72a9
synthesize session with all required theories from other session imports;
wenzelm
parents:
66966
diff
changeset
|
491 |
try { |
e365c91c72a9
synthesize session with all required theories from other session imports;
wenzelm
parents:
66966
diff
changeset
|
492 |
val name = entry.name |
e365c91c72a9
synthesize session with all required theories from other session imports;
wenzelm
parents:
66966
diff
changeset
|
493 |
|
67284 | 494 |
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
|
495 |
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
|
496 |
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
|
497 |
|
e365c91c72a9
synthesize session with all required theories from other session imports;
wenzelm
parents:
66966
diff
changeset
|
498 |
val session_options = options ++ entry.options |
e365c91c72a9
synthesize session with all required theories from other session imports;
wenzelm
parents:
66966
diff
changeset
|
499 |
|
e365c91c72a9
synthesize session with all required theories from other session imports;
wenzelm
parents:
66966
diff
changeset
|
500 |
val theories = |
67216 | 501 |
entry.theories.map({ case (opts, thys) => |
502 |
(session_options ++ opts, |
|
503 |
thys.map({ case ((thy, pos), _) => |
|
67284 | 504 |
if (exclude_theory(thy)) |
67216 | 505 |
error("Bad theory name " + quote(thy) + Position.here(pos)) |
506 |
else (thy, pos) })) }) |
|
66967
e365c91c72a9
synthesize session with all required theories from other session imports;
wenzelm
parents:
66966
diff
changeset
|
507 |
|
e365c91c72a9
synthesize session with all required theories from other session imports;
wenzelm
parents:
66966
diff
changeset
|
508 |
val global_theories = |
e365c91c72a9
synthesize session with all required theories from other session imports;
wenzelm
parents:
66966
diff
changeset
|
509 |
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
|
510 |
yield { |
e365c91c72a9
synthesize session with all required theories from other session imports;
wenzelm
parents:
66966
diff
changeset
|
511 |
val thy_name = Path.explode(thy).expand.base_name |
e365c91c72a9
synthesize session with all required theories from other session imports;
wenzelm
parents:
66966
diff
changeset
|
512 |
if (Long_Name.is_qualified(thy_name)) |
e365c91c72a9
synthesize session with all required theories from other session imports;
wenzelm
parents:
66966
diff
changeset
|
513 |
error("Bad qualified name for global theory " + |
e365c91c72a9
synthesize session with all required theories from other session imports;
wenzelm
parents:
66966
diff
changeset
|
514 |
quote(thy_name) + Position.here(pos)) |
e365c91c72a9
synthesize session with all required theories from other session imports;
wenzelm
parents:
66966
diff
changeset
|
515 |
else thy_name |
e365c91c72a9
synthesize session with all required theories from other session imports;
wenzelm
parents:
66966
diff
changeset
|
516 |
} |
e365c91c72a9
synthesize session with all required theories from other session imports;
wenzelm
parents:
66966
diff
changeset
|
517 |
|
e365c91c72a9
synthesize session with all required theories from other session imports;
wenzelm
parents:
66966
diff
changeset
|
518 |
val conditions = |
e365c91c72a9
synthesize session with all required theories from other session imports;
wenzelm
parents:
66966
diff
changeset
|
519 |
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
|
520 |
map(x => (x, Isabelle_System.getenv(x) != "")) |
e365c91c72a9
synthesize session with all required theories from other session imports;
wenzelm
parents:
66966
diff
changeset
|
521 |
|
e365c91c72a9
synthesize session with all required theories from other session imports;
wenzelm
parents:
66966
diff
changeset
|
522 |
val document_files = |
e365c91c72a9
synthesize session with all required theories from other session imports;
wenzelm
parents:
66966
diff
changeset
|
523 |
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
|
524 |
|
68292 | 525 |
val export_files = |
526 |
entry.export_files.map({ case (dir, pats) => (Path.explode(dir), pats) }) |
|
527 |
||
66967
e365c91c72a9
synthesize session with all required theories from other session imports;
wenzelm
parents:
66966
diff
changeset
|
528 |
val meta_digest = |
e365c91c72a9
synthesize session with all required theories from other session imports;
wenzelm
parents:
66966
diff
changeset
|
529 |
SHA1.digest((name, chapter, entry.parent, entry.options, entry.imports, |
68292 | 530 |
entry.theories_no_position, conditions, entry.document_files, entry.export_files).toString) |
66967
e365c91c72a9
synthesize session with all required theories from other session imports;
wenzelm
parents:
66966
diff
changeset
|
531 |
|
e365c91c72a9
synthesize session with all required theories from other session imports;
wenzelm
parents:
66966
diff
changeset
|
532 |
Info(name, chapter, dir_selected, entry.pos, entry.groups, |
e365c91c72a9
synthesize session with all required theories from other session imports;
wenzelm
parents:
66966
diff
changeset
|
533 |
dir + Path.explode(entry.path), entry.parent, entry.description, session_options, |
68292 | 534 |
entry.imports, theories, global_theories, document_files, export_files, meta_digest) |
66967
e365c91c72a9
synthesize session with all required theories from other session imports;
wenzelm
parents:
66966
diff
changeset
|
535 |
} |
e365c91c72a9
synthesize session with all required theories from other session imports;
wenzelm
parents:
66966
diff
changeset
|
536 |
catch { |
e365c91c72a9
synthesize session with all required theories from other session imports;
wenzelm
parents:
66966
diff
changeset
|
537 |
case ERROR(msg) => |
e365c91c72a9
synthesize session with all required theories from other session imports;
wenzelm
parents:
66966
diff
changeset
|
538 |
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
|
539 |
quote(entry.name) + Position.here(entry.pos)) |
e365c91c72a9
synthesize session with all required theories from other session imports;
wenzelm
parents:
66966
diff
changeset
|
540 |
} |
e365c91c72a9
synthesize session with all required theories from other session imports;
wenzelm
parents:
66966
diff
changeset
|
541 |
} |
e365c91c72a9
synthesize session with all required theories from other session imports;
wenzelm
parents:
66966
diff
changeset
|
542 |
|
65419 | 543 |
object Selection |
544 |
{ |
|
65422 | 545 |
val empty: Selection = Selection() |
65525 | 546 |
val all: Selection = Selection(all_sessions = true) |
65419 | 547 |
} |
548 |
||
549 |
sealed case class Selection( |
|
550 |
requirements: Boolean = false, |
|
551 |
all_sessions: Boolean = false, |
|
66737
2edc0c42c883
option -B for "isabelle build" and "isabelle imports";
wenzelm
parents:
66736
diff
changeset
|
552 |
base_sessions: List[String] = Nil, |
65419 | 553 |
exclude_session_groups: List[String] = Nil, |
554 |
exclude_sessions: List[String] = Nil, |
|
555 |
session_groups: List[String] = Nil, |
|
556 |
sessions: List[String] = Nil) |
|
557 |
{ |
|
66736 | 558 |
def ++ (other: Selection): Selection = |
65422 | 559 |
Selection( |
560 |
requirements = requirements || other.requirements, |
|
561 |
all_sessions = all_sessions || other.all_sessions, |
|
66737
2edc0c42c883
option -B for "isabelle build" and "isabelle imports";
wenzelm
parents:
66736
diff
changeset
|
562 |
base_sessions = Library.merge(base_sessions, other.base_sessions), |
66736 | 563 |
exclude_session_groups = Library.merge(exclude_session_groups, other.exclude_session_groups), |
564 |
exclude_sessions = Library.merge(exclude_sessions, other.exclude_sessions), |
|
565 |
session_groups = Library.merge(session_groups, other.session_groups), |
|
566 |
sessions = Library.merge(sessions, other.sessions)) |
|
67029 | 567 |
|
568 |
def selected(graph: Graph[String, Info]): List[String] = |
|
569 |
{ |
|
570 |
val select_group = session_groups.toSet |
|
571 |
val select_session = sessions.toSet ++ graph.all_succs(base_sessions) |
|
572 |
||
573 |
val selected0 = |
|
574 |
if (all_sessions) graph.keys |
|
575 |
else { |
|
576 |
(for { |
|
577 |
(name, (info, _)) <- graph.iterator |
|
578 |
if info.dir_selected || select_session(name) || |
|
579 |
graph.get_node(name).groups.exists(select_group) |
|
580 |
} yield name).toList |
|
581 |
} |
|
582 |
||
583 |
if (requirements) (graph.all_preds(selected0).toSet -- selected0).toList |
|
584 |
else selected0 |
|
585 |
} |
|
586 |
||
587 |
def excluded(graph: Graph[String, Info]): List[String] = |
|
588 |
{ |
|
589 |
val exclude_group = exclude_session_groups.toSet |
|
590 |
val exclude_group_sessions = |
|
591 |
(for { |
|
592 |
(name, (info, _)) <- graph.iterator |
|
593 |
if graph.get_node(name).groups.exists(exclude_group) |
|
594 |
} yield name).toList |
|
595 |
graph.all_succs(exclude_group_sessions ::: exclude_sessions) |
|
596 |
} |
|
65419 | 597 |
} |
598 |
||
67052 | 599 |
def make(infos: List[Info]): Structure = |
62631 | 600 |
{ |
65420
695d4e22345a
support for static session imports, without affect build hierarchy;
wenzelm
parents:
65419
diff
changeset
|
601 |
def add_edges(graph: Graph[String, Info], kind: String, edges: Info => Traversable[String]) |
695d4e22345a
support for static session imports, without affect build hierarchy;
wenzelm
parents:
65419
diff
changeset
|
602 |
: Graph[String, Info] = |
695d4e22345a
support for static session imports, without affect build hierarchy;
wenzelm
parents:
65419
diff
changeset
|
603 |
{ |
695d4e22345a
support for static session imports, without affect build hierarchy;
wenzelm
parents:
65419
diff
changeset
|
604 |
def add_edge(pos: Position.T, name: String, g: Graph[String, Info], parent: String) = |
695d4e22345a
support for static session imports, without affect build hierarchy;
wenzelm
parents:
65419
diff
changeset
|
605 |
{ |
695d4e22345a
support for static session imports, without affect build hierarchy;
wenzelm
parents:
65419
diff
changeset
|
606 |
if (!g.defined(parent)) |
695d4e22345a
support for static session imports, without affect build hierarchy;
wenzelm
parents:
65419
diff
changeset
|
607 |
error("Bad " + kind + " session " + quote(parent) + " for " + |
695d4e22345a
support for static session imports, without affect build hierarchy;
wenzelm
parents:
65419
diff
changeset
|
608 |
quote(name) + Position.here(pos)) |
695d4e22345a
support for static session imports, without affect build hierarchy;
wenzelm
parents:
65419
diff
changeset
|
609 |
|
695d4e22345a
support for static session imports, without affect build hierarchy;
wenzelm
parents:
65419
diff
changeset
|
610 |
try { g.add_edge_acyclic(parent, name) } |
695d4e22345a
support for static session imports, without affect build hierarchy;
wenzelm
parents:
65419
diff
changeset
|
611 |
catch { |
695d4e22345a
support for static session imports, without affect build hierarchy;
wenzelm
parents:
65419
diff
changeset
|
612 |
case exn: Graph.Cycles[_] => |
695d4e22345a
support for static session imports, without affect build hierarchy;
wenzelm
parents:
65419
diff
changeset
|
613 |
error(cat_lines(exn.cycles.map(cycle => |
695d4e22345a
support for static session imports, without affect build hierarchy;
wenzelm
parents:
65419
diff
changeset
|
614 |
"Cyclic session dependency of " + |
695d4e22345a
support for static session imports, without affect build hierarchy;
wenzelm
parents:
65419
diff
changeset
|
615 |
cycle.map(c => quote(c.toString)).mkString(" via "))) + Position.here(pos)) |
695d4e22345a
support for static session imports, without affect build hierarchy;
wenzelm
parents:
65419
diff
changeset
|
616 |
} |
695d4e22345a
support for static session imports, without affect build hierarchy;
wenzelm
parents:
65419
diff
changeset
|
617 |
} |
695d4e22345a
support for static session imports, without affect build hierarchy;
wenzelm
parents:
65419
diff
changeset
|
618 |
(graph /: graph.iterator) { |
695d4e22345a
support for static session imports, without affect build hierarchy;
wenzelm
parents:
65419
diff
changeset
|
619 |
case (g, (name, (info, _))) => (g /: edges(info))(add_edge(info.pos, name, _, _)) |
695d4e22345a
support for static session imports, without affect build hierarchy;
wenzelm
parents:
65419
diff
changeset
|
620 |
} |
695d4e22345a
support for static session imports, without affect build hierarchy;
wenzelm
parents:
65419
diff
changeset
|
621 |
} |
695d4e22345a
support for static session imports, without affect build hierarchy;
wenzelm
parents:
65419
diff
changeset
|
622 |
|
695d4e22345a
support for static session imports, without affect build hierarchy;
wenzelm
parents:
65419
diff
changeset
|
623 |
val graph0 = |
65415
8cd54b18b68b
clarified signature: tree structure is not essential;
wenzelm
parents:
65410
diff
changeset
|
624 |
(Graph.string[Info] /: infos) { |
66960 | 625 |
case (graph, info) => |
626 |
if (graph.defined(info.name)) |
|
627 |
error("Duplicate session " + quote(info.name) + Position.here(info.pos) + |
|
628 |
Position.here(graph.get_node(info.name).pos)) |
|
629 |
else graph.new_node(info.name, info) |
|
65415
8cd54b18b68b
clarified signature: tree structure is not essential;
wenzelm
parents:
65410
diff
changeset
|
630 |
} |
65420
695d4e22345a
support for static session imports, without affect build hierarchy;
wenzelm
parents:
65419
diff
changeset
|
631 |
val graph1 = add_edges(graph0, "parent", _.parent) |
695d4e22345a
support for static session imports, without affect build hierarchy;
wenzelm
parents:
65419
diff
changeset
|
632 |
val graph2 = add_edges(graph1, "imports", _.imports) |
62631 | 633 |
|
67052 | 634 |
new Structure(graph1, graph2) |
62631 | 635 |
} |
636 |
||
67052 | 637 |
final class Structure private[Sessions]( |
65420
695d4e22345a
support for static session imports, without affect build hierarchy;
wenzelm
parents:
65419
diff
changeset
|
638 |
val build_graph: Graph[String, Info], |
695d4e22345a
support for static session imports, without affect build hierarchy;
wenzelm
parents:
65419
diff
changeset
|
639 |
val imports_graph: Graph[String, Info]) |
62631 | 640 |
{ |
66823 | 641 |
def build_graph_display: Graph_Display.Graph = Graph_Display.make_graph(build_graph) |
642 |
def imports_graph_display: Graph_Display.Graph = Graph_Display.make_graph(imports_graph) |
|
643 |
||
67025
961285f581e6
clarifified selection: always wrt. build_graph structure;
wenzelm
parents:
67024
diff
changeset
|
644 |
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
|
645 |
def apply(name: String): Info = imports_graph.get_node(name) |
67025
961285f581e6
clarifified selection: always wrt. build_graph structure;
wenzelm
parents:
67024
diff
changeset
|
646 |
def get(name: String): Option[Info] = if (defined(name)) Some(apply(name)) else None |
62631 | 647 |
|
65457 | 648 |
def global_theories: Map[String, String] = |
65490 | 649 |
(Thy_Header.bootstrap_global_theories.toMap /: |
65424 | 650 |
(for { |
65519 | 651 |
(_, (info, _)) <- imports_graph.iterator |
652 |
thy <- info.global_theories.iterator } |
|
653 |
yield (thy, info)))({ |
|
654 |
case (global, (thy, info)) => |
|
66780
bf54ca580bf2
theory qualifier is always session name (see also 31e8a86971a8);
wenzelm
parents:
66770
diff
changeset
|
655 |
val qualifier = info.name |
65457 | 656 |
global.get(thy) match { |
657 |
case Some(qualifier1) if qualifier != qualifier1 => |
|
658 |
error("Duplicate global theory " + quote(thy) + Position.here(info.pos)) |
|
659 |
case _ => global + (thy -> qualifier) |
|
660 |
} |
|
661 |
}) |
|
65372
b722ee40c26c
refer to global_theories from all sessions, before selection;
wenzelm
parents:
65371
diff
changeset
|
662 |
|
67052 | 663 |
def selection(sel: Selection): Structure = |
62631 | 664 |
{ |
67025
961285f581e6
clarifified selection: always wrt. build_graph structure;
wenzelm
parents:
67024
diff
changeset
|
665 |
val bad_sessions = |
961285f581e6
clarifified selection: always wrt. build_graph structure;
wenzelm
parents:
67024
diff
changeset
|
666 |
SortedSet((sel.base_sessions ::: sel.exclude_sessions ::: sel.sessions). |
961285f581e6
clarifified selection: always wrt. build_graph structure;
wenzelm
parents:
67024
diff
changeset
|
667 |
filterNot(defined(_)): _*).toList |
961285f581e6
clarifified selection: always wrt. build_graph structure;
wenzelm
parents:
67024
diff
changeset
|
668 |
if (bad_sessions.nonEmpty) |
961285f581e6
clarifified selection: always wrt. build_graph structure;
wenzelm
parents:
67024
diff
changeset
|
669 |
error("Undefined session(s): " + commas_quote(bad_sessions)) |
961285f581e6
clarifified selection: always wrt. build_graph structure;
wenzelm
parents:
67024
diff
changeset
|
670 |
|
67029 | 671 |
val excluded = sel.excluded(build_graph).toSet |
67027 | 672 |
|
67025
961285f581e6
clarifified selection: always wrt. build_graph structure;
wenzelm
parents:
67024
diff
changeset
|
673 |
def restrict(graph: Graph[String, Info]): Graph[String, Info] = |
961285f581e6
clarifified selection: always wrt. build_graph structure;
wenzelm
parents:
67024
diff
changeset
|
674 |
{ |
67029 | 675 |
val sessions = graph.all_preds(sel.selected(graph)).filterNot(excluded) |
676 |
graph.restrict(graph.all_preds(sessions).toSet) |
|
67025
961285f581e6
clarifified selection: always wrt. build_graph structure;
wenzelm
parents:
67024
diff
changeset
|
677 |
} |
961285f581e6
clarifified selection: always wrt. build_graph structure;
wenzelm
parents:
67024
diff
changeset
|
678 |
|
67052 | 679 |
new Structure(restrict(build_graph), restrict(imports_graph)) |
62631 | 680 |
} |
681 |
||
68304 | 682 |
def selection_deps(sel: Selection, |
683 |
progress: Progress = No_Progress, |
|
684 |
inlined_files: Boolean = false, |
|
685 |
verbose: Boolean = false): Deps = |
|
686 |
{ |
|
687 |
Sessions.deps(selection(sel), global_theories, |
|
688 |
progress = progress, inlined_files = inlined_files, verbose = verbose) |
|
689 |
} |
|
690 |
||
67029 | 691 |
def build_selection(sel: Selection): List[String] = sel.selected(build_graph) |
692 |
def build_descendants(ss: List[String]): List[String] = build_graph.all_succs(ss) |
|
693 |
def build_requirements(ss: List[String]): List[String] = build_graph.all_preds(ss).reverse |
|
694 |
def build_topological_order: List[String] = build_graph.topological_order |
|
62631 | 695 |
|
67029 | 696 |
def imports_selection(sel: Selection): List[String] = sel.selected(imports_graph) |
697 |
def imports_descendants(ss: List[String]): List[String] = imports_graph.all_succs(ss) |
|
698 |
def imports_requirements(ss: List[String]): List[String] = imports_graph.all_preds(ss).reverse |
|
699 |
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
|
700 |
|
695d4e22345a
support for static session imports, without affect build hierarchy;
wenzelm
parents:
65419
diff
changeset
|
701 |
override def toString: String = |
67052 | 702 |
imports_graph.keys_iterator.mkString("Sessions.Structure(", ", ", ")") |
62631 | 703 |
} |
704 |
||
705 |
||
706 |
/* parser */ |
|
707 |
||
62864 | 708 |
val ROOT = Path.explode("ROOT") |
709 |
val ROOTS = Path.explode("ROOTS") |
|
710 |
||
62631 | 711 |
private val CHAPTER = "chapter" |
712 |
private val SESSION = "session" |
|
713 |
private val IN = "in" |
|
714 |
private val DESCRIPTION = "description" |
|
715 |
private val OPTIONS = "options" |
|
65420
695d4e22345a
support for static session imports, without affect build hierarchy;
wenzelm
parents:
65419
diff
changeset
|
716 |
private val SESSIONS = "sessions" |
62631 | 717 |
private val THEORIES = "theories" |
65374 | 718 |
private val GLOBAL = "global" |
62631 | 719 |
private val DOCUMENT_FILES = "document_files" |
68292 | 720 |
private val EXPORT_FILES = "export_files" |
62631 | 721 |
|
67004
af72fa58f71b
clarified lazy Completion within Outer_Syntax: measurable speedup of Sessions.deps;
wenzelm
parents:
66991
diff
changeset
|
722 |
val root_syntax = |
af72fa58f71b
clarified lazy Completion within Outer_Syntax: measurable speedup of Sessions.deps;
wenzelm
parents:
66991
diff
changeset
|
723 |
Outer_Syntax.empty + "(" + ")" + "+" + "," + "=" + "[" + "]" + GLOBAL + IN + |
63443 | 724 |
(CHAPTER, Keyword.THY_DECL) + |
725 |
(SESSION, Keyword.THY_DECL) + |
|
726 |
(DESCRIPTION, Keyword.QUASI_COMMAND) + |
|
727 |
(OPTIONS, Keyword.QUASI_COMMAND) + |
|
65420
695d4e22345a
support for static session imports, without affect build hierarchy;
wenzelm
parents:
65419
diff
changeset
|
728 |
(SESSIONS, Keyword.QUASI_COMMAND) + |
63443 | 729 |
(THEORIES, Keyword.QUASI_COMMAND) + |
68292 | 730 |
(DOCUMENT_FILES, Keyword.QUASI_COMMAND) + |
731 |
(EXPORT_FILES, Keyword.QUASI_COMMAND) |
|
62631 | 732 |
|
66818
5bc903a60932
clarified signature: public access to ROOT file syntax;
wenzelm
parents:
66780
diff
changeset
|
733 |
abstract class Entry |
5bc903a60932
clarified signature: public access to ROOT file syntax;
wenzelm
parents:
66780
diff
changeset
|
734 |
sealed case class Chapter(name: String) extends Entry |
5bc903a60932
clarified signature: public access to ROOT file syntax;
wenzelm
parents:
66780
diff
changeset
|
735 |
sealed case class Session_Entry( |
5bc903a60932
clarified signature: public access to ROOT file syntax;
wenzelm
parents:
66780
diff
changeset
|
736 |
pos: Position.T, |
5bc903a60932
clarified signature: public access to ROOT file syntax;
wenzelm
parents:
66780
diff
changeset
|
737 |
name: String, |
5bc903a60932
clarified signature: public access to ROOT file syntax;
wenzelm
parents:
66780
diff
changeset
|
738 |
groups: List[String], |
5bc903a60932
clarified signature: public access to ROOT file syntax;
wenzelm
parents:
66780
diff
changeset
|
739 |
path: String, |
5bc903a60932
clarified signature: public access to ROOT file syntax;
wenzelm
parents:
66780
diff
changeset
|
740 |
parent: Option[String], |
5bc903a60932
clarified signature: public access to ROOT file syntax;
wenzelm
parents:
66780
diff
changeset
|
741 |
description: String, |
5bc903a60932
clarified signature: public access to ROOT file syntax;
wenzelm
parents:
66780
diff
changeset
|
742 |
options: List[Options.Spec], |
5bc903a60932
clarified signature: public access to ROOT file syntax;
wenzelm
parents:
66780
diff
changeset
|
743 |
imports: List[String], |
5bc903a60932
clarified signature: public access to ROOT file syntax;
wenzelm
parents:
66780
diff
changeset
|
744 |
theories: List[(List[Options.Spec], List[((String, Position.T), Boolean)])], |
68292 | 745 |
document_files: List[(String, String)], |
746 |
export_files: List[(String, List[String])]) extends Entry |
|
66818
5bc903a60932
clarified signature: public access to ROOT file syntax;
wenzelm
parents:
66780
diff
changeset
|
747 |
{ |
5bc903a60932
clarified signature: public access to ROOT file syntax;
wenzelm
parents:
66780
diff
changeset
|
748 |
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
|
749 |
theories.map({ case (a, b) => (a, b.map({ case ((c, _), d) => (c, d) })) }) |
5bc903a60932
clarified signature: public access to ROOT file syntax;
wenzelm
parents:
66780
diff
changeset
|
750 |
} |
5bc903a60932
clarified signature: public access to ROOT file syntax;
wenzelm
parents:
66780
diff
changeset
|
751 |
|
62968 | 752 |
private object Parser extends Parse.Parser with Options.Parser |
62631 | 753 |
{ |
754 |
private val chapter: Parser[Chapter] = |
|
755 |
{ |
|
756 |
val chapter_name = atom("chapter name", _.is_name) |
|
757 |
||
758 |
command(CHAPTER) ~! chapter_name ^^ { case _ ~ a => Chapter(a) } |
|
759 |
} |
|
760 |
||
761 |
private val session_entry: Parser[Session_Entry] = |
|
762 |
{ |
|
763 |
val option = |
|
67210 | 764 |
option_name ~ opt($$$("=") ~! option_value ^^ { case _ ~ x => x }) ^^ |
765 |
{ case x ~ y => (x, y) } |
|
62631 | 766 |
val options = $$$("[") ~> rep1sep(option, $$$(",")) <~ $$$("]") |
767 |
||
65374 | 768 |
val global = |
769 |
($$$("(") ~! $$$(GLOBAL) ~ $$$(")")) ^^ { case _ => true } | success(false) |
|
770 |
||
771 |
val theory_entry = |
|
65517 | 772 |
position(theory_name) ~ global ^^ { case x ~ y => (x, y) } |
65374 | 773 |
|
62631 | 774 |
val theories = |
65374 | 775 |
$$$(THEORIES) ~! |
66970
13857f49d215
clarified ROOT syntax: 'sessions' and 'theories' are optional, but need to be non-empty;
wenzelm
parents:
66969
diff
changeset
|
776 |
((options | success(Nil)) ~ rep1(theory_entry)) ^^ |
65374 | 777 |
{ case _ ~ (x ~ y) => (x, y) } |
62631 | 778 |
|
68292 | 779 |
val in_path = $$$("(") ~! ($$$(IN) ~ path ~ $$$(")")) ^^ { case _ ~ (_ ~ x ~ _) => x } |
780 |
||
62631 | 781 |
val document_files = |
782 |
$$$(DOCUMENT_FILES) ~! |
|
68292 | 783 |
((in_path | success("document")) ~ rep1(path)) ^^ { case _ ~ (x ~ y) => y.map((x, _)) } |
784 |
||
785 |
val export_files = |
|
786 |
$$$(EXPORT_FILES) ~! ((in_path | success("export")) ~ rep1(name)) ^^ |
|
787 |
{ case _ ~ (x ~ y) => (x, y) } |
|
62631 | 788 |
|
789 |
command(SESSION) ~! |
|
790 |
(position(session_name) ~ |
|
791 |
(($$$("(") ~! (rep1(name) <~ $$$(")")) ^^ { case _ ~ x => x }) | success(Nil)) ~ |
|
792 |
(($$$(IN) ~! path ^^ { case _ ~ x => x }) | success(".")) ~ |
|
793 |
($$$("=") ~! |
|
794 |
(opt(session_name ~! $$$("+") ^^ { case x ~ _ => x }) ~ |
|
795 |
(($$$(DESCRIPTION) ~! text ^^ { case _ ~ x => x }) | success("")) ~ |
|
796 |
(($$$(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
|
797 |
(($$$(SESSIONS) ~! rep1(session_name) ^^ { case _ ~ x => x }) | success(Nil)) ~ |
13857f49d215
clarified ROOT syntax: 'sessions' and 'theories' are optional, but need to be non-empty;
wenzelm
parents:
66969
diff
changeset
|
798 |
rep(theories) ~ |
68292 | 799 |
(rep(document_files) ^^ (x => x.flatten)) ~ |
800 |
(rep(export_files))))) ^^ |
|
801 |
{ case _ ~ ((a, pos) ~ b ~ c ~ (_ ~ (d ~ e ~ f ~ g ~ h ~ i ~ j))) => |
|
802 |
Session_Entry(pos, a, b, c, d, e, f, g, h, i, j) } |
|
62631 | 803 |
} |
804 |
||
66819 | 805 |
def parse_root(path: Path): List[Entry] = |
62631 | 806 |
{ |
66764
006deaf5c3dc
process ROOT files only once, which allows duplicate (or overlapping) session root directories;
wenzelm
parents:
66759
diff
changeset
|
807 |
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
|
808 |
val start = Token.Pos.file(path.implode) |
62631 | 809 |
|
66764
006deaf5c3dc
process ROOT files only once, which allows duplicate (or overlapping) session root directories;
wenzelm
parents:
66759
diff
changeset
|
810 |
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
|
811 |
case Success(result, _) => result |
66764
006deaf5c3dc
process ROOT files only once, which allows duplicate (or overlapping) session root directories;
wenzelm
parents:
66759
diff
changeset
|
812 |
case bad => error(bad.toString) |
62631 | 813 |
} |
814 |
} |
|
815 |
} |
|
816 |
||
66819 | 817 |
def parse_root(path: Path): List[Entry] = Parser.parse_root(path) |
818 |
||
819 |
def parse_root_entries(path: Path): List[Session_Entry] = |
|
820 |
for (entry <- Parser.parse_root(path) if entry.isInstanceOf[Session_Entry]) |
|
821 |
yield entry.asInstanceOf[Session_Entry] |
|
66818
5bc903a60932
clarified signature: public access to ROOT file syntax;
wenzelm
parents:
66780
diff
changeset
|
822 |
|
66960 | 823 |
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
|
824 |
{ |
5bc903a60932
clarified signature: public access to ROOT file syntax;
wenzelm
parents:
66780
diff
changeset
|
825 |
var entry_chapter = "Unsorted" |
66960 | 826 |
val infos = new mutable.ListBuffer[Info] |
66819 | 827 |
parse_root(path).foreach { |
66818
5bc903a60932
clarified signature: public access to ROOT file syntax;
wenzelm
parents:
66780
diff
changeset
|
828 |
case Chapter(name) => entry_chapter = name |
66967
e365c91c72a9
synthesize session with all required theories from other session imports;
wenzelm
parents:
66966
diff
changeset
|
829 |
case entry: Session_Entry => |
e365c91c72a9
synthesize session with all required theories from other session imports;
wenzelm
parents:
66966
diff
changeset
|
830 |
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
|
831 |
} |
5bc903a60932
clarified signature: public access to ROOT file syntax;
wenzelm
parents:
66780
diff
changeset
|
832 |
infos.toList |
5bc903a60932
clarified signature: public access to ROOT file syntax;
wenzelm
parents:
66780
diff
changeset
|
833 |
} |
5bc903a60932
clarified signature: public access to ROOT file syntax;
wenzelm
parents:
66780
diff
changeset
|
834 |
|
5bc903a60932
clarified signature: public access to ROOT file syntax;
wenzelm
parents:
66780
diff
changeset
|
835 |
def parse_roots(roots: Path): List[String] = |
5bc903a60932
clarified signature: public access to ROOT file syntax;
wenzelm
parents:
66780
diff
changeset
|
836 |
{ |
5bc903a60932
clarified signature: public access to ROOT file syntax;
wenzelm
parents:
66780
diff
changeset
|
837 |
for { |
5bc903a60932
clarified signature: public access to ROOT file syntax;
wenzelm
parents:
66780
diff
changeset
|
838 |
line <- split_lines(File.read(roots)) |
5bc903a60932
clarified signature: public access to ROOT file syntax;
wenzelm
parents:
66780
diff
changeset
|
839 |
if !(line == "" || line.startsWith("#")) |
5bc903a60932
clarified signature: public access to ROOT file syntax;
wenzelm
parents:
66780
diff
changeset
|
840 |
} yield line |
5bc903a60932
clarified signature: public access to ROOT file syntax;
wenzelm
parents:
66780
diff
changeset
|
841 |
} |
5bc903a60932
clarified signature: public access to ROOT file syntax;
wenzelm
parents:
66780
diff
changeset
|
842 |
|
62631 | 843 |
|
62635 | 844 |
/* load sessions from certain directories */ |
62631 | 845 |
|
846 |
private def is_session_dir(dir: Path): Boolean = |
|
847 |
(dir + ROOT).is_file || (dir + ROOTS).is_file |
|
848 |
||
849 |
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
|
850 |
if (is_session_dir(dir)) File.pwd() + dir.expand |
62631 | 851 |
else error("Bad session root directory: " + dir.toString) |
852 |
||
65561 | 853 |
def directories(dirs: List[Path], select_dirs: List[Path]): List[(Boolean, Path)] = |
854 |
{ |
|
855 |
val default_dirs = Isabelle_System.components().filter(is_session_dir(_)) |
|
856 |
(default_dirs ::: dirs).map((false, _)) ::: select_dirs.map((true, _)) |
|
857 |
} |
|
858 |
||
67026 | 859 |
def load_structure(options: Options, |
66968
9991671c98aa
allow to augment session context via explicit session infos;
wenzelm
parents:
66967
diff
changeset
|
860 |
dirs: List[Path] = Nil, |
9991671c98aa
allow to augment session context via explicit session infos;
wenzelm
parents:
66967
diff
changeset
|
861 |
select_dirs: List[Path] = Nil, |
67052 | 862 |
infos: List[Info] = Nil): Structure = |
62631 | 863 |
{ |
66764
006deaf5c3dc
process ROOT files only once, which allows duplicate (or overlapping) session root directories;
wenzelm
parents:
66759
diff
changeset
|
864 |
def load_dir(select: Boolean, dir: Path): List[(Boolean, Path)] = |
62635 | 865 |
load_root(select, dir) ::: load_roots(select, dir) |
62631 | 866 |
|
66764
006deaf5c3dc
process ROOT files only once, which allows duplicate (or overlapping) session root directories;
wenzelm
parents:
66759
diff
changeset
|
867 |
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
|
868 |
{ |
006deaf5c3dc
process ROOT files only once, which allows duplicate (or overlapping) session root directories;
wenzelm
parents:
66759
diff
changeset
|
869 |
val root = dir + ROOT |
006deaf5c3dc
process ROOT files only once, which allows duplicate (or overlapping) session root directories;
wenzelm
parents:
66759
diff
changeset
|
870 |
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
|
871 |
} |
62631 | 872 |
|
66764
006deaf5c3dc
process ROOT files only once, which allows duplicate (or overlapping) session root directories;
wenzelm
parents:
66759
diff
changeset
|
873 |
def load_roots(select: Boolean, dir: Path): List[(Boolean, Path)] = |
62631 | 874 |
{ |
875 |
val roots = dir + ROOTS |
|
876 |
if (roots.is_file) { |
|
877 |
for { |
|
66818
5bc903a60932
clarified signature: public access to ROOT file syntax;
wenzelm
parents:
66780
diff
changeset
|
878 |
entry <- parse_roots(roots) |
62631 | 879 |
dir1 = |
66818
5bc903a60932
clarified signature: public access to ROOT file syntax;
wenzelm
parents:
66780
diff
changeset
|
880 |
try { check_session_dir(dir + Path.explode(entry)) } |
62631 | 881 |
catch { |
882 |
case ERROR(msg) => |
|
883 |
error(msg + "\nThe error(s) above occurred in session catalog " + roots.toString) |
|
884 |
} |
|
66764
006deaf5c3dc
process ROOT files only once, which allows duplicate (or overlapping) session root directories;
wenzelm
parents:
66759
diff
changeset
|
885 |
res <- load_dir(select, dir1) |
006deaf5c3dc
process ROOT files only once, which allows duplicate (or overlapping) session root directories;
wenzelm
parents:
66759
diff
changeset
|
886 |
} yield res |
62631 | 887 |
} |
888 |
else Nil |
|
889 |
} |
|
890 |
||
66764
006deaf5c3dc
process ROOT files only once, which allows duplicate (or overlapping) session root directories;
wenzelm
parents:
66759
diff
changeset
|
891 |
val roots = |
62631 | 892 |
for { |
65561 | 893 |
(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
|
894 |
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
|
895 |
} yield res |
006deaf5c3dc
process ROOT files only once, which allows duplicate (or overlapping) session root directories;
wenzelm
parents:
66759
diff
changeset
|
896 |
|
006deaf5c3dc
process ROOT files only once, which allows duplicate (or overlapping) session root directories;
wenzelm
parents:
66759
diff
changeset
|
897 |
val unique_roots = |
006deaf5c3dc
process ROOT files only once, which allows duplicate (or overlapping) session root directories;
wenzelm
parents:
66759
diff
changeset
|
898 |
((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
|
899 |
val file = path.canonical_file |
006deaf5c3dc
process ROOT files only once, which allows duplicate (or overlapping) session root directories;
wenzelm
parents:
66759
diff
changeset
|
900 |
m.get(file) match { |
006deaf5c3dc
process ROOT files only once, which allows duplicate (or overlapping) session root directories;
wenzelm
parents:
66759
diff
changeset
|
901 |
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
|
902 |
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
|
903 |
} |
006deaf5c3dc
process ROOT files only once, which allows duplicate (or overlapping) session root directories;
wenzelm
parents:
66759
diff
changeset
|
904 |
}).toList.map(_._2) |
006deaf5c3dc
process ROOT files only once, which allows duplicate (or overlapping) session root directories;
wenzelm
parents:
66759
diff
changeset
|
905 |
|
66968
9991671c98aa
allow to augment session context via explicit session infos;
wenzelm
parents:
66967
diff
changeset
|
906 |
make(unique_roots.flatMap(p => read_root(options, p._1, p._2)) ::: infos) |
62631 | 907 |
} |
62632 | 908 |
|
909 |
||
62637
0189fe0f6452
support for Poly/ML heap hierarchy, which saves a lot of disk space;
wenzelm
parents:
62636
diff
changeset
|
910 |
|
62704
478b49f0d726
proper SHA1 digest as annex to heap file: Poly/ML reads precise segment length;
wenzelm
parents:
62637
diff
changeset
|
911 |
/** 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
|
912 |
|
478b49f0d726
proper SHA1 digest as annex to heap file: Poly/ML reads precise segment length;
wenzelm
parents:
62637
diff
changeset
|
913 |
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
|
914 |
|
478b49f0d726
proper SHA1 digest as annex to heap file: Poly/ML reads precise segment length;
wenzelm
parents:
62637
diff
changeset
|
915 |
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
|
916 |
{ |
478b49f0d726
proper SHA1 digest as annex to heap file: Poly/ML reads precise segment length;
wenzelm
parents:
62637
diff
changeset
|
917 |
if (heap.is_file) { |
478b49f0d726
proper SHA1 digest as annex to heap file: Poly/ML reads precise segment length;
wenzelm
parents:
62637
diff
changeset
|
918 |
val file = FileChannel.open(heap.file.toPath, StandardOpenOption.READ) |
478b49f0d726
proper SHA1 digest as annex to heap file: Poly/ML reads precise segment length;
wenzelm
parents:
62637
diff
changeset
|
919 |
try { |
478b49f0d726
proper SHA1 digest as annex to heap file: Poly/ML reads precise segment length;
wenzelm
parents:
62637
diff
changeset
|
920 |
val len = file.size |
478b49f0d726
proper SHA1 digest as annex to heap file: Poly/ML reads precise segment length;
wenzelm
parents:
62637
diff
changeset
|
921 |
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
|
922 |
if (len >= n) { |
478b49f0d726
proper SHA1 digest as annex to heap file: Poly/ML reads precise segment length;
wenzelm
parents:
62637
diff
changeset
|
923 |
file.position(len - n) |
478b49f0d726
proper SHA1 digest as annex to heap file: Poly/ML reads precise segment length;
wenzelm
parents:
62637
diff
changeset
|
924 |
|
478b49f0d726
proper SHA1 digest as annex to heap file: Poly/ML reads precise segment length;
wenzelm
parents:
62637
diff
changeset
|
925 |
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
|
926 |
var i = 0 |
478b49f0d726
proper SHA1 digest as annex to heap file: Poly/ML reads precise segment length;
wenzelm
parents:
62637
diff
changeset
|
927 |
var m = 0 |
478b49f0d726
proper SHA1 digest as annex to heap file: Poly/ML reads precise segment length;
wenzelm
parents:
62637
diff
changeset
|
928 |
do { |
478b49f0d726
proper SHA1 digest as annex to heap file: Poly/ML reads precise segment length;
wenzelm
parents:
62637
diff
changeset
|
929 |
m = file.read(buf) |
478b49f0d726
proper SHA1 digest as annex to heap file: Poly/ML reads precise segment length;
wenzelm
parents:
62637
diff
changeset
|
930 |
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
|
931 |
} |
478b49f0d726
proper SHA1 digest as annex to heap file: Poly/ML reads precise segment length;
wenzelm
parents:
62637
diff
changeset
|
932 |
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
|
933 |
|
478b49f0d726
proper SHA1 digest as annex to heap file: Poly/ML reads precise segment length;
wenzelm
parents:
62637
diff
changeset
|
934 |
if (i == n) { |
478b49f0d726
proper SHA1 digest as annex to heap file: Poly/ML reads precise segment length;
wenzelm
parents:
62637
diff
changeset
|
935 |
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
|
936 |
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
|
937 |
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
|
938 |
} |
478b49f0d726
proper SHA1 digest as annex to heap file: Poly/ML reads precise segment length;
wenzelm
parents:
62637
diff
changeset
|
939 |
else None |
478b49f0d726
proper SHA1 digest as annex to heap file: Poly/ML reads precise segment length;
wenzelm
parents:
62637
diff
changeset
|
940 |
} |
478b49f0d726
proper SHA1 digest as annex to heap file: Poly/ML reads precise segment length;
wenzelm
parents:
62637
diff
changeset
|
941 |
else None |
478b49f0d726
proper SHA1 digest as annex to heap file: Poly/ML reads precise segment length;
wenzelm
parents:
62637
diff
changeset
|
942 |
} |
478b49f0d726
proper SHA1 digest as annex to heap file: Poly/ML reads precise segment length;
wenzelm
parents:
62637
diff
changeset
|
943 |
finally { file.close } |
478b49f0d726
proper SHA1 digest as annex to heap file: Poly/ML reads precise segment length;
wenzelm
parents:
62637
diff
changeset
|
944 |
} |
478b49f0d726
proper SHA1 digest as annex to heap file: Poly/ML reads precise segment length;
wenzelm
parents:
62637
diff
changeset
|
945 |
else None |
478b49f0d726
proper SHA1 digest as annex to heap file: Poly/ML reads precise segment length;
wenzelm
parents:
62637
diff
changeset
|
946 |
} |
478b49f0d726
proper SHA1 digest as annex to heap file: Poly/ML reads precise segment length;
wenzelm
parents:
62637
diff
changeset
|
947 |
|
478b49f0d726
proper SHA1 digest as annex to heap file: Poly/ML reads precise segment length;
wenzelm
parents:
62637
diff
changeset
|
948 |
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
|
949 |
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
|
950 |
case None => |
478b49f0d726
proper SHA1 digest as annex to heap file: Poly/ML reads precise segment length;
wenzelm
parents:
62637
diff
changeset
|
951 |
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
|
952 |
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
|
953 |
s |
478b49f0d726
proper SHA1 digest as annex to heap file: Poly/ML reads precise segment length;
wenzelm
parents:
62637
diff
changeset
|
954 |
case Some(s) => s |
478b49f0d726
proper SHA1 digest as annex to heap file: Poly/ML reads precise segment length;
wenzelm
parents:
62637
diff
changeset
|
955 |
} |
478b49f0d726
proper SHA1 digest as annex to heap file: Poly/ML reads precise segment length;
wenzelm
parents:
62637
diff
changeset
|
956 |
|
478b49f0d726
proper SHA1 digest as annex to heap file: Poly/ML reads precise segment length;
wenzelm
parents:
62637
diff
changeset
|
957 |
|
478b49f0d726
proper SHA1 digest as annex to heap file: Poly/ML reads precise segment length;
wenzelm
parents:
62637
diff
changeset
|
958 |
|
62637
0189fe0f6452
support for Poly/ML heap hierarchy, which saves a lot of disk space;
wenzelm
parents:
62636
diff
changeset
|
959 |
/** persistent store **/ |
62632 | 960 |
|
65296 | 961 |
object Session_Info |
962 |
{ |
|
66857 | 963 |
val session_name = SQL.Column.string("session_name").make_primary_key |
65326 | 964 |
|
65296 | 965 |
// Build_Log.Session_Info |
966 |
val session_timing = SQL.Column.bytes("session_timing") |
|
967 |
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
|
968 |
val theory_timings = SQL.Column.bytes("theory_timings") |
65296 | 969 |
val ml_statistics = SQL.Column.bytes("ml_statistics") |
970 |
val task_statistics = SQL.Column.bytes("task_statistics") |
|
65934 | 971 |
val errors = SQL.Column.bytes("errors") |
65296 | 972 |
val build_log_columns = |
66873
9953ae603a23
provide theory timing information, similar to command timing but always considered relevant;
wenzelm
parents:
66857
diff
changeset
|
973 |
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
|
974 |
ml_statistics, task_statistics, errors) |
65296 | 975 |
|
976 |
// Build.Session_Info |
|
977 |
val sources = SQL.Column.string("sources") |
|
978 |
val input_heaps = SQL.Column.string("input_heaps") |
|
979 |
val output_heap = SQL.Column.string("output_heap") |
|
980 |
val return_code = SQL.Column.int("return_code") |
|
66746 | 981 |
val build_columns = List(sources, input_heaps, output_heap, return_code) |
65296 | 982 |
|
983 |
val table = SQL.Table("isabelle_session_info", build_log_columns ::: build_columns) |
|
984 |
} |
|
985 |
||
68209 | 986 |
def store(options: Options, system_mode: Boolean = false): Store = |
987 |
new Store(options, system_mode) |
|
62632 | 988 |
|
68209 | 989 |
class Store private[Sessions](val options: Options, val system_mode: Boolean) |
62632 | 990 |
{ |
68219 | 991 |
override def toString: String = "Store(output_dir = " + output_dir.expand + ")" |
992 |
||
993 |
||
994 |
/* directories */ |
|
995 |
||
68221 | 996 |
val system_output_dir: Path = Path.explode("~~/heaps/$ML_IDENTIFIER") |
997 |
val user_output_dir: Path = Path.explode("$ISABELLE_HOME_USER/heaps/$ML_IDENTIFIER") |
|
68219 | 998 |
|
68221 | 999 |
val output_dir: Path = |
68219 | 1000 |
if (system_mode) system_output_dir else user_output_dir |
1001 |
||
68221 | 1002 |
val input_dirs: List[Path] = |
68219 | 1003 |
if (system_mode) List(system_output_dir) |
1004 |
else List(user_output_dir, system_output_dir) |
|
62632 | 1005 |
|
1006 |
val browser_info: Path = |
|
1007 |
if (system_mode) Path.explode("~~/browser_info") |
|
1008 |
else Path.explode("$ISABELLE_BROWSER_INFO") |
|
1009 |
||
62637
0189fe0f6452
support for Poly/ML heap hierarchy, which saves a lot of disk space;
wenzelm
parents:
62636
diff
changeset
|
1010 |
|
68221 | 1011 |
/* file names */ |
65298 | 1012 |
|
68221 | 1013 |
def heap(name: String): Path = Path.basic(name) |
1014 |
def database(name: String): Path = Path.basic("log") + Path.basic(name).ext("db") |
|
1015 |
def log(name: String): Path = Path.basic("log") + Path.basic(name) |
|
1016 |
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
|
1017 |
|
68221 | 1018 |
def output_heap(name: String): Path = output_dir + heap(name) |
1019 |
def output_database(name: String): Path = output_dir + database(name) |
|
68086
9e1c670301b8
cleanup session output before starting build job;
wenzelm
parents:
68018
diff
changeset
|
1020 |
def output_log(name: String): Path = output_dir + log(name) |
9e1c670301b8
cleanup session output before starting build job;
wenzelm
parents:
68018
diff
changeset
|
1021 |
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
|
1022 |
|
68221 | 1023 |
def prepare_output_dir() { Isabelle_System.mkdirs(output_dir + Path.basic("log")) } |
68220
8fc4e3d1df86
clarified store.clean_output: cleanup user_output_dir even in system_mode;
wenzelm
parents:
68219
diff
changeset
|
1024 |
|
62637
0189fe0f6452
support for Poly/ML heap hierarchy, which saves a lot of disk space;
wenzelm
parents:
62636
diff
changeset
|
1025 |
|
68221 | 1026 |
/* heap */ |
62637
0189fe0f6452
support for Poly/ML heap hierarchy, which saves a lot of disk space;
wenzelm
parents:
62636
diff
changeset
|
1027 |
|
68212
5a59fded83c7
clarified heap vs. database operations: discontinued correlation of directory;
wenzelm
parents:
68210
diff
changeset
|
1028 |
def find_heap(name: String): Option[Path] = |
68221 | 1029 |
input_dirs.map(_ + heap(name)).find(_.is_file) |
68212
5a59fded83c7
clarified heap vs. database operations: discontinued correlation of directory;
wenzelm
parents:
68210
diff
changeset
|
1030 |
|
5a59fded83c7
clarified heap vs. database operations: discontinued correlation of directory;
wenzelm
parents:
68210
diff
changeset
|
1031 |
def find_heap_digest(name: String): Option[String] = |
5a59fded83c7
clarified heap vs. database operations: discontinued correlation of directory;
wenzelm
parents:
68210
diff
changeset
|
1032 |
find_heap(name).flatMap(read_heap_digest(_)) |
62632 | 1033 |
|
68221 | 1034 |
def the_heap(name: String): Path = |
1035 |
find_heap(name) getOrElse |
|
1036 |
error("Missing heap image for session " + quote(name) + " -- expected in:\n" + |
|
1037 |
cat_lines(input_dirs.map(dir => " " + dir.expand.implode))) |
|
1038 |
||
1039 |
||
1040 |
/* database */ |
|
1041 |
||
1042 |
private def database_server: Boolean = options.bool("build_database_server") |
|
65281
c70e7d24a16d
SQL database operations for combined session info;
wenzelm
parents:
65278
diff
changeset
|
1043 |
|
68221 | 1044 |
def access_database(name: String, output: Boolean = false): Option[SQL.Database] = |
1045 |
{ |
|
1046 |
if (database_server) { |
|
1047 |
val db = |
|
1048 |
PostgreSQL.open_database( |
|
1049 |
user = options.string("build_database_user"), |
|
1050 |
password = options.string("build_database_password"), |
|
1051 |
database = options.string("build_database_name"), |
|
1052 |
host = options.string("build_database_host"), |
|
1053 |
port = options.int("build_database_port"), |
|
1054 |
ssh = |
|
1055 |
proper_string(options.string("build_database_ssh_host")).map(ssh_host => |
|
1056 |
SSH.open_session(options, |
|
1057 |
host = ssh_host, |
|
1058 |
user = options.string("build_database_ssh_user"), |
|
1059 |
port = options.int("build_database_ssh_port"))), |
|
1060 |
ssh_close = true) |
|
1061 |
if (output || has_session_info(db, name)) Some(db) else { db.close; None } |
|
1062 |
} |
|
1063 |
else if (output) Some(SQLite.open_database(output_database(name))) |
|
1064 |
else input_dirs.map(_ + database(name)).find(_.is_file).map(SQLite.open_database(_)) |
|
1065 |
} |
|
68212
5a59fded83c7
clarified heap vs. database operations: discontinued correlation of directory;
wenzelm
parents:
68210
diff
changeset
|
1066 |
|
68221 | 1067 |
def open_database(name: String, output: Boolean = false): SQL.Database = |
1068 |
access_database(name, output = output) getOrElse |
|
1069 |
error("Missing build database for session " + quote(name)) |
|
68205 | 1070 |
|
68221 | 1071 |
def clean_output(name: String): (Boolean, Boolean) = |
1072 |
{ |
|
1073 |
val relevant_db = |
|
1074 |
database_server && |
|
1075 |
{ |
|
1076 |
access_database(name) match { |
|
1077 |
case Some(db) => |
|
1078 |
try { |
|
1079 |
db.transaction { |
|
1080 |
val relevant_db = has_session_info(db, name) |
|
1081 |
init_session_info(db, name) |
|
1082 |
relevant_db |
|
1083 |
} |
|
1084 |
} finally { db.close } |
|
1085 |
case None => false |
|
1086 |
} |
|
1087 |
} |
|
68212
5a59fded83c7
clarified heap vs. database operations: discontinued correlation of directory;
wenzelm
parents:
68210
diff
changeset
|
1088 |
|
68221 | 1089 |
val del = |
1090 |
for { |
|
1091 |
dir <- (if (system_mode) List(user_output_dir, system_output_dir) else List(user_output_dir)) |
|
1092 |
file <- List(heap(name), database(name), log(name), log_gz(name)) |
|
1093 |
path = dir + file if path.is_file |
|
1094 |
} yield path.file.delete |
|
1095 |
||
1096 |
val relevant = relevant_db || del.nonEmpty |
|
1097 |
val ok = del.forall(b => b) |
|
1098 |
(relevant, ok) |
|
1099 |
} |
|
65287 | 1100 |
|
1101 |
||
68218 | 1102 |
/* SQL database content */ |
1103 |
||
68294 | 1104 |
val xml_cache: XML.Cache = XML.make_cache() |
1105 |
val xz_cache: XZ.Cache = XZ.make_cache() |
|
68218 | 1106 |
|
1107 |
def read_bytes(db: SQL.Database, name: String, column: SQL.Column): Bytes = |
|
1108 |
db.using_statement(Session_Info.table.select(List(column), |
|
1109 |
Session_Info.session_name.where_equal(name)))(stmt => |
|
1110 |
{ |
|
1111 |
val res = stmt.execute_query() |
|
1112 |
if (!res.next()) Bytes.empty else res.bytes(column) |
|
1113 |
}) |
|
1114 |
||
1115 |
def read_properties(db: SQL.Database, name: String, column: SQL.Column): List[Properties.T] = |
|
1116 |
Properties.uncompress( |
|
1117 |
read_bytes(db, name, column), cache = xz_cache, xml_cache = Some(xml_cache)) |
|
1118 |
||
1119 |
||
65296 | 1120 |
/* session info */ |
65281
c70e7d24a16d
SQL database operations for combined session info;
wenzelm
parents:
65278
diff
changeset
|
1121 |
|
68086
9e1c670301b8
cleanup session output before starting build job;
wenzelm
parents:
68018
diff
changeset
|
1122 |
def init_session_info(db: SQL.Database, name: String) |
9e1c670301b8
cleanup session output before starting build job;
wenzelm
parents:
68018
diff
changeset
|
1123 |
{ |
9e1c670301b8
cleanup session output before starting build job;
wenzelm
parents:
68018
diff
changeset
|
1124 |
db.transaction { |
9e1c670301b8
cleanup session output before starting build job;
wenzelm
parents:
68018
diff
changeset
|
1125 |
db.create_table(Session_Info.table) |
9e1c670301b8
cleanup session output before starting build job;
wenzelm
parents:
68018
diff
changeset
|
1126 |
db.using_statement( |
9e1c670301b8
cleanup session output before starting build job;
wenzelm
parents:
68018
diff
changeset
|
1127 |
Session_Info.table.delete(Session_Info.session_name.where_equal(name)))(_.execute) |
68221 | 1128 |
|
1129 |
db.create_table(Export.Data.table) |
|
1130 |
db.using_statement( |
|
1131 |
Export.Data.table.delete(Export.Data.session_name.where_equal(name)))(_.execute) |
|
1132 |
} |
|
1133 |
} |
|
1134 |
||
1135 |
def has_session_info(db: SQL.Database, name: String): Boolean = |
|
1136 |
{ |
|
1137 |
db.transaction { |
|
1138 |
db.tables.contains(Session_Info.table.name) && |
|
1139 |
{ |
|
1140 |
db.using_statement( |
|
1141 |
Session_Info.table.select(List(Session_Info.session_name), |
|
1142 |
Session_Info.session_name.where_equal(name)))(stmt => stmt.execute_query().next()) |
|
1143 |
} |
|
68086
9e1c670301b8
cleanup session output before starting build job;
wenzelm
parents:
68018
diff
changeset
|
1144 |
} |
9e1c670301b8
cleanup session output before starting build job;
wenzelm
parents:
68018
diff
changeset
|
1145 |
} |
9e1c670301b8
cleanup session output before starting build job;
wenzelm
parents:
68018
diff
changeset
|
1146 |
|
65296 | 1147 |
def write_session_info( |
65318
342efc382558
eliminated somewhat redundant inlined name (despite a7aa17a1f721);
wenzelm
parents:
65298
diff
changeset
|
1148 |
db: SQL.Database, |
65320
52861eebf58d
access table via session_name: db may in principle contain multiple entries;
wenzelm
parents:
65318
diff
changeset
|
1149 |
name: String, |
65318
342efc382558
eliminated somewhat redundant inlined name (despite a7aa17a1f721);
wenzelm
parents:
65298
diff
changeset
|
1150 |
build_log: Build_Log.Session_Info, |
342efc382558
eliminated somewhat redundant inlined name (despite a7aa17a1f721);
wenzelm
parents:
65298
diff
changeset
|
1151 |
build: Build.Session_Info) |
65281
c70e7d24a16d
SQL database operations for combined session info;
wenzelm
parents:
65278
diff
changeset
|
1152 |
{ |
c70e7d24a16d
SQL database operations for combined session info;
wenzelm
parents:
65278
diff
changeset
|
1153 |
db.transaction { |
65698 | 1154 |
db.using_statement(Session_Info.table.insert())(stmt => |
65281
c70e7d24a16d
SQL database operations for combined session info;
wenzelm
parents:
65278
diff
changeset
|
1155 |
{ |
65748 | 1156 |
stmt.string(1) = name |
65857 | 1157 |
stmt.bytes(2) = Properties.encode(build_log.session_timing) |
68018 | 1158 |
stmt.bytes(3) = Properties.compress(build_log.command_timings, cache = xz_cache) |
1159 |
stmt.bytes(4) = Properties.compress(build_log.theory_timings, cache = xz_cache) |
|
1160 |
stmt.bytes(5) = Properties.compress(build_log.ml_statistics, cache = xz_cache) |
|
1161 |
stmt.bytes(6) = Properties.compress(build_log.task_statistics, cache = xz_cache) |
|
1162 |
stmt.bytes(7) = Build_Log.compress_errors(build_log.errors, cache = xz_cache) |
|
66873
9953ae603a23
provide theory timing information, similar to command timing but always considered relevant;
wenzelm
parents:
66857
diff
changeset
|
1163 |
stmt.string(8) = build.sources |
9953ae603a23
provide theory timing information, similar to command timing but always considered relevant;
wenzelm
parents:
66857
diff
changeset
|
1164 |
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
|
1165 |
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
|
1166 |
stmt.int(11) = build.return_code |
65281
c70e7d24a16d
SQL database operations for combined session info;
wenzelm
parents:
65278
diff
changeset
|
1167 |
stmt.execute() |
c70e7d24a16d
SQL database operations for combined session info;
wenzelm
parents:
65278
diff
changeset
|
1168 |
}) |
c70e7d24a16d
SQL database operations for combined session info;
wenzelm
parents:
65278
diff
changeset
|
1169 |
} |
c70e7d24a16d
SQL database operations for combined session info;
wenzelm
parents:
65278
diff
changeset
|
1170 |
} |
c70e7d24a16d
SQL database operations for combined session info;
wenzelm
parents:
65278
diff
changeset
|
1171 |
|
65320
52861eebf58d
access table via session_name: db may in principle contain multiple entries;
wenzelm
parents:
65318
diff
changeset
|
1172 |
def read_session_timing(db: SQL.Database, name: String): Properties.T = |
65857 | 1173 |
Properties.decode(read_bytes(db, name, Session_Info.session_timing), Some(xml_cache)) |
65286 | 1174 |
|
65320
52861eebf58d
access table via session_name: db may in principle contain multiple entries;
wenzelm
parents:
65318
diff
changeset
|
1175 |
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
|
1176 |
read_properties(db, name, Session_Info.command_timings) |
65286 | 1177 |
|
66873
9953ae603a23
provide theory timing information, similar to command timing but always considered relevant;
wenzelm
parents:
66857
diff
changeset
|
1178 |
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
|
1179 |
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
|
1180 |
|
65320
52861eebf58d
access table via session_name: db may in principle contain multiple entries;
wenzelm
parents:
65318
diff
changeset
|
1181 |
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
|
1182 |
read_properties(db, name, Session_Info.ml_statistics) |
65286 | 1183 |
|
65320
52861eebf58d
access table via session_name: db may in principle contain multiple entries;
wenzelm
parents:
65318
diff
changeset
|
1184 |
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
|
1185 |
read_properties(db, name, Session_Info.task_statistics) |
65286 | 1186 |
|
65937 | 1187 |
def read_errors(db: SQL.Database, name: String): List[String] = |
68018 | 1188 |
Build_Log.uncompress_errors(read_bytes(db, name, Session_Info.errors), cache = xz_cache) |
65937 | 1189 |
|
65320
52861eebf58d
access table via session_name: db may in principle contain multiple entries;
wenzelm
parents:
65318
diff
changeset
|
1190 |
def read_build(db: SQL.Database, name: String): Option[Build.Session_Info] = |
66744 | 1191 |
{ |
66957
82d13ba817b2
more permissive: db could be empty after hard crash;
wenzelm
parents:
66914
diff
changeset
|
1192 |
if (db.tables.contains(Session_Info.table.name)) { |
82d13ba817b2
more permissive: db could be empty after hard crash;
wenzelm
parents:
66914
diff
changeset
|
1193 |
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
|
1194 |
Session_Info.session_name.where_equal(name)))(stmt => |
82d13ba817b2
more permissive: db could be empty after hard crash;
wenzelm
parents:
66914
diff
changeset
|
1195 |
{ |
82d13ba817b2
more permissive: db could be empty after hard crash;
wenzelm
parents:
66914
diff
changeset
|
1196 |
val res = stmt.execute_query() |
82d13ba817b2
more permissive: db could be empty after hard crash;
wenzelm
parents:
66914
diff
changeset
|
1197 |
if (!res.next()) None |
82d13ba817b2
more permissive: db could be empty after hard crash;
wenzelm
parents:
66914
diff
changeset
|
1198 |
else { |
82d13ba817b2
more permissive: db could be empty after hard crash;
wenzelm
parents:
66914
diff
changeset
|
1199 |
Some( |
82d13ba817b2
more permissive: db could be empty after hard crash;
wenzelm
parents:
66914
diff
changeset
|
1200 |
Build.Session_Info( |
82d13ba817b2
more permissive: db could be empty after hard crash;
wenzelm
parents:
66914
diff
changeset
|
1201 |
res.string(Session_Info.sources), |
82d13ba817b2
more permissive: db could be empty after hard crash;
wenzelm
parents:
66914
diff
changeset
|
1202 |
split_lines(res.string(Session_Info.input_heaps)), |
82d13ba817b2
more permissive: db could be empty after hard crash;
wenzelm
parents:
66914
diff
changeset
|
1203 |
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
|
1204 |
res.int(Session_Info.return_code))) |
82d13ba817b2
more permissive: db could be empty after hard crash;
wenzelm
parents:
66914
diff
changeset
|
1205 |
} |
82d13ba817b2
more permissive: db could be empty after hard crash;
wenzelm
parents:
66914
diff
changeset
|
1206 |
}) |
82d13ba817b2
more permissive: db could be empty after hard crash;
wenzelm
parents:
66914
diff
changeset
|
1207 |
} |
82d13ba817b2
more permissive: db could be empty after hard crash;
wenzelm
parents:
66914
diff
changeset
|
1208 |
else None |
66744 | 1209 |
} |
65281
c70e7d24a16d
SQL database operations for combined session info;
wenzelm
parents:
65278
diff
changeset
|
1210 |
} |
62631 | 1211 |
} |