[nongnu] elpa/edit-indirect 56e3231915 01/28: Initial import.

[ELPA Syncer]

branch: elpa/edit-indirect
commit 56e3231915c9dba4f6a7ed586ad9e5c9741b0c8a
Author: Fanael Linithien <fanael4@gmail.com>
Commit: Fanael Linithien <fanael4@gmail.com>

    Initial import.
---
 edit-indirect.el | 287 +++++++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 287 insertions(+)

diff --git a/edit-indirect.el b/edit-indirect.el
new file mode 100644
index 0000000000..0b15c6d1ff
--- /dev/null
+++ b/edit-indirect.el
@@ -0,0 +1,287 @@
+;;; edit-indirect.el --- Edit regions in separate buffers -*- lexical-binding: 
t -*-
+
+;; Author: Fanael Linithien <fanael4@gmail.com>
+;; URL: https://github.com/Fanael/edit-indirect
+;; Version: 0.1
+;; Package-Requires: ((emacs "24"))
+
+;; This file is NOT part of GNU Emacs.
+
+;; Copyright (c) 2014, Fanael Linithien
+;; All rights reserved.
+;;
+;; Redistribution and use in source and binary forms, with or without
+;; modification, are permitted provided that the following conditions are
+;; met:
+;;
+;;   * Redistributions of source code must retain the above copyright
+;;     notice, this list of conditions and the following disclaimer.
+;;   * Redistributions in binary form must reproduce the above copyright
+;;     notice, this list of conditions and the following disclaimer in the
+;;     documentation and/or other materials provided with the distribution.
+;;
+;; THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS
+;; IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
+;; TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A
+;; PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER
+;; OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
+;; EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
+;; PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR
+;; PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
+;; LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
+;; NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
+;; SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+
+;;; Commentary:
+
+;; Edit regions in separate buffers, like `org-edit-src-code' but for arbitrary
+;; regions.
+;;
+;; See the docstring of `edit-indirect-region' for details.
+
+;;; Code:
+(defgroup edit-indirect nil
+  "Editing regions in separate buffers."
+  :group 'editing)
+
+(defcustom edit-indirect-guess-mode-function #'edit-indirect-default-guess-mode
+  "The function used to guess the major mode of an edit-indirect buffer.
+It's called with the edit-indirect buffer as the current buffer.
+It's called with three arguments, the parent buffer, the beginning
+and the end of the parent buffer region being editing.
+
+Note that the buffer-local value from the parent buffer is used."
+  :type 'function
+  :group 'edit-indirect)
+
+(defcustom edit-indirect-after-creation-hook nil
+  "Functions called after the edit-indirect buffer is created.
+The functions are called with the edit-indirect buffer as the
+current buffer.
+
+Note that the buffer-local value from the parent buffer is used."
+  :type 'hook
+  :group 'edit-indirect)
+
+(defcustom edit-indirect-before-commit-functions nil
+  "Functions called before an edit-indirect buffer is committed.
+The functions are called with the parent buffer as the current
+buffer.
+Each function is called with two arguments, the beginning and the
+end of the region to be changed."
+  :type 'hook
+  :group 'edit-indirect)
+
+(defcustom edit-indirect-after-commit-functions nil
+  "Functions called after an edit-indirect buffer has been committed.
+The functions are called with the parent buffer as the current
+buffer.
+Each function is called with two arguments, the beginning and the
+end of the changed region."
+  :type 'hook
+  :group 'edit-indirect)
+
+(defgroup edit-indirect-faces nil
+  "Faces used in `edit-indirect'."
+  :group 'edit-indirect
+  :group 'faces
+  :prefix "edit-indirect")
+
+(defface edit-indirect-edited-region
+  '((t :inherit secondary-selection))
+  "Face used to highlight an indirectly edited region."
+  :group 'edit-indirect-faces)
+
+(defvar edit-indirect--overlay)
+
+;;;###autoload
+(defun edit-indirect-region (beg end &optional display-buffer)
+  "Edit the region BEG..END in a separate buffer.
+The region is copied, without text properties, to a separate
+buffer, called edit-indirect buffer, and
+`edit-indirect-guess-mode-function' is called to set the major
+mode.
+When done, exit with `edit-indirect-commit', which will remove the
+original region and replace it with the edited version; or with
+`edit-indirect-abort', which will drop the modifications.
+
+Edit-indirect buffers use the `edit-indirect-mode-map' keymap.
+
+If there's already an edit-indirect buffer for BEG..END, use that.
+If there's already an edit-indirect buffer active overlapping any
+portion of BEG..END, an `user-error' is signaled.
+
+When DISPLAY-BUFFER is non-nil or when called interactively,
+display the edit-indirect buffer in some window and select it.
+
+In any case, return the edit-indirect buffer."
+  (interactive
+   (if (or (use-region-p) (not transient-mark-mode))
+       (prog1 (list (region-beginning) (region-end) t)
+         (deactivate-mark))
+     (user-error "No region")))
+  (let ((buffer
+         (let ((old-overlay (edit-indirect--search-for-edit-indirect beg end)))
+           (cond
+            ((null old-overlay)
+             (let ((overlay (edit-indirect--create-overlay beg end)))
+               (edit-indirect--create-indirect-buffer beg end overlay)))
+            ((and (= beg (overlay-start old-overlay))
+                  (= end (overlay-end old-overlay)))
+             (overlay-get old-overlay 'edit-indirect-buffer))
+            (t
+             (user-error "Indirectly edited regions cannot overlap"))))))
+    (when display-buffer
+      (select-window (display-buffer buffer)))
+    buffer))
+
+(defvar edit-indirect-mode-map
+  (let ((map (make-sparse-keymap)))
+    (define-key map (kbd "C-c '") #'edit-indirect-commit)
+    (define-key map (kbd "C-c C-k") #'edit-indirect-abort)
+    map)
+  "Keymap for edit-indirect buffers.")
+
+(defun edit-indirect-commit ()
+  "Commit the modifications done in an edit-indirect buffer.
+That is, replace the original region in the parent buffer with the
+contents of the edit-indirect buffer.
+The edit-indirect buffer is then killed.
+
+Can be called only when the current buffer is an edit-indirect
+buffer."
+  (interactive)
+  (edit-indirect--barf-if-not-indirect)
+  (edit-indirect--commit)
+  (edit-indirect--clean-up))
+
+(defun edit-indirect-abort ()
+  "Abort indirect editing in the current buffer and kill the buffer.
+
+Can be called only when the current buffer is an edit-indirect
+buffer."
+  (interactive)
+  (edit-indirect--barf-if-not-indirect)
+  (edit-indirect--abort))
+
+(defun edit-indirect-buffer-indirect-p (&optional buffer)
+  "Non-nil iff the BUFFER is an edit-indirect buffer.
+BUFFER defaults to the current buffer."
+  (save-current-buffer
+    (when buffer
+      (set-buffer buffer))
+    ;; (not (null)) so we don't leak the overlay to the outside world.
+    (not (null edit-indirect--overlay))))
+
+(defun edit-indirect-default-guess-mode (_parent-buffer _beg _end)
+  "Guess the major mode for an edit-indirect buffer.
+It's done by calling `normal-mode'."
+  (normal-mode))
+
+(defvar edit-indirect--overlay nil
+  "The overlay spanning the region of the parent buffer being edited.
+
+It's also used as the variable determining if we're in an
+edit-indirect buffer at all.")
+(make-variable-buffer-local 'edit-indirect--overlay)
+(put 'edit-indirect--overlay 'permanent-local t)
+
+;; Normally this would use `define-minor-mode', but that makes the mode 
function
+;; interactive, which we don't want, because it's just an implementation 
detail.
+(defun edit-indirect--mode (overlay)
+  "Turn the `edit-indirect--mode' \"minor mode\" on.
+OVERLAY is the value to set `edit-indirect--overlay' to."
+  (setq edit-indirect--overlay overlay)
+  (add-hook 'kill-buffer-hook #'edit-indirect--abort-on-kill-buffer nil t))
+(with-no-warnings
+  (add-minor-mode
+   'edit-indirect--overlay " indirect" edit-indirect-mode-map nil #'ignore))
+
+(defun edit-indirect--create-indirect-buffer (beg end overlay)
+  "Create an edit-indirect buffer and return it.
+
+BEG..END is the parent buffer region to insert.
+OVERLAY is the overlay, see `edit-indirect--overlay'."
+  (let ((buffer (generate-new-buffer (format "*edit-indirect %s*" 
(buffer-name))))
+        (parent-buffer (current-buffer))
+        ;; So we can use the buffer-local values from the parent buffer.
+        (guess-fn edit-indirect-guess-mode-function)
+        (creation-hook edit-indirect-after-creation-hook))
+    (overlay-put overlay 'edit-indirect-buffer buffer)
+    (with-current-buffer buffer
+      (insert-buffer-substring-no-properties parent-buffer beg end)
+      (set-buffer-modified-p nil)
+      (edit-indirect--mode overlay)
+      (funcall guess-fn parent-buffer beg end)
+      (let ((edit-indirect-after-creation-hook creation-hook))
+        (run-hooks 'edit-indirect-after-creation-hook)))
+    buffer))
+
+(defun edit-indirect--create-overlay (beg end)
+  "Create the edit-indirect overlay and return it.
+
+BEG and END specify the region the overlay should encompass."
+  (let ((overlay (make-overlay beg end)))
+    (overlay-put overlay 'face 'edit-indirect-edited-region)
+    (overlay-put overlay 'modification-hooks '(edit-indirect--barf-read-only))
+    overlay))
+
+(defvar edit-indirect--inhibit-read-only nil
+  "Non-nil means disregard read-only status of indirectly-edited region.")
+
+(defun edit-indirect--barf-read-only (_ov _after _beg _end &optional _len)
+  "Signal an `user-error' because the text is read-only.
+The text edited in an edit-indirect buffer shouldn't be changed in
+the parent buffer."
+  (unless (or inhibit-read-only edit-indirect--inhibit-read-only)
+    (user-error "Text is read-only, modify the edit-indirect buffer instead")))
+
+(defun edit-indirect--commit ()
+  "Commit the modifications done in an edit-indirect buffer."
+  (let ((beg (overlay-start edit-indirect--overlay))
+        (end (overlay-end edit-indirect--overlay))
+        (buffer (current-buffer))
+        (edit-indirect--inhibit-read-only t))
+    (with-current-buffer (overlay-buffer edit-indirect--overlay)
+      (save-excursion
+        (run-hook-with-args 'edit-indirect-before-commit-functions beg end)
+        (delete-region beg end)
+        (goto-char beg)
+        (insert-buffer-substring-no-properties buffer 1 (1+ (buffer-size 
buffer)))
+        (run-hook-with-args 'edit-indirect-after-commit-functions beg 
(point))))))
+
+(defun edit-indirect--abort ()
+  "Abort indirect edit."
+  (edit-indirect--clean-up))
+
+(defun edit-indirect--clean-up ()
+  "Clean up an edit-indirect buffer."
+  (delete-overlay edit-indirect--overlay)
+  ;; Kill the overlay reference so that `edit-indirect--abort-on-kill-buffer'
+  ;; won't try to call us again.
+  (setq edit-indirect--overlay nil)
+  (kill-buffer-and-window))
+
+(defun edit-indirect--search-for-edit-indirect (beg end)
+  "Return an existing edit-indirect overlay for some region inside BEG..END.
+If there's no indirectly edited region inside BEG..END, return
+nil."
+  (catch 'done
+    (dolist (overlay (overlays-in beg end))
+      (when (overlay-get overlay 'edit-indirect-buffer)
+        (throw 'done overlay)))
+    nil))
+
+(defun edit-indirect--abort-on-kill-buffer ()
+  "Abort indirect edit.
+Should be called only from `kill-buffer-hook'."
+  (when edit-indirect--overlay
+    (edit-indirect--abort)))
+
+(defun edit-indirect--barf-if-not-indirect ()
+  "Signal an `user-error' if the current buffer is not an edit-indirect 
buffer."
+  (unless edit-indirect--overlay
+    (user-error "This is not an edit-indirect buffer")))
+
+(provide 'edit-indirect)
+;;; edit-indirect.el ends here