;;; yasnippet-tests.el --- some yasnippet tests ;; Copyright (C) 2012 João Távora ;; Author: João Távora ;; Keywords: emulations, convenience ;; 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 . ;;; Commentary: ;; Test basic snippet mechanics and the loading system ;;; Code: (require 'yasnippet) (require 'ert) (require 'ert-x) ;;; Snippet mechanics (defun yas--buffer-contents () (buffer-substring-no-properties (point-min) (point-max))) (ert-deftest field-navigation () (with-temp-buffer (yas-minor-mode 1) (yas-expand-snippet "${1:brother} from another ${2:mother}") (should (string= (yas--buffer-contents) "brother from another mother")) (should (looking-at "brother")) (ert-simulate-command '(yas-next-field-or-maybe-expand)) (should (looking-at "mother")) (ert-simulate-command '(yas-prev-field)) (should (looking-at "brother")))) (ert-deftest simple-mirror () (with-temp-buffer (yas-minor-mode 1) (yas-expand-snippet "${1:brother} from another $1") (should (string= (yas--buffer-contents) "brother from another brother")) (ert-simulate-command `(yas-mock-insert "bla")) (should (string= (yas--buffer-contents) "bla from another bla")))) (ert-deftest mirror-with-transformation () (with-temp-buffer (yas-minor-mode 1) (yas-expand-snippet "${1:brother} from another ${1:$(upcase yas-text)}") (should (string= (yas--buffer-contents) "brother from another BROTHER")) (ert-simulate-command `(yas-mock-insert "bla")) (should (string= (yas--buffer-contents) "bla from another BLA")))) (ert-deftest primary-field-transformation () (with-temp-buffer (yas-minor-mode 1) (let ((snippet "${1:$$(upcase yas/text)}${1:$(concat \"bar\" yas/text)}")) (yas-expand-snippet snippet) (should (string= (yas--buffer-contents) "bar")) (ert-simulate-command `(yas-mock-insert "foo")) (should (string= (yas--buffer-contents) "FOObarFOO"))))) (ert-deftest nested-placeholders-kill-superfield () (with-temp-buffer (yas-minor-mode 1) (yas-expand-snippet "brother from ${2:another ${3:mother}}!") (should (string= (yas--buffer-contents) "brother from another mother!")) (ert-simulate-command `(yas-mock-insert "bla")) (should (string= (yas--buffer-contents) "brother from bla!")))) (ert-deftest nested-placeholders-use-subfield () (with-temp-buffer (yas-minor-mode 1) (yas-expand-snippet "brother from ${2:another ${3:mother}}!") (ert-simulate-command '(yas-next-field-or-maybe-expand)) (ert-simulate-command `(yas-mock-insert "bla")) (should (string= (yas--buffer-contents) "brother from another bla!")))) (ert-deftest mirrors-adjacent-to-fields-with-nested-mirrors () (with-temp-buffer (yas-minor-mode 1) (yas-expand-snippet "<%= f.submit \"${1:Submit}\"${2:$(and (yas-text) \", :disable_with => '\")}${2:$1ing...}${2:$(and (yas-text) \"'\")} %>") (should (string= (yas--buffer-contents) "<%= f.submit \"Submit\", :disable_with => 'Submiting...' %>")) (ert-simulate-command `(yas-mock-insert "Send")) (should (string= (yas--buffer-contents) "<%= f.submit \"Send\", :disable_with => 'Sending...' %>")))) (ert-deftest deep-nested-mirroring-issue-351 () (with-temp-buffer (yas-minor-mode 1) (yas-expand-snippet "${1:FOOOOOOO}${2:$1}${3:$2}${4:$3}") (ert-simulate-command `(yas-mock-insert "abc")) (should (string= (yas--buffer-contents) "abcabcabcabc")))) ;; (ert-deftest in-snippet-undo () ;; (with-temp-buffer ;; (yas-minor-mode 1) ;; (yas-expand-snippet "brother from ${2:another ${3:mother}}!") ;; (ert-simulate-command '(yas-next-field-or-maybe-expand)) ;; (ert-simulate-command `(yas-mock-insert "bla")) ;; (ert-simulate-command '(undo)) ;; (should (string= (yas--buffer-contents) ;; "brother from another mother!")))) ;;; Snippet expansion and character escaping ;;; Thanks to @zw963 (Billy) for the testing ;;; (ert-deftest escape-dollar () (with-temp-buffer (yas-minor-mode 1) (yas-expand-snippet "bla\\${1:bla}ble") (should (string= (yas--buffer-contents) "bla${1:bla}ble")))) (ert-deftest escape-closing-brace () (with-temp-buffer (yas-minor-mode 1) (yas-expand-snippet "bla${1:bla\\}}ble") (should (string= (yas--buffer-contents) "blabla}ble")) (should (string= (yas-field-value 1) "bla}")))) (ert-deftest escape-backslashes () (with-temp-buffer (yas-minor-mode 1) (yas-expand-snippet "bla\\ble") (should (string= (yas--buffer-contents) "bla\\ble")))) (ert-deftest escape-backquotes () (with-temp-buffer (yas-minor-mode 1) (yas-expand-snippet "bla`(upcase \"foo\\`bar\")`ble") (should (string= (yas--buffer-contents) "blaFOO`BARble")))) (ert-deftest escape-some-elisp-with-strings () "elisp with strings and unbalance parens inside it" (with-temp-buffer (yas-minor-mode 1) ;; The rules here is: to output a literal `"' you need to escape ;; it with one backslash. You don't need to escape them in ;; embedded elisp. (yas-expand-snippet "soon \\\"`(concat (upcase \"(my arms\")\"\\\" were all around her\")`") (should (string= (yas--buffer-contents) "soon \"(MY ARMS\" were all around her")))) (ert-deftest escape-some-elisp-with-backslashes () (with-temp-buffer (yas-minor-mode 1) ;; And the rule here is: to output a literal `\' inside a string ;; inside embedded elisp you need a total of six `\' (yas-expand-snippet "bla`(upcase \"hey\\\\\\yo\")`ble") (should (string= (yas--buffer-contents) "blaHEY\\YOble")))) (ert-deftest be-careful-when-escaping-in-yas-selected-text () (with-temp-buffer (yas-minor-mode 1) (let ((yas/selected-text "He\\\\o world!")) (yas-expand-snippet "Look ma! `(yas/selected-text)`") (should (string= (yas--buffer-contents) "Look ma! He\\\\o world!"))) (yas-exit-all-snippets) (erase-buffer) (let ((yas/selected-text "He\"o world!")) (yas-expand-snippet "Look ma! `(yas/selected-text)`") (should (string= (yas--buffer-contents) "Look ma! He\"o world!"))) (yas-exit-all-snippets) (erase-buffer) (let ((yas/selected-text "He\"\)\\o world!")) (yas-expand-snippet "Look ma! `(yas/selected-text)`") (should (string= (yas--buffer-contents) "Look ma! He\"\)\\o world!"))) (yas-exit-all-snippets) (erase-buffer))) (ert-deftest be-careful-when-escaping-in-yas-selected-text-2 () (with-temp-buffer (let ((yas/selected-text "He)}o world!")) (yas-expand-snippet "Look ma! ${1:`(yas/selected-text)`} OK?") (should (string= (yas--buffer-contents) "Look ma! He)}o world! OK?"))))) (ert-deftest example-for-issue-271 () (with-temp-buffer (yas-minor-mode 1) (let ((yas-selected-text "aaa") (snippet "if ${1:condition}\n`yas/selected-text`\nelse\n$3\nend")) (yas-expand-snippet snippet) (yas-next-field) (ert-simulate-command `(yas-mock-insert "bbb")) (should (string= (yas--buffer-contents) "if condition\naaa\nelse\nbbb\nend"))))) (ert-deftest another-example-for-issue-271 () ;; expect this to fail in batch mode since `region-active-p' doesn't ;; used by `yas-expand-snippet' doesn't make sense in that context. ;; :expected-result (if noninteractive :failed :passed) (with-temp-buffer (yas-minor-mode 1) (let ((snippet "\\${${1:1}:`yas/selected-text`}")) (insert "aaabbbccc") (set-mark 4) (goto-char 7) (yas-expand-snippet snippet) (should (string= (yas--buffer-contents) "aaa${1:bbb}ccc"))))) (ert-deftest string-match-with-subregexp-in-embedded-elisp () (with-temp-buffer (yas-minor-mode 1) ;; the rule here is: To use regexps in embedded `(elisp)` expressions, write ;; it like you would normal elisp, i.e. no need to escape the backslashes. (let ((snippet "`(if (string-match \"foo\\\\(ba+r\\\\)foo\" \"foobaaaaaaaaaarfoo\") \"ok\" \"fail\")`")) (yas-expand-snippet snippet)) (should (string= (yas--buffer-contents) "ok")))) (ert-deftest string-match-with-subregexp-in-mirror-transformations () (with-temp-buffer (yas-minor-mode 1) ;; the rule here is: To use regexps in embedded `(elisp)` expressions, ;; escape backslashes once, i.e. to use \\( \\) constructs, write \\\\( \\\\). (let ((snippet "$1${1:$(if (string-match \"foo\\\\\\\\(ba+r\\\\\\\\)baz\" yas/text) \"ok\" \"fail\")}")) (yas-expand-snippet snippet) (should (string= (yas--buffer-contents) "fail")) (ert-simulate-command `(yas-mock-insert "foobaaar")) (should (string= (yas--buffer-contents) "foobaaarfail")) (ert-simulate-command `(yas-mock-insert "baz")) (should (string= (yas--buffer-contents) "foobaaarbazok"))))) ;;; Misc tests ;;; (ert-deftest protection-overlay-no-cheating () "Protection overlays at the very end of the buffer are dealt with by cheatingly inserting a newline! TODO: correct this bug!" :expected-result :failed (with-temp-buffer (yas-minor-mode 1) (yas-expand-snippet "${2:brother} from another ${1:mother}") (should (string= (yas--buffer-contents) "brother from another mother") ;; no newline should be here! ))) ;;; Loading ;;; (defmacro yas-with-overriden-buffer-list (&rest body) (let ((saved-sym (gensym))) `(let ((,saved-sym (symbol-function 'buffer-list))) (yas--with-temporary-redefinitions ((buffer-list () (remove-if #'(lambda (buf) (with-current-buffer buf (eq major-mode 'lisp-interaction-mode))) (funcall ,saved-sym)))) ,@body)))) (defmacro yas-with-some-interesting-snippet-dirs (&rest body) `(yas-saving-variables (yas-with-overriden-buffer-list (yas-with-snippet-dirs '((".emacs.d/snippets" ("c-mode" (".yas-parents" . "cc-mode") ("printf" . "printf($1);")) ;; notice the overriding for issue #281 ("emacs-lisp-mode" ("ert-deftest" . "(ert-deftest ${1:name} () $0)")) ("lisp-interaction-mode" (".yas-parents" . "emacs-lisp-mode"))) ("library/snippets" ("c-mode" (".yas-parents" . "c++-mode") ("printf" . "printf")) ("cc-mode" ("def" . "# define")) ("emacs-lisp-mode" ("dolist" . "(dolist)")) ("lisp-interaction-mode" ("sc" . "brother from another mother")))) ,@body)))) (ert-deftest basic-jit-loading () "Test basic loading and expansion of snippets" (yas-with-some-interesting-snippet-dirs (yas-reload-all) (yas--basic-jit-loading-1))) (ert-deftest basic-jit-loading-with-compiled-snippets () "Test basic loading and expansion of snippets" (yas-with-some-interesting-snippet-dirs (yas-reload-all) (yas-recompile-all) (yas--with-temporary-redefinitions ((yas--load-directory-2 (&rest dummies) (declare (ignore dummies)) (ert-fail "yas--load-directory-2 shouldn't be called when snippets have been compiled"))) (yas-reload-all) (yas--basic-jit-loading-1)))) (defun yas--basic-jit-loading-1 (&optional compile) (with-temp-buffer (should (= 4 (hash-table-count yas--scheduled-jit-loads))) (should (= 0 (hash-table-count yas--tables))) (lisp-interaction-mode) (yas-minor-mode 1) (should (= 2 (hash-table-count yas--scheduled-jit-loads))) (should (= 2 (hash-table-count yas--tables))) (should (= 1 (hash-table-count (yas--table-uuidhash (gethash 'lisp-interaction-mode yas--tables))))) (should (= 2 (hash-table-count (yas--table-uuidhash (gethash 'emacs-lisp-mode yas--tables))))) (yas-should-expand '(("sc" . "brother from another mother") ("dolist" . "(dolist)") ("ert-deftest" . "(ert-deftest name () )"))) (c-mode) (yas-minor-mode 1) (should (= 0 (hash-table-count yas--scheduled-jit-loads))) (should (= 4 (hash-table-count yas--tables))) (should (= 1 (hash-table-count (yas--table-uuidhash (gethash 'c-mode yas--tables))))) (should (= 1 (hash-table-count (yas--table-uuidhash (gethash 'cc-mode yas--tables))))) (yas-should-expand '(("printf" . "printf();") ("def" . "# define"))) (yas-should-not-expand '("sc" "dolist" "ert-deftest")))) ;;; Menu ;;; (defmacro yas-with-even-more-interesting-snippet-dirs (&rest body) `(yas-saving-variables (yas-with-snippet-dirs `((".emacs.d/snippets" ("c-mode" (".yas-make-groups" . "") ("printf" . "printf($1);") ("foo-group-a" ("fnprintf" . "fprintf($1);") ("snprintf" . "snprintf($1);")) ("foo-group-b" ("strcmp" . "strecmp($1);") ("strcasecmp" . "strcasecmp($1);"))) ("lisp-interaction-mode" ("ert-deftest" . "# group: barbar\n# --\n(ert-deftest ${1:name} () $0)")) ("fancy-mode" ("a-guy" . "# uuid: 999\n# --\nyo!") ("a-sir" . "# uuid: 12345\n# --\nindeed!") ("a-lady" . "# uuid: 54321\n# --\noh-la-la!") ("a-beggar" . "# uuid: 0101\n# --\narrrgh!") ("an-outcast" . "# uuid: 666\n# --\narrrgh!") (".yas-setup.el" . , (pp-to-string '(yas-define-menu 'fancy-mode '((yas-ignore-item "0101") (yas-item "999") (yas-submenu "sirs" ((yas-item "12345"))) (yas-submenu "ladies" ((yas-item "54321")))) '("666"))))))) ,@body))) (ert-deftest test-yas-define-menu () (let ((yas-use-menu t)) (yas-with-even-more-interesting-snippet-dirs (yas-reload-all 'no-jit) (let ((menu (cdr (gethash 'fancy-mode yas--menu-table)))) (should (eql 4 (length menu))) (dolist (item '("a-guy" "a-beggar")) (should (find item menu :key #'third :test #'string=))) (should-not (find "an-outcast" menu :key #'third :test #'string=)) (dolist (submenu '("sirs" "ladies")) (should (keymapp (fourth (find submenu menu :key #'third :test #'string=))))) )))) (ert-deftest test-group-menus () "Test group-based menus using .yas-make-groups and the group directive" (let ((yas-use-menu t)) (yas-with-even-more-interesting-snippet-dirs (yas-reload-all 'no-jit) ;; first the subdir-based groups ;; (let ((menu (cdr (gethash 'c-mode yas--menu-table)))) (should (eql 3 (length menu))) (dolist (item '("printf" "foo-group-a" "foo-group-b")) (should (find item menu :key #'third :test #'string=))) (dolist (submenu '("foo-group-a" "foo-group-b")) (should (keymapp (fourth (find submenu menu :key #'third :test #'string=)))))) ;; now group directives ;; (let ((menu (cdr (gethash 'lisp-interaction-mode yas--menu-table)))) (should (eql 1 (length menu))) (should (find "barbar" menu :key #'third :test #'string=)) (should (keymapp (fourth (find "barbar" menu :key #'third :test #'string=)))))))) (ert-deftest test-group-menus-twisted () "Same as similarly named test, but be mean. TODO: be meaner" (let ((yas-use-menu t)) (yas-with-even-more-interesting-snippet-dirs ;; add a group directive conflicting with the subdir and watch ;; behaviour (with-temp-buffer (insert "# group: foo-group-c\n# --\nstrecmp($1)") (write-region nil nil (concat (first (yas-snippet-dirs)) "/c-mode/foo-group-b/strcmp"))) (yas-reload-all 'no-jit) (let ((menu (cdr (gethash 'c-mode yas--menu-table)))) (should (eql 4 (length menu))) (dolist (item '("printf" "foo-group-a" "foo-group-b" "foo-group-c")) (should (find item menu :key #'third :test #'string=))) (dolist (submenu '("foo-group-a" "foo-group-b" "foo-group-c")) (should (keymapp (fourth (find submenu menu :key #'third :test #'string=)))))) ;; delete the .yas-make-groups file and watch behaviour ;; (delete-file (concat (first (yas-snippet-dirs)) "/c-mode/.yas-make-groups")) (yas-reload-all 'no-jit) (let ((menu (cdr (gethash 'c-mode yas--menu-table)))) (should (eql 5 (length menu)))) ;; Change a group directive and reload ;; (let ((menu (cdr (gethash 'lisp-interaction-mode yas--menu-table)))) (should (find "barbar" menu :key #'third :test #'string=))) (with-temp-buffer (insert "# group: foofoo\n# --\n(ert-deftest ${1:name} () $0)") (write-region nil nil (concat (first (yas-snippet-dirs)) "/lisp-interaction-mode/ert-deftest"))) (yas-reload-all 'no-jit) (let ((menu (cdr (gethash 'lisp-interaction-mode yas--menu-table)))) (should (eql 1 (length menu))) (should (find "foofoo" menu :key #'third :test #'string=)) (should (keymapp (fourth (find "foofoo" menu :key #'third :test #'string=)))))))) ;;; The infamous and problematic tab keybinding ;;; (ert-deftest test-yas-tab-binding () (with-temp-buffer (yas-minor-mode -1) (should (not (eq (key-binding (yas--read-keybinding "")) 'yas-expand))) (yas-minor-mode 1) (should (eq (key-binding (yas--read-keybinding "")) 'yas-expand)) (yas-expand-snippet "$1 $2 $3") (should (eq (key-binding [(tab)]) 'yas-next-field-or-maybe-expand)) (should (eq (key-binding (kbd "TAB")) 'yas-next-field-or-maybe-expand)) (should (eq (key-binding [(shift tab)]) 'yas-prev-field)) (should (eq (key-binding [backtab]) 'yas-prev-field)))) (ert-deftest test-rebindings () (unwind-protect (progn (define-key yas-minor-mode-map [tab] nil) (define-key yas-minor-mode-map (kbd "TAB") nil) (define-key yas-minor-mode-map (kbd "SPC") 'yas-expand) (with-temp-buffer (yas-minor-mode 1) (should (not (eq (key-binding (yas--read-keybinding "TAB")) 'yas-expand))) (should (eq (key-binding (yas--read-keybinding "SPC")) 'yas-expand)) (yas-reload-all) (should (not (eq (key-binding (yas--read-keybinding "TAB")) 'yas-expand))) (should (eq (key-binding (yas--read-keybinding "SPC")) 'yas-expand)))) (setcdr yas-minor-mode-map (cdr (yas--init-minor-keymap))))) (ert-deftest test-yas-in-org () (with-temp-buffer (org-mode) (yas-minor-mode 1) (should (eq (key-binding [(tab)]) 'yas-expand)) (should (eq (key-binding (kbd "TAB")) 'yas-expand)))) ;;; Helpers ;;; (defun yas/ert () (interactive) (with-temp-buffer (yas--with-temporary-redefinitions ((message (&rest args) ; (declare (ignore args)) nil)) (ert t (buffer-name (current-buffer))) (princ (buffer-string))))) (defun yas-should-expand (keys-and-expansions) (dolist (key-and-expansion keys-and-expansions) (yas-exit-all-snippets) (erase-buffer) (insert (car key-and-expansion)) (let ((yas-fallback-behavior nil)) (ert-simulate-command '(yas-expand))) (should (string= (yas--buffer-contents) (cdr key-and-expansion)))) (yas-exit-all-snippets)) (defun yas-should-not-expand (keys) (dolist (key keys) (yas-exit-all-snippets) (erase-buffer) (insert key) (let ((yas-fallback-behavior nil)) (ert-simulate-command '(yas-expand))) (should (string= (yas--buffer-contents) key)))) (defun yas-mock-insert (string) (interactive) (do ((i 0 (1+ i))) ((= i (length string))) (insert (aref string i)))) (defun yas-make-file-or-dirs (ass) (let ((file-or-dir-name (car ass)) (content (cdr ass))) (cond ((listp content) (make-directory file-or-dir-name 'parents) (let ((default-directory (concat default-directory "/" file-or-dir-name))) (mapc #'yas-make-file-or-dirs content))) ((stringp content) (with-temp-buffer (insert content) (write-region nil nil file-or-dir-name nil 'nomessage))) (t (message "[yas] oops don't know this content"))))) (defun yas-variables () (let ((syms)) (mapatoms #'(lambda (sym) (if (and (string-match "^yas-[^/]" (symbol-name sym)) (boundp sym)) (push sym syms)))) syms)) (defun yas-call-with-saving-variables (fn) (let* ((vars (yas-variables)) (saved-values (mapcar #'symbol-value vars))) (unwind-protect (funcall fn) (loop for var in vars for saved in saved-values do (set var saved))))) (defmacro yas-saving-variables (&rest body) `(yas-call-with-saving-variables #'(lambda () ,@body))) (defun yas-call-with-snippet-dirs (dirs fn) (let* ((default-directory (make-temp-file "yasnippet-fixture" t)) (yas-snippet-dirs (mapcar #'car dirs))) (with-temp-message "" (unwind-protect (progn (mapc #'yas-make-file-or-dirs dirs) (funcall fn)) (when (>= emacs-major-version 24) (delete-directory default-directory 'recursive)))))) (defmacro yas-with-snippet-dirs (dirs &rest body) `(yas-call-with-snippet-dirs ,dirs #'(lambda () ,@body))) ;;; Older emacsen ;;; (unless (fboundp 'special-mode) (define-minor-mode special-mode "Just a placeholder for something isn't in emacs 22")) ;;; btw to test this in emacs22 mac osx: ;;; curl -L -O https://github.com/mirrors/emacs/raw/master/lisp/emacs-lisp/ert.el ;;; curl -L -O https://github.com/mirrors/emacs/raw/master/lisp/emacs-lisp/ert-x.el ;;; /usr/bin/emacs -nw -Q -L . -l yasnippet-tests.el --batch -e ert (provide 'yasnippet-tests) ;;; yasnippet-tests.el ends here ;; Local Variables: ;; lexical-binding: t ;; End: