Blame gdata/services/documents/gdata-documents-metadata.c

Packit 4b6dd7
/* -*- Mode: C; indent-tabs-mode: t; c-basic-offset: 8; tab-width: 8 -*- */
Packit 4b6dd7
/*
Packit 4b6dd7
 * GData Client
Packit 4b6dd7
 * Copyright (C) Michael Terry 2017 <mike@mterry.name>
Packit 4b6dd7
 *
Packit 4b6dd7
 * GData Client is free software; you can redistribute it and/or
Packit 4b6dd7
 * modify it under the terms of the GNU Lesser General Public
Packit 4b6dd7
 * License as published by the Free Software Foundation; either
Packit 4b6dd7
 * version 2.1 of the License, or (at your option) any later version.
Packit 4b6dd7
 *
Packit 4b6dd7
 * GData Client is distributed in the hope that it will be useful,
Packit 4b6dd7
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
Packit 4b6dd7
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
Packit 4b6dd7
 * Lesser General Public License for more details.
Packit 4b6dd7
 *
Packit 4b6dd7
 * You should have received a copy of the GNU Lesser General Public
Packit 4b6dd7
 * License along with GData Client.  If not, see <http://www.gnu.org/licenses/>.
Packit 4b6dd7
 */
Packit 4b6dd7
Packit 4b6dd7
/**
Packit 4b6dd7
 * SECTION:gdata-documents-metadata
Packit 4b6dd7
 * @short_description: GData document service metadata class
Packit 4b6dd7
 * @stability: Stable
Packit 4b6dd7
 * @include: gdata/services/documents/gdata-documents-metadata.h
Packit 4b6dd7
 *
Packit 4b6dd7
 * #GDataDocumentsMetadata is a subclass of #GDataParsable to represent Google Drive service metadata.
Packit 4b6dd7
 *
Packit 4b6dd7
 * For more details of Google Documents' GData API, see the
Packit 4b6dd7
 * <ulink type="http" url="https://developers.google.com/drive/v2/web/about-sdk">online documentation</ulink>.
Packit 4b6dd7
 *
Packit 4b6dd7
 * Since: 0.17.9
Packit 4b6dd7
 */
