* @file cmds.c Commands API /* Copyright (C) 2003-2004 Timothy Ringenbach <omarvo@hotmail.com * 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, write to the Free Software * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02111-1301 USA static GList *cmds = NULL; static guint next_id = 1; typedef struct _PurpleCmd { PurpleCmdPriority priority; static gint cmds_compare_func(const PurpleCmd *a, const PurpleCmd *b) if (a->priority > b->priority) else if (a->priority < b->priority) PurpleCmdId purple_cmd_register(const gchar *cmd, const gchar *args, PurpleCmdPriority p, PurpleCmdFlag f, const gchar *prpl_id, PurpleCmdFunc func, const gchar *helpstr, void *data) g_return_val_if_fail(cmd != NULL && *cmd != '\0', 0); g_return_val_if_fail(args != NULL, 0); g_return_val_if_fail(func != NULL, 0); c = g_new0(PurpleCmd, 1); c->args = g_strdup(args); c->prpl_id = g_strdup(prpl_id); c->help = g_strdup(helpstr); cmds = g_list_insert_sorted(cmds, c, (GCompareFunc)cmds_compare_func); purple_signal_emit(purple_cmds_get_handle(), "cmd-added", cmd, p, f); static void purple_cmd_free(PurpleCmd *c) void purple_cmd_unregister(PurpleCmdId id) for (l = cmds; l; l = l->next) { cmds = g_list_remove(cmds, c); purple_signal_emit(purple_cmds_get_handle(), "cmd-removed", c->cmd); * This sets args to a NULL-terminated array of strings. It should * be freed using g_strfreev(). static gboolean purple_cmd_parse_args(PurpleCmd *cmd, const gchar *s, const gchar *m, gchar ***args) *args = g_new0(char *, strlen(cmd->args) + 1); for (i = 0; cmd->args[i]; i++) { return (cmd->flags & PURPLE_CMD_FLAG_ALLOW_WRONG_ARGS); if (!(end = strchr(cur, ' '))) { (*args)[i] = g_strndup(cur, end - cur); (*args)[i] = g_strndup(cur, end - cur); if (!(end = strchr(cur, ' '))) { (*args)[i] = purple_markup_slice(m, g_utf8_pointer_to_offset(s, cur), g_utf8_pointer_to_offset(s, end)); (*args)[i] = purple_markup_slice(m, g_utf8_pointer_to_offset(s, cur), g_utf8_pointer_to_offset(s, end)); (*args)[i] = g_strdup(cur); (*args)[i] = purple_markup_slice(m, g_utf8_pointer_to_offset(s, cur), g_utf8_strlen(cur, -1) + 1); return (cmd->flags & PURPLE_CMD_FLAG_ALLOW_WRONG_ARGS); static void purple_cmd_strip_current_char(gunichar c, char *s, guint len) bytes = g_unichar_to_utf8(c, NULL); memmove(s, s + bytes, len + 1 - bytes); static void purple_cmd_strip_cmd_from_markup(char *markup) guint len = strlen(markup); gunichar c = g_utf8_get_char(s); } else if (g_unichar_isspace(c)) { purple_cmd_strip_current_char(c, s, len - (s - markup)); purple_cmd_strip_current_char(c, s, len - (s - markup)); PurpleCmdStatus purple_cmd_do_command(PurpleConversation *conv, const gchar *cmdline, const gchar *markup, gchar **error) gboolean found = FALSE, tried_cmd = FALSE, right_type = FALSE, right_prpl = FALSE; gchar *cmd, *rest, *mrest; PurpleCmdRet ret = PURPLE_CMD_RET_CONTINUE; prpl_id = purple_account_get_protocol_id(purple_conversation_get_account(conv)); if (purple_conversation_get_type(conv) == PURPLE_CONV_TYPE_IM) else if (purple_conversation_get_type(conv) == PURPLE_CONV_TYPE_CHAT) return PURPLE_CMD_STATUS_FAILED; rest = strchr(cmdline, ' '); cmd = g_strndup(cmdline, rest - cmdline); mrest = g_strdup(markup); purple_cmd_strip_cmd_from_markup(mrest); for (l = cmds; l; l = l->next) { if (!purple_strequal(c->cmd, cmd)) if (!(c->flags & PURPLE_CMD_FLAG_IM)) if (!(c->flags & PURPLE_CMD_FLAG_CHAT)) if ((c->flags & PURPLE_CMD_FLAG_PRPL_ONLY) && !purple_strequal(c->prpl_id, prpl_id)) /* this checks the allow bad args flag for us */ if (!purple_cmd_parse_args(c, rest, mrest, &args)) { ret = c->func(conv, cmd, args, &err, c->data); if (ret == PURPLE_CMD_RET_CONTINUE) { return PURPLE_CMD_STATUS_NOT_FOUND; return PURPLE_CMD_STATUS_WRONG_TYPE; return PURPLE_CMD_STATUS_WRONG_PRPL; return PURPLE_CMD_STATUS_WRONG_ARGS; if (ret == PURPLE_CMD_RET_OK) { return PURPLE_CMD_STATUS_OK; if (ret == PURPLE_CMD_RET_CONTINUE) return PURPLE_CMD_STATUS_NOT_FOUND; return PURPLE_CMD_STATUS_FAILED; GList *purple_cmd_list(PurpleConversation *conv) for (l = cmds; l; l = l->next) { if (conv && (purple_conversation_get_type(conv) == PURPLE_CONV_TYPE_IM)) if (!(c->flags & PURPLE_CMD_FLAG_IM)) if (conv && (purple_conversation_get_type(conv) == PURPLE_CONV_TYPE_CHAT)) if (!(c->flags & PURPLE_CMD_FLAG_CHAT)) if (conv && (c->flags & PURPLE_CMD_FLAG_PRPL_ONLY) && !purple_strequal(c->prpl_id, purple_account_get_protocol_id(purple_conversation_get_account(conv)))) ret = g_list_append(ret, c->cmd); ret = g_list_sort(ret, (GCompareFunc)strcmp); GList *purple_cmd_help(PurpleConversation *conv, const gchar *cmd) for (l = cmds; l; l = l->next) { if (cmd && !purple_strequal(cmd, c->cmd)) if (conv && (purple_conversation_get_type(conv) == PURPLE_CONV_TYPE_IM)) if (!(c->flags & PURPLE_CMD_FLAG_IM)) if (conv && (purple_conversation_get_type(conv) == PURPLE_CONV_TYPE_CHAT)) if (!(c->flags & PURPLE_CMD_FLAG_CHAT)) if (conv && (c->flags & PURPLE_CMD_FLAG_PRPL_ONLY) && !purple_strequal(c->prpl_id, purple_account_get_protocol_id(purple_conversation_get_account(conv)))) ret = g_list_append(ret, c->help); ret = g_list_sort(ret, (GCompareFunc)strcmp); gpointer purple_cmds_get_handle(void) void purple_cmds_init(void) gpointer handle = purple_cmds_get_handle(); purple_signal_register(handle, "cmd-added", purple_marshal_VOID__POINTER_INT_INT, NULL, 3, purple_value_new(PURPLE_TYPE_STRING), purple_value_new(PURPLE_TYPE_INT), purple_value_new(PURPLE_TYPE_INT)); purple_signal_register(handle, "cmd-removed", purple_marshal_VOID__POINTER, NULL, 1, purple_value_new(PURPLE_TYPE_STRING)); void purple_cmds_uninit(void) purple_signals_unregister_by_instance(purple_cmds_get_handle());