AsRelease

AsRelease — Object representing a single upstream release

Stability Level

Stable, unless otherwise indicated

Functions

Object Hierarchy

    GObject
    ╰── AsRelease

Includes

#include <appstream-glib.h>

Description

This object represents a single upstream release, typically a minor update. Releases can contain a localized description of paragraph and list elements and also have a version number and timestamp.

Releases can be automatically generated by parsing upstream ChangeLogs or .spec files, or can be populated using AppData files.

See also: AsApp

Functions

as_release_new ()

AsRelease *
as_release_new (void);

Creates a new AsRelease.

Returns

a AsRelease.

[transfer full]

Since: 0.1.0


as_release_get_version ()

const gchar *
as_release_get_version (AsRelease *release);

Gets the release version.

Parameters

release

a AsRelease instance.

 

Returns

string, or NULL for not set or invalid

Since: 0.1.0


as_release_get_timestamp ()

guint64
as_release_get_timestamp (AsRelease *release);

Gets the release timestamp.

Parameters

release

a AsRelease instance.

 

Returns

timestamp, or 0 for unset

Since: 0.1.0


as_release_get_description ()

const gchar *
as_release_get_description (AsRelease *release,
                            const gchar *locale);

Gets the release description markup for a given locale.

Parameters

release

a AsRelease instance.

 

locale

the locale, or NULL. e.g. "en_GB"

 

Returns

markup, or NULL for not set or invalid

Since: 0.1.0


as_release_get_locations ()

GPtrArray *
as_release_get_locations (AsRelease *release);

Gets the release locations, typically URLs.

Parameters

release

a AsRelease instance.

 

Returns

list of locations.

[transfer none][element-type utf8]

Since: 0.3.5


as_release_get_location_default ()

const gchar *
as_release_get_location_default (AsRelease *release);

Gets the default release location, typically a URL.

Parameters

release

a AsRelease instance.

 

Returns

string, or NULL for not set or invalid

Since: 0.3.5


as_release_get_checksum ()

const gchar *
as_release_get_checksum (AsRelease *release,
                         GChecksumType checksum_type);

Gets the release checksum, typically a SHA1 hash.

Parameters

release

a AsRelease instance.

 

Returns

string, or NULL for not set or invalid

Since: 0.3.5


as_release_set_version ()

void
as_release_set_version (AsRelease *release,
                        const gchar *version,
                        gssize version_len);

Sets the release version.

Parameters

release

a AsRelease instance.

 

version

the version string.

 

version_len

the size of version , or -1 if NULL-terminated.

 

Since: 0.1.0


as_release_set_timestamp ()

void
as_release_set_timestamp (AsRelease *release,
                          guint64 timestamp);

Sets the release timestamp.

Parameters

release

a AsRelease instance.

 

timestamp

the timestamp value.

 

Since: 0.1.0


as_release_set_description ()

void
as_release_set_description (AsRelease *release,
                            const gchar *locale,
                            const gchar *description,
                            gssize description_len);

Sets the description release markup.

Parameters

release

a AsRelease instance.

 

locale

the locale, or NULL. e.g. "en_GB"

 

description

the description markup.

 

description_len

the size of description , or -1 if NULL-terminated.

 

Since: 0.1.0


as_release_add_location ()

void
as_release_add_location (AsRelease *release,
                         const gchar *location,
                         gssize location_len);

Adds a release location.

Parameters

release

a AsRelease instance.

 

location

the location string.

 

location_len

the size of location , or -1 if NULL-terminated.

 

Since: 0.3.5


as_release_set_checksum ()

void
as_release_set_checksum (AsRelease *release,
                         GChecksumType checksum_type,
                         const gchar *checksum,
                         gssize checksum_len);

Sets the release checksum.

Parameters

release

a AsRelease instance.

 

checksum_type

a GChecksumType, e.g. G_CHECKSUM_SHA1

 

checksum

the checksum string.

 

checksum_len

the size of checksum , or -1 if NULL-terminated.

 

Since: 0.3.5

Types and Values