src/Pure/Isar/method.ML
author wenzelm
Wed Aug 18 20:43:42 1999 +0200 (1999-08-18)
changeset 7268 315655dc361b
parent 7130 a17f7b5ac40f
child 7367 a79d4683fadf
permissions -rw-r--r--
sectioned_args etc.: more general modifier;
wenzelm@5824
     1
(*  Title:      Pure/Isar/method.ML
wenzelm@5824
     2
    ID:         $Id$
wenzelm@5824
     3
    Author:     Markus Wenzel, TU Muenchen
wenzelm@5824
     4
wenzelm@5824
     5
Proof methods.
wenzelm@5824
     6
*)
wenzelm@5824
     7
wenzelm@5824
     8
signature BASIC_METHOD =
wenzelm@5824
     9
sig
wenzelm@5824
    10
  val print_methods: theory -> unit
wenzelm@5824
    11
  val Method: bstring -> (Args.src -> Proof.context -> Proof.method) -> string -> unit
wenzelm@5824
    12
end;
wenzelm@5824
    13
wenzelm@5824
    14
signature METHOD =
wenzelm@5824
    15
sig
wenzelm@5824
    16
  include BASIC_METHOD
wenzelm@6775
    17
  val multi_resolve: thm list -> thm -> thm Seq.seq
wenzelm@6500
    18
  val FINISHED: tactic -> tactic
wenzelm@6091
    19
  val METHOD: (thm list -> tactic) -> Proof.method
wenzelm@5824
    20
  val METHOD0: tactic -> Proof.method
wenzelm@5824
    21
  val fail: Proof.method
wenzelm@5824
    22
  val succeed: Proof.method
wenzelm@6500
    23
  val same_tac: thm list -> int -> tactic
wenzelm@6108
    24
  val same: Proof.method
wenzelm@6981
    25
  val assumption_tac: thm list -> int -> tactic
wenzelm@5824
    26
  val assumption: Proof.method
wenzelm@5824
    27
  val forward_chain: thm list -> thm list -> thm Seq.seq
wenzelm@6091
    28
  val rule_tac: thm list -> thm list -> int -> tactic
wenzelm@7130
    29
  val erule_tac: thm list -> thm list -> int -> tactic
wenzelm@6091
    30
  val rule: thm list -> Proof.method
wenzelm@7130
    31
  val erule: thm list -> Proof.method
wenzelm@5916
    32
  exception METHOD_FAIL of (string * Position.T) * exn
wenzelm@5824
    33
  val method: theory -> Args.src -> Proof.context -> Proof.method
wenzelm@5824
    34
  val add_methods: (bstring * (Args.src -> Proof.context -> Proof.method) * string) list
wenzelm@5824
    35
    -> theory -> theory
