Files
Sean Whitton 7be92efa5e Rename variable to macroexp-enable-preserve-posification
* lisp/emacs-lisp/macroexp.el
(macroexp-enable-pos-preservation): Rename ...
(macroexp-enable-preserve-posification): ... to this.  All uses
changes.
2026-06-22 10:45:27 +01:00

207 lines
8.2 KiB
EmacsLisp

;;; macroexp-tests.el --- Tests for macroexp.el -*- lexical-binding: t; -*-
;; Copyright (C) 2021-2026 Free Software Foundation, Inc.
;; Author: Stefan Monnier <monnier@iro.umontreal.ca>
;; Keywords:
;; 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:
;;; Code:
(require 'macroexp)
(require 'ert-x)
(ert-deftest macroexp--tests-fgrep ()
(should (equal (macroexp--fgrep '((x) (y)) '([x] z ((u))))
'((x))))
(should (equal (macroexp--fgrep '((x) (y)) '#2=([y] ((y #2#))))
'((y))))
(should (equal (macroexp--fgrep '((x) (y)) '#2=([r] ((a x)) a b c d . #2#))
'((x)))))
(defconst macroexp--tests-filename (macroexp-file-name))
(defmacro macroexp--test-get-file-name () (macroexp-file-name))
(ert-deftest macroexp--tests-file-name ()
(should (string-match
"\\`macroexp-tests.elc?\\'"
(file-name-nondirectory macroexp--tests-filename)))
(let ((rsrc-dir (expand-file-name
"macroexp-resources"
(file-name-directory macroexp--tests-filename))))
(with-current-buffer
(find-file-noselect (expand-file-name "m1.el" rsrc-dir))
(defvar macroexp--m1-tests-filename)
(declare-function macroexp--m1-tests-file-name "m1" ())
;; `macroexp-file-name' should work with `eval-buffer'.
(eval-buffer)
(should (equal "m1.el"
(file-name-nondirectory macroexp--m1-tests-filename)))
(should (equal "m1.el"
(file-name-nondirectory (macroexp--m1-tests-file-name))))
(search-forward "macroexp--m1-tests-filename")
(makunbound 'macroexp--m1-tests-filename)
;; `macroexp-file-name' should also work with `eval-defun'.
(eval-defun nil)
(should (equal "m1.el"
(file-name-nondirectory macroexp--m1-tests-filename))))
;; Test the case where we load a file which byte-compiles another.
(defvar macroexp--m1-tests-comp-filename)
(makunbound 'macroexp--m1-tests-comp-filename)
(load (expand-file-name "m2.el" rsrc-dir) nil t)
(should (equal "m1.el"
(file-name-nondirectory macroexp--m1-tests-comp-filename)))))
(defun macroexp-tests--run-emacs (&rest args)
"Run Emacs in batch mode with ARGS, return output."
(let ((emacs (expand-file-name invocation-name invocation-directory)))
(with-temp-buffer
(let ((res (apply #'call-process emacs nil t nil
"-Q" "--batch" args))
(output (buffer-string)))
(unless (equal res 0)
(message "%s" output)
(error "Inferior Emacs exited with status %S" res))
output))))
(defun macroexp-tests--eval-in-subprocess (file expr)
(let ((output (macroexp-tests--run-emacs
"-l" file (format "--eval=(print %S)" expr))))
(car (read-from-string output))))
(defun macroexp-tests--byte-compile-in-subprocess (file)
"Byte-compile FILE using a subprocess to avoid contaminating the lisp state."
(let ((output (macroexp-tests--run-emacs "-f" "batch-byte-compile" file)))
(when output
(message "%s" output))))
(ert-deftest macroexp--tests-dynamic-variable-p ()
"Test `macroexp--dynamic-variable-p'."
(let* ((vk-el (ert-resource-file "vk.el"))
(vk-elc (concat vk-el "c"))
(expr '(list (vk-f1 0)
(vk-f2 0)
vk-val3
(funcall vk-f4 0)
(funcall vk-f5 0)
(vk-f6)
(vk-f7))))
;; We compile and run the test in separate processes for complete
;; isolation between test cases.
(should (equal (macroexp-tests--eval-in-subprocess vk-el expr)
'((dyn dyn dyn dyn lex lex)
(dyn dyn lex lex)
(dyn dyn dyn dyn lex lex)
(dyn dyn dyn dyn dyn)
(dyn dyn dyn lex lex)
(dyn dyn dyn dyn)
(dyn dyn dyn lex))))
(macroexp-tests--byte-compile-in-subprocess vk-el)
(should (equal (macroexp-tests--eval-in-subprocess vk-elc expr)
'((dyn dyn dyn dyn lex lex)
(dyn dyn lex lex)
(dyn dyn dyn dyn lex lex)
(dyn dyn dyn dyn dyn)
(dyn dyn dyn lex lex)
(dyn dyn dyn dyn)
(dyn dyn dyn lex))))))
(ert-deftest macroexp--dynbound-eval-and-compile ()
(let ((code1 '(progn
(eval-and-compile
(defun my-foo () (bound-and-true-p my-foo))
(defun my-identity (x)
(defvar my-foo)
(let ((my-foo x))
(my-foo))))
(defmacro my-toto (y)
`(list ',y ',(my-identity y)))
(eval-when-compile (my-toto 7))))
(code2 '(progn
(defvar my-foo)
(eval-and-compile
(defun my-foo () (bound-and-true-p my-foo))
(defun my-identity (x)
(let ((my-foo x))
(my-foo))))
(defmacro my-toto (y)
`(list ',y ',(my-identity y)))
(eval-when-compile (my-toto 7))))
(code3 '(progn
(eval-and-compile
(defvar my-foo)
(defun my-foo () (bound-and-true-p my-foo))
(defun my-identity (x)
(let ((my-foo x))
(my-foo))))
(defmacro my-toto (y)
`(list ',y ',(my-identity y)))
(eval-when-compile (my-toto 7)))))
(should (equal (eval code1 t) '(7 7)))
(should (equal (eval code2 t) '(7 7)))
(should (equal (eval code3 t) '(7 7)))
(should (equal (eval (let ((lexical-binding t)) (byte-compile code1)) t)
'(7 7)))
(should (equal (eval (let ((lexical-binding t)) (byte-compile code2)) t)
'(7 7)))
(should (equal (eval (let ((lexical-binding t)) (byte-compile code3)) t)
'(7 7)))
))
(defmacro macroexp--test-macro1 ()
(declare (obsolete "new-replacement" nil))
1)
(defmacro macroexp--test-macro2 ()
'(macroexp--test-macro1))
(ert-deftest macroexp--test-obsolete-macro ()
(should
(let ((res
(cl-letf (((symbol-function 'message) #'user-error))
(condition-case err
(macroexpand-all '(macroexp--test-macro2))
(user-error (error-message-string err))))))
(should (and (stringp res) (string-match "new-replacement" res))))))
(defmacro macroexp--test-with-foo (&rest body)
"Eagerly macro-expand BODY."
(macroexpand-all `(progn . ,body) macroexpand-all-environment))
(ert-deftest macroexp--test-macroexp-enable-preserve-posification ()
(let* ((symbols-with-pos-enabled t)
(form (read-positioning-symbols
"(macroexp--test-with-foo (pop command-history))"))
(pop-pos (symbol-with-pos-pos (caadr form)))
(exp1 (macroexpand-1 form))
(macroexp-enable-preserve-posification nil)
(exp2 (macroexpand-1 form)))
;; Position of `pop' preserved in EXP1. There's no way to tell that
;; the position information in EXP1 is synthetic, which may confuse
;; consumers such as semantic highlighting.
(should (symbol-with-pos-p (caadr exp1)))
(should (= (symbol-with-pos-pos (caadr exp1)) pop-pos))
;; Position preservation was disabled, so EXP2 is clean of synthetic
;; position information.
(should-not (symbol-with-pos-p (caadr exp2)))))
;;; macroexp-tests.el ends here