Packit 4b6dd7
Packit 4b6dd7
#include <config.h>
Packit 4b6dd7
#include <glib.h>
Packit 4b6dd7
#include <glib/gi18n-lib.h>
Packit 4b6dd7
#include <string.h>
Packit 4b6dd7
Packit 4b6dd7
#include "gdata-documents-metadata.h"
Packit 4b6dd7
#include "gdata-parser.h"
Packit 4b6dd7
#include "gdata-types.h"
Packit 4b6dd7
Packit 4b6dd7
static const gchar *get_content_type (void);
Packit 4b6dd7
static void gdata_documents_metadata_get_property (GObject *object, guint property_id, GValue *value, GParamSpec *pspec);
Packit 4b6dd7
static void gdata_documents_metadata_set_property (GObject *object, guint property_id, const GValue *value, GParamSpec *pspec);
Packit 4b6dd7
static gboolean parse_json (GDataParsable *parsable, JsonReader *reader, gpointer user_data, GError **error);
Packit 4b6dd7
Packit 4b6dd7
struct _GDataDocumentsMetadataPrivate {
Packit 4b6dd7
	goffset quota_total; /* bytes */
Packit 4b6dd7
	goffset quota_used; /* bytes */
Packit 4b6dd7
	gboolean quota_unlimited;
Packit 4b6dd7
};
Packit 4b6dd7
Packit 4b6dd7
enum {
Packit 4b6dd7
	PROP_QUOTA_TOTAL = 1,
Packit 4b6dd7
	PROP_QUOTA_USED,
Packit 4b6dd7
};
Packit 4b6dd7
Packit 4b6dd7
G_DEFINE_TYPE (GDataDocumentsMetadata, gdata_documents_metadata, GDATA_TYPE_PARSABLE)
Packit 4b6dd7
Packit 4b6dd7
static void
Packit 4b6dd7
gdata_documents_metadata_class_init (GDataDocumentsMetadataClass *klass)
Packit 4b6dd7
{
Packit 4b6dd7
	GObjectClass *gobject_class = G_OBJECT_CLASS (klass);
Packit 4b6dd7
	GDataParsableClass *parsable_class = GDATA_PARSABLE_CLASS (klass);
Packit 4b6dd7
Packit 4b6dd7
	g_type_class_add_private (klass, sizeof (GDataDocumentsMetadataPrivate));
Packit 4b6dd7
Packit 4b6dd7
	gobject_class->get_property = gdata_documents_metadata_get_property;
Packit 4b6dd7
	gobject_class->set_property = gdata_documents_metadata_set_property;
Packit 4b6dd7
Packit 4b6dd7
	parsable_class->parse_json = parse_json;
Packit 4b6dd7
	parsable_class->get_content_type = get_content_type;
Packit 4b6dd7
Packit 4b6dd7
	/**
Packit 4b6dd7
	 * GDataDocumentsMetadata:quota-total:
Packit 4b6dd7
	 *
Packit 4b6dd7
	 * The user quota limit across all services. Measured in bytes.
Packit 4b6dd7
	 *
Packit 4b6dd7
	 * Since: 0.17.9
Packit 4b6dd7
	 */
Packit 4b6dd7
	g_object_class_install_property (gobject_class, PROP_QUOTA_TOTAL,
Packit 4b6dd7
	                                 g_param_spec_int64 ("quota-total",
Packit 4b6dd7
	                                                     "Quota total", "The user quota limit across all services.",
Packit 4b6dd7
	                                                     -1, G_MAXINT64, 0,
Packit 4b6dd7
	                                                     G_PARAM_READABLE | G_PARAM_STATIC_STRINGS));
Packit 4b6dd7
Packit 4b6dd7
	/**
Packit 4b6dd7
	 * GDataDocumentsMetadata:quota-used:
Packit 4b6dd7
	 *
Packit 4b6dd7
	 * The amount of user quota used up across all services. Measured in bytes.
Packit 4b6dd7
	 *
Packit 4b6dd7
	 * Since: 0.17.9
Packit 4b6dd7
	 */
Packit 4b6dd7
	g_object_class_install_property (gobject_class, PROP_QUOTA_USED,
Packit 4b6dd7
	                                 g_param_spec_int64 ("quota-used",
Packit 4b6dd7
	                                                     "Quota used", "The amount of user quota used up across all services.",
Packit 4b6dd7
	                                                     0, G_MAXINT64, 0,
Packit 4b6dd7
	                                                     G_PARAM_READABLE | G_PARAM_STATIC_STRINGS));
Packit 4b6dd7
}
Packit 4b6dd7
Packit 4b6dd7
static void
Packit 4b6dd7
gdata_documents_metadata_init (GDataDocumentsMetadata *self)
Packit 4b6dd7
{
Packit 4b6dd7
	self->priv = G_TYPE_INSTANCE_GET_PRIVATE (self, GDATA_TYPE_DOCUMENTS_METADATA, GDataDocumentsMetadataPrivate);
Packit 4b6dd7
}
Packit 4b6dd7
Packit 4b6dd7
static void
Packit 4b6dd7
gdata_documents_metadata_get_property (GObject *object, guint property_id, GValue *value, GParamSpec *pspec)
Packit 4b6dd7
{
Packit 4b6dd7
	GDataDocumentsMetadata *self = GDATA_DOCUMENTS_METADATA (object);
Packit 4b6dd7
Packit 4b6dd7
	switch (property_id) {
Packit 4b6dd7
		case PROP_QUOTA_TOTAL:
Packit 4b6dd7
			g_value_set_int64 (value, gdata_documents_metadata_get_quota_total (self));
Packit 4b6dd7
			break;
Packit 4b6dd7
		case PROP_QUOTA_USED:
Packit 4b6dd7
			g_value_set_int64 (value, gdata_documents_metadata_get_quota_used (self));
Packit 4b6dd7
			break;
Packit 4b6dd7
		default:
Packit 4b6dd7
			/* We don't have any other property... */
Packit 4b6dd7
			G_OBJECT_WARN_INVALID_PROPERTY_ID (object, property_id, pspec);
Packit 4b6dd7
			break;
Packit 4b6dd7
	}
Packit 4b6dd7
}
Packit 4b6dd7
Packit 4b6dd7
static void
Packit 4b6dd7
gdata_documents_metadata_set_property (GObject *object, guint property_id, const GValue *value, GParamSpec *pspec)
Packit 4b6dd7
{
Packit 4b6dd7
	switch (property_id) {
Packit 4b6dd7
		case PROP_QUOTA_TOTAL:
Packit 4b6dd7
		case PROP_QUOTA_USED:
Packit 4b6dd7
			/* Read only. */
Packit 4b6dd7
		default:
Packit 4b6dd7
			/* We don't have any other property... */
Packit 4b6dd7
			G_OBJECT_WARN_INVALID_PROPERTY_ID (object, property_id, pspec);
Packit 4b6dd7
			break;
Packit 4b6dd7
	}
Packit 4b6dd7
}
Packit 4b6dd7
Packit 4b6dd7
static gboolean
Packit 4b6dd7
parse_json (GDataParsable *parsable, JsonReader *reader, gpointer user_data, GError **error)
Packit 4b6dd7
{
Packit 4b6dd7
	GDataDocumentsMetadataPrivate *priv = GDATA_DOCUMENTS_METADATA (parsable)->priv;
Packit 4b6dd7
	gboolean success = TRUE;
Packit 4b6dd7
	gchar *quota_total = NULL;
Packit 4b6dd7
	gchar *quota_used = NULL;
Packit 4b6dd7
	gchar *quota_type = NULL;
Packit 4b6dd7
Packit 4b6dd7
	/* JSON format: https://developers.google.com/drive/v2/reference/about */
Packit 4b6dd7
Packit 4b6dd7
	if (gdata_parser_string_from_json_member (reader, "quotaBytesTotal", P_DEFAULT, &quota_total, &success, error) == TRUE) {
Packit 4b6dd7
		gchar *end_ptr;
Packit 4b6dd7
		guint64 val;
Packit 4b6dd7
Packit 4b6dd7
		/* Even though ‘quotaBytesTotal’ is documented as long,
Packit 4b6dd7
		 * it is actually a string in the JSON.
Packit 4b6dd7
		 */
Packit 4b6dd7
		val = g_ascii_strtoull (quota_total, &end_ptr, 10);
Packit 4b6dd7
		if (*end_ptr == '\0')
Packit 4b6dd7
			priv->quota_total = (goffset) val;
Packit 4b6dd7
		g_free (quota_total);
Packit 4b6dd7
		return success;
Packit 4b6dd7
	} else if (gdata_parser_string_from_json_member (reader, "quotaBytesUsedAggregate", P_DEFAULT, &quota_used, &success, error) == TRUE) {
Packit 4b6dd7
		gchar *end_ptr;
Packit 4b6dd7
		guint64 val;
Packit 4b6dd7
Packit 4b6dd7
		/* Even though ‘quotaBytesUsedAggregate’ is documented as long,
Packit 4b6dd7
		 * it is actually a string in the JSON.
Packit 4b6dd7
		 */
Packit 4b6dd7
		val = g_ascii_strtoull (quota_used, &end_ptr, 10);
Packit 4b6dd7
		if (*end_ptr == '\0')
Packit 4b6dd7
			priv->quota_used = (goffset) val;
Packit 4b6dd7
		g_free (quota_used);
Packit 4b6dd7
		return success;
Packit 4b6dd7
	} else if (gdata_parser_string_from_json_member (reader, "quotaType", P_DEFAULT, &quota_type, &success, error) == TRUE) {
Packit 4b6dd7
		if (g_strcmp0 (quota_type, "UNLIMITED") == 0)
Packit 4b6dd7
			priv->quota_unlimited = TRUE;
Packit 4b6dd7
		g_free (quota_type);
Packit 4b6dd7
		return success;
Packit 4b6dd7
	}
Packit 4b6dd7
Packit 4b6dd7
	return GDATA_PARSABLE_CLASS (gdata_documents_metadata_parent_class)->parse_json (parsable, reader, user_data, error);
Packit 4b6dd7
}
Packit 4b6dd7
Packit 4b6dd7
static const gchar *
Packit 4b6dd7
get_content_type (void)
Packit 4b6dd7
{
Packit 4b6dd7
	return "application/json";
Packit 4b6dd7
}
Packit 4b6dd7
Packit 4b6dd7
/**
Packit 4b6dd7
 * gdata_documents_metadata_get_quota_total:
Packit 4b6dd7
 * @self: a #GDataDocumentsMetadata
Packit 4b6dd7
 *
Packit 4b6dd7
 * Gets the #GDataDocumentsMetadata:quota-total property.
Packit 4b6dd7
 *
Packit 4b6dd7
 * Return value: the number of quota bytes available in total. Returns -1 if
Packit 4b6dd7
 *               there is no quota limit.
Packit 4b6dd7
 *
Packit 4b6dd7
 * Since: 0.17.9
Packit 4b6dd7
 */
