Fix wording in a comment.
[bpt/emacs.git] / lisp / jka-compr.el
CommitLineData
be010748
RS
1;;; jka-compr.el --- reading/writing/loading compressed files
2
523b128c 3;; Copyright (C) 1993, 1994, 1995, 1997, 1999, 2000 Free Software Foundation, Inc.
acd622cc
RS
4
5;; Author: jka@ece.cmu.edu (Jay K. Adams)
4228277d 6;; Maintainer: FSF
acd622cc
RS
7;; Keywords: data
8
f4454a14
RS
9;; This file is part of GNU Emacs.
10
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 2, or (at your option)
14;; any later version.
15
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.
20
21;; You should have received a copy of the GNU General Public License
b578f267
EN
22;; along with GNU Emacs; see the file COPYING. If not, write to the
23;; Free Software Foundation, Inc., 59 Temple Place - Suite 330,
24;; Boston, MA 02111-1307, USA.
f4454a14 25
acd622cc
RS
26;;; Commentary:
27
b578f267
EN
28;; This package implements low-level support for reading, writing,
29;; and loading compressed files. It hooks into the low-level file
30;; I/O functions (including write-region and insert-file-contents) so
31;; that they automatically compress or uncompress a file if the file
32;; appears to need it (based on the extension of the file name).
33;; Packages like Rmail, VM, GNUS, and Info should be able to work
34;; with compressed files without modification.
35
36
37;; INSTRUCTIONS:
38;;
39;; To use jka-compr, simply load this package, and edit as usual.
40;; Its operation should be transparent to the user (except for
41;; messages appearing when a file is being compressed or
42;; uncompressed).
43;;
44;; The variable, jka-compr-compression-info-list can be used to
45;; customize jka-compr to work with other compression programs.
46;; The default value of this variable allows jka-compr to work with
47;; Unix compress and gzip.
48;;
49;; If you are concerned about the stderr output of gzip and other
50;; compression/decompression programs showing up in your buffers, you
51;; should set the discard-error flag in the compression-info-list.
52;; This will cause the stderr of all programs to be discarded.
53;; However, it also causes emacs to call compression/uncompression
54;; programs through a shell (which is specified by jka-compr-shell).
55;; This may be a drag if, on your system, starting up a shell is
56;; slow.
57;;
58;; If you don't want messages about compressing and decompressing
59;; to show up in the echo area, you can set the compress-name and
60;; decompress-name fields of the jka-compr-compression-info-list to
61;; nil.
62
63
64;; APPLICATION NOTES:
65;;
66;; crypt++
67;; jka-compr can coexist with crpyt++ if you take all the decompression
68;; entries out of the crypt-encoding-list. Clearly problems will arise if
69;; you have two programs trying to compress/decompress files. jka-compr
70;; will not "work with" crypt++ in the following sense: you won't be able to
71;; decode encrypted compressed files--that is, files that have been
72;; compressed then encrypted (in that order). Theoretically, crypt++ and
73;; jka-compr could properly handle a file that has been encrypted then
74;; compressed, but there is little point in trying to compress an encrypted
75;; file.
76;;
77
78
79;; ACKNOWLEDGMENTS
80;;
81;; jka-compr is a V19 adaptation of jka-compr for V18 of Emacs. Many people
82;; have made helpful suggestions, reported bugs, and even fixed bugs in
83;; jka-compr. I recall the following people as being particularly helpful.
84;;
85;; Jean-loup Gailly
86;; David Hughes
87;; Richard Pieri
88;; Daniel Quinlan
89;; Chris P. Ross
90;; Rick Sladkey
91;;
92;; Andy Norman's ange-ftp was the inspiration for the original jka-compr for
93;; Version 18 of Emacs.
94;;
95;; After I had made progress on the original jka-compr for V18, I learned of a
96;; package written by Kazushi Jam Marukawa, called jam-zcat, that did exactly
97;; what I was trying to do. I looked over the jam-zcat source code and
98;; probably got some ideas from it.
99;;
acd622cc
RS
100
101;;; Code:
102
bbf5eb28
RS
103(defgroup compression nil
104 "Data compression utilities"
105 :group 'data)
106
107(defgroup jka-compr nil
108 "jka-compr customization"
109 :group 'compression)
110
111
112(defcustom jka-compr-shell "sh"
acd622cc
RS
113 "*Shell to be used for calling compression programs.
114The value of this variable only matters if you want to discard the
115stderr of a compression/decompression program (see the documentation
bbf5eb28
RS
116for `jka-compr-compression-info-list')."
117 :type 'string
118 :group 'jka-compr)
acd622cc 119
eb915452
RS
120(defvar jka-compr-use-shell
121 (not (memq system-type '(ms-dos windows-nt))))
acd622cc
RS
122
123;;; I have this defined so that .Z files are assumed to be in unix
060c3cc9 124;;; compress format; and .gz files, in gzip format, and .bz2 files in bzip fmt.
bbf5eb28 125(defcustom jka-compr-compression-info-list
acd622cc 126 ;;[regexp
ede9c6a8
RS
127 ;; compr-message compr-prog compr-args
128 ;; uncomp-message uncomp-prog uncomp-args
e073a356 129 ;; can-append auto-mode-flag strip-extension-flag file-magic-bytes]
094cf604 130 '(["\\.Z\\(~\\|\\.~[0-9]+~\\)?\\'"
acd622cc
RS
131 "compressing" "compress" ("-c")
132 "uncompressing" "uncompress" ("-c")
e073a356 133 nil t "\037\235"]
df312987
DL
134 ;; Formerly, these had an additional arg "-c", but that fails with
135 ;; "Version 0.1pl2, 29-Aug-97." (RedHat 5.1 GNU/Linux) and
136 ;; "Version 0.9.0b, 9-Sept-98".
060c3cc9 137 ["\\.bz2\\'"
df312987
DL
138 "bzip2ing" "bzip2" nil
139 "bunzip2ing" "bzip2" ("-d")
e073a356 140 nil t "BZh"]
74b2c737
RS
141 ["\\.tgz\\'"
142 "zipping" "gzip" ("-c" "-q")
143 "unzipping" "gzip" ("-c" "-q" "-d")
e073a356 144 t nil "\037\213"]
0166aed1 145 ["\\.g?z\\(~\\|\\.~[0-9]+~\\)?\\'"
acd622cc
RS
146 "zipping" "gzip" ("-c" "-q")
147 "unzipping" "gzip" ("-c" "-q" "-d")
e073a356 148 t t "\037\213"])
acd622cc
RS
149
150 "List of vectors that describe available compression techniques.
151Each element, which describes a compression technique, is a vector of
ede9c6a8
RS
152the form [REGEXP COMPRESS-MSG COMPRESS-PROGRAM COMPRESS-ARGS
153UNCOMPRESS-MSG UNCOMPRESS-PROGRAM UNCOMPRESS-ARGS
e073a356 154APPEND-FLAG STRIP-EXTENSION-FLAG FILE-MAGIC-CHARS], where:
acd622cc
RS
155
156 regexp is a regexp that matches filenames that are
157 compressed with this format
158
ede9c6a8
RS
159 compress-msg is the message to issue to the user when doing this
160 type of compression (nil means no message)
161
acd622cc
RS
162 compress-program is a program that performs this compression
163
164 compress-args is a list of args to pass to the compress program
165
ede9c6a8
RS
166 uncompress-msg is the message to issue to the user when doing this
167 type of uncompression (nil means no message)
acd622cc
RS
168
169 uncompress-program is a program that performs this compression
170
171 uncompress-args is a list of args to pass to the uncompress program
172
173 append-flag is non-nil if this compression technique can be
174 appended
175
e073a356 176 strip-extension-flag non-nil means strip the regexp from file names
acd622cc
RS
177 before attempting to set the mode.
178
e073a356
RS
179 file-magic-chars is a string of characters that you would find
180 at the beginning of a file compressed in this way.
181
8fb1a583 182Because of the way `call-process' is defined, discarding the stderr output of
acd622cc 183a program adds the overhead of starting a shell each time the program is
bbf5eb28
RS
184invoked."
185 :type '(repeat (vector regexp
186 (choice :tag "Compress Message"
187 (string :format "%v")
188 (const :tag "No Message" nil))
189 (string :tag "Compress Program")
190 (repeat :tag "Compress Arguments" string)
191 (choice :tag "Uncompress Message"
192 (string :format "%v")
193 (const :tag "No Message" nil))
194 (string :tag "Uncompress Program")
195 (repeat :tag "Uncompress Arguments" string)
196 (boolean :tag "Append")
197 (boolean :tag "Auto Mode")))
198 :group 'jka-compr)
acd622cc 199
74b2c737
RS
200(defvar jka-compr-mode-alist-additions
201 (list (cons "\\.tgz\\'" 'tar-mode))
4eec33ae
RS
202 "A list of pairs to add to `auto-mode-alist' when jka-compr is installed.")
203
204;; List of all the elements we actually added to file-coding-system-alist.
205(defvar jka-compr-added-to-file-coding-system-alist nil)
acd622cc 206
555235e6
RS
207(defvar jka-compr-file-name-handler-entry
208 nil
209 "The entry in `file-name-handler-alist' used by the jka-compr I/O functions.")
e073a356
RS
210
211(defvar jka-compr-really-do-compress nil
212 "Non-nil in a buffer whose visited file was uncompressed on visiting it.")
213(put 'jka-compr-really-do-compress 'permanent-local t)
555235e6 214\f
43a3bdcc 215;;; Functions for accessing the return value of jka-compr-get-compression-info
acd622cc
RS
216(defun jka-compr-info-regexp (info) (aref info 0))
217(defun jka-compr-info-compress-message (info) (aref info 1))
218(defun jka-compr-info-compress-program (info) (aref info 2))
219(defun jka-compr-info-compress-args (info) (aref info 3))
220(defun jka-compr-info-uncompress-message (info) (aref info 4))
221(defun jka-compr-info-uncompress-program (info) (aref info 5))
222(defun jka-compr-info-uncompress-args (info) (aref info 6))
223(defun jka-compr-info-can-append (info) (aref info 7))
224(defun jka-compr-info-strip-extension (info) (aref info 8))
e073a356 225(defun jka-compr-info-file-magic-bytes (info) (aref info 9))
acd622cc
RS
226
227
228(defun jka-compr-get-compression-info (filename)
229 "Return information about the compression scheme of FILENAME.
230The determination as to which compression scheme, if any, to use is
99bee6a4 231based on the filename itself and `jka-compr-compression-info-list'."
acd622cc
RS
232 (catch 'compression-info
233 (let ((case-fold-search nil))
234 (mapcar
235 (function (lambda (x)
236 (and (string-match (jka-compr-info-regexp x) filename)
237 (throw 'compression-info x))))
238 jka-compr-compression-info-list)
239 nil)))
240
241
242(put 'compression-error 'error-conditions '(compression-error file-error error))
243
244
30c78e11 245(defvar jka-compr-acceptable-retval-list '(0 2 141))
acd622cc
RS
246
247
248(defun jka-compr-error (prog args infile message &optional errfile)
249
250 (let ((errbuf (get-buffer-create " *jka-compr-error*"))
251 (curbuf (current-buffer)))
75e9c107
RS
252 (with-current-buffer errbuf
253 (widen) (erase-buffer)
254 (insert (format "Error while executing \"%s %s < %s\"\n\n"
255 prog
256 (mapconcat 'identity args " ")
257 infile))
258
259 (and errfile
260 (insert-file-contents errfile)))
acd622cc
RS
261 (display-buffer errbuf))
262
75e9c107
RS
263 (signal 'compression-error
264 (list "Opening input file" (format "error %s" message) infile)))
acd622cc
RS
265
266
267(defvar jka-compr-dd-program
268 "/bin/dd")
269
270
dfe05fac 271(defvar jka-compr-dd-blocksize 256)
acd622cc
RS
272
273
274(defun jka-compr-partial-uncompress (prog message args infile beg len)
275 "Call program PROG with ARGS args taking input from INFILE.
276Fourth and fifth args, BEG and LEN, specify which part of the output
ee139ed3 277to keep: LEN chars starting BEG chars from the beginning."
acd622cc
RS
278 (let* ((skip (/ beg jka-compr-dd-blocksize))
279 (prefix (- beg (* skip jka-compr-dd-blocksize)))
280 (count (and len (1+ (/ (+ len prefix) jka-compr-dd-blocksize))))
281 (start (point))
acd622cc
RS
282 (err-file (jka-compr-make-temp-name))
283 (run-string (format "%s %s 2> %s | %s bs=%d skip=%d %s 2> /dev/null"
284 prog
285 (mapconcat 'identity args " ")
286 err-file
287 jka-compr-dd-program
288 jka-compr-dd-blocksize
289 skip
dfe05fac
RS
290 ;; dd seems to be unreliable about
291 ;; providing the last block. So, always
292 ;; read one more than you think you need.
293 (if count (concat "count=" (1+ count)) ""))))
acd622cc
RS
294
295 (unwind-protect
296 (or (memq (call-process jka-compr-shell
297 infile t nil "-c"
298 run-string)
299 jka-compr-acceptable-retval-list)
300
301 (jka-compr-error prog args infile message err-file))
302
303 (jka-compr-delete-temp-file err-file))
304
ee139ed3 305 ;; Delete the stuff after what we want, if there is any.
acd622cc 306 (and
dfe05fac 307 len
ee139ed3 308 (< (+ start prefix len) (point))
dfe05fac 309 (delete-region (+ start prefix len) (point)))
acd622cc 310
ee139ed3 311 ;; Delete the stuff before what we want.
acd622cc
RS
312 (delete-region start (+ start prefix))))
313
314
315(defun jka-compr-call-process (prog message infile output temp args)
316 (if jka-compr-use-shell
317
a81635fc 318 (let ((err-file (jka-compr-make-temp-name))
baefb016 319 (coding-system-for-read (or coding-system-for-read 'undecided))
70c7850e 320 (coding-system-for-write 'no-conversion))
a81635fc 321
acd622cc
RS
322 (unwind-protect
323
324 (or (memq
325 (call-process jka-compr-shell infile
326 (if (stringp output) nil output)
327 nil
328 "-c"
329 (format "%s %s 2> %s %s"
330 prog
331 (mapconcat 'identity args " ")
332 err-file
333 (if (stringp output)
334 (concat "> " output)
335 "")))
336 jka-compr-acceptable-retval-list)
337
338 (jka-compr-error prog args infile message err-file))
339
340 (jka-compr-delete-temp-file err-file)))
341
342 (or (zerop
343 (apply 'call-process
344 prog
345 infile
346 (if (stringp output) temp output)
347 nil
348 args))
349 (jka-compr-error prog args infile message))
350
351 (and (stringp output)
75e9c107 352 (with-current-buffer temp
acd622cc 353 (write-region (point-min) (point-max) output)
75e9c107 354 (erase-buffer)))))
acd622cc
RS
355
356
357;;; Support for temp files. Much of this was inspired if not lifted
358;;; from ange-ftp.
359
bbf5eb28 360(defcustom jka-compr-temp-name-template
11757e2f 361 (expand-file-name "jka-com" temporary-file-directory)
362b539a 362 "Prefix added to all temp files created by jka-compr.
bbf5eb28
RS
363There should be no more than seven characters after the final `/'."
364 :type 'string
365 :group 'jka-compr)
acd622cc 366
acd622cc
RS
367(defun jka-compr-make-temp-name (&optional local-copy)
368 "This routine will return the name of a new file."
767d12f2
SM
369 (make-temp-file jka-compr-temp-name-template))
370
371(defalias 'jka-compr-delete-temp-file 'delete-file)
acd622cc
RS
372
373
374(defun jka-compr-write-region (start end file &optional append visit)
acd622cc
RS
375 (let* ((filename (expand-file-name file))
376 (visit-file (if (stringp visit) (expand-file-name visit) filename))
e073a356
RS
377 (info (jka-compr-get-compression-info visit-file))
378 (magic (and info (jka-compr-info-file-magic-bytes info))))
379
380 ;; If we uncompressed this file when visiting it,
381 ;; then recompress it when writing it
382 ;; even if the contents look compressed already.
383 (if (and jka-compr-really-do-compress
384 (eq start 1)
385 (eq end (1+ (buffer-size))))
386 (setq magic nil))
387
388 (if (and info
389 ;; If the contents to be written out
390 ;; are properly compressed already,
391 ;; don't try to compress them over again.
392 (not (and magic
393 (equal (if (stringp start)
394 (substring start 0 (min (length start)
395 (length magic)))
396 (buffer-substring start
397 (min end
398 (+ start (length magic)))))
399 magic))))
400 (let ((can-append (jka-compr-info-can-append info))
401 (compress-program (jka-compr-info-compress-program info))
402 (compress-message (jka-compr-info-compress-message info))
403 (uncompress-program (jka-compr-info-uncompress-program info))
404 (uncompress-message (jka-compr-info-uncompress-message info))
405 (compress-args (jka-compr-info-compress-args info))
406 (uncompress-args (jka-compr-info-uncompress-args info))
407 (base-name (file-name-nondirectory visit-file))
408 temp-file temp-buffer
409 ;; we need to leave `last-coding-system-used' set to its
410 ;; value after calling write-region the first time, so
411 ;; that `basic-save-buffer' sees the right value.
412 (coding-system-used last-coding-system-used))
413
414 (setq temp-buffer (get-buffer-create " *jka-compr-wr-temp*"))
415 (with-current-buffer temp-buffer
416 (widen) (erase-buffer))
417
418 (if (and append
419 (not can-append)
420 (file-exists-p filename))
421
422 (let* ((local-copy (file-local-copy filename))
423 (local-file (or local-copy filename)))
424
425 (setq temp-file local-file))
426
427 (setq temp-file (jka-compr-make-temp-name)))
428
429 (and
430 compress-message
431 (message "%s %s..." compress-message base-name))
432
433 (jka-compr-run-real-handler 'write-region
434 (list start end temp-file t 'dont))
435 ;; save value used by the real write-region
436 (setq coding-system-used last-coding-system-used)
437
438 ;; Here we must read the output of compress program as is
439 ;; without any code conversion.
440 (let ((coding-system-for-read 'no-conversion))
441 (jka-compr-call-process compress-program
442 (concat compress-message
443 " " base-name)
444 temp-file
445 temp-buffer
446 nil
447 compress-args))
448
449 (with-current-buffer temp-buffer
450 (let ((coding-system-for-write 'no-conversion))
451 (if (memq system-type '(ms-dos windows-nt))
452 (setq buffer-file-type t) )
453 (jka-compr-run-real-handler 'write-region
454 (list (point-min) (point-max)
455 filename
456 (and append can-append) 'dont))
457 (erase-buffer)) )
458
459 (jka-compr-delete-temp-file temp-file)
acd622cc 460
e073a356
RS
461 (and
462 compress-message
463 (message "%s %s...done" compress-message base-name))
464
465 (cond
466 ((eq visit t)
467 (setq buffer-file-name filename)
468 (setq jka-compr-really-do-compress t)
469 (set-visited-file-modtime))
470 ((stringp visit)
471 (setq buffer-file-name visit)
472 (let ((buffer-file-name filename))
473 (set-visited-file-modtime))))
474
475 (and (or (eq visit t)
476 (eq visit nil)
477 (stringp visit))
478 (message "Wrote %s" visit-file))
479
480 ;; ensure `last-coding-system-used' has an appropriate value
481 (setq last-coding-system-used coding-system-used)
482
483 nil)
acd622cc 484
e073a356
RS
485 (jka-compr-run-real-handler 'write-region
486 (list start end filename append visit)))))
acd622cc
RS
487
488
54b2aa5c 489(defun jka-compr-insert-file-contents (file &optional visit beg end replace)
acd622cc
RS
490 (barf-if-buffer-read-only)
491
492 (and (or beg end)
493 visit
494 (error "Attempt to visit less than an entire file"))
495
496 (let* ((filename (expand-file-name file))
497 (info (jka-compr-get-compression-info filename)))
498
499 (if info
500
501 (let ((uncompress-message (jka-compr-info-uncompress-message info))
502 (uncompress-program (jka-compr-info-uncompress-program info))
503 (uncompress-args (jka-compr-info-uncompress-args info))
504 (base-name (file-name-nondirectory filename))
505 (notfound nil)
8fb1a583
RS
506 (local-copy
507 (jka-compr-run-real-handler 'file-local-copy (list filename)))
acd622cc 508 local-file
a81635fc 509 size start
4eec33ae
RS
510 (coding-system-for-read
511 (or coding-system-for-read
bab00368
RS
512 ;; If multibyte characters are disabled,
513 ;; don't do that conversion.
514 (and (null enable-multibyte-characters)
c352d959 515 (or (auto-coding-alist-lookup
f8d8f627 516 (jka-compr-byte-compiler-base-file-name file))
c352d959 517 'raw-text))
7ec4806e
RS
518 (let ((coding (find-operation-coding-system
519 'insert-file-contents
520 (jka-compr-byte-compiler-base-file-name file))))
521 (and (consp coding) (car coding)))
4eec33ae 522 'undecided)) )
acd622cc
RS
523
524 (setq local-file (or local-copy filename))
525
526 (and
527 visit
528 (setq buffer-file-name filename))
529
530 (unwind-protect ; to make sure local-copy gets deleted
531
532 (progn
533
534 (and
535 uncompress-message
536 (message "%s %s..." uncompress-message base-name))
537
538 (condition-case error-code
539
540 (progn
094cf604
RS
541 (if replace
542 (goto-char (point-min)))
acd622cc
RS
543 (setq start (point))
544 (if (or beg end)
545 (jka-compr-partial-uncompress uncompress-program
546 (concat uncompress-message
547 " " base-name)
548 uncompress-args
549 local-file
550 (or beg 0)
551 (if (and beg end)
552 (- end beg)
553 end))
ae849784
RS
554 ;; If visiting, bind off buffer-file-name so that
555 ;; file-locking will not ask whether we should
556 ;; really edit the buffer.
557 (let ((buffer-file-name
558 (if visit nil buffer-file-name)))
559 (jka-compr-call-process uncompress-program
560 (concat uncompress-message
561 " " base-name)
562 local-file
563 t
564 nil
565 uncompress-args)))
acd622cc 566 (setq size (- (point) start))
094cf604
RS
567 (if replace
568 (let* ((del-beg (point))
569 (del-end (+ del-beg size)))
570 (delete-region del-beg
571 (min del-end (point-max)))))
572 (goto-char start))
acd622cc
RS
573 (error
574 (if (and (eq (car error-code) 'file-error)
575 (eq (nth 3 error-code) local-file))
576 (if visit
577 (setq notfound error-code)
578 (signal 'file-error
579 (cons "Opening input file"
580 (nthcdr 2 error-code))))
581 (signal (car error-code) (cdr error-code))))))
582
583 (and
584 local-copy
585 (file-exists-p local-copy)
586 (delete-file local-copy)))
587
588 (and
589 visit
590 (progn
8fb1a583 591 (unlock-buffer)
acd622cc 592 (setq buffer-file-name filename)
e073a356 593 (setq jka-compr-really-do-compress t)
acd622cc
RS
594 (set-visited-file-modtime)))
595
596 (and
597 uncompress-message
598 (message "%s %s...done" uncompress-message base-name))
599
600 (and
601 visit
602 notfound
603 (signal 'file-error
604 (cons "Opening input file" (nth 2 notfound))))
605
5c6f2f2a
RS
606 ;; This is done in insert-file-contents after we return.
607 ;; That is a little weird, but better to go along with it now
608 ;; than to change it now.
609
610;;; ;; Run the functions that insert-file-contents would.
611;;; (let ((p after-insert-file-functions)
612;;; (insval size))
613;;; (while p
614;;; (setq insval (funcall (car p) size))
615;;; (if insval
616;;; (progn
617;;; (or (integerp insval)
618;;; (signal 'wrong-type-argument
619;;; (list 'integerp insval)))
620;;; (setq size insval)))
621;;; (setq p (cdr p))))
094cf604 622
acd622cc
RS
623 (list filename size))
624
8fb1a583
RS
625 (jka-compr-run-real-handler 'insert-file-contents
626 (list file visit beg end replace)))))
acd622cc
RS
627
628
629(defun jka-compr-file-local-copy (file)
acd622cc
RS
630 (let* ((filename (expand-file-name file))
631 (info (jka-compr-get-compression-info filename)))
632
633 (if info
634
635 (let ((uncompress-message (jka-compr-info-uncompress-message info))
636 (uncompress-program (jka-compr-info-uncompress-program info))
637 (uncompress-args (jka-compr-info-uncompress-args info))
638 (base-name (file-name-nondirectory filename))
8fb1a583
RS
639 (local-copy
640 (jka-compr-run-real-handler 'file-local-copy (list filename)))
acd622cc 641 (temp-file (jka-compr-make-temp-name t))
30c78e11 642 (temp-buffer (get-buffer-create " *jka-compr-flc-temp*"))
acd622cc 643 (notfound nil)
acd622cc
RS
644 local-file)
645
646 (setq local-file (or local-copy filename))
647
648 (unwind-protect
649
75e9c107 650 (with-current-buffer temp-buffer
acd622cc
RS
651
652 (and
653 uncompress-message
654 (message "%s %s..." uncompress-message base-name))
acd622cc 655
baefb016
KH
656 ;; Here we must read the output of uncompress program
657 ;; and write it to TEMP-FILE without any code
658 ;; conversion. An appropriate code conversion (if
659 ;; necessary) is done by the later I/O operation
660 ;; (e.g. load).
661 (let ((coding-system-for-read 'no-conversion)
662 (coding-system-for-write 'no-conversion))
663
664 (jka-compr-call-process uncompress-program
665 (concat uncompress-message
666 " " base-name)
667 local-file
668 t
669 nil
670 uncompress-args)
671
672 (and
673 uncompress-message
674 (message "%s %s...done" uncompress-message base-name))
675
676 (write-region
677 (point-min) (point-max) temp-file nil 'dont)))
acd622cc
RS
678
679 (and
680 local-copy
681 (file-exists-p local-copy)
682 (delete-file local-copy))
683
acd622cc
RS
684 (kill-buffer temp-buffer))
685
686 temp-file)
687
8fb1a583 688 (jka-compr-run-real-handler 'file-local-copy (list filename)))))
acd622cc
RS
689
690
691;;; Support for loading compressed files.
692(defun jka-compr-load (file &optional noerror nomessage nosuffix)
693 "Documented as original."
694
695 (let* ((local-copy (jka-compr-file-local-copy file))
696 (load-file (or local-copy file)))
697
698 (unwind-protect
699
8fb1a583
RS
700 (let (inhibit-file-name-operation
701 inhibit-file-name-handlers)
acd622cc
RS
702 (or nomessage
703 (message "Loading %s..." file))
704
9b37d8a9
RS
705 (let ((load-force-doc-strings t))
706 (load load-file noerror t t))
acd622cc 707 (or nomessage
e645e77b
DL
708 (message "Loading %s...done." file))
709 ;; Fix up the load history to point at the right library.
710 (let ((l (assoc load-file load-history)))
711 ;; Remove .gz and .elc?.
712 (while (file-name-extension file)
713 (setq file (file-name-sans-extension file)))
714 (setcar l file)))
acd622cc 715
acd622cc
RS
716 (jka-compr-delete-temp-file local-copy))
717
718 t))
3068998d
RS
719
720(defun jka-compr-byte-compiler-base-file-name (file)
721 (let ((info (jka-compr-get-compression-info file)))
722 (if (and info (jka-compr-info-strip-extension info))
723 (save-match-data
724 (substring file 0 (string-match (jka-compr-info-regexp info) file)))
725 file)))
8fb1a583
RS
726\f
727(put 'write-region 'jka-compr 'jka-compr-write-region)
728(put 'insert-file-contents 'jka-compr 'jka-compr-insert-file-contents)
729(put 'file-local-copy 'jka-compr 'jka-compr-file-local-copy)
730(put 'load 'jka-compr 'jka-compr-load)
3068998d
RS
731(put 'byte-compiler-base-file-name 'jka-compr
732 'jka-compr-byte-compiler-base-file-name)
acd622cc 733
9fdf055b
KH
734(defvar jka-compr-inhibit nil
735 "Non-nil means inhibit automatic uncompression temporarily.
736Lisp programs can bind this to t to do that.
737It is not recommended to set this variable permanently to anything but nil.")
738
acd622cc 739(defun jka-compr-handler (operation &rest args)
8fb1a583
RS
740 (save-match-data
741 (let ((jka-op (get operation 'jka-compr)))
9fdf055b 742 (if (and jka-op (not jka-compr-inhibit))
8fb1a583
RS
743 (apply jka-op args)
744 (jka-compr-run-real-handler operation args)))))
acd622cc 745
99bee6a4
RS
746;; If we are given an operation that we don't handle,
747;; call the Emacs primitive for that operation,
748;; and manipulate the inhibit variables
749;; to prevent the primitive from calling our handler again.
750(defun jka-compr-run-real-handler (operation args)
751 (let ((inhibit-file-name-handlers
752 (cons 'jka-compr-handler
753 (and (eq inhibit-file-name-operation operation)
754 inhibit-file-name-handlers)))
755 (inhibit-file-name-operation operation))
756 (apply operation args)))
757
523b128c 758
acd622cc 759(defun jka-compr-build-file-regexp ()
defdd32e
SM
760 (mapconcat
761 'jka-compr-info-regexp
762 jka-compr-compression-info-list
763 "\\|"))
acd622cc
RS
764
765
766(defun jka-compr-install ()
767 "Install jka-compr.
919a07bb
RS
768This adds entries to `file-name-handler-alist' and `auto-mode-alist'
769and `inhibit-first-line-modes-suffixes'."
acd622cc
RS
770
771 (setq jka-compr-file-name-handler-entry
772 (cons (jka-compr-build-file-regexp) 'jka-compr-handler))
773
774 (setq file-name-handler-alist (cons jka-compr-file-name-handler-entry
775 file-name-handler-alist))
776
4eec33ae
RS
777 (setq jka-compr-added-to-file-coding-system-alist nil)
778
acd622cc
RS
779 (mapcar
780 (function (lambda (x)
4eec33ae
RS
781 ;; Don't do multibyte encoding on the compressed files.
782 (let ((elt (cons (jka-compr-info-regexp x)
783 '(no-conversion . no-conversion))))
784 (setq file-coding-system-alist
785 (cons elt file-coding-system-alist))
786 (setq jka-compr-added-to-file-coding-system-alist
787 (cons elt jka-compr-added-to-file-coding-system-alist)))
788
469f4e8c
RS
789 (and (jka-compr-info-strip-extension x)
790 ;; Make entries in auto-mode-alist so that modes
791 ;; are chosen right according to the file names
792 ;; sans `.gz'.
793 (setq auto-mode-alist
794 (cons (list (jka-compr-info-regexp x)
795 nil 'jka-compr)
796 auto-mode-alist))
797 ;; Also add these regexps to
798 ;; inhibit-first-line-modes-suffixes, so that a
799 ;; -*- line in the first file of a compressed tar
800 ;; file doesn't override tar-mode.
801 (setq inhibit-first-line-modes-suffixes
802 (cons (jka-compr-info-regexp x)
803 inhibit-first-line-modes-suffixes)))))
74b2c737
RS
804 jka-compr-compression-info-list)
805 (setq auto-mode-alist
806 (append auto-mode-alist jka-compr-mode-alist-additions)))
acd622cc
RS
807
808
809(defun jka-compr-uninstall ()
810 "Uninstall jka-compr.
99bee6a4 811This removes the entries in `file-name-handler-alist' and `auto-mode-alist'
919a07bb
RS
812and `inhibit-first-line-modes-suffixes' that were added
813by `jka-compr-installed'."
814 ;; Delete from inhibit-first-line-modes-suffixes
815 ;; what jka-compr-install added.
816 (mapcar
817 (function (lambda (x)
818 (and (jka-compr-info-strip-extension x)
819 (setq inhibit-first-line-modes-suffixes
820 (delete (jka-compr-info-regexp x)
821 inhibit-first-line-modes-suffixes)))))
822 jka-compr-compression-info-list)
acd622cc
RS
823
824 (let* ((fnha (cons nil file-name-handler-alist))
825 (last fnha))
826
827 (while (cdr last)
828 (if (eq (cdr (car (cdr last))) 'jka-compr-handler)
829 (setcdr last (cdr (cdr last)))
830 (setq last (cdr last))))
831
832 (setq file-name-handler-alist (cdr fnha)))
833
834 (let* ((ama (cons nil auto-mode-alist))
835 (last ama)
836 entry)
837
838 (while (cdr last)
839 (setq entry (car (cdr last)))
74b2c737
RS
840 (if (or (member entry jka-compr-mode-alist-additions)
841 (and (consp (cdr entry))
842 (eq (nth 2 entry) 'jka-compr)))
acd622cc
RS
843 (setcdr last (cdr (cdr last)))
844 (setq last (cdr last))))
845
4eec33ae
RS
846 (setq auto-mode-alist (cdr ama)))
847
848 (let* ((ama (cons nil file-coding-system-alist))
849 (last ama)
850 entry)
851
852 (while (cdr last)
853 (setq entry (car (cdr last)))
854 (if (member entry jka-compr-added-to-file-coding-system-alist)
855 (setcdr last (cdr (cdr last)))
856 (setq last (cdr last))))
857
858 (setq file-coding-system-alist (cdr ama))))
acd622cc
RS
859
860
861(defun jka-compr-installed-p ()
862 "Return non-nil if jka-compr is installed.
99bee6a4 863The return value is the entry in `file-name-handler-alist' for jka-compr."
acd622cc
RS
864
865 (let ((fnha file-name-handler-alist)
866 (installed nil))
867
868 (while (and fnha (not installed))
869 (and (eq (cdr (car fnha)) 'jka-compr-handler)
870 (setq installed (car fnha)))
871 (setq fnha (cdr fnha)))
872
873 installed))
874
875
7dbc9c8a
MB
876;;; Add the file I/O hook if it does not already exist.
877;;; Make sure that jka-compr-file-name-handler-entry is eq to the
878;;; entry for jka-compr in file-name-handler-alist.
879(and (jka-compr-installed-p)
880 (jka-compr-uninstall))
881
882
883;;; Note this definition must be at the end of the file, because
884;;; `define-minor-mode' actually calls the mode-function if the
885;;; associated variable is non-nil, which requires that all needed
886;;; functions be already defined. [This is arguably a bug in d-m-m]
6fee86a3
MB
887;;;###autoload
888(define-minor-mode auto-compression-mode
889 "Toggle automatic file compression and uncompression.
890With prefix argument ARG, turn auto compression on if positive, else off.
891Returns the new status of auto compression (non-nil means on)."
892 nil nil nil :global t :group 'jka-compr
893 (let* ((installed (jka-compr-installed-p))
894 (flag auto-compression-mode))
895 (cond
896 ((and flag installed) t) ; already installed
897 ((and (not flag) (not installed)) nil) ; already not installed
898 (flag (jka-compr-install))
899 (t (jka-compr-uninstall)))))
900
901
902;;;###autoload
903(defmacro with-auto-compression-mode (&rest body)
7dbc9c8a 904 "Evalute BODY with automatic file compression and uncompression enabled."
6fee86a3
MB
905 (let ((already-installed (make-symbol "already-installed")))
906 `(let ((,already-installed (jka-compr-installed-p)))
907 (unwind-protect
908 (progn
909 (unless ,already-installed
910 (jka-compr-install))
911 ,@body)
912 (unless ,already-installed
913 (jka-compr-uninstall))))))
914(put 'with-auto-compression-mode 'lisp-indent-function 0)
915
916
acd622cc
RS
917(provide 'jka-compr)
918
919;; jka-compr.el ends here.