pidgin/pidgin

Make user interfaces setup the default history adapter.

2021-10-18, Gary Kramlich
755e1554051c
Make user interfaces setup the default history adapter.

This helps avoid some issues with the unit tests as well as gives us more
flexibility in the future.

Testing Done:
Ran the unit tests without issue. Ran Pidgin 3 with no existing config directory and verified that `history.db` was created properly.

Reviewed at https://reviews.imfreedom.org/r/1033/
/*
* Purple - Internet Messaging Library
* Copyright (C) Pidgin Developers <devel@pidgin.im>
*
* Purple is the legal property of its developers, whose names are too numerous
* to list here. Please refer to the COPYRIGHT file distributed with this
* source distribution.
*
* This program is free software; you can redistribute it and/or modify
* it under the terms of the GNU General Public License as published by
* the Free Software Foundation; either version 2 of the License, or
* (at your option) any later version.
*
* This program 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 General Public License for more details.
*
* You should have received a copy of the GNU General Public License
* along with this program; if not, see <https://www.gnu.org/licenses/>.
*/
#if !defined(PURPLE_GLOBAL_HEADER_INSIDE) && !defined(PURPLE_COMPILATION)
# error "only <purple.h> may be included directly"
#endif
#ifndef PURPLE_UI_INFO_H
#define PURPLE_UI_INFO_H
/**
* SECTION:purpleuiinfo
* @section_id: libpurple-ui-info
* @short_description: User Interface Information
* @title: A simple class that contains information about a user interface.
*
* #PurpleUiInfo keeps track of basic information about the user interface.
*/
#include <glib.h>
#include <glib-object.h>
G_BEGIN_DECLS
/**
* PURPLE_TYPE_UI_INFO:
*
* The standard _get_type macro for #PurpleUiInfo.
*/
#define PURPLE_TYPE_UI_INFO (purple_ui_info_get_type())
G_DECLARE_FINAL_TYPE(PurpleUiInfo, purple_ui_info, PURPLE, UI_INFO, GObject)
/**
* purple_ui_info_new:
* @name: The name.
* @version: The version.
* @website: The website.
* @support_website: The support website.
* @client_type: The client type.
*
* Creates a new #PurpleUiInfo with the given values. If you only want to set
* a few of these, you should use g_object_new() directly.
*
* Returns: (transfer full): The newly created #PurpleUiInfo instance.
*
* Since: 3.0.0
*/
PurpleUiInfo *purple_ui_info_new(const gchar *name,
const gchar *version,
const gchar *website,
const gchar *support_website,
const gchar *client_type);
/**
* purple_ui_info_get_name:
* @info: The #PurpleUiInfo instance.
*
* Gets the name from @info.
*
* Returns: The name from @info.
*
* Since: 3.0.0
*/
const gchar *purple_ui_info_get_name(PurpleUiInfo *info);
/**
* purple_ui_info_get_version:
* @info: The #PurpleUiInfo instance.
*
* Gets the version from @info.
*
* Returns: The version from @info.
*
* Since: 3.0.0
*/
const gchar *purple_ui_info_get_version(PurpleUiInfo *info);
/**
* purple_ui_info_get_website:
* @info: The #PurpleUiInfo instance.
*
* Gets the website from @info.
*
* Returns: The website for @info.
*
* Since: 3.0.0
*/
const gchar *purple_ui_info_get_website(PurpleUiInfo *info);
/**
* purple_ui_info_get_support_website:
* @info: The #PurpleUiInfo instance.
*
* Gets the support website from @info.
*
* Returns: The support website from @info.
*
* Since: 3.0.0
*/
const gchar *purple_ui_info_get_support_website(PurpleUiInfo *info);
/**
* purple_ui_info_get_client_type:
* @info: The #PurpleUiInfo instance.
*
* Gets the client type from @info. For example: 'bot', 'console', 'mobile',
* 'pc', 'web', etc.
*
* Returns: The client type of @info.
*
* Since: 3.0.0
*/
const gchar *purple_ui_info_get_client_type(PurpleUiInfo *info);
G_END_DECLS
#endif /* PURPLE_UI_INFO_H */