src/xb-silo.h - main - githubmirror/libxmlb

src/xb-silo.h
119 строк4 KB
Richard Hughes
trivial: Never call g_error() in library code
18 май 2026, 18:38
18 май 2026, 18:3825b55e5
/*
 * Copyright 2018 Richard Hughes <richard@hughsie.com>
 *
 * SPDX-License-Identifier: LGPL-2.1-or-later
 */

#pragma once

#include <gio/gio.h>
#include <glib-object.h>
#include <glib.h>

#include "xb-node.h"

G_BEGIN_DECLS

#define XB_TYPE_SILO (xb_silo_get_type())
G_DECLARE_DERIVABLE_TYPE(XbSilo, xb_silo, XB, SILO, GObject)

struct _XbSiloClass {
	GObjectClass parent_class;
	/*< private >*/
	void (*_xb_reserved1)(void);
	void (*_xb_reserved2)(void);
	void (*_xb_reserved3)(void);
	void (*_xb_reserved4)(void);
	void (*_xb_reserved5)(void);
	void (*_xb_reserved6)(void);
	void (*_xb_reserved7)(void);
};

/**
 * XbSiloLoadFlags:
 * @XB_SILO_LOAD_FLAG_NONE:			No extra flags to use
 * @XB_SILO_LOAD_FLAG_NO_MAGIC:			No not check header signature
 * @XB_SILO_LOAD_FLAG_WATCH_BLOB:		Watch the XMLB file for changes
 *
 * The flags for loading a silo.
 **/
typedef enum {
	XB_SILO_LOAD_FLAG_NONE = 0,	       /* Since: 0.1.0 */
	XB_SILO_LOAD_FLAG_NO_MAGIC = 1 << 0,   /* Since: 0.1.0 */
	XB_SILO_LOAD_FLAG_WATCH_BLOB = 1 << 1, /* Since: 0.1.0 */
	/*< private >*/
	XB_SILO_LOAD_FLAG_LAST
} XbSiloLoadFlags;

/**
 * XbSiloProfileFlags:
 * @XB_SILO_PROFILE_FLAG_NONE:			No extra flags to use
 * @XB_SILO_PROFILE_FLAG_DEBUG:			Output profiling as debug
 * @XB_SILO_PROFILE_FLAG_APPEND:		Save profiling in an appended string
 * @XB_SILO_PROFILE_FLAG_XPATH:			Save XPATH queries
 * @XB_SILO_PROFILE_FLAG_OPTIMIZER:		Output the machine optimizer as debug
 *
 * The flags used when profiling a silo.
 **/
typedef enum {
	XB_SILO_PROFILE_FLAG_NONE = 0,		 /* Since: 0.1.1 */
	XB_SILO_PROFILE_FLAG_DEBUG = 1 << 0,	 /* Since: 0.1.1 */
	XB_SILO_PROFILE_FLAG_APPEND = 1 << 1,	 /* Since: 0.1.1 */
	XB_SILO_PROFILE_FLAG_XPATH = 1 << 2,	 /* Since: 0.1.1 */
	XB_SILO_PROFILE_FLAG_OPTIMIZER = 1 << 3, /* Since: 0.3.1 */
	/*< private >*/
	XB_SILO_PROFILE_FLAG_LAST
} XbSiloProfileFlags;

XbSilo *
xb_silo_new(void);
XbSilo *
xb_silo_new_from_xml(const gchar *xml, GError **error) G_GNUC_NON_NULL(1);
GBytes *
xb_silo_get_bytes(XbSilo *self) G_GNUC_NON_NULL(1);
gboolean
xb_silo_load_from_bytes(XbSilo *self, GBytes *blob, XbSiloLoadFlags flags, GError **error)
    G_GNUC_NON_NULL(1, 2);
gboolean
xb_silo_load_from_file(XbSilo *self,
		       GFile *file,
		       XbSiloLoadFlags flags,
		       GCancellable *cancellable,
		       GError **error) G_GNUC_NON_NULL(1, 2);
gboolean
xb_silo_save_to_file(XbSilo *self, GFile *file, GCancellable *cancellable, GError **error)
    G_GNUC_NON_NULL(1, 2);
gchar *
xb_silo_to_string(XbSilo *self, GError **error) G_GNUC_NON_NULL(1);
guint
xb_silo_get_size(XbSilo *self) G_GNUC_NON_NULL(1);
const gchar *
xb_silo_get_guid(XbSilo *self) G_GNUC_NON_NULL(1);
XbNode *
xb_silo_get_root(XbSilo *self) G_GNUC_NON_NULL(1);
void
xb_silo_invalidate(XbSilo *self) G_GNUC_NON_NULL(1);
gboolean
xb_silo_is_valid(XbSilo *self) G_GNUC_NON_NULL(1);
gboolean
xb_silo_watch_file(XbSilo *self, GFile *file, GCancellable *cancellable, GError **error)
    G_GNUC_NON_NULL(1, 2);
void
xb_silo_set_profile_flags(XbSilo *self, XbSiloProfileFlags profile_flags) G_GNUC_NON_NULL(1);
const gchar *
xb_silo_get_profile_string(XbSilo *self) G_GNUC_NON_NULL(1);

gboolean
xb_silo_get_enable_node_cache(XbSilo *self) G_GNUC_NON_NULL(1);
void
xb_silo_set_enable_node_cache(XbSilo *self, gboolean enable_node_cache) G_GNUC_NON_NULL(1);

#include "xb-query.h"

G_DEPRECATED_FOR(xb_silo_lookup_query_full)
XbQuery *
xb_silo_lookup_query(XbSilo *self, const gchar *xpath) G_GNUC_NON_NULL(1, 2);
XbQuery *
xb_silo_lookup_query_full(XbSilo *self, const gchar *xpath, GError **error) G_GNUC_NON_NULL(1, 2);

G_END_DECLS