AsRelease

AsRelease — Object representing a single upstream release

Stability Level

Stable, unless otherwise indicated

Synopsis

#include <appstream-glib.h>

AsRelease *         as_release_new                      (void);
const gchar *       as_release_get_version              (AsRelease *release);
guint64             as_release_get_timestamp            (AsRelease *release);
const gchar *       as_release_get_description          (AsRelease *release,
                                                         const gchar *locale);
GPtrArray *         as_release_get_locations            (AsRelease *release);
const gchar *       as_release_get_location_default     (AsRelease *release);
const gchar *       as_release_get_checksum             (AsRelease *release,
                                                         GChecksumType checksum_type);
void                as_release_set_version              (AsRelease *release,
                                                         const gchar *version,
                                                         gssize version_len);
void                as_release_set_timestamp            (AsRelease *release,
                                                         guint64 timestamp);
void                as_release_set_description          (AsRelease *release,
                                                         const gchar *locale,
                                                         const gchar *description,
                                                         gssize description_len);
void                as_release_add_location             (AsRelease *release,
                                                         const gchar *location,
                                                         gssize location_len);
void                as_release_set_checksum             (AsRelease *release,
                                                         GChecksumType checksum_type,
                                                         const gchar *checksum,
                                                         gssize checksum_len);

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

Details

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.

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.

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.

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.

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.

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.

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.

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.

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.

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.

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.

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