src/Pure/System/build.scala
author wenzelm
Thu, 19 Jul 2012 12:37:08 +0200
changeset 49362 8bb27ab9e841
parent 49361 e2382bede914
child 49364 a78e5d399599
permissions -rw-r--r--
more explicit treatment of initial Pure sessions;
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@49295
    22
  case class Session_Info(
wenzelm@49349
    23
    dir: Path,
wenzelm@49349
    24
    name: String,
wenzelm@49362
    25
    parent: Option[String],
wenzelm@49349
    26
    description: String,
wenzelm@49349
    27
    options: Options,
wenzelm@49349
    28
    theories: List[(Options, String)],
wenzelm@49349
    29
    files: List[String])
wenzelm@49295
    30
wenzelm@49352
    31
wenzelm@49352
    32
  /* parsing */
wenzelm@49352
    33
wenzelm@49352
    34
  val ROOT_NAME = "ROOT"
wenzelm@49352
    35
wenzelm@49352
    36
  private case class Session_Entry(
wenzelm@49352
    37
    name: String,
wenzelm@49352
    38
    reset: Boolean,
wenzelm@49352
    39
    path: Option[String],
wenzelm@49362
    40
    parent: Option[String],
wenzelm@49352
    41
    description: String,
wenzelm@49352
    42
    options: Options,
wenzelm@49352
    43
    theories: List[(Options, List[String])],
wenzelm@49352
    44
    files: List[String])
wenzelm@49352
    45
wenzelm@49349
    46
  private object Parser extends Parse.Parser
wenzelm@49349
    47
  {
wenzelm@49349
    48
    val SESSION = "session"
wenzelm@49349
    49
    val IN = "in"
wenzelm@49349
    50
    val DESCRIPTION = "description"
wenzelm@49349
    51
    val OPTIONS = "options"
wenzelm@49349
    52
    val THEORIES = "theories"
wenzelm@49349
    53
    val FILES = "files"
wenzelm@49349
    54
wenzelm@49349
    55
    val syntax =
wenzelm@49351
    56
      Outer_Syntax.empty + "!" + "(" + ")" + "+" + "," + "=" + "[" + "]" +
wenzelm@49351
    57
        SESSION + IN + DESCRIPTION + OPTIONS + THEORIES + FILES
wenzelm@49349
    58
wenzelm@49352
    59
    val session_entry: Parser[Session_Entry] =
wenzelm@49349
    60
    {
wenzelm@49349
    61
      val session_name = atom("session name", _.is_name)
wenzelm@49349
    62
      val theory_name = atom("theory name", _.is_name)
wenzelm@49349
    63
wenzelm@49349
    64
      val option =
wenzelm@49349
    65
        name ~ opt(keyword("=") ~! name ^^ { case _ ~ x => x }) ^^ { case x ~ y => (x, y) }
wenzelm@49352
    66
      val options = keyword("[") ~> repsep(option, keyword(",")) <~ keyword("]")
wenzelm@49349
    67
wenzelm@49349
    68
      val theories =
wenzelm@49349
    69
        keyword(THEORIES) ~! ((options | success(Nil)) ~ rep1(theory_name)) ^^
wenzelm@49349
    70
          { case _ ~ (x ~ y) => (x, y) }
wenzelm@49349
    71
wenzelm@49349
    72
      ((keyword(SESSION) ~! session_name) ^^ { case _ ~ x => x }) ~
wenzelm@49351
    73
        (keyword("!") ^^^ true | success(false)) ~
wenzelm@49352
    74
        (opt(keyword(IN) ~! string ^^ { case _ ~ x => x })) ~
wenzelm@49362
    75
        (keyword("=") ~> opt(session_name <~ keyword("+"))) ~
wenzelm@49349
    76
        (keyword(DESCRIPTION) ~! text ^^ { case _ ~ x => x } | success("")) ~
wenzelm@49349
    77
        (keyword(OPTIONS) ~! options ^^ { case _ ~ x => x } | success(Nil)) ~
wenzelm@49362
    78
        rep(theories) ~
wenzelm@49351
    79
        (keyword(FILES) ~! rep1(path) ^^ { case _ ~ x => x } | success(Nil)) ^^
wenzelm@49352
    80
          { case a ~ b ~ c ~ d ~ e ~ f ~ g ~ h => Session_Entry(a, b, c, d, e, f, g, h) }
wenzelm@49349
    81
    }
wenzelm@49349
    82
wenzelm@49352
    83
    def parse_entries(root: File): List[Session_Entry] =
wenzelm@49349
    84
    {
wenzelm@49350
    85
      val toks = syntax.scan(Standard_System.read_file(root))
wenzelm@49352
    86
      parse_all(rep(session_entry), Token.reader(toks, root.toString)) match {
wenzelm@49349
    87
        case Success(result, _) => result
wenzelm@49349
    88
        case bad => error(bad.toString)
wenzelm@49349
    89
      }
wenzelm@49349
    90
    }
wenzelm@49349
    91
  }
wenzelm@49295
    92
wenzelm@49352
    93
wenzelm@49356
    94
  /* find sessions */
wenzelm@49352
    95
wenzelm@49355
    96
  def find_sessions(more_dirs: List[Path]): List[Session_Info] =
