mirror of
https://gitlab.gnome.org/GNOME/glib.git
synced 2024-09-20 17:26:14 +02:00
af36393e60
The introspection API has lived out of tree far too long. It has the same ABI guarantees as the rest of GLib, so it has no reason to be split from the main library. The gobject-introspection project can depend on libgirepository, and the language bindings can drop the gobject-introspection-1.0 dependency.
249 lines
7.8 KiB
C
249 lines
7.8 KiB
C
/* -*- mode: C; c-file-style: "gnu"; indent-tabs-mode: nil; -*-
|
|
* GObject introspection: Repository
|
|
*
|
|
* Copyright (C) 2005 Matthias Clasen
|
|
* Copyright (C) 2008,2009 Red Hat, Inc.
|
|
*
|
|
* This library is free software; you can redistribute it and/or
|
|
* modify it under the terms of the GNU Lesser General Public
|
|
* License as published by the Free Software Foundation; either
|
|
* version 2 of the License, or (at your option) any later version.
|
|
*
|
|
* This library is distributed in the hope that it will be useful,
|
|
* but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
|
|
* Lesser General Public License for more details.
|
|
*
|
|
* You should have received a copy of the GNU Lesser General Public
|
|
* License along with this library; if not, write to the
|
|
* Free Software Foundation, Inc., 59 Temple Place - Suite 330,
|
|
* Boston, MA 02111-1307, USA.
|
|
*/
|
|
|
|
#ifndef __G_IREPOSITORY_H__
|
|
#define __G_IREPOSITORY_H__
|
|
|
|
#include <glib-object.h>
|
|
#include <gmodule.h>
|
|
|
|
#include <gi-visibility.h>
|
|
|
|
#define __GIREPOSITORY_H_INSIDE__
|
|
|
|
#include <giarginfo.h>
|
|
#include <gibaseinfo.h>
|
|
#include <gicallableinfo.h>
|
|
#include <giconstantinfo.h>
|
|
#include <gienuminfo.h>
|
|
#include <gifieldinfo.h>
|
|
#include <gifunctioninfo.h>
|
|
#include <giinterfaceinfo.h>
|
|
#include <giobjectinfo.h>
|
|
#include <gipropertyinfo.h>
|
|
#include <giregisteredtypeinfo.h>
|
|
#include <gisignalinfo.h>
|
|
#include <gistructinfo.h>
|
|
#include <gitypeinfo.h>
|
|
#include <gitypelib.h>
|
|
#include <gitypes.h>
|
|
#include <giunioninfo.h>
|
|
#include <givfuncinfo.h>
|
|
|
|
G_BEGIN_DECLS
|
|
|
|
#define G_TYPE_IREPOSITORY (g_irepository_get_type ())
|
|
#define G_IREPOSITORY(object) (G_TYPE_CHECK_INSTANCE_CAST ((object), G_TYPE_IREPOSITORY, GIRepository))
|
|
#define G_IREPOSITORY_CLASS(klass) (G_TYPE_CHECK_CLASS_CAST ((klass), G_TYPE_IREPOSITORY, GIRepositoryClass))
|
|
#define G_IS_IREPOSITORY(object) (G_TYPE_CHECK_INSTANCE_TYPE ((object), G_TYPE_IREPOSITORY))
|
|
#define G_IS_IREPOSITORY_CLASS(klass) (G_TYPE_CHECK_CLASS_TYPE ((klass), G_TYPE_IREPOSITORY))
|
|
#define G_IREPOSITORY_GET_CLASS(obj) (G_TYPE_INSTANCE_GET_CLASS ((obj), G_TYPE_IREPOSITORY, GIRepositoryClass))
|
|
|
|
/**
|
|
* GIRepository:
|
|
*
|
|
* The GIRepository structure contains private data and should only be
|
|
* accessed using the provided API.
|
|
*/
|
|
typedef struct _GIRepository GIRepository;
|
|
typedef struct _GIRepositoryClass GIRepositoryClass;
|
|
typedef struct _GIRepositoryPrivate GIRepositoryPrivate;
|
|
|
|
struct _GIRepository
|
|
{
|
|
/*< private >*/
|
|
GObject parent;
|
|
GIRepositoryPrivate *priv;
|
|
};
|
|
|
|
struct _GIRepositoryClass
|
|
{
|
|
/*< private >*/
|
|
GObjectClass parent;
|
|
};
|
|
|
|
/**
|
|
* GIRepositoryLoadFlags:
|
|
* @G_IREPOSITORY_LOAD_FLAG_LAZY: Lazily load the typelib.
|
|
*
|
|
* Flags that control how a typelib is loaded.
|
|
*/
|
|
typedef enum
|
|
{
|
|
G_IREPOSITORY_LOAD_FLAG_LAZY = 1 << 0
|
|
} GIRepositoryLoadFlags;
|
|
|
|
/* Repository */
|
|
|
|
GI_AVAILABLE_IN_ALL
|
|
GType g_irepository_get_type (void) G_GNUC_CONST;
|
|
|
|
GI_AVAILABLE_IN_ALL
|
|
GIRepository *g_irepository_get_default (void);
|
|
|
|
GI_AVAILABLE_IN_ALL
|
|
void g_irepository_prepend_search_path (const char *directory);
|
|
|
|
GI_AVAILABLE_IN_2_36
|
|
void g_irepository_prepend_library_path (const char *directory);
|
|
|
|
GI_AVAILABLE_IN_ALL
|
|
GSList * g_irepository_get_search_path (void);
|
|
|
|
GI_AVAILABLE_IN_ALL
|
|
const char * g_irepository_load_typelib (GIRepository *repository,
|
|
GITypelib *typelib,
|
|
GIRepositoryLoadFlags flags,
|
|
GError **error);
|
|
|
|
GI_AVAILABLE_IN_ALL
|
|
gboolean g_irepository_is_registered (GIRepository *repository,
|
|
const gchar *namespace_,
|
|
const gchar *version);
|
|
|
|
GI_AVAILABLE_IN_ALL
|
|
GIBaseInfo * g_irepository_find_by_name (GIRepository *repository,
|
|
const gchar *namespace_,
|
|
const gchar *name);
|
|
|
|
GI_AVAILABLE_IN_ALL
|
|
GList * g_irepository_enumerate_versions (GIRepository *repository,
|
|
const gchar *namespace_);
|
|
|
|
GI_AVAILABLE_IN_ALL
|
|
GITypelib * g_irepository_require (GIRepository *repository,
|
|
const gchar *namespace_,
|
|
const gchar *version,
|
|
GIRepositoryLoadFlags flags,
|
|
GError **error);
|
|
|
|
GI_AVAILABLE_IN_ALL
|
|
GITypelib * g_irepository_require_private (GIRepository *repository,
|
|
const gchar *typelib_dir,
|
|
const gchar *namespace_,
|
|
const gchar *version,
|
|
GIRepositoryLoadFlags flags,
|
|
GError **error);
|
|
|
|
GI_AVAILABLE_IN_2_44
|
|
gchar ** g_irepository_get_immediate_dependencies (GIRepository *repository,
|
|
const gchar *namespace_);
|
|
|
|
GI_AVAILABLE_IN_ALL
|
|
gchar ** g_irepository_get_dependencies (GIRepository *repository,
|
|
const gchar *namespace_);
|
|
|
|
GI_AVAILABLE_IN_ALL
|
|
gchar ** g_irepository_get_loaded_namespaces (GIRepository *repository);
|
|
|
|
GI_AVAILABLE_IN_ALL
|
|
GIBaseInfo * g_irepository_find_by_gtype (GIRepository *repository,
|
|
GType gtype);
|
|
|
|
GI_AVAILABLE_IN_2_60
|
|
void g_irepository_get_object_gtype_interfaces (GIRepository *repository,
|
|
GType gtype,
|
|
guint *n_interfaces_out,
|
|
GIInterfaceInfo ***interfaces_out);
|
|
|
|
GI_AVAILABLE_IN_ALL
|
|
gint g_irepository_get_n_infos (GIRepository *repository,
|
|
const gchar *namespace_);
|
|
|
|
GI_AVAILABLE_IN_ALL
|
|
GIBaseInfo * g_irepository_get_info (GIRepository *repository,
|
|
const gchar *namespace_,
|
|
gint index);
|
|
|
|
GI_AVAILABLE_IN_ALL
|
|
GIEnumInfo * g_irepository_find_by_error_domain (GIRepository *repository,
|
|
GQuark domain);
|
|
|
|
GI_AVAILABLE_IN_ALL
|
|
const gchar * g_irepository_get_typelib_path (GIRepository *repository,
|
|
const gchar *namespace_);
|
|
GI_AVAILABLE_IN_ALL
|
|
const gchar * g_irepository_get_shared_library (GIRepository *repository,
|
|
const gchar *namespace_);
|
|
GI_AVAILABLE_IN_ALL
|
|
const gchar * g_irepository_get_c_prefix (GIRepository *repository,
|
|
const gchar *namespace_);
|
|
GI_AVAILABLE_IN_ALL
|
|
const gchar * g_irepository_get_version (GIRepository *repository,
|
|
const gchar *namespace_);
|
|
|
|
|
|
GI_AVAILABLE_IN_ALL
|
|
GOptionGroup * g_irepository_get_option_group (void);
|
|
|
|
|
|
GI_AVAILABLE_IN_ALL
|
|
gboolean g_irepository_dump (const char *arg, GError **error);
|
|
|
|
/**
|
|
* GIRepositoryError:
|
|
* @G_IREPOSITORY_ERROR_TYPELIB_NOT_FOUND: the typelib could not be found.
|
|
* @G_IREPOSITORY_ERROR_NAMESPACE_MISMATCH: the namespace does not match the
|
|
* requested namespace.
|
|
* @G_IREPOSITORY_ERROR_NAMESPACE_VERSION_CONFLICT: the version of the
|
|
* typelib does not match the requested version.
|
|
* @G_IREPOSITORY_ERROR_LIBRARY_NOT_FOUND: the library used by the typelib
|
|
* could not be found.
|
|
*
|
|
* An error code used with #G_IREPOSITORY_ERROR in a #GError returned
|
|
* from a #GIRepository routine.
|
|
*/
|
|
typedef enum
|
|
{
|
|
G_IREPOSITORY_ERROR_TYPELIB_NOT_FOUND,
|
|
G_IREPOSITORY_ERROR_NAMESPACE_MISMATCH,
|
|
G_IREPOSITORY_ERROR_NAMESPACE_VERSION_CONFLICT,
|
|
G_IREPOSITORY_ERROR_LIBRARY_NOT_FOUND
|
|
} GIRepositoryError;
|
|
|
|
/**
|
|
* G_IREPOSITORY_ERROR:
|
|
*
|
|
* Error domain for #GIRepository. Errors in this domain will be from the
|
|
* #GIRepositoryError enumeration. See #GError for more information on
|
|
* error domains.
|
|
*/
|
|
#define G_IREPOSITORY_ERROR (g_irepository_error_quark ())
|
|
|
|
GI_AVAILABLE_IN_ALL
|
|
GQuark g_irepository_error_quark (void);
|
|
|
|
|
|
/* Global utility functions */
|
|
|
|
GI_AVAILABLE_IN_ALL
|
|
void gi_cclosure_marshal_generic (GClosure *closure,
|
|
GValue *return_gvalue,
|
|
guint n_param_values,
|
|
const GValue *param_values,
|
|
gpointer invocation_hint,
|
|
gpointer marshal_data);
|
|
|
|
G_END_DECLS
|
|
|
|
#endif /* __G_IREPOSITORY_H__ */
|