NeoMutt  2024-12-12-14-g7b49f7
Teaching an old dog new tricks
DOXYGEN
Loading...
Searching...
No Matches
Browser Function API

Prototype for a Browser Function. More...

Functions

static int op_browser_new_file (struct BrowserPrivateData *priv, int op)
 Select a new file in this directory - Implements browser_function_t -.
 
static int op_browser_subscribe (struct BrowserPrivateData *priv, int op)
 Subscribe to current mbox (IMAP/NNTP only) - Implements browser_function_t -.
 
static int op_browser_tell (struct BrowserPrivateData *priv, int op)
 Display the currently selected file's name - Implements browser_function_t -.
 
static int op_browser_toggle_lsub (struct BrowserPrivateData *priv, int op)
 Toggle view all/subscribed mailboxes (IMAP only) - Implements browser_function_t -.
 
static int op_browser_view_file (struct BrowserPrivateData *priv, int op)
 View file - Implements browser_function_t -.
 
static int op_catchup (struct BrowserPrivateData *priv, int op)
 Mark all articles in newsgroup as read - Implements browser_function_t -.
 
static int op_change_directory (struct BrowserPrivateData *priv, int op)
 Change directories - Implements browser_function_t -.
 
static int op_create_mailbox (struct BrowserPrivateData *priv, int op)
 Create a new mailbox (IMAP only) - Implements browser_function_t -.
 
static int op_delete_mailbox (struct BrowserPrivateData *priv, int op)
 Delete the current mailbox (IMAP only) - Implements browser_function_t -.
 
static int op_enter_mask (struct BrowserPrivateData *priv, int op)
 Enter a file mask - Implements browser_function_t -.
 
static int op_exit (struct BrowserPrivateData *priv, int op)
 Exit this menu - Implements browser_function_t -.
 
static int op_generic_select_entry (struct BrowserPrivateData *priv, int op)
 Select the current entry - Implements browser_function_t -.
 
static int op_load_active (struct BrowserPrivateData *priv, int op)
 Load list of all newsgroups from NNTP server - Implements browser_function_t -.
 
static int op_mailbox_list (struct BrowserPrivateData *priv, int op)
 List mailboxes with new mail - Implements browser_function_t -.
 
static int op_rename_mailbox (struct BrowserPrivateData *priv, int op)
 Rename the current mailbox (IMAP only) - Implements browser_function_t -.
 
static int op_sort (struct BrowserPrivateData *priv, int op)
 Sort messages - Implements browser_function_t -.
 
static int op_subscribe_pattern (struct BrowserPrivateData *priv, int op)
 Subscribe to newsgroups matching a pattern - Implements browser_function_t -.
 
static int op_toggle_mailboxes (struct BrowserPrivateData *priv, int op)
 Toggle whether to browse mailboxes or all files - Implements browser_function_t -.
 

Detailed Description

Prototype for a Browser Function.

Parameters
privPrivate Browser data
opOperation to perform, e.g. OP_MAIN_LIMIT
Return values
enumFunctionRetval

Function Documentation

◆ op_browser_new_file()

static int op_browser_new_file ( struct BrowserPrivateData priv,
int  op 
)
static

Select a new file in this directory - Implements browser_function_t -.

Definition at line 152 of file functions.c.

153{
154 struct Buffer *buf = buf_pool_get();
155 buf_printf(buf, "%s/", buf_string(&LastDir));
156
157 struct FileCompletionData cdata = { false, priv->mailbox, NULL, NULL };
158 const int rc = mw_get_field(_("New file name: "), buf, MUTT_COMP_NO_FLAGS,
159 HC_FILE, &CompleteMailboxOps, &cdata);
160 if (rc != 0)
161 {
162 buf_pool_release(&buf);
163 return FR_NO_ACTION;
164 }
165
166 buf_copy(priv->file, buf);
167 buf_pool_release(&buf);
168 priv->done = true;
169 return FR_DONE;
170}
const struct CompleteOps CompleteMailboxOps
Auto-Completion of Files / Mailboxes.
Definition: complete.c:160
int buf_printf(struct Buffer *buf, const char *fmt,...)
Format a string overwriting a Buffer.
Definition: buffer.c:161
size_t buf_copy(struct Buffer *dst, const struct Buffer *src)
Copy a Buffer's contents to another Buffer.
Definition: buffer.c:601
static const char * buf_string(const struct Buffer *buf)
Convert a buffer to a const char * "string".
Definition: buffer.h:96
@ FR_DONE
Exit the Dialog.
Definition: dispatcher.h:35
@ FR_NO_ACTION
Valid function - no action performed.
Definition: dispatcher.h:37
struct Buffer LastDir
Browser: previous selected directory.
Definition: dlg_browser.c:136
int mw_get_field(const char *prompt, struct Buffer *buf, CompletionFlags complete, enum HistoryClass hclass, const struct CompleteOps *comp_api, void *cdata)
Ask the user for a string -.
Definition: window.c:274
@ HC_FILE
Files.
Definition: lib.h:56
#define _(a)
Definition: message.h:28
#define MUTT_COMP_NO_FLAGS
No flags are set.
Definition: mutt.h:56
struct Buffer * buf_pool_get(void)
Get a Buffer from the pool.
Definition: pool.c:82
void buf_pool_release(struct Buffer **ptr)
Return a Buffer to the pool.
Definition: pool.c:96
bool done
Should we close the Dialog?
Definition: private_data.h:52
struct Mailbox * mailbox
Mailbox.
Definition: private_data.h:37
struct Buffer * file
Buffer for the result.
Definition: private_data.h:36
String manipulation buffer.
Definition: buffer.h:36
Input for the file completion function.
Definition: curs_lib.h:40
+ Here is the call graph for this function:

◆ op_browser_subscribe()

static int op_browser_subscribe ( struct BrowserPrivateData priv,
int  op 
)
static

Subscribe to current mbox (IMAP/NNTP only) - Implements browser_function_t -.

This function handles:

  • OP_BROWSER_SUBSCRIBE
  • OP_BROWSER_UNSUBSCRIBE

Definition at line 179 of file functions.c.