Packit 4b6dd7
goffset
Packit 4b6dd7
gdata_documents_metadata_get_quota_total (GDataDocumentsMetadata *self)
Packit 4b6dd7
{
Packit 4b6dd7
	g_return_val_if_fail (GDATA_IS_DOCUMENTS_METADATA (self), 0);
Packit 4b6dd7
Packit 4b6dd7
	if (self->priv->quota_unlimited)
Packit 4b6dd7
		return -1;
Packit 4b6dd7
	else
Packit 4b6dd7
		return self->priv->quota_total;
Packit 4b6dd7
}
Packit 4b6dd7
Packit 4b6dd7
/**
Packit 4b6dd7
 * gdata_documents_metadata_get_quota_used:
Packit 4b6dd7
 * @self: a #GDataDocumentsMetadata
Packit 4b6dd7
 *
Packit 4b6dd7
 * Gets the #GDataDocumentsMetadata:quota-used property.
Packit 4b6dd7
 *
Packit 4b6dd7
 * Return value: the number of quota bytes used by the documents service
Packit 4b6dd7
 *
Packit 4b6dd7
 * Since: 0.17.9
Packit 4b6dd7
 */
Packit 4b6dd7
goffset
Packit 4b6dd7
gdata_documents_metadata_get_quota_used (GDataDocumentsMetadata *self)
Packit 4b6dd7
{
Packit 4b6dd7
	g_return_val_if_fail (GDATA_IS_DOCUMENTS_METADATA (self), 0);
Packit 4b6dd7
Packit 4b6dd7
	return self->priv->quota_used;
Packit 4b6dd7
}