0.7.10.18:
[sbcl.git] / src / cold / with-stuff.lisp
1 ;;;; code to tweak compilation environment, used to set up
2 ;;;; for different phases of cross-compilation
3
4 ;;;; This software is part of the SBCL system. See the README file for
5 ;;;; more information.
6 ;;;;
7 ;;;; This software is derived from the CMU CL system, which was
8 ;;;; written at Carnegie Mellon University and released into the
9 ;;;; public domain. The software is in the public domain and is
10 ;;;; provided with absolutely no warranty. See the COPYING and CREDITS
11 ;;;; files for more information.
12
13 (in-package "SB-COLD")
14
15 ;;; a helper macro for WITH-ADDITIONAL-NICKNAME and WITHOUT-SOME-NICKNAME
16 (defmacro with-given-nicknames ((package-designator nicknames) &body body)
17   (let ((p (gensym "P"))
18         (n (gensym "N"))
19         (o (gensym "O")))
20     `(let* ((,p ,package-designator) ; PACKAGE-DESIGNATOR, evaluated only once
21             (,n ,nicknames) ; NICKNAMES, evaluated only once
22             (,o (package-nicknames ,p))) ; old package nicknames
23        (rename-package-carefully ,p (package-name ,p) ,n)
24        (unwind-protect
25            (progn ,@body)
26          (unless (nicknames= ,n (package-nicknames ,p))
27            ;; This probably didn't happen on purpose, and it's not clear anyway
28            ;; what we should do when it did happen, so die noisily:
29            (error "package nicknames changed within WITH-GIVEN-NICKNAMES: ~
30                    expected ~S, found ~S"
31                   ,n
32                   (package-nicknames ,p)))
33          (rename-package-carefully ,p (package-name ,p) ,o)))))
34
35 ;;; Execute BODY with NICKNAME added as a nickname for PACKAGE-DESIGNATOR.
36 (defmacro with-additional-nickname ((package-designator nickname) &body body)
37   (let ((p (gensym "P"))
38         (n (gensym "N")))
39     `(let* ((,p ,package-designator) ; PACKAGE-DESIGNATOR, evaluated only once
40             (,n ,nickname)) ; NICKNAME, evaluated only once
41        (if (find-package ,n)
42          (error "~S is already a package name." ,n)
43          (with-given-nicknames (,p (cons ,n (package-nicknames ,p)))
44            ,@body)))))
45
46 ;;; Execute BODY with NICKNAME removed as a nickname for PACKAGE-DESIGNATOR.
47 (defmacro without-given-nickname ((package-designator nickname) &body body)
48   (let ((p (gensym "P"))
49         (n (gensym "N"))
50         (o (gensym "O")))
51     `(let* ((,p ,package-designator) ; PACKAGE-DESIGNATOR, evaluated only once
52             (,n ,nickname) ; NICKNAME, evaluated only once
53             (,o (package-nicknames ,p))) ; old package nicknames
54        (if (find ,n ,o :test #'string=)
55          (with-given-nicknames (,p (remove ,n ,o :test #'string=))
56            ,@body)
57          (error "~S is not a nickname for ~S." ,n ,p)))))
58
59 ;;; a helper function for WITH-NICKNAME: Are two collections of package
60 ;;; nicknames the same?
61 (defun nicknames= (x y)
62   (equal (sort (mapcar #'string x) #'string<)
63          (sort (mapcar #'string y) #'string<)))
64 (compile 'nicknames=)
65
66 ;;; helper functions for WITH-ADDITIONAL-NICKNAMES and WITHOUT-GIVEN-NICKNAMES
67 (defun %with-additional-nickname (package-designator nickname body-fn)
68   (declare (type function body-fn))
69   (with-additional-nickname (package-designator nickname)
70     (funcall body-fn)))
71 (defun %without-given-nickname (package-designator nickname body-fn)
72   (declare (type function body-fn))
73   (without-given-nickname (package-designator nickname)
74     (funcall body-fn)))
75 (defun %multi-nickname-magic (nd-list single-nn-fn body-fn)
76   (declare (type function single-nn-fn))
77   (labels ((multi-nd (nd-list body-fn) ; multiple nickname descriptors
78              (declare (type function body-fn))
79              (if (null nd-list)
80                (funcall body-fn)
81                (single-nd (first nd-list)
82                           (lambda ()
83                             (multi-nd (rest nd-list) body-fn)))))
84            (single-nd (nd body-fn) ; single nickname descriptor
85              (destructuring-bind (package-descriptor nickname-list) nd
86                (multi-nn package-descriptor nickname-list body-fn)))
87            (multi-nn (nn-list package-descriptor body-fn) ; multiple nicknames
88              (declare (type function body-fn))
89              (if (null nn-list)
90                (funcall body-fn)
91                (funcall single-nn-fn
92                         (first nn-list)
93                         package-descriptor
94                         (lambda ()
95                           (multi-nn package-descriptor
96                                     (rest nn-list)
97                                     body-fn))))))
98     (multi-nd nd-list body-fn)))
99 (compile '%with-additional-nickname)
100 (compile '%without-given-nickname)
101 (compile '%multi-nickname-magic)
102
103 ;;; This is like WITH-ADDITIONAL-NICKNAME and WITHOUT-GIVEN-NICKNAMES,
104 ;;; except working on arbitrary lists of nickname descriptors instead
105 ;;; of single nickname/package pairs.
106 ;;;
107 ;;; A nickname descriptor is a list of the form
108 ;;;   PACKAGE-DESIGNATOR NICKNAME*
109 (defmacro with-additional-nicknames (nickname-descriptor-list &body body)
110   `(%multi-nickname-magic ,nickname-descriptor-list
111                           #'%with-additional-nickname
112                           (lambda () ,@body)))
113 (defmacro without-given-nicknames (nickname-descriptor-list &body body)
114   `(%multi-nickname-magic ,nickname-descriptor-list
115                           #'%without-additional-nickname
116                           (lambda () ,@body)))