180{
181 if (OptNews)
182 {
184 int index = menu_get_index(priv->menu);
185
186 if (ARRAY_EMPTY(&priv->state.entry))
187 {
188 mutt_error(_("No newsgroups match the mask"));
189 return FR_ERROR;
190 }
191
192 int rc = nntp_newsrc_parse(adata);
193 if (rc < 0)
194 return FR_ERROR;
195
196 struct FolderFile *ff = ARRAY_GET(&priv->state.entry, index);
197 if (op == OP_BROWSER_SUBSCRIBE)
198 mutt_newsgroup_subscribe(adata, ff->name);
199 else
201
202 menu_set_index(priv->menu, index + 1);
203
204 if (rc > 0)
206 nntp_newsrc_update(adata);
207 nntp_clear_cache(adata);
208 nntp_newsrc_close(adata);
209 }
210 else
211 {
212 if (ARRAY_EMPTY(&priv->state.entry))
213 {
214 mutt_error(_("There are no mailboxes"));
215 return FR_ERROR;
216 }
217
218 struct Buffer *buf = buf_pool_get();
219 int index = menu_get_index(priv->menu);
220 struct FolderFile *ff = ARRAY_GET(&priv->state.entry, index);
221 buf_strcpy(buf, ff->name);
222 buf_expand_path(buf);
223 imap_subscribe(buf_string(buf), (op == OP_BROWSER_SUBSCRIBE));
224 buf_pool_release(&buf);
225 }
226 return FR_SUCCESS;
227}
#define ARRAY_EMPTY(head)
Check if an array is empty.
Definition: array.h:74
#define ARRAY_GET(head, idx)
Return the element at index.
Definition: array.h:109
size_t buf_strcpy(struct Buffer *buf, const char *s)
Copy a string into a Buffer.
Definition: buffer.c:395
@ FR_SUCCESS
Valid function - successfully performed.
Definition: dispatcher.h:39
@ FR_ERROR
Valid function - error occurred.
Definition: dispatcher.h:38
bool OptNews
(pseudo) used to change reader mode
Definition: globals.c:67
#define mutt_error(...)
Definition: logging2.h:92
int imap_subscribe(const char *path, bool subscribe)
Subscribe to a mailbox.
Definition: imap.c:1222
#define MENU_REDRAW_FULL
Redraw everything.
Definition: lib.h:59
void menu_queue_redraw(struct Menu *menu, MenuRedrawFlags redraw)
Queue a request for a redraw.
Definition: menu.c:184
int menu_get_index(struct Menu *menu)
Get the current selection in the Menu.
Definition: menu.c:160
MenuRedrawFlags menu_set_index(struct Menu *menu, int index)
Set the current selection in the Menu.
Definition: menu.c:174
void buf_expand_path(struct Buffer *buf)
Create the canonical path.
Definition: muttlib.c:315
void nntp_clear_cache(struct NntpAccountData *adata)
Clear the NNTP cache.
Definition: newsrc.c:841
int nntp_newsrc_parse(struct NntpAccountData *adata)
Parse .newsrc file.
Definition: newsrc.c:164
void nntp_newsrc_close(struct NntpAccountData *adata)
Unlock and close .newsrc file.
Definition: newsrc.c:120
int nntp_newsrc_update(struct NntpAccountData *adata)
Update .newsrc file.
Definition: newsrc.c:443
struct NntpMboxData * mutt_newsgroup_subscribe(struct NntpAccountData *adata, char *group)
Subscribe newsgroup.
Definition: newsrc.c:1175
struct NntpAccountData * CurrentNewsSrv
Current NNTP news server.
Definition: nntp.c:77
struct NntpMboxData * mutt_newsgroup_unsubscribe(struct NntpAccountData *adata, char *group)
Unsubscribe newsgroup.
Definition: newsrc.c:1199
void * adata
Private data (for Mailbox backends)
Definition: account.h:42
struct Menu * menu
Menu.
Definition: private_data.h:43
struct BrowserState state
State containing list of files/dir/mailboxes.
Definition: private_data.h:42
struct BrowserEntryArray entry
Array of files / dirs / mailboxes.
Definition: lib.h:145
Browser entry representing a folder/dir.
Definition: lib.h:78
char * name
Name of file/dir/mailbox.
Definition: lib.h:86
NNTP-specific Account data -.
Definition: adata.h:36
+ Here is the call graph for this function:

◆ op_browser_tell()

static int op_browser_tell ( struct BrowserPrivateData priv,
int  op 
)
static

Display the currently selected file's name - Implements browser_function_t -.

Definition at line 232 of file functions.c.

233{
234 int index = menu_get_index(priv->menu);
235 if (ARRAY_EMPTY(&priv->state.entry))
236 return FR_ERROR;
237
238 mutt_message("%s", ARRAY_GET(&priv->state.entry, index)->name);
239 return FR_SUCCESS;
240}
#define mutt_message(...)
Definition: logging2.h:91
+ Here is the call graph for this function:

◆ op_browser_toggle_lsub()

static int op_browser_toggle_lsub ( struct BrowserPrivateData priv,
int  op 
)
static

Toggle view all/subscribed mailboxes (IMAP only) - Implements browser_function_t -.

Definition at line 245 of file functions.c.

246{
247 bool_str_toggle(NeoMutt->sub, "imap_list_subscribed", NULL);
248
249 mutt_unget_op(OP_CHECK_NEW);
250 return FR_SUCCESS;
251}
int bool_str_toggle(struct ConfigSubset *sub, const char *name, struct Buffer *err)
Toggle the value of a bool.
Definition: bool.c:224
void mutt_unget_op(int op)
Return an operation to the input buffer.
Definition: get.c:126
Container for Accounts, Notifications.
Definition: neomutt.h:42
struct ConfigSubset * sub
Inherited config items.
Definition: neomutt.h:46
+ Here is the call graph for this function:

◆ op_browser_view_file()

static int op_browser_view_file ( struct BrowserPrivateData priv,
int  op 
)
static

View file - Implements browser_function_t -.

Definition at line 256 of file functions.c.

