Fix a docstring typo.
[sbcl.git] / src / code / parse-defmacro-errors.lisp
blob05c2e65f8c2f0c5e8e702d4ee28c94293f6a86f2
1 ;;;; error-handling machinery for MAKE-MACRO-LAMBDA separated from
2 ;;;; that code because the happy path can be handled
3 ;;;; earlier in the bootstrap sequence than DEFINE-CONDITION can be
5 ;;;; This software is part of the SBCL system. See the README file for
6 ;;;; more information.
7 ;;;;
8 ;;;; This software is derived from the CMU CL system, which was
9 ;;;; written at Carnegie Mellon University and released into the
10 ;;;; public domain. The software is in the public domain and is
11 ;;;; provided with absolutely no warranty. See the COPYING and CREDITS
12 ;;;; files for more information.
14 (in-package "SB!KERNEL")
16 (define-condition defmacro-lambda-list-bind-error (error)
17 ((kind :reader defmacro-lambda-list-bind-error-kind
18 :initarg :kind)
19 (name :reader defmacro-lambda-list-bind-error-name
20 :initarg :name
21 :initform nil)))
23 ;;; shared logic for REPORTing variants of DEFMACRO-LAMBDA-LIST-BIND-ERROR:
24 ;;; Set up appropriate prettying and indentation on STREAM, print some
25 ;;; boilerplate related to CONDITION (an instance of
26 ;;; DEFMACRO-LAMBDA-LIST-BIND-ERROR), then execute BODY.
27 (defmacro !printing-defmacro-lambda-list-bind-error ((condition stream)
28 &body body)
29 `(%printing-defmacro-lambda-list-bind-error ,condition
30 ,stream
31 (lambda (,stream)
32 (declare (type stream ,stream))
33 ,@body)))
34 (defun %printing-defmacro-lambda-list-bind-error (condition stream fun)
35 (declare (type stream stream) (type function fun))
36 (pprint-logical-block (stream nil)
37 (format stream
38 "error while parsing arguments to ~A~@[ ~S~]:~2I~:@_"
39 (defmacro-lambda-list-bind-error-kind condition)
40 (defmacro-lambda-list-bind-error-name condition))
41 (pprint-logical-block (stream nil)
42 (funcall fun stream))))
44 (define-condition arg-count-error (defmacro-lambda-list-bind-error)
45 ((args :reader arg-count-error-args :initarg :args)
46 (lambda-list :reader arg-count-error-lambda-list
47 :initarg :lambda-list)
48 (minimum :reader arg-count-error-minimum :initarg :minimum)
49 (maximum :reader arg-count-error-maximum :initarg :maximum))
50 (:report
51 (lambda (condition stream)
52 (!printing-defmacro-lambda-list-bind-error (condition stream)
53 (let* ((min (arg-count-error-minimum condition))
54 (max (arg-count-error-maximum condition))
55 (actual (arg-count-error-args condition))
56 (n-actual (if (proper-list-p actual) (length actual) nil)))
57 (format stream
58 "~A elements in ~2I~_~:S ~
59 ~I~_to satisfy lambda list ~2I~_~:S: ~I~_"
60 (cond ((and n-actual (< n-actual min)) "too few")
61 ((and n-actual max (> n-actual max)) "too many")
62 (t "invalid number of"))
63 actual (arg-count-error-lambda-list condition))
64 (format stream
65 (cond ((null max) "at least ~W expected")
66 ((= min max) "exactly ~W expected")
67 (t "between ~W and ~W expected"))
68 min max)
69 (cond ((and (atom actual) actual)
70 (format stream ", but got a non-list"))
71 ((cdr (last actual))
72 (format stream ", but got an improper list"))
74 (format stream ", but got ~d" n-actual))))))))
76 (define-condition defmacro-lambda-list-broken-key-list-error
77 (defmacro-lambda-list-bind-error)
78 ((problem :reader defmacro-lambda-list-broken-key-list-error-problem
79 :initarg :problem)
80 (info :reader defmacro-lambda-list-broken-key-list-error-info
81 :initarg :info))
82 (:report (lambda (condition stream)
83 (!printing-defmacro-lambda-list-bind-error (condition stream)
84 (format stream
85 ;; FIXME: These should probably just be three
86 ;; subclasses of the base class, so that we don't
87 ;; need to maintain the set of tags both here and
88 ;; implicitly wherever this macro is used. (This
89 ;; might get easier once CLOS is initialized in
90 ;; cold init.)
91 (ecase
92 (defmacro-lambda-list-broken-key-list-error-problem
93 condition)
94 (:dotted-list
95 "dotted keyword/value list: ~S")
96 (:odd-length
97 "odd number of elements in keyword/value list: ~S")
98 (:unknown-keyword
99 ;; Todo: print the keyword portion of the actual args
100 ;; "unknown keyword foo in (:A 1 :B ...);
101 ;; expected one of ..."
102 "~{unknown keyword: ~S; expected one of ~
103 ~{~S~^, ~}~}"))
104 (defmacro-lambda-list-broken-key-list-error-info
105 condition))))))