mirror of
https://github.com/m00natic/vlfi.git
synced 2025-03-13 14:18:05 +00:00
222 lines
7.4 KiB
EmacsLisp
222 lines
7.4 KiB
EmacsLisp
;;; vlf.el --- View Large Files
|
|
;;; -*- lexical-bind: t -*-
|
|
|
|
;; Copyright (C) 2006, 2012, 2013 Free Software Foundation, Inc.
|
|
|
|
;; Version: 0.3
|
|
;; Keywords: large files, utilities
|
|
;; Authors: 2006 Mathias Dahl <mathias.dahl@gmail.com>
|
|
;; 2012 Sam Steingold <sds@gnu.org>
|
|
;; 2013 Andrey Kotlarski <m00naticus@gmail.com>
|
|
|
|
;; 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:
|
|
|
|
;; This package provides the M-x vlf command, which visits part of a
|
|
;; large file in a read-only buffer without visiting the entire file.
|
|
;; The buffer uses VLF mode, which defines the commands M-<next>
|
|
;; (vlf-next-batch) and M-<prior> (vlf-prev-batch) to visit other
|
|
;; parts of the file. The option `vlf-batch-size' specifies the size
|
|
;; of each batch, in bytes.
|
|
|
|
;; This package was inspired by a snippet posted by Kevin Rodgers,
|
|
;; showing how to use `insert-file-contents' to extract part of a
|
|
;; file.
|
|
|
|
;;; Code:
|
|
|
|
(defgroup vlf nil
|
|
"View Large Files in Emacs."
|
|
:prefix "vlf-"
|
|
:group 'files)
|
|
|
|
(defcustom vlf-batch-size 1024
|
|
"Defines how large each batch of file data is (in bytes)."
|
|
:type 'integer
|
|
:group 'vlf)
|
|
|
|
;; Keep track of file position.
|
|
(defvar vlf-start-pos)
|
|
(defvar vlf-end-pos)
|
|
(defvar vlf-file-size)
|
|
|
|
(defvar vlf-mode-map
|
|
(let ((map (make-sparse-keymap)))
|
|
(define-key map [M-next] 'vlf-next-batch)
|
|
(define-key map [M-prior] 'vlf-prev-batch)
|
|
(define-key map (kbd "M-+") 'vlf-change-batch-size)
|
|
(define-key map (kbd "M--")
|
|
(lambda () "Decrease vlf batch size by factor of 2."
|
|
(interactive)
|
|
(vlf-change-batch-size t)))
|
|
map)
|
|
"Keymap for `vlf-mode'.")
|
|
|
|
(define-derived-mode vlf-mode special-mode "VLF"
|
|
"Mode to browse large files in."
|
|
(setq buffer-read-only t)
|
|
(set-buffer-modified-p nil)
|
|
(make-local-variable 'vlf-batch-size)
|
|
(make-local-variable 'vlf-start-pos)
|
|
(make-local-variable 'vlf-file-size))
|
|
|
|
(defun vlf-change-batch-size (decrease)
|
|
"Change the buffer-local value of `vlf-batch-size'.
|
|
Normally, the value is doubled;
|
|
with the prefix argument DECREASE it is halved."
|
|
(interactive "P")
|
|
(or (assq 'vlf-batch-size (buffer-local-variables))
|
|
(error "%s is not local in this buffer" 'vlf-batch-size))
|
|
(setq vlf-batch-size
|
|
(if decrease
|
|
(/ vlf-batch-size 2)
|
|
(* vlf-batch-size 2)))
|
|
(vlf-update-buffer-name))
|
|
|
|
(defun vlf-format-buffer-name ()
|
|
"Return format for vlf buffer name."
|
|
(format "%s(%s)[%d,%d](%d)"
|
|
(file-name-nondirectory buffer-file-name)
|
|
(file-size-human-readable vlf-file-size)
|
|
vlf-start-pos vlf-end-pos vlf-batch-size))
|
|
|
|
(defun vlf-update-buffer-name ()
|
|
"Update the current buffer name."
|
|
(rename-buffer (vlf-format-buffer-name) t))
|
|
|
|
(defun vlf-next-batch (append)
|
|
"Display the next batch of file data.
|
|
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")
|
|
(let ((end (+ vlf-end-pos (* vlf-batch-size
|
|
(abs append)))))
|
|
(when (< vlf-file-size end) ; re-check file size
|
|
(setq vlf-file-size (nth 7 (file-attributes buffer-file-name)))
|
|
(cond ((= vlf-end-pos vlf-file-size)
|
|
(error "Already at EOF"))
|
|
((< vlf-file-size end)
|
|
(setq end vlf-file-size))))
|
|
(let ((inhibit-read-only t)
|
|
(do-append (< append 0)))
|
|
(if do-append
|
|
(goto-char (point-max))
|
|
(setq vlf-start-pos (- end vlf-batch-size))
|
|
(erase-buffer))
|
|
(insert-file-contents buffer-file-name nil
|
|
(if do-append
|
|
vlf-end-pos
|
|
vlf-start-pos)
|
|
end))
|
|
(setq vlf-end-pos end))
|
|
(set-buffer-modified-p nil)
|
|
(vlf-update-buffer-name))
|
|
|
|
(defun vlf-prev-batch (prepend)
|
|
"Display the previous batch of file data.
|
|
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")
|
|
(if (zerop vlf-start-pos)
|
|
(error "Already at BOF"))
|
|
(let ((inhibit-read-only t)
|
|
(start (max 0 (- vlf-start-pos (* vlf-batch-size
|
|
(abs prepend)))))
|
|
(do-prepend (< prepend 0)))
|
|
(if do-prepend
|
|
(goto-char (point-min))
|
|
(setq vlf-end-pos (+ start vlf-batch-size))
|
|
(erase-buffer))
|
|
(insert-file-contents buffer-file-name nil start
|
|
(if do-prepend
|
|
vlf-start-pos
|
|
vlf-end-pos))
|
|
(setq vlf-start-pos start))
|
|
(set-buffer-modified-p nil)
|
|
(vlf-update-buffer-name))
|
|
|
|
;;;###autoload
|
|
(defun vlf (from-end file)
|
|
"View a Large File in Emacs.
|
|
With FROM-END prefix, view from the back.
|
|
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
|
|
display by customizing `vlf-batch-size'."
|
|
(interactive "P\nfFile to open: ")
|
|
(with-current-buffer (generate-new-buffer "*vlf*")
|
|
(setq buffer-file-name file
|
|
vlf-file-size (nth 7 (file-attributes file)))
|
|
(if from-end
|
|
(setq vlf-start-pos (max 0 (- vlf-file-size vlf-batch-size))
|
|
vlf-end-pos vlf-file-size)
|
|
(setq vlf-start-pos 0
|
|
vlf-end-pos (min vlf-batch-size vlf-file-size)))
|
|
(vlf-update-buffer-name)
|
|
(insert-file-contents buffer-file-name nil
|
|
vlf-start-pos vlf-end-pos)
|
|
(vlf-mode)
|
|
(switch-to-buffer (current-buffer))))
|
|
|
|
;;;###autoload
|
|
(defun dired-vlf (from-end)
|
|
"In Dired, visit the file on this line in VLF mode.
|
|
With FROM-END prefix, view from the back."
|
|
(interactive "P")
|
|
(vlf from-end (dired-get-file-for-visit)))
|
|
|
|
;;;###autoload
|
|
(eval-after-load "dired"
|
|
'(define-key dired-mode-map "V" 'dired-vlf))
|
|
|
|
;;;###autoload
|
|
(defun vlf-if-file-too-large (size op-type &optional filename)
|
|
"If file SIZE larger than `large-file-warning-threshold', \
|
|
allow user to view file with `vlf', open it normally or abort.
|
|
OP-TYPE specifies the file operation being performed over FILENAME."
|
|
(and large-file-warning-threshold size
|
|
(> size large-file-warning-threshold)
|
|
(let ((char nil))
|
|
(while (not (memq (setq char
|
|
(read-event
|
|
(propertize
|
|
(format "File %s is large (%s): %s normally (o), %s with vlf (v) or abort (a)"
|
|
(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))
|
|
(vlf nil filename)
|
|
(error ""))
|
|
((memq char '(?a ?A))
|
|
(error "Aborted"))))))
|
|
|
|
;;; hijack `abort-if-file-too-large'
|
|
;;;###autoload
|
|
(fset 'abort-if-file-too-large 'vlf-if-file-too-large)
|
|
|
|
(provide 'vlf)
|
|
|
|
;;; vlf.el ends here
|