helm/software/matita/matitaScript.mli

   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 exception NoUnfinishedProof
  27 exception ActionCancelled of string
  28
  29 class type script =
  30 object
  31
  32   method locked_mark : Gtk.text_mark
  33   method locked_tag : GText.tag
  34   method error_tag : GText.tag
  35
  36     (** @return current status *)
  37   method grafite_status: GrafiteTypes.status
  38
  39   (** {2 Observers} *)
  40
  41   method addObserver : (GrafiteTypes.status -> unit) -> unit
  42
  43   (** {2 History} *)
  44
  45   method advance : ?statement:string -> unit -> unit
  46   method retract : unit -> unit
  47   method goto: [`Top | `Bottom | `Cursor] -> unit -> unit
  48   method reset: unit -> unit
  49   method template: unit -> unit
  50
  51   (** {2 Load/save} *)
  52
  53   method has_name: bool
  54   (* alwais return a name, use has_name to check if it is the default one *)
  55   method filename: string
  56   method buri_of_current_file: string
  57   method include_paths: string list
  58   method assignFileName : string option -> unit (* to the current active file *)
  59   method loadFromFile : string -> unit
  60   method loadFromString : string -> unit
  61   method saveToFile : unit -> unit
  62   method filename : string
  63
  64   (** {2 Current proof} (if any) *)
  65
  66   (** @return true if there is an ongoing proof, false otherise *)
  67   method onGoingProof: unit -> bool
  68
  69   method proofMetasenv: Cic.metasenv          (** @raise Statement_error *)
  70   method proofContext: Cic.context            (** @raise Statement_error *)
  71   method proofConclusion: Cic.term            (** @raise Statement_error *)
  72   method stack: Continuationals.Stack.t       (** @raise Statement_error *)
  73
  74   method setGoal: int option -> unit
  75   method goal: int option
  76
  77   (** end of script, true if the whole script has been executed *)
  78   method eos: bool
  79   method bos: bool
  80
  81   (** misc *)
  82   method clean_dirty_lock: unit
  83
  84   (* debug *)
  85   method dump : unit -> unit
  86   method expandAllVirtuals : unit
  87
  88 end
  89
  90   (** @param set_star callback used to set the modified symbol (usually a star
  91    * "*") on the side of a script name *)
  92 val script:
  93   source_view:GSourceView2.source_view ->
  94   mathviewer: MatitaTypes.mathViewer->
  95   urichooser: (UriManager.uri list -> UriManager.uri list) ->
  96   ask_confirmation:
  97     (title:string -> message:string -> [`YES | `NO | `CANCEL]) ->
  98   set_star: (bool -> unit) ->
  99   unit ->
 100     script
 101
 102 (* each time script above is called an internal ref is set, instance will return
 103  * the value of this ref *)
 104 (* TODO Zack: orrible solution until we found a better one for having a single
 105  * access point for the script *)
 106 val current: unit -> script
 107