257{
258 if (ARRAY_EMPTY(&priv->state.entry))
259 {
260 mutt_error(_("No files match the file mask"));
261 return FR_ERROR;
262 }
263
264 int index = menu_get_index(priv->menu);
265 struct FolderFile *ff = ARRAY_GET(&priv->state.entry, index);
266 if (ff->selectable)
267 {
268 buf_strcpy(priv->file, ff->name);
269 priv->done = true;
270 return FR_DONE;
271 }
272 else if (S_ISDIR(ff->mode) ||
273 (S_ISLNK(ff->mode) && link_is_dir(buf_string(&LastDir), ff->name)))
274 {
275 mutt_error(_("Can't view a directory"));
276 return FR_ERROR;
277 }
278 else
279 {
280 struct Buffer *path = buf_pool_get();
282 struct Body *b = mutt_make_file_attach(buf_string(path), NeoMutt->sub);
283 if (b)
284 {
285 mutt_view_attachment(NULL, b, MUTT_VA_REGULAR, NULL, NULL, priv->menu->win);
286 mutt_body_free(&b);
288 }
289 else
290 {
291 mutt_error(_("Error trying to view file"));
292 }
293 buf_pool_release(&path);
294 }
295 return FR_ERROR;
296}
size_t buf_concat_path(struct Buffer *buf, const char *dir, const char *fname)
Join a directory name and a filename.
Definition: buffer.c:509
bool link_is_dir(const char *folder, const char *path)
Does this symlink point to a directory?
Definition: dlg_browser.c:172
void mutt_body_free(struct Body **ptr)
Free a Body.
Definition: body.c:58
int mutt_view_attachment(FILE *fp, struct Body *b, enum ViewAttachMode mode, struct Email *e, struct AttachCtx *actx, struct MuttWindow *win)
View an attachment.
Definition: mutt_attach.c:419
@ MUTT_VA_REGULAR
View using default method.
Definition: mutt_attach.h:44
struct Body * mutt_make_file_attach(const char *path, struct ConfigSubset *sub)
Create a file attachment.
Definition: sendlib.c:607
The body of an email.
Definition: body.h:36
bool selectable
Folder can be selected.
Definition: lib.h:96
mode_t mode
File permissions.
Definition: lib.h:79
struct MuttWindow * win
Window holding the Menu.
Definition: lib.h:86
+ Here is the call graph for this function:

◆ op_catchup()

static int op_catchup ( struct BrowserPrivateData priv,
int  op 
)
static

Mark all articles in newsgroup as read - Implements browser_function_t -.

Definition at line 301 of file functions.c.

302{
303 if (!OptNews)
304 return FR_NOT_IMPL;
305
306 struct NntpMboxData *mdata = NULL;
307
309 if (rc < 0)
310 return FR_ERROR;
311
312 int index = menu_get_index(priv->menu);
313 struct FolderFile *ff = ARRAY_GET(&priv->state.entry, index);
314 if (op == OP_CATCHUP)
316 else
318
319 if (mdata)
320 {
322 index = menu_get_index(priv->menu) + 1;
323 if (index < priv->menu->max)
324 menu_set_index(priv->menu, index);
325 }
326
327 if (rc != 0)
329
331 return FR_ERROR;
332}
@ FR_NOT_IMPL
Invalid function - feature not enabled.
Definition: dispatcher.h:36
#define MENU_REDRAW_INDEX
Redraw the index.
Definition: lib.h:56
struct NntpMboxData * mutt_newsgroup_catchup(struct Mailbox *m, struct NntpAccountData *adata, char *group)
Catchup newsgroup.
Definition: newsrc.c:1226
struct NntpMboxData * mutt_newsgroup_uncatchup(struct Mailbox *m, struct NntpAccountData *adata, char *group)
Uncatchup newsgroup.
Definition: newsrc.c:1265
void * mdata
Driver specific data.
Definition: mailbox.h:132
NNTP-specific Mailbox data -.
Definition: mdata.h:34
+ Here is the call graph for this function:

◆ op_change_directory()

static int op_change_directory ( struct BrowserPrivateData priv,
int  op 
)
static

Change directories - Implements browser_function_t -.

This function handles:

  • OP_GOTO_PARENT
  • OP_CHANGE_DIRECTORY

Definition at line 341 of file functions.c.

