1
Fork 0
mirror of git://git.sv.gnu.org/emacs.git synced 2025-12-09 07:40:39 -08:00
emacs/test/lisp/eshell/eshell-tests-unload.el
Jim Porter 8051be9ac2 Allow unloading Eshell
* lisp/eshell/em-extpipe.el (eshell-extpipe):
* lisp/eshell/esh-opt.el (eshell-opt): New groups.  Eshell uses these
to identify modules to unload.

* lisp/eshell/em-hist.el (eshell-hist-unload-hook):
* lisp/eshell/em-ls.el (eshell-ls-unload-hook):
* lisp/eshell/em-smart.el (eshell-smart-unload-hook):
* lisp/eshell/eshell.el (eshell-unload-hook): Make obsolete and move
to...

* lisp/eshell/em-smart.el (em-smart-unload-function):
* lisp/eshell/em-hist.el (em-hist-unload-function):
* lisp/eshell/em-ls.el (em-ls-unload-function):
* lisp/eshell/eshell.el (eshell-unload-function): ... these.

* lisp/eshell/esh-mode.el (eshell-mode-unload-hook):
* lisp/eshell/esh-module.el (eshell-module-unload-hook): Make
obsolete.

* lisp/eshell/em-ls (eshell-ls-enable-in-dired,
eshell-ls-disable-in-dired): New functions...
(eshell-ls-use-in-dired): ... use them.

* lisp/eshell/esh-module.el (eshell-module--feature-name,
eshell-unload-modules): New functions.
(eshell-unload-extension-modules): Use 'eshell-unload-modules'.

* lisp/eshell/eshell.el (eshell-unload-all-modules): Remove.

* test/lisp/eshell/eshell-tests-unload.el: New file.

* doc/misc/eshell.texi (Bugs and ideas): Remove item about unloading
Eshell not working.

* etc/NEWS: Announce this change (bug#61501).
2023-02-15 17:31:52 -08:00

99 lines
3.5 KiB
EmacsLisp

;;; eshell-tests-unload.el --- test unloading Eshell -*- lexical-binding:t -*-
;; Copyright (C) 2023 Free Software Foundation, Inc.
;; This file is part of GNU Emacs.
;; GNU Emacs 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.
;; GNU Emacs 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. If not, see <https://www.gnu.org/licenses/>.
;;; Commentary:
;; Tests for unloading Eshell.
;;; Code:
(require 'ert)
(require 'ert-x)
;; In order to test unloading Eshell, don't require any of its files
;; at the top level. This means we need to explicitly declare some of
;; the variables and functions we'll use.
(defvar eshell-directory-name)
(defvar eshell-history-file-name)
(defvar eshell-last-dir-ring-file-name)
(defvar eshell-modules-list)
(declare-function eshell-module--feature-name "esh-module"
(module &optional kind))
(declare-function eshell-subgroups "esh-util" (groupsym))
(defvar max-unload-time 5
"The maximum amount of time to wait to unload Eshell modules, in seconds.
See `unload-eshell'.")
(defun load-eshell ()
"Load Eshell by calling the `eshell' function and immediately closing it."
(save-current-buffer
(ert-with-temp-directory eshell-directory-name
(let* (;; We want no history file, so prevent Eshell from falling
;; back on $HISTFILE.
(process-environment (cons "HISTFILE" process-environment))
(eshell-history-file-name nil)
(eshell-last-dir-ring-file-name nil)
(eshell-buffer (eshell t)))
(let (kill-buffer-query-functions)
(kill-buffer eshell-buffer))))))
(defun unload-eshell ()
"Unload Eshell, waiting until the core modules are unloaded as well."
(let ((debug-on-error t)
(inhibit-message t))
(unload-feature 'eshell)
;; We unload core modules are unloaded from a timer, since they
;; need to wait until after `eshell' itself is unloaded. Wait for
;; this to finish.
(let ((start (current-time)))
(while (featurep 'esh-arg)
(when (> (float-time (time-since start))
max-unload-time)
(error "timed out waiting to unload Eshell modules"))
(sit-for 0.1)))))
;;; Tests:
(ert-deftest eshell-test-unload/default ()
"Test unloading Eshell with the default list of extension modules."
(load-eshell)
(unload-eshell))
(ert-deftest eshell-test-unload/no-modules ()
"Test unloading Eshell with no extension modules."
(require 'esh-module)
(let (eshell-modules-list)
(load-eshell))
(dolist (module (eshell-subgroups 'eshell-module))
(should-not (featurep (intern (eshell-module--feature-name module)))))
(unload-eshell))
(ert-deftest eshell-test-unload/all-modules ()
"Test unloading Eshell with every extension module."
(require 'esh-module)
(let ((eshell-modules-list (eshell-subgroups 'eshell-module)))
(load-eshell))
(dolist (module (eshell-subgroups 'eshell-module))
(should (featurep (intern (eshell-module--feature-name module)))))
(unload-eshell))
(provide 'eshell-tests-unload)
;;; eshell-tests-unload.el ends here