Commit | Line | Data |
---|---|---|
048d0b2d MW |
1 | ;;; -*-lisp-*- |
2 | ;;; | |
3 | ;;; Output for modules | |
4 | ;;; | |
5 | ;;; (c) 2013 Straylight/Edgeware | |
6 | ;;; | |
7 | ||
8 | ;;;----- Licensing notice --------------------------------------------------- | |
9 | ;;; | |
e0808c47 | 10 | ;;; This file is part of the Sensible Object Design, an object system for C. |
048d0b2d MW |
11 | ;;; |
12 | ;;; SOD is free software; you can redistribute it and/or modify | |
13 | ;;; it under the terms of the GNU General Public License as published by | |
14 | ;;; the Free Software Foundation; either version 2 of the License, or | |
15 | ;;; (at your option) any later version. | |
16 | ;;; | |
17 | ;;; SOD is distributed in the hope that it will be useful, | |
18 | ;;; but WITHOUT ANY WARRANTY; without even the implied warranty of | |
19 | ;;; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the | |
20 | ;;; GNU General Public License for more details. | |
21 | ;;; | |
22 | ;;; You should have received a copy of the GNU General Public License | |
23 | ;;; along with SOD; if not, write to the Free Software Foundation, | |
24 | ;;; Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA. | |
25 | ||
26 | (cl:in-package #:sod) | |
27 | ||
28 | ;;;-------------------------------------------------------------------------- | |
29 | ;;; Utilities. | |
30 | ||
31 | (export 'banner) | |
32 | (defun banner (title output &key (blank-line-p t)) | |
33 | "Write a banner to the OUTPUT stream, starting a new section called TITLE. | |
34 | ||
35 | If BLANK-LINE-P is false, then leave a blank line after the banner. (This | |
36 | is useful for a final banner at the end of a file.)" | |
37 | (format output "~&/*----- ~A ~A*/~%" | |
38 | title | |
39 | (make-string (- 77 2 5 1 (length title) 1 2) | |
40 | :initial-element #\-)) | |
41 | (when blank-line-p | |
42 | (terpri output))) | |
43 | ||
44 | (export 'guard-name) | |
45 | (defun guard-name (filename) | |
46 | "Return a sensible inclusion guard name for FILENAME." | |
47 | (with-output-to-string (guard) | |
48 | (let* ((pathname (make-pathname :name (pathname-name filename) | |
49 | :type (pathname-type filename))) | |
50 | (name (namestring pathname)) | |
51 | (uscore t)) | |
52 | (dotimes (i (length name)) | |
53 | (let ((ch (char name i))) | |
54 | (cond ((alphanumericp ch) | |
55 | (write-char (char-upcase ch) guard) | |
56 | (setf uscore nil)) | |
57 | ((not uscore) | |
58 | (write-char #\_ guard) | |
59 | (setf uscore t)))))))) | |
60 | ||
61 | (defun guess-output-file (module type) | |
62 | "Guess the filename to use for a file TYPE, generated from MODULE. | |
63 | ||
64 | Here, TYPE is a filetype string. The result is returned as a pathname." | |
65 | (merge-pathnames (make-pathname :type type :case :common) | |
66 | (module-name module))) | |
67 | ||
e674612e MW |
68 | (defvar *done-one-off-output* nil |
69 | "A list of tokens for things which should appear at most once in output.") | |
70 | ||
71 | (export 'one-off-output) | |
72 | (defun one-off-output (token sequencer item-name function) | |
73 | "Arrange to output a thing at most once. | |
74 | ||
75 | If there has been no previous call to `one-off-output' with the given | |
76 | TOKEN during this output run, then arrange to call FUNCTION when the item | |
77 | called ITEM-NAME is traversed. Otherwise do nothing." | |
78 | (unless (member token *done-one-off-output*) | |
79 | (push token *done-one-off-output*) | |
80 | (add-sequencer-item-function sequencer item-name function))) | |
81 | ||
048d0b2d MW |
82 | ;;;-------------------------------------------------------------------------- |
83 | ;;; Main output interface. | |
84 | ||
85 | (export 'output-module) | |
86 | (defun output-module (module reason stream) | |
87 | "Write the MODULE to STREAM, giving the output machinery the REASON. | |
88 | ||
89 | This is the top-level interface for producing output." | |
b7a3889e MW |
90 | (let ((*print-right-margin* 77) |
91 | (*done-one-off-output* nil) | |
e674612e | 92 | (sequencer (make-instance 'sequencer)) |
048d0b2d MW |
93 | (stream (if (typep stream 'position-aware-output-stream) |
94 | stream | |
95 | (make-instance 'position-aware-output-stream | |
96 | :stream stream | |
ea578bb4 | 97 | :file (stream-pathname stream))))) |
9ec578d9 MW |
98 | (with-module-environment (module) |
99 | (hook-output module reason sequencer) | |
100 | (invoke-sequencer-items sequencer stream)))) | |
048d0b2d MW |
101 | |
102 | ;;;-------------------------------------------------------------------------- | |
103 | ;;; Output implementation. | |
104 | ||
105 | (defmethod hook-output progn ((module module) reason sequencer) | |
106 | ||
107 | ;; Ask the module's items to sequence themselves. | |
108 | (dolist (item (module-items module)) | |
109 | (hook-output item reason sequencer))) | |
110 | ||
111 | (defmethod hook-output progn ((frag code-fragment-item) reason sequencer) | |
112 | ||
113 | ;; Output fragments when their reasons are called up. | |
114 | (when (eq reason (code-fragment-reason frag)) | |
115 | (dolist (constraint (code-fragment-constraints frag)) | |
116 | (add-sequencer-constraint sequencer constraint)) | |
117 | (add-sequencer-item-function sequencer (code-fragment-name frag) | |
118 | (lambda (stream) | |
119 | (write (code-fragment frag) | |
120 | :stream stream | |
121 | :pretty nil | |
122 | :escape nil))))) | |
123 | ||
124 | (defmethod hook-output progn ((module module) (reason (eql :h)) sequencer) | |
125 | (sequence-output (stream sequencer) | |
126 | ||
127 | :constraint | |
128 | (:prologue | |
129 | (:guard :start) | |
130 | (:typedefs :start) :typedefs (:typedefs :end) | |
e674612e | 131 | (:includes :start) :includes :early-decls (:includes :end) |
d437292a | 132 | (:early-user :start) :early-user (:early-user :end) |
721c1ca4 | 133 | (:classes :start) (:classes :end) |
d437292a | 134 | (:user :start) :user (:user :end) |
048d0b2d MW |
135 | (:guard :end) |
136 | :epilogue) | |
137 | ||
138 | (:prologue | |
139 | (format stream "~ | |
9ec578d9 | 140 | /* -*- mode: c; indent-tabs-mode: nil -*- |
048d0b2d MW |
141 | * |
142 | * Header file generated by SOD for ~A | |
143 | */~2%" | |
144 | (namestring (module-name module)))) | |
145 | ||
146 | ((:guard :start) | |
147 | (format stream "~ | |
148 | #ifndef ~A | |
149 | #define ~:*~A | |
150 | ||
151 | #ifdef __cplusplus | |
152 | extern \"C\" { | |
153 | #endif~2%" | |
154 | (or (get-property (module-pset module) :guard :id) | |
155 | (guard-name (or (stream-pathname stream) | |
156 | (guess-output-file module "H")))))) | |
157 | ((:guard :end) | |
158 | (banner "That's all, folks" stream) | |
159 | (format stream "~ | |
160 | #ifdef __cplusplus | |
161 | } | |
162 | #endif | |
163 | ||
164 | #endif~%")) | |
165 | ||
166 | ((:typedefs :start) | |
167 | (banner "Forward type declarations" stream)) | |
168 | ((:typedefs :end) | |
169 | (terpri stream)) | |
170 | ||
171 | ((:includes :start) | |
172 | (banner "External header files" stream)) | |
173 | ((:includes :end) | |
174 | (terpri stream)))) | |
175 | ||
176 | (defmethod hook-output progn ((module module) (reason (eql :c)) sequencer) | |
177 | (sequence-output (stream sequencer) | |
178 | ||
179 | :constraint | |
180 | (:prologue | |
181 | (:includes :start) :includes (:includes :end) | |
d437292a | 182 | (:early-user :start) :early-user (:early-user :end) |
048d0b2d | 183 | (:classes :start) (:classes :end) |
d437292a | 184 | (:user :start) :user (:user :end) |
048d0b2d MW |
185 | :epilogue) |
186 | ||
187 | (:prologue | |
188 | (format stream "~ | |
9ec578d9 | 189 | /* -*- mode: c; indent-tabs-mode: nil -*- |
048d0b2d MW |
190 | * |
191 | * Implementation file generated by SOD for ~A | |
192 | */~2%" | |
193 | (namestring (module-name module)))) | |
194 | ||
195 | (:epilogue | |
196 | (banner "That's all, folks" stream :blank-line-p nil)) | |
197 | ||
198 | ((:includes :start) | |
199 | (banner "External header files" stream)) | |
200 | ((:includes :end) | |
201 | (terpri stream)))) | |
202 | ||
9ec578d9 MW |
203 | ;;;-------------------------------------------------------------------------- |
204 | ;;; Output types. | |
205 | ||
206 | (defvar *output-types* nil | |
207 | "List of known output types.") | |
208 | ||
209 | (export 'declare-output-type) | |
210 | (defun declare-output-type (reason pathname) | |
211 | "Record that REASON is a valid user-level output type. | |
212 | ||
213 | The output file name will be constructed by merging the module's pathname | |
214 | with PATHNAME." | |
e05aabbb | 215 | (pushnew reason *output-types*) |
9ec578d9 MW |
216 | (setf (get reason 'output-type) pathname)) |
217 | ||
218 | (export 'output-type-pathname) | |
219 | (defun output-type-pathname (reason) | |
220 | "Return the PATHNAME template for the output type REASON. | |
221 | ||
222 | Report an error if there is no such output type." | |
223 | (or (get reason 'output-type) | |
224 | (error "Unknown output type `~(~A~)'" reason))) | |
225 | ||
b0e21f83 MW |
226 | (export 'module-output-file) |
227 | (defgeneric module-output-file (module output-type output-dir) | |
228 | (:documentation | |
229 | "Return a pathname to which the output should be written. | |
230 | ||
231 | Specifically, if we're processing a MODULE for a particular OUTPUT-TYPE, | |
232 | and the user has requested that output be written to OUTPUT-DIR (a | |
233 | pathname), then return the pathname to which the output should be | |
234 | written. | |
235 | ||
236 | The OUTPUT-TYPE can be an `reason' symbol or a raw pathname. (Or | |
237 | something else, of course.)")) | |
238 | ||
239 | (defmethod module-output-file | |
240 | ((module module) (output-type symbol) output-dir) | |
241 | (module-output-file module (output-type-pathname output-type) output-dir)) | |
242 | ||
243 | (defmethod module-output-file | |
244 | ((module module) (output-type pathname) output-dir) | |
245 | (reduce #'merge-pathnames | |
246 | (list output-dir output-type | |
247 | (make-pathname :directory nil | |
248 | :defaults (module-name module))))) | |
249 | ||
e05aabbb MW |
250 | (export 'write-dependency-file) |
251 | (defgeneric write-dependency-file (module reason output-dir) | |
252 | (:documentation | |
253 | "Write a dependency-tracking make(1) fragment. | |
254 | ||
255 | Specifically, we've processed a MODULE for a particular REASON (a | |
256 | symbol), and the user has requested that output be written to OUTPUT-DIR | |
257 | (a pathname): determine a suitable output pathname and write a make(1) | |
258 | fragment explaining that the output file we've made depends on all of the | |
259 | files we had to read to load the module.")) | |
260 | ||
261 | (defmethod write-dependency-file ((module module) reason output-dir) | |
262 | (let* ((common-case | |
263 | ;; Bletch. We want to derive the filetype from the one we're | |
264 | ;; given, but we need to determine the environment's preferred | |
265 | ;; filetype case to do that. Make a pathname and inspect it to | |
266 | ;; find out how to do this. | |
267 | ||
268 | (if (upper-case-p | |
269 | (char (pathname-type (make-pathname | |
270 | :type "TEST" | |
271 | :case :common)) | |
272 | 0)) | |
273 | #'string-upcase | |
274 | #'string-downcase)) | |
275 | ||
276 | (outpath (output-type-pathname reason)) | |
277 | (deppath (make-pathname :type (concatenate 'string | |
278 | (pathname-type outpath) | |
279 | (funcall common-case | |
280 | "-DEP")) | |
281 | :defaults outpath)) | |
282 | (outfile (module-output-file module reason output-dir)) | |
283 | (depfile (module-output-file module deppath output-dir))) | |
284 | ||
285 | (with-open-file (dep depfile | |
286 | :direction :output | |
287 | :if-exists :supersede | |
288 | :if-does-not-exist :create) | |
289 | (format dep "### -*-makefile-*-~%~ | |
290 | ~A:~{ \\~% ~A~}~%" | |
291 | outfile | |
292 | (cons (module-name module) | |
293 | (module-files module)))))) | |
294 | ||
9ec578d9 MW |
295 | (define-clear-the-decks reset-output-types |
296 | "Clear out the registered output types." | |
297 | (dolist (reason *output-types*) (remprop reason 'output-type)) | |
298 | (setf *output-types* nil) | |
299 | (declare-output-type :c (make-pathname :type "C" :case :common)) | |
300 | (declare-output-type :h (make-pathname :type "H" :case :common))) | |
301 | ||
048d0b2d | 302 | ;;;----- That's all, folks -------------------------------------------------- |