X-Git-Url: https://git.distorted.org.uk/~mdw/lisp/blobdiff_plain/0b3651e569cc085b532a495570eacd5af7db3c21..2f94737a4ef20fe9dc36bd3e49a4bf19e246c571:/safely.lisp diff --git a/safely.lisp b/safely.lisp index abb2fb2..60dd683 100644 --- a/safely.lisp +++ b/safely.lisp @@ -45,15 +45,15 @@ (defun fresh-file-name (base tag) "Return a fresh file name constructed from BASE and TAG in the current -directory. Do not assume that this filename will be good by the time you try -to create the file." + directory. Do not assume that this filename will be good by the time you + try to create the file." (let ((name (format nil "~A.~A-~X" base tag (random most-positive-fixnum)))) (if (probe-file name) (fresh-file-name base tag) name))) (defun safely-open-output-stream (safe file &rest open-args) "Create an output stream which will be named FILE when SAFE is committed. -Other OPEN-ARGS are passed to open." + Other OPEN-ARGS are passed to open." (let* ((new (fresh-file-name file "new")) (stream (apply #'open new @@ -73,7 +73,7 @@ Other OPEN-ARGS are passed to open." (defun rename-file-without-moaning (old new) "Rename OLD to NEW, ignoring errors, and without doing any stupid name -mangling." + mangling." (with-errno-handlers () (sys-rename old new) (ENOENT nil))) @@ -101,7 +101,7 @@ mangling." (defun safely-bail (safe) "Abort the operations in SAFE, unwinding all the things that have been -done. Streams are closed, new files are removed." + done. Streams are closed, new files are removed." (dolist (stream (safely-streams safe)) (close stream :abort t)) (safely-unwind (safely-trail safe)) @@ -109,9 +109,9 @@ done. Streams are closed, new files are removed." (defun safely-commit (safe) "Commit SAFE. The files deleted by safely-delete-file are deleted; the -files created by safely-open-output-stream are renamed over the old versions, -if any. If a problem occurs during this stage, everything is rewound and no -changes are made." + files created by safely-open-output-stream are renamed over the old + versions, if any. If a problem occurs during this stage, everything is + rewound and no changes are made." (let ((trail (safely-trail safe)) (revert nil) (cleanup nil)) @@ -147,7 +147,7 @@ changes are made." (defmacro safely ((safe &key) &body body) "Do stuff within the BODY safely. If BODY completes without errors, the -SAFE is committed; otherwise it's bailed." + SAFE is committed; otherwise it's bailed." `(let ((,safe (make-safely))) (unwind-protect (progn @@ -159,7 +159,7 @@ SAFE is committed; otherwise it's bailed." (defmacro safely-writing ((stream file &rest open-args) &body body) "Simple macro for writing a single file safely. STREAM is opened onto a -temporary file, and if BODY completes, it is renamed to FILE." + temporary file, and if BODY completes, it is renamed to FILE." (with-gensyms safe `(safely (,safe) (let ((,stream (apply #'safely-open-output-stream