src/Pure/config.ML
author wenzelm
Fri Apr 12 14:54:14 2013 +0200 (2013-04-12)
changeset 51700 c8f2bad67dbb
parent 47814 53668571d300
child 51947 3301612c4893
permissions -rw-r--r--
tuned signature;
tuned comments;
wenzelm@24114
     1
(*  Title:      Pure/config.ML
wenzelm@24114
     2
    Author:     Makarius
wenzelm@24114
     3
wenzelm@24114
     4
Configuration options as values within the local context.
wenzelm@24114
     5
*)
wenzelm@24114
     6
wenzelm@24114
     7
signature CONFIG =
wenzelm@24114
     8
sig
wenzelm@40291
     9
  datatype value = Bool of bool | Int of int | Real of real | String of string
wenzelm@24114
    10
  val print_value: value -> string
wenzelm@24114
    11
  val print_type: value -> string
wenzelm@24114
    12
  type 'a T
wenzelm@39163
    13
  type raw = value T
wenzelm@39163
    14
  val bool: raw -> bool T
wenzelm@39163
    15
  val int: raw -> int T
wenzelm@40291
    16
  val real: raw -> real T
wenzelm@39163
    17
  val string: raw -> string T
wenzelm@24114
    18
  val get: Proof.context -> 'a T -> 'a
wenzelm@24114
    19
  val map: 'a T -> ('a -> 'a) -> Proof.context -> Proof.context
wenzelm@24114
    20
  val put: 'a T -> 'a -> Proof.context -> Proof.context
wenzelm@36787
    21
  val get_global: theory -> 'a T -> 'a
wenzelm@36787
    22
  val map_global: 'a T -> ('a -> 'a) -> theory -> theory
wenzelm@36787
    23
  val put_global: 'a T -> 'a -> theory -> theory
wenzelm@24114
    24
  val get_generic: Context.generic -> 'a T -> 'a
wenzelm@24114
    25
  val map_generic: 'a T -> ('a -> 'a) -> Context.generic -> Context.generic
wenzelm@24114
    26
  val put_generic: 'a T -> 'a -> Context.generic -> Context.generic
wenzelm@39163
    27
  val declare_generic: {global: bool} -> string -> (Context.generic -> value) -> raw
wenzelm@39163
    28
  val declare_global: string -> (Context.generic -> value) -> raw
wenzelm@39163
    29
  val declare: string -> (Context.generic -> value) -> raw
wenzelm@24125
    30
  val name_of: 'a T -> string
wenzelm@24114
    31
end;
wenzelm@24114
    32
wenzelm@24114
    33
structure Config: CONFIG =
wenzelm@24114
    34
struct
wenzelm@24114
    35
wenzelm@24114
    36
(* simple values *)
wenzelm@24114
    37
wenzelm@24114
    38
datatype value =
wenzelm@24114
    39
  Bool of bool |
wenzelm@24114
    40
  Int of int |
wenzelm@40291
    41
  Real of real |
wenzelm@24114
    42
  String of string;
wenzelm@24114
    43
wenzelm@24114
    44
fun print_value (Bool true) = "true"
wenzelm@24114
    45
  | print_value (Bool false) = "false"
wenzelm@24114
    46
  | print_value (Int i) = signed_string_of_int i
wenzelm@40291
    47
  | print_value (Real x) = signed_string_of_real x
wenzelm@24114
    48
  | print_value (String s) = quote s;
wenzelm@24114
    49
wenzelm@38804
    50
fun print_type (Bool _) = "bool"
wenzelm@38804
    51
  | print_type (Int _) = "int"
wenzelm@40291
    52
  | print_type (Real _) = "real"
wenzelm@24114
    53
  | print_type (String _) = "string";
wenzelm@24114
    54
wenzelm@24114
    55
fun same_type (Bool _) (Bool _) = true
wenzelm@24114
    56
  | same_type (Int _) (Int _) = true
wenzelm@40291
    57
  | same_type (Real _) (Real _) = true
wenzelm@24114
    58
  | same_type (String _) (String _) = true
wenzelm@24114
    59
  | same_type _ _ = false;
wenzelm@24114
    60
wenzelm@24114
    61
fun type_check name f value =
wenzelm@24114
    62
  let
wenzelm@24114
    63
    val value' = f value;
wenzelm@24114
    64
    val _ = same_type value value' orelse
