NeoMutt  2024-10-02-37-gfa9146
Teaching an old dog new tricks
DOXYGEN
Loading...
Searching...
No Matches
hook.c
Go to the documentation of this file.
1
37#include "config.h"
38#include <limits.h>
39#include <stdbool.h>
40#include <string.h>
41#include <unistd.h>
42#include "mutt/lib.h"
43#include "address/lib.h"
44#include "config/lib.h"
45#include "email/lib.h"
46#include "core/lib.h"
47#include "alias/lib.h"
48#include "hook.h"
49#include "attach/lib.h"
50#include "compmbox/lib.h"
51#include "expando/lib.h"
52#include "index/lib.h"
53#include "ncrypt/lib.h"
54#include "parse/lib.h"
55#include "pattern/lib.h"
56#include "commands.h"
57#include "globals.h"
58#include "hdrline.h"
59#include "muttlib.h"
60#include "mx.h"
61
62extern const struct ExpandoDefinition IndexFormatDef[];
63
67struct Hook
68{
70 struct Regex regex;
71 char *command;
73 struct PatternList *pattern;
74 struct Expando *expando;
75 TAILQ_ENTRY(Hook) entries;
76};
77TAILQ_HEAD(HookList, Hook);
78
80static struct HookList Hooks = TAILQ_HEAD_INITIALIZER(Hooks);
81
83static struct HashTable *IdxFmtHooks = NULL;
84
87
92static void hook_free(struct Hook **ptr)
93{
94 if (!ptr || !*ptr)
95 return;
96
97 struct Hook *h = *ptr;
98
99 FREE(&h->command);
100 FREE(&h->source_file);
101 FREE(&h->regex.pattern);
102 if (h->regex.regex)
103 {
104 regfree(h->regex.regex);
105 FREE(&h->regex.regex);
106 }
109 FREE(ptr);
110}
111
116static struct Hook *hook_new(void)
117{
118 return mutt_mem_calloc(1, sizeof(struct Hook));
119}
120
125 intptr_t data, struct Buffer *err)
126{
127 struct Buffer *alias = buf_pool_get();
128 struct Buffer *charset = buf_pool_get();
129
130 int rc = MUTT_CMD_ERROR;
131
132 if (parse_extract_token(alias, s, TOKEN_NO_FLAGS) < 0)
133 goto done;
134 if (parse_extract_token(charset, s, TOKEN_NO_FLAGS) < 0)
135 goto done;
136
138
139 if (buf_is_empty(alias) || buf_is_empty(charset))
140 {
141 buf_printf(err, _("%s: too few arguments"), buf->data);
142 rc = MUTT_CMD_WARNING;
143 }
144 else if (MoreArgs(s))
145 {
146 buf_printf(err, _("%s: too many arguments"), buf->data);
147 buf_reset(s); // clean up buffer to avoid a mess with further rcfile processing
148 rc = MUTT_CMD_WARNING;
149 }
150 else if (mutt_ch_lookup_add(type, buf_string(alias), buf_string(charset), err))
151 {
152 rc = MUTT_CMD_SUCCESS;
153 }
154
155done:
156 buf_pool_release(&alias);
157 buf_pool_release(&charset);
158
159 return rc;
160}
161
167enum CommandResult mutt_parse_hook(struct Buffer *buf, struct Buffer *s,
168 intptr_t data, struct Buffer *err)
169{
170 struct Hook *hook = NULL;
171 int rc = MUTT_CMD_ERROR;
172 bool pat_not = false;
173 bool use_regex = true;
174 regex_t *rx = NULL;
175 struct PatternList *pat = NULL;
176 const bool folder_or_mbox = (data & (MUTT_FOLDER_HOOK | MUTT_MBOX_HOOK));
177
178 struct Buffer *cmd = buf_pool_get();
179 struct Buffer *pattern = buf_pool_get();
180
181 if (~data & MUTT_GLOBAL_HOOK) /* NOT a global hook */
182 {
183 if (*s->dptr == '!')
184 {
185 s->dptr++;
186 SKIPWS(s->dptr);
187 pat_not = true;
188 }
189
191 if (folder_or_mbox && mutt_str_equal(buf_string(pattern), "-noregex"))
192 {
193 use_regex = false;
194 if (!MoreArgs(s))
195 {
196 buf_printf(err, _("%s: too few arguments"), buf->data);
197 rc = MUTT_CMD_WARNING;
198 goto cleanup;
199 }
201 }
202
203 if (!MoreArgs(s))
204 {
205 buf_printf(err, _("%s: too few arguments"), buf->data);
206 rc = MUTT_CMD_WARNING;
207 goto cleanup;
208 }
209 }
210
211 parse_extract_token(cmd, s,
216
217 if (buf_is_empty(cmd))
218 {
219 buf_printf(err, _("%s: too few arguments"), buf->data);
220 rc = MUTT_CMD_WARNING;
221 goto cleanup;
222 }
223
224 if (MoreArgs(s))
225 {
226 buf_printf(err, _("%s: too many arguments"), buf->data);
227 rc = MUTT_CMD_WARNING;
228 goto cleanup;
229 }
230
231 const char *const c_default_hook = cs_subset_string(NeoMutt->sub, "default_hook");
232 if (folder_or_mbox)
233 {
234 /* Accidentally using the ^ mailbox shortcut in the .neomuttrc is a
235 * common mistake */
236 if ((pattern->data[0] == '^') && !CurrentFolder)
237 {
238 buf_strcpy(err, _("current mailbox shortcut '^' is unset"));
239 goto cleanup;
240 }
241
242 struct Buffer *tmp = buf_pool_get();
243 buf_copy(tmp, pattern);
244 buf_expand_path_regex(tmp, use_regex);
245
246 /* Check for other mailbox shortcuts that expand to the empty string.
247 * This is likely a mistake too */
248 if (buf_is_empty(tmp) && !buf_is_empty(pattern))
249 {
250 buf_strcpy(err, _("mailbox shortcut expanded to empty regex"));
251 buf_pool_release(&tmp);
252 goto cleanup;
253 }
254
255 if (use_regex)
256 {
257 buf_copy(pattern, tmp);
258 }
259 else
260 {
262 }
263 buf_pool_release(&tmp);
264 }
266 {
267 if (mutt_comp_valid_command(buf_string(cmd)) == 0)
268 {
269 buf_strcpy(err, _("badly formatted command string"));
270 goto cleanup;
271 }
272 }
273 else if (c_default_hook && (~data & MUTT_GLOBAL_HOOK) &&
275 {
276 /* At this stage only these hooks remain:
277 * fcc-, fcc-save-, index-format-, message-, reply-, save-, send- and send2-hook
278 * If given a plain string, or regex, we expand it using $default_hook. */
279 mutt_check_simple(pattern, c_default_hook);
280 }
281
283 {
284 buf_expand_path(cmd);
285 }
286
287 /* check to make sure that a matching hook doesn't already exist */
288 TAILQ_FOREACH(hook, &Hooks, entries)
289 {
291 {
292 /* Ignore duplicate global hooks */
293 if (mutt_str_equal(hook->command, buf_string(cmd)))
294 {
295 rc = MUTT_CMD_SUCCESS;
296 goto cleanup;
297 }
298 }
299 else if ((hook->type == data) && (hook->regex.pat_not == pat_not) &&
300 mutt_str_equal(buf_string(pattern), hook->regex.pattern))
301 {
305 {
306 /* these hooks allow multiple commands with the same
307 * pattern, so if we've already seen this pattern/command pair, just
308 * ignore it instead of creating a duplicate */
309 if (mutt_str_equal(hook->command, buf_string(cmd)))
310 {
311 rc = MUTT_CMD_SUCCESS;
312 goto cleanup;
313 }
314 }
315 else
316 {
317 /* other hooks only allow one command per pattern, so update the
318 * entry with the new command. this currently does not change the
319 * order of execution of the hooks, which i think is desirable since
320 * a common action to perform is to change the default (.) entry
321 * based upon some other information. */
322 FREE(&hook->command);
323 hook->command = buf_strdup(cmd);
324 FREE(&hook->source_file);
326
328 {
329 expando_free(&hook->expando);
331 }
332
333 rc = MUTT_CMD_SUCCESS;
334 goto cleanup;
335 }
336 }
337 }
338
341 {
342 PatternCompFlags comp_flags;
343
344 if (data & (MUTT_SEND2_HOOK))
345 comp_flags = MUTT_PC_SEND_MODE_SEARCH;
346 else if (data & (MUTT_SEND_HOOK | MUTT_FCC_HOOK))
347 comp_flags = MUTT_PC_NO_FLAGS;
348 else
349 comp_flags = MUTT_PC_FULL_MSG;
350
351 struct MailboxView *mv_cur = get_current_mailbox_view();
352 struct Menu *menu = get_current_menu();
353 pat = mutt_pattern_comp(mv_cur, menu, buf_string(pattern), comp_flags, err);
354 if (!pat)
355 goto cleanup;
356 }
357 else if (~data & MUTT_GLOBAL_HOOK) /* NOT a global hook */
358 {
359 /* Hooks not allowing full patterns: Check syntax of regex */
360 rx = mutt_mem_calloc(1, sizeof(regex_t));
361 int rc2 = REG_COMP(rx, buf_string(pattern), ((data & MUTT_CRYPT_HOOK) ? REG_ICASE : 0));
362 if (rc2 != 0)
363 {
364 regerror(rc2, rx, err->data, err->dsize);
365 FREE(&rx);
366 goto cleanup;
367 }
368 }
369
370 struct Expando *exp = NULL;
372 exp = expando_parse(buf_string(cmd), IndexFormatDef, err);
373
374 hook = hook_new();
375 hook->type = data;
376 hook->command = buf_strdup(cmd);
378 hook->pattern = pat;
379 hook->regex.pattern = buf_strdup(pattern);
380 hook->regex.regex = rx;
381 hook->regex.pat_not = pat_not;
382 hook->expando = exp;
383
384 TAILQ_INSERT_TAIL(&Hooks, hook, entries);
385 rc = MUTT_CMD_SUCCESS;
386
387cleanup:
388 buf_pool_release(&cmd);
389 buf_pool_release(&pattern);
390 return rc;
391}
392
400{
401 struct Hook *h = NULL;
402 struct Hook *tmp = NULL;
403
404 TAILQ_FOREACH_SAFE(h, &Hooks, entries, tmp)
405 {
406 if ((type == MUTT_HOOK_NO_FLAGS) || (type == h->type))
407 {
408 TAILQ_REMOVE(&Hooks, h, entries);
409 hook_free(&h);
410 }
411 }
412}
413
417static void idxfmt_hashelem_free(int type, void *obj, intptr_t data)
418{
419 struct HookList *hl = obj;
420 struct Hook *h = NULL;
421 struct Hook *tmp = NULL;
422
423 TAILQ_FOREACH_SAFE(h, hl, entries, tmp)
424 {
425 TAILQ_REMOVE(hl, h, entries);
426 hook_free(&h);
427 }
428
429 FREE(&hl);
430}
431
435static void delete_idxfmt_hooks(void)
436{
438}
439
443static enum CommandResult mutt_parse_idxfmt_hook(struct Buffer *buf, struct Buffer *s,
444 intptr_t data, struct Buffer *err)
445{
447 bool pat_not = false;
448
449 struct Buffer *name = buf_pool_get();
450 struct Buffer *pattern = buf_pool_get();
451 struct Buffer *fmtstring = buf_pool_get();
452 struct Expando *exp = NULL;
453
454 if (!IdxFmtHooks)
455 {
458 }
459
460 if (!MoreArgs(s))
461 {
462 buf_printf(err, _("%s: too few arguments"), buf->data);
463 goto out;
464 }
466 struct HookList *hl = mutt_hash_find(IdxFmtHooks, buf_string(name));
467
468 if (*s->dptr == '!')
469 {
470 s->dptr++;
471 SKIPWS(s->dptr);
472 pat_not = true;
473 }
475
476 if (!MoreArgs(s))
477 {
478 buf_printf(err, _("%s: too few arguments"), buf->data);
479 goto out;
480 }
481 parse_extract_token(fmtstring, s, TOKEN_NO_FLAGS);
482
483 exp = expando_parse(buf_string(fmtstring), IndexFormatDef, err);
484 if (!exp)
485 goto out;
486
487 if (MoreArgs(s))
488 {
489 buf_printf(err, _("%s: too many arguments"), buf->data);
490 goto out;
491 }
492
493 const char *const c_default_hook = cs_subset_string(NeoMutt->sub, "default_hook");
494 if (c_default_hook)
495 mutt_check_simple(pattern, c_default_hook);
496
497 /* check to make sure that a matching hook doesn't already exist */
498 struct Hook *hook = NULL;
499 if (hl)
500 {
501 TAILQ_FOREACH(hook, hl, entries)
502 {
503 if ((hook->regex.pat_not == pat_not) &&
505 {
506 expando_free(&hook->expando);
507 hook->expando = exp;
508 exp = NULL;
509 rc = MUTT_CMD_SUCCESS;
510 goto out;
511 }
512 }
513 }
514
515 /* MUTT_PC_PATTERN_DYNAMIC sets so that date ranges are regenerated during
516 * matching. This of course is slower, but index-format-hook is commonly
517 * used for date ranges, and they need to be evaluated relative to "now", not
518 * the hook compilation time. */
519 struct MailboxView *mv_cur = get_current_mailbox_view();
520 struct Menu *menu = get_current_menu();
521 struct PatternList *pat = mutt_pattern_comp(mv_cur, menu, buf_string(pattern),
523 err);
524 if (!pat)
525 goto out;
526
527 hook = hook_new();
528 hook->type = MUTT_IDXFMTHOOK;
529 hook->command = NULL;
531 hook->pattern = pat;
532 hook->regex.pattern = buf_strdup(pattern);
533 hook->regex.regex = NULL;
534 hook->regex.pat_not = pat_not;
535 hook->expando = exp;
536 exp = NULL;
537
538 if (!hl)
539 {
540 hl = mutt_mem_calloc(1, sizeof(*hl));
541 TAILQ_INIT(hl);
543 }
544
545 TAILQ_INSERT_TAIL(hl, hook, entries);
546 rc = MUTT_CMD_SUCCESS;
547
548out:
549 buf_pool_release(&name);
550 buf_pool_release(&pattern);
551 buf_pool_release(&fmtstring);
552 expando_free(&exp);
553
554 return rc;
555}
556
563static HookFlags mutt_get_hook_type(const char *name)
564{
565 struct Command *c = NULL;
566 for (size_t i = 0, size = commands_array(&c); i < size; i++)
567 {
568 if (((c[i].parse == mutt_parse_hook) || (c[i].parse == mutt_parse_idxfmt_hook)) &&
570 {
571 return c[i].data;
572 }
573 }
574 return MUTT_HOOK_NO_FLAGS;
575}
576
580static enum CommandResult mutt_parse_unhook(struct Buffer *buf, struct Buffer *s,
581 intptr_t data, struct Buffer *err)
582{
583 while (MoreArgs(s))
584 {
586 if (mutt_str_equal("*", buf->data))
587 {
589 {
590 buf_addstr(err, _("unhook: Can't do unhook * from within a hook"));
591 return MUTT_CMD_WARNING;
592 }
596 }
597 else
598 {
599 HookFlags type = mutt_get_hook_type(buf->data);
600
601 if (type == MUTT_HOOK_NO_FLAGS)
602 {
603 buf_printf(err, _("unhook: unknown hook type: %s"), buf->data);
604 return MUTT_CMD_ERROR;
605 }
606 if (type & (MUTT_CHARSET_HOOK | MUTT_ICONV_HOOK))
607 {
609 return MUTT_CMD_SUCCESS;
610 }
611 if (CurrentHookType == type)
612 {
613 buf_printf(err, _("unhook: Can't delete a %s from within a %s"),
614 buf->data, buf->data);
615 return MUTT_CMD_WARNING;
616 }
617 if (type == MUTT_IDXFMTHOOK)
619 else
620 mutt_delete_hooks(type);
621 }
622 }
623 return MUTT_CMD_SUCCESS;
624}
625
631void mutt_folder_hook(const char *path, const char *desc)
632{
633 if (!path && !desc)
634 return;
635
636 struct Hook *hook = NULL;
637 struct Buffer *err = buf_pool_get();
638
640
641 TAILQ_FOREACH(hook, &Hooks, entries)
642 {
643 if (!hook->command)
644 continue;
645
646 if (!(hook->type & MUTT_FOLDER_HOOK))
647 continue;
648
649 const char *match = NULL;
650 if (mutt_regex_match(&hook->regex, path))
651 match = path;
652 else if (mutt_regex_match(&hook->regex, desc))
653 match = desc;
654
655 if (match)
656 {
657 mutt_debug(LL_DEBUG1, "folder-hook '%s' matches '%s'\n", hook->regex.pattern, match);
658 mutt_debug(LL_DEBUG5, " %s\n", hook->command);
659 if (parse_rc_line_cwd(hook->command, hook->source_file, err) == MUTT_CMD_ERROR)
660 {
661 mutt_error("%s", buf_string(err));
662 break;
663 }
664 }
665 }
666 buf_pool_release(&err);
667
669}
670
679char *mutt_find_hook(HookFlags type, const char *pat)
680{
681 struct Hook *tmp = NULL;
682
683 TAILQ_FOREACH(tmp, &Hooks, entries)
684 {
685 if (tmp->type & type)
686 {
687 if (mutt_regex_match(&tmp->regex, pat))
688 return tmp->command;
689 }
690 }
691 return NULL;
692}
693
700void mutt_message_hook(struct Mailbox *m, struct Email *e, HookFlags type)
701{
702 struct Hook *hook = NULL;
703 struct PatternCache cache = { 0 };
704 struct Buffer *err = buf_pool_get();
705
706 CurrentHookType = type;
707
708 TAILQ_FOREACH(hook, &Hooks, entries)
709 {
710 if (!hook->command)
711 continue;
712
713 if (hook->type & type)
714 {
715 if ((mutt_pattern_exec(SLIST_FIRST(hook->pattern), 0, m, e, &cache) > 0) ^
716 hook->regex.pat_not)
717 {
718 if (parse_rc_line_cwd(hook->command, hook->source_file, err) == MUTT_CMD_ERROR)
719 {
720 mutt_error("%s", buf_string(err));
722 buf_pool_release(&err);
723
724 return;
725 }
726 /* Executing arbitrary commands could affect the pattern results,
727 * so the cache has to be wiped */
728 memset(&cache, 0, sizeof(cache));
729 }
730 }
731 }
732 buf_pool_release(&err);
733
735}
736
746static int addr_hook(struct Buffer *path, HookFlags type, struct Mailbox *m, struct Email *e)
747{
748 struct Hook *hook = NULL;
749 struct PatternCache cache = { 0 };
750
751 /* determine if a matching hook exists */
752 TAILQ_FOREACH(hook, &Hooks, entries)
753 {
754 if (!hook->command)
755 continue;
756
757 if (hook->type & type)
758 {
759 if ((mutt_pattern_exec(SLIST_FIRST(hook->pattern), 0, m, e, &cache) > 0) ^
760 hook->regex.pat_not)
761 {
762 buf_alloc(path, PATH_MAX);
763 mutt_make_string(path, -1, hook->expando, m, -1, e, MUTT_FORMAT_PLAIN, NULL);
764 buf_fix_dptr(path);
765 return 0;
766 }
767 }
768 }
769
770 return -1;
771}
772
778void mutt_default_save(struct Buffer *path, struct Email *e)
779{
780 struct Mailbox *m_cur = get_current_mailbox();
781 if (addr_hook(path, MUTT_SAVE_HOOK, m_cur, e) == 0)
782 return;
783
784 struct Envelope *env = e->env;
785 const struct Address *from = TAILQ_FIRST(&env->from);
786 const struct Address *reply_to = TAILQ_FIRST(&env->reply_to);
787 const struct Address *to = TAILQ_FIRST(&env->to);
788 const struct Address *cc = TAILQ_FIRST(&env->cc);
789 const struct Address *addr = NULL;
790 bool from_me = mutt_addr_is_user(from);
791
792 if (!from_me && reply_to && reply_to->mailbox)
793 addr = reply_to;
794 else if (!from_me && from && from->mailbox)
795 addr = from;
796 else if (to && to->mailbox)
797 addr = to;
798 else if (cc && cc->mailbox)
799 addr = cc;
800 else
801 addr = NULL;
802 if (addr)
803 {
804 struct Buffer *tmp = buf_pool_get();
805 mutt_safe_path(tmp, addr);
806 buf_add_printf(path, "=%s", buf_string(tmp));
807 buf_pool_release(&tmp);
808 }
809}
810
816void mutt_select_fcc(struct Buffer *path, struct Email *e)
817{
818 buf_alloc(path, PATH_MAX);
819
820 if (addr_hook(path, MUTT_FCC_HOOK, NULL, e) != 0)
821 {
822 const struct Address *to = TAILQ_FIRST(&e->env->to);
823 const struct Address *cc = TAILQ_FIRST(&e->env->cc);
824 const struct Address *bcc = TAILQ_FIRST(&e->env->bcc);
825 const bool c_save_name = cs_subset_bool(NeoMutt->sub, "save_name");
826 const bool c_force_name = cs_subset_bool(NeoMutt->sub, "force_name");
827 const char *const c_record = cs_subset_string(NeoMutt->sub, "record");
828 if ((c_save_name || c_force_name) && (to || cc || bcc))
829 {
830 const struct Address *addr = to ? to : (cc ? cc : bcc);
831 struct Buffer *buf = buf_pool_get();
832 mutt_safe_path(buf, addr);
833 const char *const c_folder = cs_subset_string(NeoMutt->sub, "folder");
834 buf_concat_path(path, NONULL(c_folder), buf_string(buf));
835 buf_pool_release(&buf);
836 if (!c_force_name && (mx_access(buf_string(path), W_OK) != 0))
837 buf_strcpy(path, c_record);
838 }
839 else
840 {
841 buf_strcpy(path, c_record);
842 }
843 }
844 else
845 {
846 buf_fix_dptr(path);
847 }
848
849 buf_pretty_mailbox(path);
850}
851
858static void list_hook(struct ListHead *matches, const char *match, HookFlags type)
859{
860 struct Hook *tmp = NULL;
861
862 TAILQ_FOREACH(tmp, &Hooks, entries)
863 {
864 if ((tmp->type & type) && mutt_regex_match(&tmp->regex, match))
865 {
867 }
868 }
869}
870
878void mutt_crypt_hook(struct ListHead *list, struct Address *addr)
879{
881}
882
887void mutt_account_hook(const char *url)
888{
889 /* parsing commands with URLs in an account hook can cause a recursive
890 * call. We just skip processing if this occurs. Typically such commands
891 * belong in a folder-hook -- perhaps we should warn the user. */
892 static bool inhook = false;
893 if (inhook)
894 return;
895
896 struct Hook *hook = NULL;
897 struct Buffer *err = buf_pool_get();
898
899 TAILQ_FOREACH(hook, &Hooks, entries)
900 {
901 if (!(hook->command && (hook->type & MUTT_ACCOUNT_HOOK)))
902 continue;
903
904 if (mutt_regex_match(&hook->regex, url))
905 {
906 inhook = true;
907 mutt_debug(LL_DEBUG1, "account-hook '%s' matches '%s'\n", hook->regex.pattern, url);
908 mutt_debug(LL_DEBUG5, " %s\n", hook->command);
909
910 if (parse_rc_line_cwd(hook->command, hook->source_file, err) == MUTT_CMD_ERROR)
911 {
912 mutt_error("%s", buf_string(err));
913 buf_pool_release(&err);
914
915 inhook = false;
916 goto done;
917 }
918
919 inhook = false;
920 }
921 }
922done:
923 buf_pool_release(&err);
924}
925
933{
934 struct Hook *hook = NULL;
935 struct Buffer *err = buf_pool_get();
936
937 TAILQ_FOREACH(hook, &Hooks, entries)
938 {
939 if (!(hook->command && (hook->type & MUTT_TIMEOUT_HOOK)))
940 continue;
941
942 if (parse_rc_line_cwd(hook->command, hook->source_file, err) == MUTT_CMD_ERROR)
943 {
944 mutt_error("%s", buf_string(err));
945 buf_reset(err);
946
947 /* The hooks should be independent of each other, so even though this on
948 * failed, we'll carry on with the others. */
949 }
950 }
951 buf_pool_release(&err);
952
953 /* Delete temporary attachment files */
955}
956
965{
966 struct Hook *hook = NULL;
967 struct Buffer *err = buf_pool_get();
968
969 TAILQ_FOREACH(hook, &Hooks, entries)
970 {
971 if (!(hook->command && (hook->type & type)))
972 continue;
973
974 if (parse_rc_line_cwd(hook->command, hook->source_file, err) == MUTT_CMD_ERROR)
975 {
976 mutt_error("%s", buf_string(err));
977 buf_reset(err);
978 }
979 }
980 buf_pool_release(&err);
981}
982
991const struct Expando *mutt_idxfmt_hook(const char *name, struct Mailbox *m, struct Email *e)
992{
993 if (!IdxFmtHooks)
994 return NULL;
995
996 struct HookList *hl = mutt_hash_find(IdxFmtHooks, name);
997 if (!hl)
998 return NULL;
999
1001
1002 struct PatternCache cache = { 0 };
1003 const struct Expando *exp = NULL;
1004 struct Hook *hook = NULL;
1005
1006 TAILQ_FOREACH(hook, hl, entries)
1007 {
1008 struct Pattern *pat = SLIST_FIRST(hook->pattern);
1009 if ((mutt_pattern_exec(pat, 0, m, e, &cache) > 0) ^ hook->regex.pat_not)
1010 {
1011 exp = hook->expando;
1012 break;
1013 }
1014 }
1015
1017
1018 return exp;
1019}
1020
1024static const struct Command HookCommands[] = {
1025 // clang-format off
1026 { "account-hook", mutt_parse_hook, MUTT_ACCOUNT_HOOK },
1028 { "crypt-hook", mutt_parse_hook, MUTT_CRYPT_HOOK },
1029 { "fcc-hook", mutt_parse_hook, MUTT_FCC_HOOK },
1030 { "fcc-save-hook", mutt_parse_hook, MUTT_FCC_HOOK | MUTT_SAVE_HOOK },
1031 { "folder-hook", mutt_parse_hook, MUTT_FOLDER_HOOK },
1033 { "index-format-hook", mutt_parse_idxfmt_hook, MUTT_IDXFMTHOOK },
1034 { "mbox-hook", mutt_parse_hook, MUTT_MBOX_HOOK },
1035 { "message-hook", mutt_parse_hook, MUTT_MESSAGE_HOOK },
1036 { "pgp-hook", mutt_parse_hook, MUTT_CRYPT_HOOK },
1037 { "reply-hook", mutt_parse_hook, MUTT_REPLY_HOOK },
1038 { "save-hook", mutt_parse_hook, MUTT_SAVE_HOOK },
1039 { "send-hook", mutt_parse_hook, MUTT_SEND_HOOK },
1040 { "send2-hook", mutt_parse_hook, MUTT_SEND2_HOOK },
1041 { "shutdown-hook", mutt_parse_hook, MUTT_SHUTDOWN_HOOK | MUTT_GLOBAL_HOOK },
1042 { "startup-hook", mutt_parse_hook, MUTT_STARTUP_HOOK | MUTT_GLOBAL_HOOK },
1043 { "timeout-hook", mutt_parse_hook, MUTT_TIMEOUT_HOOK | MUTT_GLOBAL_HOOK },
1044 { "unhook", mutt_parse_unhook, 0 },
1045 // clang-format on
1046};
1047
1051void hooks_init(void)
1052{
1054}
Email Address Handling.
Email Aliases.
bool mutt_addr_is_user(const struct Address *addr)
Does the address belong to the user.
Definition: alias.c:600
GUI display the mailboxes in a side panel.
int buf_printf(struct Buffer *buf, const char *fmt,...)
Format a string overwriting a Buffer.
Definition: buffer.c:161
int buf_add_printf(struct Buffer *buf, const char *fmt,...)
Format a string appending a Buffer.
Definition: buffer.c:204
void buf_reset(struct Buffer *buf)
Reset an existing Buffer.
Definition: buffer.c:76
bool buf_is_empty(const struct Buffer *buf)
Is the Buffer empty?
Definition: buffer.c:291
void buf_fix_dptr(struct Buffer *buf)
Move the dptr to end of the Buffer.
Definition: buffer.c:182
size_t buf_addstr(struct Buffer *buf, const char *s)
Add a string to a Buffer.
Definition: buffer.c:226
size_t buf_strcpy(struct Buffer *buf, const char *s)
Copy a string into a Buffer.
Definition: buffer.c:395
size_t buf_copy(struct Buffer *dst, const struct Buffer *src)
Copy a Buffer's contents to another Buffer.
Definition: buffer.c:601
char * buf_strdup(const struct Buffer *buf)
Copy a Buffer's string.
Definition: buffer.c:571
size_t buf_concat_path(struct Buffer *buf, const char *dir, const char *fname)
Join a directory name and a filename.
Definition: buffer.c:509
void buf_alloc(struct Buffer *buf, size_t new_size)
Make sure a buffer can store at least new_size bytes.
Definition: buffer.c:337
static const char * buf_string(const struct Buffer *buf)
Convert a buffer to a const char * "string".
Definition: buffer.h:96
CommandResult
Error codes for command_t parse functions.
Definition: command.h:36
@ MUTT_CMD_SUCCESS
Success: Command worked.
Definition: command.h:39
@ MUTT_CMD_ERROR
Error: Can't help the user.
Definition: command.h:37
@ MUTT_CMD_WARNING
Warning: Help given to the user.
Definition: command.h:38
enum CommandResult parse_rc_line_cwd(const char *line, char *cwd, struct Buffer *err)
Parse and run a muttrc line in a relative directory.
Definition: commands.c:165
char * mutt_get_sourced_cwd(void)
Get the current file path that is being parsed.
Definition: commands.c:185
Functions to parse commands in a config file.
struct PatternList * mutt_pattern_comp(struct MailboxView *mv, struct Menu *menu, const char *s, PatternCompFlags flags, struct Buffer *err)
Create a Pattern.
Definition: compile.c:906
void mutt_pattern_free(struct PatternList **pat)
Free a Pattern.
Definition: compile.c:778
int mutt_comp_valid_command(const char *cmd)
Is this command string allowed?
Definition: compress.c:414
Compressed mbox local mailbox type.
const char * cs_subset_string(const struct ConfigSubset *sub, const char *name)
Get a string config item by name.
Definition: helpers.c:291
bool cs_subset_bool(const struct ConfigSubset *sub, const char *name)
Get a boolean config item by name.
Definition: helpers.c:47
Convenience wrapper for the config headers.
void commands_register(const struct Command *cmds, const size_t num_cmds)
Add commands to Commands array.
Definition: command.c:53
size_t commands_array(struct Command **first)
Get Commands array.
Definition: command.c:75
Convenience wrapper for the core headers.
Structs that make up an email.
bool mutt_pattern_exec(struct Pattern *pat, PatternExecFlags flags, struct Mailbox *m, struct Email *e, struct PatternCache *cache)
Match a pattern against an email header.
Definition: exec.c:1149
Parse Expando string.
struct Expando * expando_parse(const char *str, const struct ExpandoDefinition *defs, struct Buffer *err)
Parse an Expando string.
Definition: expando.c:78
void expando_free(struct Expando **ptr)
Free an Expando object.
Definition: expando.c:58
int parse_extract_token(struct Buffer *dest, struct Buffer *tok, TokenFlags flags)
Extract one token from a string.
Definition: extract.c:50
#define TOKEN_SPACE
Don't treat whitespace as a term.
Definition: extract.h:49
#define MoreArgs(buf)
Definition: extract.h:32
#define TOKEN_NO_FLAGS
No flags are set.
Definition: extract.h:46
int mutt_file_sanitize_regex(struct Buffer *dest, const char *src)
Escape any regex-magic characters in a string.
Definition: file.c:754
char * CurrentFolder
Currently selected mailbox.
Definition: globals.c:42
Global variables.
static enum CommandResult mutt_parse_unhook(struct Buffer *buf, struct Buffer *s, intptr_t data, struct Buffer *err)
Parse the 'unhook' command - Implements Command::parse() -.
Definition: hook.c:580
static enum CommandResult mutt_parse_idxfmt_hook(struct Buffer *buf, struct Buffer *s, intptr_t data, struct Buffer *err)
Parse the 'index-format-hook' command - Implements Command::parse() -.
Definition: hook.c:443
enum CommandResult mutt_parse_hook(struct Buffer *buf, struct Buffer *s, intptr_t data, struct Buffer *err)
Parse the 'hook' family of commands - Implements Command::parse() -.
Definition: hook.c:167
enum CommandResult mutt_parse_charset_iconv_hook(struct Buffer *buf, struct Buffer *s, intptr_t data, struct Buffer *err)
Parse 'charset-hook' and 'iconv-hook' commands - Implements Command::parse() -.
Definition: hook.c:124
static void idxfmt_hashelem_free(int type, void *obj, intptr_t data)
Free our hash table data - Implements hash_hdata_free_t -.
Definition: hook.c:417
#define mutt_error(...)
Definition: logging2.h:92
#define mutt_debug(LEVEL,...)
Definition: logging2.h:89
struct HashElem * mutt_hash_insert(struct HashTable *table, const char *strkey, void *data)
Add a new element to the Hash Table (with string keys)
Definition: hash.c:335
void * mutt_hash_find(const struct HashTable *table, const char *strkey)
Find the HashElem data in a Hash Table element using a key.
Definition: hash.c:362
struct HashTable * mutt_hash_new(size_t num_elems, HashFlags flags)
Create a new Hash Table (with string keys)
Definition: hash.c:259
void mutt_hash_set_destructor(struct HashTable *table, hash_hdata_free_t fn, intptr_t fn_data)
Set the destructor for a Hash Table.
Definition: hash.c:301
void mutt_hash_free(struct HashTable **ptr)
Free a hash table.
Definition: hash.c:457
#define MUTT_HASH_STRDUP_KEYS
make a copy of the keys
Definition: hash.h:111
int mutt_make_string(struct Buffer *buf, size_t max_cols, const struct Expando *exp, struct Mailbox *m, int inpgr, struct Email *e, MuttFormatFlags flags, const char *progress)
Create formatted strings using mailbox expandos.
Definition: hdrline.c:1719
String processing routines to generate the mail index.
void mutt_default_save(struct Buffer *path, struct Email *e)
Find the default save path for an email.
Definition: hook.c:778
void mutt_timeout_hook(void)
Execute any timeout hooks.
Definition: hook.c:932
static struct HashTable * IdxFmtHooks
All Index Format hooks.
Definition: hook.c:83
char * mutt_find_hook(HookFlags type, const char *pat)
Find a matching hook.
Definition: hook.c:679
void mutt_startup_shutdown_hook(HookFlags type)
Execute any startup/shutdown hooks.
Definition: hook.c:964
void mutt_delete_hooks(HookFlags type)
Delete matching hooks.
Definition: hook.c:399
static void list_hook(struct ListHead *matches, const char *match, HookFlags type)
Find hook strings matching.
Definition: hook.c:858
void mutt_account_hook(const char *url)
Perform an account hook.
Definition: hook.c:887
static void delete_idxfmt_hooks(void)
Delete all the index-format-hooks.
Definition: hook.c:435
static void hook_free(struct Hook **ptr)
Free a Hook.
Definition: hook.c:92
void mutt_folder_hook(const char *path, const char *desc)
Perform a folder hook.
Definition: hook.c:631
void mutt_select_fcc(struct Buffer *path, struct Email *e)
Select the FCC path for an email.
Definition: hook.c:816
const struct Expando * mutt_idxfmt_hook(const char *name, struct Mailbox *m, struct Email *e)
Get index-format-hook format string.
Definition: hook.c:991
static int addr_hook(struct Buffer *path, HookFlags type, struct Mailbox *m, struct Email *e)
Perform an address hook (get a path)
Definition: hook.c:746
const struct ExpandoDefinition IndexFormatDef[]
Expando definitions.
Definition: mutt_config.c:301
void hooks_init(void)
Setup feature commands.
Definition: hook.c:1051
static struct HookList Hooks
All simple hooks, e.g. MUTT_FOLDER_HOOK.
Definition: hook.c:80
static HookFlags mutt_get_hook_type(const char *name)
Find a hook by name.
Definition: hook.c:563
static HookFlags CurrentHookType
The type of the hook currently being executed, e.g. MUTT_SAVE_HOOK.
Definition: hook.c:86
static const struct Command HookCommands[]
Hook Commands.
Definition: hook.c:1024
void mutt_crypt_hook(struct ListHead *list, struct Address *addr)
Find crypto hooks for an Address.
Definition: hook.c:878
static struct Hook * hook_new(void)
Create a Hook.
Definition: hook.c:116
void mutt_message_hook(struct Mailbox *m, struct Email *e, HookFlags type)
Perform a message hook.
Definition: hook.c:700
Parse and execute user-defined hooks.
#define MUTT_OPEN_HOOK
open-hook: to read a compressed mailbox
Definition: hook.h:49
#define MUTT_ICONV_HOOK
iconv-hook: create a system charset alias
Definition: hook.h:43
#define MUTT_FOLDER_HOOK
folder-hook: when entering a mailbox
Definition: hook.h:37
#define MUTT_SAVE_HOOK
save-hook: set a default folder when saving an email
Definition: hook.h:41
#define MUTT_SEND_HOOK
send-hook: when composing a new email
Definition: hook.h:39
uint32_t HookFlags
Flags for mutt_parse_hook(), e.g. MUTT_FOLDER_HOOK.
Definition: hook.h:35
#define MUTT_FCC_HOOK
fcc-hook: to save outgoing email
Definition: hook.h:40
#define MUTT_CLOSE_HOOK
close-hook: write to a compressed mailbox
Definition: hook.h:51
#define MUTT_ACCOUNT_HOOK
account-hook: when changing between accounts
Definition: hook.h:46
#define MUTT_APPEND_HOOK
append-hook: append to a compressed mailbox
Definition: hook.h:50
#define MUTT_GLOBAL_HOOK
Hooks which don't take a regex.
Definition: hook.h:56
#define MUTT_STARTUP_HOOK
startup-hook: run when starting NeoMutt
Definition: hook.h:54
#define MUTT_SEND2_HOOK
send2-hook: when changing fields in the compose menu
Definition: hook.h:48
#define MUTT_CRYPT_HOOK
crypt-hook: automatically select a PGP/SMIME key
Definition: hook.h:45
#define MUTT_MBOX_HOOK
mbox-hook: move messages after reading them
Definition: hook.h:38
#define MUTT_REPLY_HOOK
reply-hook: when replying to an email
Definition: hook.h:47
#define MUTT_TIMEOUT_HOOK
timeout-hook: run a command periodically
Definition: hook.h:53
#define MUTT_MESSAGE_HOOK
message-hook: run before displaying a message
Definition: hook.h:44
#define MUTT_SHUTDOWN_HOOK
shutdown-hook: run when leaving NeoMutt
Definition: hook.h:55
#define MUTT_IDXFMTHOOK
index-format-hook: customise the format of the index
Definition: hook.h:52
#define MUTT_CHARSET_HOOK
charset-hook: create a charset alias for malformed emails
Definition: hook.h:42
#define MUTT_HOOK_NO_FLAGS
No flags are set.
Definition: hook.h:36
GUI manage the main index (list of emails)
struct MailboxView * get_current_mailbox_view(void)
Get the current Mailbox view.
Definition: index.c:683
struct Mailbox * get_current_mailbox(void)
Get the current Mailbox.
Definition: index.c:715
struct Menu * get_current_menu(void)
Get the current Menu.
Definition: index.c:731
struct ListNode * mutt_list_insert_tail(struct ListHead *h, char *s)
Append a string to the end of a List.
Definition: list.c:65
@ LL_DEBUG5
Log at debug level 5.
Definition: logging2.h:47
@ LL_DEBUG1
Log at debug level 1.
Definition: logging2.h:43
void * mutt_mem_calloc(size_t nmemb, size_t size)
Allocate zeroed memory on the heap.
Definition: memory.c:51
#define FREE(x)
Definition: memory.h:45
#define mutt_array_size(x)
Definition: memory.h:38
void mutt_ch_lookup_remove(void)
Remove all the character set lookups.
Definition: charset.c:541
bool mutt_ch_lookup_add(enum LookupType type, const char *pat, const char *replace, struct Buffer *err)
Add a new character set lookup.
Definition: charset.c:509
LookupType
Types of character set lookups.
Definition: charset.h:68
@ MUTT_LOOKUP_ICONV
Character set conversion.
Definition: charset.h:70
@ MUTT_LOOKUP_CHARSET
Alias for another character set.
Definition: charset.h:69
Convenience wrapper for the library headers.
#define _(a)
Definition: message.h:28
bool mutt_regex_match(const struct Regex *regex, const char *str)
Shorthand to mutt_regex_capture()
Definition: regex.c:614
bool mutt_istr_equal(const char *a, const char *b)
Compare two strings, ignoring case.
Definition: string.c:672
char * mutt_str_dup(const char *str)
Copy a string, safely.
Definition: string.c:253
bool mutt_str_equal(const char *a, const char *b)
Compare two strings.
Definition: string.c:660
#define PATH_MAX
Definition: mutt.h:42
void mutt_temp_attachments_cleanup(void)
Delete all temporary attachments.
Definition: mutt_attach.c:1309
void buf_expand_path_regex(struct Buffer *buf, bool regex)
Create the canonical path (with regex char escaping)
Definition: muttlib.c:122
void buf_pretty_mailbox(struct Buffer *buf)
Shorten a mailbox path using '~' or '='.
Definition: muttlib.c:519
void buf_expand_path(struct Buffer *buf)
Create the canonical path.
Definition: muttlib.c:315
void mutt_safe_path(struct Buffer *dest, const struct Address *a)
Make a safe filename from an email address.
Definition: muttlib.c:683
Some miscellaneous functions.
int mx_access(const char *path, int flags)
Wrapper for access, checks permissions on a given mailbox.
Definition: mx.c:170
API for mailboxes.
API for encryption/signing of emails.
#define WithCrypto
Definition: lib.h:116
Text parsing functions.
Match patterns to emails.
#define MUTT_PC_SEND_MODE_SEARCH
Allow send-mode body searching.
Definition: lib.h:70
uint8_t PatternCompFlags
Flags for mutt_pattern_comp(), e.g. MUTT_PC_FULL_MSG.
Definition: lib.h:66
#define MUTT_PC_FULL_MSG
Enable body and header matching.
Definition: lib.h:68
void mutt_check_simple(struct Buffer *s, const char *simple)
Convert a simple search into a real request.
Definition: pattern.c:112
#define MUTT_PC_NO_FLAGS
No flags are set.
Definition: lib.h:67
#define MUTT_PC_PATTERN_DYNAMIC
Enable runtime date range evaluation.
Definition: lib.h:69
struct Buffer * buf_pool_get(void)
Get a Buffer from the pool.
Definition: pool.c:81
void buf_pool_release(struct Buffer **ptr)
Return a Buffer to the pool.
Definition: pool.c:94
#define TAILQ_FOREACH(var, head, field)
Definition: queue.h:725
#define TAILQ_FOREACH_SAFE(var, head, field, tvar)
Definition: queue.h:735
#define TAILQ_INIT(head)
Definition: queue.h:765
#define TAILQ_HEAD(name, type)
Definition: queue.h:623
#define TAILQ_INSERT_TAIL(head, elm, field)
Definition: queue.h:809
#define TAILQ_FIRST(head)
Definition: queue.h:723
#define SLIST_FIRST(head)
Definition: queue.h:229
#define TAILQ_REMOVE(head, elm, field)
Definition: queue.h:841
#define TAILQ_HEAD_INITIALIZER(head)
Definition: queue.h:637
#define TAILQ_ENTRY(type)
Definition: queue.h:640
#define REG_COMP(preg, regex, cflags)
Compile a regular expression.
Definition: regex3.h:50
#define MUTT_FORMAT_PLAIN
Do not prepend DISP_TO, DISP_CC ...
Definition: render.h:39
#define NONULL(x)
Definition: string2.h:37
#define SKIPWS(ch)
Definition: string2.h:45
An email address.
Definition: address.h:36
struct Buffer * mailbox
Mailbox and host address.
Definition: address.h:38
String manipulation buffer.
Definition: buffer.h:36
char * dptr
Current read/write position.
Definition: buffer.h:38
size_t dsize
Length of data.
Definition: buffer.h:39
char * data
Pointer to data.
Definition: buffer.h:37
enum CommandResult(* parse)(struct Buffer *buf, struct Buffer *s, intptr_t data, struct Buffer *err)
Definition: command.h:65
intptr_t data
Data or flags to pass to the command.
Definition: command.h:67
const char * name
Name of the command.
Definition: command.h:52
The envelope/body of an email.
Definition: email.h:39
struct Envelope * env
Envelope information.
Definition: email.h:68
The header of an Email.
Definition: envelope.h:57
struct AddressList to
Email's 'To' list.
Definition: envelope.h:60
struct AddressList reply_to
Email's 'reply-to'.
Definition: envelope.h:64
struct AddressList cc
Email's 'Cc' list.
Definition: envelope.h:61
struct AddressList bcc
Email's 'Bcc' list.
Definition: envelope.h:62
struct AddressList from
Email's 'From' list.
Definition: envelope.h:59
Definition of a format string.
Definition: definition.h:52
Parsed Expando trees.
Definition: expando.h:41
A Hash Table.
Definition: hash.h:97
A list of user hooks.
Definition: hook.c:68
HookFlags type
Hook type.
Definition: hook.c:69
struct PatternList * pattern
Used for fcc,save,send-hook.
Definition: hook.c:73
struct Regex regex
Regular expression.
Definition: hook.c:70
char * command
Filename, command or pattern to execute.
Definition: hook.c:71
struct Expando * expando
Used for format hooks.
Definition: hook.c:74
char * source_file
Used for relative-directory source.
Definition: hook.c:72
View of a Mailbox.
Definition: mview.h:40
A mailbox.
Definition: mailbox.h:79
Definition: lib.h:79
Container for Accounts, Notifications.
Definition: neomutt.h:42
struct ConfigSubset * sub
Inherited config items.
Definition: neomutt.h:46
Cache commonly-used patterns.
Definition: lib.h:116
A simple (non-regex) pattern.
Definition: lib.h:76
Cached regular expression.
Definition: regex3.h:86
char * pattern
printable version
Definition: regex3.h:87
bool pat_not
do not match
Definition: regex3.h:89
regex_t * regex
compiled expression
Definition: regex3.h:88