helm/software/components/disambiguation/multiPassDisambiguator.ml

   1 (* Copyright (C) 2004-2005, HELM Team.
   2  *
   3  * This file is part of HELM, an Hypertextual, Electronic
   4  * Library of Mathematics, developed at the Computer Science
   5  * Department, University of Bologna, Italy.
   6  *
   7  * HELM is free software; you can redistribute it and/or
   8  * modify it under the terms of the GNU General Public License
   9  * as published by the Free Software Foundation; either version 2
  10  * of the License, or (at your option) any later version.
  11  *
  12  * HELM is distributed in the hope that it will be useful,
  13  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  14  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  15  * GNU General Public License for more details.
  16  *
  17  * You should have received a copy of the GNU General Public License
  18  * along with HELM; if not, write to the Free Software
  19  * Foundation, Inc., 59 Temple Place - Suite 330, Boston,
  20  * MA  02111-1307, USA.
  21  *
  22  * For details, see the HELM World-Wide-Web page,
  23  * http://helm.cs.unibo.it/
  24  *)
  25
  26 (* $Id$ *)
  27
  28 open Printf
  29
  30 let debug = false;;
  31 let debug_print s =
  32  if debug then prerr_endline (Lazy.force s);;
  33
  34 exception Ambiguous_input
  35 (* the integer is an offset to be added to each location *)
  36 exception DisambiguationError of
  37  int *
  38  ((Stdpp.location list * string * string) list *
  39   (DisambiguateTypes.domain_item * string) list *
  40   (Stdpp.location * string) Lazy.t * bool) list list
  41   (** parameters are: option name, error message *)
  42
  43 let mono_uris_callback ~selection_mode ?ok
  44           ?(enable_button_for_non_vars = true) ~title ~msg ~id =
  45  if Helm_registry.get_opt_default Helm_registry.get_bool ~default:true
  46       "matita.auto_disambiguation"
  47  then
  48   function l -> l
  49  else
  50   raise Ambiguous_input
  51
  52 let mono_interp_callback _ _ _ = raise Ambiguous_input
  53
  54 let _choose_uris_callback = ref mono_uris_callback
  55 let _choose_interp_callback = ref mono_interp_callback
  56 let set_choose_uris_callback f = _choose_uris_callback := f
  57 let set_choose_interp_callback f = _choose_interp_callback := f
  58
  59 module Callbacks =
  60   struct
  61     let interactive_user_uri_choice = !_choose_uris_callback
  62
  63     let interactive_interpretation_choice interp =
  64       !_choose_interp_callback interp
  65
  66     let input_or_locate_uri ~(title:string) ?id () = None
  67       (* Zack: I try to avoid using this callback. I therefore assume that
  68       * the presence of an identifier that can't be resolved via "locate"
  69       * query is a syntax error *)
  70   end
  71
  72 module Disambiguator = Disambiguate.Make (Callbacks)
  73
  74 (* implement module's API *)
  75
  76 let only_one_pass = ref false;;
  77
  78 let passes () = (* <fresh_instances?, aliases, coercions?> *)
  79  if !only_one_pass then
  80   [ (true, `Mono, false) ]
  81  else
  82   [ (true, `Mono, false);
  83     (true, `Multi, false);
  84     (true, `Mono, true);
  85     (true, `Multi, true);
  86     (true, `Library, false);
  87       (* for demo to reduce the number of interpretations *)
  88     (true, `Library, true);
  89   ]
  90 ;;
  91
  92 let drop_aliases ?(minimize_instances=false) (choices, user_asked) =
  93  let module D = DisambiguateTypes in
  94  let minimize d =
  95   if not minimize_instances then
  96    d
  97   else
  98    let rec aux =
  99     function
 100        [] -> []
 101      | (D.Symbol (s,n),((descr,_) as ci)) as he::tl when n > 0 ->
 102          if
 103           List.for_all
 104            (function
 105                (D.Symbol (s2,_),(descr2,_)) -> s2 <> s || descr = descr2
 106              | _ -> true
 107            ) d
 108          then
 109           (D.Symbol (s,0),ci)::(aux tl)
 110          else
 111           he::(aux tl)
 112      | (D.Num n,((descr,_) as ci)) as he::tl when n > 0 ->
 113          if
 114           List.for_all
 115            (function (D.Num _,(descr2,_)) -> descr = descr2 | _ -> true) d
 116          then
 117           (D.Num 0,ci)::(aux tl)
 118          else
 119           he::(aux tl)
 120       | he::tl -> he::(aux tl)
 121    in
 122     aux d
 123  in
 124   (List.map (fun (d, a, b, c, e) -> minimize d, a, b, c, e) choices),
 125   user_asked
 126
 127 let drop_aliases_and_clear_diff (choices, user_asked) =
 128   (List.map (fun (_, a, b, c, d) -> [], a, b, c, d) choices),
 129   user_asked
 130
 131 let disambiguate_thing ~passes ~aliases ~universe ~f thing =
 132   assert (universe <> None);
 133   let library = false, DisambiguateTypes.Environment.empty, None in
 134   let multi_aliases = false, DisambiguateTypes.Environment.empty, universe in
 135   let mono_aliases = true, aliases, Some DisambiguateTypes.Environment.empty in
 136   let passes =
 137     List.map
 138      (function (fresh_instances,env,use_coercions) ->
 139        fresh_instances,
 140        (match env with `Mono -> mono_aliases | `Multi -> multi_aliases |
 141        `Library -> library),
 142        use_coercions) passes in
 143   let try_pass (fresh_instances, (_, aliases, universe), use_coercions) =
 144     f ~fresh_instances ~aliases ~universe ~use_coercions thing
 145   in
 146   let set_aliases (instances,(use_mono_aliases,_,_),_) (_, user_asked as res) =
 147    if use_mono_aliases then
 148     drop_aliases ~minimize_instances:true res (* one shot aliases *)
 149    else if user_asked then
 150     drop_aliases ~minimize_instances:true res (* one shot aliases *)
 151    else
 152     drop_aliases_and_clear_diff res
 153   in
 154   let rec aux i errors passes =
 155   debug_print (lazy ("Pass: " ^ string_of_int i));
 156    match passes with
 157       [ pass ] ->
 158         (try
 159           set_aliases pass (try_pass pass)
 160          with Disambiguate.NoWellTypedInterpretation (offset,newerrors) ->
 161           raise (DisambiguationError (offset, errors @ [newerrors])))
 162     | hd :: tl ->
 163         (try
 164           set_aliases hd (try_pass hd)
 165         with Disambiguate.NoWellTypedInterpretation (_offset,newerrors) ->
 166          aux (i+1) (errors @ [newerrors]) tl)
 167     | [] -> assert false
 168   in
 169    aux 1 [] passes
 170
 171 let disambiguate_thing ~passes ~freshen_thing ~context ~metasenv ~subst
 172   ~mk_implicit ~string_context_of_context ~initial_ugraph ~hint ~aliases
 173   ~universe ~lookup_in_library ~uri ~pp_thing ~domain_of_thing
 174   ~interpretate_thing ~refine_thing ~localization_tbl thing
 175  =
 176   let f ~fresh_instances ~aliases ~universe ~use_coercions (txt,len,thing) =
 177     let thing = if fresh_instances then freshen_thing thing else thing
 178     in
 179      Disambiguator.disambiguate_thing
 180       ~context ~metasenv ~subst ~use_coercions
 181       ~mk_implicit ~string_context_of_context
 182       ~initial_ugraph ~hint
 183       ~aliases ~universe ~lookup_in_library
 184       ~uri ~pp_thing ~domain_of_thing ~interpretate_thing ~refine_thing
 185       ~localization_tbl (txt,len,thing)
 186   in
 187   disambiguate_thing ~passes ~aliases ~universe ~f thing