NeoMutt  2024-03-23-23-gec7045
Teaching an old dog new tricks
DOXYGEN
Loading...
Searching...
No Matches
neomutt.h File Reference

Container for Accounts, Notifications. More...

#include <stddef.h>
#include <locale.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_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.
 
bool neomutt_account_remove (struct NeoMutt *n, const struct Account *a)
 Remove an Account from the global list.
 
void neomutt_free (struct NeoMutt **ptr)
 Free a NeoMutt.
 
struct NeoMuttneomutt_new (struct ConfigSet *cs)
 Create the main NeoMutt object.
 
void neomutt_mailboxlist_clear (struct MailboxList *ml)
 Free a Mailbox List.
 
size_t neomutt_mailboxlist_get_all (struct MailboxList *head, struct NeoMutt *n, enum MailboxType type)
 Get a List of all Mailboxes.
 

Variables

struct NeoMuttNeoMutt
 Global NeoMutt object.
 

Detailed Description

Container for Accounts, Notifications.

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

Enumeration Type Documentation

◆ 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 57 of file neomutt.h.

58{
62};
@ NT_GLOBAL_STARTUP
NeoMutt is initialised.
Definition: neomutt.h:59
@ NT_GLOBAL_COMMAND
A NeoMutt command.
Definition: neomutt.h:61
@ NT_GLOBAL_SHUTDOWN
NeoMutt is about to close.
Definition: neomutt.h:60

Function Documentation

◆ neomutt_account_add()

bool neomutt_account_add ( struct NeoMutt n,
struct Account a 
)

Add an Account to the global list.

Parameters
nNeoMutt
aAccount to add
Return values
trueAccount was added

Definition at line 105 of file neomutt.c.

106{
107 if (!n || !a)
108 return false;
109
110 TAILQ_INSERT_TAIL(&n->accounts, a, entries);
112
113 mutt_debug(LL_NOTIFY, "NT_ACCOUNT_ADD: %s %p\n",
114 mailbox_get_type_name(a->type), (void *) a);
115 struct EventAccount ev_a = { a };
117 return true;
118}
@ NT_ACCOUNT_ADD
Account has been added.
Definition: account.h:69
const char * mailbox_get_type_name(enum MailboxType type)
Get the type of a Mailbox.
Definition: mailbox.c:327
#define mutt_debug(LEVEL,...)
Definition: logging2.h:89
@ LL_NOTIFY
Log of notifications.
Definition: logging2.h:48
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
void notify_set_parent(struct Notify *notify, struct Notify *parent)
Set the parent notification handler.
Definition: notify.c:95
@ NT_ACCOUNT
Account has changed, NotifyAccount, EventAccount.
Definition: notify_type.h:36
#define TAILQ_INSERT_TAIL(head, elm, field)
Definition: queue.h:809
enum MailboxType type
Type of Mailboxes this Account contains.
Definition: account.h:37
struct Notify * notify
Notifications: NotifyAccount, EventAccount.
Definition: account.h:41
An Event that happened to an Account.
Definition: account.h:79
struct AccountList accounts
List of all Accounts.
Definition: neomutt.h:46
struct Notify * notify
Notifications handler.
Definition: neomutt.h:42
+ 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,
const struct Account a 
)

Remove an Account from the global list.

Parameters
nNeoMutt
aAccount to remove
Return values
trueAccount was removed
Note
If a is NULL, all the Accounts will be removed

Definition at line 128 of file neomutt.c.

129{
130 if (!n || TAILQ_EMPTY(&n->accounts))
131 return false;
132
133 if (!a)
134 {
135 mutt_debug(LL_NOTIFY, "NT_ACCOUNT_DELETE_ALL\n");
136 struct EventAccount ev_a = { NULL };
138 }
139
140 bool result = false;
141 struct Account *np = NULL;
142 struct Account *tmp = NULL;
143 TAILQ_FOREACH_SAFE(np, &n->accounts, entries, tmp)
144 {
145 if (a && (np != a))
146 continue;
147
148 TAILQ_REMOVE(&n->accounts, np, entries);
149 account_free(&np);
150 result = true;
151 if (a)
152 break;
153 }
154 return result;
155}
void account_free(struct Account **ptr)
Free an Account.
Definition: account.c:143
@ NT_ACCOUNT_DELETE_ALL
All Accounts are about to be deleted.
Definition: account.h:71
#define TAILQ_FOREACH_SAFE(var, head, field, tvar)
Definition: queue.h:735
#define TAILQ_REMOVE(head, elm, field)
Definition: queue.h:841
#define TAILQ_EMPTY(head)
Definition: queue.h:721
A group of associated Mailboxes.
Definition: account.h:36
+ 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]ptrNeoMutt to free

Definition at line 81 of file neomutt.c.

