src/Tools/code/code_printer.ML
author haftmann
Tue May 12 16:11:36 2009 +0200 (2009-05-12)
changeset 31121 f79a0d03b75f
parent 31056 01ac77eb660b
child 31665 a1f4d3b3f6c8
permissions -rw-r--r--
tuned exception code
haftmann@28060
     1
(*  Title:      Tools/code/code_printer.ML
haftmann@28060
     2
    Author:     Florian Haftmann, TU Muenchen
haftmann@28060
     3
haftmann@28060
     4
Generic operations for pretty printing of target language code.
haftmann@28060
     5
*)
haftmann@28060
     6
haftmann@28060
     7
signature CODE_PRINTER =
haftmann@28060
     8
sig
haftmann@28663
     9
  val nerror: thm -> string -> 'a
haftmann@28060
    10
haftmann@28060
    11
  val @@ : 'a * 'a -> 'a list
haftmann@28060
    12
  val @| : 'a list * 'a -> 'a list
haftmann@28060
    13
  val str: string -> Pretty.T
haftmann@28060
    14
  val concat: Pretty.T list -> Pretty.T
haftmann@28060
    15
  val brackets: Pretty.T list -> Pretty.T
haftmann@28060
    16
  val semicolon: Pretty.T list -> Pretty.T
haftmann@28060
    17
  val enum_default: string -> string -> string -> string -> Pretty.T list -> Pretty.T
haftmann@28060
    18
haftmann@30648
    19
  val first_upper: string -> string
haftmann@30648
    20
  val first_lower: string -> string
haftmann@30648
    21
  type var_ctxt
haftmann@30648
    22
  val make_vars: string list -> var_ctxt
haftmann@30648
    23
  val intro_vars: string list -> var_ctxt -> var_ctxt
haftmann@30648
    24
  val lookup_var: var_ctxt -> string -> string
haftmann@30648
    25
haftmann@31056
    26
  type literals
haftmann@31056
    27
  val Literals: { literal_char: string -> string, literal_string: string -> string,
haftmann@31056
    28
        literal_numeral: bool -> int -> string,
haftmann@31056
    29
        literal_list: Pretty.T list -> Pretty.T, infix_cons: int * string }
haftmann@31056
    30
    -> literals
haftmann@31056
    31
  val literal_char: literals -> string -> string
haftmann@31056
    32
  val literal_string: literals -> string -> string
haftmann@31056
    33
  val literal_numeral: literals -> bool -> int -> string
haftmann@31056
    34
  val literal_list: literals -> Pretty.T list -> Pretty.T
haftmann@31056
    35
  val infix_cons: literals -> int * string
haftmann@31056
    36
haftmann@28060
    37
  type lrx
haftmann@28060
    38
  val L: lrx
haftmann@28060
    39
  val R: lrx
haftmann@28060
    40
  val X: lrx
haftmann@28060
    41
  type fixity
haftmann@28060
    42
  val BR: fixity
haftmann@28060
    43
  val NOBR: fixity
haftmann@28060
    44
  val INFX: int * lrx -> fixity
haftmann@28060
    45
  val APP: fixity
haftmann@28060
    46
  val brackify: fixity -> Pretty.T list -> Pretty.T
haftmann@28060
    47
  val brackify_infix: int * lrx -> fixity -> Pretty.T list -> Pretty.T
haftmann@28060
    48
haftmann@28060
    49
  type itype = Code_Thingol.itype
haftmann@28060
    50
  type iterm = Code_Thingol.iterm
haftmann@28060
    51
  type const = Code_Thingol.const
haftmann@28060
    52
  type dict = Code_Thingol.dict
haftmann@28060
    53
  type tyco_syntax
haftmann@28060
    54
  type const_syntax
haftmann@31056
    55
  type proto_const_syntax
haftmann@28060
    56
  val parse_infix: ('a -> 'b) -> lrx * int -> string
haftmann@28663
    57
    -> int * ((fixity -> 'b -> Pretty.T)
haftmann@28663
    58
    -> fixity -> 'a list -> Pretty.T)
haftmann@28060
    59
  val parse_syntax: ('a -> 'b) -> OuterParse.token list
haftmann@28663
    60
    -> (int * ((fixity -> 'b -> Pretty.T)
haftmann@28663
    61
    -> fixity -> 'a list -> Pretty.T)) option * OuterParse.token list
haftmann@28663
    62
  val simple_const_syntax: (int * ((fixity -> iterm -> Pretty.T)
haftmann@31056
    63
    -> fixity -> (iterm * itype) list -> Pretty.T)) option -> proto_const_syntax option
haftmann@31056
    64
  val activate_const_syntax: theory -> literals
haftmann@31056
    65
    -> proto_const_syntax -> Code_Thingol.naming -> const_syntax * Code_Thingol.naming
haftmann@30648
    66
  val gen_pr_app: (thm -> var_ctxt -> const * iterm list -> Pretty.T list)
haftmann@30648
    67
    -> (thm -> var_ctxt -> fixity -> iterm -> Pretty.T)
haftmann@31056
    68
    -> (string -> const_syntax option)
haftmann@30648
    69
    -> thm -> var_ctxt -> fixity -> const * iterm list -> Pretty.T
haftmann@28060
    70
  val gen_pr_bind: ((string option * Pretty.T option) * itype -> Pretty.T)
haftmann@30648
    71
    -> (thm -> var_ctxt -> fixity -> iterm -> Pretty.T)
haftmann@28663
    72
    -> thm -> fixity
haftmann@30648
    73
    -> (string option * iterm option) * itype -> var_ctxt -> Pretty.T * var_ctxt
haftmann@28060
    74
haftmann@30648
    75
  val mk_name_module: Name.context -> string option -> (string -> string option)
haftmann@30648
    76
    -> 'a Graph.T -> string -> string
haftmann@30648
    77
  val dest_name: string -> string * string
haftmann@28060
    78
end;
haftmann@28060
    79
haftmann@28060
    80
structure Code_Printer : CODE_PRINTER =
haftmann@28060
    81
struct
haftmann@28060
    82
haftmann@28060
    83
open Code_Thingol;
haftmann@28060
    84
haftmann@28060
    85
fun nerror thm s = error (s ^ ",\nin equation " ^ Display.string_of_thm thm);
haftmann@28060
    86
haftmann@28060
    87
(** assembling text pieces **)
haftmann@28060
    88
haftmann@28060
    89
infixr 5 @@;
haftmann@28060
    90
infixr 5 @|;
haftmann@28060
    91
fun x @@ y = [x, y];
haftmann@28060
    92
fun xs @| y = xs @ [y];
haftmann@28060
    93
val str = PrintMode.setmp [] Pretty.str;
haftmann@28060
    94
val concat = Pretty.block o Pretty.breaks;
haftmann@28060
    95
val brackets = Pretty.enclose "(" ")" o Pretty.breaks;
haftmann@28060
    96
fun semicolon ps = Pretty.block [concat ps, str ";"];
haftmann@28060
    97
fun enum_default default sep opn cls [] = str default
haftmann@28060
    98
  | enum_default default sep opn cls xs = Pretty.enum sep opn cls xs;
haftmann@28060
    99
haftmann@28060
   100
haftmann@30648
   101
(** names and variable name contexts **)
haftmann@30648
   102
haftmann@30648
   103
type var_ctxt = string Symtab.table * Name.context;
haftmann@30648
   104
haftmann@30648
   105
fun make_vars names = (fold (fn name => Symtab.update_new (name, name)) names Symtab.empty,
haftmann@30648
   106
  Name.make_context names);
haftmann@30648
   107
haftmann@30648
   108
fun intro_vars names (namemap, namectxt) =
haftmann@30648
   109
  let
haftmann@30648
   110
    val (names', namectxt') = Name.variants names namectxt;
haftmann@30648
   111
    val namemap' = fold2 (curry Symtab.update) names names' namemap;
haftmann@30648
   112
  in (namemap', namectxt') end;
haftmann@30648
   113
haftmann@30648
   114
fun lookup_var (namemap, _) name = case Symtab.lookup namemap name
haftmann@30648
   115
 of SOME name' => name'
haftmann@30648
   116
  | NONE => error ("Invalid name in context: " ^ quote name);
haftmann@30648
   117
haftmann@30648
   118
val first_upper = implode o nth_map 0 Symbol.to_ascii_upper o explode;
haftmann@30648
   119
val first_lower = implode o nth_map 0 Symbol.to_ascii_lower o explode;
haftmann@30648
   120
haftmann@30648
   121
haftmann@31056
   122
(** pretty literals **)
haftmann@31056
   123
haftmann@31056
   124
datatype literals = Literals of {
haftmann@31056
   125
  literal_char: string -> string,
haftmann@31056
   126
  literal_string: string -> string,
haftmann@31056
   127
  literal_numeral: bool -> int -> string,
haftmann@31056
   128
  literal_list: Pretty.T list -> Pretty.T,
haftmann@31056
   129
  infix_cons: int * string
haftmann@31056
   130
};
haftmann@31056
   131
haftmann@31056
   132
fun dest_Literals (Literals lits) = lits;
haftmann@31056
   133
haftmann@31056
   134
val literal_char = #literal_char o dest_Literals;
haftmann@31056
   135
val literal_string = #literal_string o dest_Literals;
haftmann@31056
   136
val literal_numeral = #literal_numeral o dest_Literals;
haftmann@31056
   137
val literal_list = #literal_list o dest_Literals;
haftmann@31056
   138
val infix_cons = #infix_cons o dest_Literals;
haftmann@31056
   139
haftmann@31056
   140
haftmann@28060
   141
(** syntax printer **)
haftmann@28060
   142
haftmann@28060
   143
(* binding priorities *)
haftmann@28060
   144
haftmann@28060
   145
datatype lrx = L | R | X;
haftmann@28060
   146
haftmann@28060
   147
datatype fixity =
haftmann@28060
   148
    BR
haftmann@28060
   149
  | NOBR
haftmann@28060
   150
  | INFX of (int * lrx);
haftmann@28060
   151
haftmann@28060
   152
val APP = INFX (~1, L);
haftmann@28060
   153
haftmann@28060
   154
fun fixity_lrx L L = false
haftmann@28060
   155
  | fixity_lrx R R = false
haftmann@28060
   156
  | fixity_lrx _ _ = true;
haftmann@28060
   157
haftmann@28060
   158
fun fixity NOBR _ = false
haftmann@28060
   159
  | fixity _ NOBR = false
haftmann@28060
   160
  | fixity (INFX (pr, lr)) (INFX (pr_ctxt, lr_ctxt)) =
haftmann@28060
   161
      pr < pr_ctxt
haftmann@28060
   162
      orelse pr = pr_ctxt
haftmann@28060
   163
        andalso fixity_lrx lr lr_ctxt
haftmann@28060
   164
      orelse pr_ctxt = ~1
haftmann@28060
   165
  | fixity BR (INFX _) = false
haftmann@28060
   166
  | fixity _ _ = true;
haftmann@28060
   167
haftmann@28060
   168
fun gen_brackify _ [p] = p
haftmann@28060
   169
  | gen_brackify true (ps as _::_) = Pretty.enclose "(" ")" ps
haftmann@28060
   170
  | gen_brackify false (ps as _::_) = Pretty.block ps;
haftmann@28060
   171
haftmann@28060
   172
fun brackify fxy_ctxt =
haftmann@28060
   173
  gen_brackify (fixity BR fxy_ctxt) o Pretty.breaks;
haftmann@28060
   174
haftmann@28060
   175
fun brackify_infix infx fxy_ctxt =
haftmann@28060
   176
  gen_brackify (fixity (INFX infx) fxy_ctxt) o Pretty.breaks;
haftmann@28060
   177
haftmann@28060
   178
haftmann@28060
   179
(* generic syntax *)
haftmann@28060
   180
haftmann@28060
   181
type tyco_syntax = int * ((fixity -> itype -> Pretty.T)
haftmann@28060
   182
  -> fixity -> itype list -> Pretty.T);
haftmann@30648
   183
type const_syntax = int * ((var_ctxt -> fixity -> iterm -> Pretty.T)
haftmann@31056
   184
  -> thm -> var_ctxt -> fixity -> (iterm * itype) list -> Pretty.T);
haftmann@31056
   185
type proto_const_syntax = int * (string list * (literals -> string list
haftmann@31056
   186
  -> (var_ctxt -> fixity -> iterm -> Pretty.T)
haftmann@31056
   187
    -> thm -> var_ctxt -> fixity -> (iterm * itype) list -> Pretty.T));
haftmann@28060
   188
haftmann@31056
   189
fun simple_const_syntax (SOME (n, f)) = SOME (n,
haftmann@31056
   190
      ([], (fn _ => fn _ => fn pr => fn thm => fn vars => f (pr vars))))
haftmann@31056
   191
  | simple_const_syntax NONE = NONE;
haftmann@28060
   192
haftmann@31056
   193
fun activate_const_syntax thy literals (n, (cs, f)) naming =
haftmann@31056
   194
  fold_map (Code_Thingol.ensure_declared_const thy) cs naming
haftmann@31056
   195
  |-> (fn cs' => pair (n, f literals cs'));
haftmann@31056
   196
haftmann@31056
   197
fun gen_pr_app pr_app pr_term syntax_const thm vars fxy (app as ((c, (_, tys)), ts)) =
haftmann@28060
   198
  case syntax_const c
haftmann@28708
   199
   of NONE => brackify fxy (pr_app thm vars app)
haftmann@28060
   200
    | SOME (k, pr) =>
haftmann@28060
   201
        let
haftmann@31056
   202
          fun pr' fxy ts = pr (pr_term thm) thm vars fxy (ts ~~ curry Library.take k tys);
haftmann@28060
   203
        in if k = length ts
haftmann@28060
   204
          then pr' fxy ts
haftmann@28060
   205
        else if k < length ts
haftmann@28060
   206
          then case chop k ts of (ts1, ts2) =>
haftmann@28708
   207
            brackify fxy (pr' APP ts1 :: map (pr_term thm vars BR) ts2)
haftmann@28708
   208
          else pr_term thm vars fxy (Code_Thingol.eta_expand k app)
haftmann@28060
   209
        end;
haftmann@28060
   210
haftmann@28060
   211
fun gen_pr_bind pr_bind pr_term thm (fxy : fixity) ((v, pat), ty : itype) vars =
haftmann@28060
   212
  let
haftmann@28060
   213
    val vs = case pat
haftmann@28060
   214
     of SOME pat => Code_Thingol.fold_varnames (insert (op =)) pat []
haftmann@28060
   215
      | NONE => [];
haftmann@30648
   216
    val vars' = intro_vars (the_list v) vars;
haftmann@30648
   217
    val vars'' = intro_vars vs vars';
haftmann@30648
   218
    val v' = Option.map (lookup_var vars') v;
haftmann@28708
   219
    val pat' = Option.map (pr_term thm vars'' fxy) pat;
haftmann@28060
   220
  in (pr_bind ((v', pat'), ty), vars'') end;
haftmann@28060
   221
haftmann@28060
   222
haftmann@28060
   223
(* mixfix syntax *)
haftmann@28060
   224
haftmann@28060
   225
datatype 'a mixfix =
haftmann@28060
   226
    Arg of fixity
haftmann@28060
   227
  | Pretty of Pretty.T;
haftmann@28060
   228
haftmann@28060
   229
fun mk_mixfix prep_arg (fixity_this, mfx) =
haftmann@28060
   230
  let
haftmann@28060
   231
    fun is_arg (Arg _) = true
haftmann@28060
   232
      | is_arg _ = false;
haftmann@28060
   233
    val i = (length o filter is_arg) mfx;
haftmann@28060
   234
    fun fillin _ [] [] =
haftmann@28060
   235
          []
haftmann@28060
   236
      | fillin pr (Arg fxy :: mfx) (a :: args) =
haftmann@28060
   237
          (pr fxy o prep_arg) a :: fillin pr mfx args
haftmann@28060
   238
      | fillin pr (Pretty p :: mfx) args =
haftmann@28060
   239
          p :: fillin pr mfx args;
haftmann@28060
   240
  in
haftmann@28060
   241
    (i, fn pr => fn fixity_ctxt => fn args =>
haftmann@28060
   242
      gen_brackify (fixity fixity_this fixity_ctxt) (fillin pr mfx args))
haftmann@28060
   243
  end;
haftmann@28060
   244
haftmann@28060
   245
fun parse_infix prep_arg (x, i) s =
haftmann@28060
   246
  let
haftmann@28060
   247
    val l = case x of L => INFX (i, L) | _ => INFX (i, X);
haftmann@28060
   248
    val r = case x of R => INFX (i, R) | _ => INFX (i, X);
haftmann@28060
   249
  in
haftmann@28060
   250
    mk_mixfix prep_arg (INFX (i, x),
haftmann@28060
   251
      [Arg l, (Pretty o Pretty.brk) 1, (Pretty o str) s, (Pretty o Pretty.brk) 1, Arg r])
haftmann@28060
   252
  end;
haftmann@28060
   253
haftmann@28060
   254
fun parse_mixfix prep_arg s =
haftmann@28060
   255
  let
haftmann@28060
   256
    val sym_any = Scan.one Symbol.is_regular;
haftmann@28060
   257
    val parse = Scan.optional ($$ "!" >> K true) false -- Scan.repeat (
haftmann@28060
   258
         ($$ "(" -- $$ "_" -- $$ ")" >> K (Arg NOBR))
haftmann@28060
   259
      || ($$ "_" >> K (Arg BR))
haftmann@28060
   260
      || ($$ "/" |-- Scan.repeat ($$ " ") >> (Pretty o Pretty.brk o length))
haftmann@28060
   261
      || (Scan.repeat1
haftmann@28060
   262
           (   $$ "'" |-- sym_any
haftmann@28060
   263
            || Scan.unless ($$ "_" || $$ "/" || $$ "(" |-- $$ "_" |-- $$ ")")
haftmann@28060
   264
                 sym_any) >> (Pretty o str o implode)));
haftmann@28060
   265
  in case Scan.finite Symbol.stopper parse (Symbol.explode s)
haftmann@28060
   266
   of ((_, p as [_]), []) => mk_mixfix prep_arg (NOBR, p)
haftmann@28060
   267
    | ((b, p as _ :: _ :: _), []) => mk_mixfix prep_arg (if b then NOBR else BR, p)
haftmann@28060
   268
    | _ => Scan.!!
haftmann@28060
   269
        (the_default ("malformed mixfix annotation: " ^ quote s) o snd) Scan.fail ()
haftmann@28060
   270
  end;
haftmann@28060
   271
haftmann@28060
   272
val (infixK, infixlK, infixrK) = ("infix", "infixl", "infixr");
haftmann@28060
   273
haftmann@28060
   274
fun parse_syntax prep_arg xs =
haftmann@28060
   275
  Scan.option ((
haftmann@28060
   276
      ((OuterParse.$$$ infixK  >> K X)
haftmann@28060
   277
        || (OuterParse.$$$ infixlK >> K L)
haftmann@28060
   278
        || (OuterParse.$$$ infixrK >> K R))
haftmann@28060
   279
        -- OuterParse.nat >> parse_infix prep_arg
haftmann@28060
   280
      || Scan.succeed (parse_mixfix prep_arg))
haftmann@28060
   281
      -- OuterParse.string
haftmann@28060
   282
      >> (fn (parse, s) => parse s)) xs;
haftmann@28060
   283
haftmann@28060
   284
val _ = List.app OuterKeyword.keyword [infixK, infixlK, infixrK];
haftmann@28060
   285
haftmann@28064
   286
haftmann@30648
   287
(** module name spaces **)
haftmann@30648
   288
haftmann@30648
   289
val dest_name =
haftmann@30648
   290
  apfst Long_Name.implode o split_last o fst o split_last o Long_Name.explode;
haftmann@30648
   291
haftmann@30648
   292
fun mk_name_module reserved_names module_prefix module_alias program =
haftmann@30648
   293
  let
haftmann@30648
   294
    fun mk_alias name = case module_alias name
haftmann@30648
   295
     of SOME name' => name'
haftmann@30648
   296
      | NONE => name
haftmann@30648
   297
          |> Long_Name.explode
haftmann@30648
   298
          |> map (fn name => (the_single o fst) (Name.variants [name] reserved_names))
haftmann@30648
   299
          |> Long_Name.implode;
haftmann@30648
   300
    fun mk_prefix name = case module_prefix
haftmann@30648
   301
     of SOME module_prefix => Long_Name.append module_prefix name
haftmann@30648
   302
      | NONE => name;
haftmann@30648
   303
    val tab =
haftmann@30648
   304
      Symtab.empty
haftmann@30648
   305
      |> Graph.fold ((fn name => Symtab.default (name, (mk_alias #> mk_prefix) name))
haftmann@30648
   306
           o fst o dest_name o fst)
haftmann@30648
   307
             program
haftmann@30648
   308
  in the o Symtab.lookup tab end;
haftmann@30648
   309
haftmann@28060
   310
end; (*struct*)