wenzelm@49291
|
1 |
/* Title: Pure/System/build.scala
|
wenzelm@49291
|
2 |
Author: Makarius
|
wenzelm@49291
|
3 |
|
wenzelm@49291
|
4 |
Build and manage Isabelle sessions.
|
wenzelm@49291
|
5 |
*/
|
wenzelm@49291
|
6 |
|
wenzelm@49291
|
7 |
package isabelle
|
wenzelm@49291
|
8 |
|
wenzelm@49291
|
9 |
|
wenzelm@49350
|
10 |
import java.io.File
|
wenzelm@49350
|
11 |
|
wenzelm@49352
|
12 |
import scala.collection.mutable
|
wenzelm@49355
|
13 |
import scala.annotation.tailrec
|
wenzelm@49352
|
14 |
|
wenzelm@49350
|
15 |
|
wenzelm@49291
|
16 |
object Build
|
wenzelm@49291
|
17 |
{
|
wenzelm@49352
|
18 |
/** session information **/
|
wenzelm@49349
|
19 |
|
wenzelm@49349
|
20 |
type Options = List[(String, Option[String])]
|
wenzelm@49349
|
21 |
|
wenzelm@49364
|
22 |
object Session
|
wenzelm@49364
|
23 |
{
|
wenzelm@49364
|
24 |
object Key
|
wenzelm@49364
|
25 |
{
|
wenzelm@49364
|
26 |
object Ordering extends scala.math.Ordering[Key]
|
wenzelm@49364
|
27 |
{
|
wenzelm@49364
|
28 |
def compare(key1: Key, key2: Key): Int =
|
wenzelm@49365
|
29 |
key1.order compare key2.order match {
|
wenzelm@49364
|
30 |
case 0 => key1.name compare key2.name
|
wenzelm@49364
|
31 |
case ord => ord
|
wenzelm@49364
|
32 |
}
|
wenzelm@49364
|
33 |
}
|
wenzelm@49364
|
34 |
}
|
wenzelm@49364
|
35 |
|
wenzelm@49364
|
36 |
sealed case class Key(name: String, order: Int)
|
wenzelm@49364
|
37 |
{
|
wenzelm@49364
|
38 |
override def toString: String = name
|
wenzelm@49364
|
39 |
}
|
wenzelm@49364
|
40 |
|
wenzelm@49364
|
41 |
sealed case class Info(
|
wenzelm@49364
|
42 |
dir: Path,
|
wenzelm@49364
|
43 |
description: String,
|
wenzelm@49364
|
44 |
options: Options,
|
wenzelm@49364
|
45 |
theories: List[(Options, String)],
|
wenzelm@49364
|
46 |
files: List[String])
|
wenzelm@49364
|
47 |
|
wenzelm@49364
|
48 |
object Queue
|
wenzelm@49364
|
49 |
{
|
wenzelm@49364
|
50 |
val empty: Queue = new Queue()
|
wenzelm@49364
|
51 |
}
|
wenzelm@49364
|
52 |
|
wenzelm@49364
|
53 |
final class Queue private(
|
wenzelm@49364
|
54 |
keys: Map[String, Key] = Map.empty,
|
wenzelm@49364
|
55 |
graph: Graph[Key, Info] = Graph.empty(Key.Ordering))
|
wenzelm@49364
|
56 |
{
|
wenzelm@49366
|
57 |
def defined(name: String): Boolean = keys.isDefinedAt(name)
|
wenzelm@49364
|
58 |
|
wenzelm@49366
|
59 |
def + (key: Key, info: Info, parent: Option[String]): Queue =
|
wenzelm@49364
|
60 |
{
|
wenzelm@49364
|
61 |
val keys1 =
|
wenzelm@49366
|
62 |
if (defined(key.name)) error("Duplicate session: " + quote(key.name))
|
wenzelm@49366
|
63 |
else keys + (key.name -> key)
|
wenzelm@49364
|
64 |
|
wenzelm@49364
|
65 |
val graph1 =
|
wenzelm@49364
|
66 |
try {
|
wenzelm@49366
|
67 |
graph.new_node(key, info).add_deps_acyclic(key, parent.toList.map(keys(_)))
|
wenzelm@49364
|
68 |
}
|
wenzelm@49364
|
69 |
catch {
|
wenzelm@49364
|
70 |
case exn: Graph.Cycles[_] =>
|
wenzelm@49364
|
71 |
error(cat_lines(exn.cycles.map(cycle =>
|
wenzelm@49364
|
72 |
"Cyclic session dependency of " +
|
wenzelm@49364
|
73 |
cycle.map(key => quote(key.toString)).mkString(" via "))))
|
wenzelm@49364
|
74 |
}
|
wenzelm@49364
|
75 |
new Queue(keys1, graph1)
|
wenzelm@49364
|
76 |
}
|
wenzelm@49364
|
77 |
|
wenzelm@49366
|
78 |
def topological_order: List[(Key, Info)] =
|
wenzelm@49366
|
79 |
graph.topological_order.map(key => (key, graph.get_node(key)))
|
wenzelm@49364
|
80 |
}
|
wenzelm@49364
|
81 |
}
|
wenzelm@49295
|
82 |
|
wenzelm@49352
|
83 |
|
wenzelm@49352
|
84 |
/* parsing */
|
wenzelm@49352
|
85 |
|
wenzelm@49352
|
86 |
private case class Session_Entry(
|
wenzelm@49352
|
87 |
name: String,
|
wenzelm@49352
|
88 |
reset: Boolean,
|
wenzelm@49364
|
89 |
order: Int,
|
wenzelm@49352
|
90 |
path: Option[String],
|
wenzelm@49362
|
91 |
parent: Option[String],
|
wenzelm@49352
|
92 |
description: String,
|
wenzelm@49352
|
93 |
options: Options,
|
wenzelm@49352
|
94 |
theories: List[(Options, List[String])],
|
wenzelm@49352
|
95 |
files: List[String])
|
wenzelm@49352
|
96 |
|
wenzelm@49349
|
97 |
private object Parser extends Parse.Parser
|
wenzelm@49349
|
98 |
{
|
wenzelm@49349
|
99 |
val SESSION = "session"
|
wenzelm@49349
|
100 |
val IN = "in"
|
wenzelm@49349
|
101 |
val DESCRIPTION = "description"
|
wenzelm@49349
|
102 |
val OPTIONS = "options"
|
wenzelm@49349
|
103 |
val THEORIES = "theories"
|
wenzelm@49349
|
104 |
val FILES = "files"
|
wenzelm@49349
|
105 |
|
wenzelm@49349
|
106 |
val syntax =
|
wenzelm@49351
|
107 |
Outer_Syntax.empty + "!" + "(" + ")" + "+" + "," + "=" + "[" + "]" +
|
wenzelm@49351
|
108 |
SESSION + IN + DESCRIPTION + OPTIONS + THEORIES + FILES
|
wenzelm@49349
|
109 |
|
wenzelm@49352
|
110 |
val session_entry: Parser[Session_Entry] =
|
wenzelm@49349
|
111 |
{
|
wenzelm@49349
|
112 |
val session_name = atom("session name", _.is_name)
|
wenzelm@49349
|
113 |
val theory_name = atom("theory name", _.is_name)
|
wenzelm@49349
|
114 |
|
wenzelm@49349
|
115 |
val option =
|
wenzelm@49349
|
116 |
name ~ opt(keyword("=") ~! name ^^ { case _ ~ x => x }) ^^ { case x ~ y => (x, y) }
|
wenzelm@49352
|
117 |
val options = keyword("[") ~> repsep(option, keyword(",")) <~ keyword("]")
|
wenzelm@49349
|
118 |
|
wenzelm@49349
|
119 |
val theories =
|
wenzelm@49349
|
120 |
keyword(THEORIES) ~! ((options | success(Nil)) ~ rep1(theory_name)) ^^
|
wenzelm@49349
|
121 |
{ case _ ~ (x ~ y) => (x, y) }
|
wenzelm@49349
|
122 |
|
wenzelm@49349
|
123 |
((keyword(SESSION) ~! session_name) ^^ { case _ ~ x => x }) ~
|
wenzelm@49351
|
124 |
(keyword("!") ^^^ true | success(false)) ~
|
wenzelm@49364
|
125 |
(keyword("(") ~! (nat <~ keyword(")")) ^^ { case _ ~ x => x } | success(Integer.MAX_VALUE)) ~
|
wenzelm@49352
|
126 |
(opt(keyword(IN) ~! string ^^ { case _ ~ x => x })) ~
|
wenzelm@49362
|
127 |
(keyword("=") ~> opt(session_name <~ keyword("+"))) ~
|
wenzelm@49349
|
128 |
(keyword(DESCRIPTION) ~! text ^^ { case _ ~ x => x } | success("")) ~
|
wenzelm@49349
|
129 |
(keyword(OPTIONS) ~! options ^^ { case _ ~ x => x } | success(Nil)) ~
|
wenzelm@49362
|
130 |
rep(theories) ~
|
wenzelm@49351
|
131 |
(keyword(FILES) ~! rep1(path) ^^ { case _ ~ x => x } | success(Nil)) ^^
|
wenzelm@49364
|
132 |
{ case a ~ b ~ c ~ d ~ e ~ f ~ g ~ h ~ i => Session_Entry(a, b, c, d, e, f, g, h, i) }
|
wenzelm@49349
|
133 |
}
|
wenzelm@49349
|
134 |
|
wenzelm@49352
|
135 |
def parse_entries(root: File): List[Session_Entry] =
|
wenzelm@49349
|
136 |
{
|
wenzelm@49350
|
137 |
val toks = syntax.scan(Standard_System.read_file(root))
|
wenzelm@49352
|
138 |
parse_all(rep(session_entry), Token.reader(toks, root.toString)) match {
|
wenzelm@49349
|
139 |
case Success(result, _) => result
|
wenzelm@49349
|
140 |
case bad => error(bad.toString)
|
wenzelm@49349
|
141 |
}
|
wenzelm@49349
|
142 |
}
|
wenzelm@49349
|
143 |
}
|
wenzelm@49295
|
144 |
|
wenzelm@49352
|
145 |
|
wenzelm@49356
|
146 |
/* find sessions */
|
wenzelm@49352
|
147 |
|
wenzelm@49376
|
148 |
private val ROOT = Path.explode("ROOT")
|
wenzelm@49376
|
149 |
private val SESSIONS = Path.explode("etc/sessions")
|
wenzelm@49376
|
150 |
|
wenzelm@49376
|
151 |
private def sessions_root(dir: Path, root: File, queue: Session.Queue): Session.Queue =
|
wenzelm@49295
|
152 |
{
|
wenzelm@49376
|
153 |
(queue /: Parser.parse_entries(root))((queue1, entry) =>
|
wenzelm@49352
|
154 |
try {
|
wenzelm@49362
|
155 |
if (entry.name == "") error("Bad session name")
|
wenzelm@49362
|
156 |
|
wenzelm@49352
|
157 |
val full_name =
|
wenzelm@49362
|
158 |
if (entry.name == "RAW" || entry.name == "Pure") {
|
wenzelm@49362
|
159 |
if (entry.parent.isDefined) error("Illegal parent session")
|
wenzelm@49362
|
160 |
else entry.name
|
wenzelm@49362
|
161 |
}
|
wenzelm@49362
|
162 |
else
|
wenzelm@49362
|
163 |
entry.parent match {
|
wenzelm@49376
|
164 |
case Some(parent_name) if queue1.defined(parent_name) =>
|
wenzelm@49362
|
165 |
if (entry.reset) entry.name
|
wenzelm@49366
|
166 |
else parent_name + "-" + entry.name
|
wenzelm@49366
|
167 |
case _ => error("Bad parent session")
|
wenzelm@49362
|
168 |
}
|
wenzelm@49354
|
169 |
|
wenzelm@49352
|
170 |
val path =
|
wenzelm@49352
|
171 |
entry.path match {
|
wenzelm@49352
|
172 |
case Some(p) => Path.explode(p)
|
wenzelm@49352
|
173 |
case None => Path.basic(entry.name)
|
wenzelm@49352
|
174 |
}
|
wenzelm@49354
|
175 |
|
wenzelm@49366
|
176 |
val key = Session.Key(full_name, entry.order)
|
wenzelm@49366
|
177 |
val info = Session.Info(dir + path, entry.description, entry.options,
|
wenzelm@49366
|
178 |
entry.theories.map({ case (x, ys) => ys.map(y => (x, y)) }).flatten, entry.files)
|
wenzelm@49366
|
179 |
|
wenzelm@49376
|
180 |
queue1 + (key, info, entry.parent)
|
wenzelm@49352
|
181 |
}
|
wenzelm@49352
|
182 |
catch {
|
wenzelm@49352
|
183 |
case ERROR(msg) =>
|
wenzelm@49352
|
184 |
error(msg + "\nThe error(s) above occurred in session entry " +
|
wenzelm@49352
|
185 |
quote(entry.name) + " (file " + quote(root.toString) + ")")
|
wenzelm@49367
|
186 |
})
|
wenzelm@49367
|
187 |
}
|
wenzelm@49367
|
188 |
|
wenzelm@49376
|
189 |
private def sessions_dir(strict: Boolean, dir: Path, queue: Session.Queue): Session.Queue =
|
wenzelm@49367
|
190 |
{
|
wenzelm@49376
|
191 |
val root = Isabelle_System.platform_file(dir + ROOT)
|
wenzelm@49376
|
192 |
if (root.isFile) sessions_root(dir, root, queue)
|
wenzelm@49367
|
193 |
else if (strict) error("Bad session root file: " + quote(root.toString))
|
wenzelm@49376
|
194 |
else queue
|
wenzelm@49367
|
195 |
}
|
wenzelm@49367
|
196 |
|
wenzelm@49376
|
197 |
private def sessions_catalog(dir: Path, catalog: File, queue: Session.Queue): Session.Queue =
|
wenzelm@49367
|
198 |
{
|
wenzelm@49369
|
199 |
val dirs =
|
wenzelm@49369
|
200 |
split_lines(Standard_System.read_file(catalog)).
|
wenzelm@49369
|
201 |
filterNot(line => line == "" || line.startsWith("#"))
|
wenzelm@49376
|
202 |
(queue /: dirs)((queue1, dir1) =>
|
wenzelm@49367
|
203 |
try {
|
wenzelm@49367
|
204 |
val dir2 = dir + Path.explode(dir1)
|
wenzelm@49376
|
205 |
if (Isabelle_System.platform_file(dir2).isDirectory) sessions_dir(true, dir2, queue1)
|
wenzelm@49367
|
206 |
else error("Bad session directory: " + dir2.toString)
|
wenzelm@49352
|
207 |
}
|
wenzelm@49367
|
208 |
catch {
|
wenzelm@49367
|
209 |
case ERROR(msg) =>
|
wenzelm@49367
|
210 |
error(msg + "\nThe error(s) above occurred in session catalog " + quote(catalog.toString))
|
wenzelm@49367
|
211 |
})
|
wenzelm@49367
|
212 |
}
|
wenzelm@49367
|
213 |
|
wenzelm@49367
|
214 |
def find_sessions(more_dirs: List[Path]): Session.Queue =
|
wenzelm@49367
|
215 |
{
|
wenzelm@49376
|
216 |
var queue = Session.Queue.empty
|
wenzelm@49367
|
217 |
|
wenzelm@49367
|
218 |
for (dir <- Isabelle_System.components()) {
|
wenzelm@49376
|
219 |
queue = sessions_dir(false, dir, queue)
|
wenzelm@49367
|
220 |
|
wenzelm@49376
|
221 |
val catalog = Isabelle_System.platform_file(dir + SESSIONS)
|
wenzelm@49367
|
222 |
if (catalog.isFile)
|
wenzelm@49376
|
223 |
queue = sessions_catalog(dir, catalog, queue)
|
wenzelm@49352
|
224 |
}
|
wenzelm@49367
|
225 |
|
wenzelm@49376
|
226 |
for (dir <- more_dirs) queue = sessions_dir(true, dir, queue)
|
wenzelm@49367
|
227 |
|
wenzelm@49376
|
228 |
queue
|
wenzelm@49295
|
229 |
}
|
wenzelm@49356
|
230 |
|
wenzelm@49356
|
231 |
|
wenzelm@49356
|
232 |
|
wenzelm@49356
|
233 |
/** build **/
|
wenzelm@49356
|
234 |
|
wenzelm@49356
|
235 |
def build(all_sessions: Boolean, build_images: Boolean, list_only: Boolean,
|
wenzelm@49356
|
236 |
more_dirs: List[Path], options: List[String], sessions: List[String]): Int =
|
wenzelm@49356
|
237 |
{
|
wenzelm@49356
|
238 |
println("more_dirs = " + more_dirs.toString)
|
wenzelm@49356
|
239 |
println("options = " + options.toString)
|
wenzelm@49356
|
240 |
println("sessions = " + sessions.toString)
|
wenzelm@49356
|
241 |
|
wenzelm@49366
|
242 |
for ((key, info) <- find_sessions(more_dirs).topological_order)
|
wenzelm@49366
|
243 |
println(key.name + " in " + info.dir)
|
wenzelm@49356
|
244 |
|
wenzelm@49356
|
245 |
0
|
wenzelm@49356
|
246 |
}
|
wenzelm@49356
|
247 |
|
wenzelm@49356
|
248 |
|
wenzelm@49361
|
249 |
/* command line entry point */
|
wenzelm@49356
|
250 |
|
wenzelm@49356
|
251 |
def main(args: Array[String])
|
wenzelm@49356
|
252 |
{
|
wenzelm@49361
|
253 |
Command_Line.tool {
|
wenzelm@49361
|
254 |
args.toList match {
|
wenzelm@49361
|
255 |
case
|
wenzelm@49361
|
256 |
Properties.Value.Boolean(all_sessions) ::
|
wenzelm@49361
|
257 |
Properties.Value.Boolean(build_images) ::
|
wenzelm@49361
|
258 |
Properties.Value.Boolean(list_only) ::
|
wenzelm@49361
|
259 |
Command_Line.Chunks(more_dirs, options, sessions) =>
|
wenzelm@49361
|
260 |
build(all_sessions, build_images, list_only,
|
wenzelm@49361
|
261 |
more_dirs.map(Path.explode), options, sessions)
|
wenzelm@49361
|
262 |
case _ => error("Bad arguments:\n" + cat_lines(args))
|
wenzelm@49356
|
263 |
}
|
wenzelm@49361
|
264 |
}
|
wenzelm@49356
|
265 |
}
|
wenzelm@49291
|
266 |
}
|
wenzelm@49291
|
267 |
|