src/Pure/Isar/method.ML
author wenzelm
Wed Jun 13 00:01:38 2007 +0200 (2007-06-13)
changeset 23349 23a8345f89f5
parent 23178 07ba6b58b3d2
child 23395 15fb6637690e
permissions -rw-r--r--
Basic text: include position;
assumption/close: refer to non-atomic assumptions as well, implicit use of prems now considered legacy feature;
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@17110
     5
Isar proof methods.
wenzelm@5824
     6
*)
wenzelm@5824
     7
wenzelm@5824
     8
signature BASIC_METHOD =
wenzelm@5824
     9
sig
wenzelm@17110
    10
  val FINDGOAL: (int -> thm -> 'a Seq.seq) -> thm -> 'a Seq.seq
wenzelm@17110
    11
  val HEADGOAL: (int -> thm -> 'a Seq.seq) -> thm -> 'a Seq.seq
wenzelm@17110
    12
  type method
wenzelm@11731
    13
  val trace_rules: bool ref
wenzelm@5824
    14
  val print_methods: theory -> unit
wenzelm@5824
    15
end;
wenzelm@5824
    16
wenzelm@5824
    17
signature METHOD =
wenzelm@5824
    18
sig
wenzelm@5824
    19
  include BASIC_METHOD
wenzelm@18227
    20
  val apply: method -> thm list -> cases_tactic
wenzelm@18227
    21
  val RAW_METHOD_CASES: (thm list -> cases_tactic) -> method
wenzelm@17110
    22
  val RAW_METHOD: (thm list -> tactic) -> method
wenzelm@18227
    23
  val METHOD_CASES: (thm list -> cases_tactic) -> method
wenzelm@17110
    24
  val METHOD: (thm list -> tactic) -> method
wenzelm@17110
    25
  val fail: method
wenzelm@17110
    26
  val succeed: method
wenzelm@17110
    27
  val insert_tac: thm list -> int -> tactic
wenzelm@17110
    28
  val insert: thm list -> method
wenzelm@17110
    29
  val insert_facts: method
wenzelm@17110
    30
  val SIMPLE_METHOD: tactic -> method
wenzelm@21592
    31
  val SIMPLE_METHOD': (int -> tactic) -> method
wenzelm@21592
    32
  val SIMPLE_METHOD'': ((int -> tactic) -> tactic) -> (int -> tactic) -> method
wenzelm@17110
    33
  val defer: int option -> method
wenzelm@17110
    34
  val prefer: int -> method
wenzelm@20289
    35
  val cheating: bool -> Proof.context -> method
wenzelm@17110
    36
  val intro: thm list -> method
wenzelm@17110
    37
  val elim: thm list -> method
wenzelm@20289
    38
  val unfold: thm list -> Proof.context -> method
wenzelm@20289
    39
  val fold: thm list -> Proof.context -> method
wenzelm@17110
    40
  val atomize: bool -> method
wenzelm@17110
    41
  val this: method
wenzelm@20289
    42
  val fact: thm list -> Proof.context -> method
wenzelm@20289
    43
  val assumption: Proof.context -> method
wenzelm@20289
    44
  val close: bool -> Proof.context -> method
wenzelm@20289
    45
  val trace: Proof.context -> thm list -> unit
wenzelm@6091
    46
  val rule_tac: thm list -> thm list -> int -> tactic
wenzelm@20289
    47
  val some_rule_tac: thm list -> Proof.context -> thm list -> int -> tactic
wenzelm@17110
    48
  val rule: thm list -> method
wenzelm@17110
    49
  val erule: int -> thm list -> method
wenzelm@17110
    50
  val drule: int -> thm list -> method
wenzelm@17110
    51
  val frule: int -> thm list -> method
wenzelm@20289
    52
  val iprover_tac: Proof.context -> int option -> int -> tactic
wenzelm@20289
    53
  val set_tactic: (Proof.context -> thm list -> tactic) -> unit
wenzelm@20289
    54
  val tactic: string -> Proof.context -> method
wenzelm@17110
    55
  type src
wenzelm@5824
    56
  datatype text =
wenzelm@23349
    57
    Basic of (Proof.context -> method) * Position.T |
wenzelm@15703
    58
    Source of src |
wenzelm@20030
    59
    Source_i of src |
wenzelm@5824
    60
    Then of text list |
wenzelm@5824
    61
    Orelse of text list |
wenzelm@5824
    62
    Try of text |
wenzelm@19186
    63
    Repeat1 of text |
wenzelm@19186
    64
    SelectGoals of int * text
wenzelm@17857
    65
  val primitive_text: (thm -> thm) -> text
wenzelm@17857
    66
  val succeed_text: text
wenzelm@17110
    67
  val default_text: text
wenzelm@17110
    68
  val this_text: text
wenzelm@17110
    69
  val done_text: text
wenzelm@17356
    70
  val sorry_text: bool -> text
wenzelm@23349
    71
  val finish_text: text option * bool -> Position.T -> text
wenzelm@17110
    72
  exception METHOD_FAIL of (string * Position.T) * exn
wenzelm@20289
    73
  val method: theory -> src -> Proof.context -> method
wenzelm@20289
    74
  val method_i: theory -> src -> Proof.context -> method
wenzelm@20289
    75
  val add_methods: (bstring * (src -> Proof.context -> method) * string) list
wenzelm@17110
    76
    -> theory -> theory
wenzelm@20289
    77
  val add_method: bstring * (src -> Proof.context -> method) * string
wenzelm@17110
    78
    -> theory -> theory
wenzelm@17356
    79
  val method_setup: bstring * string * string -> theory -> theory
wenzelm@18999
    80
  val syntax: (Context.generic * Args.T list -> 'a * (Context.generic * Args.T list))
haftmann@21879
    81
    -> src -> Proof.context -> 'a * Proof.context
wenzelm@17110
    82
  val simple_args: (Args.T list -> 'a * Args.T list)
wenzelm@20289
    83
    -> ('a -> Proof.context -> method) -> src -> Proof.context -> method
wenzelm@20289
    84
  val ctxt_args: (Proof.context -> method) -> src -> Proof.context -> method
wenzelm@20289
    85
  val no_args: method -> src -> Proof.context -> method
wenzelm@17110
    86
  type modifier
wenzelm@18999
    87
  val sectioned_args: (Context.generic * Args.T list -> 'a * (Context.generic * Args.T list)) ->
wenzelm@17110
    88
    (Args.T list -> modifier * Args.T list) list ->
wenzelm@20289
    89
    ('a -> Proof.context -> 'b) -> src -> Proof.context -> 'b
wenzelm@17110
    90
  val bang_sectioned_args:
wenzelm@17110
    91
    (Args.T list -> modifier * Args.T list) list ->
wenzelm@20289
    92
    (thm list -> Proof.context -> 'a) -> src -> Proof.context -> 'a
wenzelm@17110
    93
  val bang_sectioned_args':
wenzelm@17110
    94
    (Args.T list -> modifier * Args.T list) list ->
wenzelm@18999
    95
    (Context.generic * Args.T list -> 'a * (Context.generic * Args.T list)) ->
wenzelm@20289
    96
    ('a -> thm list -> Proof.context -> 'b) -> src -> Proof.context -> 'b
wenzelm@17110
    97
  val only_sectioned_args:
wenzelm@17110
    98
    (Args.T list -> modifier * Args.T list) list ->
wenzelm@20289
    99
    (Proof.context -> 'a) -> src -> Proof.context -> 'a
wenzelm@20289
   100
  val thms_ctxt_args: (thm list -> Proof.context -> 'a) -> src ->
wenzelm@20289
   101
    Proof.context -> 'a
wenzelm@20289
   102
  val thms_args: (thm list -> 'a) -> src -> Proof.context -> 'a
wenzelm@20289
   103
  val thm_args: (thm -> 'a) -> src -> Proof.context -> 'a
wenzelm@9539
   104
  val goal_args: (Args.T list -> 'a * Args.T list) -> ('a -> int -> tactic)
wenzelm@20289
   105
    -> src -> Proof.context -> method
wenzelm@18999
   106
  val goal_args': (Context.generic * Args.T list -> 'a * (Context.generic * Args.T list))
wenzelm@20289
   107
    -> ('a -> int -> tactic) -> src -> Proof.context -> method
wenzelm@17110
   108
  val goal_args_ctxt: (Args.T list -> 'a * Args.T list) ->
wenzelm@20289
   109
    (Proof.context -> 'a -> int -> tactic) -> src -> Proof.context -> method
wenzelm@18999
   110
  val goal_args_ctxt': (Context.generic * Args.T list -> 'a * (Context.generic * Args.T list)) ->
wenzelm@20289
   111
    (Proof.context -> 'a -> int -> tactic) -> src -> Proof.context -> method
wenzelm@22118
   112
  val parse: OuterLex.token list -> text * OuterLex.token list
wenzelm@5824
   113
end;
wenzelm@5824
   114
wenzelm@5824
   115
structure Method: METHOD =
wenzelm@5824
   116
struct
wenzelm@5824
   117
wenzelm@17110
   118
(** generic tools **)
wenzelm@17110
   119
wenzelm@17110
   120
(* goal addressing *)
wenzelm@17110
   121
wenzelm@17110
   122
fun FINDGOAL tac st =
wenzelm@17110
   123
  let fun find i n = if i > n then Seq.fail else Seq.APPEND (tac i, find (i + 1) n)
wenzelm@17110
   124
  in find 1 (Thm.nprems_of st) st end;
wenzelm@17110
   125
wenzelm@17110
   126
fun HEADGOAL tac = tac 1;
wenzelm@17110
   127
wenzelm@17110
   128
wenzelm@5824
   129
wenzelm@12324
   130
(** proof methods **)
wenzelm@12324
   131
wenzelm@17110
   132
(* datatype method *)
wenzelm@11731
   133
wenzelm@18227
   134
datatype method = Meth of thm list -> cases_tactic;
wenzelm@11731
   135
wenzelm@17756
   136
fun apply (Meth m) = m;
wenzelm@11731
   137
wenzelm@17756
   138
val RAW_METHOD_CASES = Meth;
wenzelm@11731
   139
wenzelm@17110
   140
fun RAW_METHOD tac = RAW_METHOD_CASES (NO_CASES o tac);
wenzelm@12144
   141
wenzelm@17110
   142
fun METHOD_CASES tac = RAW_METHOD_CASES (fn facts =>
wenzelm@21687
   143
  Seq.THEN (ALLGOALS Goal.conjunction_tac, tac facts));
wenzelm@8372
   144
wenzelm@21687
   145
fun METHOD tac = RAW_METHOD (fn facts => ALLGOALS Goal.conjunction_tac THEN tac facts);
wenzelm@5824
   146
wenzelm@5824
   147
val fail = METHOD (K no_tac);
wenzelm@5824
   148
val succeed = METHOD (K all_tac);
wenzelm@5824
   149
wenzelm@5824
   150
wenzelm@17110
   151
(* insert facts *)
wenzelm@7419
   152
wenzelm@7419
   153
local
wenzelm@5824
   154
wenzelm@21579
   155
fun cut_rule_tac rule =
wenzelm@21579
   156
  Tactic.rtac (Drule.forall_intr_vars rule COMP_INCR revcut_rl);
wenzelm@6981
   157
wenzelm@7419
   158
in
wenzelm@5824
   159
wenzelm@7419
   160
fun insert_tac [] i = all_tac
wenzelm@7419
   161
  | insert_tac facts i = EVERY (map (fn th => cut_rule_tac th i) facts);
wenzelm@6981
   162
wenzelm@7555
   163
val insert_facts = METHOD (ALLGOALS o insert_tac);
wenzelm@7664
   164
fun insert thms = METHOD (fn _ => ALLGOALS (insert_tac thms));
wenzelm@7419
   165
wenzelm@9706
   166
fun SIMPLE_METHOD tac = METHOD (fn facts => ALLGOALS (insert_tac facts) THEN tac);
wenzelm@21592
   167
fun SIMPLE_METHOD'' quant tac = METHOD (fn facts => quant (insert_tac facts THEN' tac));
wenzelm@21592
   168
val SIMPLE_METHOD' = SIMPLE_METHOD'' HEADGOAL;
wenzelm@9706
   169
wenzelm@12324
   170
end;
wenzelm@12324
   171
wenzelm@9706
   172
wenzelm@17110
   173
(* shuffle subgoals *)
wenzelm@17110
   174
wenzelm@17110
   175
fun prefer i = METHOD (K (Tactic.defer_tac i THEN PRIMITIVE (Thm.permute_prems 0 ~1)));
wenzelm@18939
   176
fun defer opt_i = METHOD (K (Tactic.defer_tac (the_default 1 opt_i)));
wenzelm@17110
   177
wenzelm@17110
   178
wenzelm@17356
   179
(* cheating *)
wenzelm@17356
   180
wenzelm@17356
   181
fun cheating int ctxt = METHOD (K (setmp quick_and_dirty (int orelse ! quick_and_dirty)
wenzelm@17356
   182
    (SkipProof.cheat_tac (ProofContext.theory_of ctxt))));
wenzelm@17356
   183
wenzelm@17356
   184
wenzelm@17110
   185
(* unfold intro/elim rules *)
wenzelm@17110
   186
wenzelm@21592
   187
fun intro ths = SIMPLE_METHOD' (CHANGED_PROP o REPEAT_ALL_NEW (Tactic.match_tac ths));
wenzelm@21592
   188
fun elim ths = SIMPLE_METHOD' (CHANGED_PROP o REPEAT_ALL_NEW (Tactic.ematch_tac ths));
wenzelm@17110
   189
wenzelm@17110
   190
wenzelm@12384
   191
(* unfold/fold definitions *)
wenzelm@12384
   192
wenzelm@18877
   193
fun unfold_meth ths ctxt = SIMPLE_METHOD (CHANGED_PROP (LocalDefs.unfold_tac ctxt ths));
wenzelm@18877
   194
fun fold_meth ths ctxt = SIMPLE_METHOD (CHANGED_PROP (LocalDefs.fold_tac ctxt ths));
wenzelm@6532
   195
wenzelm@12384
   196
wenzelm@12829
   197
(* atomize rule statements *)
wenzelm@12829
   198
wenzelm@21592
   199
fun atomize false = SIMPLE_METHOD' (CHANGED_PROP o ObjectLogic.atomize_tac)
wenzelm@12829
   200
  | atomize true = RAW_METHOD (K (HEADGOAL (CHANGED_PROP o ObjectLogic.full_atomize_tac)));
wenzelm@12829
   201
wenzelm@12829
   202
wenzelm@18039
   203
(* this -- resolve facts directly *)
wenzelm@12384
   204
wenzelm@17110
   205
val this = METHOD (EVERY o map (HEADGOAL o Tactic.rtac));
wenzelm@9484
   206
wenzelm@9484
   207
wenzelm@18039
   208
(* fact -- composition by facts from context *)
wenzelm@18039
   209
wenzelm@21592
   210
fun fact [] ctxt = SIMPLE_METHOD' (ProofContext.some_fact_tac ctxt)
wenzelm@21592
   211
  | fact rules _ = SIMPLE_METHOD' (ProofContext.fact_tac rules);
wenzelm@18039
   212
wenzelm@18039
   213
wenzelm@17110
   214
(* assumption *)
wenzelm@7419
   215
wenzelm@7419
   216
local
wenzelm@7419
   217
wenzelm@19778
   218
fun cond_rtac cond rule = SUBGOAL (fn (prop, i) =>
wenzelm@19778
   219
  if cond (Logic.strip_assums_concl prop)
wenzelm@19778
   220
  then Tactic.rtac rule i else no_tac);
wenzelm@7419
   221
wenzelm@23349
   222
fun assm_tac warn_tac ctxt =
wenzelm@17110
   223
  assume_tac APPEND'
wenzelm@23349
   224
  Goal.assume_rule_tac ctxt APPEND'
wenzelm@23349
   225
  (CHANGED o solve_tac (Assumption.prems_of ctxt) THEN' K warn_tac) APPEND'
wenzelm@19778
   226
  cond_rtac (can Logic.dest_equals) Drule.reflexive_thm APPEND'
wenzelm@19778
   227
  cond_rtac (can Logic.dest_term) Drule.termI;
wenzelm@17110
   228
wenzelm@23349
   229
fun legacy_tac ctxt st =
wenzelm@23349
   230
  (legacy_feature ("implicit use of prems at end of proof" ^ ContextPosition.str_of ctxt);
wenzelm@23349
   231
    all_tac st);
wenzelm@7419
   232
wenzelm@7419
   233
in
wenzelm@7419
   234
wenzelm@23349
   235
fun assumption ctxt = METHOD (HEADGOAL o
wenzelm@23349
   236
  (fn [] => assm_tac all_tac ctxt
wenzelm@23349
   237
    | [fact] => solve_tac [fact]
wenzelm@23349
   238
    | _ => K no_tac));
wenzelm@23349
   239
wenzelm@17356
   240
fun close immed ctxt = METHOD (K
wenzelm@23349
   241
  (FILTER Thm.no_prems
wenzelm@23349
   242
    ((if immed then ALLGOALS (assm_tac (legacy_tac ctxt) ctxt) else all_tac) THEN flexflex_tac)));
wenzelm@7419
   243
wenzelm@7419
   244
end;
wenzelm@7419
   245
wenzelm@7419
   246
wenzelm@17110
   247
(* rule etc. -- single-step refinements *)
wenzelm@12347
   248
wenzelm@17110
   249
val trace_rules = ref false;
wenzelm@12347
   250
wenzelm@17110
   251
fun trace ctxt rules =
wenzelm@21962
   252
  if ! trace_rules andalso not (null rules) then
wenzelm@17110
   253
    Pretty.big_list "rules:" (map (ProofContext.pretty_thm ctxt) rules)
wenzelm@21962
   254
    |> Pretty.string_of |> tracing
wenzelm@21962
   255
  else ();
wenzelm@12347
   256
wenzelm@12347
   257
local
wenzelm@12347
   258
wenzelm@18841
   259
fun gen_rule_tac tac rules facts =
wenzelm@18841
   260
  (fn i => fn st =>
wenzelm@18841
   261
    if null facts then tac rules i st
wenzelm@18841
   262
    else Seq.maps (fn rule => (tac o single) rule i st) (Drule.multi_resolves facts rules))
wenzelm@21687
   263
  THEN_ALL_NEW Goal.norm_hhf_tac;
wenzelm@7130
   264
wenzelm@10744
   265
fun gen_arule_tac tac j rules facts =
wenzelm@10744
   266
  EVERY' (gen_rule_tac tac rules facts :: replicate j Tactic.assume_tac);
wenzelm@10744
   267
wenzelm@11785
   268
fun gen_some_rule_tac tac arg_rules ctxt facts = SUBGOAL (fn (goal, i) =>
wenzelm@11785
   269
  let
wenzelm@11785
   270
    val rules =
wenzelm@11785
   271
      if not (null arg_rules) then arg_rules
wenzelm@19482
   272
      else flat (ContextRules.find_rules false facts goal ctxt)
wenzelm@12055
   273
  in trace ctxt rules; tac rules facts i end);
wenzelm@10309
   274
wenzelm@10744
   275
fun meth tac x = METHOD (HEADGOAL o tac x);
wenzelm@10744
   276
fun meth' tac x y = METHOD (HEADGOAL o tac x y);
wenzelm@8220
   277
wenzelm@7419
   278
in
wenzelm@7419
   279
wenzelm@10744
   280
val rule_tac = gen_rule_tac Tactic.resolve_tac;
wenzelm@10744
   281
val rule = meth rule_tac;
wenzelm@10744
   282
val some_rule_tac = gen_some_rule_tac rule_tac;
wenzelm@10744
   283
val some_rule = meth' some_rule_tac;
wenzelm@10744
   284
wenzelm@10744
   285
val erule = meth' (gen_arule_tac Tactic.eresolve_tac);
wenzelm@10744
   286
val drule = meth' (gen_arule_tac Tactic.dresolve_tac);
wenzelm@10744
   287
val frule = meth' (gen_arule_tac Tactic.forward_tac);
wenzelm@5824
   288
wenzelm@7419
   289
end;
wenzelm@7419
   290
wenzelm@7419
   291
nipkow@17587
   292
(* iprover -- intuitionistic proof search *)
wenzelm@17110
   293
wenzelm@17110
   294
local
wenzelm@17110
   295
wenzelm@17110
   296
val remdups_tac = SUBGOAL (fn (g, i) =>
wenzelm@17110
   297
  let val prems = Logic.strip_assums_hyp g in
wenzelm@19046
   298
    REPEAT_DETERM_N (length prems - length (distinct op aconv prems))
wenzelm@17110
   299
    (Tactic.ematch_tac [Drule.remdups_rl] i THEN Tactic.eq_assume_tac i)
wenzelm@17110
   300
  end);
wenzelm@17110
   301
wenzelm@17110
   302
fun REMDUPS tac = tac THEN_ALL_NEW remdups_tac;
wenzelm@17110
   303
wenzelm@17110
   304
val bires_tac = Tactic.biresolution_from_nets_tac ContextRules.orderlist;
wenzelm@17110
   305
wenzelm@17110
   306
fun safe_step_tac ctxt =
wenzelm@17110
   307
  ContextRules.Swrap ctxt
wenzelm@17110
   308
   (eq_assume_tac ORELSE'
wenzelm@17110
   309
    bires_tac true (ContextRules.netpair_bang ctxt));
wenzelm@8195
   310
wenzelm@17110
   311
fun unsafe_step_tac ctxt =
wenzelm@17110
   312
  ContextRules.wrap ctxt
wenzelm@17110
   313
   (assume_tac APPEND'
wenzelm@17110
   314
    bires_tac false (ContextRules.netpair_bang ctxt) APPEND'
wenzelm@17110
   315
    bires_tac false (ContextRules.netpair ctxt));
wenzelm@17110
   316
wenzelm@17110
   317
fun step_tac ctxt i =
wenzelm@17110
   318
  REPEAT_DETERM1 (REMDUPS (safe_step_tac ctxt) i) ORELSE
wenzelm@17110
   319
  REMDUPS (unsafe_step_tac ctxt) i;
wenzelm@17110
   320
wenzelm@17110
   321
fun intprover_tac ctxt gs d lim = SUBGOAL (fn (g, i) => if d > lim then no_tac else
wenzelm@17110
   322
  let
wenzelm@17110
   323
    val ps = Logic.strip_assums_hyp g;
wenzelm@17110
   324
    val c = Logic.strip_assums_concl g;
wenzelm@17110
   325
  in
wenzelm@18921
   326
    if member (fn ((ps1, c1), (ps2, c2)) =>
wenzelm@19307
   327
        c1 aconv c2 andalso
wenzelm@19307
   328
        length ps1 = length ps2 andalso
wenzelm@19307
   329
        gen_eq_set (op aconv) (ps1, ps2)) gs (ps, c) then no_tac
wenzelm@17110
   330
    else (step_tac ctxt THEN_ALL_NEW intprover_tac ctxt ((ps, c) :: gs) (d + 1) lim) i
wenzelm@17110
   331
  end);
wenzelm@17110
   332
wenzelm@17110
   333
in
wenzelm@17110
   334
nipkow@17587
   335
fun iprover_tac ctxt opt_lim =
wenzelm@18939
   336
  SELECT_GOAL (DEEPEN (2, the_default 20 opt_lim) (intprover_tac ctxt [] 0) 4 1);
wenzelm@17110
   337
wenzelm@17110
   338
end;
wenzelm@8195
   339
wenzelm@8195
   340
wenzelm@8351
   341
(* ML tactics *)
wenzelm@8351
   342
wenzelm@20289
   343
val tactic_ref = ref ((fn _ => raise Match): Proof.context -> thm list -> tactic);
wenzelm@8351
   344
fun set_tactic f = tactic_ref := f;
wenzelm@8351
   345
wenzelm@8351
   346
fun tactic txt ctxt = METHOD (fn facts =>
wenzelm@22134
   347
 (ML_Context.use_mltext
wenzelm@22134
   348
   ("let fun tactic (ctxt: Proof.context) (facts: thm list) : tactic =\n"
wenzelm@22134
   349
     ^ txt ^ "\nin Method.set_tactic tactic end") false (SOME (Context.Proof ctxt));
wenzelm@22134
   350
  ML_Context.setmp (SOME (Context.Proof ctxt)) (! tactic_ref ctxt) facts));
wenzelm@8351
   351
wenzelm@8351
   352
wenzelm@5824
   353
wenzelm@17110
   354
(** method syntax **)
wenzelm@17110
   355
wenzelm@17110
   356
(* method text *)
wenzelm@17110
   357
wenzelm@17110
   358
type src = Args.src;
wenzelm@5824
   359
wenzelm@17110
   360
datatype text =
wenzelm@23349
   361
  Basic of (Proof.context -> method) * Position.T |
wenzelm@17110
   362
  Source of src |
wenzelm@20030
   363
  Source_i of src |
wenzelm@17110
   364
  Then of text list |
wenzelm@17110
   365
  Orelse of text list |
wenzelm@17110
   366
  Try of text |
wenzelm@19186
   367
  Repeat1 of text |
wenzelm@19186
   368
  SelectGoals of int * text;
wenzelm@17110
   369
wenzelm@23349
   370
fun primitive_text r = Basic (K (SIMPLE_METHOD (PRIMITIVE r)), Position.none);
wenzelm@23349
   371
val succeed_text = Basic (K succeed, Position.none);
wenzelm@17110
   372
val default_text = Source (Args.src (("default", []), Position.none));
wenzelm@23349
   373
val this_text = Basic (K this, Position.none);
wenzelm@23349
   374
val done_text = Basic (K (SIMPLE_METHOD all_tac), Position.none);
wenzelm@23349
   375
fun sorry_text int = Basic (cheating int, Position.none);
wenzelm@17110
   376
wenzelm@23349
   377
fun finish_text (NONE, immed) pos = Basic (close immed, pos)
wenzelm@23349
   378
  | finish_text (SOME txt, immed) pos = Then [txt, Basic (close immed, pos)];
wenzelm@17110
   379
wenzelm@17110
   380
wenzelm@17110
   381
(* method definitions *)
wenzelm@5824
   382
wenzelm@16448
   383
structure MethodsData = TheoryDataFun
wenzelm@22846
   384
(
wenzelm@20289
   385
  type T = (((src -> Proof.context -> method) * string) * stamp) NameSpace.table;
wenzelm@16347
   386
  val empty = NameSpace.empty_table;
wenzelm@6546
   387
  val copy = I;
wenzelm@16448
   388
  val extend = I;
haftmann@17496
   389
  fun merge _ tables = NameSpace.merge_tables (eq_snd (op =)) tables handle Symtab.DUPS dups =>
wenzelm@16347
   390
    error ("Attempt to merge different versions of method(s) " ^ commas_quote dups);
wenzelm@22846
   391
);
wenzelm@5824
   392
wenzelm@22846
   393
fun print_methods thy =
wenzelm@22846
   394
  let
wenzelm@22846
   395
    val meths = MethodsData.get thy;
wenzelm@22846
   396
    fun prt_meth (name, ((_, comment), _)) = Pretty.block
wenzelm@22846
   397
      [Pretty.str (name ^ ":"), Pretty.brk 2, Pretty.str comment];
wenzelm@22846
   398
  in
wenzelm@22846
   399
    [Pretty.big_list "methods:" (map prt_meth (NameSpace.extern_table meths))]
wenzelm@22846
   400
    |> Pretty.chunks |> Pretty.writeln
wenzelm@22846
   401
  end;
wenzelm@7611
   402
wenzelm@5824
   403
wenzelm@5824
   404
(* get methods *)
wenzelm@5824
   405
wenzelm@5916
   406
exception METHOD_FAIL of (string * Position.T) * exn;
wenzelm@5916
   407
wenzelm@20030
   408
fun method_i thy =
wenzelm@5824
   409
  let
wenzelm@20030
   410
    val meths = #2 (MethodsData.get thy);
wenzelm@5884
   411
    fun meth src =
wenzelm@20030
   412
      let val ((name, _), pos) = Args.dest_src src in
wenzelm@17412
   413
        (case Symtab.lookup meths name of
skalberg@15531
   414
          NONE => error ("Unknown proof method: " ^ quote name ^ Position.str_of pos)
skalberg@15531
   415
        | SOME ((mth, _), _) => transform_failure (curry METHOD_FAIL (name, pos)) (mth src))
wenzelm@5824
   416
      end;
wenzelm@5824
   417
  in meth end;
wenzelm@5824
   418
wenzelm@20030
   419
fun method thy = method_i thy o Args.map_name (NameSpace.intern (#1 (MethodsData.get thy)));
wenzelm@20030
   420
wenzelm@5824
   421
wenzelm@17110
   422
(* add method *)
wenzelm@5824
   423
wenzelm@5824
   424
fun add_methods raw_meths thy =
wenzelm@5824
   425
  let
wenzelm@16145
   426
    val new_meths = raw_meths |> map (fn (name, f, comment) =>
wenzelm@16347
   427
      (name, ((f, comment), stamp ())));
wenzelm@5824
   428
haftmann@23086
   429
    fun add meths = NameSpace.extend_table (Sign.naming_of thy) new_meths meths
wenzelm@16347
   430
      handle Symtab.DUPS dups =>
wenzelm@16347
   431
        error ("Duplicate declaration of method(s) " ^ commas_quote dups);
wenzelm@16347
   432
  in MethodsData.map add thy end;
wenzelm@5824
   433
wenzelm@9194
   434
val add_method = add_methods o Library.single;
wenzelm@9194
   435
wenzelm@5824
   436
wenzelm@17356
   437
(* method_setup *)
wenzelm@17356
   438
wenzelm@17356
   439
fun method_setup (name, txt, cmt) =
wenzelm@22118
   440
  ML_Context.use_let
wenzelm@22118
   441
    "val method: bstring * (Method.src -> Proof.context -> Proof.method) * string"
wenzelm@22086
   442
    "Context.map_theory (Method.add_method method)"
wenzelm@22086
   443
    ("(" ^ quote name ^ ", " ^ txt ^ ", " ^ quote cmt ^ ")")
wenzelm@22086
   444
  |> Context.theory_map;
wenzelm@17356
   445
wenzelm@17356
   446
wenzelm@5884
   447
wenzelm@17110
   448
(** concrete syntax **)
wenzelm@5824
   449
wenzelm@5884
   450
(* basic *)
wenzelm@5884
   451
wenzelm@18999
   452
fun syntax scan = Args.context_syntax "method" scan;
wenzelm@5824
   453
wenzelm@17110
   454
fun simple_args scan f src ctxt : method =
haftmann@21879
   455
  fst (syntax (Scan.lift (scan >> (fn x => f x ctxt))) src ctxt);
wenzelm@8351
   456
wenzelm@20289
   457
fun ctxt_args (f: Proof.context -> method) src ctxt =
haftmann@21879
   458
  fst (syntax (Scan.succeed (f ctxt)) src ctxt);
wenzelm@7555
   459
wenzelm@7555
   460
fun no_args m = ctxt_args (K m);
wenzelm@5884
   461
wenzelm@5884
   462
wenzelm@5884
   463
(* sections *)
wenzelm@5824
   464
wenzelm@20289
   465
type modifier = (Proof.context -> Proof.context) * attribute;
wenzelm@7268
   466
wenzelm@7268
   467
local
wenzelm@7268
   468
wenzelm@8381
   469
fun sect ss = Scan.first (map Scan.lift ss);
wenzelm@19482
   470
fun thms ss = Scan.repeat (Scan.unless (sect ss) Attrib.multi_thm) >> flat;
wenzelm@5884
   471
wenzelm@19186
   472
fun app (f, att) (context, ths) = foldl_map att (Context.map_proof f context, ths);
wenzelm@5824
   473
wenzelm@18999
   474
fun section ss = (sect ss -- thms ss) :-- (fn (m, ths) => Scan.depend (fn context =>
wenzelm@19186
   475
  Scan.succeed (app m (context, ths)))) >> #2;
wenzelm@5884
   476
wenzelm@7601
   477
fun sectioned args ss = args -- Scan.repeat (section ss);
wenzelm@5884
   478
wenzelm@7268
   479
in
wenzelm@5824
   480
wenzelm@5884
   481
fun sectioned_args args ss f src ctxt =
haftmann@21879
   482
  let val ((x, _), ctxt') = syntax (sectioned args ss) src ctxt
wenzelm@5921
   483
  in f x ctxt' end;
wenzelm@5884
   484
wenzelm@7601
   485
fun bang_sectioned_args ss f = sectioned_args Args.bang_facts ss f;
wenzelm@9777
   486
fun bang_sectioned_args' ss scan f =
wenzelm@9777
   487
  sectioned_args (Args.bang_facts -- scan >> swap) ss (uncurry f);
wenzelm@7601
   488
fun only_sectioned_args ss f = sectioned_args (Scan.succeed ()) ss (fn () => f);
wenzelm@7268
   489
wenzelm@18999
   490
fun thms_ctxt_args f = sectioned_args (thms []) [] f;
wenzelm@8093
   491
fun thms_args f = thms_ctxt_args (K o f);
wenzelm@9706
   492
fun thm_args f = thms_args (fn [thm] => f thm | _ => error "Single theorem expected");
wenzelm@5824
   493
wenzelm@7268
   494
end;
wenzelm@7268
   495
wenzelm@5824
   496
nipkow@17587
   497
(* iprover syntax *)
wenzelm@12347
   498
wenzelm@12347
   499
local
wenzelm@12347
   500
wenzelm@12347
   501
val introN = "intro";
wenzelm@12347
   502
val elimN = "elim";
wenzelm@12347
   503
val destN = "dest";
wenzelm@12347
   504
val ruleN = "rule";
wenzelm@12347
   505
wenzelm@12347
   506
fun modifier name kind kind' att =
skalberg@15531
   507
  Args.$$$ name |-- (kind >> K NONE || kind' |-- Args.nat --| Args.colon >> SOME)
wenzelm@20289
   508
    >> (pair (I: Proof.context -> Proof.context) o att);
wenzelm@12347
   509
nipkow@17587
   510
val iprover_modifiers =
wenzelm@18728
   511
 [modifier destN Args.bang_colon Args.bang ContextRules.dest_bang,
wenzelm@18728
   512
  modifier destN Args.colon (Scan.succeed ()) ContextRules.dest,
wenzelm@18728
   513
  modifier elimN Args.bang_colon Args.bang ContextRules.elim_bang,
wenzelm@18728
   514
  modifier elimN Args.colon (Scan.succeed ()) ContextRules.elim,
wenzelm@18728
   515
  modifier introN Args.bang_colon Args.bang ContextRules.intro_bang,
wenzelm@18728
   516
  modifier introN Args.colon (Scan.succeed ()) ContextRules.intro,
wenzelm@18728
   517
  Args.del -- Args.colon >> K (I, ContextRules.rule_del)];
wenzelm@12347
   518
wenzelm@12347
   519
in
wenzelm@12347
   520
wenzelm@18640
   521
val iprover_meth =
wenzelm@18640
   522
  bang_sectioned_args' iprover_modifiers (Scan.lift (Scan.option Args.nat))
wenzelm@18640
   523
    (fn n => fn prems => fn ctxt => METHOD (fn facts =>
wenzelm@18640
   524
      HEADGOAL (insert_tac (prems @ facts) THEN'
wenzelm@18640
   525
      ObjectLogic.atomize_tac THEN' iprover_tac ctxt n)));
wenzelm@12347
   526
wenzelm@12347
   527
end;
wenzelm@12347
   528
wenzelm@12347
   529
wenzelm@9539
   530
(* tactic syntax *)
wenzelm@8238
   531
wenzelm@10744
   532
fun nat_thms_args f = uncurry f oo
haftmann@21879
   533
  (fst oo syntax (Scan.lift (Scan.optional (Args.parens Args.nat) 0) -- Attrib.thms));
wenzelm@10744
   534
haftmann@21879
   535
fun goal_args' args tac src ctxt = fst (syntax (Args.goal_spec HEADGOAL -- args >>
wenzelm@21592
   536
  (fn (quant, s) => SIMPLE_METHOD'' quant (tac s))) src ctxt);
wenzelm@8537
   537
wenzelm@9539
   538
fun goal_args args tac = goal_args' (Scan.lift args) tac;
wenzelm@8238
   539
ballarin@14174
   540
fun goal_args_ctxt' args tac src ctxt =
haftmann@21879
   541
  fst (syntax (Args.goal_spec HEADGOAL -- args >>
wenzelm@21592
   542
  (fn (quant, s) => SIMPLE_METHOD'' quant (tac ctxt s))) src ctxt);
wenzelm@8238
   543
ballarin@14174
   544
fun goal_args_ctxt args tac = goal_args_ctxt' (Scan.lift args) tac;
wenzelm@5824
   545
wenzelm@14718
   546
wenzelm@18708
   547
(* theory setup *)
wenzelm@5824
   548
wenzelm@18708
   549
val _ = Context.add_setup (add_methods
wenzelm@5824
   550
 [("fail", no_args fail, "force failure"),
wenzelm@5824
   551
  ("succeed", no_args succeed, "succeed"),
wenzelm@9587
   552
  ("-", no_args insert_facts, "do nothing (insert current facts only)"),
wenzelm@9539
   553
  ("insert", thms_args insert, "insert theorems, ignoring facts (improper)"),
wenzelm@12384
   554
  ("intro", thms_args intro, "repeatedly apply introduction rules"),
wenzelm@12384
   555
  ("elim", thms_args elim, "repeatedly apply elimination rules"),
wenzelm@18877
   556
  ("unfold", thms_ctxt_args unfold_meth, "unfold definitions"),
wenzelm@18877
   557
  ("fold", thms_ctxt_args fold_meth, "fold definitions"),
haftmann@21879
   558
  ("atomize", (atomize o fst) oo syntax (Args.mode "full"),
wenzelm@11962
   559
    "present local premises as object-level statements"),
wenzelm@18640
   560
  ("iprover", iprover_meth, "intuitionistic proof search"),
wenzelm@12384
   561
  ("rule", thms_ctxt_args some_rule, "apply some intro/elim rule"),
wenzelm@10744
   562
  ("erule", nat_thms_args erule, "apply rule in elimination manner (improper)"),
wenzelm@10744
   563
  ("drule", nat_thms_args drule, "apply rule in destruct manner (improper)"),
wenzelm@10744
   564
  ("frule", nat_thms_args frule, "apply rule in forward manner (improper)"),
wenzelm@8195
   565
  ("this", no_args this, "apply current facts as rules"),
wenzelm@18039
   566
  ("fact", thms_ctxt_args fact, "composition by facts from context"),
wenzelm@8238
   567
  ("assumption", ctxt_args assumption, "proof by assumption, preferring facts"),
wenzelm@20335
   568
  ("rename_tac", goal_args (Scan.repeat1 Args.name) Tactic.rename_params_tac,
wenzelm@22586
   569
    "rename parameters of goal"),
wenzelm@20335
   570
  ("rotate_tac", goal_args (Scan.optional Args.int 1) Tactic.rotate_tac,
wenzelm@20335
   571
    "rotate assumptions of goal"),
wenzelm@18708
   572
  ("tactic", simple_args Args.name tactic, "ML tactic as proof method")]);
wenzelm@5824
   573
wenzelm@5824
   574
wenzelm@22118
   575
(* outer parser *)
wenzelm@22118
   576
wenzelm@22118
   577
local
wenzelm@22118
   578
wenzelm@22118
   579
structure T = OuterLex;
wenzelm@22118
   580
structure P = OuterParse;
wenzelm@22118
   581
wenzelm@22118
   582
fun is_symid_meth s =
wenzelm@22118
   583
  s <> "|" andalso s <> "?" andalso s <> "+" andalso T.is_sid s;
wenzelm@22118
   584
wenzelm@22118
   585
fun meth4 x =
wenzelm@22118
   586
 (P.position (P.xname >> rpair []) >> (Source o Args.src) ||
wenzelm@22118
   587
  P.$$$ "(" |-- P.!!! (meth0 --| P.$$$ ")")) x
wenzelm@22118
   588
and meth3 x =
wenzelm@22118
   589
 (meth4 --| P.$$$ "?" >> Try ||
wenzelm@22118
   590
  meth4 --| P.$$$ "+" >> Repeat1 ||
wenzelm@22118
   591
  meth4 -- (P.$$$ "[" |-- Scan.optional P.nat 1 --| P.$$$ "]") >> (SelectGoals o swap) ||
wenzelm@22118
   592
  meth4) x
wenzelm@22118
   593
and meth2 x =
wenzelm@22118
   594
 (P.position (P.xname -- P.args1 is_symid_meth false) >> (Source o Args.src) ||
wenzelm@22118
   595
  meth3) x
wenzelm@22118
   596
and meth1 x = (P.enum1 "," meth2 >> (fn [m] => m | ms => Then ms)) x
wenzelm@22118
   597
and meth0 x = (P.enum1 "|" meth1 >> (fn [m] => m | ms => Orelse ms)) x;
wenzelm@22118
   598
wenzelm@22118
   599
in val parse = meth3 end;
wenzelm@22118
   600
wenzelm@22118
   601
wenzelm@16145
   602
(*final declarations of this structure!*)
wenzelm@16145
   603
val unfold = unfold_meth;
wenzelm@16145
   604
val fold = fold_meth;
wenzelm@16145
   605
wenzelm@5824
   606
end;
wenzelm@5824
   607
wenzelm@5824
   608
structure BasicMethod: BASIC_METHOD = Method;
wenzelm@5824
   609
open BasicMethod;