1 /* -*- mode: C; c-file-style: "gnu"; indent-tabs-mode: nil; -*-
2 * GObject introspection: Repository
4 * Copyright (C) 2005 Matthias Clasen
5 * Copyright (C) 2008,2009 Red Hat, Inc.
7 * This library is free software; you can redistribute it and/or
8 * modify it under the terms of the GNU Lesser General Public
9 * License as published by the Free Software Foundation; either
10 * version 2 of the License, or (at your option) any later version.
12 * This library is distributed in the hope that it will be useful,
13 * but WITHOUT ANY WARRANTY; without even the implied warranty of
14 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
15 * Lesser General Public License for more details.
17 * You should have received a copy of the GNU Lesser General Public
18 * License along with this library; if not, write to the
19 * Free Software Foundation, Inc., 59 Temple Place - Suite 330,
20 * Boston, MA 02111-1307, USA.
23 #ifndef __G_IREPOSITORY_H__
24 #define __G_IREPOSITORY_H__
26 #include <glib-object.h>
29 #define __GIREPOSITORY_H_INSIDE__
31 #include <giarginfo.h>
32 #include <gibaseinfo.h>
33 #include <gicallableinfo.h>
34 #include <giconstantinfo.h>
35 #include <gienuminfo.h>
36 #include <gifieldinfo.h>
37 #include <gifunctioninfo.h>
38 #include <giinterfaceinfo.h>
39 #include <giobjectinfo.h>
40 #include <gipropertyinfo.h>
41 #include <giregisteredtypeinfo.h>
42 #include <gisignalinfo.h>
43 #include <gistructinfo.h>
44 #include <gitypeinfo.h>
45 #include <gitypelib.h>
47 #include <giunioninfo.h>
48 #include <giversionmacros.h>
49 #include <givfuncinfo.h>
50 #include <giversion.h>
54 #define G_TYPE_IREPOSITORY (g_irepository_get_type ())
55 #define G_IREPOSITORY(object) (G_TYPE_CHECK_INSTANCE_CAST ((object), G_TYPE_IREPOSITORY, GIRepository))
56 #define G_IREPOSITORY_CLASS(klass) (G_TYPE_CHECK_CLASS_CAST ((klass), G_TYPE_IREPOSITORY, GIRepositoryClass))
57 #define G_IS_IREPOSITORY(object) (G_TYPE_CHECK_INSTANCE_TYPE ((object), G_TYPE_IREPOSITORY))
58 #define G_IS_IREPOSITORY_CLASS(klass) (G_TYPE_CHECK_CLASS_TYPE ((klass), G_TYPE_IREPOSITORY))
59 #define G_IREPOSITORY_GET_CLASS(obj) (G_TYPE_INSTANCE_GET_CLASS ((obj), G_TYPE_IREPOSITORY, GIRepositoryClass))
64 * The GIRepository structure contains private data and should only be
65 * accessed using the provided API.
67 typedef struct _GIRepository GIRepository;
68 typedef struct _GIRepositoryClass GIRepositoryClass;
69 typedef struct _GIRepositoryPrivate GIRepositoryPrivate;
75 GIRepositoryPrivate *priv;
78 struct _GIRepositoryClass
85 * GIRepositoryLoadFlags:
86 * @G_IREPOSITORY_LOAD_FLAG_LAZY: Lazily load the typelib.
88 * Flags that control how a typelib is loaded.
92 G_IREPOSITORY_LOAD_FLAG_LAZY = 1 << 0
93 } GIRepositoryLoadFlags;
98 GType g_irepository_get_type (void) G_GNUC_CONST;
101 GIRepository *g_irepository_get_default (void);
104 void g_irepository_prepend_search_path (const char *directory);
107 void g_irepository_prepend_library_path (const char *directory);
110 GSList * g_irepository_get_search_path (void);
113 const char * g_irepository_load_typelib (GIRepository *repository,
115 GIRepositoryLoadFlags flags,
119 gboolean g_irepository_is_registered (GIRepository *repository,
120 const gchar *namespace_,
121 const gchar *version);
124 GIBaseInfo * g_irepository_find_by_name (GIRepository *repository,
125 const gchar *namespace_,
129 GList * g_irepository_enumerate_versions (GIRepository *repository,
130 const gchar *namespace_);
133 GITypelib * g_irepository_require (GIRepository *repository,
134 const gchar *namespace_,
135 const gchar *version,
136 GIRepositoryLoadFlags flags,
140 GITypelib * g_irepository_require_private (GIRepository *repository,
141 const gchar *typelib_dir,
142 const gchar *namespace_,
143 const gchar *version,
144 GIRepositoryLoadFlags flags,
148 gchar ** g_irepository_get_immediate_dependencies (GIRepository *repository,
149 const gchar *namespace_);
152 gchar ** g_irepository_get_dependencies (GIRepository *repository,
153 const gchar *namespace_);
156 gchar ** g_irepository_get_loaded_namespaces (GIRepository *repository);
159 GIBaseInfo * g_irepository_find_by_gtype (GIRepository *repository,
163 void g_irepository_get_object_gtype_interfaces (GIRepository *repository,
165 guint *n_interfaces_out,
166 GIInterfaceInfo **interfaces_out);
169 gint g_irepository_get_n_infos (GIRepository *repository,
170 const gchar *namespace_);
173 GIBaseInfo * g_irepository_get_info (GIRepository *repository,
174 const gchar *namespace_,
178 GIEnumInfo * g_irepository_find_by_error_domain (GIRepository *repository,
182 const gchar * g_irepository_get_typelib_path (GIRepository *repository,
183 const gchar *namespace_);
185 const gchar * g_irepository_get_shared_library (GIRepository *repository,
186 const gchar *namespace_);
188 const gchar * g_irepository_get_c_prefix (GIRepository *repository,
189 const gchar *namespace_);
191 const gchar * g_irepository_get_version (GIRepository *repository,
192 const gchar *namespace_);
196 GOptionGroup * g_irepository_get_option_group (void);
200 gboolean g_irepository_dump (const char *arg, GError **error);
204 * @G_IREPOSITORY_ERROR_TYPELIB_NOT_FOUND: the typelib could not be found.
205 * @G_IREPOSITORY_ERROR_NAMESPACE_MISMATCH: the namespace does not match the
206 * requested namespace.
207 * @G_IREPOSITORY_ERROR_NAMESPACE_VERSION_CONFLICT: the version of the
208 * typelib does not match the requested version.
209 * @G_IREPOSITORY_ERROR_LIBRARY_NOT_FOUND: the library used by the typelib
210 * could not be found.
212 * An error code used with #G_IREPOSITORY_ERROR in a #GError returned
213 * from a #GIRepository routine.
217 G_IREPOSITORY_ERROR_TYPELIB_NOT_FOUND,
218 G_IREPOSITORY_ERROR_NAMESPACE_MISMATCH,
219 G_IREPOSITORY_ERROR_NAMESPACE_VERSION_CONFLICT,
220 G_IREPOSITORY_ERROR_LIBRARY_NOT_FOUND
224 * G_IREPOSITORY_ERROR:
226 * Error domain for #GIRepository. Errors in this domain will be from the
227 * #GIRepositoryError enumeration. See #GError for more information on
230 #define G_IREPOSITORY_ERROR (g_irepository_error_quark ())
233 GQuark g_irepository_error_quark (void);
236 /* Global utility functions */
239 void gi_cclosure_marshal_generic (GClosure *closure,
240 GValue *return_gvalue,
241 guint n_param_values,
242 const GValue *param_values,
243 gpointer invocation_hint,
244 gpointer marshal_data);
249 #endif /* __G_IREPOSITORY_H__ */