neomutt.h File Reference

#include <stddef.h>
#include <stdbool.h>
#include "account.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...

Enumerations
enum	NotifyGlobal { NT_GLOBAL_STARTUP = 1, NT_GLOBAL_SHUTDOWN, NT_GLOBAL_TIMEOUT }
	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. More...
bool	neomutt_account_remove (struct NeoMutt *n, struct Account *a)
	Remove an Account from the global list. More...
void	neomutt_free (struct NeoMutt **ptr)
	Free a NeoMutt. More...
struct NeoMutt *	neomutt_new (struct ConfigSet *cs)
	Create the main NeoMutt object. More...
void	neomutt_mailboxlist_clear (struct MailboxList *ml)
	Free a Mailbox List. More...
size_t	neomutt_mailboxlist_get_all (struct MailboxList *head, struct NeoMutt *n, enum MailboxType type)
	Get a List of all Mailboxes. More...

Variables
struct NeoMutt *	NeoMutt
	Global NeoMutt object. More...

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.

Enumeration Type Documentation

NotifyGlobal

enum NotifyGlobal

Events not associated with an object.

Enumerator
NT_GLOBAL_STARTUP	NeoMutt is initialised.
NT_GLOBAL_SHUTDOWN	NeoMutt is about to close.
NT_GLOBAL_TIMEOUT	A timer has elapsed.

Definition at line 48 of file neomutt.h.

{
  NT_GLOBAL_STARTUP = 1, 
  NT_GLOBAL_SHUTDOWN,    
  NT_GLOBAL_TIMEOUT,     
};

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	If Account was added

Definition at line 84 of file neomutt.c.

{
  if (!n || !a)
    return false;
 
  TAILQ_INSERT_TAIL(&n->accounts, a, entries);
  notify_set_parent(a->notify, n->notify);
 
  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()

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

Remove an Account from the global list.

Parameters

n	NeoMutt
a	Account to remove

Return values

true	If Account was removed

Note

If a is NULL, all the Accounts will be removed

Definition at line 105 of file neomutt.c.

{
  if (!n)
    return false;
 
  bool result = false;
  struct Account *np = NULL;
  struct Account *tmp = NULL;
  TAILQ_FOREACH_SAFE(np, &n->accounts, entries, tmp)
  {
    if (!a || (np == a))
    {
      struct EventAccount ev_a = { np };
      notify_send(n->notify, NT_ACCOUNT, NT_ACCOUNT_REMOVE, &ev_a);
 
      TAILQ_REMOVE(&n->accounts, np, entries);
      notify_set_parent(n->notify, NULL);
      account_free(&np);
      result = true;
      if (a)
        break;
    }
  }
  return result;
}

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 64 of file neomutt.c.

{
  if (!ptr || !*ptr)
    return;
 
  struct NeoMutt *n = *ptr;
 
  neomutt_account_remove(n, NULL);
  cs_subset_free(&n->sub);
  notify_free(&n->notify);
 
  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 44 of file neomutt.c.

{
  if (!cs)
    return NULL;
 
  struct NeoMutt *n = mutt_mem_calloc(1, sizeof(*NeoMutt));
 
  TAILQ_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;
 
  return n;
}

Here is the call graph for this function:

Here is the caller graph for this function:

neomutt_mailboxlist_clear()

void neomutt_mailboxlist_clear

(

struct MailboxList *

ml

)

Free a Mailbox List.

Parameters

ml	Mailbox List to free

Note

The Mailboxes aren't freed

Definition at line 137 of file neomutt.c.

{
  if (!ml)
    return;
 
  struct MailboxNode *mn = NULL;
  struct MailboxNode *tmp = NULL;
  STAILQ_FOREACH_SAFE(mn, ml, entries, tmp)
  {
    STAILQ_REMOVE(ml, mn, MailboxNode, entries);
    FREE(&mn);
  }
}

Here is the caller graph for this function:

neomutt_mailboxlist_get_all()

size_t neomutt_mailboxlist_get_all	(	struct MailboxList *	head,
		struct NeoMutt *	n,
		enum MailboxType	type
	)

Get a List of all Mailboxes.

Parameters

head	List to store the Mailboxes
n	NeoMutt
type	Type of Account to match, see MailboxType

Return values

num	Number of Mailboxes in the List

Note

If type is MUTT_MAILBOX_ANY then all Mailbox types will be matched

Definition at line 160 of file neomutt.c.

{
  if (!n)
    return 0;
 
  size_t count = 0;
  struct Account *a = NULL;
  struct MailboxNode *mn = NULL;
 
  TAILQ_FOREACH(a, &n->accounts, entries)
  {
    if ((type > MUTT_UNKNOWN) && (a->type != type))
      continue;
 
    STAILQ_FOREACH(mn, &a->mailboxes, entries)
    {
      struct MailboxNode *mn2 = mutt_mem_calloc(1, sizeof(*mn2));
      mn2->mailbox = mn->mailbox;
      STAILQ_INSERT_TAIL(head, mn2, entries);
      count++;
    }
  }
 
  return count;
}

Here is the call graph for this function:

Here is the caller graph for this function:

Variable Documentation

NeoMutt

struct NeoMutt* NeoMutt

Global NeoMutt object.

Definition at line 37 of file neomutt.c.