regex.c File Reference

Regex Colour. More...

#include "config.h"
#include <stdbool.h>
#include <stddef.h>
#include <stdint.h>
#include "mutt/lib.h"
#include "config/lib.h"
#include "core/lib.h"
#include "index/lib.h"
#include "pattern/lib.h"
#include "attr.h"
#include "color.h"
#include "commands.h"
#include "debug.h"
#include "module_data.h"
#include "notify2.h"
#include "regex4.h"

Include dependency graph for regex.c:

Go to the source code of this file.

Functions
void	regex_colors_init (struct ColorModuleData *mod_data)
	Initialise the Regex colours.
void	regex_colors_reset (struct ColorModuleData *mod_data)
	Reset the Regex colours.
void	regex_colors_cleanup (struct ColorModuleData *mod_data)
	Cleanup the Regex colours.
void	regex_color_clear (struct RegexColor *rcol)
	Free the contents of a Regex colour.
void	regex_color_free (struct RegexColor **ptr)
	Free a Regex colour.
struct RegexColor *	regex_color_new (void)
	Create a new RegexColor.
struct RegexColorList *	regex_color_list_new (void)
	Create a new RegexColorList.
void	regex_color_list_clear (struct RegexColorList *rcl)
	Free the contents of a RegexColorList.
struct RegexColorList *	regex_colors_get_list (enum ColorId cid)
	Return the RegexColorList for a Colour ID.
static enum CommandResult	add_pattern (struct RegexColorList *rcl, const char *s, struct AttrColor *ac_val, struct Buffer *err, bool is_index, int match)
	Associate a colour to a pattern.
bool	regex_colors_parse_color_list (enum ColorId cid, const char *pat, struct AttrColor *ac, int *rc, struct Buffer *err)
	Parse a Regex 'color' command.
int	regex_colors_parse_status_list (enum ColorId cid, const char *pat, struct AttrColor *ac, int match, struct Buffer *err)
	Parse a Regex 'color status' command.
bool	regex_colors_parse_uncolor (enum ColorId cid, const char *pat)
	Parse a Regex 'uncolor' command.

Detailed Description

Regex Colour.

Authors

• Richard Russon
• Pietro Cerutti

Copyright

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

Definition in file regex.c.

Function Documentation

regex_colors_init()

void regex_colors_init

(

struct ColorModuleData *

mod_data

)

Initialise the Regex colours.

Parameters

mod_data

Color module data

Definition at line 52 of file regex.c.

{
  color_debug(LL_DEBUG5, "init AttachList, BodyList, etc\n");
  STAILQ_INIT(&mod_data->attach_list);
  STAILQ_INIT(&mod_data->body_list);
  STAILQ_INIT(&mod_data->header_list);
  STAILQ_INIT(&mod_data->index_author_list);
  STAILQ_INIT(&mod_data->index_collapsed_list);
  STAILQ_INIT(&mod_data->index_date_list);
  STAILQ_INIT(&mod_data->index_label_list);
  STAILQ_INIT(&mod_data->index_number_list);
  STAILQ_INIT(&mod_data->index_size_list);
  STAILQ_INIT(&mod_data->index_tags_list);
  STAILQ_INIT(&mod_data->index_flags_list);
  STAILQ_INIT(&mod_data->index_list);
  STAILQ_INIT(&mod_data->index_subject_list);
  STAILQ_INIT(&mod_data->index_tag_list);
  STAILQ_INIT(&mod_data->status_list);
}

Here is the call graph for this function:

Here is the caller graph for this function:

regex_colors_reset()

void regex_colors_reset

(

struct ColorModuleData *

mod_data

)

Reset the Regex colours.

Parameters

mod_data

Color module data

Definition at line 76 of file regex.c.

{
  color_debug(LL_DEBUG5, "reset regex\n");
  regex_color_list_clear(&mod_data->attach_list);
  regex_color_list_clear(&mod_data->body_list);
  regex_color_list_clear(&mod_data->header_list);
  regex_color_list_clear(&mod_data->index_list);
  regex_color_list_clear(&mod_data->index_author_list);
  regex_color_list_clear(&mod_data->index_collapsed_list);
  regex_color_list_clear(&mod_data->index_date_list);
  regex_color_list_clear(&mod_data->index_label_list);
  regex_color_list_clear(&mod_data->index_number_list);
  regex_color_list_clear(&mod_data->index_size_list);
  regex_color_list_clear(&mod_data->index_tags_list);
  regex_color_list_clear(&mod_data->index_flags_list);
  regex_color_list_clear(&mod_data->index_subject_list);
  regex_color_list_clear(&mod_data->index_tag_list);
  regex_color_list_clear(&mod_data->status_list);
}

