Mercurial > emacs
annotate lisp/mail/mailclient.el @ 95392:838b2bca5a6f
*** empty log message ***
author | Juanma Barranquero <lekktu@gmail.com> |
---|---|
date | Thu, 29 May 2008 20:05:36 +0000 |
parents | ef65fa4dca3b |
children | a9dc0e7c3f2b |
rev | line source |
---|---|
65664 | 1 ;;; mailclient.el --- mail sending via system's mail client. -*- byte-compile-dynamic: t -*- |
2 | |
79712 | 3 ;; Copyright (C) 2005, 2006, 2007, 2008 Free Software Foundation |
65664 | 4 |
5 ;; Author: David Reitter <david.reitter@gmail.com> | |
6 ;; Keywords: mail | |
7 | |
8 ;; This file is part of GNU Emacs. | |
9 | |
94674
ef65fa4dca3b
Switch to recommended form of GPLv3 permissions notice.
Glenn Morris <rgm@gnu.org>
parents:
79712
diff
changeset
|
10 ;; GNU Emacs is free software: you can redistribute it and/or modify |
65664 | 11 ;; it under the terms of the GNU General Public License as published by |
94674
ef65fa4dca3b
Switch to recommended form of GPLv3 permissions notice.
Glenn Morris <rgm@gnu.org>
parents:
79712
diff
changeset
|
12 ;; the Free Software Foundation, either version 3 of the License, or |
ef65fa4dca3b
Switch to recommended form of GPLv3 permissions notice.
Glenn Morris <rgm@gnu.org>
parents:
79712
diff
changeset
|
13 ;; (at your option) any later version. |
65664 | 14 |
15 ;; GNU Emacs is distributed in the hope that it will be useful, | |
16 ;; but WITHOUT ANY WARRANTY; without even the implied warranty of | |
17 ;; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the | |
18 ;; GNU General Public License for more details. | |
19 | |
20 ;; You should have received a copy of the GNU General Public License | |
94674
ef65fa4dca3b
Switch to recommended form of GPLv3 permissions notice.
Glenn Morris <rgm@gnu.org>
parents:
79712
diff
changeset
|
21 ;; along with GNU Emacs. If not, see <http://www.gnu.org/licenses/>. |
65664 | 22 |
23 ;;; Commentary: | |
24 | |
68565
877f39b663ef
(mailclient-place-body-on-clipboard-flag): Fix typo in docstring.
Juanma Barranquero <lekktu@gmail.com>
parents:
65685
diff
changeset
|
25 ;; This package allows to hand over a buffer to be sent off |
877f39b663ef
(mailclient-place-body-on-clipboard-flag): Fix typo in docstring.
Juanma Barranquero <lekktu@gmail.com>
parents:
65685
diff
changeset
|
26 ;; via the system's designated e-mail client. |
65664 | 27 ;; Note that the e-mail client will display the contents of the buffer |
28 ;; again for editing. | |
29 ;; The e-mail client is taken to be whoever handles a mailto: URL | |
68565
877f39b663ef
(mailclient-place-body-on-clipboard-flag): Fix typo in docstring.
Juanma Barranquero <lekktu@gmail.com>
parents:
65685
diff
changeset
|
30 ;; via `browse-url'. |
65664 | 31 ;; Mailto: URLs are composed according to RFC2368. |
32 | |
33 ;; MIME bodies are not supported - we rather expect the mail client | |
34 ;; to encode the body and add, for example, a digital signature. | |
35 ;; The mailto URL RFC calls for "short text messages that are | |
68565
877f39b663ef
(mailclient-place-body-on-clipboard-flag): Fix typo in docstring.
Juanma Barranquero <lekktu@gmail.com>
parents:
65685
diff
changeset
|
36 ;; actually the content of automatic processing." |
65664 | 37 ;; So mailclient.el is ideal for situations where an e-mail is |
68565
877f39b663ef
(mailclient-place-body-on-clipboard-flag): Fix typo in docstring.
Juanma Barranquero <lekktu@gmail.com>
parents:
65685
diff
changeset
|
38 ;; generated automatically, and the user can edit it in the |
877f39b663ef
(mailclient-place-body-on-clipboard-flag): Fix typo in docstring.
Juanma Barranquero <lekktu@gmail.com>
parents:
65685
diff
changeset
|
39 ;; mail client (e.g. bug-reports). |
65664 | 40 |
41 ;; To activate: | |
42 ;; (setq send-mail-function 'mailclient-send-it) ; if you use `mail' | |
43 | |
44 ;;; Code: | |
45 | |
46 | |
47 (require 'sendmail) ;; for mail-sendmail-undelimit-header | |
48 (require 'mail-utils) ;; for mail-fetch-field | |
49 | |
68565
877f39b663ef
(mailclient-place-body-on-clipboard-flag): Fix typo in docstring.
Juanma Barranquero <lekktu@gmail.com>
parents:
65685
diff
changeset
|
50 (defcustom mailclient-place-body-on-clipboard-flag |
65664 | 51 (fboundp 'w32-set-clipboard-data) |
52 "If non-nil, put the e-mail body on the clipboard in mailclient. | |
68565
877f39b663ef
(mailclient-place-body-on-clipboard-flag): Fix typo in docstring.
Juanma Barranquero <lekktu@gmail.com>
parents:
65685
diff
changeset
|
53 This is useful on systems where only short mailto:// URLs are |
877f39b663ef
(mailclient-place-body-on-clipboard-flag): Fix typo in docstring.
Juanma Barranquero <lekktu@gmail.com>
parents:
65685
diff
changeset
|
54 supported. Defaults to non-nil on Windows, nil otherwise." |
65664 | 55 :type 'boolean |
56 :group 'mail) | |
57 | |
58 (defun mailclient-encode-string-as-url (string) | |
59 "Convert STRING to a URL, using utf-8 as encoding." | |
60 (apply (function concat) | |
61 (mapcar | |
62 (lambda (char) | |
63 (cond | |
64 ((eq char ?\x20) "%20") ;; space | |
68565
877f39b663ef
(mailclient-place-body-on-clipboard-flag): Fix typo in docstring.
Juanma Barranquero <lekktu@gmail.com>
parents:
65685
diff
changeset
|
65 ((eq char ?\n) "%0D%0A") ;; newline |
65664 | 66 ((string-match "[-a-zA-Z0-9_:/.@]" (char-to-string char)) |
67 (char-to-string char)) ;; printable | |
68 (t ;; everything else | |
69 (format "%%%02x" char)))) ;; escape | |
70 ;; Convert string to list of chars | |
71 (append (encode-coding-string string 'utf-8))))) | |
72 | |
73 (defvar mailclient-delim-static "?") | |
74 (defun mailclient-url-delim () | |
75 (let ((current mailclient-delim-static)) | |
68565
877f39b663ef
(mailclient-place-body-on-clipboard-flag): Fix typo in docstring.
Juanma Barranquero <lekktu@gmail.com>
parents:
65685
diff
changeset
|
76 (setq mailclient-delim-static "&") |
65664 | 77 current)) |
78 | |
79 (defun mailclient-gather-addresses (str &optional drop-first-name) | |
80 (let ((field (mail-fetch-field str nil t))) | |
81 (if field | |
82 (save-excursion | |
68565
877f39b663ef
(mailclient-place-body-on-clipboard-flag): Fix typo in docstring.
Juanma Barranquero <lekktu@gmail.com>
parents:
65685
diff
changeset
|
83 (let ((first t) |
65664 | 84 (result "")) |
85 (mapc | |
86 (lambda (recp) | |
68565
877f39b663ef
(mailclient-place-body-on-clipboard-flag): Fix typo in docstring.
Juanma Barranquero <lekktu@gmail.com>
parents:
65685
diff
changeset
|
87 (setq result |
877f39b663ef
(mailclient-place-body-on-clipboard-flag): Fix typo in docstring.
Juanma Barranquero <lekktu@gmail.com>
parents:
65685
diff
changeset
|
88 (concat |
65664 | 89 result |
90 (if (and drop-first-name | |
91 first) | |
92 "" | |
93 (concat (mailclient-url-delim) str "=")) | |
68565
877f39b663ef
(mailclient-place-body-on-clipboard-flag): Fix typo in docstring.
Juanma Barranquero <lekktu@gmail.com>
parents:
65685
diff
changeset
|
94 (mailclient-encode-string-as-url |
65664 | 95 recp))) |
96 (setq first nil)) | |
68565
877f39b663ef
(mailclient-place-body-on-clipboard-flag): Fix typo in docstring.
Juanma Barranquero <lekktu@gmail.com>
parents:
65685
diff
changeset
|
97 (split-string |
65664 | 98 (mail-strip-quoted-names field) "\, *")) |
99 result))))) | |
100 | |
101 ;;;###autoload | |
68565
877f39b663ef
(mailclient-place-body-on-clipboard-flag): Fix typo in docstring.
Juanma Barranquero <lekktu@gmail.com>
parents:
65685
diff
changeset
|
102 (defun mailclient-send-it () |
65664 | 103 "Pass current buffer on to the system's mail client. |
104 Suitable value for `send-mail-function'. | |
105 The mail client is taken to be the handler of mailto URLs." | |
106 (require 'mail-utils) | |
107 (let ((case-fold-search nil) | |
108 delimline | |
109 (mailbuf (current-buffer))) | |
110 (unwind-protect | |
111 (with-temp-buffer | |
112 (insert-buffer-substring mailbuf) | |
113 ;; Move to header delimiter | |
114 (mail-sendmail-undelimit-header) | |
115 (setq delimline (point-marker)) | |
116 (if mail-aliases | |
117 (expand-mail-aliases (point-min) delimline)) | |
118 (goto-char (point-min)) | |
119 ;; ignore any blank lines in the header | |
120 (while (and (re-search-forward "\n\n\n*" delimline t) | |
121 (< (point) delimline)) | |
122 (replace-match "\n")) | |
68565
877f39b663ef
(mailclient-place-body-on-clipboard-flag): Fix typo in docstring.
Juanma Barranquero <lekktu@gmail.com>
parents:
65685
diff
changeset
|
123 (let ((case-fold-search t)) |
65664 | 124 ;; initialize limiter |
125 (setq mailclient-delim-static "?") | |
126 ;; construct and call up mailto URL | |
68565
877f39b663ef
(mailclient-place-body-on-clipboard-flag): Fix typo in docstring.
Juanma Barranquero <lekktu@gmail.com>
parents:
65685
diff
changeset
|
127 (browse-url |
877f39b663ef
(mailclient-place-body-on-clipboard-flag): Fix typo in docstring.
Juanma Barranquero <lekktu@gmail.com>
parents:
65685
diff
changeset
|
128 (concat |
65664 | 129 (save-excursion |
130 (narrow-to-region (point-min) delimline) | |
68565
877f39b663ef
(mailclient-place-body-on-clipboard-flag): Fix typo in docstring.
Juanma Barranquero <lekktu@gmail.com>
parents:
65685
diff
changeset
|
131 (concat |
65664 | 132 "mailto:" |
133 ;; some of the headers according to RFC822 | |
68565
877f39b663ef
(mailclient-place-body-on-clipboard-flag): Fix typo in docstring.
Juanma Barranquero <lekktu@gmail.com>
parents:
65685
diff
changeset
|
134 (mailclient-gather-addresses "To" |
877f39b663ef
(mailclient-place-body-on-clipboard-flag): Fix typo in docstring.
Juanma Barranquero <lekktu@gmail.com>
parents:
65685
diff
changeset
|
135 'drop-first-name) |
65664 | 136 (mailclient-gather-addresses "cc" ) |
137 (mailclient-gather-addresses "bcc" ) | |
138 (mailclient-gather-addresses "Resent-To" ) | |
139 (mailclient-gather-addresses "Resent-cc" ) | |
140 (mailclient-gather-addresses "Resent-bcc" ) | |
141 (mailclient-gather-addresses "Reply-To" ) | |
142 ;; The From field is not honored for now: it's | |
143 ;; not necessarily configured. The mail client | |
144 ;; knows the user's address(es) | |
145 ;; (mailclient-gather-addresses "From" ) | |
146 ;; subject line | |
147 (let ((subj (mail-fetch-field "Subject" nil t))) | |
148 (widen) ;; so we can read the body later on | |
149 (if subj ;; if non-blank | |
150 ;; the mail client will deal with | |
151 ;; warning the user etc. | |
68565
877f39b663ef
(mailclient-place-body-on-clipboard-flag): Fix typo in docstring.
Juanma Barranquero <lekktu@gmail.com>
parents:
65685
diff
changeset
|
152 (concat (mailclient-url-delim) "subject=" |
65664 | 153 (mailclient-encode-string-as-url subj)) |
154 "")))) | |
155 ;; body | |
68565
877f39b663ef
(mailclient-place-body-on-clipboard-flag): Fix typo in docstring.
Juanma Barranquero <lekktu@gmail.com>
parents:
65685
diff
changeset
|
156 (concat |
877f39b663ef
(mailclient-place-body-on-clipboard-flag): Fix typo in docstring.
Juanma Barranquero <lekktu@gmail.com>
parents:
65685
diff
changeset
|
157 (mailclient-url-delim) "body=" |
65664 | 158 (mailclient-encode-string-as-url |
159 (if mailclient-place-body-on-clipboard-flag | |
160 (progn | |
68565
877f39b663ef
(mailclient-place-body-on-clipboard-flag): Fix typo in docstring.
Juanma Barranquero <lekktu@gmail.com>
parents:
65685
diff
changeset
|
161 (clipboard-kill-ring-save |
65664 | 162 (+ 1 delimline) (point-max)) |
163 (concat | |
164 "*** E-Mail body has been placed on clipboard, " | |
165 "please paste them here! ***")) | |
166 ;; else | |
167 (buffer-substring (+ 1 delimline) (point-max)))))))))))) | |
168 | |
169 (provide 'mailclient) | |
170 | |
65685 | 171 ;; arch-tag: 35d10fc8-a1bc-4f29-a4e6-c288e53578ef |
65664 | 172 ;;; mailclient.el ends here |