grim/pidgin

Add PurpleAccount:connected and PurpleAccount:disconnected signals

13 months ago, Gary Kramlich
a401fa6276ac
Add PurpleAccount:connected and PurpleAccount:disconnected signals

This will be propagated by PurpleAccountManager at a later time, but were
implemented separately.

Testing Done:
Temporarily added `g_warnings` where the signal emissions where to verify they were being emitted.

I didn't add unit tests for this as there's a lot of boiler plate for that which will hopefully be changing soon.

Reviewed at https://reviews.imfreedom.org/r/2439/
/*
* Purple - Internet Messaging Library
* Copyright (C) Pidgin Developers <devel@pidgin.im>
*
* 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/>.
*/
#ifndef PURPLE_IRCV3_CONNECTION_H
#define PURPLE_IRCV3_CONNECTION_H
#include <glib.h>
#include <glib-object.h>
#include <gplugin.h>
#include <gplugin-native.h>
#include <sasl/sasl.h>
#include <purple.h>
G_BEGIN_DECLS
#define PURPLE_IRCV3_TYPE_CONNECTION (purple_ircv3_connection_get_type())
G_DECLARE_DERIVABLE_TYPE(PurpleIRCv3Connection, purple_ircv3_connection,
PURPLE_IRCV3, CONNECTION, PurpleConnection)
#include "purpleircv3capabilities.h"
struct _PurpleIRCv3ConnectionClass {
/*< private >*/
PurpleConnectionClass parent;
/*< private >*/
gpointer reserved[8];
};
G_GNUC_INTERNAL void purple_ircv3_connection_register(GPluginNativePlugin *plugin);
G_GNUC_INTERNAL GCancellable *purple_ircv3_connection_get_cancellable(PurpleIRCv3Connection *connection);
/**
* purple_ircv3_connection_writef:
* @connection: The instance.
* @format: The format string.
* @...: The arguments for @format.
*
* Similar to C `printf()` but writes the format string out to @connection.
*
* This will add the proper line termination, so you do not need to worry about
* that.
*/
void purple_ircv3_connection_writef(PurpleIRCv3Connection *connection, const char *format, ...) G_GNUC_PRINTF(2, 3);
/**
* purple_ircv3_connection_get_capabilities:
* @connection: The instance.
*
* Gets the list of capabilities that the server supplied during registration.
*
* Returns: The list of capabilities that the server supports.
*/
PurpleIRCv3Capabilities *purple_ircv3_connection_get_capabilities(PurpleIRCv3Connection *connection);
/**
* purple_ircv3_connection_get_registered:
* @connection: The instance.
*
* Gets whether or not the connection has finished the registration process.
*
* Returns: %TRUE if registration has been completed otherwise %FALSE.
*
* Since: 3.0.0
*/
gboolean purple_ircv3_connection_get_registered(PurpleIRCv3Connection *connection);
G_END_DECLS
#endif /* PURPLE_IRCV3_CONNECTION_H */