package merlin-lib
sectionYPositions = computeSectionYPositions($el), 10)"
x-init="setTimeout(() => sectionYPositions = computeSectionYPositions($el), 10)"
>
Merlin's libraries
Install
dune-project
Dependency
Authors
Maintainers
Sources
merlin-5.6.1-504.tbz
sha256=cc3c7c01f19a454c96f6bc8a39538023e01042519f001a895fd61488e2b49fb5
sha512=4268a932a8494023699abd98e0d52deb6f201f656863849db230dc8692050e0fe00cc25a50d70e902410f17a27268fd8335c32636f616ef012cf86fc9a43e019
doc/src/merlin-lib.kernel/mtyper.ml.html
Source file mtyper.ml
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 192 193 194 195 196 197 198 199 200 201 202 203 204 205 206 207 208 209 210 211 212 213 214 215 216 217 218 219 220 221 222 223 224 225 226 227 228 229 230 231 232 233 234 235 236 237 238 239 240 241 242 243 244 245 246 247 248 249 250 251 252 253 254 255 256 257 258 259 260 261 262 263 264 265 266 267 268 269 270 271 272 273 274 275 276 277 278 279 280 281 282 283 284 285 286 287 288 289 290 291 292 293 294 295 296 297 298 299 300 301 302 303 304 305 306 307 308 309 310 311 312 313 314 315 316 317 318 319 320open Std open Local_store let { Logger.log } = Logger.for_section "Mtyper" type index = Longident.t Location.loc list Shape.Uid.Map.t (* Forward ref to be filled by analysis.Occurrences *) let index_items : (index -> Mconfig.t -> [ `Impl of Typedtree.structure_item list | `Intf of Typedtree.signature_item list ] -> index) ref = ref (fun acc _config _item -> acc) let set_index_items f = index_items := f type ('p, 't) item = { parsetree_item : 'p; typedtree_items : 't list * Types.signature_item list; part_snapshot : Types.snapshot; part_stamp : int; part_uid : int; part_env : Env.t; part_errors : exn list; part_checks : Typecore.delayed_check list; part_warnings : Warnings.state; part_index : index lazy_t } type typedtree = [ `Interface of Typedtree.signature | `Implementation of Typedtree.structure ] type typedtree_items = [ `Interface of (Parsetree.signature_item, Typedtree.signature_item) item list | `Implementation of (Parsetree.structure_item, Typedtree.structure_item) item list ] type typer_cache_stats = Miss | Hit of { reused : int; typed : int } type 'a cache_result = { env : Env.t; snapshot : Types.snapshot; ident_stamp : int; uid_stamp : int; value : 'a } let cache : typedtree_items option cache_result option ref = s_ref None let fresh_env config = let env0 = Typer_raw.fresh_env () in let env0 = Extension.register Mconfig.(config.merlin.extensions) env0 in let snap0 = Btype.snapshot () in let stamp0 = Ident.get_currentstamp () in let uid0 = Shape.Uid.get_current_stamp () in (env0, snap0, stamp0, uid0) let get_cache config = match !cache with | Some ({ snapshot; _ } as c) when Types.is_valid snapshot -> c | Some _ | None -> let env, snapshot, ident_stamp, uid_stamp = fresh_env config in { env; snapshot; ident_stamp; uid_stamp; value = None } let return_and_cache status = cache := Some { status with value = Some status.value }; status type result = { config : Mconfig.t; initial_env : Env.t; initial_snapshot : Types.snapshot; initial_stamp : int; stamp : int; initial_uid_stamp : int; typedtree : typedtree_items; cache_stat : typer_cache_stats } let initial_env res = res.initial_env let get_cache_stat res = res.cache_stat let compatible_prefix result_items tree_items = let rec aux acc = function | ritem :: ritems, pitem :: pitems when Types.is_valid ritem.part_snapshot && compare ritem.parsetree_item pitem = 0 -> aux (ritem :: acc) (ritems, pitems) | _, pitems -> let reused = List.length acc in let typed = List.length pitems in let cache_stat = Hit { reused; typed } in log ~title:"compatible_prefix" "reusing %d items, %d new items to type" reused typed; (acc, pitems, cache_stat) in aux [] (result_items, tree_items) let rec type_structure config caught env index = function | parsetree_item :: rest -> let items, _, part_env = Typemod.merlin_type_structure env [ parsetree_item ] in let part_index = lazy (!index_items (Lazy.force index) config (`Impl items.str_items)) in let typedtree_items = (items.Typedtree.str_items, items.Typedtree.str_type) in let item = { parsetree_item; typedtree_items; part_env; part_snapshot = Btype.snapshot (); part_stamp = Ident.get_currentstamp (); part_uid = Shape.Uid.get_current_stamp (); part_errors = !caught; part_checks = !Typecore.delayed_checks; part_warnings = Warnings.backup (); part_index } in item :: type_structure config caught part_env part_index rest | [] -> [] let rec type_signature config caught env index = function | parsetree_item :: rest -> let { Typedtree.sig_final_env = part_env; sig_items; sig_type } = Typemod.merlin_transl_signature env [ parsetree_item ] in let part_index = lazy (!index_items (Lazy.force index) config (`Intf sig_items)) in let item = { parsetree_item; typedtree_items = (sig_items, sig_type); part_env; part_snapshot = Btype.snapshot (); part_stamp = Ident.get_currentstamp (); part_uid = Shape.Uid.get_current_stamp (); part_errors = !caught; part_checks = !Typecore.delayed_checks; part_warnings = Warnings.backup (); part_index } in item :: type_signature config caught part_env part_index rest | [] -> [] let type_implementation config caught parsetree = let { env; snapshot; ident_stamp; uid_stamp; value = prefix; _ } = get_cache config in let prefix, parsetree, cache_stats = match prefix with | Some (`Implementation items) -> compatible_prefix items parsetree | Some (`Interface _) | None -> ([], parsetree, Miss) in let env', snap', stamp', uid_stamp', warn', index' = match prefix with | [] -> ( env, snapshot, ident_stamp, uid_stamp, Warnings.backup (), lazy Shape.Uid.Map.empty ) | x :: _ -> caught := x.part_errors; Typecore.delayed_checks := x.part_checks; ( x.part_env, x.part_snapshot, x.part_stamp, x.part_uid, x.part_warnings, x.part_index ) in Btype.backtrack snap'; Warnings.restore warn'; Env.cleanup_functor_caches ~stamp:stamp'; Env.cleanup_usage_tables ~stamp:uid_stamp'; Shape.Uid.restore_stamp uid_stamp'; let suffix = type_structure config caught env' index' parsetree in let value = `Implementation (List.rev_append prefix suffix) in ( return_and_cache { env; snapshot; ident_stamp; uid_stamp; value }, cache_stats ) let type_interface config caught parsetree = let { env; snapshot; ident_stamp; uid_stamp; value = prefix; _ } = get_cache config in let prefix, parsetree, cache_stats = match prefix with | Some (`Interface items) -> compatible_prefix items parsetree | Some (`Implementation _) | None -> ([], parsetree, Miss) in let env', snap', stamp', uid_stamp', warn', index' = match prefix with | [] -> ( env, snapshot, ident_stamp, uid_stamp, Warnings.backup (), lazy Shape.Uid.Map.empty ) | x :: _ -> caught := x.part_errors; Typecore.delayed_checks := x.part_checks; ( x.part_env, x.part_snapshot, x.part_stamp, x.part_uid, x.part_warnings, x.part_index ) in Btype.backtrack snap'; Warnings.restore warn'; Env.cleanup_functor_caches ~stamp:stamp'; Env.cleanup_usage_tables ~stamp:uid_stamp'; Shape.Uid.restore_stamp uid_stamp'; let suffix = type_signature config caught env' index' parsetree in let value = `Interface (List.rev_append prefix suffix) in ( return_and_cache { env; snapshot; ident_stamp; uid_stamp; value }, cache_stats ) let run config parsetree = if not (Env.check_state_consistency ()) then ( (* Resetting the local store will clear the load_path cache. Save it now, reset the store and then restore the path. *) let { Load_path.visible; } = Load_path.get_paths () in Mocaml.flush_caches (); Local_store.reset (); Load_path.reset (); Load_path.(init ~auto_include:no_auto_include ~visible ~hidden)); let caught = ref [] in Msupport.catch_errors Mconfig.(config.ocaml.warnings) caught @@ fun () -> Typecore.reset_delayed_checks (); let cached_result, cache_stat = match parsetree with | `Implementation parsetree -> type_implementation config caught parsetree | `Interface parsetree -> type_interface config caught parsetree in let stamp = Ident.get_currentstamp () in Typecore.reset_delayed_checks (); { config; initial_env = cached_result.env; initial_snapshot = cached_result.snapshot; initial_stamp = cached_result.ident_stamp; stamp; initial_uid_stamp = cached_result.uid_stamp; typedtree = cached_result.value; cache_stat } let get_env ?pos:_ t = Option.value ~default:t.initial_env (match t.typedtree with | `Implementation l -> Option.map ~f:(fun x -> x.part_env) (List.last l) | `Interface l -> Option.map ~f:(fun x -> x.part_env) (List.last l)) let get_errors t = let errors, checks = Option.value ~default:([], []) (let f x = (x.part_errors, x.part_checks) in match t.typedtree with | `Implementation l -> Option.map ~f (List.last l) | `Interface l -> Option.map ~f (List.last l)) in let caught = ref errors in Typecore.delayed_checks := checks; Msupport.catch_errors Mconfig.(t.config.ocaml.warnings) caught Typecore.force_delayed_checks; Typecore.reset_delayed_checks (); !caught let get_typedtree t = let split_items l = let typd, typs = List.split (List.map ~f:(fun x -> x.typedtree_items) l) in (List.concat typd, List.concat typs) in match t.typedtree with | `Implementation l -> let str_items, str_type = split_items l in `Implementation { Typedtree.str_items; str_type; str_final_env = get_env t } | `Interface l -> let sig_items, sig_type = split_items l in `Interface { Typedtree.sig_items; sig_type; sig_final_env = get_env t } let get_index t = let of_items items = List.last items |> Option.value_map ~default:Shape.Uid.Map.empty ~f:(fun { part_index; _ } -> Lazy.force part_index) in match t.typedtree with | `Implementation items -> of_items items | `Interface items -> of_items items let get_stamp t = t.stamp let node_at ?(skip_recovered = false) t pos_cursor = let node = Mbrowse.of_typedtree (get_typedtree t) in log ~title:"node_at" "Node: %s" (Mbrowse.print () node); let rec select = function (* If recovery happens, the incorrect node is kept and a recovery node is introduced, so the node to check for recovery is the second one. *) | (_, _) :: ((_, node') :: _ as ancestors) when Mbrowse.is_recovered node' -> select ancestors | l -> l in match Mbrowse.deepest_before pos_cursor [ node ] with | [] -> [ (get_env t, Browse_raw.Dummy) ] | path when skip_recovered -> select path | path -> log ~title:"node_at" "Deepest before %s" (Mbrowse.print () path); path
sectionYPositions = computeSectionYPositions($el), 10)"
x-init="setTimeout(() => sectionYPositions = computeSectionYPositions($el), 10)"
>