+;;;; tests for problems in the interface presented to the user/programmer
+
;;;; This software is part of the SBCL system. See the README file for
;;;; more information.
;;;;
;;;; more information.
(in-package :cl-user)
+\f
+;;;; properties of symbols, e.g. presence of doc strings for public symbols
+
+;;; FIXME: It would probably be good to require here that every
+;;; external symbol either has a doc string or has some good excuse
+;;; (like being an accessor for a structure which has a doc string).
+\f
+;;;; tests of interface machinery
+
+;;; APROPOS should accept a package designator, not just a package, and
+;;; furthermore do the right thing when it gets a package designator.
+;;; (bug reported and fixed by Alexey Dejneka sbcl-devel 2001-10-17)
+(assert (< 0
+ (length (apropos-list "PRINT" :cl))
+ (length (apropos-list "PRINT"))))
+;;; Further, it should correctly deal with the external-only flag (bug
+;;; reported by cliini on #lisp IRC 2003-05-30, fixed in sbcl-0.8.0.1x
+;;; by CSR)
+(assert (= (length (apropos-list "" "CL"))
+ (length (apropos-list "" "CL" t))))
+(assert (< 0
+ (length (apropos-list "" "SB-VM" t))
+ (length (apropos-list "" "SB-VM"))))
+\f
+;;; DESCRIBE shouldn't fail on rank-0 arrays (bug reported and fixed
+;;; by Lutz Euler sbcl-devel 2002-12-03)
+(describe #0a0)
+(describe #(1 2 3))
+(describe #2a((1 2) (3 4)))
+
+;;; support for DESCRIBE tests
+(defstruct to-be-described a b)
+(defclass forward-describe-class (forward-describe-ref) (a))
+
+;;; DESCRIBE should run without signalling an error.
+(describe (make-to-be-described))
+(describe 12)
+(describe "a string")
+(describe 'symbolism)
+(describe (find-package :cl))
+(describe '(a list))
+(describe #(a vector))
+
+;;; The DESCRIBE-OBJECT methods for built-in CL stuff should do
+;;; FRESH-LINE and TERPRI neatly.
+(dolist (i (list (make-to-be-described :a 14) 12 "a string"
+ #0a0 #(1 2 3) #2a((1 2) (3 4)) 'sym :keyword
+ (find-package :keyword) (list 1 2 3)
+ nil (cons 1 2) (make-hash-table)
+ (let ((h (make-hash-table)))
+ (setf (gethash 10 h) 100
+ (gethash 11 h) 121)
+ h)
+ (make-condition 'simple-error)
+ (make-condition 'simple-error :format-control "fc")
+ #'car #'make-to-be-described (lambda (x) (+ x 11))
+ (constantly 'foo) #'(setf to-be-described-a)
+ #'describe-object (find-class 'to-be-described)
+ (find-class 'forward-describe-class)
+ (find-class 'forward-describe-ref) (find-class 'cons)))
+ (let ((s (with-output-to-string (s)
+ (write-char #\x s)
+ (describe i s))))
+ (unless (and (char= #\x (char s 0))
+ ;; one leading #\NEWLINE from FRESH-LINE or the like, no more
+ (char= #\newline (char s 1))
+ (char/= #\newline (char s 2))
+ ;; one trailing #\NEWLINE from TERPRI or the like, no more
+ (let ((n (length s)))
+ (and (char= #\newline (char s (- n 1)))
+ (char/= #\newline (char s (- n 2))))))
+ (error "misbehavior in DESCRIBE of ~S" i))))
+
+;;; TYPEP, SUBTYPEP, UPGRADED-ARRAY-ELEMENT-TYPE and
+;;; UPGRADED-COMPLEX-PART-TYPE should be able to deal with NIL as an
+;;; environment argument
+(typep 1 'fixnum nil)
+(subtypep 'fixnum 'integer nil)
+(upgraded-array-element-type '(mod 5) nil)
+(upgraded-complex-part-type '(single-float 0.0 1.0) nil)
+
+;;; We should have documentation for our extension package:
+(assert (documentation (find-package "SB-EXT") t))
+
+;;; DECLARE should not be a special operator
+(assert (not (special-operator-p 'declare)))
+
+;;; WITH-TIMEOUT should accept more than one form in its body.
+(handler-bind ((sb-ext:timeout #'continue))
+ (sb-ext:with-timeout 3
+ (sleep 2)
+ (sleep 2)))
+
+;;; DOCUMENTATION should return nil, not signal slot-unbound
+(documentation 'fixnum 'type)
+(documentation 'class 'type)
+(documentation (find-class 'class) 'type)
+
+;;; DECODE-UNIVERSAL-TIME should accept second-resolution time-zones.
+(macrolet ((test (ut time-zone list)
+ (destructuring-bind (sec min hr date mon yr day tz)
+ list
+ `(multiple-value-bind (sec min hr date mon yr day dst tz)
+ (decode-universal-time ,ut ,time-zone)
+ (declare (ignore dst))
+ (assert (= sec ,sec))
+ (assert (= min ,min))
+ (assert (= hr ,hr))
+ (assert (= date ,date))
+ (assert (= mon ,mon))
+ (assert (= yr ,yr))
+ (assert (= day ,day))
+ (assert (= tz ,tz))))))
+ (test (* 86400 365) -1/3600 (1 0 0 1 1 1901 1 -1/3600))
+ (test (* 86400 365) 0 (0 0 0 1 1 1901 1 0))
+ (test (* 86400 365) 1/3600 (59 59 23 31 12 1900 0 1/3600)))
-;;; Check for fbound external symbols in public packages that have no
-;;; argument list information. (This can happen if we get carried away
-;;; with byte compilation, since at least in sbcl-0.6.12 the byte
-;;; compiler can't record argument list information.)
-(defvar *public-package-names*
- '("SB-ALIEN" "SB-C-CALL" "SB-DEBUG" "SB-EXT" "SB-GRAY" "SB-MP"
- "SB-PROFILE" "SB-PCL" "COMMON-LISP"))
-(defun has-arglist-info-p (function)
- (and (not (typep function 'sb-c::byte-function))
- (sb-kernel:%function-arglist function)))
-(defun check-ext-symbols-arglist (package)
- (format t "~% looking at package: ~A" package)
- (do-external-symbols (ext-sym package)
- (when (fboundp ext-sym)
- (let ((fun (symbol-function ext-sym)))
- (unless (has-arglist-info-p fun)
- (error "~%Function ~A (~A) has no argument-list information available, ~%~
- and is probably byte-compiled.~%" ext-sym fun))))))
-(dolist (public-package *public-package-names*)
- (when (find-package public-package)
- (check-ext-symbols-arglist public-package)))
-(terpri)
-(print "done with interface.pure.lisp")
+;;; DISASSEMBLE shouldn't fail on purified functions
+(disassemble 'cl:+)
+(disassemble 'sb-ext:run-program)
projects / sbcl.git / blobdiff