/* -*- Mode: C; indent-tabs-mode: t; c-basic-offset: 8; tab-width: 8 -*- */ /* * GData Client * Copyright (C) Philip Withnall 2008-2009 * * GData Client is free software; you can redistribute it and/or * modify it under the terms of the GNU Lesser General Public * License as published by the Free Software Foundation; either * version 2.1 of the License, or (at your option) any later version. * * GData Client is distributed in the hope that it will be useful, * but WITHOUT ANY WARRANTY; without even the implied warranty of * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU * Lesser General Public License for more details. * * You should have received a copy of the GNU Lesser General Public * License along with GData Client. If not, see . */ #include #include #include #include #ifndef GDATA_PRIVATE_H #define GDATA_PRIVATE_H G_BEGIN_DECLS /** * GDataLogLevel: * @GDATA_LOG_NONE: Output no debug messages or network logs * @GDATA_LOG_MESSAGES: Output debug messages, but not network logs * @GDATA_LOG_HEADERS: Output debug messages and network traffic headers * @GDATA_LOG_FULL: Output debug messages and full network traffic logs, * redacting usernames, passwords and auth. tokens * @GDATA_LOG_FULL_UNREDACTED: Output debug messages and full network traffic * logs, and don't redact usernames, passwords and auth. tokens * * Logging level. */ typedef enum { GDATA_LOG_NONE = 0, GDATA_LOG_MESSAGES = 1, GDATA_LOG_HEADERS = 2, GDATA_LOG_FULL = 3, GDATA_LOG_FULL_UNREDACTED = 4, } GDataLogLevel; #include "gdata-service.h" G_GNUC_INTERNAL SoupSession *_gdata_service_get_session (GDataService *self) G_GNUC_PURE; G_GNUC_INTERNAL SoupMessage *_gdata_service_build_message (GDataService *self, GDataAuthorizationDomain *domain, const gchar *method, const gchar *uri, const gchar *etag, gboolean etag_if_match); G_GNUC_INTERNAL void _gdata_service_actually_send_message (SoupSession *session, SoupMessage *message, GCancellable *cancellable, GError **error); G_GNUC_INTERNAL guint _gdata_service_send_message (GDataService *self, SoupMessage *message, GCancellable *cancellable, GError **error); G_GNUC_INTERNAL SoupMessage *_gdata_service_query (GDataService *self, GDataAuthorizationDomain *domain, const gchar *feed_uri, GDataQuery *query, GCancellable *cancellable, GError **error) G_GNUC_WARN_UNUSED_RESULT G_GNUC_MALLOC; G_GNUC_INTERNAL const gchar *_gdata_service_get_scheme (void) G_GNUC_CONST; G_GNUC_INTERNAL gchar *_gdata_service_build_uri (const gchar *format, ...) G_GNUC_PRINTF (1, 2) G_GNUC_WARN_UNUSED_RESULT G_GNUC_MALLOC; G_GNUC_INTERNAL guint _gdata_service_get_https_port (void); G_GNUC_INTERNAL gchar *_gdata_service_fix_uri_scheme (const gchar *uri) G_GNUC_WARN_UNUSED_RESULT G_GNUC_MALLOC; G_GNUC_INTERNAL GDataLogLevel _gdata_service_get_log_level (void) G_GNUC_CONST; G_GNUC_INTERNAL SoupSession *_gdata_service_build_session (void) G_GNUC_WARN_UNUSED_RESULT G_GNUC_MALLOC; typedef gchar *GDataSecureString; typedef const gchar *GDataConstSecureString; G_GNUC_INTERNAL GDataSecureString _gdata_service_secure_strdup (const gchar *str) G_GNUC_WARN_UNUSED_RESULT G_GNUC_MALLOC; G_GNUC_INTERNAL GDataSecureString _gdata_service_secure_strndup (const gchar *str, gsize n_bytes) G_GNUC_WARN_UNUSED_RESULT G_GNUC_MALLOC; G_GNUC_INTERNAL void _gdata_service_secure_strfree (GDataSecureString str); #include "gdata-query.h" typedef enum { GDATA_QUERY_PAGINATION_INDEXED, GDATA_QUERY_PAGINATION_URIS, GDATA_QUERY_PAGINATION_TOKENS, } GDataQueryPaginationType; G_GNUC_INTERNAL void _gdata_query_add_q_internal (GDataQuery *self, const gchar *q); G_GNUC_INTERNAL void _gdata_query_clear_q_internal (GDataQuery *self); G_GNUC_INTERNAL void _gdata_query_clear_pagination (GDataQuery *self); G_GNUC_INTERNAL void _gdata_query_set_pagination_type (GDataQuery *self, GDataQueryPaginationType type); G_GNUC_INTERNAL void _gdata_query_set_next_page_token (GDataQuery *self, const gchar *next_page_token); G_GNUC_INTERNAL void _gdata_query_set_next_uri (GDataQuery *self, const gchar *next_uri); G_GNUC_INTERNAL gboolean _gdata_query_is_finished (GDataQuery *self); G_GNUC_INTERNAL void _gdata_query_set_previous_uri (GDataQuery *self, const gchar *previous_uri); #include "gdata-parsable.h" G_GNUC_INTERNAL GDataParsable *_gdata_parsable_new_from_xml (GType parsable_type, const gchar *xml, gint length, gpointer user_data, GError **error) G_GNUC_WARN_UNUSED_RESULT G_GNUC_MALLOC; G_GNUC_INTERNAL GDataParsable *_gdata_parsable_new_from_xml_node (GType parsable_type, xmlDoc *doc, xmlNode *node, gpointer user_data, GError **error) G_GNUC_WARN_UNUSED_RESULT G_GNUC_MALLOC; G_GNUC_INTERNAL GDataParsable *_gdata_parsable_new_from_json (GType parsable_type, const gchar *json, gint length, gpointer user_data, GError **error) G_GNUC_WARN_UNUSED_RESULT G_GNUC_MALLOC; G_GNUC_INTERNAL GDataParsable *_gdata_parsable_new_from_json_node (GType parsable_type, JsonReader *reader, gpointer user_data, GError **error) G_GNUC_WARN_UNUSED_RESULT G_GNUC_MALLOC; G_GNUC_INTERNAL void _gdata_parsable_get_xml (GDataParsable *self, GString *xml_string, gboolean declare_namespaces); G_GNUC_INTERNAL void _gdata_parsable_get_json (GDataParsable *self, JsonBuilder *builder); G_GNUC_INTERNAL void _gdata_parsable_string_append_escaped (GString *xml_string, const gchar *pre, const gchar *element_content, const gchar *post); G_GNUC_INTERNAL gboolean _gdata_parsable_is_constructed_from_xml (GDataParsable *self); #include "gdata-feed.h" G_GNUC_INTERNAL GDataFeed *_gdata_feed_new (GType feed_type, const gchar *title, const gchar *id, gint64 updated) G_GNUC_WARN_UNUSED_RESULT; G_GNUC_INTERNAL GDataFeed *_gdata_feed_new_from_xml (GType feed_type, const gchar *xml, gint length, GType entry_type, GDataQueryProgressCallback progress_callback, gpointer progress_user_data, GError **error) G_GNUC_WARN_UNUSED_RESULT G_GNUC_MALLOC; G_GNUC_INTERNAL GDataFeed *_gdata_feed_new_from_json (GType feed_type, const gchar *json, gint length, GType entry_type, GDataQueryProgressCallback progress_callback, gpointer progress_user_data, GError **error) G_GNUC_WARN_UNUSED_RESULT G_GNUC_MALLOC; G_GNUC_INTERNAL void _gdata_feed_add_entry (GDataFeed *self, GDataEntry *entry); G_GNUC_INTERNAL void _gdata_feed_add_link (GDataFeed *self, GDataLink *_link); G_GNUC_INTERNAL gpointer _gdata_feed_parse_data_new (GType entry_type, GDataQueryProgressCallback progress_callback, gpointer progress_user_data); G_GNUC_INTERNAL void _gdata_feed_parse_data_free (gpointer data); G_GNUC_INTERNAL void _gdata_feed_call_progress_callback (GDataFeed *self, gpointer user_data, GDataEntry *entry); G_GNUC_INTERNAL void _gdata_feed_set_page_info (GDataFeed *self, guint total_results, guint items_per_page); #include "gdata-entry.h" #include "gdata-batch-operation.h" G_GNUC_INTERNAL void _gdata_entry_set_updated (GDataEntry *self, gint64 updated); G_GNUC_INTERNAL void _gdata_entry_set_published (GDataEntry *self, gint64 published); G_GNUC_INTERNAL void _gdata_entry_set_id (GDataEntry *self, const gchar *id); G_GNUC_INTERNAL void _gdata_entry_set_etag (GDataEntry *self, const gchar *etag); G_GNUC_INTERNAL void _gdata_entry_set_batch_data (GDataEntry *self, guint id, GDataBatchOperationType type); #include "gdata-access-rule.h" G_GNUC_INTERNAL void _gdata_access_rule_set_key (GDataAccessRule *self, const gchar *key); #include "gdata-parser.h" /** * _GDATA_DEFINE_AUTHORIZATION_DOMAIN: * @l_n: lowercase name for the authorization domain, separated by underscores * @SERVICE_NAME: the service name, as listed here: http://code.google.com/apis/documents/faq_gdata.html#clientlogin * @SCOPE: the scope URI, as listed here: http://code.google.com/apis/documents/faq_gdata.html#AuthScopes * * Defines a static function to return an interned singleton #GDataAuthorizationDomain instance for the given parameters. Every time it's called, the * function will return the same instance. * * The function will be named get_(l_n)_authorization_domain. * * Return value: (transfer none): a #GDataAuthorizationDomain instance for the given parameters * * Since: 0.9.0 */ #define _GDATA_DEFINE_AUTHORIZATION_DOMAIN(l_n, SERVICE_NAME, SCOPE) \ static GDataAuthorizationDomain * \ get_##l_n##_authorization_domain (void) \ { \ static volatile GDataAuthorizationDomain *domain__volatile = NULL; \ \ if (g_once_init_enter (&domain__volatile) == TRUE) { \ GDataAuthorizationDomain *domain; \ \ domain = g_object_new (GDATA_TYPE_AUTHORIZATION_DOMAIN, \ "service-name", SERVICE_NAME, \ "scope", SCOPE, \ NULL); \ \ g_once_init_leave (&domain__volatile, domain); \ } \ \ return GDATA_AUTHORIZATION_DOMAIN (domain__volatile); \ } G_END_DECLS #endif /* !GDATA_PRIVATE_H */