1
0
mirror of https://github.com/weechat/weechat.git synced 2026-07-06 21:45:42 +02:00

api: allow to catch multiple signals in functions hook_signal and hook_hsignal (closes #1780)

This commit is contained in:
Sébastien Helleu
2022-04-24 21:37:38 +02:00
parent f69ef840e0
commit b7f3127bf8
14 changed files with 226 additions and 199 deletions
+1
View File
@@ -23,6 +23,7 @@ New features::
* core: add bar item "spacer" (issue #1700)
* core: add case conversion in evaluation of expressions with `lower:string` and `upper:string` (issue #1778)
* core: move detailed list of hooks from command `/plugin listfull` to `/debug hooks <plugin>`
* api: allow to catch multiple signals in functions hook_signal and hook_hsignal (issue #1780)
Bug fixes::
+10 -8
View File
@@ -10282,7 +10282,7 @@ hook = weechat.hook_print("", "", "", 1, "my_print_cb", "")
==== hook_signal
_Updated in 1.5._
_Updated in 1.5, 3.6._
Hook a signal.
@@ -10302,7 +10302,8 @@ struct t_hook *weechat_hook_signal (const char *signal,
Arguments:
* _signal_: signal to catch, wildcard `+*+` is allowed
* _signal_: signal to catch, wildcard `+*+` is allowed; multiple signals can
be separated by semi-colons
(priority allowed, see note about <<hook_priority,priority>>)
(see table below)
* _callback_: function called when signal is received, arguments and return
@@ -10982,8 +10983,8 @@ my_signal_cb (const void *pointer, void *data, const char *signal,
return WEECHAT_RC_OK;
}
/* catch signal "quit" */
struct t_hook *my_signal_hook = weechat_hook_signal ("quit",
/* catch signals "quit" and "upgrade" */
struct t_hook *my_signal_hook = weechat_hook_signal ("quit;upgrade",
&my_signal_cb, NULL, NULL);
----
@@ -10999,8 +11000,8 @@ def my_signal_cb(data, signal, signal_data):
# ...
return weechat.WEECHAT_RC_OK
# catch signal "quit"
hook = weechat.hook_signal("quit", "my_signal_cb", "")
# catch signals "quit" and "upgrade"
hook = weechat.hook_signal("quit;upgrade", "my_signal_cb", "")
----
==== hook_signal_send
@@ -11204,7 +11205,7 @@ weechat.hook_signal_send("irc_input_send", weechat.WEECHAT_HOOK_SIGNAL_STRING,
==== hook_hsignal
_WeeChat ≥ 0.3.4, updated in 1.5._
_WeeChat ≥ 0.3.4, updated in 1.5, 3.6._
Hook a hsignal (signal with hashtable).
@@ -11223,7 +11224,8 @@ struct t_hook *weechat_hook_hsignal (const char *signal,
Arguments:
* _signal_: signal to catch, wildcard `+*+` is allowed
* _signal_: signal to catch, wildcard `+*+` is allowed; multiple signals can
be separated by semi-colons
(priority allowed, see note about <<hook_priority,priority>>)
(see table below)
* _callback_: function called when signal is received, arguments and return
+10 -8
View File
@@ -10487,7 +10487,7 @@ hook = weechat.hook_print("", "", "", 1, "my_print_cb", "")
==== hook_signal
_Mis à jour dans la 1.5._
_Mis à jour dans la 1.5, 3.6._
S'accrocher à un signal.
@@ -10507,7 +10507,8 @@ struct t_hook *weechat_hook_signal (const char *signal,
Paramètres :
* _signal_ : signal à intercepter, le caractère joker `+*+` est autorisé
* _signal_ : signal à intercepter, le caractère joker `+*+` est autorisé,
plusieurs signaux peuvent être séparés par des point-virgules
(priorité autorisée, voir la note sur la <<hook_priority,priorité>>)
(voir le tableau ci-dessous)
* _callback_ : fonction appelée quand le signal est reçu, paramètres et valeur
@@ -11201,8 +11202,8 @@ my_signal_cb (const void *pointer, void *data, const char *signal,
return WEECHAT_RC_OK;
}
/* intercepter le signal "quit" */
struct t_hook *my_signal_hook = weechat_hook_signal ("quit",
/* intercepter les signaux "quit" et "upgrade" */
struct t_hook *my_signal_hook = weechat_hook_signal ("quit;upgrade",
&my_signal_cb, NULL, NULL);
----
@@ -11218,8 +11219,8 @@ def my_signal_cb(data, signal, signal_data):
# ...
return weechat.WEECHAT_RC_OK
# intercepter le signal "quit"
hook = weechat.hook_signal("quit", "my_signal_cb", "")
# intercepter les signaux "quit" et "upgrade"
hook = weechat.hook_signal("quit;upgrade", "my_signal_cb", "")
----
==== hook_signal_send
@@ -11431,7 +11432,7 @@ weechat.hook_signal_send("irc_input_send", weechat.WEECHAT_HOOK_SIGNAL_STRING,
==== hook_hsignal
_WeeChat ≥ 0.3.4, mis à jour dans la 1.5._
_WeeChat ≥ 0.3.4, mis à jour dans la 1.5, 3.6._
S'accrocher à un hsignal (signal avec une table de hachage).
@@ -11450,7 +11451,8 @@ struct t_hook *weechat_hook_hsignal (const char *signal,
Paramètres :
* _signal_ : signal à intercepter, le caractère joker `+*+` est autorisé
* _signal_ : signal à intercepter, le caractère joker `+*+` est autorisé,
plusieurs signaux peuvent être séparés par des point-virgules
(priorité autorisée, voir la note sur la <<hook_priority,priorité>>)
(voir le tableau ci-dessous)
* _callback_ : fonction appelée quand le signal est reçu, paramètres et valeur
+12 -8
View File
@@ -10610,7 +10610,7 @@ hook = weechat.hook_print("", "", "", 1, "my_print_cb", "")
==== hook_signal
// TRANSLATION MISSING
_Updated in 1.5._
_Updated in 1.5, 3.6._
Hook su un segnale.
@@ -10631,7 +10631,8 @@ struct t_hook *weechat_hook_signal (const char *signal,
Argomenti:
// TRANSLATION MISSING
* _signal_: segnale da catturare, wildcard `+*+` is allowed
* _signal_: segnale da catturare, wildcard `+*+` is allowed, multiple signals
can be separated by semi-colons
(priorità consentita, consultare la nota riguardo la
<<hook_priority,priority>>), see table below
* _callback_: funzione chiamata a segnale ricevuto, argomenti e valore
@@ -11402,6 +11403,7 @@ List of signals sent by WeeChat and plugins:
Esempio in C:
// TRANSLATION MISSING
[source,c]
----
int
@@ -11412,13 +11414,14 @@ my_signal_cb (const void *pointer, void *data, const char *signal,
return WEECHAT_RC_OK;
}
/* cattura il segnale "quit" */
struct t_hook *my_signal_hook = weechat_hook_signal ("quit",
/* catch signals "quit" and "upgrade" */
struct t_hook *my_signal_hook = weechat_hook_signal ("quit;upgrade",
&my_signal_cb, NULL, NULL);
----
Script (Python):
// TRANLSATION MISSING
[source,python]
----
# prototipo
@@ -11429,8 +11432,8 @@ def my_signal_cb(data, signal, signal_data):
# ...
return weechat.WEECHAT_RC_OK
# cattura il segnale "quit"
hook = weechat.hook_signal("quit", "my_signal_cb", "")
# catch signals "quit" and "upgrade"
hook = weechat.hook_signal("quit;upgrade", "my_signal_cb", "")
----
==== hook_signal_send
@@ -11648,7 +11651,7 @@ weechat.hook_signal_send("irc_input_send", weechat.WEECHAT_HOOK_SIGNAL_STRING,
==== hook_hsignal
_WeeChat ≥ 0.3.4, updated in 1.5._
_WeeChat ≥ 0.3.4, updated in 1.5, 3.6._
Hook su hsignal (segnale con tabella hash).
@@ -11668,7 +11671,8 @@ struct t_hook *weechat_hook_hsignal (const char *signal,
Argomenti:
// TRANSLATION MISSING
* _signal_: segnale da catturare, wildcard `+*+` is allowed
* _signal_: segnale da catturare, wildcard `+*+` is allowed, multiple signals can
be separated by semi-colons
(priorità consentita, consultare la nota a proposito di <<hook_priority,priority>>),
see table below
* _callback_: funzione chiamata a segnale ricevuto, argomenti e valore
+12 -8
View File
@@ -10311,7 +10311,7 @@ hook = weechat.hook_print("", "", "", 1, "my_print_cb", "")
==== hook_signal
_WeeChat バージョン 1.5 で更新。_
_WeeChat バージョン 1.5, 3.6 で更新。_
シグナルをフックする。
@@ -10331,7 +10331,9 @@ struct t_hook *weechat_hook_signal (const char *signal,
引数:
* _signal_: キャッチするシグナル、ワイルドカード `+*+` を使うことができます
// TRANSLATION MISSING
* _signal_: キャッチするシグナル、ワイルドカード `+*+` を使うことができます,
multiple signals can be separated by semi-colons
(優先度の設定が可能、<<hook_priority,フックの優先度>>に関する注意を参照)
(以下の表を参照)
* _callback_:
@@ -11024,8 +11026,8 @@ my_signal_cb (const void *pointer, void *data, const char *signal,
return WEECHAT_RC_OK;
}
/* catch signal "quit" */
struct t_hook *my_signal_hook = weechat_hook_signal ("quit",
/* catch signals "quit" and "upgrade" */
struct t_hook *my_signal_hook = weechat_hook_signal ("quit;upgrade",
&my_signal_cb, NULL, NULL);
----
@@ -11041,8 +11043,8 @@ def my_signal_cb(data, signal, signal_data):
# ...
return weechat.WEECHAT_RC_OK
# catch signal "quit"
hook = weechat.hook_signal("quit", "my_signal_cb", "")
# catch signals "quit" and "upgrade"
hook = weechat.hook_signal("quit;upgrade", "my_signal_cb", "")
----
==== hook_signal_send
@@ -11247,7 +11249,7 @@ weechat.hook_signal_send("irc_input_send", weechat.WEECHAT_HOOK_SIGNAL_STRING,
==== hook_hsignal
_WeeChat バージョン 0.3.4 以上で利用可、バージョン 1.5 で更新。_
_WeeChat バージョン 0.3.4 以上で利用可、バージョン 1.5, 3.6 で更新。_
hsignal (ハッシュテーブルを持つシグナル) をフック。
@@ -11266,7 +11268,9 @@ struct t_hook *weechat_hook_hsignal (const char *signal,
引数:
* _signal_: キャッチするシグナル、ワイルドカード `+*+` を使うことができます
// TRANSLATION MISSING
* _signal_: キャッチするシグナル、ワイルドカード `+*+` を使うことができます,
multiple signals can be separated by semi-colons
(優先度の設定が可能、<<hook_priority,フックの優先度>>に関する注意を参照)
(以下の表を参照)
* _callback_:
+15 -8
View File
@@ -9912,7 +9912,7 @@ hook = weechat.hook_print("", "", "", 1, "my_print_cb", "")
==== hook_signal
_Ажурирано у верзији 1.5._
_Ажурирано у верзији 1.5, 3.6._
Качи се на сигнал.
@@ -9932,7 +9932,10 @@ struct t_hook *weechat_hook_signal (const char *signal,
Аргументи:
* _signal_: сигнал који се хвата, дозвољава се џокер `+*+` (дозвољен је приоритет, погледајте напомену о <<hook_priority,приоритетима>>) (погледајте табелу испод)
// TRANSLATION MISSING
* _signal_: сигнал који се хвата, дозвољава се џокер `+*+`, multiple signals can
be separated by semi-colons
(дозвољен је приоритет, погледајте напомену о <<hook_priority,приоритетима>>) (погледајте табелу испод)
* _callback_: функција која се позива када се прими сигнал, аргументи и повратна вредност су:
** _const void *pointer_: показивач
** _void *data_: показивач
@@ -10596,6 +10599,7 @@ struct t_hook *weechat_hook_signal (const char *signal,
C пример:
// TRANSLATION MISSING
[source,c]
----
int
@@ -10606,13 +10610,14 @@ my_signal_cb (const void *pointer, void *data, const char *signal,
return WEECHAT_RC_OK;
}
/* хвата сигнал "quit" */
struct t_hook *my_signal_hook = weechat_hook_signal ("quit",
/* catch signals "quit" and "upgrade" */
struct t_hook *my_signal_hook = weechat_hook_signal ("quit;upgrade",
&my_signal_cb, NULL, NULL);
----
Скрипта (Python):
// TRANSLATION MISSING
[source,python]
----
# прототип
@@ -10623,8 +10628,8 @@ def my_signal_cb(data, signal, signal_data):
# ...
return weechat.WEECHAT_RC_OK
# хвата сигнал "quit"
hook = weechat.hook_signal("quit", "my_signal_cb", "")
# catch signals "quit" and "upgrade"
hook = weechat.hook_signal("quit;upgrade", "my_signal_cb", "")
----
==== hook_signal_send
@@ -10820,7 +10825,7 @@ weechat.hook_signal_send("irc_input_send", weechat.WEECHAT_HOOK_SIGNAL_STRING,
==== hook_hsignal
_WeeChat ≥ 0.3.4, ажурирано у верзији 1.5._
_WeeChat ≥ 0.3.4, ажурирано у верзији 1.5, 3.6._
Качи се на hsignal (сигнал са хеш табелом).
@@ -10839,7 +10844,9 @@ struct t_hook *weechat_hook_hsignal (const char *signal,
Аргументи:
* _signal_: сигнал који се хвата, дозвољава се џокер `+*+` (дозвољен је приоритет, погледајте напомену о <<hook_priority,приоритетима>>) (погледајте табелу испод)
* _signal_: сигнал који се хвата, дозвољава се џокер `+*+`, multiple signals can
be separated by semi-colons
(дозвољен је приоритет, погледајте напомену о <<hook_priority,приоритетима>>) (погледајте табелу испод)
* _callback_: функција која се позива када се прими сигнал, аргументи и повратна вредност су:
** _const void *pointer_: показивач
** _void *data_: показивач
File diff suppressed because it is too large Load Diff
+4 -2
View File
@@ -32,8 +32,10 @@ typedef int (t_hook_callback_hsignal)(const void *pointer, void *data,
struct t_hook_hsignal
{
t_hook_callback_hsignal *callback; /* signal callback */
char *signal; /* signal selected (may begin or end */
/* with "*", "*" == any signal) */
char **signals; /* signals selected; each one may */
/* begin or end with "*", */
/* "*" == any signal */
int num_signals; /* number of signals */
};
extern char *hook_hsignal_get_description (struct t_hook *hook);
File diff suppressed because it is too large Load Diff
+4 -2
View File
@@ -32,8 +32,10 @@ typedef int (t_hook_callback_signal)(const void *pointer, void *data,
struct t_hook_signal
{
t_hook_callback_signal *callback; /* signal callback */
char *signal; /* signal selected (may begin or end */
/* with "*", "*" == any signal) */
char **signals; /* signals selected; each one may */
/* begin or end with "*", */
/* "*" == any signal */
int num_signals; /* number of signals */
};
extern char *hook_signal_get_description (struct t_hook *hook);
+26 -113
View File
File diff suppressed because it is too large Load Diff
+3 -5
View File
@@ -82,11 +82,9 @@ gui_chat_init ()
}
/* some hsignals */
hook_hsignal (NULL, "chat_quote_time_prefix_message",
&gui_chat_hsignal_quote_line_cb, NULL, NULL);
hook_hsignal (NULL, "chat_quote_prefix_message",
&gui_chat_hsignal_quote_line_cb, NULL, NULL);
hook_hsignal (NULL, "chat_quote_message",
hook_hsignal (NULL,
"chat_quote_time_prefix_message;chat_quote_prefix_message;"
"chat_quote_message",
&gui_chat_hsignal_quote_line_cb, NULL, NULL);
}
+1 -3
View File
@@ -1307,9 +1307,7 @@ weechat_plugin_init (struct t_weechat_plugin *plugin, int argc, char *argv[])
plugin_script_display_short_list (weechat_perl_plugin,
perl_scripts);
weechat_hook_signal ("quit",
&weechat_perl_signal_quit_upgrade_cb, NULL, NULL);
weechat_hook_signal ("upgrade",
weechat_hook_signal ("quit;upgrade",
&weechat_perl_signal_quit_upgrade_cb, NULL, NULL);
/* init OK */
+12 -18
View File
@@ -301,34 +301,28 @@ trigger_hook (struct t_trigger *trigger)
case TRIGGER_HOOK_SIGNAL:
if (argv && (argc >= 1))
{
trigger->hooks = malloc (argc * sizeof (trigger->hooks[0]));
trigger->hooks = malloc (sizeof (trigger->hooks[0]));
if (trigger->hooks)
{
trigger->hooks_count = argc;
for (i = 0; i < argc; i++)
{
trigger->hooks[i] = weechat_hook_signal (
argv[i],
&trigger_callback_signal_cb,
trigger, NULL);
}
trigger->hooks_count = 1;
trigger->hooks[0] = weechat_hook_signal (
weechat_config_string (trigger->options[TRIGGER_OPTION_ARGUMENTS]),
&trigger_callback_signal_cb,
trigger, NULL);
}
}
break;
case TRIGGER_HOOK_HSIGNAL:
if (argv && (argc >= 1))
{
trigger->hooks = malloc (argc * sizeof (trigger->hooks[0]));
trigger->hooks = malloc (sizeof (trigger->hooks[0]));
if (trigger->hooks)
{
trigger->hooks_count = argc;
for (i = 0; i < argc; i++)
{
trigger->hooks[i] = weechat_hook_hsignal (
argv[i],
&trigger_callback_hsignal_cb,
trigger, NULL);
}
trigger->hooks_count = 1;
trigger->hooks[0] = weechat_hook_hsignal (
weechat_config_string (trigger->options[TRIGGER_OPTION_ARGUMENTS]),
&trigger_callback_hsignal_cb,
trigger, NULL);
}
}
break;