X-Git-Url: http://git.annexia.org/?a=blobdiff_plain;f=src%2Fast.mli;h=e47ddc35fd1b65c5770e74fef64eb38b5c83a6bb;hb=3ed50d510dbab127125a8af9f72554c2dec72ef5;hp=978099e5d24bfe26bc406113485a924a9dda1e28;hpb=24cc20b33e3d81ed7d754391bef929276c1f4f42;p=goals.git diff --git a/src/ast.mli b/src/ast.mli index 978099e..e47ddc3 100644 --- a/src/ast.mli +++ b/src/ast.mli @@ -26,6 +26,9 @@ module Env : sig val fold: (key -> 'a -> 'b -> 'b) -> 'a t -> 'b -> 'b val filter: (key -> 'a -> bool) -> 'a t -> 'a t val bindings: 'a t -> (key * 'a) list + + (* This is not the normal Map.merge function. *) + val merge : 'a t -> 'a t -> 'a t end (** Location where we parsed from $loc = $startpos, $endpos *) @@ -40,16 +43,15 @@ type env = expr Env.t and pattern = (** match tactic such as *file ("filename") *) | PTactic of loc * id * substs list - (** match named variable, which must be a string, ETactic or - a list of those *) - | PVar of loc * id and expr = - (** goal (params) = patterns : exprs = code *) - | EGoal of loc * goal - (** goalname (params) etc. *) - | ECall of loc * id * expr list - (** *tactic (params) etc. *) - | ETactic of loc * id * expr list + (** goal (params) = patterns : exprs code *) + | EGoalDefn of loc * goal + (** tactic (params) = code *) + | ETacticDefn of loc * tactic + (** call goalname (params) etc. *) + | ECallGoal of loc * id * expr list + (** call *tactic (params) etc. *) + | ETacticCtor of loc * id * expr list (** variable, or goal call with no parameters *) | EVar of loc * id (** list *) @@ -61,7 +63,8 @@ and expr = and constant = | CString of string and goal = param_decl list * pattern list * expr list * code option - (** Goal parameter is the parameter name and an optional default value. *) +and tactic = param_decl list * code + (** Goal/tactic parameter. *) and param_decl = id and id = string and code = substs @@ -80,6 +83,10 @@ val getvar : env -> loc -> id -> expr found or if the named variable is not a goal. *) val getgoal : env -> loc -> id -> goal +(** Look up a tactic in the environment. Raise [Failure _] if not + found or if the named variable is not a tactic. *) +val gettactic : env -> loc -> id -> tactic + (** Take any expression and simplify it down to a constant. If the expression cannot be simplified then this raises [Failure _]. *) @@ -90,6 +97,12 @@ val to_constant : env -> expr -> constant raises [Failure _]. *) val substitute : env -> loc -> substs -> string +(** Similar to {!substitute} except this is used where we will + pass the result immediately to the shell to execute. Variables + are substituted with shell quoted strings. Raises [Failure _] + on error. *) +val to_shell_script : env -> loc -> substs -> string + (** This is used for incrementally building Ast.substs in the parser. *) module Substs : sig type t @@ -100,9 +113,8 @@ module Substs : sig val add_var : t -> string -> unit end -(** Print all definitions in an environment. *) -val print_env : out_channel -> env -> unit - (** %a formatters. *) +val print_env : out_channel -> env -> unit val string_pattern : unit -> pattern -> string val string_expr : unit -> expr -> string +val print_expr : out_channel -> expr -> unit