src/Pure/System/options.scala
author wenzelm
Fri, 20 Jul 2012 21:04:03 +0200
changeset 49388 527e2bad7cca
parent 49385 d0fa3efec93b
child 49424 0d2114eb412a
permissions -rw-r--r--
further imitation of "usedir" shell script;
Pure/build observes build_images option, unlike traditional version;
tuned signature;
wenzelm@49380
     1
/*  Title:      Pure/System/options.scala
wenzelm@49380
     2
    Author:     Makarius
wenzelm@49380
     3
wenzelm@49380
     4
Stand-alone options with external string representation.
wenzelm@49380
     5
*/
wenzelm@49380
     6
wenzelm@49380
     7
package isabelle
wenzelm@49380
     8
wenzelm@49380
     9
wenzelm@49380
    10
import java.io.File
wenzelm@49380
    11
wenzelm@49380
    12
wenzelm@49380
    13
object Options
wenzelm@49380
    14
{
wenzelm@49380
    15
  abstract class Type
wenzelm@49380
    16
  {
wenzelm@49380
    17
    def print: String = toString.toLowerCase
wenzelm@49380
    18
  }
wenzelm@49385
    19
  case object Bool extends Type
wenzelm@49385
    20
  case object Int extends Type
wenzelm@49385
    21
  case object Real extends Type
wenzelm@49385
    22
  case object String extends Type
wenzelm@49380
    23
wenzelm@49385
    24
  case class Opt(typ: Type, value: String, description: String)
wenzelm@49380
    25
wenzelm@49380
    26
  val empty: Options = new Options()
wenzelm@49380
    27
wenzelm@49380
    28
wenzelm@49380
    29
  /* parsing */
wenzelm@49380
    30
wenzelm@49380
    31
  private object Parser extends Parse.Parser
wenzelm@49380
    32
  {
wenzelm@49380
    33
    val DECLARE = "declare"
wenzelm@49380
    34
    val DEFINE = "define"
wenzelm@49380
    35
wenzelm@49380
    36
    val syntax = Outer_Syntax.empty + ":" + "=" + DECLARE + DEFINE
wenzelm@49380
    37
wenzelm@49380
    38
    val entry: Parser[Options => Options] =
wenzelm@49380
    39
    {
wenzelm@49380
    40
      val option_name = atom("option name", _.is_xname)
wenzelm@49380
    41
      val option_type = atom("option type", _.is_ident)
wenzelm@49380
    42
      val option_value = atom("option value", tok => tok.is_name || tok.is_float)
wenzelm@49380
    43
wenzelm@49385
    44
      keyword(DECLARE) ~! (option_name ~ keyword(":") ~ option_type ~
wenzelm@49385
    45
      keyword("=") ~ option_value ~ opt(text)) ^^
wenzelm@49385
    46
        { case _ ~ (a ~ _ ~ b ~ _ ~ c ~ d) =>
wenzelm@49385
    47
            (options: Options) => options.declare(a, b, c, d.getOrElse("")) } |
wenzelm@49380
    48
      keyword(DEFINE) ~! (option_name ~ keyword("=") ~ option_value) ^^
wenzelm@49385
    49
        { case _ ~ (a ~ _ ~ b) => (options: Options) => options.define(a, b) }
wenzelm@49380
    50
    }
wenzelm@49380
    51
wenzelm@49380
    52
    def parse_entries(file: File): List[Options => Options] =
wenzelm@49380
    53
    {
wenzelm@49380
    54
      val toks = syntax.scan(Standard_System.read_file(file))
wenzelm@49380
    55
      parse_all(rep(entry), Token.reader(toks, file.toString)) match {
wenzelm@49380
    56
        case Success(result, _) => result
wenzelm@49380
    57
        case bad => error(bad.toString)
wenzelm@49380
    58
      }
wenzelm@49380
    59
    }
wenzelm@49380
    60
  }
wenzelm@49380
    61
wenzelm@49380
    62
  val OPTIONS = Path.explode("etc/options")
wenzelm@49380
    63
wenzelm@49380
    64
  def init(): Options =
wenzelm@49380
    65
  {
wenzelm@49380
    66
    var options = empty
wenzelm@49380
    67
    for {
wenzelm@49380
    68
      dir <- Isabelle_System.components()
wenzelm@49388
    69
      file = (dir + OPTIONS).file
wenzelm@49380
    70
      if file.isFile
wenzelm@49380
    71
      entry <- Parser.parse_entries(file)
wenzelm@49380
    72
    } {
wenzelm@49380
    73
      try { options = entry(options) }
wenzelm@49385
    74
      catch { case ERROR(msg) => error(msg + Position.str_of(Position.file(file))) }
wenzelm@49380
    75
    }
wenzelm@49380
    76
    options
wenzelm@49380
    77
  }
wenzelm@49380
    78
}
wenzelm@49380
    79
