dlg_alias.c File Reference

Address book. More...

#include "config.h"
#include <stdbool.h>
#include <stdint.h>
#include <stdio.h>
#include <string.h>
#include "mutt/lib.h"
#include "address/lib.h"
#include "config/lib.h"
#include "email/lib.h"
#include "core/lib.h"
#include "gui/lib.h"
#include "lib.h"
#include "menu/lib.h"
#include "pattern/lib.h"
#include "send/lib.h"
#include "alias.h"
#include "format_flags.h"
#include "functions.h"
#include "gui.h"
#include "keymap.h"
#include "mutt_logging.h"
#include "muttlib.h"
#include "opcodes.h"

Include dependency graph for dlg_alias.c:

Go to the source code of this file.

Functions
static const char *	alias_format_str (char *buf, size_t buflen, size_t col, int cols, char op, const char *src, const char *prec, const char *if_str, const char *else_str, intptr_t data, MuttFormatFlags flags)
	Format a string for the alias list - Implements format_t -. More...
static void	alias_make_entry (struct Menu *menu, char *buf, size_t buflen, int line)
	Format a menu item for the alias list - Implements Menu::make_entry() -. More...
static int	alias_tag (struct Menu *menu, int sel, int act)
	Tag some aliases - Implements Menu::tag() -. More...
static int	alias_alias_observer (struct NotifyCallback *nc)
	Notification that an Alias has changed - Implements observer_t -. More...
static int	alias_window_observer (struct NotifyCallback *nc)
	Notification that a Window has changed - Implements observer_t -. More...
static struct MuttWindow *	alias_dialog_new (struct AliasMenuData *mdata)
	Create an Alias Selection Dialog. More...
static bool	dlg_select_alias (struct Buffer *buf, struct AliasMenuData *mdata)
	Display a menu of Aliases. More...
int	alias_complete (char *buf, size_t buflen, struct ConfigSubset *sub)
	Alias completion routine. More...
void	alias_dialog (struct Mailbox *m, struct ConfigSubset *sub)
	Open the aliases dialog. More...

Variables
static const struct Mapping	AliasHelp []
	Help Bar for the Alias dialog (address book) More...

Detailed Description

Address book.

Authors

• Michael R. Elkins
• Pietro Cerutti
• Richard Russon

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 dlg_alias.c.

Function Documentation

alias_dialog_new()

static struct MuttWindow * alias_dialog_new ( struct AliasMenuData *  mdata )

static

Create an Alias Selection Dialog.

Parameters

mdata

Menu data holding Aliases

Return values

ptr	New Dialog

Definition at line 279 of file dlg_alias.c.

{
  struct MuttWindow *dlg = simple_dialog_new(MENU_ALIAS, WT_DLG_ALIAS, AliasHelp);
 
  struct Menu *menu = dlg->wdata;
 
  menu->make_entry = alias_make_entry;
  menu->custom_search = true;
  menu->tag = alias_tag;
  menu->max = alias_array_count_visible(&mdata->ava);
  menu->mdata = mdata;
  menu->mdata_free = NULL; // Menu doesn't own the data
 
  struct MuttWindow *win_menu = menu->win;
 
  // Override the Simple Dialog's recalc()
  win_menu->recalc = alias_recalc;
 
  struct MuttWindow *sbar = window_find_child(dlg, WT_STATUS_BAR);
  alias_set_title(sbar, mdata->title, mdata->limit);
 
  // NT_COLOR is handled by the SimpleDialog
  notify_observer_add(NeoMutt->notify, NT_ALIAS, alias_alias_observer, menu);
  notify_observer_add(NeoMutt->notify, NT_CONFIG, alias_config_observer, menu);
  notify_observer_add(win_menu->notify, NT_WINDOW, alias_window_observer, win_menu);
 
  return dlg;
}

Here is the call graph for this function:

Here is the caller graph for this function:

dlg_select_alias()

static bool dlg_select_alias ( struct Buffer *  buf, struct AliasMenuData *  mdata  )

static

Display a menu of Aliases.

Parameters

buf	Buffer for expanded aliases
mdata	Menu data holding Aliases

Return values

true	Selection was made