342{
343 if (OptNews)
344 return FR_NOT_IMPL;
345
346 struct Buffer *buf = buf_pool_get();
347 buf_copy(buf, &LastDir);
348 if (!priv->state.imap_browse)
349 {
350 /* add '/' at the end of the directory name if not already there */
351 size_t len = buf_len(buf);
352 if ((len > 0) && (buf_string(&LastDir)[len - 1] != '/'))
353 buf_addch(buf, '/');
354 }
355
356 if (op == OP_CHANGE_DIRECTORY)
357 {
358 struct FileCompletionData cdata = { false, priv->mailbox, NULL, NULL };
359 int rc = mw_get_field(_("Chdir to: "), buf, MUTT_COMP_NO_FLAGS, HC_FILE,
360 &CompleteMailboxOps, &cdata);
361 if ((rc != 0) && buf_is_empty(buf))
362 {
363 buf_pool_release(&buf);
364 return FR_NO_ACTION;
365 }
366 }
367 else if (op == OP_GOTO_PARENT)
368 {
369 mutt_get_parent_path(buf_string(buf), buf->data, buf->dsize);
370 }
371
372 if (!buf_is_empty(buf))
373 {
374 priv->state.is_mailbox_list = false;
375 buf_expand_path(buf);
376 if (imap_path_probe(buf_string(buf), NULL) == MUTT_IMAP)
377 {
378 buf_copy(&LastDir, buf);
379 destroy_state(&priv->state);
380 init_state(&priv->state);
381 priv->state.imap_browse = true;
383 browser_sort(&priv->state);
384 browser_highlight_default(&priv->state, priv->menu);
385 init_menu(&priv->state, priv->menu, priv->mailbox, priv->sbar);
386 }
387 else
388 {
389 if (buf_string(buf)[0] != '/')
390 {
391 /* in case dir is relative, make it relative to LastDir,
392 * not current working dir */
393 struct Buffer *tmp = buf_pool_get();
395 buf_copy(buf, tmp);
396 buf_pool_release(&tmp);
397 }
398 /* Resolve path from <chdir>
399 * Avoids buildup such as /a/b/../../c
400 * Symlinks are always unraveled to keep code simple */
401 if (mutt_path_realpath(buf) == 0)
402 {
403 buf_pool_release(&buf);
404 return FR_ERROR;
405 }
406
407 struct stat st = { 0 };
408 if (stat(buf_string(buf), &st) == 0)
409 {
410 if (S_ISDIR(st.st_mode))
411 {
412 destroy_state(&priv->state);
413 if (examine_directory(priv->mailbox, priv->menu, &priv->state,
414 buf_string(buf), buf_string(priv->prefix)) == 0)
415 {
416 buf_copy(&LastDir, buf);
417 }
418 else
419 {
420 mutt_error(_("Error scanning directory"));
421 if (examine_directory(priv->mailbox, priv->menu, &priv->state,
422 buf_string(&LastDir), buf_string(priv->prefix)) == -1)
423 {
424 priv->done = true;
425 return FR_ERROR;
426 }
427 }
428 browser_highlight_default(&priv->state, priv->menu);
429 init_menu(&priv->state, priv->menu, priv->mailbox, priv->sbar);
430 }
431 else
432 {
433 mutt_error(_("%s is not a directory"), buf_string(buf));
434 }
435 }
436 else
437 {
438 mutt_perror("%s", buf_string(buf));
439 }
440 }
441 }
442 buf_pool_release(&buf);
443 return FR_ERROR;
444}
int imap_browse(const char *path, struct BrowserState *state)
IMAP hook into the folder browser.
Definition: browse.c:197
void destroy_state(struct BrowserState *state)
Free the BrowserState.
Definition: functions.c:135
void browser_sort(struct BrowserState *state)
Sort the entries in the browser.
Definition: sort.c:186
size_t buf_len(const struct Buffer *buf)
Calculate the length of a Buffer.
Definition: buffer.c:491
bool buf_is_empty(const struct Buffer *buf)
Is the Buffer empty?
Definition: buffer.c:291
size_t buf_addch(struct Buffer *buf, char c)
Add a single character to a Buffer.
Definition: buffer.c:241
@ MUTT_IMAP
'IMAP' Mailbox type
Definition: mailbox.h:50
int examine_directory(struct Mailbox *m, struct Menu *menu, struct BrowserState *state, const char *dirname, const char *prefix)
Get list of all files/newsgroups with mask.
Definition: dlg_browser.c:265
void init_menu(struct BrowserState *state, struct Menu *menu, struct Mailbox *m, struct MuttWindow *sbar)
Set up a new menu.
Definition: dlg_browser.c:585
void init_state(struct BrowserState *state)
Initialise a browser state.
Definition: dlg_browser.c:248
void browser_highlight_default(struct BrowserState *state, struct Menu *menu)
Decide which browser item should be highlighted.
Definition: dlg_browser.c:559
#define mutt_perror(...)
Definition: logging2.h:93
enum MailboxType imap_path_probe(const char *path, const struct stat *st)
Is this an IMAP Mailbox? - Implements MxOps::path_probe() -.
Definition: imap.c:2344
size_t mutt_path_realpath(struct Buffer *path)
Resolve path, unraveling symlinks.
Definition: path.c:377
void mutt_get_parent_path(const char *path, char *buf, size_t buflen)
Find the parent of a path (or mailbox)
Definition: muttlib.c:936
struct Buffer * prefix
Folder prefix string.
Definition: private_data.h:49
struct MuttWindow * sbar
Status Bar.
Definition: private_data.h:51
bool is_mailbox_list
Viewing mailboxes.
Definition: lib.h:148
bool imap_browse
IMAP folder.
Definition: lib.h:146
size_t dsize
Length of data.
Definition: buffer.h:39
char * data
Pointer to data.
Definition: buffer.h:37
+ Here is the call graph for this function:

◆ op_create_mailbox()

static int op_create_mailbox ( struct BrowserPrivateData priv,
int  op 
)
static

Create a new mailbox (IMAP only) - Implements browser_function_t -.

Definition at line 449 of file functions.c.

450{
451 if (!priv->state.imap_browse)
452 {
453 mutt_error(_("Create is only supported for IMAP mailboxes"));
454 return FR_ERROR;
455 }
456
458 return FR_ERROR;
459
460 /* TODO: find a way to detect if the new folder would appear in
461 * this window, and insert it without starting over. */
462 destroy_state(&priv->state);
463 init_state(&priv->state);
464 priv->state.imap_browse = true;
466 browser_sort(&priv->state);
467 browser_highlight_default(&priv->state, priv->menu);
468 init_menu(&priv->state, priv->menu, priv->mailbox, priv->sbar);
469
470 return FR_SUCCESS;
471}
int imap_mailbox_create(const char *path)
Create a new IMAP mailbox.
Definition: browse.c:394
+ Here is the call graph for this function:

◆ op_delete_mailbox()

static int op_delete_mailbox ( struct BrowserPrivateData priv,
int  op 
)
static

Delete the current mailbox (IMAP only) - Implements browser_function_t -.

Definition at line 476 of file functions.c.

477{
478 int index = menu_get_index(priv->menu);
479 struct FolderFile *ff = ARRAY_GET(&priv->state.entry, index);
480 if (!ff->imap)
481 {
482 mutt_error(_("Delete is only supported for IMAP mailboxes"));
483 return FR_ERROR;
484 }
485
486 char msg[128] = { 0 };
487
488 // TODO(sileht): It could be better to select INBOX instead. But I
489 // don't want to manipulate Mailboxes/mailbox->account here for now.
490 // Let's just protect neomutt against crash for now. #1417
491 if (mutt_str_equal(mailbox_path(priv->mailbox), ff->name))
492 {
493 mutt_error(_("Can't delete currently selected mailbox"));
494 return FR_ERROR;
495 }
496
497 snprintf(msg, sizeof(msg), _("Really delete mailbox \"%s\"?"), ff->name);
498 if (query_yesorno(msg, MUTT_NO) != MUTT_YES)
499 {
500 mutt_message(_("Mailbox not deleted"));
501 return FR_NO_ACTION;
502 }
503
504 if (imap_delete_mailbox(priv->mailbox, ff->name) != 0)
505 {
506 mutt_error(_("Mailbox deletion failed"));
507 return FR_ERROR;
508 }
509
510 /* free the mailbox from the browser */
511 FREE(&ff->name);
512 FREE(&ff->desc);
513 /* and move all other entries up */
514 ARRAY_REMOVE(&priv->state.entry, ff);
515 mutt_message(_("Mailbox deleted"));
516 init_menu(&priv->state, priv->menu, priv->mailbox, priv->sbar);
517
518 return FR_SUCCESS;
519}
#define ARRAY_REMOVE(head, elem)
Remove an entry from the array, shifting down the subsequent entries.
Definition: array.h:267
static const char * mailbox_path(const struct Mailbox *m)
Get the Mailbox's path string.
Definition: mailbox.h:223
int imap_delete_mailbox(struct Mailbox *m, char *path)
Delete a mailbox.
Definition: imap.c:504
#define FREE(x)
Definition: memory.h:55
bool mutt_str_equal(const char *a, const char *b)
Compare two strings.
Definition: string.c:660
@ MUTT_NO
User answered 'No', or assume 'No'.
Definition: quad.h:38
@ MUTT_YES
User answered 'Yes', or assume 'Yes'.
Definition: quad.h:39
enum QuadOption query_yesorno(const char *prompt, enum QuadOption def)
Ask the user a Yes/No question.
Definition: question.c:327
bool imap
This is an IMAP folder.
Definition: lib.h:95
char * desc
Description of mailbox.
Definition: lib.h:87
+ Here is the call graph for this function:

