src/Pure/theory.ML
author wenzelm
Sat Oct 24 19:47:37 2009 +0200 (2009-10-24 ago)
changeset 33095 bbd52d2f8696
parent 33092 c859019d3ac5
child 33096 db3c18fd9708
permissions -rw-r--r--
renamed NameSpace to Name_Space -- also to emphasize its subtle change in semantics;
paulson@1526
     1
(*  Title:      Pure/theory.ML
paulson@1526
     2
    Author:     Lawrence C Paulson and Markus Wenzel
paulson@1526
     3
wenzelm@28290
     4
Logical theory content: axioms, definitions, and begin/end wrappers.
paulson@1526
     5
*)
wenzelm@16291
     6
wenzelm@26668
     7
signature THEORY =
wenzelm@3767
     8
sig
wenzelm@16443
     9
  val eq_thy: theory * theory -> bool
wenzelm@3996
    10
  val subthy: theory * theory -> bool
wenzelm@24666
    11
  val assert_super: theory -> theory -> theory
wenzelm@22684
    12
  val parents_of: theory -> theory list
wenzelm@22684
    13
  val ancestors_of: theory -> theory list
wenzelm@24666
    14
  val check_thy: theory -> theory_ref
wenzelm@24666
    15
  val deref: theory_ref -> theory
wenzelm@24666
    16
  val merge: theory * theory -> theory
wenzelm@24666
    17
  val merge_refs: theory_ref * theory_ref -> theory_ref
wenzelm@24666
    18
  val merge_list: theory list -> theory
wenzelm@16495
    19
  val checkpoint: theory -> theory
wenzelm@16495
    20
  val copy: theory -> theory
wenzelm@24666
    21
  val requires: theory -> string -> string -> unit
wenzelm@33095
    22
  val axiom_space: theory -> Name_Space.T
wenzelm@22684
    23
  val axiom_table: theory -> term Symtab.table
wenzelm@16339
    24
  val axioms_of: theory -> (string * term) list
wenzelm@16339
    25
  val all_axioms_of: theory -> (string * term) list
wenzelm@24666
    26
  val defs_of: theory -> Defs.T
wenzelm@24666
    27
  val at_begin: (theory -> theory option) -> theory -> theory
wenzelm@24666
    28
  val at_end: (theory -> theory option) -> theory -> theory
wenzelm@24666
    29
  val begin_theory: string -> theory list -> theory
wenzelm@24666
    30
  val end_theory: theory -> theory
haftmann@29581
    31
  val add_axioms_i: (binding * term) list -> theory -> theory
wenzelm@30337
    32
  val add_axioms: (binding * string) list -> theory -> theory
wenzelm@19708
    33
  val add_deps: string -> string * typ -> (string * typ) list -> theory -> theory
haftmann@29581
    34
  val add_defs_i: bool -> bool -> (binding * term) list -> theory -> theory
wenzelm@30337
    35
  val add_defs: bool -> bool -> (binding * string) list -> theory -> theory
haftmann@29581
    36
  val add_finals_i: bool -> term list -> theory -> theory
wenzelm@16443
    37
  val add_finals: bool -> string list -> theory -> theory
haftmann@29581
    38
  val specify_const: Properties.T -> (binding * typ) * mixfix -> theory -> term * theory
wenzelm@16495
    39
end
paulson@1526
    40
wenzelm@24666
    41
structure Theory: THEORY =
wenzelm@16443
    42
struct
wenzelm@16443
    43
wenzelm@19708
    44
wenzelm@24666
    45
(** theory context operations **)
wenzelm@16443
    46
wenzelm@16443
    47
val eq_thy = Context.eq_thy;
wenzelm@16443
    48
val subthy = Context.subthy;
paulson@1526
    49
haftmann@24626
    50
fun assert_super thy1 thy2 =
haftmann@24626
    51
  if subthy (thy1, thy2) then thy2
haftmann@24626
    52
  else raise THEORY ("Not a super theory", [thy1, thy2]);
haftmann@24626
    53
wenzelm@16443
    54
val parents_of = Context.parents_of;
wenzelm@16443
    55
