backup-each-save.el v1.1

[Benjamin Rutt]

Added:

1) filter function to filter out certain filenames
2) expanation of how to enable it for individual files using
   a 'Local Variables:' stanza.

;;; backup-each-save.el --- backup each savepoint of a file

;; Copyright (C) 2004  Free Software Foundation, Inc.

;; Author: Benjamin Rutt <address@hidden>
;; Version: 1.1

;; 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:

;; Ever wish to go back to an older saved version of a file?  Then
;; this package is for you.  This package copies every file you save
;; in emacs to a backup directory tree (which mirrors the tree
;; structure of the filesystem), with a timestamp suffix to make
;; multiple saves of the same file unique.  Never lose old saved
;; versions again.

;; To activate globally, place this file in your `load-path', and add
;; the following line to your ~/.emacs file:

;; (add-hook 'after-save-hook 'backup-each-save)

;; To activate only for individual files, place entries like the
;; following at the end of your files:

;;; Local Variables: 
;;; eval: (add-hook (make-local-variable 'after-save-hook) 'backup-each-save)
;;; End:

;; To filter out which files it backs up, use a custom function for
;; `backup-each-save-filter-function'.  For example, to filter out
;; the saving of gnus .newsrc.eld files, do:

;; (defun backup-each-save-no-newsrc-eld (filename)
;;   (cond
;;    ((string= (file-name-nondirectory filename) ".newsrc.eld") nil)
;;    (t t)))
;; (setq backup-each-save-filter-function 'backup-each-save-no-newsrc-eld)

;;; Notes:
;; Tested on GNU Emacs 21.3.X and XEmacs (unknown version).
;; Features/bug reports/enhancements welcome. -- Benjamin Rutt

(defvar backup-each-save-mirror-location "~/.backups")

(defvar backup-each-save-remote-files nil
  "Whether to backup remote files at each save.

Defaults to nil.")

(defvar backup-each-save-time-format "%Y_%m_%d_%H_%M_%S"
  "Format given to `format-time-string' which is appended to the filename.")

(defvar backup-each-save-filter-function 'identity
  "Function which should return non-nil if the file should be backed up.")

(defun backup-each-save ()
  (let ((bfn (buffer-file-name)))
    (when (and (or backup-each-save-remote-files
                   (not (file-remote-p bfn)))
               (funcall backup-each-save-filter-function bfn))
      (copy-file bfn (backup-each-save-compute-location bfn) t))))

(defun backup-each-save-compute-location (filename)
  (let* ((containing-dir (file-name-directory filename))
         (basename (file-name-nondirectory filename))
         (backup-container
          (format "%s/%s"
                  backup-each-save-mirror-location
                  containing-dir)))
    (when (not (file-exists-p backup-container))
      (make-directory backup-container t))
    (format "%s/%s-%s" backup-container basename
            (format-time-string backup-each-save-time-format))))

(provide 'backup-each-save)