Definition at line 314 of file dlg_alias.c.

{
  if (ARRAY_EMPTY(&mdata->ava))
  {
    mutt_warning(_("You have no aliases"));
    return false;
  }
 
  mdata->query = buf;
  mdata->title = mutt_str_dup(_("Aliases"));
 
  struct MuttWindow *dlg = alias_dialog_new(mdata);
  struct Menu *menu = dlg->wdata;
  struct MuttWindow *win_sbar = window_find_child(dlg, WT_STATUS_BAR);
  mdata->menu = menu;
  mdata->sbar = win_sbar;
 
  alias_array_sort(&mdata->ava, mdata->sub);
 
  struct AliasView *avp = NULL;
  ARRAY_FOREACH(avp, &mdata->ava)
  {
    avp->num = ARRAY_FOREACH_IDX;
  }
 
  // ---------------------------------------------------------------------------
  // Event Loop
  int rc = 0;
  int op = OP_NULL;
  do
  {
    menu_tagging_dispatcher(menu->win, op);
    window_redraw(NULL);
 
    op = km_dokey(MENU_ALIAS);
    mutt_debug(LL_DEBUG1, "Got op %s (%d)\n", opcodes_get_name(op), op);
    if (op < 0)
      continue;
    if (op == OP_NULL)
    {
      km_error_key(MENU_ALIAS);
      continue;
    }
    mutt_clear_error();
 
    rc = alias_function_dispatcher(dlg, op);
    if (rc == FR_UNKNOWN)
      rc = menu_function_dispatcher(menu->win, op);
    if (rc == FR_UNKNOWN)
      rc = global_function_dispatcher(NULL, op);
  } while ((rc != FR_DONE) && (rc != FR_CONTINUE));
  // ---------------------------------------------------------------------------
 
  simple_dialog_free(&dlg);
  window_redraw(NULL);
  return (rc == FR_CONTINUE); // Was a selection made?
}

Here is the call graph for this function:

Here is the caller graph for this function:

alias_complete()

int alias_complete	(	char *	buf,
		size_t	buflen,
		struct ConfigSubset *	sub
	)

Alias completion routine.

Parameters

buf	Partial Alias to complete
buflen	Length of buffer
sub	Config items

Return values

1	Success
0	Error

Given a partial alias, this routine attempts to fill in the alias from the alias list as much as possible. if given empty search string or found nothing, present all aliases

Definition at line 384 of file dlg_alias.c.

{
  struct Alias *np = NULL;
  char bestname[8192] = { 0 };
 
  struct AliasMenuData mdata = { ARRAY_HEAD_INITIALIZER, NULL, sub };
  mdata.limit = mutt_str_dup(buf);
 
  if (buf[0] != '\0')
  {
    TAILQ_FOREACH(np, &Aliases, entries)
    {
      if (np->name && mutt_strn_equal(np->name, buf, strlen(buf)))
      {
        if (bestname[0] == '\0') /* init */
        {
          mutt_str_copy(bestname, np->name,
                        MIN(mutt_str_len(np->name) + 1, sizeof(bestname)));
        }
        else
        {
          int i;
          for (i = 0; np->name[i] && (np->name[i] == bestname[i]); i++)
            ; // do nothing
 
          bestname[i] = '\0';
        }
      }
    }
 
    if (bestname[0] == '\0')
    {
      // Create a View Array of all the Aliases
      FREE(&mdata.limit);
      TAILQ_FOREACH(np, &Aliases, entries)
      {
        alias_array_alias_add(&mdata.ava, np);
      }
    }
    else
    {
      /* fake the pattern for menu title */
      char *mtitle = NULL;
      mutt_str_asprintf(&mtitle, "~f ^%s", buf);
      FREE(&mdata.limit);
      mdata.limit = mtitle;
 
      if (!mutt_str_equal(bestname, buf))
      {
        /* we are adding something to the completion */
        mutt_str_copy(buf, bestname, mutt_str_len(bestname) + 1);
        FREE(&mdata.limit);
        return 1;
      }
 
      /* build alias list and show it */
      TAILQ_FOREACH(np, &Aliases, entries)
      {
        int aasize = alias_array_alias_add(&mdata.ava, np);
 
        struct AliasView *av = ARRAY_GET(&mdata.ava, aasize - 1);
 
        if (np->name && !mutt_strn_equal(np->name, buf, strlen(buf)))
        {
          av->is_visible = false;
        }
      }
    }
  }
 
  if (ARRAY_EMPTY(&mdata.ava))
  {
    TAILQ_FOREACH(np, &Aliases, entries)
    {
      alias_array_alias_add(&mdata.ava, np);
    }
 
    mutt_pattern_alias_func(NULL, &mdata, NULL);
  }
 
  if (!dlg_select_alias(NULL, &mdata))
    goto done;
 
  buf[0] = '\0';
 
  // Extract the selected aliases
  struct Buffer *tmpbuf = mutt_buffer_pool_get();
  struct AliasView *avp = NULL;
  ARRAY_FOREACH(avp, &mdata.ava)
  {
    if (!avp->is_tagged)
      continue;
 
    mutt_addrlist_write(&avp->alias->addr, tmpbuf, true);
  }
  mutt_str_copy(buf, mutt_buffer_string(tmpbuf), buflen);
  mutt_buffer_pool_release(&tmpbuf);
 
done:
  // Process any deleted aliases
  ARRAY_FOREACH(avp, &mdata.ava)
  {
    if (!avp->is_deleted)
      continue;
 
    TAILQ_REMOVE(&Aliases, avp->alias, entries);
    alias_free(&avp->alias);
  }
 
  ARRAY_FREE(&mdata.ava);
  FREE(&mdata.limit);
  FREE(&mdata.title);
 
  return 0;
}

