]> matita.cs.unibo.it Git - helm.git/blob - helm/matita/matitaMathView.ml
- commented out no longer needed macros Redo, Undo, Abort
[helm.git] / helm / matita / matitaMathView.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://cs.unibo.it/helm/.
24  *)
25
26 open Printf
27
28 open MatitaTypes
29
30 let list_map_fail f =
31   let rec aux = function
32     | [] -> []
33     | he::tl ->
34         try
35           let he' = f he in
36           he'::(aux tl)
37         with Exit ->
38           (aux tl)
39   in
40   aux
41
42 (** inherit from this class if you want to access current script *)
43 class scriptAccessor =
44 object (self)
45   method private script = MatitaScript.instance ()
46 end
47
48 class clickableMathView obj =
49   let href = Gdome.domString "href" in
50   let xref = Gdome.domString "xref" in
51   object (self)
52     inherit GMathViewAux.multi_selection_math_view obj
53
54     val mutable href_callback: (string -> unit) option = None
55     method set_href_callback f = href_callback <- f
56
57     initializer
58       ignore (self#connect#selection_changed self#choose_selection);
59       ignore (self#connect#click (fun (gdome_elt, _, _, _) ->
60         match gdome_elt with
61         | Some elt  (* element is an hyperlink, use href_callback on it *)
62           when elt#hasAttributeNS ~namespaceURI:Misc.xlink_ns ~localName:href ->
63             (match href_callback with
64             | None -> ()
65             | Some f ->
66                 let uri =
67                   elt#getAttributeNS ~namespaceURI:Misc.xlink_ns ~localName:href
68                 in
69                 f (uri#to_string))
70         | Some elt -> ignore (self#action_toggle elt)
71         | None -> ()))
72     method private choose_selection gdome_elt =
73       let rec aux elt =
74         if elt#hasAttributeNS ~namespaceURI:Misc.helm_ns ~localName:xref then
75           self#set_selection (Some elt)
76         else
77           try
78             (match elt#get_parentNode with
79             | None -> assert false
80             | Some p -> aux (new Gdome.element_of_node p))
81           with GdomeInit.DOMCastException _ -> ()
82 (*             debug_print "trying to select above the document root" *)
83       in
84       match gdome_elt with
85       | Some elt -> aux elt
86       | None   -> self#set_selection None
87   end
88
89 let clickableMathView ?hadjustment ?vadjustment ?font_size ?log_verbosity =
90   GtkBase.Widget.size_params
91     ~cont:(OgtkMathViewProps.pack_return (fun p ->
92       OgtkMathViewProps.set_params
93         (new clickableMathView (GtkMathViewProps.MathView_GMetaDOM.create p))
94         ~font_size:None ~log_verbosity:None))
95     []
96
97 class sequentViewer obj =
98   object(self)
99
100     inherit clickableMathView obj
101
102     val mutable current_infos = None
103
104     method get_selected_terms =
105       let selections = self#get_selections in
106       list_map_fail
107         (fun node ->
108           let xpath =
109             ((node : Gdome.element)#getAttributeNS
110               ~namespaceURI:Misc.helm_ns
111               ~localName:(Gdome.domString "xref"))#to_string
112           in
113           if xpath = "" then assert false (* "ERROR: No xref found!!!" *)
114           else
115             match current_infos with
116             | Some (ids_to_terms,_,_) ->
117                 (try Hashtbl.find ids_to_terms xpath with _ -> raise Exit)
118             | None -> assert false) (* "ERROR: No current term!!!" *)
119         selections
120
121     method get_selected_hypotheses =
122       let selections = self#get_selections in
123       list_map_fail
124         (fun node ->
125           let xpath =
126             ((node : Gdome.element)#getAttributeNS
127               ~namespaceURI:Misc.helm_ns
128               ~localName:(Gdome.domString "xref"))#to_string
129           in
130           if xpath = "" then assert false (* "ERROR: No xref found!!!" *)
131           else
132             match current_infos with
133             | Some (_,_,ids_to_hypotheses) ->
134                 (try Hashtbl.find ids_to_hypotheses xpath with _ -> raise Exit)
135             | None -> assert false) (* "ERROR: No current term!!!" *)
136         selections
137   
138   method load_sequent metasenv metano =
139     let sequent = CicUtil.lookup_meta metano metasenv in
140     let (mathml,(_,(ids_to_terms, ids_to_father_ids, ids_to_hypotheses,_))) =
141       ApplyTransformation.mml_of_cic_sequent metasenv sequent
142     in
143     current_infos <- Some (ids_to_terms, ids_to_father_ids, ids_to_hypotheses);
144 (*
145     debug_print "load_sequent: dumping MathML to ./prova";
146     ignore (Misc.domImpl#saveDocumentToFile ~name:"./prova" ~doc:mathml ());
147 *)
148     self#load_root ~root:mathml#get_documentElement
149  end
150
151 class sequentsViewer ~(notebook:GPack.notebook)
152   ~(sequentViewer:sequentViewer) ()
153 =
154   object (self)
155     inherit scriptAccessor
156
157     val mutable pages = 0
158     val mutable switch_page_callback = None
159     val mutable page2goal = []  (* associative list: page no -> goal no *)
160     val mutable goal2page = []  (* the other way round *)
161     val mutable goal2win = []   (* associative list: goal no -> scrolled win *)
162     val mutable _metasenv = []
163     val mutable scrolledWin: GBin.scrolled_window option = None
164       (* scrolled window to which the sequentViewer is currently attached *)
165
166     method private tab_label metano =
167       (GMisc.label ~text:(sprintf "?%d" metano) ~show:true ())#coerce
168
169     method reset =
170       (match scrolledWin with
171       | Some w ->
172           (* removing page from the notebook will destroy all contained widget,
173           * we do not want the sequentViewer to be destroyed as well *)
174           w#remove sequentViewer#coerce;
175           scrolledWin <- None
176       | None -> ());
177       for i = 1 to pages do notebook#remove_page 0 done;
178       pages <- 0;
179       page2goal <- [];
180       goal2page <- [];
181       goal2win <- [];
182       _metasenv <- [];
183       self#script#setGoal ~-1;
184       (match switch_page_callback with
185       | Some id ->
186           GtkSignal.disconnect notebook#as_widget id;
187           switch_page_callback <- None
188       | None -> ())
189
190     method load_sequents (status: ProofEngineTypes.status) =
191       let ((_, metasenv, _, _), goal) = status in
192       let sequents_no = List.length metasenv in
193       _metasenv <- metasenv;
194       pages <- sequents_no;
195       self#script#setGoal goal;
196       let win metano =
197         let w =
198           GBin.scrolled_window ~hpolicy:`AUTOMATIC ~vpolicy:`AUTOMATIC
199             ~shadow_type:`IN ~show:true ()
200         in
201         let reparent () =
202           scrolledWin <- Some w;
203           match sequentViewer#misc#parent with
204           | None -> w#add sequentViewer#coerce
205           | Some _ -> sequentViewer#misc#reparent w#coerce
206         in
207         goal2win <- (metano, reparent) :: goal2win;
208         w#coerce
209       in
210       let page = ref 0 in
211       List.iter
212         (fun (metano, _, _) ->
213           page2goal <- (!page, metano) :: page2goal;
214           goal2page <- (metano, !page) :: goal2page;
215           incr page;
216           notebook#append_page ~tab_label:(self#tab_label metano) (win metano))
217         metasenv;
218       switch_page_callback <-
219         Some (notebook#connect#switch_page ~callback:(fun page ->
220           let goal =
221             try
222               List.assoc page page2goal
223             with Not_found -> assert false
224           in
225           self#script#setGoal goal;
226           self#render_page ~page ~goal))
227
228     method private render_page ~page ~goal =
229       sequentViewer#load_sequent _metasenv goal;
230       try
231         List.assoc goal goal2win ();
232         sequentViewer#set_selection None
233       with Not_found -> assert false
234
235     method goto_sequent goal =
236       let page =
237         try
238           List.assoc goal goal2page
239         with Not_found -> assert false
240       in
241       notebook#goto_page page;
242       self#render_page page goal
243
244   end
245
246  (** constructors *)
247
248 type 'widget constructor =
249   ?hadjustment:GData.adjustment ->
250   ?vadjustment:GData.adjustment ->
251   ?font_size:int ->
252   ?log_verbosity:int ->
253   ?width:int ->
254   ?height:int ->
255   ?packing:(GObj.widget -> unit) ->
256   ?show:bool ->
257   unit ->
258     'widget
259
260 let sequentViewer ?hadjustment ?vadjustment ?font_size ?log_verbosity =
261   GtkBase.Widget.size_params
262     ~cont:(OgtkMathViewProps.pack_return (fun p ->
263       OgtkMathViewProps.set_params
264         (new sequentViewer (GtkMathViewProps.MathView_GMetaDOM.create p))
265         ~font_size ~log_verbosity))
266     []
267
268 let blank_uri = BuildTimeConf.blank_uri
269 let current_proof_uri = BuildTimeConf.current_proof_uri
270
271 type term_source =
272   [ `Ast of DisambiguateTypes.term
273   | `Cic of Cic.term * Cic.metasenv
274   | `String of string
275   ]
276
277 exception Browser_failure of string
278
279 let cicBrowsers = ref []
280
281 class type cicBrowser =
282 object
283   method load: MatitaTypes.mathViewer_entry -> unit
284   (* method loadList: string list -> MatitaTypes.mathViewer_entry-> unit *)
285   method loadInput: string -> unit
286 end
287
288 class cicBrowser_impl ~(history:MatitaTypes.mathViewer_entry MatitaMisc.history)
289   ()
290 =
291   let term_RE = Pcre.regexp "^term:(.*)" in
292   let whelp_RE = Pcre.regexp "^\\s*whelp" in
293   let whelp_query_RE = Pcre.regexp "^\\s*whelp\\s+([^\\s]+)\\s+(.*)$" in
294   let trailing_slash_RE = Pcre.regexp "/$" in
295   let has_xpointer_RE = Pcre.regexp "#xpointer\\(\\d+/\\d+(/\\d+)?\\)$" in
296   let gui = MatitaGui.instance () in
297   let win = gui#newBrowserWin () in
298   let queries = ["Locate";"Hint";"Match";"Elim";"Instance"] in
299   let combo,_ = GEdit.combo_box_text ~strings:queries () in
300   let activate_combo_query input q =
301     let q' = String.lowercase q in
302     let rec aux i = function
303       | [] -> failwith ("Whelp query '" ^ q ^ "' not found")
304       | h::_ when String.lowercase h = q' -> i
305       | _::tl -> aux (i+1) tl
306     in
307     combo#set_active (aux 0 queries);
308     win#queryInputText#set_text input
309   in
310   let set_whelp_query txt =
311     let query, arg = 
312       try
313         let q = Pcre.extract ~rex:whelp_query_RE txt in
314         q.(1), q.(2)
315       with Invalid_argument _ -> failwith "Malformed Whelp query"
316     in
317     activate_combo_query arg query
318   in
319   let toplevel = win#toplevel in
320   let mathView = sequentViewer ~packing:win#scrolledBrowser#add () in
321   let fail msg =
322     ignore (MatitaGtkMisc.ask_confirmation ~gui:(MatitaGui.instance ())
323       ~title:"Cic browser" ~msg ~cancel:false ());
324   in
325   let handle_error f =
326     try
327       f ()
328     with exn ->
329       fail (sprintf "Uncaught exception:\n%s" (Printexc.to_string exn))
330   in
331   let handle_error' f = fun () -> handle_error f in  (* used in callbacks *)
332   object (self)
333     inherit scriptAccessor
334     
335     (* Whelp bar queries *)
336
337     initializer
338       activate_combo_query "" "locate";
339       win#comboVbox#add (combo :> GObj.widget);
340       let start_query () = 
341         let query = String.lowercase (List.nth queries combo#active) in
342         let input = win#queryInputText#text in
343         let statement = "whelp " ^ query ^ " " ^ input ^ "." in
344         (MatitaScript.instance ())#advance ~statement ()
345       in
346       ignore(win#queryInputText#connect#activate ~callback:start_query);
347       ignore(combo#connect#changed ~callback:start_query);
348       win#whelpImage2#set_file "icons/whelp.png";
349       win#whelpBarToggleButton#set_active false;   
350       win#whelpBarBox#misc#hide ();
351       win#mathOrListNotebook#set_show_tabs false;
352       MatitaGtkMisc.connect_toggle_button win#whelpBarToggleButton 
353         (fun () -> 
354           if win#whelpBarToggleButton#active then
355             win#whelpBarBox#misc#show ()
356           else
357             win#whelpBarBox#misc#hide ());
358
359       win#browserForwardButton#misc#set_sensitive false;
360       win#browserBackButton#misc#set_sensitive false;
361       ignore (win#browserUri#connect#activate (handle_error' (fun () ->
362         self#loadInput win#browserUri#text)));
363       ignore (win#browserHomeButton#connect#clicked (handle_error' (fun () ->
364         self#_load (`About `Current_proof))));
365       ignore (win#browserRefreshButton#connect#clicked
366         (handle_error' self#refresh));
367       ignore (win#browserBackButton#connect#clicked (handle_error' self#back));
368       ignore (win#browserForwardButton#connect#clicked
369         (handle_error' self#forward));
370       ignore (win#toplevel#event#connect#delete (fun _ ->
371         let my_id = Oo.id self in
372         cicBrowsers := List.filter (fun b -> Oo.id b <> my_id) !cicBrowsers;
373         if !cicBrowsers = [] &&
374           Helm_registry.get "matita.mode" = "cicbrowser"
375         then
376           GMain.quit ();
377         false));
378       ignore(win#whelpResultTreeview#connect#row_activated 
379         ~callback:(fun _ _ ->
380           let selection = self#_getWhelpResultTreeviewSelection () in
381           let is_cic s =
382             try
383               String.sub s 0 5 = "cic:/"
384             with Invalid_argument _ -> false
385           in
386           let txt = 
387             if is_cic selection then
388               selection
389             else
390               win#browserUri#text ^ selection 
391           in
392           self#loadInput txt));
393       mathView#set_href_callback (Some (fun uri ->
394         handle_error (fun () -> self#_load (`Uri uri))));
395       self#_load (`About `Blank);
396       toplevel#show ()
397
398     val mutable current_entry = `About `Blank 
399     val mutable current_infos = None
400     val mutable current_mathml = None
401
402     val model = new MatitaGtkMisc.stringListModel win#whelpResultTreeview
403
404     method private _getWhelpResultTreeviewSelection () =
405       match model#easy_selection () with
406           | [u] -> u
407           | _ -> assert false
408
409     (** history RATIONALE 
410      *
411      * all operations about history are done using _historyFoo
412      *
413      * only toplevel function like load loadInput can call
414      * _historyAdd
415      *)
416           
417     method private _historyAdd item = 
418       history#add item;
419       win#browserBackButton#misc#set_sensitive true;
420       win#browserForwardButton#misc#set_sensitive false
421
422     method private _historyPrev () =
423       let item = history#previous in
424       if history#is_begin then win#browserBackButton#misc#set_sensitive false;
425       win#browserForwardButton#misc#set_sensitive true;
426       item
427     
428     method private _historyNext () =
429       let item = history#next in
430       if history#is_end then win#browserForwardButton#misc#set_sensitive false;
431       win#browserBackButton#misc#set_sensitive true;
432       item
433
434     (** notebook RATIONALE 
435      * 
436      * Use only these functions to switch between the tabs
437      *)
438     method private _showList = win#mathOrListNotebook#goto_page 1
439     method private _showMath = win#mathOrListNotebook#goto_page 0
440     
441
442     
443     method private back () =
444       try
445         self#_load (self#_historyPrev ())
446       with MatitaMisc.History_failure -> ()
447
448     method private forward () =
449       try
450         self#_load (self#_historyNext ())
451       with MatitaMisc.History_failure -> ()
452
453       (* loads a uri which can be a cic uri or an about:* uri
454       * @param uri string *)
455     method private _load entry =
456       try
457           if entry <> current_entry || entry = `About `Current_proof then begin
458             (match entry with
459             | `About `Current_proof -> self#home ()
460             | `About `Blank -> self#blank ()
461             | `About `Us -> () (* TODO implement easter egg here :-] *)
462             | `Check term -> self#_loadCheck term
463             | `Cic (term, metasenv) -> self#_loadTermCic term metasenv
464             | `Dir dir -> self#_loadDir dir
465             | `Uri uri -> self#_loadUriManagerUri (UriManager.uri_of_string uri)
466             | `Whelp (query, results) -> 
467                 set_whelp_query query;
468                 self#_loadList results);
469             self#setEntry entry
470           end
471       with
472       | UriManager.IllFormedUri uri -> fail (sprintf "invalid uri: %s" uri)
473       | CicEnvironment.Object_not_found uri ->
474           fail (sprintf "object not found: %s" (UriManager.string_of_uri uri))
475       | Browser_failure msg -> fail msg
476
477     method private blank () =
478       self#_showMath;
479       mathView#load_root (MatitaMisc.empty_mathml ())#get_documentElement
480
481     method private _loadCheck term =
482       failwith "not implemented _loadCheck";
483       self#_showMath
484
485     method private home () =
486       self#_showMath;
487       match self#script#status.proof_status with
488       | Proof  (uri, metasenv, bo, ty) ->
489           let name = UriManager.name_of_uri (MatitaMisc.unopt uri) in
490           let obj = Cic.CurrentProof (name, metasenv, bo, ty, [], []) in
491           self#_loadObj obj
492       | Incomplete_proof ((uri, metasenv, bo, ty), _) -> 
493           let name = UriManager.name_of_uri (MatitaMisc.unopt uri) in
494           let obj = Cic.CurrentProof (name, metasenv, bo, ty, [], []) in
495           self#_loadObj obj
496       | _ -> self#blank ()
497
498       (** loads a cic uri from the environment
499       * @param uri UriManager.uri *)
500     method private _loadUriManagerUri uri =
501       let uri = UriManager.strip_xpointer uri in
502       let (obj, _) = CicEnvironment.get_obj CicUniv.empty_ugraph uri in
503       self#_loadObj obj
504       
505     method private _loadDir dir = 
506       let content = Http_getter.ls dir in
507       let l = List.map (function 
508         | Http_getter_types.Ls_section sec -> sec            
509         | Http_getter_types.Ls_object obj -> obj.Http_getter_types.uri
510         ) content
511       in
512       self#_loadList l
513
514     method private setEntry entry =
515       win#browserUri#set_text (string_of_entry entry);
516       current_entry <- entry
517
518     method private _loadObj obj =
519       self#_showMath; 
520       (* this must be _before_ loading the document, since 
521        * if the widget is not mapped (hidden by the notebook)
522        * the document is not rendered *)
523       let use_diff = false in (* ZACK TODO use XmlDiff when re-rendering? *)
524       let (mathml, (_,(ids_to_terms, ids_to_father_ids, ids_to_conjectures,
525            ids_to_hypotheses,_,_))) =
526         ApplyTransformation.mml_of_cic_object obj
527       in
528       current_infos <- Some (ids_to_terms, ids_to_father_ids,
529         ids_to_conjectures, ids_to_hypotheses);
530       (match current_mathml with
531       | Some current_mathml when use_diff ->
532           mathView#freeze;
533           XmlDiff.update_dom ~from:current_mathml mathml;
534           mathView#thaw
535       |  _ ->
536           mathView#load_root ~root:mathml#get_documentElement;
537           current_mathml <- Some mathml);
538
539     method private _loadTermCic term metasenv =
540       let context = self#script#proofContext in
541       let dummyno = CicMkImplicit.new_meta metasenv [] in
542       let sequent = (dummyno, context, term) in
543       mathView#load_sequent (sequent :: metasenv) dummyno;
544       self#_showMath
545
546     method private _loadList l =
547       model#list_store#clear ();
548       List.iter model#easy_append l;
549       self#_showList
550     
551     (** { public methods, all must call _load!! } *)
552       
553     method load uri =
554       handle_error (fun () -> self#_load uri);
555       self#_historyAdd uri
556
557     (**  this is what the browser does when you enter a string an hit enter *)
558     method loadInput txt = 
559       let add_terminating_slash s =
560         if not(Pcre.pmatch ~rex:trailing_slash_RE s) && 
561            not(Pcre.pmatch ~rex:has_xpointer_RE s) then s^"/" else s
562       in
563       let is_uri txt = 
564         try 
565           let u = UriManager.strip_xpointer (UriManager.uri_of_string txt) in
566           ignore (Http_getter.resolve' u);
567           true
568         with
569         | Http_getter_types.Key_not_found _ 
570         | Http_getter_types.Unresolvable_URI _
571         | UriManager.IllFormedUri ("cic:/" | "cic:") -> false
572         | UriManager.IllFormedUri u -> failwith ("Malformed URI '" ^ u ^ "'")
573       in
574       let is_whelp txt = Pcre.pmatch ~rex:whelp_RE txt in
575       if is_whelp txt then
576         begin
577           set_whelp_query txt;  
578           
579             
580           (MatitaScript.instance ())#advance ~statement:(txt^".") ()
581         end
582       else
583         begin
584           let entry = 
585             if is_uri txt then
586               (`Uri txt)
587             else
588               (`Dir (add_terminating_slash txt))
589           in
590           self#_load entry;
591           self#_historyAdd entry
592         end
593       
594         
595       (** {2 methods used by constructor only} *)
596
597     method win = win
598     method history = history
599     method currentEntry = current_entry
600     method refresh () =
601       if current_entry = `About `Current_proof then
602       self#_load (`About `Current_proof) 
603   end
604
605   
606 let sequentsViewer ~(notebook:GPack.notebook)
607   ~(sequentViewer:sequentViewer) ()
608 =
609   new sequentsViewer ~notebook ~sequentViewer ()
610
611 let cicBrowser () =
612   let size = BuildTimeConf.browser_history_size in
613   let rec aux history =
614     let browser = new cicBrowser_impl ~history () in
615     let win = browser#win in
616     ignore (win#browserNewButton#connect#clicked (fun () ->
617       let history =
618         new MatitaMisc.browser_history ~memento:history#save size
619           (`About `Blank)
620       in
621       let newBrowser = aux history in
622       newBrowser#load browser#currentEntry));
623 (*
624       (* attempt (failed) to close windows on CTRL-W ... *)
625     MatitaGtkMisc.connect_key win#browserWinEventBox#event ~modifiers:[`CONTROL]
626       GdkKeysyms._W (fun () -> win#toplevel#destroy ());
627 *)
628     cicBrowsers := browser :: !cicBrowsers;
629     (browser :> cicBrowser)
630   in
631   let history = new MatitaMisc.browser_history size (`About `Blank) in
632   aux history
633
634 let refresh_all_browsers () = List.iter (fun b -> b#refresh ()) !cicBrowsers
635
636 let default_sequentViewer () = sequentViewer ~show:true ()
637 let sequentViewer_instance = MatitaMisc.singleton default_sequentViewer
638
639 let default_sequentsViewer () =
640   let gui = MatitaGui.instance () in
641   let sequentViewer = sequentViewer_instance () in
642   sequentsViewer ~notebook:gui#main#sequentsNotebook ~sequentViewer ()
643 let sequentsViewer_instance = MatitaMisc.singleton default_sequentsViewer
644
645 let mathViewer () = 
646   object(self)
647     method private get_browser reuse = 
648       if reuse then
649         (match !cicBrowsers with
650         | [] -> cicBrowser ()
651         | b :: _ -> (b :> cicBrowser))
652       else
653         (cicBrowser ())
654           
655     method show_entry ?(reuse=false) t = (self#get_browser reuse)#load t
656       
657     method show_uri_list ?(reuse=false) ~entry l =
658       (self#get_browser reuse)#load entry
659   end