wenzelm@5884
    36
  val syntax: (Proof.context * Args.T list -> 'a * (Proof.context * Args.T list)) ->
wenzelm@5884
    37
    Proof.context -> Args.src -> Proof.context * 'a
wenzelm@5884
    38
  val no_args: Proof.method -> Args.src -> Proof.context -> Proof.method
wenzelm@7268
    39
  type modifier
wenzelm@7268
    40
  val sectioned_args: ((Args.T list -> modifier * Args.T list) list ->
wenzelm@5884
    41
      Proof.context * Args.T list -> 'a * (Proof.context * Args.T list)) ->
wenzelm@7268
    42
    (Args.T list -> modifier * Args.T list) list ->
wenzelm@5884
    43
    ('a -> Proof.context -> Proof.method) -> Args.src -> Proof.context -> Proof.method
wenzelm@7268
    44
  val default_sectioned_args: modifier ->
wenzelm@7268
    45
    (Args.T list -> modifier * Args.T list) list ->
wenzelm@5884
    46
    (Proof.context -> Proof.method) -> Args.src -> Proof.context -> Proof.method
wenzelm@7268
    47
  val only_sectioned_args: (Args.T list -> modifier * Args.T list) list ->
wenzelm@5884
    48
    (Proof.context -> Proof.method) -> Args.src -> Proof.context -> Proof.method
wenzelm@6091
    49
  val thms_args: (thm list -> Proof.method) -> Args.src -> Proof.context -> Proof.method
wenzelm@5824
    50
  datatype text =
wenzelm@5824
    51
    Basic of (Proof.context -> Proof.method) |
wenzelm@5824
    52
    Source of Args.src |
wenzelm@5824
    53
    Then of text list |
wenzelm@5824
    54
    Orelse of text list |
wenzelm@5824
    55
    Try of text |
wenzelm@5824
    56
    Repeat of text |
wenzelm@5824
    57
    Repeat1 of text
wenzelm@5824
    58
  val refine: text -> Proof.state -> Proof.state Seq.seq
wenzelm@5824
    59
  val tac: text -> Proof.state -> Proof.state Seq.seq
wenzelm@5884
    60
  val then_tac: text -> Proof.state -> Proof.state Seq.seq
wenzelm@5824
    61
  val proof: text option -> Proof.state -> Proof.state Seq.seq
wenzelm@6981
    62
  val local_qed: text option
wenzelm@6981
    63
    -> ({kind: string, name: string, thm: thm} -> unit) * (thm -> unit)
wenzelm@6736
    64
    -> Proof.state -> Proof.state Seq.seq
wenzelm@6981
    65
  val local_terminal_proof: text * text option
wenzelm@6981
    66
    -> ({kind: string, name: string, thm: thm} -> unit) * (thm -> unit)
wenzelm@6736
    67
    -> Proof.state -> Proof.state Seq.seq
wenzelm@6981
    68
  val local_immediate_proof: ({kind: string, name: string, thm: thm} -> unit) * (thm -> unit)
wenzelm@6981
    69
    -> Proof.state -> Proof.state Seq.seq
wenzelm@6981
    70
  val local_default_proof: ({kind: string, name: string, thm: thm} -> unit) * (thm -> unit)
wenzelm@6736
    71
    -> Proof.state -> Proof.state Seq.seq
wenzelm@6951
    72
  val global_qed: text option -> Proof.state -> theory * {kind: string, name: string, thm: thm}
wenzelm@6934
    73
  val global_terminal_proof: text * text option
wenzelm@6934
    74
    -> Proof.state -> theory * {kind: string, name: string, thm: thm}
wenzelm@6532
    75
  val global_immediate_proof: Proof.state -> theory * {kind: string, name: string, thm: thm}
wenzelm@6532
    76
  val global_default_proof: Proof.state -> theory * {kind: string, name: string, thm: thm}
wenzelm@5824
    77
  val setup: (theory -> theory) list
wenzelm@5824
    78
end;
wenzelm@5824
    79
wenzelm@5824
    80
structure Method: METHOD =
wenzelm@5824
    81
struct
wenzelm@5824
    82
wenzelm@5824
    83
wenzelm@6500
    84
(** utils **)
wenzelm@6500
    85
wenzelm@6500
    86
val FINISHED = FILTER (equal 0 o Thm.nprems_of);
wenzelm@6500
    87
wenzelm@6500
    88
wenzelm@6500
    89
wenzelm@5824
    90
(** proof methods **)
wenzelm@5824
    91
wenzelm@5824
    92
(* method from tactic *)
wenzelm@5824
    93
wenzelm@6849
    94
val METHOD = Proof.method;
wenzelm@5824
    95
fun METHOD0 tac = METHOD (fn [] => tac | _ => error "Method may not be used with facts");
wenzelm@5824
    96
wenzelm@5824
    97
wenzelm@5824
    98
(* primitive *)
wenzelm@5824
    99
wenzelm@5824
   100
val fail = METHOD (K no_tac);
wenzelm@5824
   101
val succeed = METHOD (K all_tac);
wenzelm@5824
   102
wenzelm@5824
   103
wenzelm@6981
   104
(* same *)
wenzelm@5824
   105
wenzelm@6981
   106
fun cut_rule_tac raw_rule =
wenzelm@6981
   107
  let
wenzelm@6981
   108
    val rule = Drule.forall_intr_vars raw_rule;
wenzelm@6981
   109
    val revcut_rl = Drule.incr_indexes_wrt [] [] [] [rule] Drule.revcut_rl;
wenzelm@6981
   110
  in Tactic.rtac (rule COMP revcut_rl) THEN' Tactic.rotate_tac ~1 end;
wenzelm@6981
   111
wenzelm@6981
   112
fun same_tac [] i = all_tac
wenzelm@6981
   113
  | same_tac facts i = EVERY (map (fn th => cut_rule_tac th i) facts);
wenzelm@5824
   114
wenzelm@6108
   115
val same = METHOD (ALLGOALS o same_tac);
wenzelm@6981
   116
wenzelm@5824
   117
wenzelm@6981
   118
(* assumption *)
wenzelm@6981
   119
wenzelm@6981
   120
fun assumption_tac facts = same_tac facts THEN' assume_tac;
wenzelm@6981
   121
val assumption = METHOD (FIRSTGOAL o assumption_tac);
wenzelm@6500
   122
val asm_finish = METHOD (K (FINISHED (ALLGOALS assume_tac)));
wenzelm@5824
   123
wenzelm@5824
   124
wenzelm@6532
   125
(* fold / unfold definitions *)
wenzelm@6532
   126
wenzelm@6532
   127
val fold = METHOD0 o fold_goals_tac;
wenzelm@6532
   128
val unfold = METHOD0 o rewrite_goals_tac;
wenzelm@6532
   129
wenzelm@6532
   130
wenzelm@5824
   131
(* rule *)
wenzelm@5824
   132
wenzelm@5824
   133
fun res th i rule = Thm.biresolution false [(false, th)] i rule handle THM _ => Seq.empty;
wenzelm@5824
   134
wenzelm@5824
   135
fun multi_resolve facts rule =
wenzelm@5824
   136
  let
wenzelm@5824
   137
    fun multi_res i [] = Seq.single rule
wenzelm@5824
   138
      | multi_res i (th :: ths) = Seq.flat (Seq.map (res th i) (multi_res (i + 1) ths))
wenzelm@5824
   139
  in multi_res 1 facts end;
wenzelm@5824
   140
wenzelm@5824
   141
fun forward_chain facts rules = Seq.flat (Seq.map (multi_resolve facts) (Seq.of_list rules));
wenzelm@5824
   142
wenzelm@7130
   143
fun gen_rule_tac tac rules [] = tac rules
wenzelm@7130
   144
  | gen_rule_tac tac erules facts =
wenzelm@5824
   145
      let
wenzelm@6091
   146
        val rules = forward_chain facts erules;
wenzelm@7130
   147
        fun tactic i state = Seq.flat (Seq.map (fn rule => tac [rule] i state) rules);
wenzelm@7130
   148
      in tactic end;
wenzelm@7130
   149
wenzelm@7130
   150
val rule_tac = gen_rule_tac Tactic.resolve_tac;
wenzelm@7130
   151
val erule_tac = gen_rule_tac Tactic.eresolve_tac;
wenzelm@5824
   152
wenzelm@5824
   153
fun rule rules = METHOD (FIRSTGOAL o rule_tac rules);
wenzelm@7130
   154
fun erule rules = METHOD (FIRSTGOAL o erule_tac rules);
wenzelm@5824
   155
wenzelm@5824
   156
wenzelm@5824
   157
wenzelm@5824
   158
(** methods theory data **)
wenzelm@5824
   159
wenzelm@5824
   160
(* data kind 'Isar/methods' *)
wenzelm@5824
   161
wenzelm@5824
   162
structure MethodsDataArgs =
wenzelm@5824
   163
struct
wenzelm@5824
   164
  val name = "Isar/methods";
wenzelm@5824
   165
  type T =
wenzelm@5824
   166
    {space: NameSpace.T,
wenzelm@5824
   167
     meths: (((Args.src -> Proof.context -> Proof.method) * string) * stamp) Symtab.table};
wenzelm@5824
   168
wenzelm@5824
   169
  val empty = {space = NameSpace.empty, meths = Symtab.empty};
wenzelm@6546
   170
  val copy = I;
wenzelm@5824
   171
  val prep_ext = I;
wenzelm@5824
   172
  fun merge ({space = space1, meths = meths1}, {space = space2, meths = meths2}) =
wenzelm@5824
   173
    {space = NameSpace.merge (space1, space2),
wenzelm@5824
   174
      meths = Symtab.merge eq_snd (meths1, meths2) handle Symtab.DUPS dups =>
wenzelm@5824
   175
        error ("Attempt to merge different versions of methods " ^ commas_quote dups)};
wenzelm@5824
   176
wenzelm@5824
   177
  fun print _ {space, meths} =
wenzelm@5824
   178
    let
wenzelm@5824
   179
      fun prt_meth (name, ((_, comment), _)) = Pretty.block
wenzelm@6849
   180
        [Pretty.str (name ^ ":"), Pretty.brk 2, Pretty.str comment];
wenzelm@5824
   181
    in
wenzelm@5824
   182
      Pretty.writeln (Display.pretty_name_space ("method name space", space));
wenzelm@6849
   183
      Pretty.writeln (Pretty.big_list "methods:"
wenzelm@6849
   184
        (map prt_meth (NameSpace.cond_extern_table space meths)))
wenzelm@5824
   185
    end;
wenzelm@5824
   186
end;
wenzelm@5824
   187
wenzelm@5824
   188
structure MethodsData = TheoryDataFun(MethodsDataArgs);
wenzelm@5824
   189
val print_methods = MethodsData.print;
wenzelm@5824
   190
wenzelm@5824
   191
wenzelm@5824
   192
(* get methods *)
wenzelm@5824
   193
wenzelm@5916
   194
exception METHOD_FAIL of (string * Position.T) * exn;
wenzelm@5916
   195
wenzelm@5824
   196
fun method thy =
wenzelm@5824
   197
  let
wenzelm@5824
   198
    val {space, meths} = MethodsData.get thy;
wenzelm@5824
   199
wenzelm@5884
   200
    fun meth src =
wenzelm@5884
   201
      let
wenzelm@5884
   202
        val ((raw_name, _), pos) = Args.dest_src src;
wenzelm@5884
   203
        val name = NameSpace.intern space raw_name;
wenzelm@5884
   204
      in
wenzelm@5824
   205
        (case Symtab.lookup (meths, name) of
wenzelm@5824
   206
          None => error ("Unknown proof method: " ^ quote name ^ Position.str_of pos)
wenzelm@5916
   207
        | Some ((mth, _), _) => transform_failure (curry METHOD_FAIL (name, pos)) (mth src))
wenzelm@5824
   208
      end;
wenzelm@5824
   209
  in meth end;
wenzelm@5824
   210
wenzelm@5824
   211
wenzelm@5824
   212
(* add_methods *)
wenzelm@5824
   213
wenzelm@5824
   214
fun add_methods raw_meths thy =
wenzelm@5824
   215
  let
wenzelm@5824
   216
    val full = Sign.full_name (Theory.sign_of thy);
wenzelm@5824
   217
    val new_meths =
wenzelm@5824
   218
      map (fn (name, f, comment) => (full name, ((f, comment), stamp ()))) raw_meths;
wenzelm@5824
   219
wenzelm@5824
   220
    val {space, meths} = MethodsData.get thy;
wenzelm@5824
   221
    val space' = NameSpace.extend (space, map fst new_meths);
wenzelm@5824
   222
    val meths' = Symtab.extend (meths, new_meths) handle Symtab.DUPS dups =>
wenzelm@5824
   223
      error ("Duplicate declaration of method(s) " ^ commas_quote dups);
wenzelm@5824
   224
  in
wenzelm@5824
   225
    thy |> MethodsData.put {space = space', meths = meths'}
wenzelm@5824
   226
  end;
wenzelm@5824
   227
wenzelm@5824
   228
(*implicit version*)
wenzelm@5824
   229
fun Method name meth cmt = Context.>> (add_methods [(name, meth, cmt)]);
wenzelm@5824
   230
wenzelm@5824
   231
wenzelm@5884
   232
wenzelm@5884
   233
(** method syntax **)
wenzelm@5824
   234
wenzelm@5884
   235
(* basic *)
wenzelm@5884
   236
wenzelm@5884
   237
fun syntax (scan: (Proof.context * Args.T list -> 'a * (Proof.context * Args.T list))) =
wenzelm@5884
   238
  Args.syntax "method" scan;
wenzelm@5824
   239
wenzelm@5884
   240
fun no_args (x: Proof.method) src ctxt = #2 (syntax (Scan.succeed x) ctxt src);
wenzelm@5884
   241
wenzelm@5884
   242
wenzelm@5884
   243
(* sections *)
wenzelm@5824
   244
wenzelm@7268
   245
type modifier = (Proof.context -> Proof.context) * Proof.context attribute;
wenzelm@7268
   246
wenzelm@7268
   247
local
wenzelm@7268
   248
wenzelm@5884
   249
fun sect ss = Scan.first (map (fn s => Scan.lift (s --| Args.$$$ ":")) ss);
wenzelm@5884
   250
fun thms ss = Scan.unless (sect ss) Attrib.local_thms;
wenzelm@5884
   251
fun thmss ss = Scan.repeat (thms ss) >> flat;
wenzelm@5884
   252
wenzelm@7268
   253
fun apply (f, att) (ctxt, ths) = Thm.applys_attributes ((f ctxt, ths), [att]);
wenzelm@5824
   254
wenzelm@7268
   255
fun section ss = (sect ss -- thmss ss) :-- (fn (m, ths) => Scan.depend (fn ctxt =>
wenzelm@7268
   256
  Scan.succeed (apply m (ctxt, ths)))) >> #2;
wenzelm@5884
   257
wenzelm@5884
   258
fun sectioned args ss = args ss -- Scan.repeat (section ss);
wenzelm@5884
   259
wenzelm@7268
   260
in
wenzelm@5824
   261
wenzelm@5884
   262
fun sectioned_args args ss f src ctxt =
wenzelm@5921
   263
  let val (ctxt', (x, _)) = syntax (sectioned args ss) ctxt src
wenzelm@5921
   264
  in f x ctxt' end;
wenzelm@5884
   265
wenzelm@7268
   266
fun default_sectioned_args m ss f src ctxt =
wenzelm@7268
   267
  sectioned_args thmss ss (fn ths => fn ctxt' => f (#1 (apply m (ctxt', ths)))) src ctxt;
wenzelm@5884
   268
wenzelm@5884
   269
fun only_sectioned_args ss f = sectioned_args (K (Scan.succeed ())) ss (fn () => f);
wenzelm@7268
   270
wenzelm@5884
   271
fun thms_args f = sectioned_args thmss [] (fn ths => fn _ => f ths);
wenzelm@5824
   272
wenzelm@7268
   273
end;
wenzelm@7268
   274
wenzelm@5824
   275
wenzelm@5824
   276
wenzelm@5824
   277
(** method text **)
wenzelm@5824
   278
wenzelm@5824
   279
(* datatype text *)
wenzelm@5824
   280
wenzelm@5824
   281
datatype text =
wenzelm@5824
   282
  Basic of (Proof.context -> Proof.method) |
wenzelm@5824
   283
  Source of Args.src |
wenzelm@5824
   284
  Then of text list |
wenzelm@5824
   285
  Orelse of text list |
wenzelm@5824
   286
  Try of text |
wenzelm@5824
   287
  Repeat of text |
wenzelm@5824
   288
  Repeat1 of text;
wenzelm@5824
   289
wenzelm@5824
   290
wenzelm@5824
   291
(* refine *)
wenzelm@5824
   292
wenzelm@5824
   293
fun refine text state =
wenzelm@5824
   294
  let
wenzelm@5824
   295
    val thy = Proof.theory_of state;
wenzelm@5824
   296
wenzelm@5824
   297
    fun eval (Basic mth) = Proof.refine mth
wenzelm@5824
   298
      | eval (Source src) = Proof.refine (method thy src)
wenzelm@5824
   299
      | eval (Then txts) = Seq.EVERY (map eval txts)
wenzelm@5824
   300
      | eval (Orelse txts) = Seq.FIRST (map eval txts)
wenzelm@5824
   301
      | eval (Try txt) = Seq.TRY (eval txt)
wenzelm@5824
   302
      | eval (Repeat txt) = Seq.REPEAT (eval txt)
wenzelm@5824
   303
      | eval (Repeat1 txt) = Seq.REPEAT1 (eval txt);
wenzelm@5824
   304
  in eval text state end;
wenzelm@5824
   305
wenzelm@6404
   306
fun named_method name = Source (Args.src ((name, []), Position.none));
wenzelm@6404
   307
wenzelm@5824
   308
wenzelm@5824
   309
(* unstructured steps *)
wenzelm@5824
   310
wenzelm@5824
   311
fun tac text state =
wenzelm@5824
   312
  state
wenzelm@5824
   313
  |> Proof.goal_facts (K [])
wenzelm@5824
   314
  |> refine text;
wenzelm@5824
   315
wenzelm@5884
   316
fun then_tac text state =
wenzelm@5824
   317
  state
wenzelm@5824
   318
  |> Proof.goal_facts Proof.the_facts
wenzelm@5824
   319
  |> refine text;
wenzelm@5824
   320
wenzelm@5824
   321
wenzelm@6404
   322
(* structured proof steps *)
wenzelm@5824
   323
wenzelm@6404
   324
val default_text = named_method "default";
wenzelm@6404
   325
val finish_text = named_method "finish";
wenzelm@5824
   326
wenzelm@6872
   327
wenzelm@5824
   328
fun proof opt_text state =
wenzelm@5824
   329
  state
wenzelm@5824
   330
  |> Proof.assert_backward
wenzelm@6404
   331
  |> refine (if_none opt_text default_text)
wenzelm@5824
   332
  |> Seq.map Proof.enter_forward;
wenzelm@5824
   333
wenzelm@6404
   334
fun local_qed opt_text = Proof.local_qed (refine (if_none opt_text finish_text));
wenzelm@6934
   335
fun local_terminal_proof (text, opt_text) pr = Seq.THEN (proof (Some text), local_qed opt_text pr);
wenzelm@6934
   336
val local_immediate_proof = local_terminal_proof (Basic (K same), None);
wenzelm@6934
   337
val local_default_proof = local_terminal_proof (default_text, None);
wenzelm@5824
   338
wenzelm@6872
   339
wenzelm@6951
   340
fun global_qeds opt_text = Proof.global_qed (refine (if_none opt_text finish_text));
wenzelm@5824
   341
wenzelm@6951
   342
fun global_qed opt_text state =
wenzelm@6872
   343
  state
wenzelm@6951
   344
  |> global_qeds opt_text
wenzelm@6872
   345
  |> Proof.check_result "Failed to finish proof" state
wenzelm@6872
   346
  |> Seq.hd;
wenzelm@6872
   347
wenzelm@6934
   348
fun global_terminal_proof (text, opt_text) state =
wenzelm@6872
   349
  state
wenzelm@6872
   350
  |> proof (Some text)
wenzelm@6872
   351
  |> Proof.check_result "Terminal proof method failed" state
wenzelm@6951
   352
  |> (Seq.flat o Seq.map (global_qeds opt_text))
wenzelm@6872
   353
  |> Proof.check_result "Failed to finish proof (after successful terminal method)" state
wenzelm@6872
   354
  |> Seq.hd;
wenzelm@6872
   355
wenzelm@6934
   356
val global_immediate_proof = global_terminal_proof (Basic (K same), None);
wenzelm@6934
   357
val global_default_proof = global_terminal_proof (default_text, None);
wenzelm@5824
   358
wenzelm@5824
   359
wenzelm@5824
   360
wenzelm@5824
   361
(** theory setup **)
wenzelm@5824
   362
wenzelm@5824
   363
(* pure_methods *)
wenzelm@5824
   364
wenzelm@5824
   365
val pure_methods =
wenzelm@5824
   366
 [("fail", no_args fail, "force failure"),
wenzelm@5824
   367
  ("succeed", no_args succeed, "succeed"),
wenzelm@7130
   368
  ("-", no_args same, "insert facts, nothing else"),
wenzelm@5824
   369
  ("assumption", no_args assumption, "proof by assumption"),
wenzelm@5824
   370
  ("finish", no_args asm_finish, "finish proof by assumption"),
wenzelm@6532
   371
  ("fold", thms_args fold, "fold definitions"),
wenzelm@6532
   372
  ("unfold", thms_args unfold, "unfold definitions"),
wenzelm@7130
   373
  ("rule", thms_args rule, "apply some rule"),
wenzelm@7130
   374
  ("erule", thms_args erule, "apply some erule (improper!)")];
wenzelm@5824
   375
wenzelm@5824
   376
wenzelm@5824
   377
(* setup *)
wenzelm@5824
   378
wenzelm@5824
   379
val setup = [MethodsData.init, add_methods pure_methods];
wenzelm@5824
   380
wenzelm@5824
   381
wenzelm@5824
   382
end;
wenzelm@5824
   383
wenzelm@5824
   384
wenzelm@5824
   385
structure BasicMethod: BASIC_METHOD = Method;
wenzelm@5824
   386
open BasicMethod;