val ancestors_of = Context.ancestors_of;
wenzelm@16443
    56
wenzelm@24137
    57
val check_thy = Context.check_thy;
wenzelm@16443
    58
val deref = Context.deref;
wenzelm@24666
    59
wenzelm@16443
    60
val merge = Context.merge;
wenzelm@16443
    61
val merge_refs = Context.merge_refs;
wenzelm@16443
    62
wenzelm@23600
    63
fun merge_list [] = raise THEORY ("Empty merge of theories", [])
wenzelm@21608
    64
  | merge_list (thy :: thys) = Library.foldl merge (thy, thys);
wenzelm@21608
    65
wenzelm@16495
    66
val checkpoint = Context.checkpoint_thy;
wenzelm@16495
    67
val copy = Context.copy_thy;
wenzelm@16495
    68
wenzelm@24666
    69
fun requires thy name what =
wenzelm@29092
    70
  if exists (fn thy' => Context.theory_name thy' = name) (thy :: ancestors_of thy) then ()
wenzelm@24666
    71
  else error ("Require theory " ^ quote name ^ " as an ancestor for " ^ what);
wenzelm@24666
    72
wenzelm@24666
    73
wenzelm@24666
    74
wenzelm@25059
    75
(** datatype thy **)
wenzelm@24666
    76
wenzelm@24666
    77
type wrapper = (theory -> theory option) * stamp;
wenzelm@24666
    78
wenzelm@24666
    79
fun apply_wrappers (wrappers: wrapper list) =
wenzelm@25059
    80
  perhaps (perhaps_loop (perhaps_apply (map fst wrappers)));
wenzelm@24666
    81
wenzelm@24666
    82
datatype thy = Thy of
wenzelm@33095
    83
 {axioms: term Name_Space.table,
wenzelm@24666
    84
  defs: Defs.T,
wenzelm@24666
    85
  wrappers: wrapper list * wrapper list};
wenzelm@24666
    86
wenzelm@28290
    87
fun make_thy (axioms, defs, wrappers) = Thy {axioms = axioms, defs = defs, wrappers = wrappers};
wenzelm@24666
    88
wenzelm@24666
    89
structure ThyData = TheoryDataFun
wenzelm@24666
    90
(
wenzelm@24666
    91
  type T = thy;
wenzelm@33095
    92
  val empty = make_thy (Name_Space.empty_table, Defs.empty, ([], []));
wenzelm@24666
    93
  val copy = I;
wenzelm@24666
    94
wenzelm@32789
    95
  fun extend (Thy {axioms = _, defs, wrappers}) =
wenzelm@33095
    96
    make_thy (Name_Space.empty_table, defs, wrappers);
wenzelm@24666
    97
wenzelm@24666
    98
  fun merge pp (thy1, thy2) =
wenzelm@24666
    99
    let
wenzelm@28290
   100
      val Thy {axioms = _, defs = defs1, wrappers = (bgs1, ens1)} = thy1;
wenzelm@28290
   101
      val Thy {axioms = _, defs = defs2, wrappers = (bgs2, ens2)} = thy2;
wenzelm@24666
   102
wenzelm@33095
   103
      val axioms' = Name_Space.empty_table;
wenzelm@24666
   104
      val defs' = Defs.merge pp (defs1, defs2);
wenzelm@24666
   105
      val bgs' = Library.merge (eq_snd op =) (bgs1, bgs2);
wenzelm@24666
   106
      val ens' = Library.merge (eq_snd op =) (ens1, ens2);
wenzelm@28290
   107
    in make_thy (axioms', defs', (bgs', ens')) end;
wenzelm@24666
   108
);
wenzelm@24666
   109
wenzelm@24666
   110
fun rep_theory thy = ThyData.get thy |> (fn Thy args => args);
wenzelm@24666
   111
wenzelm@28290
   112
fun map_thy f = ThyData.map (fn (Thy {axioms, defs, wrappers}) =>
wenzelm@28290
   113
  make_thy (f (axioms, defs, wrappers)));
wenzelm@24666
   114