◆ op_enter_mask()

static int op_enter_mask ( struct BrowserPrivateData priv,
int  op 
)
static

Enter a file mask - Implements browser_function_t -.

Definition at line 524 of file functions.c.

525{
526 const struct Regex *c_mask = cs_subset_regex(NeoMutt->sub, "mask");
527 struct Buffer *buf = buf_pool_get();
528 buf_strcpy(buf, c_mask ? c_mask->pattern : NULL);
529 if (mw_get_field(_("File Mask: "), buf, MUTT_COMP_NO_FLAGS, HC_OTHER, NULL, NULL) != 0)
530 {
531 buf_pool_release(&buf);
532 return FR_NO_ACTION;
533 }
534
535 buf_fix_dptr(buf);
536
537 priv->state.is_mailbox_list = false;
538 /* assume that the user wants to see everything */
539 if (buf_is_empty(buf))
540 buf_strcpy(buf, ".");
541
542 struct Buffer *errmsg = buf_pool_get();
543 int rc = cs_subset_str_string_set(NeoMutt->sub, "mask", buf_string(buf), errmsg);
544 buf_pool_release(&buf);
545 if (CSR_RESULT(rc) != CSR_SUCCESS)
546 {
547 if (!buf_is_empty(errmsg))
548 {
549 mutt_error("%s", buf_string(errmsg));
550 buf_pool_release(&errmsg);
551 }
552 return FR_ERROR;
553 }
554 buf_pool_release(&errmsg);
555
556 destroy_state(&priv->state);
557 if (priv->state.imap_browse)
558 {
559 init_state(&priv->state);
560 priv->state.imap_browse = true;
562 browser_sort(&priv->state);
563 init_menu(&priv->state, priv->menu, priv->mailbox, priv->sbar);
564 }
565 else if (examine_directory(priv->mailbox, priv->menu, &priv->state,
566 buf_string(&LastDir), NULL) == 0)
567 {
568 init_menu(&priv->state, priv->menu, priv->mailbox, priv->sbar);
569 }
570 else
571 {
572 mutt_error(_("Error scanning directory"));
573 priv->done = true;
574 return FR_ERROR;
575 }
576 priv->kill_prefix = false;
577 if (ARRAY_EMPTY(&priv->state.entry))
578 {
579 mutt_error(_("No files match the file mask"));
580 return FR_ERROR;
581 }
582 return FR_SUCCESS;
583}
void buf_fix_dptr(struct Buffer *buf)
Move the dptr to end of the Buffer.
Definition: buffer.c:182
const struct Regex * cs_subset_regex(const struct ConfigSubset *sub, const char *name)
Get a regex config item by name.
Definition: helpers.c:217
#define CSR_RESULT(x)
Definition: set.h:52
#define CSR_SUCCESS
Action completed successfully.
Definition: set.h:35
@ HC_OTHER
Miscellaneous strings.
Definition: lib.h:58
bool kill_prefix
Prefix is in use.
Definition: private_data.h:44
Cached regular expression.
Definition: regex3.h:86
char * pattern
printable version
Definition: regex3.h:87
int cs_subset_str_string_set(const struct ConfigSubset *sub, const char *name, const char *value, struct Buffer *err)
Set a config item by string.
Definition: subset.c:386
+ Here is the call graph for this function:

◆ op_exit()

static int op_exit ( struct BrowserPrivateData priv,
int  op 
)
static

Exit this menu - Implements browser_function_t -.

Definition at line 588 of file functions.c.

589{
590 if (priv->multiple)
591 {
592 char **tfiles = NULL;
593
594 if (priv->menu->num_tagged)
595 {
596 *priv->numfiles = priv->menu->num_tagged;
597 tfiles = MUTT_MEM_CALLOC(*priv->numfiles, char *);
598 size_t j = 0;
599 struct FolderFile *ff = NULL;
600 ARRAY_FOREACH(ff, &priv->state.entry)
601 {
602 if (ff->tagged)
603 {
604 struct Buffer *buf = buf_pool_get();
606 buf_expand_path(buf);
607 tfiles[j++] = buf_strdup(buf);
608 buf_pool_release(&buf);
609 }
610 }
611 *priv->files = tfiles;
612 }
613 else if (!buf_is_empty(priv->file)) /* no tagged entries. return selected entry */
614 {
615 *priv->numfiles = 1;
616 tfiles = MUTT_MEM_CALLOC(*priv->numfiles, char *);
617 buf_expand_path(priv->file);
618 tfiles[0] = buf_strdup(priv->file);
619 *priv->files = tfiles;
620 }
621 }
622
623 priv->done = true;
624 return FR_DONE;
625}
#define ARRAY_FOREACH(elem, head)
Iterate over all elements of the array.
Definition: array.h:212
char * buf_strdup(const struct Buffer *buf)
Copy a Buffer's string.
Definition: buffer.c:571
#define MUTT_MEM_CALLOC(n, type)
Definition: memory.h:40
char *** files
Array of selected files.
Definition: private_data.h:38
int * numfiles
Number of selected files.
Definition: private_data.h:39
bool multiple
Allow multiple selections.
Definition: private_data.h:45
bool tagged
Folder is tagged.
Definition: lib.h:102
int num_tagged
Number of tagged entries.
Definition: lib.h:93
+ Here is the call graph for this function:

◆ op_generic_select_entry()

static int op_generic_select_entry ( struct BrowserPrivateData priv,
int  op 
)
static

Select the current entry - Implements browser_function_t -.

This function handles:

  • OP_DESCEND_DIRECTORY
  • OP_GENERIC_SELECT_ENTRY

Definition at line 634 of file functions.c.

