src/Pure/Isar/method.ML
author wenzelm
Fri Sep 01 00:33:36 2000 +0200 (2000-09-01)
changeset 9777 232fb8886765
parent 9706 8e48a19fc81e
child 9864 b4a170f7d658
permissions -rw-r--r--
added bang_sectioned_args';
wenzelm@5824
     1
(*  Title:      Pure/Isar/method.ML
wenzelm@5824
     2
    ID:         $Id$
wenzelm@5824
     3
    Author:     Markus Wenzel, TU Muenchen
wenzelm@8807
     4
    License:    GPL (GNU GENERAL PUBLIC LICENSE)
wenzelm@5824
     5
wenzelm@5824
     6
Proof methods.
wenzelm@5824
     7
*)
wenzelm@5824
     8
wenzelm@5824
     9
signature BASIC_METHOD =
wenzelm@5824
    10
sig
wenzelm@5824
    11
  val print_methods: theory -> unit
wenzelm@5824
    12
  val Method: bstring -> (Args.src -> Proof.context -> Proof.method) -> string -> unit
wenzelm@5824
    13
end;
wenzelm@5824
    14
wenzelm@5824
    15
signature METHOD =
wenzelm@5824
    16
sig
wenzelm@5824
    17
  include BASIC_METHOD
wenzelm@8153
    18
  val print_global_rules: theory -> unit
wenzelm@8153
    19
  val print_local_rules: Proof.context -> unit
wenzelm@8153
    20
  val dest_global: theory attribute
wenzelm@8153
    21
  val elim_global: theory attribute
wenzelm@8153
    22
  val intro_global: theory attribute
wenzelm@8153
    23
  val delrule_global: theory attribute
wenzelm@8153
    24
  val dest_local: Proof.context attribute
wenzelm@8153
    25
  val elim_local: Proof.context attribute
wenzelm@8153
    26
  val intro_local: Proof.context attribute
wenzelm@8153
    27
  val delrule_local: Proof.context attribute
wenzelm@6091
    28
  val METHOD: (thm list -> tactic) -> Proof.method
wenzelm@8372
    29
  val METHOD_CASES:
wenzelm@8372
    30
    (thm list -> thm -> (thm * (string * RuleCases.T) list) Seq.seq) -> Proof.method
wenzelm@9706
    31
  val SIMPLE_METHOD: tactic -> Proof.method
wenzelm@9706
    32
  val SIMPLE_METHOD': ((int -> tactic) -> tactic) -> (int -> tactic) -> Proof.method
wenzelm@5824
    33
  val fail: Proof.method
wenzelm@5824
    34
  val succeed: Proof.method
wenzelm@8167
    35
  val defer: int option -> Proof.method
wenzelm@8167
    36
  val prefer: int -> Proof.method
wenzelm@7419
    37
  val insert_tac: thm list -> int -> tactic
wenzelm@7574
    38
  val insert: thm list -> Proof.method
wenzelm@7555
    39
  val insert_facts: Proof.method
wenzelm@7601
    40
  val unfold: thm list -> Proof.method
wenzelm@7419
    41
  val fold: thm list -> Proof.method
wenzelm@9484
    42
  val atomize_tac: thm list -> int -> tactic
wenzelm@9485
    43
  val atomize_goal: thm list -> int -> thm -> thm
wenzelm@7419
    44
  val multi_resolve: thm list -> thm -> thm Seq.seq
wenzelm@7419
    45
  val multi_resolves: thm list -> thm list -> thm Seq.seq
wenzelm@8335
    46
  val resolveq_tac: thm Seq.seq -> int -> tactic
wenzelm@9294
    47
  val resolveq_cases_tac: bool -> (thm * string list) Seq.seq
wenzelm@8372
    48
    -> int -> thm -> (thm * (string * RuleCases.T) list) Seq.seq
wenzelm@6091
    49
  val rule_tac: thm list -> thm list -> int -> tactic
wenzelm@9587
    50
  val erule_tac: thm list -> thm list -> int -> tactic
wenzelm@6091
    51
  val rule: thm list -> Proof.method
wenzelm@7130
    52
  val erule: thm list -> Proof.method
wenzelm@8220
    53
  val drule: thm list -> Proof.method
wenzelm@8220
    54
  val frule: thm list -> Proof.method
wenzelm@8195
    55
  val this: Proof.method
wenzelm@7555
    56
  val assumption: Proof.context -> Proof.method
wenzelm@8351
    57
  val set_tactic: (Proof.context -> thm list -> tactic) -> unit
wenzelm@8351
    58
  val tactic: string -> Proof.context -> Proof.method
wenzelm@5916
    59
  exception METHOD_FAIL of (string * Position.T) * exn
wenzelm@5824
    60
  val method: theory -> Args.src -> Proof.context -> Proof.method
wenzelm@9539
    61
  val add_method: bstring * (Args.src -> Proof.context -> Proof.method) * string
wenzelm@9539
    62
    -> theory -> theory
wenzelm@5824
    63
  val add_methods: (bstring * (Args.src -> Proof.context -> Proof.method) * string) list
wenzelm@5824
    64
    -> theory -> theory