wenzelm@24666
   115
wenzelm@28290
   116
fun map_axioms f = map_thy (fn (axioms, defs, wrappers) => (f axioms, defs, wrappers));
wenzelm@28290
   117
fun map_defs f = map_thy (fn (axioms, defs, wrappers) => (axioms, f defs, wrappers));
wenzelm@28290
   118
fun map_wrappers f = map_thy (fn (axioms, defs, wrappers) => (axioms, defs, f wrappers));
wenzelm@24666
   119
wenzelm@24666
   120
wenzelm@24666
   121
(* basic operations *)
wenzelm@24666
   122
wenzelm@24666
   123
val axiom_space = #1 o #axioms o rep_theory;
wenzelm@24666
   124
val axiom_table = #2 o #axioms o rep_theory;
wenzelm@24666
   125
wenzelm@24666
   126
val axioms_of = Symtab.dest o #2 o #axioms o rep_theory;
wenzelm@24666
   127
fun all_axioms_of thy = maps axioms_of (thy :: ancestors_of thy);
wenzelm@24666
   128
wenzelm@24666
   129
val defs_of = #defs o rep_theory;
wenzelm@24666
   130
wenzelm@24666
   131
wenzelm@24666
   132
(* begin/end theory *)
wenzelm@24666
   133
wenzelm@24666
   134
val begin_wrappers = rev o #1 o #wrappers o rep_theory;
wenzelm@24666
   135
val end_wrappers = rev o #2 o #wrappers o rep_theory;
wenzelm@24666
   136
wenzelm@24666
   137
fun at_begin f = map_wrappers (apfst (cons (f, stamp ())));
wenzelm@24666
   138
fun at_end f = map_wrappers (apsnd (cons (f, stamp ())));
wenzelm@24666
   139
wenzelm@24666
   140
fun begin_theory name imports =
wenzelm@24666
   141
  let
wenzelm@26939
   142
    val thy = Context.begin_thy Syntax.pp_global name imports;
wenzelm@24666
   143
    val wrappers = begin_wrappers thy;
wenzelm@24666
   144
  in thy |> Sign.local_path |> apply_wrappers wrappers end;
wenzelm@24666
   145
wenzelm@24666
   146
fun end_theory thy =
wenzelm@24666
   147
  thy |> apply_wrappers (end_wrappers thy) |> Context.finish_thy;
wenzelm@24666
   148
wenzelm@16443
   149
wenzelm@3996
   150
wenzelm@24666
   151
(** add axioms **)
wenzelm@3814
   152
paulson@1526
   153
(* prepare axioms *)
paulson@1526
   154
haftmann@29581
   155
fun cert_axm thy (b, raw_tm) =
paulson@1526
   156
  let
wenzelm@32789
   157
    val t = Sign.cert_prop thy raw_tm
wenzelm@2979
   158
      handle TYPE (msg, _, _) => error msg
wenzelm@16291
   159
        | TERM (msg, _) => error msg;
paulson@1526
   160
  in
wenzelm@9537
   161
    Term.no_dummy_patterns t handle TERM (msg, _) => error msg;
haftmann@29581
   162
    (b, Sign.no_vars (Syntax.pp_global thy) t)
wenzelm@9629
   163
  end;
paulson@1526
   164
wenzelm@30337
   165
fun read_axm thy (b, str) =
wenzelm@30337
   166
  cert_axm thy (b, Syntax.read_prop_global thy str) handle ERROR msg =>
wenzelm@33092
   167
    cat_error msg ("The error(s) above occurred in axiom " ^ quote (Binding.str_of b));
paulson@1526
   168
paulson@1526
   169
wenzelm@16443
   170
(* add_axioms(_i) *)
paulson@1526
   171
wenzelm@16291
   172
local
wenzelm@16291
   173
wenzelm@16443
   174
