1 ;;; notmuch-maildir-fcc.el --- inserting using a fcc handler -*- lexical-binding: t -*-
3 ;; Copyright © Jesse Rosenthal
5 ;; This file is part of Notmuch.
7 ;; Notmuch is free software: you can redistribute it and/or modify it
8 ;; under the terms of the GNU General Public License as published by
9 ;; the Free Software Foundation, either version 3 of the License, or
10 ;; (at your option) any later version.
12 ;; Notmuch is distributed in the hope that it will be useful, but
13 ;; WITHOUT ANY WARRANTY; without even the implied warranty of
14 ;; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
15 ;; General Public License for more details.
17 ;; You should have received a copy of the GNU General Public License
18 ;; along with Notmuch. If not, see <https://www.gnu.org/licenses/>.
20 ;; Authors: Jesse Rosenthal <jrosenthal@jhu.edu>
28 (require 'notmuch-lib)
30 (defvar notmuch-maildir-fcc-count 0)
34 (defcustom notmuch-fcc-dirs "sent"
35 "Determines the Fcc Header which says where to save outgoing mail.
37 Three types of values are permitted:
39 - nil: no Fcc header is added,
41 - a string: the value of `notmuch-fcc-dirs' is the Fcc header to
44 - an alist: the folder is chosen based on the From address of
45 the current message according to an alist mapping regular
46 expressions to folders or nil:
48 ((\"Sebastian@SSpaeth.de\" . \"privat\")
49 (\"spaetz@sspaeth.de\" . \"OUTBOX.OSS\")
50 (\".*\" . \"defaultinbox\"))
52 If none of the regular expressions match the From address, or
53 if the cdr of the matching entry is nil, then no Fcc header
56 If `notmuch-maildir-use-notmuch-insert' is set (the default) then
57 the header should be of the form \"folder +tag1 -tag2\" where
58 folder is the folder (relative to the notmuch mailstore) to store
59 the message in, and tag1 and tag2 are tag changes to apply to the
60 stored message. This string is split using `split-string-and-unquote',
61 so a folder name containing spaces can be specified by
62 quoting each space with an immediately preceding backslash
63 or surrounding the entire folder name in double quotes.
65 If `notmuch-maildir-use-notmuch-insert' is nil then the Fcc
66 header should be the directory where the message should be
67 saved. A relative directory will be understood to specify a
68 directory within the notmuch mail store, (as set by the
69 database.path option in the notmuch configuration file).
71 In all cases you will be prompted to create the folder or
72 directory if it does not exist yet when sending a mail."
75 (const :tag "No FCC header" nil)
76 (string :tag "A single folder")
77 (repeat :tag "A folder based on the From header"
78 (cons regexp (choice (const :tag "No FCC header" nil)
79 (string :tag "Folder")))))
80 :require 'notmuch-fcc-initialization
83 (defcustom notmuch-maildir-use-notmuch-insert t
84 "Should fcc use notmuch insert instead of simple fcc."
85 :type '(choice :tag "Fcc Method"
86 (const :tag "Use notmuch insert" t)
87 (const :tag "Use simple fcc" nil))
90 ;;; Functions which set up the fcc header in the message buffer.
92 (defun notmuch-fcc-header-setup ()
93 "Add an Fcc header to the current message buffer.
95 If the Fcc header is already set, then keep it as-is.
96 Otherwise set it according to `notmuch-fcc-dirs'."
99 ((or (not notmuch-fcc-dirs)
100 (message-field-value "Fcc"))
101 ;; Nothing set or an existing header.
103 ((stringp notmuch-fcc-dirs)
105 ((and (listp notmuch-fcc-dirs)
106 (stringp (car notmuch-fcc-dirs)))
107 ;; Old style - no longer works.
108 (error "Invalid `notmuch-fcc-dirs' setting (old style)"))
109 ((listp notmuch-fcc-dirs)
110 (if-let ((match (seq-some (let ((from (message-field-value "From")))
111 (pcase-lambda (`(,regexp . ,folder))
112 (and (string-match-p regexp from)
116 (message "No Fcc header added.")
119 (error "Invalid `notmuch-fcc-dirs' setting (neither string nor list)")))))
121 (if notmuch-maildir-use-notmuch-insert
122 (notmuch-maildir-add-notmuch-insert-style-fcc-header subdir)
123 (notmuch-maildir-add-file-style-fcc-header subdir)))))
125 (defun notmuch-maildir-add-notmuch-insert-style-fcc-header (subdir)
126 ;; Notmuch insert does not accept absolute paths, so check the user
127 ;; really want this header inserted.
128 (when (or (not (= (elt subdir 0) ?/))
129 (y-or-n-p (format "Fcc header %s is an absolute path %s %s" subdir
130 "and notmuch insert is requested."
131 "Insert header anyway? ")))
132 (message-add-header (concat "Fcc: " subdir))))
134 (defun notmuch-maildir-add-file-style-fcc-header (subdir)
138 ;; If the resulting directory is not an absolute path,
139 ;; prepend the standard notmuch database path.
140 (if (= (elt subdir 0) ?/)
142 (concat (notmuch-database-path) "/" subdir))))))
144 ;;; Functions for saving a message using either method.
146 (defmacro with-temporary-notmuch-message-buffer (&rest body)
147 "Set-up a temporary copy of the current message-mode buffer."
148 `(let ((case-fold-search t)
149 (buf (current-buffer))
150 (mml-externalize-attachments message-fcc-externalize-attachments))
151 (with-current-buffer (get-buffer-create " *message temp*")
152 (message-clone-locals buf) ;; for message-encoded-mail-cache
154 (insert-buffer-substring buf)
157 (defun notmuch-maildir-setup-message-for-saving ()
158 "Setup message for saving.
160 This should be called on a temporary copy.
161 This is taken from the function message-do-fcc."
162 (if (not message-encoded-mail-cache)
163 (message-encode-message-body)
165 (insert message-encoded-mail-cache))
167 (message-narrow-to-headers)
168 (mail-encode-encoded-word-buffer))
169 (goto-char (point-min))
170 (when (re-search-forward
171 (concat "^" (regexp-quote mail-header-separator) "$")
173 (replace-match "" t t )))
175 (defun notmuch-maildir-message-do-fcc ()
176 "Process Fcc headers in the current buffer.
178 This is a rearranged version of message mode's message-do-fcc."
182 (message-narrow-to-headers)
183 (setq file (message-fetch-field "fcc" t)))
185 (with-temporary-notmuch-message-buffer
186 (notmuch-maildir-setup-message-for-saving)
188 (message-narrow-to-headers)
189 (while (setq file (message-fetch-field "fcc" t))
191 (message-remove-header "fcc" nil t)))
192 ;; Process FCC operations.
193 (mapc #'notmuch-fcc-handler files)
194 (kill-buffer (current-buffer)))))))
196 (defun notmuch-fcc-handler (fcc-header)
197 "Store message with notmuch insert or normal (file) fcc.
199 If `notmuch-maildir-use-notmuch-insert' is set then store the
200 message using notmuch insert. Otherwise store the message using
202 (message "Doing Fcc...")
203 (if notmuch-maildir-use-notmuch-insert
204 (notmuch-maildir-fcc-with-notmuch-insert fcc-header)
205 (notmuch-maildir-fcc-file-fcc fcc-header))
206 (message "Doing Fcc...done"))
208 ;;; Functions for saving a message using notmuch insert.
210 (defun notmuch-maildir-notmuch-insert-current-buffer (folder &optional create tags)
211 "Use notmuch insert to put the current buffer in the database.
213 This inserts the current buffer as a message into the notmuch
214 database in folder FOLDER. If CREATE is non-nil it will supply
215 the --create-folder flag to create the folder if necessary. TAGS
216 should be a list of tag changes to apply to the inserted message."
217 (apply 'notmuch-call-notmuch-process
218 :stdin-string (buffer-string) "insert"
219 (append (and create (list "--create-folder"))
220 (list (concat "--folder=" folder))
223 (defun notmuch-maildir-fcc-with-notmuch-insert (fcc-header &optional create)
224 "Store message with notmuch insert.
226 The fcc-header should be of the form \"folder +tag1 -tag2\" where
227 folder is the folder (relative to the notmuch mailstore) to store
228 the message in, and tag1 and tag2 are tag changes to apply to the
229 stored message. This string is split using `split-string-and-unquote',
230 so a folder name containing spaces can be specified by
231 quoting each space with an immediately preceding backslash
232 or surrounding the entire folder name in double quotes.
234 If CREATE is non-nil then create the folder if necessary."
235 (pcase-let ((`(,folder . ,tags)
236 (split-string-and-unquote fcc-header)))
238 (notmuch-maildir-notmuch-insert-current-buffer folder create tags)
239 ;; Since there are many reasons notmuch insert could fail, e.g.,
240 ;; locked database, non-existent folder (which could be due to a
241 ;; typo, or just the user want a new folder, let the user decide
242 ;; how to deal with it.
244 (let ((response (read-char-choice "Insert failed: \
245 \(r)etry, (c)reate folder, (i)gnore, or (e)dit the header? " '(?r ?c ?i ?e))))
247 (?r (notmuch-maildir-fcc-with-notmuch-insert fcc-header))
248 (?c (notmuch-maildir-fcc-with-notmuch-insert fcc-header t))
250 (?e (notmuch-maildir-fcc-with-notmuch-insert
251 (read-from-minibuffer "Fcc header: " fcc-header)))))))))
253 ;;; Functions for saving a message using file fcc.
255 (defun notmuch-maildir-fcc-host-fixer (hostname)
256 (replace-regexp-in-string "/\\|:"
258 (cond ((string-equal s "/") "\\057")
259 ((string-equal s ":") "\\072")
265 (defun notmuch-maildir-fcc-make-uniq-maildir-id ()
266 (let* ((ftime (float-time))
267 (microseconds (mod (* 1000000 ftime) 1000000))
268 (hostname (notmuch-maildir-fcc-host-fixer (system-name))))
269 (cl-incf notmuch-maildir-fcc-count)
270 (format "%d.%d_%d_%d.%s"
274 notmuch-maildir-fcc-count
277 (defun notmuch-maildir-fcc-dir-is-maildir-p (dir)
278 (and (file-exists-p (concat dir "/cur/"))
279 (file-exists-p (concat dir "/new/"))
280 (file-exists-p (concat dir "/tmp/"))))
282 (defun notmuch-maildir-fcc-create-maildir (path)
283 (cond ((or (not (file-exists-p path)) (file-directory-p path))
284 (make-directory (concat path "/cur/") t)
285 (make-directory (concat path "/new/") t)
286 (make-directory (concat path "/tmp/") t))
287 ((file-regular-p path)
288 (error "%s is a file. Can't create maildir." path))
290 (error "I don't know how to create a maildir here"))))
292 (defun notmuch-maildir-fcc-save-buffer-to-tmp (destdir)
293 "Returns the msg id of the message written to the temp directory
294 if successful, nil if not."
295 (let ((msg-id (notmuch-maildir-fcc-make-uniq-maildir-id)))
296 (while (file-exists-p (concat destdir "/tmp/" msg-id))
297 (setq msg-id (notmuch-maildir-fcc-make-uniq-maildir-id)))
298 (cond ((notmuch-maildir-fcc-dir-is-maildir-p destdir)
299 (write-file (concat destdir "/tmp/" msg-id))
302 (error "Can't write to %s. Not a maildir." destdir)))))
304 (defun notmuch-maildir-fcc-move-tmp-to-new (destdir msg-id)
306 (concat destdir "/tmp/" msg-id)
307 (concat destdir "/new/" msg-id ":2,")))
309 (defun notmuch-maildir-fcc-move-tmp-to-cur (destdir msg-id &optional mark-seen)
311 (concat destdir "/tmp/" msg-id)
312 (concat destdir "/cur/" msg-id ":2," (and mark-seen "S"))))
314 (defun notmuch-maildir-fcc-file-fcc (fcc-header)
315 "Write the message to the file specified by FCC-HEADER.
317 If that fails, then offer the user a chance to correct the header
319 (if (notmuch-maildir-fcc-dir-is-maildir-p fcc-header)
320 (notmuch-maildir-fcc-write-buffer-to-maildir fcc-header t)
321 ;; The fcc-header is not a valid maildir see if the user wants to
322 ;; fix it in some way.
323 (let* ((prompt (format "Fcc %s is not a maildir: \
324 \(r)etry, (c)reate folder, (i)gnore, or (e)dit the header? " fcc-header))
325 (response (read-char-choice prompt '(?r ?c ?i ?e))))
327 (?r (notmuch-maildir-fcc-file-fcc fcc-header))
328 (?c (if (file-writable-p fcc-header)
329 (notmuch-maildir-fcc-create-maildir fcc-header)
330 (message "No permission to create %s." fcc-header)
332 (notmuch-maildir-fcc-file-fcc fcc-header))
334 (?e (notmuch-maildir-fcc-file-fcc
335 (read-from-minibuffer "Fcc header: " fcc-header)))))))
337 (defun notmuch-maildir-fcc-write-buffer-to-maildir (destdir &optional mark-seen)
338 "Write the current buffer to maildir destdir.
340 If mark-seen is non-nil, then write it to \"cur/\", and mark it
341 as read, otherwise write it to \"new/\". Return t if successful,
343 (let ((orig-buffer (buffer-name)))
345 (insert-buffer-substring orig-buffer)
347 (let ((msg-id (notmuch-maildir-fcc-save-buffer-to-tmp destdir)))
351 (notmuch-maildir-fcc-move-tmp-to-cur destdir msg-id t)
352 (notmuch-maildir-fcc-move-tmp-to-new destdir msg-id))
354 (throw 'link-error nil))))
355 (delete-file (concat destdir "/tmp/" msg-id))))
360 (provide 'notmuch-maildir-fcc)
362 ;;; notmuch-maildir-fcc.el ends here