Here is the call graph for this function:

Here is the caller graph for this function:

alias_dialog()

void alias_dialog	(	struct Mailbox *	m,
		struct ConfigSubset *	sub
	)

Open the aliases dialog.

Parameters

m	Mailbox
sub	Config item

Definition at line 505 of file dlg_alias.c.

{
  struct Alias *np = NULL;
 
  struct AliasMenuData mdata = { ARRAY_HEAD_INITIALIZER, NULL, sub };
 
  // Create a View Array of all the Aliases
  TAILQ_FOREACH(np, &Aliases, entries)
  {
    alias_array_alias_add(&mdata.ava, np);
  }
 
  if (!dlg_select_alias(NULL, &mdata))
    goto done;
 
  // Prepare the "To:" field of a new email
  struct Email *e = email_new();
  e->env = mutt_env_new();
 
  struct AliasView *avp = NULL;
  ARRAY_FOREACH(avp, &mdata.ava)
  {
    if (!avp->is_tagged)
      continue;
 
    struct AddressList al_copy = TAILQ_HEAD_INITIALIZER(al_copy);
    if (alias_to_addrlist(&al_copy, avp->alias))
    {
      mutt_addrlist_copy(&e->env->to, &al_copy, false);
      mutt_addrlist_clear(&al_copy);
    }
  }
 
  mutt_send_message(SEND_REVIEW_TO, e, NULL, m, NULL, sub);
 
done:
  // Process any deleted aliases
  ARRAY_FOREACH(avp, &mdata.ava)
  {
    if (avp->is_deleted)
    {
      TAILQ_REMOVE(&Aliases, avp->alias, entries);
      alias_free(&avp->alias);
    }
  }
 
  ARRAY_FREE(&mdata.ava);
  FREE(&mdata.limit);
  FREE(&mdata.title);
}

Here is the call graph for this function:

Here is the caller graph for this function:

Variable Documentation

AliasHelp

const struct Mapping AliasHelp[]

static

Initial value:

= {
  
  { N_("Exit"),     OP_EXIT },
  { N_("Del"),      OP_DELETE },
  { N_("Undel"),    OP_UNDELETE },
  { N_("Sort"),     OP_SORT },
  { N_("Rev-Sort"), OP_SORT_REVERSE },
  { N_("Select"),   OP_GENERIC_SELECT_ENTRY },
  { N_("Help"),     OP_HELP },
  { NULL, 0 },
  
}

Help Bar for the Alias dialog (address book)

Definition at line 99 of file dlg_alias.c.