NeoMutt  2025-12-11-435-g4ac674
Teaching an old dog new tricks
DOXYGEN
Loading...
Searching...
No Matches
attach.c File Reference

Compose Attachments. More...

#include "config.h"
#include <stdbool.h>
#include <stddef.h>
#include "private.h"
#include "mutt/lib.h"
#include "config/lib.h"
#include "email/lib.h"
#include "core/lib.h"
#include "gui/lib.h"
#include "attach/lib.h"
#include "convert/lib.h"
#include "expando/lib.h"
#include "key/lib.h"
#include "menu/lib.h"
#include "attach_data.h"
#include "functions.h"
#include "shared_data.h"
+ Include dependency graph for attach.c:

Go to the source code of this file.

Functions

unsigned long cum_attachs_size (struct ConfigSubset *sub, struct ComposeAttachData *adata)
 Cumulative Attachments Size.
 
static int attach_email_observer (struct NotifyCallback *nc)
 Notification that the Email has changed - Implements observer_t -.
 
static int attach_config_observer (struct NotifyCallback *nc)
 Notification that a Config Variable has changed - Implements observer_t -.
 
static int attach_window_observer (struct NotifyCallback *nc)
 Notification that a Window has changed - Implements observer_t -.
 
static int compose_attach_tag (struct Menu *menu, int sel, int act)
 Tag an attachment - Implements Menu::tag() -.
 
static int compose_make_entry (struct Menu *menu, int line, int max_cols, struct Buffer *buf)
 Format an Attachment for the Menu - Implements Menu::make_entry() -.
 
static int attach_recalc (struct MuttWindow *win)
 Recalculate the Window data - Implements MuttWindow::recalc() -.
 
struct MuttWindowattach_new (struct MuttWindow *parent, struct ComposeSharedData *shared)
 Create the Attachments Menu.
 
void attachment_size_fixed (struct MuttWindow *win)
 Make the Attachment Window fixed-size.
 
void attachment_size_max (struct MuttWindow *win)
 Make the Attachment Window maximised.
 

Detailed Description

Compose Attachments.

Authors
  • Richard Russon
  • Tóth János
  • Dennis Schön

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

Function Documentation

◆ cum_attachs_size()

unsigned long cum_attachs_size ( struct ConfigSubset * sub,
struct ComposeAttachData * adata )

Cumulative Attachments Size.

Parameters
subConfig Subset
adataAttachment data
Return values
numBytes in attachments

Returns the total number of bytes used by the attachments in the attachment list after content-transfer-encodings have been applied.

Definition at line 87 of file attach.c.

88{
89 if (!adata || !adata->actx)
90 return 0;
91
92 size_t s = 0;
93 struct Content *info = NULL;
94 struct Body *b = NULL;
95 struct AttachCtx *actx = adata->actx;
96 struct AttachPtr **idx = actx->idx;
97
98 for (unsigned short i = 0; i < actx->idxlen; i++)
99 {
100 b = idx[i]->body;
101
102 if (!b->content)
103 b->content = mutt_get_content_info(b->filename, b, sub);
104
105 info = b->content;
106 if (info)
107 {
108 switch (b->encoding)
109 {
111 s += 3 * (info->lobin + info->hibin) + info->ascii + info->crlf;
112 break;
113 case ENC_BASE64:
114 s += (4 * (info->lobin + info->hibin + info->ascii + info->crlf)) / 3;
115 break;
116 default:
117 s += info->lobin + info->hibin + info->ascii + info->crlf;
118 break;
119 }
120 }
121 }
122
123 return s;
124}
struct Content * mutt_get_content_info(const char *fname, struct Body *b, struct ConfigSubset *sub)
Analyze file to determine MIME encoding to use.
@ ENC_BASE64
Base-64 encoded text.
Definition mime.h:52
@ ENC_QUOTED_PRINTABLE
Quoted-printable text.
Definition mime.h:51
A set of attachments.
Definition attach.h:63
struct AttachPtr ** idx
Array of attachments.
Definition attach.h:67
short idxlen
Number of attachmentes.
Definition attach.h:68
An email to which things will be attached.
Definition attach.h:35
struct Body * body
Attachment.
Definition attach.h:36
The body of an email.
Definition body.h:36
struct Content * content
Detailed info about the content of the attachment.
Definition body.h:70
unsigned int encoding
content-transfer-encoding, ContentEncoding
Definition body.h:41
char * filename
When sending a message, this is the file to which this structure refers.
Definition body.h:59
struct AttachCtx * actx
Set of attachments.
Definition attach_data.h:34
Info about an attachment.
Definition content.h:35
long crlf
\r and \n characters
Definition content.h:39
long hibin
8-bit characters
Definition content.h:36
long ascii
Number of ascii chars.
Definition content.h:40
long lobin
Unprintable 7-bit chars (eg., control chars)
Definition content.h:37
+ Here is the call graph for this function:
+ Here is the caller graph for this function:

◆ attach_window_observer()

static int attach_window_observer ( struct NotifyCallback * nc)
static

Notification that a Window has changed - Implements observer_t -.

Definition at line 170 of file attach.c.

171{
172 if (nc->event_type != NT_WINDOW)
173 return 0;
174 if (!nc->global_data || !nc->event_data)
175 return -1;
176
177 struct MuttWindow *win_attach = nc->global_data;
178 struct EventWindow *ev_w = nc->event_data;
179 if (ev_w->win != win_attach)
180 return 0;
181
183 {
184 win_attach->actions |= WA_RECALC;
185 mutt_debug(LL_DEBUG5, "window state done, request WA_RECALC\n");
186 }
187 else if (nc->event_subtype == NT_WINDOW_DELETE)
188 {
189 struct Menu *menu = win_attach->wdata;
190 struct ComposeAttachData *adata = menu->mdata;
191 struct AttachCtx *actx = adata->actx;
194 notify_observer_remove(win_attach->notify, attach_window_observer, win_attach);
195 mutt_debug(LL_DEBUG5, "window delete done\n");
196 }
197
198 return 0;
199}
#define mutt_debug(LEVEL,...)
Definition logging2.h:91
static int attach_email_observer(struct NotifyCallback *nc)
Notification that the Email has changed - Implements observer_t -.
Definition attach.c:129
static int attach_config_observer(struct NotifyCallback *nc)
Notification that a Config Variable has changed - Implements observer_t -.
Definition dlg_attach.c:107
static int attach_window_observer(struct NotifyCallback *nc)
Notification that a Window has changed - Implements observer_t -.
Definition dlg_attach.c:172
@ LL_DEBUG5
Log at debug level 5.
Definition logging2.h:49
bool notify_observer_remove(struct Notify *notify, const observer_t callback, const void *global_data)
Remove an observer from an object.
Definition notify.c:230
#define WA_RECALC
Recalculate the contents of the Window.
@ NT_WINDOW_STATE
Window state has changed, e.g. WN_VISIBLE.
@ NT_WINDOW_DELETE
Window is about to be deleted.
@ NT_WINDOW
MuttWindow has changed, NotifyWindow, EventWindow.
Definition notify_type.h:57
struct Email * email
Used by recvattach for updating.
Definition attach.h:64
Data to fill the Compose Attach Window.
Definition attach_data.h:33
struct Menu * menu
Menu displaying the attachments.
Definition attach_data.h:35
struct Notify * notify
Notifications: NotifyConfig, EventConfig.
Definition subset.h:51
struct Notify * notify
Notifications: NotifyEmail, EventEmail.
Definition email.h:73
An Event that happened to a Window.
struct MuttWindow * win
Window that changed.
Definition lib.h:80
void * mdata
Private data.
Definition lib.h:149
void * wdata
Private data.
struct Notify * notify
Notifications: NotifyWindow, EventWindow.
WindowActionFlags actions
Actions to be performed, e.g. WA_RECALC.
Container for Accounts, Notifications.
Definition neomutt.h:41
struct ConfigSubset * sub
Inherited config items.
Definition neomutt.h:49
void * event_data
Data from notify_send()
Definition observer.h:38
enum NotifyType event_type
Send: Event type, e.g. NT_ACCOUNT.
Definition observer.h:36
int event_subtype
Send: Event subtype, e.g. NT_ACCOUNT_ADD.
Definition observer.h:37
void * global_data
Data from notify_observer_add()
Definition observer.h:39
+ Here is the call graph for this function:

◆ attach_new()

struct MuttWindow * attach_new ( struct MuttWindow * parent,
struct ComposeSharedData * shared )

Create the Attachments Menu.

Parameters
parentParent Window
sharedShared compose data

Definition at line 270 of file attach.c.

271{
272 struct MuttWindow *win_attach = menu_window_new(MdCompose, NeoMutt->sub);
273
274 struct ComposeAttachData *adata = attach_data_new(shared->email);
275
276 shared->adata = adata;
277
278 // NT_COLOR is handled by the Menu Window
282
283 struct Menu *menu = win_attach->wdata;
284 menu->page_len = win_attach->state.rows;
285 menu->win = win_attach;
286
288 menu->tag = compose_attach_tag;
289 menu->mdata = adata;
291 adata->menu = menu;
292
293 return win_attach;
294}
struct ComposeAttachData * attach_data_new(struct Email *e)
Create new Compose Attach Data.
Definition attach_data.c:54
struct MenuDefinition * MdCompose
Compose Menu Definition.
Definition functions.c:74
static int compose_make_entry(struct Menu *menu, int line, int max_cols, struct Buffer *buf)
Format an Attachment for the Menu - Implements Menu::make_entry() -.
Definition attach.c:220
void attach_data_free(struct Menu *menu, void **ptr)
Free the Compose Attach Data - Implements Menu::mdata_free() -.
Definition attach_data.c:37
static int compose_attach_tag(struct Menu *menu, int sel, int act)
Tag an attachment - Implements Menu::tag() -.
Definition attach.c:204
struct MuttWindow * menu_window_new(const struct MenuDefinition *md, struct ConfigSubset *sub)
Create a new Menu Window.
Definition window.c:139
bool notify_observer_add(struct Notify *notify, enum NotifyType type, observer_t callback, void *global_data)
Add an observer to an object.
Definition notify.c:191
@ NT_CONFIG
Config has changed, NotifyConfig, EventConfig.
Definition notify_type.h:43
@ NT_EMAIL
Email has changed, NotifyEmail, EventEmail.
Definition notify_type.h:44
struct ComposeAttachData * adata
Attachments.
Definition shared_data.h:39
struct Email * email
Email being composed.
Definition shared_data.h:38
struct MuttWindow * win
Window holding the Menu.
Definition lib.h:88
void(* mdata_free)(struct Menu *menu, void **ptr)
Definition lib.h:163
int(* tag)(struct Menu *menu, int sel, int act)
Definition lib.h:133
int(* make_entry)(struct Menu *menu, int line, int max_cols, struct Buffer *buf)
Definition lib.h:108
int page_len
Number of entries per screen.
Definition lib.h:85
struct WindowState state
Current state of the Window.
short rows
Number of rows, can be MUTT_WIN_SIZE_UNLIMITED.
Definition mutt_window.h:61
+ Here is the call graph for this function:
+ Here is the caller graph for this function:

◆ attachment_size_fixed()

void attachment_size_fixed ( struct MuttWindow * win)

Make the Attachment Window fixed-size.

Parameters
winAttachment Window

Definition at line 300 of file attach.c.

301{
302 if (!win || (win->size == MUTT_WIN_SIZE_FIXED))
303 return;
304
306 win->recalc = attach_recalc;
307}
static int attach_recalc(struct MuttWindow *win)
Recalculate the Window data - Implements MuttWindow::recalc() -.
Definition attach.c:245
@ MUTT_WIN_SIZE_FIXED
Window has a fixed size.
Definition mutt_window.h:47
int(* recalc)(struct MuttWindow *win)
enum MuttWindowSize size
Type of Window, e.g. MUTT_WIN_SIZE_FIXED.
+ Here is the call graph for this function:
+ Here is the caller graph for this function:

◆ attachment_size_max()

void attachment_size_max ( struct MuttWindow * win)

Make the Attachment Window maximised.

Parameters
winAttachment Window

Definition at line 313 of file attach.c.

314{
315 if (!win || (win->size == MUTT_WIN_SIZE_MAXIMISE))
316 return;
317
319 win->recalc = NULL;
320}
@ MUTT_WIN_SIZE_MAXIMISE
Window wants as much space as possible.
Definition mutt_window.h:48
+ Here is the caller graph for this function: