ident.ml 6.14 KB
Newer Older
1 2 3
(**************************************************************************)
(*                                                                        *)
(*  Copyright (C) 2010-                                                   *)
MARCHE Claude's avatar
MARCHE Claude committed
4 5 6
(*    François Bobot                                                     *)
(*    Jean-Christophe Filliâtre                                          *)
(*    Claude Marché                                                      *)
7 8 9 10 11 12 13 14 15 16 17 18 19
(*    Andrei Paskevich                                                    *)
(*                                                                        *)
(*  This software is free software; you can redistribute it and/or        *)
(*  modify it under the terms of the GNU Library General Public           *)
(*  License version 2.1, with the special exception on linking            *)
(*  described in file LICENSE.                                            *)
(*                                                                        *)
(*  This software is distributed in the hope that it will be useful,      *)
(*  but WITHOUT ANY WARRANTY; without even the implied warranty of        *)
(*  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.                  *)
(*                                                                        *)
(**************************************************************************)

François Bobot's avatar
François Bobot committed
20
open Stdlib
21 22
open Util

MARCHE Claude's avatar
MARCHE Claude committed
23 24 25 26 27 28
(** Labels *)

type label = string * Loc.position option

let label ?loc s = (s,loc)

29 30 31
(** Identifiers *)

type ident = {
32 33
  id_string : string;       (* non-unique name *)
  id_origin : origin;       (* origin of the ident *)
Andrei Paskevich's avatar
Andrei Paskevich committed
34
  id_label  : label list;   (* identifier labels *)
Andrei Paskevich's avatar
Andrei Paskevich committed
35
  id_tag    : Hashweak.tag; (* unique magical tag *)
36 37 38 39 40 41 42
}

and origin =
  | User of Loc.position
  | Derived of ident
  | Fresh

Andrei Paskevich's avatar
Andrei Paskevich committed
43
module Id = WeakStructMake (struct
44
  type t = ident
45 46 47 48 49 50
  let tag id = id.id_tag
end)

module Sid = Id.S
module Mid = Id.M
module Hid = Id.H
51

52 53
type preid = ident

54
let id_equal : ident -> ident -> bool = (==)
55

Andrei Paskevich's avatar
Andrei Paskevich committed
56
let id_hash id = Hashweak.tag_hash id.id_tag
57

Andrei Paskevich's avatar
Andrei Paskevich committed
58
(* constructors *)
59

Andrei Paskevich's avatar
Andrei Paskevich committed
60 61
let id_register = let r = ref 0 in fun id ->
  { id with id_tag = (incr r; Hashweak.create_tag !r) }
62

Andrei Paskevich's avatar
Andrei Paskevich committed
63
let create_ident name origin labels = {
64
  id_string = name;
65
  id_origin = origin;
Andrei Paskevich's avatar
Andrei Paskevich committed
66
  id_label  = labels;
Andrei Paskevich's avatar
Andrei Paskevich committed
67
  id_tag    = Hashweak.dummy_tag;
68 69
}

Andrei Paskevich's avatar
Andrei Paskevich committed
70
let id_fresh ?(labels = []) nm = create_ident nm Fresh labels
71
let id_user ?(labels = []) nm loc =
72 73 74 75 76 77 78 79 80 81
  let new_loc = ref loc in
  let new_labels = List.fold_left
    (fun acc ((s,l) as lab) ->
       match l with
	 | None -> lab :: acc
	 | Some loc -> 
	     new_loc := loc; 
	     match s with
	       | "" -> acc
	       | _ -> lab :: acc)
82 83
    [] labels
  in
84
  create_ident nm (User !new_loc) new_labels
85

Andrei Paskevich's avatar
Andrei Paskevich committed
86 87 88 89 90 91 92
let id_derive ?(labels = []) nm id = create_ident nm (Derived id) labels

let id_clone ?(labels = []) id =
  create_ident id.id_string (Derived id) (labels @ id.id_label)

let id_dup ?(labels = []) id =
  create_ident id.id_string id.id_origin (labels @ id.id_label)
93

94
let rec id_derived_from i1 i2 = id_equal i1 i2 ||
95 96 97
  (match i1.id_origin with
    | Derived i3 -> id_derived_from i3 i2
    | _ -> false)
98

99
let rec id_from_user i =
Francois Bobot's avatar
Francois Bobot committed
100 101 102 103 104
  match i.id_origin with
    | Derived i -> id_from_user i
    | User l -> Some l
    | Fresh -> None

105 106
(** Unique names for pretty printing *)

107 108
type ident_printer = {
  indices   : (string, int) Hashtbl.t;
Andrei Paskevich's avatar
Andrei Paskevich committed
109
  values    : string Hid.t;
110 111 112
  sanitizer : string -> string;
  blacklist : string list;
}
113 114 115 116 117 118

let rec find_index indices name ind =
  if Hashtbl.mem indices (name ^ string_of_int ind)
  then find_index indices name (succ ind) else ind

let find_unique indices name =
119
  let name = try
120 121
    let ind = Hashtbl.find indices name + 1 in
    let ind = find_index indices name ind in
122
    Hashtbl.replace indices name ind;
123
    name ^ string_of_int ind
124 125 126
  with Not_found -> name in
  Hashtbl.replace indices name 0;
  name
127

128 129
let reserve indices name = ignore (find_unique indices name)

130 131
let same x = x

132
let create_ident_printer ?(sanitizer = same) sl =
133
  let indices = Hashtbl.create 1997 in
134 135
  List.iter (reserve indices) sl;
  { indices   = indices;
Andrei Paskevich's avatar
Andrei Paskevich committed
136
    values    = Hid.create 1997;
137 138
    sanitizer = sanitizer;
    blacklist = sl }
139

140
let id_unique printer ?(sanitizer = same) id =
141
  try
Andrei Paskevich's avatar
Andrei Paskevich committed
142
    Hid.find printer.values id
143
  with Not_found ->
144
    let name = sanitizer (printer.sanitizer id.id_string) in
145
    let name = find_unique printer.indices name in
Andrei Paskevich's avatar
Andrei Paskevich committed
146
    Hid.replace printer.values id name;
147 148
    name

149
let string_unique printer s = find_unique printer.indices s
150

151
let forget_id printer id =
152
  try
Andrei Paskevich's avatar
Andrei Paskevich committed
153
    let name = Hid.find printer.values id in
154
    Hashtbl.remove printer.indices name;
Andrei Paskevich's avatar
Andrei Paskevich committed
155
    Hid.remove printer.values id
156 157
  with Not_found -> ()

158
let forget_all printer =
Andrei Paskevich's avatar
Andrei Paskevich committed
159
  Hid.clear printer.values;
160 161
  Hashtbl.clear printer.indices;
  List.iter (reserve printer.indices) printer.blacklist
162

163 164
(** Sanitizers *)

165
let unsanitizable = Debug.register_flag "unsanitizable"
166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182

let char_to_alpha c = match c with
  | 'a'..'z' | 'A'..'Z' -> String.make 1 c
  | ' ' -> "sp" | '_'  -> "us" | '#' -> "sh"
  | '`' -> "bq" | '~'  -> "tl" | '!' -> "ex"
  | '@' -> "at" | '$'  -> "dl" | '%' -> "pc"
  | '^' -> "cf" | '&'  -> "et" | '*' -> "as"
  | '(' -> "lp" | ')'  -> "rp" | '-' -> "mn"
  | '+' -> "pl" | '='  -> "eq" | '[' -> "lb"
  | ']' -> "rb" | '{'  -> "lc" | '}' -> "rc"
  | ':' -> "cl" | '\'' -> "qt" | '"' -> "dq"
  | '<' -> "ls" | '>'  -> "gt" | '/' -> "sl"
  | '?' -> "qu" | '\\' -> "bs" | '|' -> "br"
  | ';' -> "sc" | ','  -> "cm" | '.' -> "dt"
  | '0' -> "zr" | '1'  -> "un" | '2' -> "du"
  | '3' -> "tr" | '4'  -> "qr" | '5' -> "qn"
  | '6' -> "sx" | '7'  -> "st" | '8' -> "oc"
183 184 185 186
  | '9' -> "nn" | '\n' -> "br"
  | _ ->
    Debug.dprintf unsanitizable "Unsanitizable : '%c' can't be sanitized@." c;
    "zz"
187 188 189 190 191 192 193 194 195 196 197 198 199 200 201 202 203 204

let char_to_lalpha c = String.uncapitalize (char_to_alpha c)
let char_to_ualpha c = String.capitalize (char_to_alpha c)

let char_to_alnum c =
  match c with '0'..'9' -> String.make 1 c | _ -> char_to_alpha c

let char_to_alnumus c =
  match c with '_' | ' ' -> "_" | _ -> char_to_alnum c

let sanitizer head rest n =
  let lst = ref [] in
  let code c = lst := rest c :: !lst in
  let n = if n = "" then "zilch" else n in
  String.iter code n;
  let rst = List.tl (List.rev !lst) in
  let cs = head (String.get n 0) :: rst in
  String.concat "" cs