wenzelm@49295
    97
  {
wenzelm@49352
    98
    val infos = new mutable.ListBuffer[Session_Info]
wenzelm@49352
    99
wenzelm@49295
   100
    for {
wenzelm@49355
   101
      (dir, strict) <- Isabelle_System.components().map((_, false)) ++ more_dirs.map((_, true))
wenzelm@49295
   102
      root = Isabelle_System.platform_file(dir + Path.basic(ROOT_NAME))
wenzelm@49355
   103
      _ = (strict && !root.isFile && error("Bad session root file: " + quote(root.toString)))
wenzelm@49295
   104
      if root.isFile
wenzelm@49352
   105
      entry <- Parser.parse_entries(root)
wenzelm@49352
   106
    }
wenzelm@49352
   107
    {
wenzelm@49352
   108
      try {
wenzelm@49362
   109
        if (entry.name == "") error("Bad session name")
wenzelm@49362
   110
wenzelm@49352
   111
        val full_name =
wenzelm@49362
   112
          if (entry.name == "RAW" || entry.name == "Pure") {
wenzelm@49362
   113
            if (entry.parent.isDefined) error("Illegal parent session")
wenzelm@49362
   114
            else entry.name
wenzelm@49362
   115
          }
wenzelm@49362
   116
          else
wenzelm@49362
   117
            entry.parent match {
wenzelm@49362
   118
              case None => error("Missing parent session")
wenzelm@49362
   119
              case Some(parent) =>
wenzelm@49362
   120
                val parent_info =
wenzelm@49362
   121
                  infos.find(_.name == parent) getOrElse
wenzelm@49362
   122
                   error("Undefined parent session: " + quote(parent))
wenzelm@49362
   123
                if (entry.reset) entry.name
wenzelm@49362
   124
                else parent_info.name + "-" + entry.name
wenzelm@49362
   125
            }
wenzelm@49354
   126
wenzelm@49352
   127
        val path =
wenzelm@49352
   128
          entry.path match {
wenzelm@49352
   129
            case Some(p) => Path.explode(p)
wenzelm@49352
   130
            case None => Path.basic(entry.name)
wenzelm@49352
   131
          }
wenzelm@49352
   132
        val thys = entry.theories.map({ case (x, ys) => ys.map(y => (x, y)) }).flatten
wenzelm@49352
   133
        val info =
wenzelm@49352
   134
          Session_Info(dir + path, full_name, entry.parent, entry.description,
wenzelm@49352
   135
            entry.options, thys, entry.files)
wenzelm@49354
   136
wenzelm@49362
   137
        if (infos.exists(_.name == full_name))
wenzelm@49362
   138
          error("Duplicate session: " + quote(full_name))
wenzelm@49352
   139
        infos += info
wenzelm@49352
   140
      }
wenzelm@49352
   141
      catch {
wenzelm@49352
   142
        case ERROR(msg) =>
wenzelm@49352
   143
          error(msg + "\nThe error(s) above occurred in session entry " +
wenzelm@49352
   144
            quote(entry.name) + " (file " + quote(root.toString) + ")")
wenzelm@49352
   145
      }
wenzelm@49352
   146
    }
wenzelm@49352
   147
    infos.toList
wenzelm@49295
   148
  }
wenzelm@49356
   149
wenzelm@49356
   150
wenzelm@49356
   151
wenzelm@49356
   152
  /** build **/
wenzelm@49356
   153
wenzelm@49356
   154
  def build(all_sessions: Boolean, build_images: Boolean, list_only: Boolean,
wenzelm@49356
   155
    more_dirs: List[Path], options: List[String], sessions: List[String]): Int =
wenzelm@49356
   156
  {
wenzelm@49356
   157
    println("more_dirs = " + more_dirs.toString)
wenzelm@49356
   158
    println("options = " + options.toString)
wenzelm@49356
   159
    println("sessions = " + sessions.toString)
wenzelm@49356
   160
wenzelm@49356
   161
    find_sessions(more_dirs) foreach println
wenzelm@49356
   162
wenzelm@49356
   163
    0
wenzelm@49356
   164
  }
wenzelm@49356
   165
wenzelm@49356
   166
wenzelm@49361
   167
  /* command line entry point */
wenzelm@49356
   168
wenzelm@49356
   169
  def main(args: Array[String])
wenzelm@49356
   170
  {
wenzelm@49361
   171
    Command_Line.tool {
wenzelm@49361
   172
      args.toList match {
wenzelm@49361
   173
        case
wenzelm@49361
   174
          Properties.Value.Boolean(all_sessions) ::
wenzelm@49361
   175
          Properties.Value.Boolean(build_images) ::
wenzelm@49361
   176
          Properties.Value.Boolean(list_only) ::
wenzelm@49361
   177
          Command_Line.Chunks(more_dirs, options, sessions) =>
wenzelm@49361
   178
            build(all_sessions, build_images, list_only,
wenzelm@49361
   179
              more_dirs.map(Path.explode), options, sessions)
wenzelm@49361
   180
        case _ => error("Bad arguments:\n" + cat_lines(args))
wenzelm@49356
   181
      }
wenzelm@49361
   182
    }
wenzelm@49356
   183
  }
wenzelm@49291
   184
}
wenzelm@49291
   185