matita/components/ng_library/nCicLibrary.ml

   1 (*
   2     ||M||  This file is part of HELM, an Hypertextual, Electronic
   3     ||A||  Library of Mathematics, developed at the Computer Science
   4     ||T||  Department, University of Bologna, Italy.
   5     ||I||
   6     ||T||  HELM is free software; you can redistribute it and/or
   7     ||A||  modify it under the terms of the GNU General Public License
   8     \   /  version 2 or (at your option) any later version.
   9      \ /   This software is distributed as is, NO WARRANTY.
  10       V_______________________________________________________________ *)
  11
  12 (* $Id$ *)
  13
  14 exception LibraryOutOfSync of string Lazy.t
  15 exception IncludedFileNotCompiled of string * string
  16
  17 let magic = 2;;
  18
  19 let refresh_uri uri = NUri.uri_of_string (NUri.string_of_uri uri);;
  20
  21 let refresh_uri_in_universe =
  22  List.map (fun (x,u) -> x, refresh_uri u)
  23 ;;
  24
  25 let refresh_uri_in_reference (NReference.Ref (uri,spec)) =
  26  NReference.reference_of_spec (refresh_uri uri) spec
  27
  28 let refresh_uri_in_term status =
  29  let rec aux =
  30   function
  31   | NCic.Meta (i,(n,NCic.Ctx l)) ->
  32      NCic.Meta (i,(n,NCic.Ctx (List.map aux l)))
  33   | NCic.Meta _ as t -> t
  34   | NCic.Const ref -> NCic.Const (refresh_uri_in_reference ref)
  35   | NCic.Sort (NCic.Type l) -> NCic.Sort (NCic.Type (refresh_uri_in_universe l))
  36   | NCic.Match (NReference.Ref (uri,spec),outtype,term,pl) ->
  37      let r = NReference.reference_of_spec (refresh_uri uri) spec in
  38      let outtype = aux outtype in
  39      let term = aux term in
  40      let pl = List.map aux pl in
  41       NCic.Match (r,outtype,term,pl)
  42   | t -> NCicUtils.map status (fun _ _ -> ()) () (fun _ -> aux) t
  43 in
  44  aux
  45 ;;
  46
  47 let refresh_uri_in_obj status (uri,height,metasenv,subst,obj_kind) =
  48  assert (metasenv = []);
  49  assert (subst = []);
  50  refresh_uri uri,height,metasenv,subst,
  51   NCicUntrusted.map_obj_kind (refresh_uri_in_term status) obj_kind
  52 ;;
  53
  54 let ng_path_of_baseuri ?(no_suffix=false) baseuri =
  55  let uri = NUri.string_of_uri baseuri in
  56  let path = String.sub uri 4 (String.length uri - 4) in
  57  let path = Helm_registry.get "matita.basedir" ^ path in
  58  let dirname = Filename.dirname path in
  59   HExtlib.mkdir dirname;
  60   if no_suffix then
  61    path
  62   else
  63    path ^ ".ng"
  64 ;;
  65
  66 let require_path path =
  67  let ch = open_in path in
  68  let mmagic,dump = Marshal.from_channel ch in
  69   close_in ch;
  70   if mmagic <> magic then
  71    raise (LibraryOutOfSync (lazy "The library is out of sync with the implementation. Please recompile the library."))
  72   else
  73    dump
  74 ;;
  75
  76 let require0 ~baseuri = require_path (ng_path_of_baseuri baseuri)
  77
  78 let db_path () = Helm_registry.get "matita.basedir" ^ "/ng_db.ng";;
  79
  80 type timestamp =
  81  [ `Obj of NUri.uri * NCic.obj
  82  | `Constr of NCic.universe * NCic.universe] list *
  83  (NUri.uri * string * NReference.reference) list
  84 ;;
  85
  86 let time0 = [],[];;
  87 let storage = ref [];;
  88 let local_aliases = ref [];;
  89
  90 let load_db,set_global_aliases,get_global_aliases,add_deps,get_deps,remove_deps=
  91  let global_aliases = ref [] in
  92  let rev_includes_map = ref NUri.UriMap.empty in
  93  let store_db () =
  94   let ch = open_out (db_path ()) in
  95   Marshal.to_channel ch (magic,(!global_aliases,!rev_includes_map)) [];
  96   close_out ch in
  97  let load_db () =
  98   HExtlib.mkdir (Helm_registry.get "matita.basedir");
  99   try
 100    let ga,im = require_path (db_path ()) in
 101    let ga =
 102     List.map
 103      (fun (uri,name,NReference.Ref (uri2,spec)) ->
 104        refresh_uri uri,name,NReference.reference_of_spec (refresh_uri uri2) spec
 105      ) ga in
 106    let im =
 107     NUri.UriMap.fold
 108      (fun u l im -> NUri.UriMap.add (refresh_uri u) (List.map refresh_uri l) im
 109      ) im NUri.UriMap.empty
 110    in
 111     global_aliases := ga;
 112     rev_includes_map := im
 113   with
 114    Sys_error _ -> () in
 115  let get_deps u =
 116   let get_deps_one_step u =
 117     try NUri.UriMap.find u !rev_includes_map with Not_found -> [] in
 118   let rec aux res =
 119    function
 120       [] -> res
 121     | he::tl ->
 122        if List.mem he res then
 123         aux res tl
 124        else
 125         aux (he::res) (get_deps_one_step he @ tl)
 126   in
 127    aux [] [u] in
 128  let remove_deps u =
 129   rev_includes_map := NUri.UriMap.remove u !rev_includes_map;
 130   rev_includes_map :=
 131    NUri.UriMap.map
 132     (fun l -> List.filter (fun uri -> not (NUri.eq u uri)) l) !rev_includes_map;
 133   store_db ()
 134  in
 135   load_db,
 136   (fun ga -> global_aliases := ga; store_db ()),
 137   (fun () -> !global_aliases),
 138   (fun u l ->
 139     rev_includes_map := NUri.UriMap.add u (l @ get_deps u) !rev_includes_map;
 140     store_db ()),
 141   get_deps,
 142   remove_deps
 143 ;;
 144
 145 let init = load_db;;
 146
 147 class virtual status =
 148  object
 149   inherit NCic.status
 150   val timestamp = (time0 : timestamp)
 151   method timestamp = timestamp
 152   method set_timestamp v = {< timestamp = v >}
 153  end
 154
 155 let time_travel0 (sto,ali) =
 156  let diff_len = List.length !storage - List.length sto in
 157  let to_be_deleted,_ = HExtlib.split_nth diff_len !storage in
 158   if List.length to_be_deleted > 0 then
 159    List.iter NCicEnvironment.invalidate_item to_be_deleted;
 160   storage := sto; local_aliases := ali
 161 ;;
 162
 163 let time_travel status = time_travel0 status#timestamp;;
 164
 165 let replace status =
 166  let sto,ali = status#timestamp in
 167   storage := sto; local_aliases := ali
 168 ;;
 169
 170 type obj = string * Obj.t
 171 (* includes are transitively closed; dependencies are only immediate *)
 172 type dump =
 173  { objs: obj list ; includes: NUri.uri list; dependencies: string list }
 174
 175 class type g_dumpable_status =
 176  object
 177   method dump: dump
 178  end
 179
 180 class dumpable_status =
 181  object
 182   val db = { objs = []; includes = []; dependencies = [] }
 183   method dump = db
 184   method set_dump v = {< db = v >}
 185   method set_dumpable_status
 186    : 'status. #g_dumpable_status as 'status -> 'self
 187    = fun o -> {< db = o#dump >}
 188  end
 189
 190 let get_transitively_included status =
 191  status#dump.includes
 192 ;;
 193
 194 let dump_obj status obj =
 195  status#set_dump {status#dump with objs = obj::status#dump.objs }
 196 ;;
 197
 198 let remove_objects ~baseuri =
 199    let uri = NUri.string_of_uri baseuri in
 200    let path = String.sub uri 4 (String.length uri - 4) in
 201    let path = Helm_registry.get "matita.basedir" ^ path in
 202    let map name = Sys.remove (Filename.concat path name) in
 203    if HExtlib.is_dir path && HExtlib.is_regular (path ^ ".ng") then begin
 204       HLog.warn ("removing contents of baseuri: " ^ uri);
 205       Array.iter map (Sys.readdir path)
 206    end
 207
 208 module type SerializerType =
 209  sig
 210   type dumpable_status
 211
 212   type 'a register_type =
 213    'a ->
 214     refresh_uri_in_universe:(NCic.universe -> NCic.universe) ->
 215     refresh_uri_in_term:(NCic.status -> NCic.term -> NCic.term) ->
 216     refresh_uri_in_reference:(NReference.reference -> NReference.reference) ->
 217     alias_only:bool ->
 218      dumpable_status -> dumpable_status
 219
 220   val register: < run: 'a.  string -> 'a register_type -> ('a -> obj) >
 221   val serialize: baseuri:NUri.uri -> dumpable_status -> unit
 222   val require:
 223    baseuri:NUri.uri -> fname:string -> alias_only:bool ->
 224     dumpable_status -> dumpable_status
 225   val dependencies_of: baseuri:NUri.uri -> string list
 226  end
 227
 228 module Serializer(D: sig type dumpable_s = private #dumpable_status end) =
 229  struct
 230   type dumpable_status = D.dumpable_s
 231   type 'a register_type =
 232    'a ->
 233     refresh_uri_in_universe:(NCic.universe -> NCic.universe) ->
 234     refresh_uri_in_term:(NCic.status -> NCic.term -> NCic.term) ->
 235     refresh_uri_in_reference:(NReference.reference -> NReference.reference) ->
 236     alias_only:bool ->
 237      dumpable_status -> dumpable_status
 238
 239   let require1 = ref (fun ~alias_only:_ _ -> assert false) (* unknown data*)
 240   let already_registered = ref []
 241
 242   let register =
 243    object
 244     method run : 'a.  string -> 'a register_type -> ('a -> obj)
 245     = fun tag require ->
 246      assert (not (List.mem tag !already_registered));
 247      already_registered := tag :: !already_registered;
 248      let old_require1 = !require1 in
 249      require1 :=
 250       (fun ~alias_only ((tag',data) as x) ->
 251         if tag=tag' then
 252          require (Obj.magic data) ~refresh_uri_in_universe ~refresh_uri_in_term
 253           ~refresh_uri_in_reference ~alias_only
 254         else
 255          old_require1 ~alias_only x);
 256      (fun x -> tag,Obj.repr x)
 257    end
 258
 259   let serialize ~baseuri status =
 260    let ch = open_out (ng_path_of_baseuri baseuri) in
 261    Marshal.to_channel ch (magic,(status#dump.dependencies,status#dump.objs)) [];
 262    close_out ch;
 263    remove_objects ~baseuri; (* FG: we remove the old objects before putting the new ones*)
 264    List.iter
 265     (function
 266      | `Obj (uri,obj) ->
 267          let ch = open_out (ng_path_of_baseuri uri) in
 268          Marshal.to_channel ch (magic,obj) [];
 269          close_out ch
 270      | `Constr _ -> ()
 271     ) !storage;
 272    set_global_aliases (!local_aliases @ get_global_aliases ());
 273    List.iter (fun u -> add_deps u [baseuri]) status#dump.includes;
 274    time_travel0 time0
 275
 276   let require2 ~baseuri ~alias_only status =
 277    try
 278     let status =
 279      status#set_dump
 280       {status#dump with
 281         includes = baseuri::List.filter ((<>) baseuri) status#dump.includes} in
 282     let _dependencies,dump = require0 ~baseuri in
 283      List.fold_right (!require1 ~alias_only) dump status
 284    with
 285     Sys_error _ ->
 286      raise (IncludedFileNotCompiled(ng_path_of_baseuri baseuri,NUri.string_of_uri baseuri))
 287
 288   let dependencies_of ~baseuri = fst (require0 ~baseuri)
 289
 290   let record_include =
 291    let aux (baseuri,fname) ~refresh_uri_in_universe:_ ~refresh_uri_in_term:_
 292    ~refresh_uri_in_reference:_ ~alias_only status =
 293      let baseuri = refresh_uri baseuri in
 294      if not alias_only && List.mem baseuri (get_transitively_included status) then status
 295      else
 296       (HLog.warn ("include " ^ (if alias_only then "alias " else "") ^ fname);
 297       let status = require2 ~baseuri ~alias_only status in
 298       HLog.warn ("done: include " ^ (if alias_only then "alias " else "") ^ fname);
 299       status)
 300    in
 301     register#run "include" aux
 302
 303   let require ~baseuri ~fname ~alias_only status =
 304    if not alias_only && List.mem baseuri (get_transitively_included status) then status
 305    else
 306     (let status =
 307      if not alias_only then
 308       status#set_dump
 309        {status#dump with dependencies = fname::status#dump.dependencies}
 310      else
 311       status in
 312     let status = require2 ~baseuri ~alias_only status in
 313       status#set_dump
 314        {status#dump with
 315          objs = record_include (baseuri,fname)::status#dump.objs })
 316 end
 317
 318 let fetch_obj status uri =
 319  let obj = require0 ~baseuri:uri in
 320   refresh_uri_in_obj status obj
 321 ;;
 322
 323 let resolve name =
 324  try
 325   HExtlib.filter_map
 326    (fun (_,name',nref) -> if name'=name then Some nref else None)
 327    (!local_aliases @ get_global_aliases ())
 328  with
 329   Not_found -> raise (NCicEnvironment.ObjectNotFound (lazy name))
 330 ;;
 331
 332 let aliases_of uri =
 333   HExtlib.filter_map
 334    (fun (uri',_,nref) ->
 335      if NUri.eq uri' uri then Some nref else None) !local_aliases
 336 ;;
 337
 338 let add_obj status ((u,_,_,_,_) as orig_obj) =
 339  NCicEnvironment.check_and_add_obj status orig_obj;
 340  storage := (`Obj (u,orig_obj))::!storage;
 341   let _,height,_,_,obj = orig_obj in
 342   let references =
 343    match obj with
 344       NCic.Constant (_,name,None,_,_) ->
 345        [u,name,NReference.reference_of_spec u NReference.Decl]
 346     | NCic.Constant (_,name,Some _,_,_) ->
 347        [u,name,NReference.reference_of_spec u (NReference.Def height)]
 348     | NCic.Fixpoint (is_ind,fl,_) ->
 349        HExtlib.list_mapi
 350         (fun (_,name,recno,_,_) i ->
 351           if is_ind then
 352            u,name,NReference.reference_of_spec u(NReference.Fix(i,recno,height))
 353           else
 354            u,name,NReference.reference_of_spec u (NReference.CoFix i)) fl
 355     | NCic.Inductive (inductive,leftno,il,_) ->
 356        List.flatten
 357         (HExtlib.list_mapi
 358          (fun (_,iname,_,cl) i ->
 359            HExtlib.list_mapi
 360             (fun (_,cname,_) j->
 361               u,cname,
 362                NReference.reference_of_spec u (NReference.Con (i,j+1,leftno))
 363             ) cl @
 364            [u,iname,
 365              NReference.reference_of_spec u
 366               (NReference.Ind (inductive,i,leftno))]
 367          ) il)
 368   in
 369   local_aliases := references @ !local_aliases;
 370   status#set_timestamp (!storage,!local_aliases)
 371 ;;
 372
 373 let add_constraint status u1 u2 =
 374   if
 375    List.exists
 376     (function `Constr (u1',u2') when u1=u1' && u2=u2' -> true | _ -> false)
 377     !storage
 378   then
 379    (*CSC: raise an exception here! *)
 380    (prerr_endline "CANNOT ADD A CONSTRAINT TWICE"; assert false);
 381   NCicEnvironment.add_lt_constraint u1 u2;
 382   storage := (`Constr (u1,u2)) :: !storage;
 383   status#set_timestamp (!storage,!local_aliases)
 384 ;;
 385
 386 let get_obj status u =
 387  try
 388   List.assq u
 389    (HExtlib.filter_map
 390     (function `Obj (u,o) -> Some (u,o) | _ -> None )
 391     !storage)
 392  with Not_found ->
 393   try fetch_obj status u
 394   with Sys_error _ ->
 395    raise (NCicEnvironment.ObjectNotFound (lazy (NUri.string_of_uri u)))
 396 ;;
 397
 398 NCicEnvironment.set_get_obj get_obj