wenzelm@49380
    80
wenzelm@49380
    81
final class Options private(options: Map[String, Options.Opt] = Map.empty)
wenzelm@49380
    82
{
wenzelm@49380
    83
  override def toString: String = options.iterator.mkString("Options (", ",", ")")
wenzelm@49380
    84
wenzelm@49380
    85
wenzelm@49385
    86
  /* check */
wenzelm@49380
    87
wenzelm@49380
    88
  private def check_name(name: String): Options.Opt =
wenzelm@49380
    89
    options.get(name) match {
wenzelm@49380
    90
      case Some(opt) => opt
wenzelm@49383
    91
      case None => error("Unknown option " + quote(name))
wenzelm@49380
    92
    }
wenzelm@49380
    93
wenzelm@49380
    94
  private def check_type(name: String, typ: Options.Type): Options.Opt =
wenzelm@49380
    95
  {
wenzelm@49380
    96
    val opt = check_name(name)
wenzelm@49380
    97
    if (opt.typ == typ) opt
wenzelm@49380
    98
    else error("Ill-typed option " + quote(name) + " : " + opt.typ.print + " vs. " + typ.print)
wenzelm@49380
    99
  }
wenzelm@49380
   100
wenzelm@49385
   101
wenzelm@49385
   102
  /* basic operations */
wenzelm@49385
   103
wenzelm@49385
   104
  private def put[A](name: String, typ: Options.Type, value: String): Options =
wenzelm@49385
   105
  {
wenzelm@49385
   106
    val opt = check_type(name, typ)
wenzelm@49385
   107
    new Options(options + (name -> opt.copy(value = value)))
wenzelm@49385
   108
  }
wenzelm@49385
   109
wenzelm@49380
   110
  private def get[A](name: String, typ: Options.Type, parse: String => Option[A]): A =
wenzelm@49380
   111
  {
wenzelm@49380
   112
    val opt = check_type(name, typ)
wenzelm@49380
   113
    parse(opt.value) match {
wenzelm@49380
   114
      case Some(x) => x
wenzelm@49380
   115
      case None =>
wenzelm@49380
   116
        error("Malformed value for option " + quote(name) +
wenzelm@49380
   117
          " : " + typ.print + " =\n" + quote(opt.value))
wenzelm@49380
   118
    }
wenzelm@49380
   119
  }
wenzelm@49380
   120
wenzelm@49380
   121
wenzelm@49380
   122
  /* internal lookup and update */
wenzelm@49380
   123
wenzelm@49380
   124
  val bool = new Object
wenzelm@49380
   125
  {
wenzelm@49380
   126
    def apply(name: String): Boolean = get(name, Options.Bool, Properties.Value.Boolean.unapply)
wenzelm@49380
   127
    def update(name: String, x: Boolean): Options =
wenzelm@49380
   128
      put(name, Options.Bool, Properties.Value.Boolean(x))
wenzelm@49380
   129
  }
wenzelm@49380
   130
wenzelm@49380
   131
  val int = new Object
wenzelm@49380
   132
  {
wenzelm@49380
   133
    def apply(name: String): Int = get(name, Options.Int, Properties.Value.Int.unapply)
wenzelm@49380
   134
    def update(name: String, x: Int): Options =
wenzelm@49380
   135
      put(name, Options.Int, Properties.Value.Int(x))
wenzelm@49380
   136
  }
wenzelm@49380
   137
wenzelm@49380
   138
  val real = new Object
wenzelm@49380
   139
  {
wenzelm@49380
   140
    def apply(name: String): Double = get(name, Options.Real, Properties.Value.Double.unapply)
wenzelm@49380
   141
    def update(name: String, x: Double): Options =
wenzelm@49380
   142
      put(name, Options.Real, Properties.Value.Double(x))
wenzelm@49380
   143
  }
wenzelm@49380
   144
wenzelm@49380
   145
  val string = new Object
wenzelm@49380
   146
  {
wenzelm@49380
   147
    def apply(name: String): String = get(name, Options.String, s => Some(s))
wenzelm@49380
   148
    def update(name: String, x: String): Options = put(name, Options.String, x)
wenzelm@49380
   149
  }
wenzelm@49385
   150
wenzelm@49385
   151
wenzelm@49385
   152
  /* external declare and define */
wenzelm@49385
   153
wenzelm@49385
   154
  private def check_value(name: String): Options =
wenzelm@49385
   155
  {
wenzelm@49385
   156
    val opt = check_name(name)
wenzelm@49385
   157
    opt.typ match {
wenzelm@49385
   158
      case Options.Bool => bool(name); this
wenzelm@49385
   159
      case Options.Int => int(name); this
wenzelm@49385
   160
      case Options.Real => real(name); this
wenzelm@49385
   161
      case Options.String => string(name); this
wenzelm@49385
   162
    }
wenzelm@49385
   163
  }
wenzelm@49385
   164
wenzelm@49385
   165
  def declare(name: String, typ_name: String, value: String, description: String = ""): Options =
wenzelm@49385
   166
  {
wenzelm@49385
   167
    options.get(name) match {
wenzelm@49385
   168
      case Some(_) => error("Duplicate declaration of option " + quote(name))
wenzelm@49385
   169
      case None =>
wenzelm@49385
   170
        val typ =
wenzelm@49385
   171
          typ_name match {
wenzelm@49385
   172
            case "bool" => Options.Bool
wenzelm@49385
   173
            case "int" => Options.Int
wenzelm@49385
   174
            case "real" => Options.Real
wenzelm@49385
   175
            case "string" => Options.String
wenzelm@49385
   176
            case _ => error("Malformed type for option " + quote(name) + " : " + quote(typ_name))
wenzelm@49385
   177
          }
wenzelm@49385
   178
        (new Options(options + (name -> Options.Opt(typ, value, description)))).check_value(name)
wenzelm@49385
   179
    }
wenzelm@49385
   180
  }
wenzelm@49385
   181
wenzelm@49385
   182
  def define(name: String, value: String): Options =
wenzelm@49385
   183
  {
wenzelm@49385
   184
    val opt = check_name(name)
wenzelm@49385
   185
    (new Options(options + (name -> opt.copy(value = value)))).check_value(name)
wenzelm@49385
   186
  }
wenzelm@49385
   187
wenzelm@49385
   188
  def define(name: String, opt_value: Option[String]): Options =
wenzelm@49385
   189
  {
wenzelm@49385
   190
    val opt = check_name(name)
wenzelm@49385
   191
    opt_value match {
wenzelm@49385
   192
      case Some(value) => define(name, value)
wenzelm@49385
   193
      case None if opt.typ == Options.Bool => define(name, "true")
wenzelm@49385
   194
      case None => error("Missing value for option " + quote(name) + " : " + opt.typ.print)
wenzelm@49385
   195
    }
wenzelm@49385
   196
  }
wenzelm@49385
   197
wenzelm@49385
   198
  def define_simple(str: String): Options =
wenzelm@49385
   199
  {
wenzelm@49385
   200
    str.indexOf('=') match {
wenzelm@49385
   201
      case -1 => define(str, None)
wenzelm@49385
   202
      case i => define(str.substring(0, i), str.substring(i + 1))
wenzelm@49385
   203
    }
wenzelm@49385
   204
  }
wenzelm@49380
   205
}