635{
636 if (ARRAY_EMPTY(&priv->state.entry))
637 {
638 mutt_error(_("No files match the file mask"));
639 return FR_ERROR;
640 }
641
642 int index = menu_get_index(priv->menu);
643 struct FolderFile *ff = ARRAY_GET(&priv->state.entry, index);
644 if (S_ISDIR(ff->mode) ||
645 (S_ISLNK(ff->mode) && link_is_dir(buf_string(&LastDir), ff->name)) || ff->inferiors)
646 {
647 /* make sure this isn't a MH or maildir mailbox */
648 struct Buffer *buf = buf_pool_get();
649 if (priv->state.is_mailbox_list)
650 {
651 buf_strcpy(buf, ff->name);
652 buf_expand_path(buf);
653 }
654 else if (priv->state.imap_browse)
655 {
656 buf_strcpy(buf, ff->name);
657 }
658 else
659 {
661 }
662
663 enum MailboxType type = mx_path_probe(buf_string(buf));
664 buf_pool_release(&buf);
665
666 if ((op == OP_DESCEND_DIRECTORY) || (type == MUTT_MAILBOX_ERROR) ||
667 (type == MUTT_UNKNOWN) || ff->inferiors)
668 {
669 /* save the old directory */
671
672 if (mutt_str_equal(ff->name, ".."))
673 {
674 size_t lastdirlen = buf_len(&LastDir);
675 if ((lastdirlen > 1) && mutt_str_equal("..", buf_string(&LastDir) + lastdirlen - 2))
676 {
677 buf_addstr(&LastDir, "/..");
678 }
679 else
680 {
681 char *p = NULL;
682 if (lastdirlen > 1)
683 p = strrchr(LastDir.data + 1, '/');
684
685 if (p)
686 {
687 *p = '\0';
689 }
690 else
691 {
692 if (buf_string(&LastDir)[0] == '/')
693 buf_strcpy(&LastDir, "/");
694 else
695 buf_addstr(&LastDir, "/..");
696 }
697 }
698 }
699 else if (priv->state.is_mailbox_list)
700 {
701 buf_strcpy(&LastDir, ff->name);
703 }
704 else if (priv->state.imap_browse)
705 {
706 buf_strcpy(&LastDir, ff->name);
707 /* tack on delimiter here */
708
709 /* special case "" needs no delimiter */
710 struct Url *url = url_parse(ff->name);
711 if (url && url->path && (ff->delim != '\0'))
712 {
713 buf_addch(&LastDir, ff->delim);
714 }
715 url_free(&url);
716 }
717 else
718 {
719 struct Buffer *tmp = buf_pool_get();
721 buf_copy(&LastDir, tmp);
722 buf_pool_release(&tmp);
723 }
724
725 destroy_state(&priv->state);
726 if (priv->kill_prefix)
727 {
728 buf_reset(priv->prefix);
729 priv->kill_prefix = false;
730 }
731 priv->state.is_mailbox_list = false;
732 if (priv->state.imap_browse)
733 {
734 init_state(&priv->state);
735 priv->state.imap_browse = true;
737 browser_sort(&priv->state);
738 }
739 else
740 {
741 if (examine_directory(priv->mailbox, priv->menu, &priv->state,
742 buf_string(&LastDir), buf_string(priv->prefix)) == -1)
743 {
744 /* try to restore the old values */
746 if (examine_directory(priv->mailbox, priv->menu, &priv->state,
747 buf_string(&LastDir), buf_string(priv->prefix)) == -1)
748 {
750 priv->done = true;
751 return FR_DONE;
752 }
753 }
754 /* resolve paths navigated from GUI */
755 if (mutt_path_realpath(&LastDir) == 0)
756 return FR_ERROR;
757 }
758
759 browser_highlight_default(&priv->state, priv->menu);
760 init_menu(&priv->state, priv->menu, priv->mailbox, priv->sbar);
761 priv->goto_swapper[0] = '\0';
762 return FR_SUCCESS;
763 }
764 }
765 else if (op == OP_DESCEND_DIRECTORY)
766 {
767 mutt_error(_("%s is not a directory"), ARRAY_GET(&priv->state.entry, index)->name);
768 return FR_ERROR;
769 }
770
771 if (priv->state.is_mailbox_list || OptNews)
772 {
773 buf_strcpy(priv->file, ff->name);
774 buf_expand_path(priv->file);
775 }
776 else if (priv->state.imap_browse)
777 {
778 buf_strcpy(priv->file, ff->name);
779 }
780 else
781 {
783 }
784
785 return op_exit(priv, op);
786}
void buf_reset(struct Buffer *buf)
Reset an existing Buffer.
Definition: buffer.c:76
size_t buf_addstr(struct Buffer *buf, const char *s)
Add a string to a Buffer.
Definition: buffer.c:226
char * HomeDir
User's home directory.
Definition: globals.c:37
MailboxType
Supported mailbox formats.
Definition: mailbox.h:41
@ MUTT_MAILBOX_ERROR
Error occurred examining Mailbox.
Definition: mailbox.h:43
@ MUTT_UNKNOWN
Mailbox wasn't recognised.
Definition: mailbox.h:44
static int op_exit(struct AliasMenuData *mdata, int op)
exit this menu - Implements alias_function_t -
Definition: functions.c:201
enum MailboxType mx_path_probe(const char *path)
Find a mailbox that understands a path.
Definition: mx.c:1321
struct Buffer * old_last_dir
Previous to last dir.
Definition: private_data.h:48
char goto_swapper[PATH_MAX]
Saved path after <goto-folder>
Definition: private_data.h:47
char delim
Path delimiter.
Definition: lib.h:93
bool inferiors
Folder has children.
Definition: lib.h:97
A parsed URL proto://user:password@host:port/path?a=1&b=2
Definition: url.h:69
char * path
Path.
Definition: url.h:75
struct Url * url_parse(const char *src)
Fill in Url.
Definition: url.c:239
void url_free(struct Url **ptr)
Free the contents of a URL.
Definition: url.c:124
+ Here is the call graph for this function:

◆ op_load_active()

static int op_load_active ( struct BrowserPrivateData priv,
int  op 
)
static

Load list of all newsgroups from NNTP server - Implements browser_function_t -.

Definition at line 791 of file functions.c.

