aboutsummaryrefslogtreecommitdiffhomepage
path: root/library/loadpath.mli
blob: f755ace9e9e622bf5d3c25180f89024868cb9d23 (plain)
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
(************************************************************************)
(*  v      *   The Coq Proof Assistant  /  The Coq Development Team     *)
(* <O___,, *   INRIA - CNRS - LIX - LRI - PPS - Copyright 1999-2012     *)
(*   \VV/  **************************************************************)
(*    //   *      This file is distributed under the terms of the       *)
(*         *       GNU Lesser General Public License Version 2.1        *)
(************************************************************************)

open Names

(** * Load paths.

  A load path is a physical path in the file system; to each load path is
  associated a Coq [DirPath.t] (the "logical" path of the physical path).

*)

type t
(** Type of loadpath bindings. *)

val physical : t -> CUnix.physical_path
(** Get the physical path (filesystem location) of a loadpath. *)

val logical : t -> DirPath.t
(** Get the logical path (Coq module hierarchy) of a loadpath. *)

val get_load_paths : unit -> t list
(** Get the current loadpath association. *)

val get_paths : unit -> CUnix.physical_path list
(** Same as [get_load_paths] but only get the physical part. *)

val get_accessible_paths : unit -> CUnix.physical_path list
(** Same as [get_paths] but also get paths that can be relatively accessed. *)

val add_load_path : CUnix.physical_path -> bool -> DirPath.t -> unit
(** [add_load_path root phys log] adds the binding [phys := log] to the current
    loadpaths. The [root] flag indicates whether this loadpath has to be treated
    as a root one. *)

val remove_load_path : CUnix.physical_path -> unit
(** Remove the current logical path binding associated to a given physical path,
    if any. *)

val find_load_path : CUnix.physical_path -> t
(** Get the binding associated to a physical path. Raises [Not_found] if there
    is none. *)

val is_in_load_paths : CUnix.physical_path -> bool
(** Whether a physical path is currently bound. *)

val expand_path : DirPath.t -> (CUnix.physical_path * DirPath.t) list
(** Given a relative logical path, associate the list of absolute physical and
    logical paths which are possible expansions of it. *)

val expand_root_path : DirPath.t -> CUnix.physical_path list
(** As [expand_path] but restricts to root loadpaths. *)