2013-02-02 14:12:30 +00:00
|
|
|
;;; vlfi.el --- View Large Files Improved
|
2013-01-13 13:45:55 +00:00
|
|
|
;;; -*- lexical-bind: t -*-
|
2013-01-12 15:05:25 +00:00
|
|
|
|
2013-01-12 16:12:45 +00:00
|
|
|
;; Copyright (C) 2006, 2012, 2013 Free Software Foundation, Inc.
|
2013-01-12 15:05:25 +00:00
|
|
|
|
2013-01-12 15:30:49 +00:00
|
|
|
;; Version: 0.3
|
2013-01-12 15:05:25 +00:00
|
|
|
;; Keywords: large files, utilities
|
|
|
|
;; Authors: 2006 Mathias Dahl <mathias.dahl@gmail.com>
|
|
|
|
;; 2012 Sam Steingold <sds@gnu.org>
|
2013-01-12 15:30:49 +00:00
|
|
|
;; 2013 Andrey Kotlarski <m00naticus@gmail.com>
|
2013-01-12 15:05:25 +00:00
|
|
|
|
|
|
|
;; This file is free software; you can redistribute it and/or modify
|
|
|
|
;; it under the terms of the GNU General Public License as published by
|
|
|
|
;; the Free Software Foundation; either version 2, or (at your option)
|
|
|
|
;; any later version.
|
|
|
|
|
|
|
|
;; This file 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 GNU Emacs; see the file COPYING. If not, write to
|
|
|
|
;; the Free Software Foundation, Inc., 59 Temple Place - Suite 330,
|
|
|
|
;; Boston, MA 02111-1307, USA.
|
|
|
|
|
|
|
|
;;; Commentary:
|
|
|
|
|
2013-02-02 14:12:30 +00:00
|
|
|
;; This package provides the M-x vlfi command, which visits part of a
|
2013-01-12 15:05:25 +00:00
|
|
|
;; large file in a read-only buffer without visiting the entire file.
|
2013-02-02 14:12:30 +00:00
|
|
|
;; The buffer uses VLFI mode, which defines the commands M-<next>
|
|
|
|
;; (vlfi-next-batch) and M-<prior> (vlfi-prev-batch) to visit other
|
|
|
|
;; parts of the file. The option `vlfi-batch-size' specifies the size
|
2013-01-12 15:05:25 +00:00
|
|
|
;; of each batch, in bytes.
|
|
|
|
|
2013-02-02 14:12:30 +00:00
|
|
|
;; This package is an improved fork of the vlf.el package.
|
2013-01-12 15:05:25 +00:00
|
|
|
|
|
|
|
;;; Code:
|
|
|
|
|
2013-02-02 14:12:30 +00:00
|
|
|
(defgroup vlfi nil
|
2013-01-12 15:05:25 +00:00
|
|
|
"View Large Files in Emacs."
|
2013-02-02 14:12:30 +00:00
|
|
|
:prefix "vlfi-"
|
2013-01-12 15:05:25 +00:00
|
|
|
:group 'files)
|
|
|
|
|
2013-02-02 14:12:30 +00:00
|
|
|
(defcustom vlfi-batch-size 1024
|
2013-01-12 15:05:25 +00:00
|
|
|
"Defines how large each batch of file data is (in bytes)."
|
|
|
|
:type 'integer
|
2013-02-02 14:12:30 +00:00
|
|
|
:group 'vlfi)
|
2013-01-12 15:05:25 +00:00
|
|
|
|
|
|
|
;; Keep track of file position.
|
2013-02-02 14:12:30 +00:00
|
|
|
(defvar vlfi-start-pos)
|
|
|
|
(defvar vlfi-end-pos)
|
|
|
|
(defvar vlfi-file-size)
|
2013-01-12 15:05:25 +00:00
|
|
|
|
2013-02-02 14:12:30 +00:00
|
|
|
(defvar vlfi-mode-map
|
2013-01-12 15:05:25 +00:00
|
|
|
(let ((map (make-sparse-keymap)))
|
2013-02-02 14:12:30 +00:00
|
|
|
(define-key map [M-next] 'vlfi-next-batch)
|
|
|
|
(define-key map [M-prior] 'vlfi-prev-batch)
|
|
|
|
(define-key map (kbd "M-+") 'vlfi-change-batch-size)
|
2013-01-12 16:12:45 +00:00
|
|
|
(define-key map (kbd "M--")
|
2013-02-02 14:12:30 +00:00
|
|
|
(lambda () "Decrease vlfi batch size by factor of 2."
|
|
|
|
(interactive)
|
|
|
|
(vlfi-change-batch-size t)))
|
2013-01-12 15:05:25 +00:00
|
|
|
map)
|
2013-02-02 14:12:30 +00:00
|
|
|
"Keymap for `vlfi-mode'.")
|
2013-01-12 15:05:25 +00:00
|
|
|
|
2013-02-02 14:12:30 +00:00
|
|
|
(define-derived-mode vlfi-mode special-mode "VLFI"
|
2013-01-12 15:05:25 +00:00
|
|
|
"Mode to browse large files in."
|
|
|
|
(setq buffer-read-only t)
|
|
|
|
(set-buffer-modified-p nil)
|
2013-02-02 14:12:30 +00:00
|
|
|
(make-local-variable 'vlfi-batch-size)
|
|
|
|
(make-local-variable 'vlfi-start-pos)
|
|
|
|
(make-local-variable 'vlfi-file-size))
|
2013-01-12 15:05:25 +00:00
|
|
|
|
2013-02-02 14:12:30 +00:00
|
|
|
(defun vlfi-change-batch-size (decrease)
|
|
|
|
"Change the buffer-local value of `vlfi-batch-size'.
|
2013-01-12 15:05:25 +00:00
|
|
|
Normally, the value is doubled;
|
2013-01-12 15:30:49 +00:00
|
|
|
with the prefix argument DECREASE it is halved."
|
2013-01-12 15:05:25 +00:00
|
|
|
(interactive "P")
|
2013-02-02 14:12:30 +00:00
|
|
|
(or (assq 'vlfi-batch-size (buffer-local-variables))
|
|
|
|
(error "%s is not local in this buffer" 'vlfi-batch-size))
|
|
|
|
(setq vlfi-batch-size
|
|
|
|
(if decrease
|
|
|
|
(/ vlfi-batch-size 2)
|
|
|
|
(* vlfi-batch-size 2)))
|
|
|
|
(vlfi-update-buffer-name))
|
|
|
|
|
|
|
|
(defun vlfi-format-buffer-name ()
|
|
|
|
"Return format for vlfi buffer name."
|
2013-03-29 13:52:55 +00:00
|
|
|
(let ((vlfi-file-size-float (float vlfi-file-size)))
|
|
|
|
(format "%s(%s)[%.2f-%.2f%%%%](%d)"
|
|
|
|
(file-name-nondirectory buffer-file-name)
|
|
|
|
(file-size-human-readable vlfi-file-size)
|
|
|
|
(* 100 (/ vlfi-start-pos vlfi-file-size-float))
|
|
|
|
(* 100 (/ vlfi-end-pos vlfi-file-size-float))
|
|
|
|
vlfi-batch-size)))
|
2013-01-12 15:05:25 +00:00
|
|
|
|
2013-02-02 14:12:30 +00:00
|
|
|
(defun vlfi-update-buffer-name ()
|
2013-01-12 15:05:25 +00:00
|
|
|
"Update the current buffer name."
|
2013-02-02 14:12:30 +00:00
|
|
|
(rename-buffer (vlfi-format-buffer-name) t))
|
2013-01-12 15:05:25 +00:00
|
|
|
|
2013-02-02 14:12:30 +00:00
|
|
|
(defun vlfi-next-batch (append)
|
2013-01-12 15:05:25 +00:00
|
|
|
"Display the next batch of file data.
|
2013-01-12 15:30:49 +00:00
|
|
|
When prefix argument is supplied and positive
|
|
|
|
jump over APPEND number of batches.
|
|
|
|
When prefix argument is negative
|
|
|
|
append next APPEND number of batches to the existing buffer."
|
|
|
|
(interactive "p")
|
2013-02-02 14:12:30 +00:00
|
|
|
(let ((end (+ vlfi-end-pos (* vlfi-batch-size
|
|
|
|
(abs append)))))
|
|
|
|
(when (< vlfi-file-size end) ; re-check file size
|
|
|
|
(setq vlfi-file-size (nth 7 (file-attributes buffer-file-name)))
|
|
|
|
(cond ((= vlfi-end-pos vlfi-file-size)
|
|
|
|
(error "Already at EOF"))
|
|
|
|
((< vlfi-file-size end)
|
|
|
|
(setq end vlfi-file-size))))
|
2013-01-12 15:30:49 +00:00
|
|
|
(let ((inhibit-read-only t)
|
2013-02-02 14:12:30 +00:00
|
|
|
(do-append (< append 0)))
|
2013-01-12 15:30:49 +00:00
|
|
|
(if do-append
|
2013-02-02 14:12:30 +00:00
|
|
|
(goto-char (point-max))
|
|
|
|
(setq vlfi-start-pos (- end vlfi-batch-size))
|
|
|
|
(erase-buffer))
|
2013-01-12 15:30:49 +00:00
|
|
|
(insert-file-contents buffer-file-name nil
|
2013-02-02 14:12:30 +00:00
|
|
|
(if do-append
|
|
|
|
vlfi-end-pos
|
|
|
|
vlfi-start-pos)
|
|
|
|
end))
|
|
|
|
(setq vlfi-end-pos end))
|
2013-01-12 15:30:49 +00:00
|
|
|
(set-buffer-modified-p nil)
|
2013-02-02 14:12:30 +00:00
|
|
|
(vlfi-update-buffer-name))
|
2013-01-12 15:05:25 +00:00
|
|
|
|
2013-02-02 14:12:30 +00:00
|
|
|
(defun vlfi-prev-batch (prepend)
|
2013-01-12 15:05:25 +00:00
|
|
|
"Display the previous batch of file data.
|
2013-01-12 15:30:49 +00:00
|
|
|
When prefix argument is supplied and positive
|
|
|
|
jump over PREPEND number of batches.
|
|
|
|
When prefix argument is negative
|
|
|
|
append previous PREPEND number of batches to the existing buffer."
|
|
|
|
(interactive "p")
|
2013-02-02 14:12:30 +00:00
|
|
|
(if (zerop vlfi-start-pos)
|
2013-01-12 15:30:49 +00:00
|
|
|
(error "Already at BOF"))
|
2013-01-12 15:05:25 +00:00
|
|
|
(let ((inhibit-read-only t)
|
2013-02-02 14:12:30 +00:00
|
|
|
(start (max 0 (- vlfi-start-pos (* vlfi-batch-size
|
|
|
|
(abs prepend)))))
|
|
|
|
(do-prepend (< prepend 0)))
|
2013-01-12 15:30:49 +00:00
|
|
|
(if do-prepend
|
2013-02-02 14:12:30 +00:00
|
|
|
(goto-char (point-min))
|
|
|
|
(setq vlfi-end-pos (+ start vlfi-batch-size))
|
2013-01-12 15:30:49 +00:00
|
|
|
(erase-buffer))
|
|
|
|
(insert-file-contents buffer-file-name nil start
|
2013-02-02 14:12:30 +00:00
|
|
|
(if do-prepend
|
|
|
|
vlfi-start-pos
|
|
|
|
vlfi-end-pos))
|
|
|
|
(setq vlfi-start-pos start))
|
2013-01-12 15:30:49 +00:00
|
|
|
(set-buffer-modified-p nil)
|
2013-02-02 14:12:30 +00:00
|
|
|
(vlfi-update-buffer-name))
|
2013-01-12 15:30:49 +00:00
|
|
|
|
|
|
|
;;;###autoload
|
2013-02-02 14:12:30 +00:00
|
|
|
(defun vlfi (from-end file)
|
2013-01-12 15:05:25 +00:00
|
|
|
"View a Large File in Emacs.
|
2013-01-12 15:30:49 +00:00
|
|
|
With FROM-END prefix, view from the back.
|
2013-01-12 15:05:25 +00:00
|
|
|
FILE is the file to open.
|
|
|
|
Batches of the file data from FILE will be displayed in a
|
|
|
|
read-only buffer.
|
|
|
|
You can customize the number of bytes to
|
2013-02-02 14:12:30 +00:00
|
|
|
display by customizing `vlfi-batch-size'."
|
2013-01-12 15:30:49 +00:00
|
|
|
(interactive "P\nfFile to open: ")
|
2013-02-02 14:12:30 +00:00
|
|
|
(with-current-buffer (generate-new-buffer "*vlfi*")
|
2013-03-29 13:53:15 +00:00
|
|
|
(buffer-disable-undo)
|
2013-01-12 15:05:25 +00:00
|
|
|
(setq buffer-file-name file
|
2013-02-02 14:12:30 +00:00
|
|
|
vlfi-file-size (nth 7 (file-attributes file)))
|
2013-01-12 15:30:49 +00:00
|
|
|
(if from-end
|
2013-02-02 14:12:30 +00:00
|
|
|
(setq vlfi-start-pos (max 0
|
|
|
|
(- vlfi-file-size vlfi-batch-size))
|
|
|
|
vlfi-end-pos vlfi-file-size)
|
|
|
|
(setq vlfi-start-pos 0
|
|
|
|
vlfi-end-pos (min vlfi-batch-size vlfi-file-size)))
|
|
|
|
(vlfi-update-buffer-name)
|
2013-01-12 15:05:25 +00:00
|
|
|
(insert-file-contents buffer-file-name nil
|
2013-02-02 14:12:30 +00:00
|
|
|
vlfi-start-pos vlfi-end-pos)
|
|
|
|
(vlfi-mode)
|
2013-01-12 16:12:45 +00:00
|
|
|
(switch-to-buffer (current-buffer))))
|
2013-01-12 15:05:25 +00:00
|
|
|
|
2013-01-13 13:29:51 +00:00
|
|
|
;;;###autoload
|
2013-02-02 14:12:30 +00:00
|
|
|
(defun dired-vlfi (from-end)
|
|
|
|
"In Dired, visit the file on this line in VLFI mode.
|
2013-01-12 15:30:49 +00:00
|
|
|
With FROM-END prefix, view from the back."
|
|
|
|
(interactive "P")
|
2013-02-02 14:12:30 +00:00
|
|
|
(vlfi from-end (dired-get-file-for-visit)))
|
2013-01-12 15:14:28 +00:00
|
|
|
|
2013-01-13 13:29:51 +00:00
|
|
|
;;;###autoload
|
2013-01-12 15:30:49 +00:00
|
|
|
(eval-after-load "dired"
|
2013-02-02 14:12:30 +00:00
|
|
|
'(define-key dired-mode-map "V" 'dired-vlfi))
|
2013-01-12 15:14:28 +00:00
|
|
|
|
2013-01-13 13:29:51 +00:00
|
|
|
;;;###autoload
|
2013-02-02 14:12:30 +00:00
|
|
|
(defun vlfi-if-file-too-large (size op-type &optional filename)
|
2013-01-12 16:12:45 +00:00
|
|
|
"If file SIZE larger than `large-file-warning-threshold', \
|
2013-02-02 14:12:30 +00:00
|
|
|
allow user to view file with `vlfi', open it normally or abort.
|
2013-01-13 13:29:51 +00:00
|
|
|
OP-TYPE specifies the file operation being performed over FILENAME."
|
2013-01-13 13:45:55 +00:00
|
|
|
(and large-file-warning-threshold size
|
|
|
|
(> size large-file-warning-threshold)
|
|
|
|
(let ((char nil))
|
|
|
|
(while (not (memq (setq char
|
|
|
|
(read-event
|
|
|
|
(propertize
|
2013-02-02 14:12:30 +00:00
|
|
|
(format "File %s is large (%s): \
|
|
|
|
%s normally (o), %s with vlfi (v) or abort (a)"
|
2013-01-13 13:45:55 +00:00
|
|
|
(file-name-nondirectory filename)
|
|
|
|
(file-size-human-readable size)
|
|
|
|
op-type op-type)
|
|
|
|
'face 'minibuffer-prompt)))
|
|
|
|
'(?o ?O ?v ?V ?a ?A))))
|
|
|
|
(cond ((memq char '(?o ?O)))
|
|
|
|
((memq char '(?v ?V))
|
2013-02-02 14:12:30 +00:00
|
|
|
(vlfi nil filename)
|
2013-01-13 13:45:55 +00:00
|
|
|
(error ""))
|
|
|
|
((memq char '(?a ?A))
|
|
|
|
(error "Aborted"))))))
|
2013-01-12 16:12:45 +00:00
|
|
|
|
2013-01-13 13:24:56 +00:00
|
|
|
;;; hijack `abort-if-file-too-large'
|
2013-01-13 13:29:51 +00:00
|
|
|
;;;###autoload
|
2013-02-02 14:12:30 +00:00
|
|
|
(fset 'abort-if-file-too-large 'vlfi-if-file-too-large)
|
2013-01-12 15:14:28 +00:00
|
|
|
|
2013-02-02 14:12:30 +00:00
|
|
|
(provide 'vlfi)
|
2013-01-12 15:05:25 +00:00
|
|
|
|
2013-02-02 14:12:30 +00:00
|
|
|
;;; vlfi.el ends here
|