Here is the call graph for this function:

Here is the caller graph for this function:

regex_colors_cleanup()

void regex_colors_cleanup

(

struct ColorModuleData *

mod_data

)

Cleanup the Regex colours.

Parameters

mod_data

Color module data

Definition at line 100 of file regex.c.

{
  regex_colors_reset(mod_data);
}

Here is the call graph for this function:

Here is the caller graph for this function:

regex_color_clear()

void regex_color_clear

(

struct RegexColor *

rcol

)

Free the contents of a Regex colour.

Parameters

rcol	RegexColor to empty

Note

The RegexColor object isn't freed

Definition at line 111 of file regex.c.

{
  if (!rcol)
    return;
 
  rcol->match = 0;
  rcol->stop_matching = false;
 
  attr_color_clear(&rcol->attr_color);
  FREE(&rcol->pattern);
  regfree(&rcol->regex);
  mutt_pattern_free(&rcol->color_pattern);
}

Here is the call graph for this function:

Here is the caller graph for this function:

regex_color_free()

void regex_color_free

(

struct RegexColor **

ptr

)

Free a Regex colour.

Parameters

ptr	RegexColor to free

Definition at line 129 of file regex.c.

{
  if (!ptr || !*ptr)
    return;
 
  struct RegexColor *rcol = *ptr;
  regex_color_clear(rcol);
 
  FREE(ptr);
}

Here is the call graph for this function:

Here is the caller graph for this function:

regex_color_new()

struct RegexColor * regex_color_new

(

void

)

Create a new RegexColor.

Return values

ptr	New RegexColor

Definition at line 144 of file regex.c.

{
  return MUTT_MEM_CALLOC(1, struct RegexColor);
}

Here is the caller graph for this function:

regex_color_list_new()

struct RegexColorList * regex_color_list_new

(

void

)

Create a new RegexColorList.

Return values

ptr	New RegexColorList

Definition at line 153 of file regex.c.

{
  struct RegexColorList *rcl = MUTT_MEM_CALLOC(1, struct RegexColorList);
 
  STAILQ_INIT(rcl);
 
  struct RegexColor *rcol = regex_color_new();
  STAILQ_INSERT_TAIL(rcl, rcol, entries);
 
  return rcl;
}

Here is the call graph for this function:

regex_color_list_clear()

void regex_color_list_clear

(

struct RegexColorList *

rcl

)

Free the contents of a RegexColorList.

Parameters

rcl	List to clear

Free each of the RegexColorList in a list.

Note

The list object isn't freed, only emptied

Definition at line 173 of file regex.c.

{
  if (!rcl)
    return;
 
  struct RegexColor *np = NULL;
  struct RegexColor *tmp = NULL;
  STAILQ_FOREACH_SAFE(np, rcl, entries, tmp)
  {
    STAILQ_REMOVE(rcl, np, RegexColor, entries);
    regex_color_free(&np);
  }
}

Here is the call graph for this function:

Here is the caller graph for this function:

regex_colors_get_list()

struct RegexColorList * regex_colors_get_list

(

enum ColorId

cid

)

Return the RegexColorList for a Colour ID.

Parameters

cid	Colour ID, e.g. MT_COLOR_BODY

Return values

ptr	RegexColorList

Definition at line 192 of file regex.c.

{
  struct ColorModuleData *mod_data = neomutt_get_module_data(NeoMutt, MODULE_ID_COLOR);
  switch (cid)
  {
    case MT_COLOR_ATTACH_HEADERS:
      return &mod_data->attach_list;
    case MT_COLOR_BODY:
      return &mod_data->body_list;
    case MT_COLOR_HEADER:
      return &mod_data->header_list;
    case MT_COLOR_INDEX:
      return &mod_data->index_list;
    case MT_COLOR_INDEX_AUTHOR:
      return &mod_data->index_author_list;
    case MT_COLOR_INDEX_COLLAPSED:
      return &mod_data->index_collapsed_list;
    case MT_COLOR_INDEX_DATE:
      return &mod_data->index_date_list;
    case MT_COLOR_INDEX_FLAGS:
      return &mod_data->index_flags_list;
    case MT_COLOR_INDEX_LABEL:
      return &mod_data->index_label_list;
    case MT_COLOR_INDEX_NUMBER:
      return &mod_data->index_number_list;
    case MT_COLOR_INDEX_SIZE:
      return &mod_data->index_size_list;
    case MT_COLOR_INDEX_SUBJECT:
      return &mod_data->index_subject_list;
    case MT_COLOR_INDEX_TAG:
      return &mod_data->index_tag_list;
    case MT_COLOR_INDEX_TAGS:
      return &mod_data->index_tags_list;
    case MT_COLOR_STATUS:
      return &mod_data->status_list;
    default:
      return NULL;
  }
}

