NeoMutt  2025-12-11-435-g4ac674
Teaching an old dog new tricks
DOXYGEN
Loading...
Searching...
No Matches
score.h File Reference

Routines for adding user scores to emails. More...

#include <stdbool.h>
#include "core/lib.h"
+ Include dependency graph for score.h:
+ This graph shows which files directly or indirectly include this file:

Go to the source code of this file.

Data Structures

struct  Score
 Scoring rule for email. More...
 

Functions

enum CommandResult parse_score (const struct Command *cmd, struct Buffer *line, const struct ParseContext *pc, struct ParseError *pe)
 Parse the 'score' command - Implements Command::parse() -.
 
enum CommandResult parse_unscore (const struct Command *cmd, struct Buffer *line, const struct ParseContext *pc, struct ParseError *pe)
 Parse the 'unscore' command - Implements Command::parse() -.
 
void mutt_check_rescore (struct Mailbox *m)
 Do the emails need to have their scores recalculated?
 
void mutt_score_message (struct Mailbox *m, struct Email *e, bool upd_mbox)
 Apply scoring to an email.
 

Variables

struct ScoreScoreList
 Linked list of email scoring rules.
 

Detailed Description

Routines for adding user scores to emails.

Authors
  • Richard Russon

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 http://www.gnu.org/licenses/.

Definition in file score.h.

Function Documentation

◆ mutt_check_rescore()

void mutt_check_rescore ( struct Mailbox * m)

Do the emails need to have their scores recalculated?

Parameters
mMailbox

Definition at line 202 of file score.c.

203{
204 const bool c_score = cs_subset_bool(NeoMutt->sub, "score");
205 if (OptNeedRescore && c_score)
206 {
207 const enum EmailSortType c_sort = cs_subset_sort(NeoMutt->sub, "sort");
208 const enum EmailSortType c_sort_aux = cs_subset_sort(NeoMutt->sub, "sort_aux");
209 if (((c_sort & SORT_MASK) == EMAIL_SORT_SCORE) ||
210 ((c_sort_aux & SORT_MASK) == EMAIL_SORT_SCORE))
211 {
212 OptNeedResort = true;
213 if (mutt_using_threads())
214 OptSortSubthreads = true;
215 }
216
217 mutt_debug(LL_NOTIFY, "NT_SCORE: %p\n", (void *) m);
218 notify_send(m->notify, NT_SCORE, 0, NULL);
219 }
220 OptNeedRescore = false;
221}
bool cs_subset_bool(const struct ConfigSubset *sub, const char *name)
Get a boolean config item by name.
Definition helpers.c:47
short cs_subset_sort(const struct ConfigSubset *sub, const char *name)
Get a sort config item by name.
Definition helpers.c:266
#define SORT_MASK
Mask for the sort id.
Definition sort.h:39
bool OptNeedRescore
(pseudo) set when the 'score' command is used
Definition globals.c:51
bool OptNeedResort
(pseudo) used to force a re-sort
Definition globals.c:52
EmailSortType
Methods for sorting Emails.
Definition sort.h:53
@ EMAIL_SORT_SCORE
Sort by the email's score.
Definition sort.h:58
bool OptSortSubthreads
(pseudo) used when $sort_aux changes
Definition globals.c:57
#define mutt_debug(LEVEL,...)
Definition logging2.h:91
#define mutt_using_threads()
Definition thread.h:113
@ LL_NOTIFY
Log of notifications.
Definition logging2.h:50
bool notify_send(struct Notify *notify, enum NotifyType event_type, int event_subtype, void *event_data)
Send out a notification message.
Definition notify.c:173
@ NT_SCORE
Email scoring has changed.
Definition notify_type.h:54
struct Notify * notify
Notifications: NotifyMailbox, EventMailbox.
Definition mailbox.h:144
Container for Accounts, Notifications.
Definition neomutt.h:41
struct ConfigSubset * sub
Inherited config items.
Definition neomutt.h:49
+ Here is the call graph for this function:
+ Here is the caller graph for this function:

◆ mutt_score_message()

void mutt_score_message ( struct Mailbox * m,
struct Email * e,
bool upd_mbox )

Apply scoring to an email.

Parameters
mMailbox
eEmail
upd_mboxIf true, update the Mailbox too

Definition at line 229 of file score.c.

230{
231 struct Score *tmp = NULL;
232 struct PatternCache cache = { 0 };
233
234 e->score = 0; /* in case of re-scoring */
235 for (tmp = ScoreList; tmp; tmp = tmp->next)
236 {
237 if (mutt_pattern_exec(SLIST_FIRST(tmp->pat), MUTT_MATCH_FULL_ADDRESS, NULL, e, &cache) > 0)
238 {
239 if (tmp->exact || (tmp->val == 9999) || (tmp->val == -9999))
240 {
241 e->score = tmp->val;
242 break;
243 }
244 e->score += tmp->val;
245 }
246 }
247 if (e->score < 0)
248 e->score = 0;
249
250 const short c_score_threshold_delete = cs_subset_number(NeoMutt->sub, "score_threshold_delete");
251 const short c_score_threshold_flag = cs_subset_number(NeoMutt->sub, "score_threshold_flag");
252 const short c_score_threshold_read = cs_subset_number(NeoMutt->sub, "score_threshold_read");
253
254 if (e->score <= c_score_threshold_delete)
255 mutt_set_flag(m, e, MUTT_DELETE, true, upd_mbox);
256 if (e->score <= c_score_threshold_read)
257 mutt_set_flag(m, e, MUTT_READ, true, upd_mbox);
258 if (e->score >= c_score_threshold_flag)
259 mutt_set_flag(m, e, MUTT_FLAG, true, upd_mbox);
260}
short cs_subset_number(const struct ConfigSubset *sub, const char *name)
Get a number config item by name.
Definition helpers.c:143
void mutt_set_flag(struct Mailbox *m, struct Email *e, enum MessageType flag, bool bf, bool upd_mbox)
Set a flag on an email.
Definition flags.c:54
@ MUTT_READ
Messages that have been read.
Definition mutt.h:92
@ MUTT_FLAG
Flagged messages.
Definition mutt.h:98
@ MUTT_DELETE
Messages to be deleted.
Definition mutt.h:94
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:1146
#define MUTT_MATCH_FULL_ADDRESS
Match the full address.
Definition lib.h:107
#define SLIST_FIRST(head)
Definition queue.h:227
struct Score * ScoreList
Linked list of email scoring rules.
Definition score.c:49
int score
Message score.
Definition email.h:113
Cache commonly-used patterns.
Definition lib.h:118
Scoring rule for email.
Definition score.h:38
bool exact
If this rule matches, don't evaluate any more.
Definition score.h:42
struct PatternList * pat
Pattern to match.
Definition score.h:40
int val
Score to add.
Definition score.h:41
struct Score * next
Linked list.
Definition score.h:43
+ Here is the call graph for this function:
+ Here is the caller graph for this function:

Variable Documentation

◆ ScoreList

struct Score* ScoreList
extern

Linked list of email scoring rules.

Definition at line 49 of file score.c.