wenzelm@24114
    65
      error ("Ill-typed configuration option " ^ quote name ^ ": " ^
wenzelm@24114
    66
        print_type value ^ " expected,\nbut " ^ print_type value' ^ " was found");
wenzelm@24114
    67
  in value' end;
wenzelm@24114
    68
wenzelm@24114
    69
wenzelm@24114
    70
(* abstract configuration options *)
wenzelm@24114
    71
wenzelm@24114
    72
datatype 'a T = Config of
wenzelm@24125
    73
 {name: string,
wenzelm@24125
    74
  get_value: Context.generic -> 'a,
wenzelm@24114
    75
  map_value: ('a -> 'a) -> Context.generic -> Context.generic};
wenzelm@24114
    76
wenzelm@39163
    77
type raw = value T;
wenzelm@39163
    78
wenzelm@24125
    79
fun coerce make dest (Config {name, get_value, map_value}) = Config
wenzelm@24125
    80
 {name = name,
wenzelm@24125
    81
  get_value = dest o get_value,
wenzelm@24125
    82
  map_value = fn f => map_value (make o f o dest)};
wenzelm@24114
    83
wenzelm@24114
    84
val bool = coerce Bool (fn Bool b => b);
wenzelm@24114
    85
val int = coerce Int (fn Int i => i);
wenzelm@40291
    86
val real = coerce Real (fn Real x => x);
wenzelm@24114
    87
val string = coerce String (fn String s => s);
wenzelm@24114
    88
wenzelm@24114
    89
fun get_generic context (Config {get_value, ...}) = get_value context;
wenzelm@24114
    90
fun map_generic (Config {map_value, ...}) f context = map_value f context;
wenzelm@24114
    91
fun put_generic config value = map_generic config (K value);
wenzelm@24114
    92
wenzelm@24114
    93
fun get_ctxt ctxt = get_generic (Context.Proof ctxt);
wenzelm@24114
    94
fun map_ctxt config f = Context.proof_map (map_generic config f);
wenzelm@24114
    95
fun put_ctxt config value = map_ctxt config (K value);
wenzelm@24114
    96
wenzelm@36787
    97
fun get_global thy = get_generic (Context.Theory thy);
wenzelm@36787
    98
fun map_global config f = Context.theory_map (map_generic config f);
wenzelm@36787
    99
fun put_global config value = map_global config (K value);
wenzelm@24114
   100
wenzelm@24114
   101
wenzelm@24114
   102
(* context information *)
wenzelm@24114
   103
wenzelm@33519
   104
structure Value = Generic_Data
wenzelm@24114
   105
(
wenzelm@24114
   106
  type T = value Inttab.table;
wenzelm@24114
   107
  val empty = Inttab.empty;
wenzelm@24114
   108
  val extend = I;
wenzelm@33519
   109
  fun merge data = Inttab.merge (K true) data;
wenzelm@24114
   110
);
wenzelm@24114
   111
wenzelm@39116
   112
fun declare_generic {global} name default =
wenzelm@24114
   113
  let
wenzelm@24114
   114
    val id = serial ();
wenzelm@24114
   115
wenzelm@36000
   116
    fun get_value context =
wenzelm@36000
   117
      (case Inttab.lookup (Value.get context) id of
wenzelm@36000
   118
        SOME value => value
wenzelm@36002
   119
      | NONE => default context);
wenzelm@36000
   120
wenzelm@36000
   121
    fun update_value f context =
wenzelm@36000
   122
      Value.map (Inttab.update (id, type_check name f (get_value context))) context;
wenzelm@24114
   123
wenzelm@47814
   124
    fun map_value f (context as Context.Proof ctxt) =
wenzelm@36000
   125
          let val context' = update_value f context in
wenzelm@24114
   126
            if global andalso
wenzelm@47814
   127
              Context_Position.is_visible ctxt andalso
wenzelm@40291
   128
              print_value (get_value (Context.Theory (Context.theory_of context'))) <>
wenzelm@40291
   129
                print_value (get_value context')
wenzelm@47814
   130
            then
wenzelm@47814
   131
              (Context_Position.if_visible ctxt warning
wenzelm@47814
   132
                ("Ignoring local change of global option " ^ quote name); context)
wenzelm@24114
   133
            else context'
wenzelm@24114
   134
          end
wenzelm@36000
   135
      | map_value f context = update_value f context;
wenzelm@24125
   136
  in Config {name = name, get_value = get_value, map_value = map_value} end;
wenzelm@24125
   137
wenzelm@39116
   138
val declare_global = declare_generic {global = true};
wenzelm@39116
   139
val declare = declare_generic {global = false};
wenzelm@39116
   140
wenzelm@24125
   141
fun name_of (Config {name, ...}) = name;
wenzelm@24114
   142
wenzelm@24114
   143
wenzelm@24114
   144
(*final declarations of this structure!*)
wenzelm@24114
   145
val get = get_ctxt;
wenzelm@24114
   146
val map = map_ctxt;
wenzelm@24114
   147
val put = put_ctxt;
wenzelm@24114
   148
wenzelm@24114
   149
end;