src/Pure/System/build.scala
author wenzelm
Tue, 24 Jul 2012 12:14:16 +0200
changeset 48467 a4318c36a829
parent 48462 424fd5364f15
child 48469 826a771cff33
permissions -rw-r--r--
more precise propagation of options: build, session, theories;
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
48276
4bd480886813 basic setup for Isabelle build tool;
wenzelm
parents:
diff changeset
     1
/*  Title:      Pure/System/build.scala
4bd480886813 basic setup for Isabelle build tool;
wenzelm
parents:
diff changeset
     2
    Author:     Makarius
4bd480886813 basic setup for Isabelle build tool;
wenzelm
parents:
diff changeset
     3
4bd480886813 basic setup for Isabelle build tool;
wenzelm
parents:
diff changeset
     4
Build and manage Isabelle sessions.
4bd480886813 basic setup for Isabelle build tool;
wenzelm
parents:
diff changeset
     5
*/
4bd480886813 basic setup for Isabelle build tool;
wenzelm
parents:
diff changeset
     6
4bd480886813 basic setup for Isabelle build tool;
wenzelm
parents:
diff changeset
     7
package isabelle
4bd480886813 basic setup for Isabelle build tool;
wenzelm
parents:
diff changeset
     8
4bd480886813 basic setup for Isabelle build tool;
wenzelm
parents:
diff changeset
     9
48409
0d2114eb412a more explicit java.io.{File => JFile};
wenzelm
parents: 48373
diff changeset
    10
import java.io.{File => JFile}
48335
2f923e994056 more informative errors;
wenzelm
parents: 48334
diff changeset
    11
48337
9c7f8e5805b4 cumulate semantic Session_Info, based on syntactic Session_Entry;
wenzelm
parents: 48336
diff changeset
    12
import scala.collection.mutable
48340
6f4fc030882a allow explicit specification of additional session directories;
wenzelm
parents: 48339
diff changeset
    13
import scala.annotation.tailrec
48337
9c7f8e5805b4 cumulate semantic Session_Info, based on syntactic Session_Entry;
wenzelm
parents: 48336
diff changeset
    14
48335
2f923e994056 more informative errors;
wenzelm
parents: 48334
diff changeset
    15
48276
4bd480886813 basic setup for Isabelle build tool;
wenzelm
parents:
diff changeset
    16