82{
83 if (!ptr || !*ptr)
84 return;
85
86 struct NeoMutt *n = *ptr;
87
93 if (n->time_c_locale)
94 freelocale(n->time_c_locale);
95
96 FREE(ptr);
97}
#define FREE(x)
Definition: memory.h:45
void notify_free(struct Notify **ptr)
Free a notification handler.
Definition: notify.c:75
bool neomutt_account_remove(struct NeoMutt *n, const struct Account *a)
Remove an Account from the global list.
Definition: neomutt.c:128
Container for Accounts, Notifications.
Definition: neomutt.h:41
struct Notify * notify_timeout
Timeout notifications handler.
Definition: neomutt.h:44
struct Notify * notify_resize
Window resize notifications handler.
Definition: neomutt.h:43
struct ConfigSubset * sub
Inherited config items.
Definition: neomutt.h:45
locale_t time_c_locale
Current locale but LC_TIME=C.
Definition: neomutt.h:47
void cs_subset_free(struct ConfigSubset **ptr)
Free a Config Subset.
Definition: subset.c:108
+ 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
csConfig Set
Return values
ptrNew NeoMutt

Definition at line 45 of file neomutt.c.

46{
47 if (!cs)
48 return NULL;
49
50 struct NeoMutt *n = mutt_mem_calloc(1, sizeof(*NeoMutt));
51
53 n->notify = notify_new();
54 n->sub = cs_subset_new(NULL, NULL, n->notify);
55 n->sub->cs = cs;
57
58 n->time_c_locale = duplocale(LC_GLOBAL_LOCALE);
59 if (n->time_c_locale)
60 n->time_c_locale = newlocale(LC_TIME_MASK, "C", n->time_c_locale);
61
62 if (!n->time_c_locale)
63 {
64 mutt_error(_("Out of memory")); // LCOV_EXCL_LINE
65 mutt_exit(1); // LCOV_EXCL_LINE
66 }
67
70
73
74 return n;
75}
#define mutt_error(...)
Definition: logging2.h:92
void mutt_exit(int code)
Leave NeoMutt NOW.
Definition: main.c:231
void * mutt_mem_calloc(size_t nmemb, size_t size)
Allocate zeroed memory on the heap.
Definition: memory.c:50
#define _(a)
Definition: message.h:28
struct Notify * notify_new(void)
Create a new notifications handler.
Definition: notify.c:62
#define TAILQ_INIT(head)
Definition: queue.h:765
struct ConfigSet * cs
Parent ConfigSet.
Definition: subset.h:51
enum ConfigScope scope
Scope of Subset, e.g. SET_SCOPE_ACCOUNT.
Definition: subset.h:49
struct ConfigSubset * cs_subset_new(const char *name, struct ConfigSubset *sub_parent, struct Notify *not_parent)
Create a new Config Subset.
Definition: subset.c:152
@ SET_SCOPE_NEOMUTT
This Config is NeoMutt-specific (global)
Definition: subset.h:38
+ 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
mlMailbox List to free
Note
The Mailboxes aren't freed

Definition at line 163 of file neomutt.c.

164{
165 if (!ml)
166 return;
167
168 struct MailboxNode *mn = NULL;
169 struct MailboxNode *tmp = NULL;
170 STAILQ_FOREACH_SAFE(mn, ml, entries, tmp)
171 {
172 STAILQ_REMOVE(ml, mn, MailboxNode, entries);
173 FREE(&mn);
174 }
175}
#define STAILQ_REMOVE(head, elm, type, field)
Definition: queue.h:402
#define STAILQ_FOREACH_SAFE(var, head, field, tvar)
Definition: queue.h:362
List of Mailboxes.
Definition: mailbox.h:166
+ 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
headList to store the Mailboxes
nNeoMutt
typeType of Account to match, see MailboxType
Return values
numNumber of Mailboxes in the List
Note
If type is MUTT_MAILBOX_ANY then all Mailbox types will be matched

Definition at line 186 of file neomutt.c.

188{
189 if (!n)
190 return 0;
191
192 size_t count = 0;
193 struct Account *a = NULL;
194 struct MailboxNode *mn = NULL;
195
196 TAILQ_FOREACH(a, &n->accounts, entries)
197 {
198 if ((type > MUTT_UNKNOWN) && (a->type != type))
199 continue;
200
201 STAILQ_FOREACH(mn, &a->mailboxes, entries)
202 {
203 struct MailboxNode *mn2 = mutt_mem_calloc(1, sizeof(*mn2));
204 mn2->mailbox = mn->mailbox;
205 STAILQ_INSERT_TAIL(head, mn2, entries);
206 count++;
207 }
208 }
209
210 return count;
211}
@ MUTT_UNKNOWN
Mailbox wasn't recognised.
Definition: mailbox.h:44
#define TAILQ_FOREACH(var, head, field)
Definition: queue.h:725
#define STAILQ_FOREACH(var, head, field)
Definition: queue.h:352
#define STAILQ_INSERT_TAIL(head, elm, field)
Definition: queue.h:389
struct MailboxList mailboxes
List of Mailboxes.
Definition: account.h:40
struct Mailbox * mailbox
Mailbox in the list.
Definition: mailbox.h:167
+ 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 38 of file neomutt.c.