neomutt.h File Reference

Container for Accounts, Notifications. More...

#include <locale.h>
#include <stdbool.h>
#include <sys/types.h>
#include "account.h"
#include "command.h"
#include "mailbox.h"

Include dependency graph for neomutt.h:

This graph shows which files directly or indirectly include this file:

Go to the source code of this file.

Data Structures
struct	NeoMutt
	Container for Accounts, Notifications. More...

Macros
#define	mutt_file_fopen_masked(PATH, MODE)

Enumerations
enum	NotifyGlobal { NT_GLOBAL_STARTUP = 1 , NT_GLOBAL_SHUTDOWN , NT_GLOBAL_COMMAND }
	Events not associated with an object. More...

Functions
bool	neomutt_account_add (struct NeoMutt *n, struct Account *a)
	Add an Account to the global list.
void	neomutt_account_remove (struct NeoMutt *n, const struct Account *a)
	Remove an Account from the global list.
void	neomutt_accounts_free (struct NeoMutt *n)
void	neomutt_free (struct NeoMutt **ptr)
	Free a NeoMutt.
struct NeoMutt *	neomutt_new (struct ConfigSet *cs)
	Create the main NeoMutt object.
struct MailboxArray	neomutt_mailboxes_get (struct NeoMutt *n, enum MailboxType type)
	Get an Array of matching Mailboxes.

Variables
struct NeoMutt *	NeoMutt
	Global NeoMutt object.

Detailed Description

Container for Accounts, Notifications.

Authors

• 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 neomutt.h.

Macro Definition Documentation

mutt_file_fopen_masked

#define mutt_file_fopen_masked	(		PATH,
			MODE )

Value:

mutt_file_fopen_masked_full(PATH, MODE, __FILE__, __LINE__, __func__)

Definition at line 80 of file neomutt.h.

Enumeration Type Documentation

NotifyGlobal

enum NotifyGlobal

Events not associated with an object.

Observers of NT_GLOBAL will not be passed any Event data.

Enumerator
NT_GLOBAL_STARTUP	NeoMutt is initialised.
NT_GLOBAL_SHUTDOWN	NeoMutt is about to close.
NT_GLOBAL_COMMAND	A NeoMutt command.

Definition at line 64 of file neomutt.h.

{
  NT_GLOBAL_STARTUP = 1, 
  NT_GLOBAL_SHUTDOWN,    
  NT_GLOBAL_COMMAND,     
};

Function Documentation

neomutt_account_add()

bool neomutt_account_add	(	struct NeoMutt *	n,
		struct Account *	a )

Add an Account to the global list.

Parameters

n	NeoMutt
a	Account to add

Return values

true	Account was added

Definition at line 114 of file neomutt.c.

{
  if (!n || !a)
    return false;
 
  ARRAY_ADD(&n->accounts, a);
  notify_set_parent(a->notify, n->notify);
 
  mutt_debug(LL_NOTIFY, "NT_ACCOUNT_ADD: %s %p\n",
             mailbox_get_type_name(a->type), (void *) a);
  struct EventAccount ev_a = { a };
  notify_send(n->notify, NT_ACCOUNT, NT_ACCOUNT_ADD, &ev_a);
  return true;
}

Here is the call graph for this function:

Here is the caller graph for this function:

neomutt_account_remove()

void neomutt_account_remove	(	struct NeoMutt *	n,
		const struct Account *	a )

Remove an Account from the global list.

Parameters

n	NeoMutt
a	Account to remove

Definition at line 134 of file neomutt.c.

{
  if (!n || !a || ARRAY_EMPTY(&n->accounts))
    return;
 
  struct Account **ap = NULL;
  ARRAY_FOREACH(ap, &n->accounts)
  {
    if ((*ap) != a)
      continue;
 
    ARRAY_REMOVE(&n->accounts, ap);
    account_free(ap);
    break;
  }
}

Here is the call graph for this function:

Here is the caller graph for this function:

neomutt_accounts_free()

void neomutt_accounts_free

(

struct NeoMutt *

n

)

• Free all the Accounts

  Parameters

  n

  NeoMutt