object Build
4bd480886813 basic setup for Isabelle build tool;
wenzelm
parents:
diff changeset
    17
{
48337
9c7f8e5805b4 cumulate semantic Session_Info, based on syntactic Session_Entry;
wenzelm
parents: 48336
diff changeset
    18
  /** session information **/
48334
8dff9933e72a added parser for Session_Info;
wenzelm
parents: 48280
diff changeset
    19
48349
a78e5d399599 support Session.Queue with ordering and dependencies;
wenzelm
parents: 48347
diff changeset
    20
  object Session
a78e5d399599 support Session.Queue with ordering and dependencies;
wenzelm
parents: 48347
diff changeset
    21
  {
48421
c4d337782de4 propagate defined options;
wenzelm
parents: 48419
diff changeset
    22
    /* Key */
c4d337782de4 propagate defined options;
wenzelm
parents: 48419
diff changeset
    23
48349
a78e5d399599 support Session.Queue with ordering and dependencies;
wenzelm
parents: 48347
diff changeset
    24
    object Key
a78e5d399599 support Session.Queue with ordering and dependencies;
wenzelm
parents: 48347
diff changeset
    25
    {
a78e5d399599 support Session.Queue with ordering and dependencies;
wenzelm
parents: 48347
diff changeset
    26
      object Ordering extends scala.math.Ordering[Key]
a78e5d399599 support Session.Queue with ordering and dependencies;
wenzelm
parents: 48347
diff changeset
    27
      {
a78e5d399599 support Session.Queue with ordering and dependencies;
wenzelm
parents: 48347
diff changeset
    28
        def compare(key1: Key, key2: Key): Int =
48350
09bf3b73e446 clarified topological ordering: preserve order of adjacency via reverse fold;
wenzelm
parents: 48349
diff changeset
    29
          key1.order compare key2.order match {
48349
a78e5d399599 support Session.Queue with ordering and dependencies;
wenzelm
parents: 48347
diff changeset
    30
            case 0 => key1.name compare key2.name
a78e5d399599 support Session.Queue with ordering and dependencies;
wenzelm
parents: 48347
diff changeset
    31
            case ord => ord
a78e5d399599 support Session.Queue with ordering and dependencies;
wenzelm
parents: 48347
diff changeset
    32
          }
a78e5d399599 support Session.Queue with ordering and dependencies;
wenzelm
parents: 48347
diff changeset
    33
      }
a78e5d399599 support Session.Queue with ordering and dependencies;
wenzelm
parents: 48347
diff changeset
    34
    }
a78e5d399599 support Session.Queue with ordering and dependencies;
wenzelm
parents: 48347
diff changeset
    35
a78e5d399599 support Session.Queue with ordering and dependencies;
wenzelm
parents: 48347
diff changeset
    36
    sealed case class Key(name: String, order: Int)
a78e5d399599 support Session.Queue with ordering and dependencies;
wenzelm
parents: 48347
diff changeset
    37
    {
a78e5d399599 support Session.Queue with ordering and dependencies;
wenzelm
parents: 48347
diff changeset
    38
      override def toString: String = name
a78e5d399599 support Session.Queue with ordering and dependencies;
wenzelm
parents: 48347
diff changeset
    39
    }
a78e5d399599 support Session.Queue with ordering and dependencies;
wenzelm
parents: 48347
diff changeset
    40
48421
c4d337782de4 propagate defined options;
wenzelm
parents: 48419
diff changeset
    41
c4d337782de4 propagate defined options;
wenzelm
parents: 48419
diff changeset
    42
    /* Info */
c4d337782de4 propagate defined options;
wenzelm
parents: 48419
diff changeset
    43
48349
a78e5d399599 support Session.Queue with ordering and dependencies;
wenzelm
parents: 48347
diff changeset
    44
    sealed case class Info(
48457
fd9e28d5a143 pass build options to ML;
wenzelm
parents: 48447
diff changeset
    45
      base_name: String,
48349
a78e5d399599 support Session.Queue with ordering and dependencies;
wenzelm
parents: 48347
diff changeset
    46
      dir: Path,
48418
1a634f9614fb some actual build function on ML side;
wenzelm
parents: 48411
diff changeset
    47
      parent: Option[String],
48349
a78e5d399599 support Session.Queue with ordering and dependencies;
wenzelm
parents: 48347
diff changeset
    48
      description: String,
a78e5d399599 support Session.Queue with ordering and dependencies;
wenzelm
parents: 48347
diff changeset
    49
      options: Options,
48421
c4d337782de4 propagate defined options;
wenzelm
parents: 48419
diff changeset
    50
      theories: List[(Options, List[Path])],
c4d337782de4 propagate defined options;
wenzelm
parents: 48419
diff changeset
    51
      files: List[Path],
48424
wenzelm
parents: 48423
diff changeset
    52
      digest: SHA1.Digest)
48421
c4d337782de4 propagate defined options;
wenzelm
parents: 48419
diff changeset
    53
c4d337782de4 propagate defined options;
wenzelm
parents: 48419
diff changeset
    54
c4d337782de4 propagate defined options;
wenzelm
parents: 48419
diff changeset
    55
    /* Queue */
48349
a78e5d399599 support Session.Queue with ordering and dependencies;
wenzelm
parents: 48347
diff changeset
    56
a78e5d399599 support Session.Queue with ordering and dependencies;
wenzelm
parents: 48347
diff changeset
    57
    object Queue
a78e5d399599 support Session.Queue with ordering and dependencies;
wenzelm
parents: 48347
diff changeset
    58
    {
a78e5d399599 support Session.Queue with ordering and dependencies;
wenzelm
parents: 48347
diff changeset
    59
      val empty: Queue = new Queue()
a78e5d399599 support Session.Queue with ordering and dependencies;
wenzelm
parents: 48347
diff changeset
    60
    }
a78e5d399599 support Session.Queue with ordering and dependencies;
wenzelm
parents: 48347
diff changeset
    61
a78e5d399599 support Session.Queue with ordering and dependencies;
wenzelm
parents: 48347
diff changeset
    62
    final class Queue private(
a78e5d399599 support Session.Queue with ordering and dependencies;
wenzelm
parents: 48347
diff changeset
    63
      keys: Map[String, Key] = Map.empty,
a78e5d399599 support Session.Queue with ordering and dependencies;
wenzelm
parents: 48347
diff changeset
    64
      graph: Graph[Key, Info] = Graph.empty(Key.Ordering))
a78e5d399599 support Session.Queue with ordering and dependencies;
wenzelm
parents: 48347
diff changeset
    65
    {
48425
0d95980e9aae parallel scheduling of jobs;
wenzelm
parents: 48424
diff changeset
    66
      def is_empty: Boolean = graph.is_empty
0d95980e9aae parallel scheduling of jobs;
wenzelm
parents: 48424
diff changeset
    67
0d95980e9aae parallel scheduling of jobs;
wenzelm
parents: 48424
diff changeset
    68
      def apply(name: String): Info = graph.get_node(keys(name))
48351
a0b95a762abb less redundant data structures;
wenzelm
parents: 48350
diff changeset
    69
      def defined(name: String): Boolean = keys.isDefinedAt(name)
48419
6d7b6e47f3ef save image for inner nodes only;
wenzelm
parents: 48418
diff changeset
    70
      def is_inner(name: String): Boolean = !graph.is_maximal(keys(name))
6d7b6e47f3ef save image for inner nodes only;
wenzelm
parents: 48418
diff changeset
    71
48418
1a634f9614fb some actual build function on ML side;
wenzelm
parents: 48411
diff changeset
    72
      def + (key: Key, info: Info): Queue =
48349
a78e5d399599 support Session.Queue with ordering and dependencies;
wenzelm
parents: 48347
diff changeset
    73
      {
a78e5d399599 support Session.Queue with ordering and dependencies;
wenzelm
parents: 48347
diff changeset
    74
        val keys1 =
48351
a0b95a762abb less redundant data structures;
wenzelm
parents: 48350
diff changeset
    75
          if (defined(key.name)) error("Duplicate session: " + quote(key.name))
a0b95a762abb less redundant data structures;
wenzelm
parents: 48350
diff changeset
    76
          else keys + (key.name -> key)
48349
a78e5d399599 support Session.Queue with ordering and dependencies;
wenzelm
parents: 48347
diff changeset
    77
a78e5d399599 support Session.Queue with ordering and dependencies;
wenzelm
parents: 48347
diff changeset
    78
        val graph1 =
a78e5d399599 support Session.Queue with ordering and dependencies;
wenzelm
parents: 48347
diff changeset
    79
          try {
48418
1a634f9614fb some actual build function on ML side;
wenzelm
parents: 48411
diff changeset
    80
            graph.new_node(key, info).add_deps_acyclic(key, info.parent.toList.map(keys(_)))
48349
a78e5d399599 support Session.Queue with ordering and dependencies;
wenzelm
parents: 48347
diff changeset
    81
          }
a78e5d399599 support Session.Queue with ordering and dependencies;
wenzelm
parents: 48347
diff changeset
    82
          catch {
a78e5d399599 support Session.Queue with ordering and dependencies;
wenzelm
parents: 48347
diff changeset
    83
            case exn: Graph.Cycles[_] =>
a78e5d399599 support Session.Queue with ordering and dependencies;
wenzelm
parents: 48347
diff changeset
    84
              error(cat_lines(exn.cycles.map(cycle =>
a78e5d399599 support Session.Queue with ordering and dependencies;
wenzelm
parents: 48347
diff changeset
    85
                "Cyclic session dependency of " +
a78e5d399599 support Session.Queue with ordering and dependencies;
wenzelm
parents: 48347
diff changeset
    86
                  cycle.map(key => quote(key.toString)).mkString(" via "))))
a78e5d399599 support Session.Queue with ordering and dependencies;
wenzelm
parents: 48347
diff changeset
    87
          }
a78e5d399599 support Session.Queue with ordering and dependencies;
wenzelm
parents: 48347
diff changeset
    88
        new Queue(keys1, graph1)
a78e5d399599 support Session.Queue with ordering and dependencies;
wenzelm
parents: 48347
diff changeset
    89
      }
a78e5d399599 support Session.Queue with ordering and dependencies;
wenzelm
parents: 48347
diff changeset
    90
48425
0d95980e9aae parallel scheduling of jobs;
wenzelm
parents: 48424
diff changeset
    91
      def - (name: String): Queue = new Queue(keys - name, graph.del_node(keys(name)))
0d95980e9aae parallel scheduling of jobs;
wenzelm
parents: 48424
diff changeset
    92
48363
cf081b7042d2 restrict to required sessions;
wenzelm
parents: 48361
diff changeset
    93
      def required(names: List[String]): Queue =
cf081b7042d2 restrict to required sessions;
wenzelm
parents: 48361
diff changeset
    94
      {
cf081b7042d2 restrict to required sessions;
wenzelm
parents: 48361
diff changeset
    95
        val req = graph.all_preds(names.map(keys(_))).map(_.name).toSet
cf081b7042d2 restrict to required sessions;
wenzelm
parents: 48361
diff changeset
    96
        val keys1 = keys -- keys.keySet.filter(name => !req(name))
cf081b7042d2 restrict to required sessions;
wenzelm
parents: 48361
diff changeset
    97
        val graph1 = graph.restrict(key => keys1.isDefinedAt(key.name))
cf081b7042d2 restrict to required sessions;
wenzelm
parents: 48361
diff changeset
    98
        new Queue(keys1, graph1)
cf081b7042d2 restrict to required sessions;
wenzelm
parents: 48361
diff changeset
    99
      }
cf081b7042d2 restrict to required sessions;
wenzelm
parents: 48361
diff changeset
   100
48425
0d95980e9aae parallel scheduling of jobs;
wenzelm
parents: 48424
diff changeset
   101
      def dequeue(skip: String => Boolean): Option[(String, Info)] =
0d95980e9aae parallel scheduling of jobs;
wenzelm
parents: 48424
diff changeset
   102
      {
0d95980e9aae parallel scheduling of jobs;
wenzelm
parents: 48424
diff changeset
   103
        val it = graph.entries.dropWhile(
0d95980e9aae parallel scheduling of jobs;
wenzelm
parents: 48424
diff changeset
   104
          { case (key, (_, (deps, _))) => !deps.isEmpty || skip(key.name) })
0d95980e9aae parallel scheduling of jobs;
wenzelm
parents: 48424
diff changeset
   105
        if (it.hasNext) { val (key, (info, _)) = it.next; Some((key.name, info)) }
0d95980e9aae parallel scheduling of jobs;
wenzelm
parents: 48424
diff changeset
   106
        else None
0d95980e9aae parallel scheduling of jobs;
wenzelm
parents: 48424
diff changeset
   107
      }
0d95980e9aae parallel scheduling of jobs;
wenzelm
parents: 48424
diff changeset
   108
48422
9613780a805b determine source dependencies, relatively to preloaded theories;
wenzelm
parents: 48421
diff changeset
   109
      def topological_order: List[(String, Info)] =
9613780a805b determine source dependencies, relatively to preloaded theories;
wenzelm
parents: 48421
diff changeset
   110
        graph.topological_order.map(key => (key.name, graph.get_node(key)))
48349
a78e5d399599 support Session.Queue with ordering and dependencies;
wenzelm
parents: 48347
diff changeset
   111
    }
a78e5d399599 support Session.Queue with ordering and dependencies;
wenzelm
parents: 48347
diff changeset
   112
  }
48334
8dff9933e72a added parser for Session_Info;
wenzelm
parents: 48280
diff changeset
   113
48337
9c7f8e5805b4 cumulate semantic Session_Info, based on syntactic Session_Entry;
wenzelm
parents: 48336
diff changeset
   114
9c7f8e5805b4 cumulate semantic Session_Info, based on syntactic Session_Entry;
wenzelm
parents: 48336
diff changeset
   115
  /* parsing */
9c7f8e5805b4 cumulate semantic Session_Info, based on syntactic Session_Entry;
wenzelm
parents: 48336
diff changeset
   116
9c7f8e5805b4 cumulate semantic Session_Info, based on syntactic Session_Entry;
wenzelm
parents: 48336
diff changeset
   117
  private case class Session_Entry(
9c7f8e5805b4 cumulate semantic Session_Info, based on syntactic Session_Entry;
wenzelm
parents: 48336
diff changeset
   118
    name: String,
48462
424fd5364f15 clarified "this_name" vs. former "reset" feature -- imitate the latter by loading other session sources directly;
wenzelm
parents: 48459
diff changeset
   119
    this_name: Boolean,
48349
a78e5d399599 support Session.Queue with ordering and dependencies;
wenzelm
parents: 48347
diff changeset
   120
    order: Int,
48337
9c7f8e5805b4 cumulate semantic Session_Info, based on syntactic Session_Entry;
wenzelm
parents: 48336
diff changeset
   121
    path: Option[String],
48347
8bb27ab9e841 more explicit treatment of initial Pure sessions;
wenzelm
parents: 48346
diff changeset
   122
    parent: Option[String],
48337
9c7f8e5805b4 cumulate semantic Session_Info, based on syntactic Session_Entry;
wenzelm
parents: 48336
diff changeset
   123
    description: String,
48421
c4d337782de4 propagate defined options;
wenzelm
parents: 48419
diff changeset
   124
    options: List[Options.Spec],
c4d337782de4 propagate defined options;
wenzelm
parents: 48419
diff changeset
   125
    theories: List[(List[Options.Spec], List[String])],
48337
9c7f8e5805b4 cumulate semantic Session_Info, based on syntactic Session_Entry;
wenzelm
parents: 48336
diff changeset
   126
    files: List[String])
9c7f8e5805b4 cumulate semantic Session_Info, based on syntactic Session_Entry;
wenzelm
parents: 48336
diff changeset
   127
48334
8dff9933e72a added parser for Session_Info;
wenzelm
parents: 48280
diff changeset
   128
  private object Parser extends Parse.Parser
8dff9933e72a added parser for Session_Info;
wenzelm
parents: 48280
diff changeset
   129
  {
8dff9933e72a added parser for Session_Info;
wenzelm
parents: 48280
diff changeset
   130
    val SESSION = "session"
8dff9933e72a added parser for Session_Info;
wenzelm
parents: 48280
diff changeset
   131
    val IN = "in"
8dff9933e72a added parser for Session_Info;
wenzelm
parents: 48280
diff changeset
   132
    val DESCRIPTION = "description"
8dff9933e72a added parser for Session_Info;
wenzelm
parents: 48280
diff changeset
   133
    val OPTIONS = "options"
8dff9933e72a added parser for Session_Info;
wenzelm
parents: 48280
diff changeset
   134
    val THEORIES = "theories"
8dff9933e72a added parser for Session_Info;
wenzelm
parents: 48280
diff changeset
   135
    val FILES = "files"
8dff9933e72a added parser for Session_Info;
wenzelm
parents: 48280
diff changeset
   136
8dff9933e72a added parser for Session_Info;
wenzelm
parents: 48280
diff changeset
   137
    val syntax =
48336
3c55bfad22eb more tight treatment of reset_name;
wenzelm
parents: 48335
diff changeset
   138
      Outer_Syntax.empty + "!" + "(" + ")" + "+" + "," + "=" + "[" + "]" +
3c55bfad22eb more tight treatment of reset_name;
wenzelm
parents: 48335
diff changeset
   139
        SESSION + IN + DESCRIPTION + OPTIONS + THEORIES + FILES
48334
8dff9933e72a added parser for Session_Info;
wenzelm
parents: 48280
diff changeset
   140
48337
9c7f8e5805b4 cumulate semantic Session_Info, based on syntactic Session_Entry;
wenzelm
parents: 48336
diff changeset
   141
    val session_entry: Parser[Session_Entry] =
48334
8dff9933e72a added parser for Session_Info;
wenzelm
parents: 48280
diff changeset
   142
    {
8dff9933e72a added parser for Session_Info;
wenzelm
parents: 48280
diff changeset
   143
      val session_name = atom("session name", _.is_name)
8dff9933e72a added parser for Session_Info;
wenzelm
parents: 48280
diff changeset
   144
      val theory_name = atom("theory name", _.is_name)
48280
7d86239986c2 basic support for session ROOT files, with examples for FOL and ZF;
wenzelm
parents: 48276
diff changeset
   145
48334
8dff9933e72a added parser for Session_Info;
wenzelm
parents: 48280
diff changeset
   146
      val option =
8dff9933e72a added parser for Session_Info;
wenzelm
parents: 48280
diff changeset
   147
        name ~ opt(keyword("=") ~! name ^^ { case _ ~ x => x }) ^^ { case x ~ y => (x, y) }
48337
9c7f8e5805b4 cumulate semantic Session_Info, based on syntactic Session_Entry;
wenzelm
parents: 48336
diff changeset
   148
      val options = keyword("[") ~> repsep(option, keyword(",")) <~ keyword("]")
48334
8dff9933e72a added parser for Session_Info;
wenzelm
parents: 48280
diff changeset
   149
8dff9933e72a added parser for Session_Info;
wenzelm
parents: 48280
diff changeset
   150
      val theories =
8dff9933e72a added parser for Session_Info;
wenzelm
parents: 48280
diff changeset
   151
        keyword(THEORIES) ~! ((options | success(Nil)) ~ rep1(theory_name)) ^^
8dff9933e72a added parser for Session_Info;
wenzelm
parents: 48280
diff changeset
   152
          { case _ ~ (x ~ y) => (x, y) }
8dff9933e72a added parser for Session_Info;
wenzelm
parents: 48280
diff changeset
   153
8dff9933e72a added parser for Session_Info;
wenzelm
parents: 48280
diff changeset
   154
      ((keyword(SESSION) ~! session_name) ^^ { case _ ~ x => x }) ~
48336
3c55bfad22eb more tight treatment of reset_name;
wenzelm
parents: 48335
diff changeset
   155
        (keyword("!") ^^^ true | success(false)) ~
48349
a78e5d399599 support Session.Queue with ordering and dependencies;
wenzelm
parents: 48347
diff changeset
   156
        (keyword("(") ~! (nat <~ keyword(")")) ^^ { case _ ~ x => x } | success(Integer.MAX_VALUE)) ~
48337
9c7f8e5805b4 cumulate semantic Session_Info, based on syntactic Session_Entry;
wenzelm
parents: 48336
diff changeset
   157
        (opt(keyword(IN) ~! string ^^ { case _ ~ x => x })) ~
48347
8bb27ab9e841 more explicit treatment of initial Pure sessions;
wenzelm
parents: 48346
diff changeset
   158
        (keyword("=") ~> opt(session_name <~ keyword("+"))) ~
48334
8dff9933e72a added parser for Session_Info;
wenzelm
parents: 48280
diff changeset
   159
        (keyword(DESCRIPTION) ~! text ^^ { case _ ~ x => x } | success("")) ~
8dff9933e72a added parser for Session_Info;
wenzelm
parents: 48280
diff changeset
   160
        (keyword(OPTIONS) ~! options ^^ { case _ ~ x => x } | success(Nil)) ~
48347
8bb27ab9e841 more explicit treatment of initial Pure sessions;
wenzelm
parents: 48346
diff changeset
   161
        rep(theories) ~
48336
3c55bfad22eb more tight treatment of reset_name;
wenzelm
parents: 48335
diff changeset
   162
        (keyword(FILES) ~! rep1(path) ^^ { case _ ~ x => x } | success(Nil)) ^^
48349
a78e5d399599 support Session.Queue with ordering and dependencies;
wenzelm
parents: 48347
diff changeset
   163
          { case a ~ b ~ c ~ d ~ e ~ f ~ g ~ h ~ i => Session_Entry(a, b, c, d, e, f, g, h, i) }
48334
8dff9933e72a added parser for Session_Info;
wenzelm
parents: 48280
diff changeset
   164
    }
8dff9933e72a added parser for Session_Info;
wenzelm
parents: 48280
diff changeset
   165
48409
0d2114eb412a more explicit java.io.{File => JFile};
wenzelm
parents: 48373
diff changeset
   166
    def parse_entries(root: JFile): List[Session_Entry] =
48334
8dff9933e72a added parser for Session_Info;
wenzelm
parents: 48280
diff changeset
   167
    {
48411
5b3440850d36 more abstract file system operations in Scala, corresponding to ML version;
wenzelm
parents: 48409
diff changeset
   168
      val toks = syntax.scan(File.read(root))
48337
9c7f8e5805b4 cumulate semantic Session_Info, based on syntactic Session_Entry;
wenzelm
parents: 48336
diff changeset
   169
      parse_all(rep(session_entry), Token.reader(toks, root.toString)) match {
48334
8dff9933e72a added parser for Session_Info;
wenzelm
parents: 48280
diff changeset
   170
        case Success(result, _) => result
8dff9933e72a added parser for Session_Info;
wenzelm
parents: 48280
diff changeset
   171
        case bad => error(bad.toString)
8dff9933e72a added parser for Session_Info;
wenzelm
parents: 48280
diff changeset
   172
      }
8dff9933e72a added parser for Session_Info;
wenzelm
parents: 48280
diff changeset
   173
    }
8dff9933e72a added parser for Session_Info;
wenzelm
parents: 48280
diff changeset
   174
  }
48280
7d86239986c2 basic support for session ROOT files, with examples for FOL and ZF;
wenzelm
parents: 48276
diff changeset
   175
48337
9c7f8e5805b4 cumulate semantic Session_Info, based on syntactic Session_Entry;
wenzelm
parents: 48336
diff changeset
   176
48341
752de4e10162 tuned source structure;
wenzelm
parents: 48340
diff changeset
   177
  /* find sessions */
48337
9c7f8e5805b4 cumulate semantic Session_Info, based on syntactic Session_Entry;
wenzelm
parents: 48336
diff changeset
   178
48361
wenzelm
parents: 48354
diff changeset
   179
  private val ROOT = Path.explode("ROOT")
wenzelm
parents: 48354
diff changeset
   180
  private val SESSIONS = Path.explode("etc/sessions")
wenzelm
parents: 48354
diff changeset
   181
48364
9091b659d7b6 minimal build_job;
wenzelm
parents: 48363
diff changeset
   182
  private def is_pure(name: String): Boolean = name == "RAW" || name == "Pure"
9091b659d7b6 minimal build_job;
wenzelm
parents: 48363
diff changeset
   183
48421
c4d337782de4 propagate defined options;
wenzelm
parents: 48419
diff changeset
   184
  private def sessions_root(options: Options, dir: Path, root: JFile, queue: Session.Queue)
c4d337782de4 propagate defined options;
wenzelm
parents: 48419
diff changeset
   185
    : Session.Queue =
48280
7d86239986c2 basic support for session ROOT files, with examples for FOL and ZF;
wenzelm
parents: 48276
diff changeset
   186
  {
48361
wenzelm
parents: 48354
diff changeset
   187
    (queue /: Parser.parse_entries(root))((queue1, entry) =>
48337
9c7f8e5805b4 cumulate semantic Session_Info, based on syntactic Session_Entry;
wenzelm
parents: 48336
diff changeset
   188
      try {
48347
8bb27ab9e841 more explicit treatment of initial Pure sessions;
wenzelm
parents: 48346
diff changeset
   189
        if (entry.name == "") error("Bad session name")
8bb27ab9e841 more explicit treatment of initial Pure sessions;
wenzelm
parents: 48346
diff changeset
   190
48337
9c7f8e5805b4 cumulate semantic Session_Info, based on syntactic Session_Entry;
wenzelm
parents: 48336
diff changeset
   191
        val full_name =
48364
9091b659d7b6 minimal build_job;
wenzelm
parents: 48363
diff changeset
   192
          if (is_pure(entry.name)) {
48347
8bb27ab9e841 more explicit treatment of initial Pure sessions;
wenzelm
parents: 48346
diff changeset
   193
            if (entry.parent.isDefined) error("Illegal parent session")
8bb27ab9e841 more explicit treatment of initial Pure sessions;
wenzelm
parents: 48346
diff changeset
   194
            else entry.name
8bb27ab9e841 more explicit treatment of initial Pure sessions;
wenzelm
parents: 48346
diff changeset
   195
          }
8bb27ab9e841 more explicit treatment of initial Pure sessions;
wenzelm
parents: 48346
diff changeset
   196
          else
8bb27ab9e841 more explicit treatment of initial Pure sessions;
wenzelm
parents: 48346
diff changeset
   197
            entry.parent match {
48361
wenzelm
parents: 48354
diff changeset
   198
              case Some(parent_name) if queue1.defined(parent_name) =>
48462
424fd5364f15 clarified "this_name" vs. former "reset" feature -- imitate the latter by loading other session sources directly;
wenzelm
parents: 48459
diff changeset
   199
                if (entry.this_name) entry.name
48351
a0b95a762abb less redundant data structures;
wenzelm
parents: 48350
diff changeset
   200
                else parent_name + "-" + entry.name
a0b95a762abb less redundant data structures;
wenzelm
parents: 48350
diff changeset
   201
              case _ => error("Bad parent session")
48347
8bb27ab9e841 more explicit treatment of initial Pure sessions;
wenzelm
parents: 48346
diff changeset
   202
            }
48339
62570361e608 more errors;
wenzelm
parents: 48337
diff changeset
   203
48337
9c7f8e5805b4 cumulate semantic Session_Info, based on syntactic Session_Entry;
wenzelm
parents: 48336
diff changeset
   204
        val path =
9c7f8e5805b4 cumulate semantic Session_Info, based on syntactic Session_Entry;
wenzelm
parents: 48336
diff changeset
   205
          entry.path match {
9c7f8e5805b4 cumulate semantic Session_Info, based on syntactic Session_Entry;
wenzelm
parents: 48336
diff changeset
   206
            case Some(p) => Path.explode(p)
9c7f8e5805b4 cumulate semantic Session_Info, based on syntactic Session_Entry;
wenzelm
parents: 48336
diff changeset
   207
            case None => Path.basic(entry.name)
9c7f8e5805b4 cumulate semantic Session_Info, based on syntactic Session_Entry;
wenzelm
parents: 48336
diff changeset
   208
          }
48339
62570361e608 more errors;
wenzelm
parents: 48337
diff changeset
   209
48351
a0b95a762abb less redundant data structures;
wenzelm
parents: 48350
diff changeset
   210
        val key = Session.Key(full_name, entry.order)
48421
c4d337782de4 propagate defined options;
wenzelm
parents: 48419
diff changeset
   211
48467
a4318c36a829 more precise propagation of options: build, session, theories;
wenzelm
parents: 48462
diff changeset
   212
        val session_options = options ++ entry.options
a4318c36a829 more precise propagation of options: build, session, theories;
wenzelm
parents: 48462
diff changeset
   213
48421
c4d337782de4 propagate defined options;
wenzelm
parents: 48419
diff changeset
   214
        val theories =
48467
a4318c36a829 more precise propagation of options: build, session, theories;
wenzelm
parents: 48462
diff changeset
   215
          entry.theories.map({ case (opts, thys) =>
a4318c36a829 more precise propagation of options: build, session, theories;
wenzelm
parents: 48462
diff changeset
   216
            (session_options ++ opts, thys.map(Path.explode(_))) })
48421
c4d337782de4 propagate defined options;
wenzelm
parents: 48419
diff changeset
   217
        val files = entry.files.map(Path.explode(_))
48423
0ccf143a2a69 maintain set of source digests, including relevant parts of session entry;
wenzelm
parents: 48422
diff changeset
   218
        val digest = SHA1.digest((full_name, entry.parent, entry.options, entry.theories).toString)
0ccf143a2a69 maintain set of source digests, including relevant parts of session entry;
wenzelm
parents: 48422
diff changeset
   219
48418
1a634f9614fb some actual build function on ML side;
wenzelm
parents: 48411
diff changeset
   220
        val info =
48457
fd9e28d5a143 pass build options to ML;
wenzelm
parents: 48447
diff changeset
   221
          Session.Info(entry.name, dir + path, entry.parent,
48467
a4318c36a829 more precise propagation of options: build, session, theories;
wenzelm
parents: 48462
diff changeset
   222
            entry.description, session_options, theories, files, digest)
48351
a0b95a762abb less redundant data structures;
wenzelm
parents: 48350
diff changeset
   223
48418
1a634f9614fb some actual build function on ML side;
wenzelm
parents: 48411
diff changeset
   224
        queue1 + (key, info)
48337
9c7f8e5805b4 cumulate semantic Session_Info, based on syntactic Session_Entry;
wenzelm
parents: 48336
diff changeset
   225
      }
9c7f8e5805b4 cumulate semantic Session_Info, based on syntactic Session_Entry;
wenzelm
parents: 48336
diff changeset
   226
      catch {
9c7f8e5805b4 cumulate semantic Session_Info, based on syntactic Session_Entry;
wenzelm
parents: 48336
diff changeset
   227
        case ERROR(msg) =>
9c7f8e5805b4 cumulate semantic Session_Info, based on syntactic Session_Entry;
wenzelm
parents: 48336
diff changeset
   228
          error(msg + "\nThe error(s) above occurred in session entry " +
48370
d0fa3efec93b require explicit initialization of options;
wenzelm
parents: 48368
diff changeset
   229
            quote(entry.name) + Position.str_of(Position.file(root)))
48352
7fbf98ee265f include COMPONENT/etc/sessions as catalog for more directories, for improved scalability with hundreds of entries (notably AFP);
wenzelm
parents: 48351
diff changeset
   230
      })
7fbf98ee265f include COMPONENT/etc/sessions as catalog for more directories, for improved scalability with hundreds of entries (notably AFP);
wenzelm
parents: 48351
diff changeset
   231
  }
7fbf98ee265f include COMPONENT/etc/sessions as catalog for more directories, for improved scalability with hundreds of entries (notably AFP);
wenzelm
parents: 48351
diff changeset
   232
48421
c4d337782de4 propagate defined options;
wenzelm
parents: 48419
diff changeset
   233
  private def sessions_dir(options: Options, strict: Boolean, dir: Path, queue: Session.Queue)
c4d337782de4 propagate defined options;
wenzelm
parents: 48419
diff changeset
   234
    : Session.Queue =
48352
7fbf98ee265f include COMPONENT/etc/sessions as catalog for more directories, for improved scalability with hundreds of entries (notably AFP);
wenzelm
parents: 48351
diff changeset
   235
  {
48373
527e2bad7cca further imitation of "usedir" shell script;
wenzelm
parents: 48370
diff changeset
   236
    val root = (dir + ROOT).file
48421
c4d337782de4 propagate defined options;
wenzelm
parents: 48419
diff changeset
   237
    if (root.isFile) sessions_root(options, dir, root, queue)
48352
7fbf98ee265f include COMPONENT/etc/sessions as catalog for more directories, for improved scalability with hundreds of entries (notably AFP);
wenzelm
parents: 48351
diff changeset
   238
    else if (strict) error("Bad session root file: " + quote(root.toString))
48361
wenzelm
parents: 48354
diff changeset
   239
    else queue
48352
7fbf98ee265f include COMPONENT/etc/sessions as catalog for more directories, for improved scalability with hundreds of entries (notably AFP);
wenzelm
parents: 48351
diff changeset
   240
  }
7fbf98ee265f include COMPONENT/etc/sessions as catalog for more directories, for improved scalability with hundreds of entries (notably AFP);
wenzelm
parents: 48351
diff changeset
   241
48421
c4d337782de4 propagate defined options;
wenzelm
parents: 48419
diff changeset
   242
  private def sessions_catalog(options: Options, dir: Path, catalog: JFile, queue: Session.Queue)
c4d337782de4 propagate defined options;
wenzelm
parents: 48419
diff changeset
   243
    : Session.Queue =
48352
7fbf98ee265f include COMPONENT/etc/sessions as catalog for more directories, for improved scalability with hundreds of entries (notably AFP);
wenzelm
parents: 48351
diff changeset
   244
  {
48354
aa1e730c3fdd allow catalog entries to be commented-out;
wenzelm
parents: 48352
diff changeset
   245
    val dirs =
48411
5b3440850d36 more abstract file system operations in Scala, corresponding to ML version;
wenzelm
parents: 48409
diff changeset
   246
      split_lines(File.read(catalog)).filterNot(line => line == "" || line.startsWith("#"))
48361
wenzelm
parents: 48354
diff changeset
   247
    (queue /: dirs)((queue1, dir1) =>
48352
7fbf98ee265f include COMPONENT/etc/sessions as catalog for more directories, for improved scalability with hundreds of entries (notably AFP);
wenzelm
parents: 48351
diff changeset
   248
      try {
7fbf98ee265f include COMPONENT/etc/sessions as catalog for more directories, for improved scalability with hundreds of entries (notably AFP);
wenzelm
parents: 48351
diff changeset
   249
        val dir2 = dir + Path.explode(dir1)
48421
c4d337782de4 propagate defined options;
wenzelm
parents: 48419
diff changeset
   250
        if (dir2.file.isDirectory) sessions_dir(options, true, dir2, queue1)
48352
7fbf98ee265f include COMPONENT/etc/sessions as catalog for more directories, for improved scalability with hundreds of entries (notably AFP);
wenzelm
parents: 48351
diff changeset
   251
        else error("Bad session directory: " + dir2.toString)
48337
9c7f8e5805b4 cumulate semantic Session_Info, based on syntactic Session_Entry;
wenzelm
parents: 48336
diff changeset
   252
      }
48352
7fbf98ee265f include COMPONENT/etc/sessions as catalog for more directories, for improved scalability with hundreds of entries (notably AFP);
wenzelm
parents: 48351
diff changeset
   253
      catch {
7fbf98ee265f include COMPONENT/etc/sessions as catalog for more directories, for improved scalability with hundreds of entries (notably AFP);
wenzelm
parents: 48351
diff changeset
   254
        case ERROR(msg) =>
7fbf98ee265f include COMPONENT/etc/sessions as catalog for more directories, for improved scalability with hundreds of entries (notably AFP);
wenzelm
parents: 48351
diff changeset
   255
          error(msg + "\nThe error(s) above occurred in session catalog " + quote(catalog.toString))
7fbf98ee265f include COMPONENT/etc/sessions as catalog for more directories, for improved scalability with hundreds of entries (notably AFP);
wenzelm
parents: 48351
diff changeset
   256
      })
7fbf98ee265f include COMPONENT/etc/sessions as catalog for more directories, for improved scalability with hundreds of entries (notably AFP);
wenzelm
parents: 48351
diff changeset
   257
  }
7fbf98ee265f include COMPONENT/etc/sessions as catalog for more directories, for improved scalability with hundreds of entries (notably AFP);
wenzelm
parents: 48351
diff changeset
   258
48421
c4d337782de4 propagate defined options;
wenzelm
parents: 48419
diff changeset
   259
  def find_sessions(options: Options, all_sessions: Boolean, sessions: List[String],
48419
6d7b6e47f3ef save image for inner nodes only;
wenzelm
parents: 48418
diff changeset
   260
    more_dirs: List[Path]): Session.Queue =
48352
7fbf98ee265f include COMPONENT/etc/sessions as catalog for more directories, for improved scalability with hundreds of entries (notably AFP);
wenzelm
parents: 48351
diff changeset
   261
  {
48361
wenzelm
parents: 48354
diff changeset
   262
    var queue = Session.Queue.empty
48352
7fbf98ee265f include COMPONENT/etc/sessions as catalog for more directories, for improved scalability with hundreds of entries (notably AFP);
wenzelm
parents: 48351
diff changeset
   263
7fbf98ee265f include COMPONENT/etc/sessions as catalog for more directories, for improved scalability with hundreds of entries (notably AFP);
wenzelm
parents: 48351
diff changeset
   264
    for (dir <- Isabelle_System.components()) {
48421
c4d337782de4 propagate defined options;
wenzelm
parents: 48419
diff changeset
   265
      queue = sessions_dir(options, false, dir, queue)
48352
7fbf98ee265f include COMPONENT/etc/sessions as catalog for more directories, for improved scalability with hundreds of entries (notably AFP);
wenzelm
parents: 48351
diff changeset
   266
48373
527e2bad7cca further imitation of "usedir" shell script;
wenzelm
parents: 48370
diff changeset
   267
      val catalog = (dir + SESSIONS).file
48352
7fbf98ee265f include COMPONENT/etc/sessions as catalog for more directories, for improved scalability with hundreds of entries (notably AFP);
wenzelm
parents: 48351
diff changeset
   268
      if (catalog.isFile)
48421
c4d337782de4 propagate defined options;
wenzelm
parents: 48419
diff changeset
   269
        queue = sessions_catalog(options, dir, catalog, queue)
48337
9c7f8e5805b4 cumulate semantic Session_Info, based on syntactic Session_Entry;
wenzelm
parents: 48336
diff changeset
   270
    }
48352
7fbf98ee265f include COMPONENT/etc/sessions as catalog for more directories, for improved scalability with hundreds of entries (notably AFP);
wenzelm
parents: 48351
diff changeset
   271
48421
c4d337782de4 propagate defined options;
wenzelm
parents: 48419
diff changeset
   272
    for (dir <- more_dirs) queue = sessions_dir(options, true, dir, queue)
48352
7fbf98ee265f include COMPONENT/etc/sessions as catalog for more directories, for improved scalability with hundreds of entries (notably AFP);
wenzelm
parents: 48351
diff changeset
   273
48419
6d7b6e47f3ef save image for inner nodes only;
wenzelm
parents: 48418
diff changeset
   274
    sessions.filter(name => !queue.defined(name)) match {
6d7b6e47f3ef save image for inner nodes only;
wenzelm
parents: 48418
diff changeset
   275
      case Nil =>
6d7b6e47f3ef save image for inner nodes only;
wenzelm
parents: 48418
diff changeset
   276
      case bad => error("Undefined session(s): " + commas_quote(bad))
6d7b6e47f3ef save image for inner nodes only;
wenzelm
parents: 48418
diff changeset
   277
    }
6d7b6e47f3ef save image for inner nodes only;
wenzelm
parents: 48418
diff changeset
   278
6d7b6e47f3ef save image for inner nodes only;
wenzelm
parents: 48418
diff changeset
   279
    if (all_sessions) queue else queue.required(sessions)
48280
7d86239986c2 basic support for session ROOT files, with examples for FOL and ZF;
wenzelm
parents: 48276
diff changeset
   280
  }
48341
752de4e10162 tuned source structure;
wenzelm
parents: 48340
diff changeset
   281
752de4e10162 tuned source structure;
wenzelm
parents: 48340
diff changeset
   282
48424
wenzelm
parents: 48423
diff changeset
   283
wenzelm
parents: 48423
diff changeset
   284
  /** build **/
wenzelm
parents: 48423
diff changeset
   285
48422
9613780a805b determine source dependencies, relatively to preloaded theories;
wenzelm
parents: 48421
diff changeset
   286
  /* dependencies */
9613780a805b determine source dependencies, relatively to preloaded theories;
wenzelm
parents: 48421
diff changeset
   287
9613780a805b determine source dependencies, relatively to preloaded theories;
wenzelm
parents: 48421
diff changeset
   288
  sealed case class Node(
9613780a805b determine source dependencies, relatively to preloaded theories;
wenzelm
parents: 48421
diff changeset
   289
    loaded_theories: Set[String],
48423
0ccf143a2a69 maintain set of source digests, including relevant parts of session entry;
wenzelm
parents: 48422
diff changeset
   290
    sources: List[(Path, SHA1.Digest)])
48422
9613780a805b determine source dependencies, relatively to preloaded theories;
wenzelm
parents: 48421
diff changeset
   291
48423
0ccf143a2a69 maintain set of source digests, including relevant parts of session entry;
wenzelm
parents: 48422
diff changeset
   292
  sealed case class Deps(deps: Map[String, Node])
0ccf143a2a69 maintain set of source digests, including relevant parts of session entry;
wenzelm
parents: 48422
diff changeset
   293
  {
0ccf143a2a69 maintain set of source digests, including relevant parts of session entry;
wenzelm
parents: 48422
diff changeset
   294
    def sources(name: String): List[(Path, SHA1.Digest)] = deps(name).sources
0ccf143a2a69 maintain set of source digests, including relevant parts of session entry;
wenzelm
parents: 48422
diff changeset
   295
  }
0ccf143a2a69 maintain set of source digests, including relevant parts of session entry;
wenzelm
parents: 48422
diff changeset
   296
0ccf143a2a69 maintain set of source digests, including relevant parts of session entry;
wenzelm
parents: 48422
diff changeset
   297
  def dependencies(queue: Session.Queue): Deps =
0ccf143a2a69 maintain set of source digests, including relevant parts of session entry;
wenzelm
parents: 48422
diff changeset
   298
    Deps((Map.empty[String, Node] /: queue.topological_order)(
48422
9613780a805b determine source dependencies, relatively to preloaded theories;
wenzelm
parents: 48421
diff changeset
   299
      { case (deps, (name, info)) =>
9613780a805b determine source dependencies, relatively to preloaded theories;
wenzelm
parents: 48421
diff changeset
   300
          val preloaded =
9613780a805b determine source dependencies, relatively to preloaded theories;
wenzelm
parents: 48421
diff changeset
   301
            info.parent match {
9613780a805b determine source dependencies, relatively to preloaded theories;
wenzelm
parents: 48421
diff changeset
   302
              case None => Set.empty[String]
9613780a805b determine source dependencies, relatively to preloaded theories;
wenzelm
parents: 48421
diff changeset
   303
              case Some(parent) => deps(parent).loaded_theories
9613780a805b determine source dependencies, relatively to preloaded theories;
wenzelm
parents: 48421
diff changeset
   304
            }
9613780a805b determine source dependencies, relatively to preloaded theories;
wenzelm
parents: 48421
diff changeset
   305
          val thy_info = new Thy_Info(new Thy_Load(preloaded))
9613780a805b determine source dependencies, relatively to preloaded theories;
wenzelm
parents: 48421
diff changeset
   306
9613780a805b determine source dependencies, relatively to preloaded theories;
wenzelm
parents: 48421
diff changeset
   307
          val thy_deps =
9613780a805b determine source dependencies, relatively to preloaded theories;
wenzelm
parents: 48421
diff changeset
   308
            thy_info.dependencies(
9613780a805b determine source dependencies, relatively to preloaded theories;
wenzelm
parents: 48421
diff changeset
   309
              info.theories.map(_._2).flatten.
9613780a805b determine source dependencies, relatively to preloaded theories;
wenzelm
parents: 48421
diff changeset
   310
                map(thy => Document.Node.Name(info.dir + Thy_Load.thy_path(thy))))
9613780a805b determine source dependencies, relatively to preloaded theories;
wenzelm
parents: 48421
diff changeset
   311
9613780a805b determine source dependencies, relatively to preloaded theories;
wenzelm
parents: 48421
diff changeset
   312
          val loaded_theories = preloaded ++ thy_deps.map(_._1.theory)
48423
0ccf143a2a69 maintain set of source digests, including relevant parts of session entry;
wenzelm
parents: 48422
diff changeset
   313
0ccf143a2a69 maintain set of source digests, including relevant parts of session entry;
wenzelm
parents: 48422
diff changeset
   314
          val all_files =
48422
9613780a805b determine source dependencies, relatively to preloaded theories;
wenzelm
parents: 48421
diff changeset
   315
            thy_deps.map({ case (n, h) =>
9613780a805b determine source dependencies, relatively to preloaded theories;
wenzelm
parents: 48421
diff changeset
   316
              val thy = Path.explode(n.node).expand
9613780a805b determine source dependencies, relatively to preloaded theories;
wenzelm
parents: 48421
diff changeset
   317
              val uses =
9613780a805b determine source dependencies, relatively to preloaded theories;
wenzelm
parents: 48421
diff changeset
   318
                h match {
9613780a805b determine source dependencies, relatively to preloaded theories;
wenzelm
parents: 48421
diff changeset
   319
                  case Exn.Res(d) =>
9613780a805b determine source dependencies, relatively to preloaded theories;
wenzelm
parents: 48421
diff changeset
   320
                    d.uses.map(p => (Path.explode(n.dir) + Path.explode(p._1)).expand)
9613780a805b determine source dependencies, relatively to preloaded theories;
wenzelm
parents: 48421
diff changeset
   321
                  case _ => Nil
9613780a805b determine source dependencies, relatively to preloaded theories;
wenzelm
parents: 48421
diff changeset
   322
                }
9613780a805b determine source dependencies, relatively to preloaded theories;
wenzelm
parents: 48421
diff changeset
   323
              thy :: uses
9613780a805b determine source dependencies, relatively to preloaded theories;
wenzelm
parents: 48421
diff changeset
   324
            }).flatten ::: info.files.map(file => info.dir + file)
48423
0ccf143a2a69 maintain set of source digests, including relevant parts of session entry;
wenzelm
parents: 48422
diff changeset
   325
          val sources = all_files.par.map(p => (p, SHA1.digest(p))).toList
48422
9613780a805b determine source dependencies, relatively to preloaded theories;
wenzelm
parents: 48421
diff changeset
   326
9613780a805b determine source dependencies, relatively to preloaded theories;
wenzelm
parents: 48421
diff changeset
   327
          deps + (name -> Node(loaded_theories, sources))
48423
0ccf143a2a69 maintain set of source digests, including relevant parts of session entry;
wenzelm
parents: 48422
diff changeset
   328
      }))
48422
9613780a805b determine source dependencies, relatively to preloaded theories;
wenzelm
parents: 48421
diff changeset
   329
9613780a805b determine source dependencies, relatively to preloaded theories;
wenzelm
parents: 48421
diff changeset
   330
48424
wenzelm
parents: 48423
diff changeset
   331
  /* jobs */
48341
752de4e10162 tuned source structure;
wenzelm
parents: 48340
diff changeset
   332
48424
wenzelm
parents: 48423
diff changeset
   333
  private class Job(cwd: JFile, env: Map[String, String], script: String, args: String)
48364
9091b659d7b6 minimal build_job;
wenzelm
parents: 48363
diff changeset
   334
  {
48418
1a634f9614fb some actual build function on ML side;
wenzelm
parents: 48411
diff changeset
   335
    private val args_file = File.tmp_file("args")
1a634f9614fb some actual build function on ML side;
wenzelm
parents: 48411
diff changeset
   336
    private val env1 = env + ("ARGS_FILE" -> Isabelle_System.posix_path(args_file.getPath))
1a634f9614fb some actual build function on ML side;
wenzelm
parents: 48411
diff changeset
   337
    File.write(args_file, args)
1a634f9614fb some actual build function on ML side;
wenzelm
parents: 48411
diff changeset
   338
48424
wenzelm
parents: 48423
diff changeset
   339
    private val (thread, result) =
wenzelm
parents: 48423
diff changeset
   340
      Simple_Thread.future("build") { Isabelle_System.bash_env(cwd, env1, script) }
48418
1a634f9614fb some actual build function on ML side;
wenzelm
parents: 48411
diff changeset
   341
1a634f9614fb some actual build function on ML side;
wenzelm
parents: 48411
diff changeset
   342
    def terminate: Unit = thread.interrupt
1a634f9614fb some actual build function on ML side;
wenzelm
parents: 48411
diff changeset
   343
    def is_finished: Boolean = result.is_finished
48425
0d95980e9aae parallel scheduling of jobs;
wenzelm
parents: 48424
diff changeset
   344
    def join: (String, String, Int) = { val res = result.join; args_file.delete; res }
48418
1a634f9614fb some actual build function on ML side;
wenzelm
parents: 48411
diff changeset
   345
  }
1a634f9614fb some actual build function on ML side;
wenzelm
parents: 48411
diff changeset
   346
48457
fd9e28d5a143 pass build options to ML;
wenzelm
parents: 48447
diff changeset
   347
  private def start_job(name: String, info: Session.Info, output: Option[String],
48459
375e45df6fdf timing is command line options, not system option;
wenzelm
parents: 48457
diff changeset
   348
    options: Options, timing: Boolean, verbose: Boolean, browser_info: Path): Job =
48418
1a634f9614fb some actual build function on ML side;
wenzelm
parents: 48411
diff changeset
   349
  {
48467
a4318c36a829 more precise propagation of options: build, session, theories;
wenzelm
parents: 48462
diff changeset
   350
    // global browser info dir
a4318c36a829 more precise propagation of options: build, session, theories;
wenzelm
parents: 48462
diff changeset
   351
    if (options.bool("browser_info") && !(browser_info + Path.explode("index.html")).file.isFile)
a4318c36a829 more precise propagation of options: build, session, theories;
wenzelm
parents: 48462
diff changeset
   352
    {
a4318c36a829 more precise propagation of options: build, session, theories;
wenzelm
parents: 48462
diff changeset
   353
      browser_info.file.mkdirs()
a4318c36a829 more precise propagation of options: build, session, theories;
wenzelm
parents: 48462
diff changeset
   354
      File.copy(Path.explode("~~/lib/logo/isabelle.gif"),
a4318c36a829 more precise propagation of options: build, session, theories;
wenzelm
parents: 48462
diff changeset
   355
        browser_info + Path.explode("isabelle.gif"))
a4318c36a829 more precise propagation of options: build, session, theories;
wenzelm
parents: 48462
diff changeset
   356
      File.write(browser_info + Path.explode("index.html"),
a4318c36a829 more precise propagation of options: build, session, theories;
wenzelm
parents: 48462
diff changeset
   357
        File.read(Path.explode("~~/lib/html/library_index_header.template")) +
a4318c36a829 more precise propagation of options: build, session, theories;
wenzelm
parents: 48462
diff changeset
   358
        File.read(Path.explode("~~/lib/html/library_index_content.template")) +
a4318c36a829 more precise propagation of options: build, session, theories;
wenzelm
parents: 48462
diff changeset
   359
        File.read(Path.explode("~~/lib/html/library_index_footer.template")))
a4318c36a829 more precise propagation of options: build, session, theories;
wenzelm
parents: 48462
diff changeset
   360
    }
a4318c36a829 more precise propagation of options: build, session, theories;
wenzelm
parents: 48462
diff changeset
   361
48418
1a634f9614fb some actual build function on ML side;
wenzelm
parents: 48411
diff changeset
   362
    val parent = info.parent.getOrElse("")
1a634f9614fb some actual build function on ML side;
wenzelm
parents: 48411
diff changeset
   363
48373
527e2bad7cca further imitation of "usedir" shell script;
wenzelm
parents: 48370
diff changeset
   364
    val cwd = info.dir.file
48447
ef600ce4559c added system build mode: produce output in ISABELLE_HOME;
wenzelm
parents: 48425
diff changeset
   365
    val env = Map("INPUT" -> parent, "TARGET" -> name, "OUTPUT" -> output.getOrElse(""))
48364
9091b659d7b6 minimal build_job;
wenzelm
parents: 48363
diff changeset
   366
    val script =
48447
ef600ce4559c added system build mode: produce output in ISABELLE_HOME;
wenzelm
parents: 48425
diff changeset
   367
      if (is_pure(name)) "./build " + name + " \"$OUTPUT\""
48418
1a634f9614fb some actual build function on ML side;
wenzelm
parents: 48411
diff changeset
   368
      else {
1a634f9614fb some actual build function on ML side;
wenzelm
parents: 48411
diff changeset
   369
        """
1a634f9614fb some actual build function on ML side;
wenzelm
parents: 48411
diff changeset
   370
        . "$ISABELLE_HOME/lib/scripts/timestart.bash"
1a634f9614fb some actual build function on ML side;
wenzelm
parents: 48411
diff changeset
   371
        """ +
48447
ef600ce4559c added system build mode: produce output in ISABELLE_HOME;
wenzelm
parents: 48425
diff changeset
   372
          (if (output.isDefined)
ef600ce4559c added system build mode: produce output in ISABELLE_HOME;
wenzelm
parents: 48425
diff changeset
   373
            """ "$ISABELLE_PROCESS" -e "Build.build \"$ARGS_FILE\";" -q -w "$INPUT" "$OUTPUT" """
48418
1a634f9614fb some actual build function on ML side;
wenzelm
parents: 48411
diff changeset
   374
          else
1a634f9614fb some actual build function on ML side;
wenzelm
parents: 48411
diff changeset
   375
            """ "$ISABELLE_PROCESS" -e "Build.build \"$ARGS_FILE\";" -r -q "$INPUT" """) +
1a634f9614fb some actual build function on ML side;
wenzelm
parents: 48411
diff changeset
   376
        """
1a634f9614fb some actual build function on ML side;
wenzelm
parents: 48411
diff changeset
   377
        RC="$?"
1a634f9614fb some actual build function on ML side;
wenzelm
parents: 48411
diff changeset
   378
1a634f9614fb some actual build function on ML side;
wenzelm
parents: 48411
diff changeset
   379
        . "$ISABELLE_HOME/lib/scripts/timestop.bash"
1a634f9614fb some actual build function on ML side;
wenzelm
parents: 48411
diff changeset
   380
1a634f9614fb some actual build function on ML side;
wenzelm
parents: 48411
diff changeset
   381
        if [ "$RC" -eq 0 ]; then
1a634f9614fb some actual build function on ML side;
wenzelm
parents: 48411
diff changeset
   382
          echo "Finished $TARGET ($TIMES_REPORT)" >&2
1a634f9614fb some actual build function on ML side;
wenzelm
parents: 48411
diff changeset
   383
        fi
1a634f9614fb some actual build function on ML side;
wenzelm
parents: 48411
diff changeset
   384
1a634f9614fb some actual build function on ML side;
wenzelm
parents: 48411
diff changeset
   385
        exit "$RC"
1a634f9614fb some actual build function on ML side;
wenzelm
parents: 48411
diff changeset
   386
        """
1a634f9614fb some actual build function on ML side;
wenzelm
parents: 48411
diff changeset
   387
      }
1a634f9614fb some actual build function on ML side;
wenzelm
parents: 48411
diff changeset
   388
    val args_xml =
1a634f9614fb some actual build function on ML side;
wenzelm
parents: 48411
diff changeset
   389
    {
1a634f9614fb some actual build function on ML side;
wenzelm
parents: 48411
diff changeset
   390
      import XML.Encode._
48459
375e45df6fdf timing is command line options, not system option;
wenzelm
parents: 48457
diff changeset
   391
          pair(bool, pair(Options.encode, pair(bool, pair(bool, pair(Path.encode, pair(string,
375e45df6fdf timing is command line options, not system option;
wenzelm
parents: 48457
diff changeset
   392
            pair(string, pair(string, list(pair(Options.encode, list(Path.encode)))))))))))(
375e45df6fdf timing is command line options, not system option;
wenzelm
parents: 48457
diff changeset
   393
          (output.isDefined, (options, (timing, (verbose, (browser_info, (parent,
375e45df6fdf timing is command line options, not system option;
wenzelm
parents: 48457
diff changeset
   394
            (name, (info.base_name, info.theories)))))))))
48418
1a634f9614fb some actual build function on ML side;
wenzelm
parents: 48411
diff changeset
   395
    }
48424
wenzelm
parents: 48423
diff changeset
   396
    new Job(cwd, env, script, YXML.string_of_body(args_xml))
48364
9091b659d7b6 minimal build_job;
wenzelm
parents: 48363
diff changeset
   397
  }
9091b659d7b6 minimal build_job;
wenzelm
parents: 48363
diff changeset
   398
48424
wenzelm
parents: 48423
diff changeset
   399
48425
0d95980e9aae parallel scheduling of jobs;
wenzelm
parents: 48424
diff changeset
   400
  /* build */
48424
wenzelm
parents: 48423
diff changeset
   401
wenzelm
parents: 48423
diff changeset
   402
  private def echo(msg: String) { java.lang.System.out.println(msg) }
48425
0d95980e9aae parallel scheduling of jobs;
wenzelm
parents: 48424
diff changeset
   403
  private def sleep(): Unit = Thread.sleep(500)
48424
wenzelm
parents: 48423
diff changeset
   404
48425
0d95980e9aae parallel scheduling of jobs;
wenzelm
parents: 48424
diff changeset
   405
  def build(all_sessions: Boolean, build_images: Boolean, max_jobs: Int,
48459
375e45df6fdf timing is command line options, not system option;
wenzelm
parents: 48457
diff changeset
   406
    list_only: Boolean, system_mode: Boolean, timing: Boolean, verbose: Boolean,
48419
6d7b6e47f3ef save image for inner nodes only;
wenzelm
parents: 48418
diff changeset
   407
    more_dirs: List[Path], more_options: List[String], sessions: List[String]): Int =
48341
752de4e10162 tuned source structure;
wenzelm
parents: 48340
diff changeset
   408
  {
48419
6d7b6e47f3ef save image for inner nodes only;
wenzelm
parents: 48418
diff changeset
   409
    val options = (Options.init() /: more_options)(_.define_simple(_))
48421
c4d337782de4 propagate defined options;
wenzelm
parents: 48419
diff changeset
   410
    val queue = find_sessions(options, all_sessions, sessions, more_dirs)
48423
0ccf143a2a69 maintain set of source digests, including relevant parts of session entry;
wenzelm
parents: 48422
diff changeset
   411
    val deps = dependencies(queue)
48368
dc538eef2cf2 define build_options from command line;
wenzelm
parents: 48364
diff changeset
   412
48447
ef600ce4559c added system build mode: produce output in ISABELLE_HOME;
wenzelm
parents: 48425
diff changeset
   413
    val (output_dir, browser_info) =
ef600ce4559c added system build mode: produce output in ISABELLE_HOME;
wenzelm
parents: 48425
diff changeset
   414
      if (system_mode) (Path.explode("~~/heaps/$ML_IDENTIFIER"), Path.explode("~~/browser_info"))
ef600ce4559c added system build mode: produce output in ISABELLE_HOME;
wenzelm
parents: 48425
diff changeset
   415
      else (Path.explode("$ISABELLE_OUTPUT"), Path.explode("$ISABELLE_BROWSER_INFO"))
48363
cf081b7042d2 restrict to required sessions;
wenzelm
parents: 48361
diff changeset
   416
48373
527e2bad7cca further imitation of "usedir" shell script;
wenzelm
parents: 48370
diff changeset
   417
    // prepare log dir
48447
ef600ce4559c added system build mode: produce output in ISABELLE_HOME;
wenzelm
parents: 48425
diff changeset
   418
    val log_dir = output_dir + Path.explode("log")
48373
527e2bad7cca further imitation of "usedir" shell script;
wenzelm
parents: 48370
diff changeset
   419
    log_dir.file.mkdirs()
527e2bad7cca further imitation of "usedir" shell script;
wenzelm
parents: 48370
diff changeset
   420
48425
0d95980e9aae parallel scheduling of jobs;
wenzelm
parents: 48424
diff changeset
   421
    // scheduler loop
0d95980e9aae parallel scheduling of jobs;
wenzelm
parents: 48424
diff changeset
   422
    @tailrec def loop(
0d95980e9aae parallel scheduling of jobs;
wenzelm
parents: 48424
diff changeset
   423
      pending: Session.Queue,
0d95980e9aae parallel scheduling of jobs;
wenzelm
parents: 48424
diff changeset
   424
      running: Map[String, Job],
0d95980e9aae parallel scheduling of jobs;
wenzelm
parents: 48424
diff changeset
   425
      results: Map[String, Int]): Map[String, Int] =
0d95980e9aae parallel scheduling of jobs;
wenzelm
parents: 48424
diff changeset
   426
    {
0d95980e9aae parallel scheduling of jobs;
wenzelm
parents: 48424
diff changeset
   427
      if (pending.is_empty) results
0d95980e9aae parallel scheduling of jobs;
wenzelm
parents: 48424
diff changeset
   428
      else if (running.exists({ case (_, job) => job.is_finished })) {
0d95980e9aae parallel scheduling of jobs;
wenzelm
parents: 48424
diff changeset
   429
        val (name, job) = running.find({ case (_, job) => job.is_finished }).get
48424
wenzelm
parents: 48423
diff changeset
   430
48425
0d95980e9aae parallel scheduling of jobs;
wenzelm
parents: 48424
diff changeset
   431
        val (out, err, rc) = job.join
0d95980e9aae parallel scheduling of jobs;
wenzelm
parents: 48424
diff changeset
   432
        echo(Library.trim_line(err))
48373
527e2bad7cca further imitation of "usedir" shell script;
wenzelm
parents: 48370
diff changeset
   433
48425
0d95980e9aae parallel scheduling of jobs;
wenzelm
parents: 48424
diff changeset
   434
        val log = log_dir + Path.basic(name)
0d95980e9aae parallel scheduling of jobs;
wenzelm
parents: 48424
diff changeset
   435
        if (rc == 0) {
0d95980e9aae parallel scheduling of jobs;
wenzelm
parents: 48424
diff changeset
   436
          val sources =
0d95980e9aae parallel scheduling of jobs;
wenzelm
parents: 48424
diff changeset
   437
            (queue(name).digest :: deps.sources(name).map(_._2)).map(_.toString).sorted
0d95980e9aae parallel scheduling of jobs;
wenzelm
parents: 48424
diff changeset
   438
              .mkString("sources: ", " ", "\n")
0d95980e9aae parallel scheduling of jobs;
wenzelm
parents: 48424
diff changeset
   439
          File.write_zip(log.ext("gz"), sources + out)
0d95980e9aae parallel scheduling of jobs;
wenzelm
parents: 48424
diff changeset
   440
        }
0d95980e9aae parallel scheduling of jobs;
wenzelm
parents: 48424
diff changeset
   441
        else {
0d95980e9aae parallel scheduling of jobs;
wenzelm
parents: 48424
diff changeset
   442
          File.write(log, out)
0d95980e9aae parallel scheduling of jobs;
wenzelm
parents: 48424
diff changeset
   443
          echo(name + " FAILED")
0d95980e9aae parallel scheduling of jobs;
wenzelm
parents: 48424
diff changeset
   444
          echo("(see also " + log.file + ")")
0d95980e9aae parallel scheduling of jobs;
wenzelm
parents: 48424
diff changeset
   445
          val lines = split_lines(out)
0d95980e9aae parallel scheduling of jobs;
wenzelm
parents: 48424
diff changeset
   446
          val tail = lines.drop(lines.length - 20 max 0)
0d95980e9aae parallel scheduling of jobs;
wenzelm
parents: 48424
diff changeset
   447
          echo("\n" + cat_lines(tail))
0d95980e9aae parallel scheduling of jobs;
wenzelm
parents: 48424
diff changeset
   448
        }
0d95980e9aae parallel scheduling of jobs;
wenzelm
parents: 48424
diff changeset
   449
        loop(pending - name, running - name, results + (name -> rc))
0d95980e9aae parallel scheduling of jobs;
wenzelm
parents: 48424
diff changeset
   450
      }
0d95980e9aae parallel scheduling of jobs;
wenzelm
parents: 48424
diff changeset
   451
      else if (running.size < (max_jobs max 1)) {
0d95980e9aae parallel scheduling of jobs;
wenzelm
parents: 48424
diff changeset
   452
        pending.dequeue(running.isDefinedAt(_)) match {
0d95980e9aae parallel scheduling of jobs;
wenzelm
parents: 48424
diff changeset
   453
          case Some((name, info)) =>
0d95980e9aae parallel scheduling of jobs;
wenzelm
parents: 48424
diff changeset
   454
            if (list_only) {
0d95980e9aae parallel scheduling of jobs;
wenzelm
parents: 48424
diff changeset
   455
              echo(name + " in " + info.dir)
0d95980e9aae parallel scheduling of jobs;
wenzelm
parents: 48424
diff changeset
   456
              loop(pending - name, running, results + (name -> 0))
0d95980e9aae parallel scheduling of jobs;
wenzelm
parents: 48424
diff changeset
   457
            }
0d95980e9aae parallel scheduling of jobs;
wenzelm
parents: 48424
diff changeset
   458
            else if (info.parent.map(results(_)).forall(_ == 0)) {
48447
ef600ce4559c added system build mode: produce output in ISABELLE_HOME;
wenzelm
parents: 48425
diff changeset
   459
              val output =
ef600ce4559c added system build mode: produce output in ISABELLE_HOME;
wenzelm
parents: 48425
diff changeset
   460
                if (build_images || queue.is_inner(name))
ef600ce4559c added system build mode: produce output in ISABELLE_HOME;
wenzelm
parents: 48425
diff changeset
   461
                  Some(Isabelle_System.standard_path(output_dir + Path.basic(name)))
ef600ce4559c added system build mode: produce output in ISABELLE_HOME;
wenzelm
parents: 48425
diff changeset
   462
                else None
ef600ce4559c added system build mode: produce output in ISABELLE_HOME;
wenzelm
parents: 48425
diff changeset
   463
              echo((if (output.isDefined) "Building " else "Running ") + name + " ...")
48467
a4318c36a829 more precise propagation of options: build, session, theories;
wenzelm
parents: 48462
diff changeset
   464
              val job = start_job(name, info, output, info.options, timing, verbose, browser_info)
48425
0d95980e9aae parallel scheduling of jobs;
wenzelm
parents: 48424
diff changeset
   465
              loop(pending, running + (name -> job), results)
0d95980e9aae parallel scheduling of jobs;
wenzelm
parents: 48424
diff changeset
   466
            }
0d95980e9aae parallel scheduling of jobs;
wenzelm
parents: 48424
diff changeset
   467
            else {
0d95980e9aae parallel scheduling of jobs;
wenzelm
parents: 48424
diff changeset
   468
              echo(name + " CANCELLED")
0d95980e9aae parallel scheduling of jobs;
wenzelm
parents: 48424
diff changeset
   469
              loop(pending - name, running, results + (name -> 1))
0d95980e9aae parallel scheduling of jobs;
wenzelm
parents: 48424
diff changeset
   470
            }
0d95980e9aae parallel scheduling of jobs;
wenzelm
parents: 48424
diff changeset
   471
          case None => sleep(); loop(pending, running, results)
48373
527e2bad7cca further imitation of "usedir" shell script;
wenzelm
parents: 48370
diff changeset
   472
        }
527e2bad7cca further imitation of "usedir" shell script;
wenzelm
parents: 48370
diff changeset
   473
      }
48425
0d95980e9aae parallel scheduling of jobs;
wenzelm
parents: 48424
diff changeset
   474
      else { sleep(); loop(pending, running, results) }
0d95980e9aae parallel scheduling of jobs;
wenzelm
parents: 48424
diff changeset
   475
    }
0d95980e9aae parallel scheduling of jobs;
wenzelm
parents: 48424
diff changeset
   476
0d95980e9aae parallel scheduling of jobs;
wenzelm
parents: 48424
diff changeset
   477
    (0 /: loop(queue, Map.empty, Map.empty))({ case (rc1, (_, rc2)) => rc1 max rc2 })
48341
752de4e10162 tuned source structure;
wenzelm
parents: 48340
diff changeset
   478
  }
752de4e10162 tuned source structure;
wenzelm
parents: 48340
diff changeset
   479
752de4e10162 tuned source structure;
wenzelm
parents: 48340
diff changeset
   480
48346
e2382bede914 more general support for Isabelle/Scala command line tools;
wenzelm
parents: 48344
diff changeset
   481
  /* command line entry point */
48341
752de4e10162 tuned source structure;
wenzelm
parents: 48340
diff changeset
   482
752de4e10162 tuned source structure;
wenzelm
parents: 48340
diff changeset
   483
  def main(args: Array[String])
752de4e10162 tuned source structure;
wenzelm
parents: 48340
diff changeset
   484
  {
48346
e2382bede914 more general support for Isabelle/Scala command line tools;
wenzelm
parents: 48344
diff changeset
   485
    Command_Line.tool {
e2382bede914 more general support for Isabelle/Scala command line tools;
wenzelm
parents: 48344
diff changeset
   486
      args.toList match {
e2382bede914 more general support for Isabelle/Scala command line tools;
wenzelm
parents: 48344
diff changeset
   487
        case
e2382bede914 more general support for Isabelle/Scala command line tools;
wenzelm
parents: 48344
diff changeset
   488
          Properties.Value.Boolean(all_sessions) ::
e2382bede914 more general support for Isabelle/Scala command line tools;
wenzelm
parents: 48344
diff changeset
   489
          Properties.Value.Boolean(build_images) ::
48425
0d95980e9aae parallel scheduling of jobs;
wenzelm
parents: 48424
diff changeset
   490
          Properties.Value.Int(max_jobs) ::
48346
e2382bede914 more general support for Isabelle/Scala command line tools;
wenzelm
parents: 48344
diff changeset
   491
          Properties.Value.Boolean(list_only) ::
48447
ef600ce4559c added system build mode: produce output in ISABELLE_HOME;
wenzelm
parents: 48425
diff changeset
   492
          Properties.Value.Boolean(system_mode) ::
48459
375e45df6fdf timing is command line options, not system option;
wenzelm
parents: 48457
diff changeset
   493
          Properties.Value.Boolean(timing) ::
48425
0d95980e9aae parallel scheduling of jobs;
wenzelm
parents: 48424
diff changeset
   494
          Properties.Value.Boolean(verbose) ::
48346
e2382bede914 more general support for Isabelle/Scala command line tools;
wenzelm
parents: 48344
diff changeset
   495
          Command_Line.Chunks(more_dirs, options, sessions) =>
48459
375e45df6fdf timing is command line options, not system option;
wenzelm
parents: 48457
diff changeset
   496
            build(all_sessions, build_images, max_jobs, list_only, system_mode, timing,
48447
ef600ce4559c added system build mode: produce output in ISABELLE_HOME;
wenzelm
parents: 48425
diff changeset
   497
              verbose, more_dirs.map(Path.explode), options, sessions)
48346
e2382bede914 more general support for Isabelle/Scala command line tools;
wenzelm
parents: 48344
diff changeset
   498
        case _ => error("Bad arguments:\n" + cat_lines(args))
48341
752de4e10162 tuned source structure;
wenzelm
parents: 48340
diff changeset
   499
      }
48346
e2382bede914 more general support for Isabelle/Scala command line tools;
wenzelm
parents: 48344
diff changeset
   500
    }
48341
752de4e10162 tuned source structure;
wenzelm
parents: 48340
diff changeset
   501
  }
48276
4bd480886813 basic setup for Isabelle build tool;
wenzelm
parents:
diff changeset
   502
}
4bd480886813 basic setup for Isabelle build tool;
wenzelm
parents:
diff changeset
   503