libpurple/purpleprotocolfiletransfer.c

Sun, 10 Aug 2025 23:44:08 +0800

author
Gong Zhile <gongzl@stu.hebust.edu.cn>
date
Sun, 10 Aug 2025 23:44:08 +0800
branch
purple_conversation_find_message_by_id
changeset 43309
099e1dfb856b
parent 42821
4032fe617b2a
permissions
-rw-r--r--

Add Purple.Conversation.find_message_by_id

The method was added so that a protocol or plugin could easily lookup
for the reference for a message. This will be especially useful when a
protocol received a quoted message but only with an id.

/*
 * 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 library 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 library 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 library; if not, see <https://www.gnu.org/licenses/>.
 */

#include "purpleprotocolfiletransfer.h"

/******************************************************************************
 * GInterface Implementation
 *****************************************************************************/
G_DEFINE_INTERFACE(PurpleProtocolFileTransfer, purple_protocol_file_transfer,
                   PURPLE_TYPE_PROTOCOL)

static void
purple_protocol_file_transfer_default_init(G_GNUC_UNUSED PurpleProtocolFileTransferInterface *iface)
{
}

/******************************************************************************
 * Public API
 *****************************************************************************/
void
purple_protocol_file_transfer_send_async(PurpleProtocolFileTransfer *protocol,
                                         PurpleFileTransfer *transfer,
                                         GAsyncReadyCallback callback,
                                         gpointer data)
{
	PurpleProtocolFileTransferInterface *iface = NULL;

	g_return_if_fail(PURPLE_IS_PROTOCOL_FILE_TRANSFER(protocol));

	iface = PURPLE_PROTOCOL_FILE_TRANSFER_GET_IFACE(protocol);
	if(iface != NULL && iface->send_async != NULL) {
		iface->send_async(protocol, transfer, callback, data);
	} else {
		g_task_report_new_error(G_OBJECT(protocol), callback, data,
		                        purple_protocol_file_transfer_send_async,
		                        PURPLE_PROTOCOL_FILE_TRANSFER_ERROR, 0,
		                        "%s does not implement send_async",
		                        G_OBJECT_TYPE_NAME(protocol));
	}
}

gboolean
purple_protocol_file_transfer_send_finish(PurpleProtocolFileTransfer *protocol,
                                          GAsyncResult *result,
                                          GError **error)
{
	PurpleProtocolFileTransferInterface *iface = NULL;

	g_return_val_if_fail(PURPLE_IS_PROTOCOL_FILE_TRANSFER(protocol), FALSE);
	g_return_val_if_fail(G_IS_ASYNC_RESULT(result), FALSE);

	if(g_async_result_is_tagged(result,
	                            purple_protocol_file_transfer_send_async))
	{
		return g_task_propagate_boolean(G_TASK(result), error);
	}

	iface = PURPLE_PROTOCOL_FILE_TRANSFER_GET_IFACE(protocol);
	if(iface != NULL && iface->send_finish != NULL) {
		return iface->send_finish(protocol, result, error);
	}

	g_warning("purple_protocol_file_transfer_send_finish called without "
	          "calling purple_protocol_file_transfer_send_async");

	return FALSE;
}

void
purple_protocol_file_transfer_receive_async(PurpleProtocolFileTransfer *protocol,
                                            PurpleFileTransfer *transfer,
                                            GAsyncReadyCallback callback,
                                            gpointer data)
{
	PurpleProtocolFileTransferInterface *iface = NULL;

	g_return_if_fail(PURPLE_IS_PROTOCOL_FILE_TRANSFER(protocol));

	iface = PURPLE_PROTOCOL_FILE_TRANSFER_GET_IFACE(protocol);
	if(iface != NULL && iface->receive_async != NULL) {
		iface->receive_async(protocol, transfer, callback, data);
	} else {
		g_task_report_new_error(G_OBJECT(protocol), callback, data,
		                        purple_protocol_file_transfer_receive_async,
		                        PURPLE_PROTOCOL_FILE_TRANSFER_ERROR, 0,
		                        "%s does not implement receive_async",
		                        G_OBJECT_TYPE_NAME(protocol));
	}
}

gboolean
purple_protocol_file_transfer_receive_finish(PurpleProtocolFileTransfer *protocol,
                                             GAsyncResult *result,
                                             GError **error)
{
	PurpleProtocolFileTransferInterface *iface = NULL;

	g_return_val_if_fail(PURPLE_IS_PROTOCOL_FILE_TRANSFER(protocol), FALSE);
	g_return_val_if_fail(G_IS_ASYNC_RESULT(result), FALSE);

	if(g_async_result_is_tagged(result,
	                            purple_protocol_file_transfer_receive_async))
	{
		return g_task_propagate_boolean(G_TASK(result), error);
	}

	iface = PURPLE_PROTOCOL_FILE_TRANSFER_GET_IFACE(protocol);
	if(iface != NULL && iface->receive_finish != NULL) {
		return iface->receive_finish(protocol, result, error);
	}

	g_warning("purple_protocol_file_transfer_receive_finish called without "
	          "calling purple_protocol_file_transfer_receive_async");

	return FALSE;
}

mercurial