792{
793 if (!OptNews)
794 return FR_NOT_IMPL;
795
797
798 if (nntp_newsrc_parse(adata) < 0)
799 return FR_ERROR;
800
801 for (size_t i = 0; i < adata->groups_num; i++)
802 {
803 struct NntpMboxData *mdata = adata->groups_list[i];
804 if (mdata)
805 mdata->deleted = true;
806 }
810
811 destroy_state(&priv->state);
812 if (priv->state.is_mailbox_list)
813 {
814 examine_mailboxes(priv->mailbox, priv->menu, &priv->state);
815 }
816 else
817 {
818 if (examine_directory(priv->mailbox, priv->menu, &priv->state, NULL, NULL) == -1)
819 return FR_ERROR;
820 }
821 init_menu(&priv->state, priv->menu, priv->mailbox, priv->sbar);
822 return FR_SUCCESS;
823}
int examine_mailboxes(struct Mailbox *m, struct Menu *menu, struct BrowserState *state)
Get list of mailboxes/subscribed newsgroups.
Definition: dlg_browser.c:392
int nntp_active_fetch(struct NntpAccountData *adata, bool mark_new)
Fetch list of all newsgroups from server.
Definition: nntp.c:2037
struct NntpMboxData ** groups_list
Definition: adata.h:60
struct NntpAccountData * adata
Definition: mdata.h:48
+ Here is the call graph for this function:

◆ op_mailbox_list()

static int op_mailbox_list ( struct BrowserPrivateData priv,
int  op 
)
static

List mailboxes with new mail - Implements browser_function_t -.

Definition at line 828 of file functions.c.

829{
831 return FR_SUCCESS;
832}
bool mutt_mailbox_list(void)
Show a message with the list of mailboxes with new mail.
Definition: mutt_mailbox.c:248
+ Here is the call graph for this function:

◆ op_rename_mailbox()

static int op_rename_mailbox ( struct BrowserPrivateData priv,
int  op 
)
static

Rename the current mailbox (IMAP only) - Implements browser_function_t -.

Definition at line 837 of file functions.c.

838{
839 int index = menu_get_index(priv->menu);
840 struct FolderFile *ff = ARRAY_GET(&priv->state.entry, index);
841 if (!ff->imap)
842 {
843 mutt_error(_("Rename is only supported for IMAP mailboxes"));
844 return FR_ERROR;
845 }
846
847 if (imap_mailbox_rename(ff->name) < 0)
848 return FR_ERROR;
849
850 destroy_state(&priv->state);
851 init_state(&priv->state);
852 priv->state.imap_browse = true;
854 browser_sort(&priv->state);
855 browser_highlight_default(&priv->state, priv->menu);
856 init_menu(&priv->state, priv->menu, priv->mailbox, priv->sbar);
857
858 return FR_SUCCESS;
859}
int imap_mailbox_rename(const char *path)
Rename a mailbox.
Definition: browse.c:449
+ Here is the call graph for this function:

◆ op_sort()

static int op_sort ( struct BrowserPrivateData priv,
int  op 
)
static

Sort messages - Implements browser_function_t -.

This function handles:

  • OP_SORT
  • OP_SORT_REVERSE

Definition at line 868 of file functions.c.

869{
870 bool resort = true;
871 int sort = -1;
872 int reverse = (op == OP_SORT_REVERSE);
873
874 switch (mw_multi_choice((reverse) ?
875 /* L10N: The highlighted letters must match the "Sort" options */
876 _("Reverse sort by (d)ate, (a)lpha, si(z)e, d(e)scription, (c)ount, ne(w) count, or do(n)'t sort?") :
877 /* L10N: The highlighted letters must match the "Reverse Sort" options */
878 _("Sort by (d)ate, (a)lpha, si(z)e, d(e)scription, (c)ount, ne(w) count, or do(n)'t sort?"),
879 /* L10N: These must match the highlighted letters from "Sort" and "Reverse Sort" */
880 _("dazecwn")))
881 {
882 case -1: /* abort */
883 resort = false;
884 break;
885
886 case 1: /* (d)ate */
887 sort = BROWSER_SORT_DATE;
888 break;
889
890 case 2: /* (a)lpha */
891 sort = BROWSER_SORT_ALPHA;
892 break;
893
894 case 3: /* si(z)e */
895 sort = BROWSER_SORT_SIZE;
896 break;
897
898 case 4: /* d(e)scription */
899 sort = BROWSER_SORT_DESC;
900 break;
901
902 case 5: /* (c)ount */
903 sort = BROWSER_SORT_COUNT;
904 break;
905
906 case 6: /* ne(w) count */
907 sort = BROWSER_SORT_NEW;
908 break;
909
910 case 7: /* do(n)'t sort */
912 break;
913 }
914
915 if (!resort)
916 return FR_NO_ACTION;
917
918 sort |= reverse ? SORT_REVERSE : 0;
919 cs_subset_str_native_set(NeoMutt->sub, "browser_sort", sort, NULL);
920 browser_sort(&priv->state);
921 browser_highlight_default(&priv->state, priv->menu);
923 return FR_SUCCESS;
924}
@ BROWSER_SORT_ALPHA
Sort alphabetically by name.
Definition: sort.h:31
@ BROWSER_SORT_UNSORTED
Sort into the raw order.
Definition: sort.h:37
@ BROWSER_SORT_COUNT
Sort by total message count.
Definition: sort.h:32
@ BROWSER_SORT_DATE
Sort by date.
Definition: sort.h:33
@ BROWSER_SORT_NEW
Sort by count of new messages.
Definition: sort.h:35
@ BROWSER_SORT_SIZE
Sort by size.
Definition: sort.h:36
@ BROWSER_SORT_DESC
Sort by description.
Definition: sort.h:34
#define SORT_REVERSE
Reverse the order of the sort.
Definition: sort.h:39
int mw_multi_choice(const char *prompt, const char *letters)
Offer the user a multiple choice question -.
Definition: question.c:63
int cs_subset_str_native_set(const struct ConfigSubset *sub, const char *name, intptr_t value, struct Buffer *err)
Natively set the value of a string config item.
Definition: subset.c:297
+ Here is the call graph for this function:

◆ op_subscribe_pattern()

static int op_subscribe_pattern ( struct BrowserPrivateData priv,
int  op 
)
static

Subscribe to newsgroups matching a pattern - Implements browser_function_t -.

This function handles:

  • OP_SUBSCRIBE_PATTERN
  • OP_UNSUBSCRIBE_PATTERN

Definition at line 933 of file functions.c.

