summaryrefslogtreecommitdiffhomepage
path: root/lib/doc/jao-doc-session.el
diff options
context:
space:
mode:
Diffstat (limited to 'lib/doc/jao-doc-session.el')
-rw-r--r--lib/doc/jao-doc-session.el59
1 files changed, 59 insertions, 0 deletions
diff --git a/lib/doc/jao-doc-session.el b/lib/doc/jao-doc-session.el
new file mode 100644
index 0000000..877a8cb
--- /dev/null
+++ b/lib/doc/jao-doc-session.el
@@ -0,0 +1,59 @@
+;;; jao-doc-session.el --- persistent document sessions -*- lexical-binding: t; -*-
+
+;; Copyright (C) 2022, 2024 jao
+
+;; Author: jao <mail@jao.io>
+;; Keywords: docs
+
+;; This program 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 3 of the License, or
+;; (at your option) any later version.
+
+;; This program 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 this program. If not, see <https://www.gnu.org/licenses/>.
+
+;;; Code:
+
+(persist-defvar jao-doc-session nil "Documents session")
+
+(defvar-local jao-doc-session--is-doc nil)
+
+(defun jao-doc-session-is-doc (&optional buffer)
+ "Check whether the given or current buffer belong to the doc session."
+ (buffer-local-value 'jao-doc-session--is-doc (or buffer (current-buffer))))
+
+(defun jao-doc-session (&optional file) jao-doc-session)
+
+(defun jao-doc-session-save (&optional skip-current force)
+ "Traverse all current buffers and update the value of `jao-doc-session'."
+ (interactive)
+ (let ((docs '())
+ (cb (and skip-current (current-buffer))))
+ (dolist (b (buffer-list))
+ (when-let (fs (and (not (eq cb b)) (jao-doc-session-is-doc b)))
+ (dolist (f fs) (add-to-list 'docs f))))
+ (when (or force (> (length docs) 0))
+ (setq jao-doc-session docs))))
+
+(defun jao-doc-session-mark (&optional path)
+ "Mark the current buffer's file, or PATH, as persistent across sessions."
+ (unless (listp jao-doc-session--is-doc)
+ (setq jao-doc-session--is-doc (ensure-list jao-doc-session--is-doc)))
+ (cl-pushnew (or path (buffer-file-name)) jao-doc-session--is-doc)
+ (jao-doc-session-save))
+
+(defun jao-doc-session--maybe-save ()
+ (when (jao-doc-session-is-doc) (jao-doc-session-save t)))
+
+(defvar jao-doc-session-inhibit-save nil)
+
+(add-hook 'kill-buffer-hook #'jao-doc-session--maybe-save)
+
+(provide 'jao-doc-session)
+;;; jao-doc-session.el ends here