AsMetadata

AsMetadata — Parser for AppStream metadata

Functions

Types and Values

Object Hierarchy

    GObject
    ╰── AsMetadata

Includes

#include <appstream.h>

Description

This object parses AppStream metadata, including AppStream upstream metadata, which is defined by upstream projects. It returns an AsComponent of the data.

See also: AsComponent, AsDatabase

Functions

as_metadata_new ()

AsMetadata *
as_metadata_new (void);

Creates a new AsMetadata.

Returns

a AsMetadata.

[transfer full]


as_metadata_error_quark ()

GQuark
as_metadata_error_quark (void);

Returns

An error quark.


as_metadata_parse_file ()

void
as_metadata_parse_file (AsMetadata *metad,
                        GFile *file,
                        GError **error);

Parses an AppStream upstream metadata file.

Parameters

metad

A valid AsMetadata instance

 

file

GFile for the upstream metadata

 

error

A GError or NULL.

 

as_metadata_parse_data ()

void
as_metadata_parse_data (AsMetadata *metad,
                        const gchar *data,
                        GError **error);

Parses AppStream metadata.

Parameters

metad

A valid AsMetadata instance

 

data

XML data describing a component

 

error

A GError or NULL.

 

as_metadata_get_component ()

AsComponent *
as_metadata_get_component (AsMetadata *metad);

Gets the AsComponent which has been parsed from the XML. If the AppStream XML contained multiple components, return the first component that has been parsed.

Parameters

metad

a AsMetadata instance.

 

Returns

An AsComponent or NULL.

[transfer none]


as_metadata_get_components ()

GPtrArray *
as_metadata_get_components (AsMetadata *metad);

Parameters

metad

a AsMetadata instance.

 

Returns

A GPtrArray of all parsed components.

[transfer none][element-type AsComponent]


as_metadata_clear_components ()

void
as_metadata_clear_components (AsMetadata *metad);

as_metadata_add_component ()

void
as_metadata_add_component (AsMetadata *metad,
                           AsComponent *cpt);

Add an AsComponent to the list of components. This can be used to add multiple components in order to produce a distro-XML AppStream metadata file.


as_metadata_component_to_upstream_xml ()

gchar *
as_metadata_component_to_upstream_xml (AsMetadata *metad);

Convert an AsComponent to upstream XML. (The amount of localization included in the metadata depends on how the AsComponent was initially loaded)

The first AsComponent added to the internal list will be transformed. In case no component is present, NULL is returned.

Returns

A string containing the XML. Free with g_free().

[transfer full]


as_metadata_components_to_distro_xml ()

gchar *
as_metadata_components_to_distro_xml (AsMetadata *metad);

Serialize all AsComponent instances into AppStream distro-XML data. NULL is returned if there is nothing to serialize.

Returns

A string containing the XML. Free with g_free().

[transfer full]


as_metadata_save_upstream_xml ()

void
as_metadata_save_upstream_xml (AsMetadata *metad,
                               const gchar *fname,
                               GError **error);

Serialize AsComponent instance to XML and save it to file. An existing file at the same location will be overridden.

Parameters

fname

The filename for the new XML file.

 

as_metadata_save_distro_xml ()

void
as_metadata_save_distro_xml (AsMetadata *metad,
                             const gchar *fname,
                             GError **error);

Serialize all AsComponent instances to XML and save the data to a file. An existing file at the same location will be overridden.

Parameters

fname

The filename for the new XML file.

 

as_metadata_set_locale ()

void
as_metadata_set_locale (AsMetadata *metad,
                        const gchar *locale);

Sets the locale which should be read when processing metadata. All other locales are ignored, which increases parsing speed and reduces memory usage. If you set the locale to "ALL", all locales will be read.

Parameters

metad

a AsMetadata instance.

 

locale

the locale.

 

as_metadata_get_locale ()

const gchar *
as_metadata_get_locale (AsMetadata *metad);

Gets the current active locale for parsing metadata, or "ALL" if all locales are read.

Parameters

metad

a AsMetadata instance.

 

Returns

Locale used for metadata parsing.


as_metadata_get_origin ()

const gchar *
as_metadata_get_origin (AsMetadata *metad);

Parameters

metad

an AsMetadata instance.

 

Returns

The origin of AppStream distro metadata


as_metadata_set_origin ()

void
as_metadata_set_origin (AsMetadata *metad,
                        const gchar *origin);

Set the origin of AppStream distro metadata

Parameters

metad

an AsMetadata instance.

 

origin

the origin of AppStream distro metadata.

 

Types and Values

enum AsMetadataError

The error type.

Members

AS_METADATA_ERROR_FAILED

Generic failure

 

AS_METADATA_ERROR_LAST

   

AS_METADATA_ERROR

#define AS_METADATA_ERROR		as_metadata_error_quark ()