Definition at line 155 of file neomutt.c.

{
  if (!n)
    return;
 
  if (!ARRAY_EMPTY(&n->accounts))
  {
    mutt_debug(LL_NOTIFY, "NT_ACCOUNT_DELETE_ALL\n");
    struct EventAccount ev_a = { NULL };
    notify_send(n->notify, NT_ACCOUNT, NT_ACCOUNT_DELETE_ALL, &ev_a);
 
    struct Account **ap = NULL;
    ARRAY_FOREACH(ap, &n->accounts)
    {
      account_free(ap);
    }
  }
 
  ARRAY_FREE(&n->accounts);
}

Here is the call graph for this function:

Here is the caller graph for this function:

neomutt_free()

void neomutt_free

(

struct NeoMutt **

ptr

)

Free a NeoMutt.

Parameters

[out]

ptr

NeoMutt to free

Definition at line 85 of file neomutt.c.

{
  if (!ptr || !*ptr)
    return;
 
  struct NeoMutt *n = *ptr;
 
  neomutt_accounts_free(n);
  cs_subset_free(&n->sub);
  notify_free(&n->notify_resize);
  notify_free(&n->notify_timeout);
  notify_free(&n->notify);
  if (n->time_c_locale)
    freelocale(n->time_c_locale);
 
  FREE(&n->home_dir);
  FREE(&n->username);
 
  envlist_free(&n->env);
 
  FREE(ptr);
}

Here is the call graph for this function:

Here is the caller graph for this function:

neomutt_new()

struct NeoMutt * neomutt_new

(

struct ConfigSet *

cs

)

Create the main NeoMutt object.

Parameters

cs	Config Set

Return values

ptr	New NeoMutt

Definition at line 49 of file neomutt.c.

{
  if (!cs)
    return NULL;
 
  struct NeoMutt *n = MUTT_MEM_CALLOC(1, struct NeoMutt);
 
  ARRAY_INIT(&n->accounts);
  n->notify = notify_new();
  n->sub = cs_subset_new(NULL, NULL, n->notify);
  n->sub->cs = cs;
  n->sub->scope = SET_SCOPE_NEOMUTT;
 
  n->time_c_locale = duplocale(LC_GLOBAL_LOCALE);
  if (n->time_c_locale)
    n->time_c_locale = newlocale(LC_TIME_MASK, "C", n->time_c_locale);
 
  if (!n->time_c_locale)
  {
    mutt_error("%s", strerror(errno)); // LCOV_EXCL_LINE
    mutt_exit(1);                      // LCOV_EXCL_LINE
  }
 
  n->notify_timeout = notify_new();
  notify_set_parent(n->notify_timeout, n->notify);
 
  n->notify_resize = notify_new();
  notify_set_parent(n->notify_resize, n->notify);
 
  return n;
}

Here is the call graph for this function:

Here is the caller graph for this function:

neomutt_mailboxes_get()

struct MailboxArray neomutt_mailboxes_get	(	struct NeoMutt *	n,
		enum MailboxType	type )

Get an Array of matching Mailboxes.

Parameters

n	NeoMutt
type	Type of Account to match, see MailboxType

Return values

obj	Array of Mailboxes

Note

If type is MUTT_MAILBOX_ANY then all Mailbox types will be matched

Definition at line 184 of file neomutt.c.

{
  struct MailboxArray ma = ARRAY_HEAD_INITIALIZER;
 
  if (!n)
    return ma;
 
  struct Account **ap = NULL;
  struct Mailbox **mp = NULL;
 
  ARRAY_FOREACH(ap, &n->accounts)
  {
    struct Account *a = *ap;
    if ((type > MUTT_UNKNOWN) && (a->type != type))
      continue;
 
    ARRAY_FOREACH(mp, &a->mailboxes)
    {
      ARRAY_ADD(&ma, *mp);
    }
  }
 
  return ma;
}

Here is the call graph for this function:

Here is the caller graph for this function:

Variable Documentation

NeoMutt

struct NeoMutt* NeoMutt

extern

Global NeoMutt object.

Definition at line 42 of file neomutt.c.