Here is the call graph for this function:

Here is the caller graph for this function:

add_pattern()

enum CommandResult add_pattern ( struct RegexColorList * rcl, const char * s, struct AttrColor * ac_val, struct Buffer * err, bool is_index, int match )

static

Associate a colour to a pattern.

Parameters

rcl	List of existing colours
s	String to match
ac_val	Colour value to use
err	Buffer for error messages
is_index	true of this is for the index
match	Number of regex subexpression to match (0 for entire pattern)

Return values

CommandResult

Result e.g. MUTT_CMD_SUCCESS

is_index used to store compiled pattern only for 'index' color object when called from parse_color()

Definition at line 245 of file regex.c.

{
  struct RegexColor *rcol = NULL;
 
  STAILQ_FOREACH(rcol, rcl, entries)
  {
    if (mutt_str_equal(s, rcol->pattern))
      break;
  }
 
  if (rcol) // found a matching regex
  {
    struct AttrColor *ac = &rcol->attr_color;
    attr_color_overwrite(ac, ac_val);
  }
  else
  {
    rcol = regex_color_new();
    if (is_index)
    {
      struct Buffer *buf = buf_pool_get();
      buf_strcpy(buf, s);
      const char *const c_simple_search = cs_subset_string(NeoMutt->sub, "simple_search");
      mutt_check_simple(buf, NONULL(c_simple_search));
      struct MailboxView *mv_cur = get_current_mailbox_view();
      rcol->color_pattern = mutt_pattern_comp(mv_cur, buf_string(buf), MUTT_PC_FULL_MSG, err);
      buf_pool_release(&buf);
      if (!rcol->color_pattern)
      {
        regex_color_free(&rcol);
        return MUTT_CMD_ERROR;
      }
    }
    else
    {
      // Smart case matching
      uint16_t flags = mutt_mb_is_lower(s) ? REG_ICASE : 0;
 
      const int r = REG_COMP(&rcol->regex, s, flags);
      if (r != 0)
      {
        regerror(r, &rcol->regex, err->data, err->dsize);
        buf_fix_dptr(err);
        regex_color_free(&rcol);
        return MUTT_CMD_ERROR;
      }
    }
    rcol->pattern = mutt_str_dup(s);
    rcol->match = match;
 
    struct AttrColor *ac = &rcol->attr_color;
 
    attr_color_overwrite(ac, ac_val);
 
    STAILQ_INSERT_TAIL(rcl, rcol, entries);
  }
 
  if (is_index)
  {
    /* force re-caching of index colors */
    struct ColorModuleData *mod_data = neomutt_get_module_data(NeoMutt, MODULE_ID_COLOR);
    struct EventColor ev_c = { MT_COLOR_INDEX, NULL };
    notify_send(mod_data->colors_notify, NT_COLOR, NT_COLOR_SET, &ev_c);
  }
 
  return MUTT_CMD_SUCCESS;
}

Here is the call graph for this function:

Here is the caller graph for this function:

regex_colors_parse_color_list()

bool regex_colors_parse_color_list	(	enum ColorId	cid,
		const char *	pat,
		struct AttrColor *	ac,
		int *	rc,
		struct Buffer *	err )

Parse a Regex 'color' command.

Parameters

cid	Colour ID, should be MT_COLOR_STATUS
pat	Regex pattern
ac	Colour value to use
rc	Return code, e.g. MUTT_CMD_SUCCESS
err	Buffer for error messages

Return values

true	Colour was parsed

Parse a Regex 'color' command, e.g. "color index green default pattern"

Definition at line 326 of file regex.c.

