Improve error reporting on init
[ocaml-augeas.git] / augeas.ml
1 (* Augeas OCaml bindings
2  * Copyright (C) 2008 Red Hat Inc., Richard W.M. Jones
3  *
4  * This library is free software; you can redistribute it and/or
5  * modify it under the terms of the GNU Lesser General Public
6  * License as published by the Free Software Foundation; either
7  * version 2 of the License, or (at your option) any later version.
8  *
9  * This library is distributed in the hope that it will be useful,
10  * but WITHOUT ANY WARRANTY; without even the implied warranty of
11  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
12  * Lesser General Public License for more details.
13  *
14  * You should have received a copy of the GNU Lesser General Public
15  * License along with this library; if not, write to the Free Software
16  * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
17  *
18  * $Id: augeas.ml,v 1.2 2008/05/06 10:48:20 rjones Exp $
19  *)
20
21 type t
22
23 type flag =
24   | AugSaveBackup
25   | AugSaveNewFile
26   | AugTypeCheck
27   | AugNoStdinc
28   | AugSaveNoop
29   | AugNoLoad
30   | AugNoModlAutoload
31   | AugEnableSpan
32   | AugNoErrClose
33   | AugTraceModuleLoading
34
35 type error_code =
36   | AugErrInternal
37   | AugErrPathX
38   | AugErrNoMatch
39   | AugErrMMatch
40   | AugErrSyntax
41   | AugErrNoLens
42   | AugErrMXfm
43   | AugErrNoSpan
44   | AugErrMvDesc
45   | AugErrCmdRun
46   | AugErrBadArg
47   | AugErrLabel
48   | AugErrCpDesc
49   | AugErrUnknown of int
50
51 type transform_mode =
52   | Include
53   | Exclude
54
55 exception Error of error_code * string * string * string
56
57 type path = string
58
59 type value = string
60
61 external create : string -> string option -> flag list -> t
62   = "ocaml_augeas_create"
63 external close : t -> unit
64   = "ocaml_augeas_close"
65 external get : t -> path -> value option
66   = "ocaml_augeas_get"
67 external exists : t -> path -> bool
68   = "ocaml_augeas_exists"
69 external insert : t -> ?before:bool -> path -> string -> unit
70   = "ocaml_augeas_insert"
71 external rm : t -> path -> int
72   = "ocaml_augeas_rm"
73 external matches : t -> path -> path list
74   = "ocaml_augeas_match"
75 external count_matches : t -> path -> int
76   = "ocaml_augeas_count_matches"
77 external save : t -> unit
78   = "ocaml_augeas_save"
79 external load : t -> unit
80   = "ocaml_augeas_load"
81 external set : t -> path -> value option -> unit
82   = "ocaml_augeas_set"
83 external transform : t -> string -> string -> transform_mode -> unit
84   = "ocaml_augeas_transform"
85 external source : t -> path -> path option
86   = "ocaml_augeas_source"
87
88 let () =
89   Callback.register_exception "Augeas.Error" (Error (AugErrInternal, "", "", ""))