fun gen_add_axioms prep_axm raw_axms thy = thy |> map_axioms (fn axioms =>
paulson@1526
   175
  let
haftmann@29581
   176
    val axms = map (apsnd Logic.varify o prep_axm thy) raw_axms;
wenzelm@33095
   177
    val axioms' = fold (#2 oo Name_Space.define true (Sign.naming_of thy)) axms axioms;
wenzelm@16443
   178
  in axioms' end);
paulson@1526
   179
wenzelm@16291
   180
in
wenzelm@16291
   181
haftmann@29581
   182
val add_axioms_i = gen_add_axioms cert_axm;
wenzelm@16291
   183
val add_axioms = gen_add_axioms read_axm;
wenzelm@16291
   184
wenzelm@16291
   185
end;
paulson@1526
   186
paulson@1526
   187
wenzelm@3767
   188
wenzelm@3767
   189
(** add constant definitions **)
wenzelm@3767
   190
wenzelm@19708
   191
(* dependencies *)
wenzelm@19708
   192
wenzelm@19708
   193
fun dependencies thy unchecked is_def name lhs rhs =
wenzelm@19708
   194
  let
wenzelm@26939
   195
    val pp = Syntax.pp_global thy;
wenzelm@19708
   196
    val consts = Sign.consts_of thy;
wenzelm@19727
   197
    fun prep const =
wenzelm@19727
   198
      let val Const (c, T) = Sign.no_vars pp (Const const)
wenzelm@26631
   199
      in (c, Consts.typargs consts (c, Logic.varifyT T)) end;
wenzelm@19708
   200
wenzelm@19708
   201
    val lhs_vars = Term.add_tfreesT (#2 lhs) [];
wenzelm@19708
   202
    val rhs_extras = fold (#2 #> Term.fold_atyps (fn TFree v =>
wenzelm@19708
   203
      if member (op =) lhs_vars v then I else insert (op =) v | _ => I)) rhs [];
wenzelm@19708
   204
    val _ =
wenzelm@19708
   205
      if null rhs_extras then ()
wenzelm@19708
   206
      else error ("Specification depends on extra type variables: " ^
wenzelm@19708
   207
        commas_quote (map (Pretty.string_of_typ pp o TFree) rhs_extras) ^
wenzelm@19708
   208
        "\nThe error(s) above occurred in " ^ quote name);
haftmann@24199
   209
  in Defs.define pp unchecked is_def name (prep lhs) (map prep rhs) end;
wenzelm@19708
   210
wenzelm@19708
   211
fun add_deps a raw_lhs raw_rhs thy =
wenzelm@19708
   212
  let
wenzelm@19708
   213
    val lhs :: rhs = map (dest_Const o Sign.cert_term thy o Const) (raw_lhs :: raw_rhs);
wenzelm@19708
   214
    val name = if a = "" then (#1 lhs ^ " axiom") else a;
wenzelm@19708
   215
  in thy |> map_defs (dependencies thy false false name lhs rhs) end;
wenzelm@17706
   216
wenzelm@28112
   217
fun specify_const tags decl thy =
wenzelm@25017
   218
  let val (t as Const const, thy') = Sign.declare_const tags decl thy
wenzelm@28112
   219
  in (t, add_deps "" const [] thy') end;
wenzelm@25017
   220
wenzelm@17706
   221
wenzelm@16944
   222
(* check_overloading *)
nipkow@9280
   223
wenzelm@16944
   224
fun check_overloading thy overloaded (c, T) =
wenzelm@16291
   225
  let
wenzelm@24763
   226
    val declT = Sign.the_const_constraint thy c
wenzelm@24763
   227
      handle TYPE (msg, _, _) => error msg;
wenzelm@19806
   228
    val T' = Logic.varifyT T;
wenzelm@16944
   229
wenzelm@16944
   230
    fun message txt =
wenzelm@16944
   231
      [Pretty.block [Pretty.str "Specification of constant ",
wenzelm@26939
   232
        Pretty.str c, Pretty.str " ::", Pretty.brk 1, Pretty.quote (Syntax.pretty_typ_global thy T)],
wenzelm@16944
   233
        Pretty.str txt] |> Pretty.chunks |> Pretty.string_of;
wenzelm@16291
   234
  in
wenzelm@16944
   235
    if Sign.typ_instance thy (declT, T') then ()
wenzelm@16944
   236
    else if Type.raw_instance (declT, T') then
wenzelm@32966
   237
      error (setmp_CRITICAL show_sorts true
wenzelm@16944
   238
        message "imposes additional sort constraints on the constant declaration")
wenzelm@16944
   239
    else if overloaded then ()
wenzelm@16944
   240
    else warning (message "is strictly less general than the declared type");
wenzelm@16944
   241
    (c, T)
nipkow@9280
   242
  end;
nipkow@9280
   243
wenzelm@3767
   244
wenzelm@16291
   245
(* check_def *)
wenzelm@16291
   246
haftmann@29581
   247
fun check_def thy unchecked overloaded (b, tm) defs =
wenzelm@16291
   248
  let
wenzelm@24981
   249
    val ctxt = ProofContext.init thy;
haftmann@29581
   250
    val name = Sign.full_name thy b;
wenzelm@24981
   251
    val (lhs_const, rhs) = Sign.cert_def ctxt tm;
wenzelm@16944
   252
    val rhs_consts = fold_aterms (fn Const const => insert (op =) const | _ => I) rhs [];
wenzelm@18943
   253
    val _ = check_overloading thy overloaded lhs_const;
wenzelm@19708
   254
  in defs |> dependencies thy unchecked true name lhs_const rhs_consts end
wenzelm@18678
   255
  handle ERROR msg => cat_error msg (Pretty.string_of (Pretty.block
wenzelm@30218
   256
   [Pretty.str ("The error(s) above occurred in definition " ^ quote (Binding.str_of b) ^ ":"),
wenzelm@26939
   257
    Pretty.fbrk, Pretty.quote (Syntax.pretty_term_global thy tm)]));
wenzelm@3767
   258
wenzelm@3767
   259
wenzelm@16443
   260
(* add_defs(_i) *)
wenzelm@3767
   261
wenzelm@16291
   262
local
wenzelm@9320
   263
wenzelm@19630
   264
fun gen_add_defs prep_axm unchecked overloaded raw_axms thy =
wenzelm@16443
   265
  let val axms = map (prep_axm thy) raw_axms in
wenzelm@16443
   266
    thy
wenzelm@19630
   267
    |> map_defs (fold (check_def thy unchecked overloaded) axms)
wenzelm@9320
   268
    |> add_axioms_i axms
wenzelm@3767
   269
  end;
wenzelm@3767
   270
wenzelm@16291
   271
in
wenzelm@16291
   272
wenzelm@16291
   273
val add_defs_i = gen_add_defs cert_axm;
wenzelm@16291
   274
val add_defs = gen_add_defs read_axm;
wenzelm@16291
   275
wenzelm@16291
   276
end;
wenzelm@3767
   277
wenzelm@3767
   278
wenzelm@16443
   279
(* add_finals(_i) *)
skalberg@14223
   280
wenzelm@16291
   281
local
wenzelm@16291
   282
wenzelm@17706
   283
fun gen_add_finals prep_term overloaded args thy =
skalberg@14223
   284
  let
wenzelm@17706
   285
    fun const_of (Const const) = const
wenzelm@17706
   286
      | const_of (Free _) = error "Attempt to finalize variable (or undeclared constant)"
wenzelm@17706
   287
      | const_of _ = error "Attempt to finalize non-constant term";
wenzelm@19708
   288
    fun specify (c, T) = dependencies thy false false (c ^ " axiom") (c, T) [];
wenzelm@24708
   289
    val finalize = specify o check_overloading thy overloaded o const_of o
wenzelm@24708
   290
      Sign.cert_term thy o prep_term thy;
wenzelm@17706
   291
  in thy |> map_defs (fold finalize args) end;
wenzelm@16291
   292
skalberg@14223
   293
in
wenzelm@16291
   294
haftmann@29581
   295
val add_finals_i = gen_add_finals (K I);
wenzelm@24708
   296
val add_finals = gen_add_finals Syntax.read_term_global;
wenzelm@16291
   297
skalberg@14223
   298
end;
skalberg@14223
   299
paulson@1526
   300
end;