wenzelm@5884
    65
  val syntax: (Proof.context * Args.T list -> 'a * (Proof.context * Args.T list)) ->
wenzelm@8282
    66
    Args.src -> Proof.context -> Proof.context * 'a
wenzelm@8351
    67
  val simple_args: (Args.T list -> 'a * Args.T list)
wenzelm@8351
    68
    -> ('a -> Proof.context -> Proof.method) -> Args.src -> Proof.context -> Proof.method
wenzelm@7555
    69
  val ctxt_args: (Proof.context -> Proof.method) -> Args.src -> Proof.context -> Proof.method
wenzelm@5884
    70
  val no_args: Proof.method -> Args.src -> Proof.context -> Proof.method
wenzelm@7268
    71
  type modifier
wenzelm@7601
    72
  val sectioned_args: (Proof.context * Args.T list -> 'a * (Proof.context * Args.T list)) ->
wenzelm@7268
    73
    (Args.T list -> modifier * Args.T list) list ->
wenzelm@5884
    74
    ('a -> Proof.context -> Proof.method) -> Args.src -> Proof.context -> Proof.method
wenzelm@7601
    75
  val bang_sectioned_args:
wenzelm@7601
    76
    (Args.T list -> modifier * Args.T list) list ->
wenzelm@7555
    77
    (thm list -> Proof.context -> Proof.method) -> Args.src -> Proof.context -> Proof.method
wenzelm@9777
    78
  val bang_sectioned_args':
wenzelm@9777
    79
    (Args.T list -> modifier * Args.T list) list ->
wenzelm@9777
    80
    (Proof.context * Args.T list -> 'a * (Proof.context * Args.T list)) ->
wenzelm@9777
    81
    ('a -> thm list -> Proof.context -> Proof.method) -> Args.src -> Proof.context -> Proof.method
wenzelm@7601
    82
  val only_sectioned_args:
wenzelm@7601
    83
    (Args.T list -> modifier * Args.T list) list ->
wenzelm@5884
    84
    (Proof.context -> Proof.method) -> Args.src -> Proof.context -> Proof.method
wenzelm@8093
    85
  val thms_ctxt_args: (thm list -> Proof.context -> Proof.method)
wenzelm@8093
    86
    -> Args.src -> Proof.context -> Proof.method
wenzelm@6091
    87
  val thms_args: (thm list -> Proof.method) -> Args.src -> Proof.context -> Proof.method
wenzelm@9706
    88
  val thm_args: (thm -> Proof.method) -> Args.src -> Proof.context -> Proof.method
wenzelm@5824
    89
  datatype text =
wenzelm@5824
    90
    Basic of (Proof.context -> Proof.method) |
wenzelm@5824
    91
    Source of Args.src |
wenzelm@5824
    92
    Then of text list |
wenzelm@5824
    93
    Orelse of text list |
wenzelm@5824
    94
    Try of text |
wenzelm@5824
    95
    Repeat1 of text
wenzelm@5824
    96
  val refine: text -> Proof.state -> Proof.state Seq.seq
wenzelm@8238
    97
  val refine_end: text -> Proof.state -> Proof.state Seq.seq
wenzelm@5824
    98
  val proof: text option -> Proof.state -> Proof.state Seq.seq
wenzelm@8966
    99
  val local_qed: bool -> text option
wenzelm@6981
   100
    -> ({kind: string, name: string, thm: thm} -> unit) * (thm -> unit)
wenzelm@6736
   101
    -> Proof.state -> Proof.state Seq.seq
wenzelm@6981
   102
  val local_terminal_proof: text * text option
wenzelm@6981
   103
    -> ({kind: string, name: string, thm: thm} -> unit) * (thm -> unit)
wenzelm@6736
   104
    -> Proof.state -> Proof.state Seq.seq
wenzelm@6981
   105
  val local_default_proof: ({kind: string, name: string, thm: thm} -> unit) * (thm -> unit)
wenzelm@6736
   106
    -> Proof.state -> Proof.state Seq.seq
wenzelm@8966
   107
  val local_immediate_proof: ({kind: string, name: string, thm: thm} -> unit) * (thm -> unit)
wenzelm@8966
   108
    -> Proof.state -> Proof.state Seq.seq
wenzelm@8966
   109
  val local_done_proof: ({kind: string, name: string, thm: thm} -> unit) * (thm -> unit)
wenzelm@8966
   110
    -> Proof.state -> Proof.state Seq.seq
wenzelm@8966
   111
  val global_qed: bool -> text option
wenzelm@8966
   112
    -> Proof.state -> theory * {kind: string, name: string, thm: thm}
wenzelm@6934
   113
  val global_terminal_proof: text * text option
wenzelm@6934
   114
    -> Proof.state -> theory * {kind: string, name: string, thm: thm}
wenzelm@8966
   115
  val global_default_proof: Proof.state -> theory * {kind: string, name: string, thm: thm}
wenzelm@6532
   116
  val global_immediate_proof: Proof.state -> theory * {kind: string, name: string, thm: thm}
wenzelm@8966
   117
  val global_done_proof: Proof.state -> theory * {kind: string, name: string, thm: thm}
wenzelm@9539
   118
  val goal_args: (Args.T list -> 'a * Args.T list) -> ('a -> int -> tactic)
wenzelm@9539
   119
    -> Args.src -> Proof.context -> Proof.method
wenzelm@9539
   120
  val goal_args': (Proof.context * Args.T list -> 'a * (Proof.context * Args.T list))
wenzelm@9539
   121
    -> ('a -> int -> tactic) -> Args.src -> Proof.context -> Proof.method
wenzelm@5824
   122
  val setup: (theory -> theory) list
wenzelm@5824
   123
end;
wenzelm@5824
   124
wenzelm@5824
   125
structure Method: METHOD =
wenzelm@5824
   126
struct
wenzelm@5824
   127
wenzelm@5824
   128
wenzelm@8153
   129
(** global and local rule data **)
wenzelm@8153
   130
wenzelm@8153
   131
fun prt_rules kind ths =
wenzelm@8153
   132
  Pretty.writeln (Pretty.big_list ("standard " ^ kind ^ " rules:") (map Display.pretty_thm ths));
wenzelm@8153
   133
wenzelm@8153
   134
fun print_rules (intro, elim) =
wenzelm@8153
   135
  (prt_rules "introduction" intro; prt_rules "elimination" elim);
wenzelm@8153
   136
wenzelm@8153
   137
wenzelm@8153
   138
(* theory data kind 'Isar/rules' *)
wenzelm@8153
   139
wenzelm@8153
   140
structure GlobalRulesArgs =
wenzelm@8153
   141
struct
wenzelm@8153
   142
  val name = "Isar/rules";
wenzelm@8153
   143
  type T = thm list * thm list;
wenzelm@8153
   144
wenzelm@8153
   145
  val empty = ([], []);
wenzelm@8153
   146
  val copy = I;
wenzelm@8153
   147
  val prep_ext = I;
wenzelm@8153
   148
  fun merge ((intro1, elim1), (intro2, elim2)) =
wenzelm@9418
   149
    (Drule.merge_rules (intro1, intro2), Drule.merge_rules (elim1, elim2));
wenzelm@8153
   150
  fun print _ = print_rules;
wenzelm@8153
   151
end;
wenzelm@8153
   152
wenzelm@8153
   153
structure GlobalRules = TheoryDataFun(GlobalRulesArgs);
wenzelm@8153
   154
val print_global_rules = GlobalRules.print;
wenzelm@8153
   155
wenzelm@8153
   156
wenzelm@8153
   157
(* proof data kind 'Isar/rules' *)
wenzelm@8153
   158
wenzelm@8153
   159
structure LocalRulesArgs =
wenzelm@8153
   160
struct
wenzelm@8153
   161
  val name = "Isar/rules";
wenzelm@8153
   162
  type T = thm list * thm list;
wenzelm@8153
   163
wenzelm@8153
   164
  val init = GlobalRules.get;
wenzelm@8153
   165
  fun print _ = print_rules;
wenzelm@8153
   166
end;
wenzelm@8153
   167
wenzelm@8153
   168
structure LocalRules = ProofDataFun(LocalRulesArgs);
wenzelm@8153
   169
val print_local_rules = LocalRules.print;
wenzelm@8153
   170
wenzelm@8153
   171
wenzelm@8153
   172
wenzelm@8153
   173
(** attributes **)
wenzelm@8153
   174
wenzelm@8153
   175
(* add rules *)
wenzelm@8153
   176
wenzelm@8153
   177
local
wenzelm@8153
   178
wenzelm@8153
   179
fun add_rule thm rules = Library.gen_ins Thm.eq_thm (thm, rules);
wenzelm@8153
   180
fun del_rule thm rules = Library.gen_rem Thm.eq_thm (rules, thm);
wenzelm@8153
   181
wenzelm@8153
   182
fun add_dest thm (intro, elim) = (intro, add_rule (Tactic.make_elim thm) elim);
wenzelm@8153
   183
fun add_elim thm (intro, elim) = (intro, add_rule thm elim);
wenzelm@8153
   184
fun add_intro thm (intro, elim) = (add_rule thm intro, elim);
wenzelm@8153
   185
fun delrule thm (intro, elim) = (del_rule thm intro, del_rule thm elim);
wenzelm@8153
   186
wenzelm@8153
   187
fun mk_att f g (x, thm) = (f (g thm) x, thm);
wenzelm@8153
   188
wenzelm@8153
   189
in
wenzelm@8153
   190
wenzelm@8153
   191
val dest_global = mk_att GlobalRules.map add_dest;
wenzelm@8153
   192
val elim_global = mk_att GlobalRules.map add_elim;
wenzelm@8153
   193
val intro_global = mk_att GlobalRules.map add_intro;
wenzelm@8153
   194
val delrule_global = mk_att GlobalRules.map delrule;
wenzelm@8153
   195
wenzelm@8153
   196
val dest_local = mk_att LocalRules.map add_dest;
wenzelm@8153
   197
val elim_local = mk_att LocalRules.map add_elim;
wenzelm@8153
   198
val intro_local = mk_att LocalRules.map add_intro;
wenzelm@8153
   199
val delrule_local = mk_att LocalRules.map delrule;
wenzelm@8153
   200
wenzelm@8153
   201
end;
wenzelm@8153
   202
wenzelm@8153
   203
wenzelm@8153
   204
(* concrete syntax *)
wenzelm@8153
   205
wenzelm@8153
   206
val rule_atts =
wenzelm@8519
   207
 [("dest", (Attrib.no_args dest_global, Attrib.no_args dest_local), "declare destruction rule"),
wenzelm@8519
   208
  ("elim", (Attrib.no_args elim_global, Attrib.no_args elim_local), "declare elimination rule"),
wenzelm@8519
   209
  ("intro", (Attrib.no_args intro_global, Attrib.no_args intro_local), "declare introduction rule"),
wenzelm@8519
   210
  ("delrule", (Attrib.no_args delrule_global, Attrib.no_args delrule_local), "undeclare rule")];
wenzelm@8153
   211
wenzelm@8153
   212
wenzelm@8153
   213
wenzelm@5824
   214
(** proof methods **)
wenzelm@5824
   215
wenzelm@8372
   216
(* make methods *)
wenzelm@5824
   217
wenzelm@6849
   218
val METHOD = Proof.method;
wenzelm@8372
   219
val METHOD_CASES = Proof.method_cases;
wenzelm@8372
   220
wenzelm@5824
   221
wenzelm@5824
   222
(* primitive *)
wenzelm@5824
   223
wenzelm@5824
   224
val fail = METHOD (K no_tac);
wenzelm@5824
   225
val succeed = METHOD (K all_tac);
wenzelm@5824
   226
wenzelm@5824
   227
wenzelm@8167
   228
(* shuffle *)
wenzelm@8167
   229
wenzelm@8240
   230
fun prefer i = METHOD (K (Tactic.defer_tac i THEN PRIMITIVE (Thm.permute_prems 0 ~1)));
wenzelm@8167
   231
fun defer opt_i = METHOD (K (Tactic.defer_tac (if_none opt_i 1)));
wenzelm@8167
   232
wenzelm@8167
   233
wenzelm@7419
   234
(* insert *)
wenzelm@7419
   235
wenzelm@7419
   236
local
wenzelm@5824
   237
wenzelm@6981
   238
fun cut_rule_tac raw_rule =
wenzelm@6981
   239
  let
wenzelm@6981
   240
    val rule = Drule.forall_intr_vars raw_rule;
wenzelm@6981
   241
    val revcut_rl = Drule.incr_indexes_wrt [] [] [] [rule] Drule.revcut_rl;
wenzelm@7555
   242
  in Tactic.rtac (rule COMP revcut_rl) end;
wenzelm@6981
   243
wenzelm@7419
   244
in
wenzelm@5824
   245
wenzelm@7419
   246
fun insert_tac [] i = all_tac
wenzelm@7419
   247
  | insert_tac facts i = EVERY (map (fn th => cut_rule_tac th i) facts);
wenzelm@6981
   248
wenzelm@7555
   249
val insert_facts = METHOD (ALLGOALS o insert_tac);
wenzelm@7664
   250
fun insert thms = METHOD (fn _ => ALLGOALS (insert_tac thms));
wenzelm@7419
   251
wenzelm@7419
   252
end;
wenzelm@5824
   253
wenzelm@5824
   254
wenzelm@9706
   255
(* simple methods *)
wenzelm@9706
   256
wenzelm@9706
   257
fun SIMPLE_METHOD tac = METHOD (fn facts => ALLGOALS (insert_tac facts) THEN tac);
wenzelm@9706
   258
fun SIMPLE_METHOD' quant tac = METHOD (fn facts => quant (insert_tac facts THEN' tac));
wenzelm@9706
   259
wenzelm@9706
   260
wenzelm@7601
   261
(* unfold / fold definitions *)
wenzelm@6532
   262
wenzelm@9706
   263
fun unfold thms = SIMPLE_METHOD (CHANGED (rewrite_goals_tac thms));
wenzelm@9706
   264
fun fold thms = SIMPLE_METHOD (CHANGED (fold_goals_tac thms));
wenzelm@9484
   265
wenzelm@9484
   266
wenzelm@9484
   267
(* atomize meta-connectives *)
wenzelm@9484
   268
wenzelm@9485
   269
fun atomize_tac rews i thm =
wenzelm@9485
   270
  if Logic.has_meta_prems (#prop (Thm.rep_thm thm)) i then
wenzelm@9485
   271
    Tactic.asm_rewrite_goal_tac (true, false, false) (K no_tac) (Thm.mss_of rews) i thm
wenzelm@9485
   272
  else all_tac thm;
wenzelm@9485
   273
wenzelm@9485
   274
fun atomize_goal rews i thm =
wenzelm@9485
   275
  (case Seq.pull (atomize_tac rews i thm) of
wenzelm@9485
   276
    None => thm
wenzelm@9485
   277
  | Some (thm', _) => thm');
wenzelm@6532
   278
wenzelm@6532
   279
wenzelm@7419
   280
(* multi_resolve *)
wenzelm@7419
   281
wenzelm@7419
   282
local
wenzelm@7419
   283
wenzelm@7419
   284
fun res th i rule =
wenzelm@7419
   285
  Thm.biresolution false [(false, th)] i rule handle THM _ => Seq.empty;
wenzelm@7419
   286
wenzelm@7419
   287
fun multi_res _ [] rule = Seq.single rule
wenzelm@7419
   288
  | multi_res i (th :: ths) rule = Seq.flat (Seq.map (res th i) (multi_res (i + 1) ths rule));
wenzelm@7419
   289
wenzelm@7419
   290
in
wenzelm@7419
   291
wenzelm@7419
   292
val multi_resolve = multi_res 1;
wenzelm@8372
   293
fun multi_resolves facts rules = Seq.flat (Seq.map (multi_resolve facts) (Seq.of_list rules));
wenzelm@7419
   294
wenzelm@7419
   295
end;
wenzelm@7419
   296
wenzelm@7419
   297
wenzelm@8372
   298
(* general rule *)
wenzelm@5824
   299
wenzelm@8335
   300
fun gen_resolveq_tac tac rules i st =
wenzelm@8372
   301
  Seq.flat (Seq.map (fn rule => tac rule i st) rules);
wenzelm@8372
   302
wenzelm@8372
   303
val resolveq_tac = gen_resolveq_tac Tactic.rtac;
wenzelm@8335
   304
wenzelm@9631
   305
fun resolveq_cases_tac open_parms = gen_resolveq_tac (fn (rule, cases) => fn i => fn st =>
wenzelm@9653
   306
  Seq.map (rpair (RuleCases.make (not open_parms) rule cases)) (Tactic.rtac rule i st));
wenzelm@8335
   307
wenzelm@8335
   308
wenzelm@8372
   309
(* simple rule *)
wenzelm@8372
   310
wenzelm@7419
   311
local
wenzelm@5824
   312
wenzelm@7130
   313
fun gen_rule_tac tac rules [] = tac rules
wenzelm@8372
   314
  | gen_rule_tac tac erules facts = gen_resolveq_tac (tac o single) (multi_resolves facts erules);
wenzelm@7130
   315
wenzelm@8671
   316
fun gen_rule tac rules = METHOD (HEADGOAL o tac rules);
wenzelm@8153
   317
wenzelm@8153
   318
fun gen_rule' tac arg_rules ctxt = METHOD (fn facts =>
wenzelm@8153
   319
  let val rules =
wenzelm@8153
   320
    if not (null arg_rules) then arg_rules
wenzelm@8153
   321
    else if null facts then #1 (LocalRules.get ctxt)
wenzelm@8153
   322
    else op @ (LocalRules.get ctxt);
wenzelm@8671
   323
  in HEADGOAL (tac rules facts) end);
wenzelm@8153
   324
wenzelm@8220
   325
fun setup raw_tac =
wenzelm@8220
   326
  let val tac = gen_rule_tac raw_tac
wenzelm@8220
   327
  in (tac, gen_rule tac, gen_rule' tac) end;
wenzelm@8220
   328
wenzelm@7419
   329
in
wenzelm@7419
   330
wenzelm@8220
   331
val (rule_tac, rule, some_rule) = setup Tactic.resolve_tac;
wenzelm@8220
   332
val (erule_tac, erule, some_erule) = setup Tactic.eresolve_tac;
wenzelm@8220
   333
val (drule_tac, drule, some_drule) = setup Tactic.dresolve_tac;
wenzelm@8220
   334
val (frule_tac, frule, some_frule) = setup Tactic.forward_tac;
wenzelm@5824
   335
wenzelm@7419
   336
end;
wenzelm@7419
   337
wenzelm@7419
   338
wenzelm@8195
   339
(* this *)
wenzelm@8195
   340
wenzelm@8671
   341
val this = METHOD (EVERY o map (HEADGOAL o Tactic.rtac));
wenzelm@8195
   342
wenzelm@8195
   343
wenzelm@8195
   344
(* assumption *)
wenzelm@7555
   345
wenzelm@7555
   346
fun assm_tac ctxt =
wenzelm@7555
   347
  assume_tac APPEND' resolve_tac (filter Thm.no_prems (ProofContext.prems_of ctxt));
wenzelm@7419
   348
wenzelm@7555
   349
fun assumption_tac ctxt [] = assm_tac ctxt
wenzelm@7555
   350
  | assumption_tac _ [fact] = resolve_tac [fact]
wenzelm@7555
   351
  | assumption_tac _ _ = K no_tac;
wenzelm@7419
   352
wenzelm@8671
   353
fun assumption ctxt = METHOD (HEADGOAL o assumption_tac ctxt);
wenzelm@7419
   354
wenzelm@7419
   355
wenzelm@9539
   356
(* res_inst_tac etc. *)
wenzelm@8238
   357
wenzelm@9539
   358
(*Note: insts refer to the implicit (!!) goal context; use at your own risk*)
wenzelm@9565
   359
fun gen_res_inst _ tac (quant, ([], thms)) =
wenzelm@9565
   360
      METHOD (fn facts => (quant (insert_tac facts THEN' tac thms)))
wenzelm@9565
   361
  | gen_res_inst tac _ (quant, (insts, [thm])) =
wenzelm@9565
   362
      METHOD (fn facts => (quant (insert_tac facts THEN' tac insts thm)))
wenzelm@9565
   363
  | gen_res_inst _ _ _ = error "Cannot have instantiations with multiple rules";
wenzelm@8238
   364
wenzelm@9565
   365
val res_inst = gen_res_inst Tactic.res_inst_tac Tactic.resolve_tac;
wenzelm@9565
   366
val eres_inst = gen_res_inst Tactic.eres_inst_tac Tactic.eresolve_tac;
wenzelm@9565
   367
val dres_inst = gen_res_inst Tactic.dres_inst_tac Tactic.dresolve_tac;
wenzelm@9565
   368
val forw_inst = gen_res_inst Tactic.forw_inst_tac Tactic.forward_tac;
wenzelm@9565
   369
val cut_inst = gen_res_inst Tactic.cut_inst_tac Tactic.cut_facts_tac;
wenzelm@8238
   370
wenzelm@8238
   371
wenzelm@8329
   372
(* simple Prolog interpreter *)
wenzelm@8329
   373
wenzelm@8329
   374
fun prolog_tac rules facts =
wenzelm@8329
   375
  DEPTH_SOLVE_1 (HEADGOAL (Tactic.assume_tac APPEND' Tactic.resolve_tac (facts @ rules)));
wenzelm@8329
   376
wenzelm@8329
   377
val prolog = METHOD o prolog_tac;
wenzelm@8329
   378
wenzelm@8329
   379
wenzelm@8351
   380
(* ML tactics *)
wenzelm@8351
   381
wenzelm@8351
   382
val tactic_ref = ref ((fn _ => raise Match): Proof.context -> thm list -> tactic);
wenzelm@8351
   383
fun set_tactic f = tactic_ref := f;
wenzelm@8351
   384
wenzelm@8351
   385
fun tactic txt ctxt = METHOD (fn facts =>
wenzelm@9631
   386
  (Context.use_mltext
wenzelm@9631
   387
    ("let fun tactic (ctxt: PureIsar.Proof.context) (facts: thm list) : tactic = \
wenzelm@9631
   388
     \let val thm = PureIsar.ProofContext.get_thm_closure ctxt\n\
wenzelm@9631
   389
     \  and thms = PureIsar.ProofContext.get_thms_closure ctxt in\n"
wenzelm@9631
   390
     ^ txt ^
wenzelm@9631
   391
     "\nend in PureIsar.Method.set_tactic tactic end")
wenzelm@9631
   392
    false None;
wenzelm@9631
   393
    Context.setmp (Some (ProofContext.theory_of ctxt)) (! tactic_ref ctxt) facts));
wenzelm@8351
   394
wenzelm@8351
   395
wenzelm@5824
   396
wenzelm@5824
   397
(** methods theory data **)
wenzelm@5824
   398
wenzelm@5824
   399
(* data kind 'Isar/methods' *)
wenzelm@5824
   400
wenzelm@5824
   401
structure MethodsDataArgs =
wenzelm@5824
   402
struct
wenzelm@5824
   403
  val name = "Isar/methods";
wenzelm@5824
   404
  type T =
wenzelm@5824
   405
    {space: NameSpace.T,
wenzelm@5824
   406
     meths: (((Args.src -> Proof.context -> Proof.method) * string) * stamp) Symtab.table};
wenzelm@5824
   407
wenzelm@5824
   408
  val empty = {space = NameSpace.empty, meths = Symtab.empty};
wenzelm@6546
   409
  val copy = I;
wenzelm@5824
   410
  val prep_ext = I;
wenzelm@5824
   411
  fun merge ({space = space1, meths = meths1}, {space = space2, meths = meths2}) =
wenzelm@5824
   412
    {space = NameSpace.merge (space1, space2),
wenzelm@5824
   413
      meths = Symtab.merge eq_snd (meths1, meths2) handle Symtab.DUPS dups =>
wenzelm@5824
   414
        error ("Attempt to merge different versions of methods " ^ commas_quote dups)};
wenzelm@5824
   415
wenzelm@9222
   416
  fun print _ {space, meths} =
wenzelm@5824
   417
    let
wenzelm@5824
   418
      fun prt_meth (name, ((_, comment), _)) = Pretty.block
wenzelm@6849
   419
        [Pretty.str (name ^ ":"), Pretty.brk 2, Pretty.str comment];
wenzelm@5824
   420
    in
wenzelm@8720
   421
      [Pretty.big_list "methods:" (map prt_meth (NameSpace.cond_extern_table space meths))]
wenzelm@9222
   422
      |> Pretty.chunks |> Pretty.writeln
wenzelm@5824
   423
    end;
wenzelm@5824
   424
end;
wenzelm@5824
   425
wenzelm@5824
   426
structure MethodsData = TheoryDataFun(MethodsDataArgs);
wenzelm@5824
   427
val print_methods = MethodsData.print;
wenzelm@7611
   428
wenzelm@5824
   429
wenzelm@5824
   430
(* get methods *)
wenzelm@5824
   431
wenzelm@5916
   432
exception METHOD_FAIL of (string * Position.T) * exn;
wenzelm@5916
   433
wenzelm@5824
   434
fun method thy =
wenzelm@5824
   435
  let
wenzelm@5824
   436
    val {space, meths} = MethodsData.get thy;
wenzelm@5824
   437
wenzelm@5884
   438
    fun meth src =
wenzelm@5884
   439
      let
wenzelm@5884
   440
        val ((raw_name, _), pos) = Args.dest_src src;
wenzelm@5884
   441
        val name = NameSpace.intern space raw_name;
wenzelm@5884
   442
      in
wenzelm@5824
   443
        (case Symtab.lookup (meths, name) of
wenzelm@5824
   444
          None => error ("Unknown proof method: " ^ quote name ^ Position.str_of pos)
wenzelm@5916
   445
        | Some ((mth, _), _) => transform_failure (curry METHOD_FAIL (name, pos)) (mth src))
wenzelm@5824
   446
      end;
wenzelm@5824
   447
  in meth end;
wenzelm@5824
   448
wenzelm@5824
   449
wenzelm@9194
   450
(* add_method(s) *)
wenzelm@5824
   451
wenzelm@5824
   452
fun add_methods raw_meths thy =
wenzelm@5824
   453
  let
wenzelm@5824
   454
    val full = Sign.full_name (Theory.sign_of thy);
wenzelm@5824
   455
    val new_meths =
wenzelm@5824
   456
      map (fn (name, f, comment) => (full name, ((f, comment), stamp ()))) raw_meths;
wenzelm@5824
   457
wenzelm@5824
   458
    val {space, meths} = MethodsData.get thy;
wenzelm@5824
   459
    val space' = NameSpace.extend (space, map fst new_meths);
wenzelm@5824
   460
    val meths' = Symtab.extend (meths, new_meths) handle Symtab.DUPS dups =>
wenzelm@5824
   461
      error ("Duplicate declaration of method(s) " ^ commas_quote dups);
wenzelm@5824
   462
  in
wenzelm@5824
   463
    thy |> MethodsData.put {space = space', meths = meths'}
wenzelm@5824
   464
  end;
wenzelm@5824
   465
wenzelm@9194
   466
val add_method = add_methods o Library.single;
wenzelm@9194
   467
wenzelm@5824
   468
(*implicit version*)
wenzelm@5824
   469
fun Method name meth cmt = Context.>> (add_methods [(name, meth, cmt)]);
wenzelm@5824
   470
wenzelm@5824
   471
wenzelm@5884
   472
wenzelm@5884
   473
(** method syntax **)
wenzelm@5824
   474
wenzelm@5884
   475
(* basic *)
wenzelm@5884
   476
wenzelm@5884
   477
fun syntax (scan: (Proof.context * Args.T list -> 'a * (Proof.context * Args.T list))) =
wenzelm@5884
   478
  Args.syntax "method" scan;
wenzelm@5824
   479
wenzelm@8351
   480
fun simple_args scan f src ctxt : Proof.method =
wenzelm@8351
   481
  #2 (syntax (Scan.lift (scan >> (fn x => f x ctxt))) src ctxt);
wenzelm@8351
   482
wenzelm@7555
   483
fun ctxt_args (f: Proof.context -> Proof.method) src ctxt =
wenzelm@8282
   484
  #2 (syntax (Scan.succeed (f ctxt)) src ctxt);
wenzelm@7555
   485
wenzelm@7555
   486
fun no_args m = ctxt_args (K m);
wenzelm@5884
   487
wenzelm@5884
   488
wenzelm@8351
   489
wenzelm@5884
   490
(* sections *)
wenzelm@5824
   491
wenzelm@7268
   492
type modifier = (Proof.context -> Proof.context) * Proof.context attribute;
wenzelm@7268
   493
wenzelm@7268
   494
local
wenzelm@7268
   495
wenzelm@8381
   496
fun sect ss = Scan.first (map Scan.lift ss);
wenzelm@5884
   497
fun thms ss = Scan.unless (sect ss) Attrib.local_thms;
wenzelm@5884
   498
fun thmss ss = Scan.repeat (thms ss) >> flat;
wenzelm@5884
   499
wenzelm@7268
   500
fun apply (f, att) (ctxt, ths) = Thm.applys_attributes ((f ctxt, ths), [att]);
wenzelm@5824
   501
wenzelm@7268
   502
fun section ss = (sect ss -- thmss ss) :-- (fn (m, ths) => Scan.depend (fn ctxt =>
wenzelm@7268
   503
  Scan.succeed (apply m (ctxt, ths)))) >> #2;
wenzelm@5884
   504
wenzelm@7601
   505
fun sectioned args ss = args -- Scan.repeat (section ss);
wenzelm@5884
   506
wenzelm@7268
   507
in
wenzelm@5824
   508
wenzelm@5884
   509
fun sectioned_args args ss f src ctxt =
wenzelm@8282
   510
  let val (ctxt', (x, _)) = syntax (sectioned args ss) src ctxt
wenzelm@5921
   511
  in f x ctxt' end;
wenzelm@5884
   512
wenzelm@7601
   513
fun bang_sectioned_args ss f = sectioned_args Args.bang_facts ss f;
wenzelm@9777
   514
fun bang_sectioned_args' ss scan f =
wenzelm@9777
   515
  sectioned_args (Args.bang_facts -- scan >> swap) ss (uncurry f);
wenzelm@7601
   516
fun only_sectioned_args ss f = sectioned_args (Scan.succeed ()) ss (fn () => f);
wenzelm@7268
   517
wenzelm@8093
   518
fun thms_ctxt_args f = sectioned_args (thmss []) [] f;
wenzelm@8093
   519
fun thms_args f = thms_ctxt_args (K o f);
wenzelm@9706
   520
fun thm_args f = thms_args (fn [thm] => f thm | _ => error "Single theorem expected");
wenzelm@5824
   521
wenzelm@7268
   522
end;
wenzelm@7268
   523
wenzelm@5824
   524
wenzelm@9539
   525
(* tactic syntax *)
wenzelm@8238
   526
wenzelm@8238
   527
val insts =
wenzelm@9539
   528
  Scan.optional
wenzelm@9565
   529
    (Args.enum1 "and" (Scan.lift (Args.name -- (Args.$$$ "=" |-- Args.!!! Args.name))) --|
wenzelm@9565
   530
      Scan.lift (Args.$$$ "in")) [] -- Attrib.local_thmss;
wenzelm@8238
   531
wenzelm@8537
   532
fun inst_args f = f oo (#2 oo syntax (Args.goal_spec HEADGOAL -- insts));
wenzelm@8537
   533
wenzelm@8537
   534
wenzelm@9539
   535
fun goal_args' args tac = #2 oo syntax (Args.goal_spec HEADGOAL -- args >>
wenzelm@9706
   536
  (fn (quant, s) => SIMPLE_METHOD' quant (tac s)));
wenzelm@8537
   537
wenzelm@9539
   538
fun goal_args args tac = goal_args' (Scan.lift args) tac;
wenzelm@8238
   539
wenzelm@8238
   540
wenzelm@5824
   541
wenzelm@5824
   542
(** method text **)
wenzelm@5824
   543
wenzelm@5824
   544
(* datatype text *)
wenzelm@5824
   545
wenzelm@5824
   546
datatype text =
wenzelm@5824
   547
  Basic of (Proof.context -> Proof.method) |
wenzelm@5824
   548
  Source of Args.src |
wenzelm@5824
   549
  Then of text list |
wenzelm@5824
   550
  Orelse of text list |
wenzelm@5824
   551
  Try of text |
wenzelm@5824
   552
  Repeat1 of text;
wenzelm@5824
   553
wenzelm@5824
   554
wenzelm@5824
   555
(* refine *)
wenzelm@5824
   556
wenzelm@8238
   557
fun gen_refine f text state =
wenzelm@5824
   558
  let
wenzelm@5824
   559
    val thy = Proof.theory_of state;
wenzelm@5824
   560
wenzelm@8238
   561
    fun eval (Basic mth) = f mth
wenzelm@8238
   562
      | eval (Source src) = f (method thy src)
wenzelm@5824
   563
      | eval (Then txts) = Seq.EVERY (map eval txts)
wenzelm@5824
   564
      | eval (Orelse txts) = Seq.FIRST (map eval txts)
wenzelm@5824
   565
      | eval (Try txt) = Seq.TRY (eval txt)
wenzelm@5824
   566
      | eval (Repeat1 txt) = Seq.REPEAT1 (eval txt);
wenzelm@5824
   567
  in eval text state end;
wenzelm@5824
   568
wenzelm@8238
   569
val refine = gen_refine Proof.refine;
wenzelm@8238
   570
val refine_end = gen_refine Proof.refine_end;
wenzelm@6404
   571
wenzelm@5824
   572
wenzelm@6404
   573
(* structured proof steps *)
wenzelm@5824
   574
wenzelm@7506
   575
val default_text = Source (Args.src (("default", []), Position.none));
wenzelm@8195
   576
val this_text = Basic (K this);
wenzelm@9706
   577
val done_text = Basic (K (SIMPLE_METHOD all_tac));
wenzelm@7555
   578
wenzelm@8966
   579
fun close_text asm = Basic (fn ctxt => METHOD (K
wenzelm@8966
   580
  (FILTER Thm.no_prems ((if asm then ALLGOALS (assm_tac ctxt) else all_tac) THEN flexflex_tac))));
wenzelm@8966
   581
wenzelm@8966
   582
fun finish_text asm None = close_text asm
wenzelm@8966
   583
  | finish_text asm (Some txt) = Then [txt, close_text asm];
wenzelm@6872
   584
wenzelm@5824
   585
fun proof opt_text state =
wenzelm@5824
   586
  state
wenzelm@5824
   587
  |> Proof.assert_backward
wenzelm@6404
   588
  |> refine (if_none opt_text default_text)
wenzelm@8242
   589
  |> Seq.map (Proof.goal_facts (K []))
wenzelm@5824
   590
  |> Seq.map Proof.enter_forward;
wenzelm@5824
   591
wenzelm@8966
   592
fun local_qed asm opt_text = Proof.local_qed (refine (finish_text asm opt_text));
wenzelm@8966
   593
fun local_terminal_proof (text, opt_text) pr =
wenzelm@8966
   594
  Seq.THEN (proof (Some text), local_qed true opt_text pr);
wenzelm@8966
   595
val local_default_proof = local_terminal_proof (default_text, None);
wenzelm@8195
   596
val local_immediate_proof = local_terminal_proof (this_text, None);
wenzelm@8966
   597
fun local_done_proof pr = Seq.THEN (proof (Some done_text), local_qed false None pr);
wenzelm@5824
   598
wenzelm@6872
   599
wenzelm@8966
   600
fun global_qeds asm opt_text = Proof.global_qed (refine (finish_text asm opt_text));
wenzelm@5824
   601
wenzelm@8966
   602
fun global_qed asm opt_text state =
wenzelm@6872
   603
  state
wenzelm@8966
   604
  |> global_qeds asm opt_text
wenzelm@6872
   605
  |> Proof.check_result "Failed to finish proof" state
wenzelm@6872
   606
  |> Seq.hd;
wenzelm@6872
   607
wenzelm@8966
   608
fun global_term_proof asm (text, opt_text) state =
wenzelm@6872
   609
  state
wenzelm@6872
   610
  |> proof (Some text)
wenzelm@6872
   611
  |> Proof.check_result "Terminal proof method failed" state
wenzelm@8966
   612
  |> (Seq.flat o Seq.map (global_qeds asm opt_text))
wenzelm@6872
   613
  |> Proof.check_result "Failed to finish proof (after successful terminal method)" state
wenzelm@6872
   614
  |> Seq.hd;
wenzelm@6872
   615
wenzelm@8966
   616
val global_terminal_proof = global_term_proof true;
wenzelm@6934
   617
val global_default_proof = global_terminal_proof (default_text, None);
wenzelm@8966
   618
val global_immediate_proof = global_terminal_proof (this_text, None);
wenzelm@8966
   619
val global_done_proof = global_term_proof false (done_text, None);
wenzelm@5824
   620
wenzelm@5824
   621
wenzelm@5824
   622
(** theory setup **)
wenzelm@5824
   623
wenzelm@9539
   624
(* misc tactic emulations *)
wenzelm@9539
   625
wenzelm@9539
   626
val subgoal_meth = goal_args (Scan.repeat1 Args.name) Tactic.subgoals_tac;
wenzelm@9539
   627
val thin_meth = goal_args Args.name Tactic.thin_tac;
wenzelm@9539
   628
val rename_meth = goal_args (Scan.repeat1 Args.name) Tactic.rename_params_tac;
wenzelm@9631
   629
val rotate_meth = goal_args (Scan.optional Args.int 1) Tactic.rotate_tac;
wenzelm@9539
   630
wenzelm@9539
   631
wenzelm@5824
   632
(* pure_methods *)
wenzelm@5824
   633
wenzelm@5824
   634
val pure_methods =
wenzelm@5824
   635
 [("fail", no_args fail, "force failure"),
wenzelm@5824
   636
  ("succeed", no_args succeed, "succeed"),
wenzelm@9587
   637
  ("-", no_args insert_facts, "do nothing (insert current facts only)"),
wenzelm@9539
   638
  ("insert", thms_args insert, "insert theorems, ignoring facts (improper)"),
wenzelm@7601
   639
  ("unfold", thms_args unfold, "unfold definitions"),
wenzelm@7601
   640
  ("fold", thms_args fold, "fold definitions"),
wenzelm@8153
   641
  ("default", thms_ctxt_args some_rule, "apply some rule"),
wenzelm@8153
   642
  ("rule", thms_ctxt_args some_rule, "apply some rule"),
wenzelm@9539
   643
  ("erule", thms_ctxt_args some_erule, "apply some rule in elimination manner (improper)"),
wenzelm@9539
   644
  ("drule", thms_ctxt_args some_drule, "apply some rule in destruct manner (improper)"),
wenzelm@9539
   645
  ("frule", thms_ctxt_args some_frule, "apply some rule in forward manner (improper)"),
wenzelm@8195
   646
  ("this", no_args this, "apply current facts as rules"),
wenzelm@8238
   647
  ("assumption", ctxt_args assumption, "proof by assumption, preferring facts"),
wenzelm@9539
   648
  ("rule_tac", inst_args res_inst, "apply rule (dynamic instantiation!)"),
wenzelm@9539
   649
  ("erule_tac", inst_args eres_inst, "apply rule in elimination manner (dynamic instantiation!)"),
wenzelm@9539
   650
  ("drule_tac", inst_args dres_inst, "apply rule in destruct manner (dynamic instantiation!)"),
wenzelm@9539
   651
  ("frule_tac", inst_args forw_inst, "apply rule in forward manner (dynamic instantiation!)"),
wenzelm@9539
   652
  ("cut_tac", inst_args cut_inst, "cut rule (dynamic instantiation!)"),
wenzelm@9565
   653
  ("subgoal_tac", subgoal_meth, "insert subgoal (dynamic instantiation!)"),
wenzelm@9565
   654
  ("thin_tac", thin_meth, "remove premise (dynamic instantiation!)"),
wenzelm@9631
   655
  ("rename_tac", rename_meth, "rename parameters of goal (dynamic instantiation!)"),
wenzelm@9631
   656
  ("rotate_tac", rotate_meth, "rotate assumptions of goal"),
wenzelm@8351
   657
  ("prolog", thms_args prolog, "simple prolog interpreter"),
wenzelm@8351
   658
  ("tactic", simple_args Args.name tactic, "ML tactic as proof method")];
wenzelm@5824
   659
wenzelm@5824
   660
wenzelm@5824
   661
(* setup *)
wenzelm@5824
   662
wenzelm@8153
   663
val setup =
wenzelm@8153
   664
 [GlobalRules.init, LocalRules.init, Attrib.add_attributes rule_atts,
wenzelm@8153
   665
  MethodsData.init, add_methods pure_methods];
wenzelm@5824
   666
wenzelm@5824
   667
wenzelm@5824
   668
end;
wenzelm@5824
   669
wenzelm@5824
   670
wenzelm@5824
   671
structure BasicMethod: BASIC_METHOD = Method;
wenzelm@5824
   672
open BasicMethod;