934{
935 if (!OptNews)
936 return FR_NOT_IMPL;
937
939 regex_t rx = { 0 };
940 int index = menu_get_index(priv->menu);
941
942 char tmp2[256] = { 0 };
943
944 struct Buffer *buf = buf_pool_get();
945 if (op == OP_SUBSCRIBE_PATTERN)
946 snprintf(tmp2, sizeof(tmp2), _("Subscribe pattern: "));
947 else
948 snprintf(tmp2, sizeof(tmp2), _("Unsubscribe pattern: "));
949 /* buf comes from the buffer pool, so defaults to size 1024 */
950 if ((mw_get_field(tmp2, buf, MUTT_COMP_NO_FLAGS, HC_PATTERN, &CompletePatternOps, NULL) != 0) ||
951 buf_is_empty(buf))
952 {
953 buf_pool_release(&buf);
954 return FR_NO_ACTION;
955 }
956
957 int err = REG_COMP(&rx, buf->data, REG_NOSUB);
958 if (err != 0)
959 {
960 regerror(err, &rx, buf->data, buf->dsize);
961 regfree(&rx);
962 mutt_error("%s", buf_string(buf));
963 buf_pool_release(&buf);
964 return FR_ERROR;
965 }
967 index = 0;
968 buf_pool_release(&buf);
969
970 int rc = nntp_newsrc_parse(adata);
971 if (rc < 0)
972 return FR_ERROR;
973
974 struct FolderFile *ff = NULL;
975 ARRAY_FOREACH_FROM(ff, &priv->state.entry, index)
976 {
977 if (regexec(&rx, ff->name, 0, NULL, 0) == 0)
978 {
979 if (op == OP_SUBSCRIBE_PATTERN)
980 mutt_newsgroup_subscribe(adata, ff->name);
981 else
983 }
984 }
985
986 if (op == OP_SUBSCRIBE_PATTERN)
987 {
988 for (size_t j = 0; j < adata->groups_num; j++)
989 {
990 struct NntpMboxData *mdata = adata->groups_list[j];
991 if (mdata && mdata->group && !mdata->subscribed)
992 {
993 if (regexec(&rx, mdata->group, 0, NULL, 0) == 0)
994 {
996 browser_add_folder(priv->menu, &priv->state, mdata->group, NULL, NULL, NULL, mdata);
997 }
998 }
999 }
1000 init_menu(&priv->state, priv->menu, priv->mailbox, priv->sbar);
1001 }
1002 if (rc > 0)
1007 regfree(&rx);
1008 return FR_SUCCESS;
1009}
#define ARRAY_FOREACH_FROM(elem, head, from)
Iterate from an index to the end.
Definition: array.h:223
void browser_add_folder(const struct Menu *menu, struct BrowserState *state, const char *name, const char *desc, const struct stat *st, struct Mailbox *m, void *data)
Add a folder to the browser list.
Definition: dlg_browser.c:198
@ HC_PATTERN
Patterns.
Definition: lib.h:57
const struct CompleteOps CompletePatternOps
Auto-Completion of Patterns.
Definition: complete.c:82
#define REG_COMP(preg, regex, cflags)
Compile a regular expression.
Definition: regex3.h:50
unsigned int groups_num
Definition: adata.h:58
+ Here is the call graph for this function:

◆ op_toggle_mailboxes()

static int op_toggle_mailboxes ( struct BrowserPrivateData priv,
int  op 
)
static

Toggle whether to browse mailboxes or all files - Implements browser_function_t -.

This function handles:

  • OP_CHECK_NEW
  • OP_TOGGLE_MAILBOXES

Definition at line 1018 of file functions.c.

1019{
1020 if (priv->state.is_mailbox_list)
1021 {
1023 }
1024
1025 if (op == OP_TOGGLE_MAILBOXES)
1026 {
1028 }
1029
1030 if (op == OP_BROWSER_GOTO_FOLDER)
1031 {
1032 /* When in mailboxes mode, disables this feature */
1033 const char *const c_folder = cs_subset_string(NeoMutt->sub, "folder");
1034 if (c_folder)
1035 {
1036 mutt_debug(LL_DEBUG3, "= hit! Folder: %s, LastDir: %s\n", c_folder,
1038 if (priv->goto_swapper[0] == '\0')
1039 {
1040 if (!mutt_str_equal(buf_string(&LastDir), c_folder))
1041 {
1042 /* Stores into goto_swapper LastDir, and swaps to `$folder` */
1043 mutt_str_copy(priv->goto_swapper, buf_string(&LastDir), sizeof(priv->goto_swapper));
1045 buf_strcpy(&LastDir, c_folder);
1046 }
1047 }
1048 else
1049 {
1052 priv->goto_swapper[0] = '\0';
1053 }
1054 }
1055 }
1056 destroy_state(&priv->state);
1057 buf_reset(priv->prefix);
1058 priv->kill_prefix = false;
1059
1060 if (priv->state.is_mailbox_list)
1061 {
1062 examine_mailboxes(priv->mailbox, priv->menu, &priv->state);
1063 }
1064 else if (imap_path_probe(buf_string(&LastDir), NULL) == MUTT_IMAP)
1065 {
1066 init_state(&priv->state);
1067 priv->state.imap_browse = true;
1069 browser_sort(&priv->state);
1070 }
1071 else if (examine_directory(priv->mailbox, priv->menu, &priv->state,
1072 buf_string(&LastDir), buf_string(priv->prefix)) == -1)
1073 {
1074 priv->done = true;
1075 return FR_ERROR;
1076 }
1077 init_menu(&priv->state, priv->menu, priv->mailbox, priv->sbar);
1078 if (priv->state.is_mailbox_list)
1080 return FR_ERROR;
1081}
const char * cs_subset_string(const struct ConfigSubset *sub, const char *name)
Get a string config item by name.
Definition: helpers.c:291
struct Buffer LastDirBackup
Browser: backup copy of the current directory.
Definition: dlg_browser.c:138
#define mutt_debug(LEVEL,...)
Definition: logging2.h:89
@ LL_DEBUG3
Log at debug level 3.
Definition: logging2.h:45
size_t mutt_str_copy(char *dest, const char *src, size_t dsize)
Copy a string into a buffer (guaranteeing NUL-termination)
Definition: string.c:581
int last_selected_mailbox
Index of last selected Mailbox.
Definition: private_data.h:50
+ Here is the call graph for this function: