265 lines
10 KiB
EmacsLisp
265 lines
10 KiB
EmacsLisp
;;; tildify-tests.el --- ERT tests for tildify.el -*- lexical-binding: t -*-
|
||
|
||
;; Copyright (C) 2014-2024 Free Software Foundation, Inc.
|
||
|
||
;; Author: Michal Nazarewicz <mina86@mina86.com>
|
||
;; Version: 4.5
|
||
;; Keywords: text, TeX, SGML
|
||
|
||
;; 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:
|
||
|
||
;; This package defines regression tests for the tildify package.
|
||
|
||
;;; Code:
|
||
|
||
(require 'ert)
|
||
(require 'tildify)
|
||
|
||
(defun tildify-test--example-sentence (space)
|
||
"Return an example sentence with SPACE where hard space is required."
|
||
(concat "Lorem ipsum v" space "dolor sit amet, a" space
|
||
"consectetur adipiscing elit."))
|
||
|
||
|
||
(defun tildify-test--example-html (sentence &optional with-nbsp is-xml)
|
||
"Return an example HTML code.
|
||
SENTENCE is placed where spaces should not be replaced with hard spaces, and
|
||
WITH-NBSP is placed where spaces should be replaced with hard spaces. If the
|
||
latter is missing, SENTENCE will be used in all placeholder positions.
|
||
If IS-XML is non-nil, <pre> tag is not treated specially."
|
||
(let ((with-nbsp (or with-nbsp sentence)))
|
||
(concat "<p>" with-nbsp "</p>\n"
|
||
"<pre>" (if is-xml with-nbsp sentence) "</pre>\n"
|
||
"<! -- " sentence " -- >\n"
|
||
"<p>" with-nbsp "</p>\n"
|
||
"<" sentence ">\n")))
|
||
|
||
|
||
(defun tildify-test--test (modes input expected)
|
||
"Test tildify running in MODES.
|
||
INPUT is the initial content of the buffer and EXPECTED is expected result
|
||
after `tildify-buffer' is run."
|
||
(with-temp-buffer
|
||
(setq-local buffer-file-coding-system 'utf-8)
|
||
(dolist (mode modes)
|
||
(erase-buffer)
|
||
(funcall mode)
|
||
(let ((header (concat "Testing `tildify-buffer' in "
|
||
(symbol-name mode) "\n")))
|
||
(insert header input)
|
||
(tildify-buffer t)
|
||
(should (string-equal (concat header expected) (buffer-string))))
|
||
(erase-buffer)
|
||
(let ((header (concat "Testing `tildify-region' in "
|
||
(symbol-name mode) "\n")))
|
||
(insert header input)
|
||
(tildify-region (point-min) (point-max) t)
|
||
(should (string-equal (concat header expected) (buffer-string)))))))
|
||
|
||
(ert-deftest tildify-test-html ()
|
||
"Tests tildification in an HTML document"
|
||
(let* ((sentence (tildify-test--example-sentence " "))
|
||
(with-nbsp (tildify-test--example-sentence " ")))
|
||
(tildify-test--test '(html-mode sgml-mode)
|
||
(tildify-test--example-html sentence sentence)
|
||
(tildify-test--example-html sentence with-nbsp))))
|
||
|
||
(ert-deftest tildify-test-xml ()
|
||
"Tests tildification in an XML document"
|
||
(let* ((sentence (tildify-test--example-sentence " "))
|
||
(with-nbsp (tildify-test--example-sentence " ")))
|
||
(tildify-test--test '(nxml-mode)
|
||
(tildify-test--example-html sentence sentence t)
|
||
(tildify-test--example-html sentence with-nbsp t))))
|
||
|
||
|
||
(defun tildify-test--example-tex (sentence &optional with-nbsp)
|
||
"Return an example (La)Tex code.
|
||
SENTENCE is placed where spaces should not be replaced with hard spaces, and
|
||
WITH-NBSP is placed where spaces should be replaced with hard spaces. If the
|
||
latter is missing, SENTENCE will be used in all placeholder positions."
|
||
(let ((with-nbsp (or with-nbsp sentence)))
|
||
(concat with-nbsp "\n"
|
||
"\\begin{verbatim}\n" sentence "\n\\end{verbatim}\n"
|
||
"\\verb#" sentence "#\n"
|
||
"$$" sentence "$$\n"
|
||
"$" sentence "$\n"
|
||
"\\[" sentence "\\]\n"
|
||
"\\v A % " sentence "\n"
|
||
with-nbsp "\n")))
|
||
|
||
(ert-deftest tildify-test-tex ()
|
||
"Tests tildification in a (La)TeX document"
|
||
(let* ((sentence (tildify-test--example-sentence " "))
|
||
(with-nbsp (tildify-test--example-sentence "~")))
|
||
(tildify-test--test '(tex-mode latex-mode plain-tex-mode)
|
||
(tildify-test--example-tex sentence sentence)
|
||
(tildify-test--example-tex sentence with-nbsp))))
|
||
|
||
|
||
(ert-deftest tildify-test-find-env-end-re-bug ()
|
||
"Tests generation of end-regex using mix of indexes and strings"
|
||
(with-temp-buffer
|
||
(insert "foo whatever end-foo")
|
||
(goto-char (point-min))
|
||
(should (string-equal "end-foo"
|
||
(tildify--find-env "foo\\|bar"
|
||
'(("foo\\|bar" . ("end-" 0))))))))
|
||
|
||
|
||
(ert-deftest tildify-test-find-env-group-index-bug ()
|
||
"Tests generation of match-string indexes"
|
||
(with-temp-buffer
|
||
(let ((pairs '(("start-\\(foo\\|bar\\)" . ("end-" 1))
|
||
("open-\\(foo\\|bar\\)" . ("close-" 1))))
|
||
(beg-re "start-\\(foo\\|bar\\)\\|open-\\(foo\\|bar\\)"))
|
||
(insert "open-foo whatever close-foo")
|
||
(goto-char (point-min))
|
||
(should (string-equal "close-foo" (tildify--find-env beg-re pairs))))))
|
||
|
||
|
||
(defmacro with-test-foreach (expected &rest body)
|
||
"Helper macro for testing foreach functions.
|
||
BODY has access to pairs variable and called lambda."
|
||
(declare (indent 1))
|
||
(let ((got (make-symbol "got")))
|
||
`(with-temp-buffer
|
||
(insert "1 /- 2 -/ 3 V~ 4 ~ 5 /- 6 -/ 7")
|
||
(let* ((pairs '(("/-" . "-/") ("V\\(.\\)" . (1))))
|
||
(,got "")
|
||
(called (lambda (s e)
|
||
(setq ,got (concat ,got (buffer-substring s e))))))
|
||
(setq-local tildify-foreach-region-function
|
||
(apply-partially 'tildify-foreach-ignore-environments
|
||
pairs))
|
||
,@body
|
||
(should (string-equal ,expected ,got))))))
|
||
|
||
(ert-deftest tildify-test-foreach-ignore-environments ()
|
||
"Basic test of `tildify-foreach-ignore-environments'"
|
||
(with-test-foreach "1 3 5 7"
|
||
(tildify-foreach-ignore-environments pairs called (point-min) (point-max))))
|
||
|
||
|
||
(ert-deftest tildify-test-foreach-ignore-environments-early-return ()
|
||
"Test whether `tildify-foreach-ignore-environments' returns early
|
||
The function must terminate as soon as callback returns nil."
|
||
(with-test-foreach "1 "
|
||
(tildify-foreach-ignore-environments
|
||
pairs (lambda (start end) (funcall called start end) nil)
|
||
(point-min) (point-max))))
|
||
|
||
(ert-deftest tildify-test-foreach-region ()
|
||
"Basic test of `tildify--foreach-region'"
|
||
(with-test-foreach "1 3 5 7"
|
||
(tildify--foreach-region called (point-min) (point-max))))
|
||
|
||
(ert-deftest tildify-test-foreach-region-early-return ()
|
||
"Test whether `tildify--foreach-ignore' returns early
|
||
The function must terminate as soon as callback returns nil."
|
||
(with-test-foreach "1 "
|
||
(tildify--foreach-region (lambda (start end) (funcall called start end) nil)
|
||
(point-min) (point-max))))
|
||
|
||
(ert-deftest tildify-test-foreach-region-limit-region ()
|
||
"Test whether `tildify--foreach-ignore' limits callback to given region"
|
||
(with-test-foreach "3 "
|
||
(tildify--foreach-region called
|
||
(+ (point-min) 10) (+ (point-min) 16))) ; start at "3" end past "4"
|
||
(with-test-foreach "3 5"
|
||
(tildify--foreach-region called
|
||
(+ (point-min) 10) (+ (point-min) 20)))) ; start at "3" end past "5"
|
||
|
||
|
||
(defun tildify-space-test--test (modes nbsp env-open &optional set-space-string)
|
||
(with-temp-buffer
|
||
(setq-local buffer-file-coding-system 'utf-8)
|
||
(dolist (mode modes)
|
||
(funcall mode)
|
||
(when set-space-string
|
||
(setq-local tildify-space-string nbsp))
|
||
(let ((header (concat "Testing `tildify-space' in "
|
||
(symbol-name mode) "\n")))
|
||
;; Replace space with hard space.
|
||
(erase-buffer)
|
||
(insert header "Lorem v ")
|
||
(should (tildify-space))
|
||
(should (string-equal (concat header "Lorem v" nbsp) (buffer-string)))
|
||
;; Inside and ignore environment, replacing does not happen.
|
||
(erase-buffer)
|
||
(insert header env-open "Lorem v ")
|
||
(should (not (tildify-space)))
|
||
(should (string-equal (concat header env-open "Lorem v ")
|
||
(buffer-string)))))))
|
||
|
||
(ert-deftest tildify-space-test-html ()
|
||
"Tests auto-tildification in an HTML document"
|
||
(tildify-space-test--test '(html-mode sgml-mode) " " "<pre>"))
|
||
|
||
(ert-deftest tildify-space-test-html-nbsp ()
|
||
"Tests auto-tildification in an HTML document"
|
||
(tildify-space-test--test '(html-mode sgml-mode) " " "<pre>" t))
|
||
|
||
(ert-deftest tildify-space-test-xml ()
|
||
"Tests auto-tildification in an XML document"
|
||
(tildify-space-test--test '(nxml-mode) " " "<! -- "))
|
||
|
||
(ert-deftest tildify-space-test-tex ()
|
||
"Tests tildification in a TeX document"
|
||
(tildify-space-test--test '(tex-mode latex-mode plain-tex-mode)
|
||
"~" "\\verb# "))
|
||
|
||
|
||
(defun tildify-space-undo-test--test
|
||
(modes nbsp _env-open &optional set-space-string)
|
||
(with-temp-buffer
|
||
(setq-local buffer-file-coding-system 'utf-8)
|
||
(dolist (mode modes)
|
||
(funcall mode)
|
||
(when set-space-string
|
||
(setq-local tildify-space-string nbsp))
|
||
(let ((header (concat "Testing double-space-undos in "
|
||
(symbol-name mode) "\n")))
|
||
(erase-buffer)
|
||
(insert header "Lorem v" nbsp " ")
|
||
(should (not (tildify-space)))
|
||
(should (string-equal (concat header "Lorem v ") (buffer-string)))))))
|
||
|
||
(ert-deftest tildify-space-undo-test-html ()
|
||
"Tests auto-tildification in an HTML document"
|
||
(tildify-space-undo-test--test '(html-mode sgml-mode) " " "<pre>"))
|
||
|
||
(ert-deftest tildify-space-undo-test-html-nbsp ()
|
||
"Tests auto-tildification in an HTML document"
|
||
(tildify-space-undo-test--test '(html-mode sgml-mode) " " "<pre>" t))
|
||
|
||
(ert-deftest tildify-space-undo-test-xml ()
|
||
"Tests auto-tildification in an XML document"
|
||
(tildify-space-undo-test--test '(nxml-mode) " " "<! -- "))
|
||
|
||
(ert-deftest tildify-space-undo-test-tex ()
|
||
"Tests tildification in a TeX document"
|
||
(tildify-space-undo-test--test '(tex-mode latex-mode plain-tex-mode)
|
||
"~" "\\verb# "))
|
||
|
||
|
||
|
||
(provide 'tildify-tests)
|
||
|
||
;;; tildify-tests.el ends here
|