{
  if (cid == MT_COLOR_STATUS)
    return false;
 
  struct RegexColorList *rcl = regex_colors_get_list(cid);
  if (!rcl)
    return false;
 
  bool is_index = false;
  switch (cid)
  {
    case MT_COLOR_ATTACH_HEADERS:
    case MT_COLOR_BODY:
      break;
    case MT_COLOR_HEADER:
      break;
    case MT_COLOR_INDEX:
    case MT_COLOR_INDEX_AUTHOR:
    case MT_COLOR_INDEX_COLLAPSED:
    case MT_COLOR_INDEX_DATE:
    case MT_COLOR_INDEX_FLAGS:
    case MT_COLOR_INDEX_LABEL:
    case MT_COLOR_INDEX_NUMBER:
    case MT_COLOR_INDEX_SIZE:
    case MT_COLOR_INDEX_SUBJECT:
    case MT_COLOR_INDEX_TAG:
    case MT_COLOR_INDEX_TAGS:
      is_index = true;
      break;
    default:
      return false;
  }
 
  *rc = add_pattern(rcl, pat, ac, err, is_index, 0);
 
  struct Buffer *buf = buf_pool_get();
  get_colorid_name(cid, buf);
  color_debug(LL_DEBUG5, "NT_COLOR_SET: %s\n", buf_string(buf));
  buf_pool_release(&buf);
 
  if (!is_index) // else it will be logged in add_pattern()
  {
    struct ColorModuleData *mod_data = neomutt_get_module_data(NeoMutt, MODULE_ID_COLOR);
    struct EventColor ev_c = { cid, NULL };
    notify_send(mod_data->colors_notify, NT_COLOR, NT_COLOR_SET, &ev_c);
  }
 
  return true;
}

Here is the call graph for this function:

Here is the caller graph for this function:

regex_colors_parse_status_list()

int regex_colors_parse_status_list	(	enum ColorId	cid,
		const char *	pat,
		struct AttrColor *	ac,
		int	match,
		struct Buffer *	err )

Parse a Regex 'color status' command.

Parameters

cid	Colour ID, should be MT_COLOR_STATUS
pat	Regex pattern
ac	Colour value to use
match	Use the nth regex submatch
err	Buffer for error messages

Return values

CommandResult

Result e.g. MUTT_CMD_SUCCESS

Definition at line 388 of file regex.c.

{
  if (cid != MT_COLOR_STATUS)
    return MUTT_CMD_ERROR;
 
  struct ColorModuleData *mod_data = neomutt_get_module_data(NeoMutt, MODULE_ID_COLOR);
  int rc = add_pattern(&mod_data->status_list, pat, ac, err, false, match);
  if (rc != MUTT_CMD_SUCCESS)
    return rc;
 
  struct Buffer *buf = buf_pool_get();
  get_colorid_name(cid, buf);
  color_debug(LL_DEBUG5, "NT_COLOR_SET: %s\n", buf_string(buf));
  buf_pool_release(&buf);
 
  struct EventColor ev_c = { cid, NULL };
  notify_send(mod_data->colors_notify, NT_COLOR, NT_COLOR_SET, &ev_c);
 
  return rc;
}

Here is the call graph for this function:

Here is the caller graph for this function:

regex_colors_parse_uncolor()

bool regex_colors_parse_uncolor	(	enum ColorId	cid,
		const char *	pat )

Parse a Regex 'uncolor' command.

Parameters

cid	Colour ID, e.g. MT_COLOR_STATUS
pat	Pattern to remove (NULL to remove all)

Return values

true	If colours were unset

Definition at line 416 of file regex.c.

{
  struct RegexColorList *cl = regex_colors_get_list(cid);
  if (!cl)
    return false;
 
  struct ColorModuleData *mod_data = neomutt_get_module_data(NeoMutt, MODULE_ID_COLOR);
 
  if (!pat) // Reset all patterns
  {
    if (STAILQ_EMPTY(cl))
      return true;
 
    mutt_debug(LL_NOTIFY, "NT_COLOR_RESET: [ALL]\n");
    struct EventColor ev_c = { cid, NULL };
    notify_send(mod_data->colors_notify, NT_COLOR, NT_COLOR_RESET, &ev_c);
 
    regex_color_list_clear(cl);
    return true;
  }
 
  bool rc = false;
  struct RegexColor *np = NULL;
  struct RegexColor *prev = NULL;
  prev = NULL;
  STAILQ_FOREACH(np, cl, entries)
  {
    if (mutt_str_equal(pat, np->pattern))
    {
      rc = true;
 
      color_debug(LL_DEBUG1, "Freeing pattern \"%s\" from XXX\n", pat);
      if (prev)
        STAILQ_REMOVE_AFTER(cl, prev, entries);
      else
        STAILQ_REMOVE_HEAD(cl, entries);
 
      mutt_debug(LL_NOTIFY, "NT_COLOR_RESET: XXX\n");
      struct EventColor ev_c = { cid, &np->attr_color };
      notify_send(mod_data->colors_notify, NT_COLOR, NT_COLOR_RESET, &ev_c);
 
      regex_color_free(&np);
      break;
    }
    prev = np;
  }
 
  return rc;
}

Here is the call graph for this function:

Here is the caller graph for this function: