1 ;;; mm-uu.el --- Return uu stuff as mm handles
3 ;; Copyright (C) 1998, 1999, 2000, 2001, 2002, 2003, 2004,
4 ;; 2005, 2006, 2007, 2008, 2009 Free Software Foundation, Inc.
6 ;; Author: Shenghuo Zhu <zsh@cs.rochester.edu>
7 ;; Keywords: postscript uudecode binhex shar forward gnatsweb pgp
9 ;; This file is part of GNU Emacs.
11 ;; GNU Emacs is free software: you can redistribute it and/or modify
12 ;; it under the terms of the GNU General Public License as published by
13 ;; the Free Software Foundation, either version 3 of the License, or
14 ;; (at your option) any later version.
16 ;; GNU Emacs is distributed in the hope that it will be useful,
17 ;; but WITHOUT ANY WARRANTY; without even the implied warranty of
18 ;; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
19 ;; GNU General Public License for more details.
21 ;; You should have received a copy of the GNU General Public License
22 ;; along with GNU Emacs. If not, see <http://www.gnu.org/licenses/>.
28 (eval-when-compile (require 'cl
))
35 (autoload 'uudecode-decode-region
"uudecode")
36 (autoload 'uudecode-decode-region-external
"uudecode")
37 (autoload 'uudecode-decode-region-internal
"uudecode")
39 (autoload 'binhex-decode-region
"binhex")
40 (autoload 'binhex-decode-region-external
"binhex")
41 (autoload 'binhex-decode-region-internal
"binhex")
43 (autoload 'yenc-decode-region
"yenc")
44 (autoload 'yenc-extract-filename
"yenc")
46 (defcustom mm-uu-decode-function
'uudecode-decode-region
47 "*Function to uudecode.
48 Internal function is done in Lisp by default, therefore decoding may
49 appear to be horribly slow. You can make Gnus use an external
50 decoder, such as uudecode."
52 (function-item :tag
"Auto detect" uudecode-decode-region
)
53 (function-item :tag
"Internal" uudecode-decode-region-internal
)
54 (function-item :tag
"External" uudecode-decode-region-external
))
55 :group
'gnus-article-mime
)
57 (defcustom mm-uu-binhex-decode-function
'binhex-decode-region
58 "*Function to binhex decode.
59 Internal function is done in elisp by default, therefore decoding may
60 appear to be horribly slow . You can make Gnus use the external Unix
61 decoder, such as hexbin."
62 :type
'(choice (function-item :tag
"Auto detect" binhex-decode-region
)
63 (function-item :tag
"Internal" binhex-decode-region-internal
)
64 (function-item :tag
"External" binhex-decode-region-external
))
65 :group
'gnus-article-mime
)
67 (defvar mm-uu-yenc-decode-function
'yenc-decode-region
)
69 (defvar mm-uu-beginning-regexp nil
)
71 (defvar mm-dissect-disposition
"inline"
72 "The default disposition of uu parts.
73 This can be either \"inline\" or \"attachment\".")
75 (defcustom mm-uu-emacs-sources-regexp
"\\.emacs\\.sources"
76 "The regexp of Emacs sources groups."
79 :group
'gnus-article-mime
)
81 (defcustom mm-uu-diff-groups-regexp
82 "\\(gmane\\|gnu\\)\\..*\\(diff\\|commit\\|cvs\\|bug\\|devel\\)"
83 "Regexp matching diff groups."
86 :group
'gnus-article-mime
)
88 (defcustom mm-uu-tex-groups-regexp
"\\.tex\\>"
89 "*Regexp matching TeX groups."
92 :group
'gnus-article-mime
)
94 (defvar mm-uu-type-alist
98 mm-uu-postscript-extract
100 (uu ;; Maybe we should have a more strict test here.
101 "^begin[ \t]+0?[0-7][0-7][0-7][ \t]+"
110 mm-uu-binhex-filename
)
112 "^=ybegin.*size=[0-9]+.*name=.*$"
113 "^=yend.*size=[0-9]+"
121 ;; Thanks to Edward J. Sabol <sabol@alderaan.gsfc.nasa.gov> and
122 ;; Peter von der Ah\'e <pahe@daimi.au.dk>
123 "^-+ \\(Start of \\)?Forwarded message"
124 "^-+ End \\(of \\)?forwarded message"
125 mm-uu-forward-extract
129 "^----gnatsweb-attachment----"
131 mm-uu-gnatsweb-extract
)
133 "^-----BEGIN PGP SIGNED MESSAGE-----"
134 "^-----END PGP SIGNATURE-----"
135 mm-uu-pgp-signed-extract
139 "^-----BEGIN PGP MESSAGE-----"
140 "^-----END PGP MESSAGE-----"
141 mm-uu-pgp-encrypted-extract
145 "^-----BEGIN PGP PUBLIC KEY BLOCK-----"
146 "^-----END PGP PUBLIC KEY BLOCK-----"
147 mm-uu-pgp-key-extract
148 mm-uu-gpg-key-skip-to-last
151 "^;;;?[ \t]*[^ \t]+\\.el[ \t]*--"
152 "^;;;?[ \t]*\\([^ \t]+\\.el\\)[ \t]+ends here"
153 mm-uu-emacs-sources-extract
155 mm-uu-emacs-sources-test
)
163 ;; Text enclosed with tags similar to `message-mark-insert-begin' and
164 ;; `message-mark-insert-end'. Don't use those variables to avoid
165 ;; dependency on `message.el'.
166 "^-+[8<>]*-\\{9,\\}[a-z ]+-\\{9,\\}[a-z ]+-\\{9,\\}[8<>]*-+$"
167 "^-+[8<>]*-\\{9,\\}[a-z ]+-\\{9,\\}[a-z ]+-\\{9,\\}[8<>]*-+$"
168 (lambda () (mm-uu-verbatim-marks-extract -
1 0 1 -
1))
170 ;; Omitting [a-z8<] leads to false positives (bogus signature separators
171 ;; and mailing list banners).
173 "^ *\\(-\\|_\\)\\{30,\\}.*[a-z8<].*\\(-\\|_\\)\\{30,\\} *$"
174 "^ *\\(-\\|_\\)\\{30,\\}.*[a-z8<].*\\(-\\|_\\)\\{30,\\} *$"
175 (lambda () (mm-uu-verbatim-marks-extract 0 0 1 -
1))
178 ;; slrn-style verbatim marks, see
179 ;; http://www.slrn.org/manual/slrn-manual-6.html#ss6.81
182 (lambda () (mm-uu-verbatim-marks-extract 0 0))
185 "^\\([\\\\%][^\n]+\n\\)*\\\\documentclass.*[[{%]"
190 "A list of specifications for non-MIME attachments.
191 Each element consist of the following entries: label,
192 start-regexp, end-regexp, extract-function, test-function.
194 After modifying this list you must run \\[mm-uu-configure].
196 You can disable elements from this list by customizing
197 `mm-uu-configure-list'.")
199 (defcustom mm-uu-configure-list
'((shar . disabled
))
200 "A list of mm-uu configuration.
201 To disable dissecting shar codes, for instance, add
202 `(shar . disabled)' to this list."
204 :options
(mapcar (lambda (entry)
205 (list (car entry
) '(const disabled
)))
207 :group
'gnus-article-mime
)
209 (defvar mm-uu-text-plain-type
'("text/plain" (charset . gnus-decoded
))
210 "MIME type and parameters for text/plain parts.
211 `gnus-decoded' is a fake charset, which means no further decoding.")
215 (defsubst mm-uu-type
(entry)
218 (defsubst mm-uu-beginning-regexp
(entry)
221 (defsubst mm-uu-end-regexp
(entry)
224 (defsubst mm-uu-function-extract
(entry)
227 (defsubst mm-uu-function-1
(entry)
230 (defsubst mm-uu-function-2
(entry)
233 ;; In Emacs 22, we could use `min-colors' in the face definition. But Emacs
234 ;; 21 and XEmacs don't support it.
235 (defcustom mm-uu-hide-markers
236 (< 16 (or (and (fboundp 'defined-colors
)
237 (length (defined-colors)))
238 (and (fboundp 'device-color-cells
)
239 (device-color-cells))
241 "If non-nil, hide verbatim markers.
242 The value should be nil on displays where the face
243 `mm-uu-extract' isn't distinguishable to the face `default'."
244 :type
'(choice (const :tag
"Hide" t
)
245 (const :tag
"Don't hide" nil
))
246 :version
"23.1" ;; No Gnus
247 :group
'gnus-article-mime
)
249 (defface mm-uu-extract
'(;; Inspired by `gnus-cite-3'
253 (:background
"dark blue"))
256 (:foreground
"light yellow"
257 :background
"dark green"))
261 (:foreground
"dark blue"))
264 (:foreground
"dark green"
265 :background
"light yellow"))
268 "Face for extracted buffers."
269 ;; See `mm-uu-verbatim-marks-extract'.
270 :version
"23.1" ;; No Gnus
271 :group
'gnus-article-mime
)
273 (defun mm-uu-copy-to-buffer (&optional from to properties
)
274 "Copy the contents of the current buffer to a fresh buffer.
277 If PROPERTIES is non-nil, PROPERTIES are applied to the buffer,
278 see `set-text-properties'. If PROPERTIES equals t, this means to
279 apply the face `mm-uu-extract'."
280 (let ((obuf (current-buffer))
281 (multi (and (boundp 'enable-multibyte-characters
)
282 enable-multibyte-characters
))
284 ;; Might not exist in non-MULE XEmacs
285 (when (boundp 'buffer-file-coding-system
)
286 buffer-file-coding-system
)))
287 (with-current-buffer (generate-new-buffer " *mm-uu*")
288 (if multi
(mm-enable-multibyte) (mm-disable-multibyte))
289 (setq buffer-file-coding-system coding-system
)
290 (insert-buffer-substring obuf from to
)
291 (cond ((eq properties t
)
292 (set-text-properties (point-min) (point-max)
293 '(face mm-uu-extract
)))
295 (set-text-properties (point-min) (point-max) properties
)))
298 (defun mm-uu-configure-p (key val
)
299 (member (cons key val
) mm-uu-configure-list
))
301 (defun mm-uu-configure (&optional symbol value
)
302 "Configure detection of non-MIME attachments."
304 (if symbol
(set-default symbol value
))
305 (setq mm-uu-beginning-regexp nil
)
306 (mapcar (lambda (entry)
307 (if (mm-uu-configure-p (mm-uu-type entry
) 'disabled
)
309 (setq mm-uu-beginning-regexp
310 (concat mm-uu-beginning-regexp
311 (if mm-uu-beginning-regexp
"\\|")
312 (mm-uu-beginning-regexp entry
)))))
322 (defun mm-uu-uu-filename ()
323 (if (looking-at ".+")
325 (let ((nnheader-file-name-translation-alist
326 '((?
/ . ?
,) (?\ . ?_
) (?
* . ?_
) (?$ . ?_
))))
327 (nnheader-translate-file-chars (match-string 0))))))
329 (defun mm-uu-binhex-filename ()
332 (binhex-decode-region start-point end-point t
))))
334 (defun mm-uu-yenc-filename ()
335 (goto-char start-point
)
338 (yenc-extract-filename))))
340 (defun mm-uu-forward-test ()
342 (goto-char start-point
)
344 (looking-at "[\r\n]*[a-zA-Z][a-zA-Z0-9-]*:")))
346 (defun mm-uu-postscript-extract ()
347 (mm-make-handle (mm-uu-copy-to-buffer start-point end-point
)
348 '("application/postscript")))
350 (defun mm-uu-verbatim-marks-extract (start-offset end-offset
354 (let ((start (or (and mm-uu-hide-markers
358 (end (or (and mm-uu-hide-markers
363 (mm-uu-copy-to-buffer
364 (progn (goto-char start-point
)
367 (progn (goto-char end-point
)
371 '("text/x-verbatim" (charset . gnus-decoded
)))))
373 (defun mm-uu-latex-extract ()
375 (mm-uu-copy-to-buffer start-point end-point t
)
376 ;; application/x-tex?
377 '("text/x-verbatim" (charset . gnus-decoded
))))
379 (defun mm-uu-emacs-sources-extract ()
380 (mm-make-handle (mm-uu-copy-to-buffer start-point end-point
)
381 '("application/emacs-lisp" (charset . gnus-decoded
))
383 (list mm-dissect-disposition
384 (cons 'filename file-name
))))
386 (defvar gnus-newsgroup-name
)
388 (defun mm-uu-emacs-sources-test ()
389 (setq file-name
(match-string 1))
390 (and gnus-newsgroup-name
391 mm-uu-emacs-sources-regexp
392 (string-match mm-uu-emacs-sources-regexp gnus-newsgroup-name
)))
394 (defun mm-uu-diff-extract ()
395 (mm-make-handle (mm-uu-copy-to-buffer start-point end-point
)
396 '("text/x-patch" (charset . gnus-decoded
))))
398 (defun mm-uu-diff-test ()
399 (and gnus-newsgroup-name
400 mm-uu-diff-groups-regexp
401 (string-match mm-uu-diff-groups-regexp gnus-newsgroup-name
)))
403 (defun mm-uu-latex-test ()
404 (and gnus-newsgroup-name
405 mm-uu-tex-groups-regexp
406 (string-match mm-uu-tex-groups-regexp gnus-newsgroup-name
)))
408 (defun mm-uu-forward-extract ()
409 (mm-make-handle (mm-uu-copy-to-buffer
410 (progn (goto-char start-point
) (forward-line) (point))
411 (progn (goto-char end-point
) (forward-line -
1) (point)))
412 '("message/rfc822" (charset . gnus-decoded
))))
414 (defun mm-uu-uu-extract ()
415 (mm-make-handle (mm-uu-copy-to-buffer start-point end-point
)
416 (list (or (and file-name
417 (string-match "\\.[^\\.]+$"
419 (mailcap-extension-to-mime
420 (match-string 0 file-name
)))
421 "application/octet-stream"))
423 (if (and file-name
(not (equal file-name
"")))
424 (list mm-dissect-disposition
425 (cons 'filename file-name
)))))
427 (defun mm-uu-binhex-extract ()
428 (mm-make-handle (mm-uu-copy-to-buffer start-point end-point
)
429 (list (or (and file-name
430 (string-match "\\.[^\\.]+$" file-name
)
431 (mailcap-extension-to-mime
432 (match-string 0 file-name
)))
433 "application/octet-stream"))
435 (if (and file-name
(not (equal file-name
"")))
436 (list mm-dissect-disposition
437 (cons 'filename file-name
)))))
439 (defvar gnus-original-article-buffer
) ; gnus.el
441 (defun mm-uu-yenc-extract ()
442 ;; This might not be exactly correct, but we sure can't get the
443 ;; binary data from the article buffer, since that's already in a
444 ;; non-binary charset. So get it from the original article buffer.
445 (mm-make-handle (with-current-buffer gnus-original-article-buffer
446 (mm-uu-copy-to-buffer start-point end-point
))
447 (list (or (and file-name
448 (string-match "\\.[^\\.]+$" file-name
)
449 (mailcap-extension-to-mime
450 (match-string 0 file-name
)))
451 "application/octet-stream"))
453 (if (and file-name
(not (equal file-name
"")))
454 (list mm-dissect-disposition
455 (cons 'filename file-name
)))))
458 (defun mm-uu-shar-extract ()
459 (mm-make-handle (mm-uu-copy-to-buffer start-point end-point
)
460 '("application/x-shar")))
462 (defun mm-uu-gnatsweb-extract ()
464 (goto-char start-point
)
466 (narrow-to-region (point) end-point
)
467 (mm-dissect-buffer t
)))
469 (defun mm-uu-pgp-signed-test (&rest rest
)
472 (mml2015-clear-verify-function)
474 ((eq mm-verify-option
'never
) nil
)
475 ((eq mm-verify-option
'always
) t
)
476 ((eq mm-verify-option
'known
) t
)
478 (y-or-n-p "Verify pgp signed part? ")
481 (defvar gnus-newsgroup-charset
)
483 (defun mm-uu-pgp-signed-extract-1 (handles ctl
)
484 (let ((buf (mm-uu-copy-to-buffer (point-min) (point-max))))
485 (with-current-buffer buf
486 (if (mm-uu-pgp-signed-test)
488 (mml2015-clean-buffer)
489 (let ((coding-system-for-write (or gnus-newsgroup-charset
491 (coding-system-for-read (or gnus-newsgroup-charset
493 (funcall (mml2015-clear-verify-function))))
494 (when (and mml2015-use
(null (mml2015-clear-verify-function)))
495 (mm-set-handle-multipart-parameter
496 mm-security-handle
'gnus-details
497 (format "Clear verification not supported by `%s'.\n" mml2015-use
)))
498 (mml2015-extract-cleartext-signature))
499 (list (mm-make-handle buf mm-uu-text-plain-type
)))))
501 (defun mm-uu-pgp-signed-extract ()
502 (let ((mm-security-handle (list (format "multipart/signed"))))
503 (mm-set-handle-multipart-parameter
504 mm-security-handle
'protocol
"application/x-gnus-pgp-signature")
506 (narrow-to-region start-point end-point
)
507 (add-text-properties 0 (length (car mm-security-handle
))
508 (list 'buffer
(mm-uu-copy-to-buffer))
509 (car mm-security-handle
))
510 (setcdr mm-security-handle
511 (mm-uu-pgp-signed-extract-1 nil
512 mm-security-handle
)))
515 (defun mm-uu-pgp-encrypted-test (&rest rest
)
518 (mml2015-clear-decrypt-function)
520 ((eq mm-decrypt-option
'never
) nil
)
521 ((eq mm-decrypt-option
'always
) t
)
522 ((eq mm-decrypt-option
'known
) t
)
524 (y-or-n-p "Decrypt pgp encrypted part? ")
527 (defun mm-uu-pgp-encrypted-extract-1 (handles ctl
)
528 (let ((buf (mm-uu-copy-to-buffer (point-min) (point-max)))
531 ;; Make sure there's a blank line between header and body.
532 (with-current-buffer buf
533 (goto-char (point-min))
537 (looking-at "[^\t\n ]+:")
538 (looking-at "[^\t\n ]+:\\|[\t ]"))
540 (unless (memq (char-after) '(?
\n nil
))
543 (narrow-to-region (point-min) (point))
544 (setq charset
(mail-fetch-field "charset")))
545 (if (and (mm-uu-pgp-encrypted-test)
547 (mml2015-clean-buffer)
548 (funcall (mml2015-clear-decrypt-function))
549 (equal (mm-handle-multipart-ctl-parameter mm-security-handle
555 (setq charset gnus-newsgroup-charset
))
556 (setq charset
(mm-charset-to-coding-system charset
))
557 (not (eq charset
'ascii
)))
558 ;; Assume that buffer's multibyteness is turned off.
559 ;; See `mml2015-pgg-clear-decrypt'.
560 (insert (mm-decode-coding-string (prog1
563 (mm-enable-multibyte))
565 (mm-enable-multibyte))
566 (list (mm-make-handle buf mm-uu-text-plain-type
)))
567 (list (mm-make-handle buf
'("application/pgp-encrypted")))))))
569 (defun mm-uu-pgp-encrypted-extract ()
570 (let ((mm-security-handle (list (format "multipart/encrypted"))))
571 (mm-set-handle-multipart-parameter
572 mm-security-handle
'protocol
"application/x-gnus-pgp-encrypted")
574 (narrow-to-region start-point end-point
)
575 (add-text-properties 0 (length (car mm-security-handle
))
576 (list 'buffer
(mm-uu-copy-to-buffer))
577 (car mm-security-handle
))
578 (setcdr mm-security-handle
579 (mm-uu-pgp-encrypted-extract-1 nil
580 mm-security-handle
)))
583 (defun mm-uu-gpg-key-skip-to-last ()
584 (let ((point (point))
585 (end-regexp (mm-uu-end-regexp entry
))
586 (beginning-regexp (mm-uu-beginning-regexp entry
)))
587 (when (and end-regexp
588 (not (mm-uu-configure-p (mm-uu-type entry
) 'disabled
)))
589 (while (re-search-forward end-regexp nil t
)
590 (skip-chars-forward " \t\n\r")
591 (if (looking-at beginning-regexp
)
592 (setq point
(match-end 0)))))
595 (defun mm-uu-pgp-key-extract ()
596 (let ((buf (mm-uu-copy-to-buffer start-point end-point
)))
598 '("application/pgp-keys"))))
601 (defun mm-uu-dissect (&optional noheader mime-type
)
602 "Dissect the current buffer and return a list of uu handles.
603 The optional NOHEADER means there's no header in the buffer.
604 MIME-TYPE specifies a MIME type and parameters, which defaults to the
605 value of `mm-uu-text-plain-type'."
606 (let ((case-fold-search t
)
607 (mm-uu-text-plain-type (or mime-type mm-uu-text-plain-type
))
608 text-start start-point end-point file-name result entry func
)
610 (goto-char (point-min))
615 ((search-forward "\n\n" nil t
)
617 (t (goto-char (point-max))))
618 (setq text-start
(point))
619 (while (re-search-forward mm-uu-beginning-regexp nil t
)
620 (setq start-point
(match-beginning 0)
622 (let ((alist mm-uu-type-alist
)
623 (beginning-regexp (match-string 0)))
625 (if (string-match (mm-uu-beginning-regexp (car alist
))
627 (setq entry
(car alist
))
629 (if (setq func
(mm-uu-function-1 entry
))
631 (forward-line);; in case of failure
632 (when (and (not (mm-uu-configure-p (mm-uu-type entry
) 'disabled
))
633 (let ((end-regexp (mm-uu-end-regexp entry
)))
635 (or (setq end-point
(point-max)) t
)
637 (re-search-forward end-regexp nil t
)
639 (setq end-point
(point)))))
640 (or (not (setq func
(mm-uu-function-2 entry
)))
642 (if (and (> start-point text-start
)
644 (goto-char text-start
)
645 (re-search-forward "." start-point t
)))
647 (mm-make-handle (mm-uu-copy-to-buffer text-start start-point
)
648 mm-uu-text-plain-type
)
651 (funcall (mm-uu-function-extract entry
))
653 (goto-char (setq text-start end-point
))))
655 (if (and (> (point-max) (1+ text-start
))
657 (goto-char text-start
)
658 (re-search-forward "." nil t
)))
660 (mm-make-handle (mm-uu-copy-to-buffer text-start
(point-max))
661 mm-uu-text-plain-type
)
663 (setq result
(cons "multipart/mixed" (nreverse result
))))
667 (defun mm-uu-dissect-text-parts (handle &optional decoded
)
668 "Dissect text parts and put uu handles into HANDLE.
669 Assume text has been decoded if DECODED is non-nil."
670 (let ((buffer (mm-handle-buffer handle
)))
671 (cond ((stringp buffer
)
672 (dolist (elem (cdr handle
))
673 (mm-uu-dissect-text-parts elem decoded
)))
675 (let ((type (mm-handle-media-type handle
))
676 (case-fold-search t
) ;; string-match
677 children charset encoding
)
680 ;; Mutt still uses application/pgp even though
681 ;; it has already been withdrawn.
682 (string-match "\\`text/\\|\\`application/pgp\\'" type
)
685 (with-current-buffer buffer
688 (eq (setq charset
(mail-content-type-get
689 (mm-handle-type handle
)
694 t
(cons type
'((charset . gnus-decoded
)))))
697 (mm-with-multibyte-buffer
698 (insert (mm-decode-string (mm-get-part handle
)
701 t
(cons type
'((charset . gnus-decoded
))))))
702 ((setq encoding
(mm-handle-encoding handle
))
704 ;; Inherit the multibyteness of the `buffer'.
706 (insert-buffer-substring buffer
)
707 (mm-decode-content-transfer-encoding
709 (mm-uu-dissect t
(list type
))))
712 (mm-uu-dissect t
(list type
)))))))
713 ;; Ignore it if a given part is dissected into a single
714 ;; part of which the type is the same as the given one.
715 (if (and (<= (length children
) 2)
716 (string-equal (mm-handle-media-type (cadr children
))
718 (kill-buffer (mm-handle-buffer (cadr children
)))
720 (setcdr handle
(cdr children
))
721 (setcar handle
(car children
)) ;; "multipart/mixed"
722 (dolist (elem (cdr children
))
723 (mm-uu-dissect-text-parts elem decoded
))))))
725 (dolist (elem handle
)
726 (mm-uu-dissect-text-parts elem decoded
))))))
730 ;; arch-tag: 7db076bf-53db-4320-aa19-ca76a1d2ab2c
731 ;;; mm-uu.el ends here