1 ;; -*- geiser-scheme-implementation: 'chicken
3 ;; Copyright (C) 2015 Daniel J Leslie
5 ;; This program is free software; you can redistribute it and/or
6 ;; modify it under the terms of the Modified BSD License. You should
7 ;; have received a copy of the license along with this program. If
8 ;; not, see <http://www.xfree86.org/3.3.6/COPYRIGHT2.html#5>.
17 geiser-object-signature
18 geiser-symbol-location
19 geiser-symbol-documentation
21 geiser-add-to-load-path
27 geiser-module-location
28 geiser-module-completions
30 geiser-chicken-use-debug-log
31 geiser-chicken-load-paths)
33 (import chicken scheme)
50 ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
52 ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
54 (define geiser-r4rs-symbols
56 '(not boolean? eq? eqv? equal? pair? cons car cdr caar cadr cdar cddr
57 caaar caadr cadar caddr cdaar cdadr cddar cdddr caaaar caaadr caadar
58 caaddr cadaar cadadr caddar cadddr cdaaar cdaadr cdadar cdaddr cddaar
59 cddadr cdddar cddddr set-car! set-cdr! null? list? list length
60 list-tail list-ref append reverse memq memv member assq assv assoc
61 symbol? symbol->string string->symbol number? integer? exact? real?
62 complex? inexact? rational? zero? odd? even? positive? negative?
63 max min + - * / = > < >= <= quotient remainder modulo gcd lcm abs
64 floor ceiling truncate round exact->inexact inexact->exact exp log
65 expt sqrt sin cos tan asin acos atan number->string string->number
66 char? char=? char>? char<? char>=? char<=? char-ci=? char-ci<?
67 char-ci>? char-ci>=? char-ci<=? char-alphabetic? char-whitespace?
68 char-numeric? char-upper-case? char-lower-case? char-upcase
69 char-downcase char->integer integer->char string? string=? string>?
70 string<? string>=? string<=? string-ci=? string-ci<? string-ci>?
71 string-ci>=? string-ci<=? make-string string-length string-ref
72 string-set! string-append string-copy string->list list->string
73 substring string-fill! vector? make-vector vector-ref vector-set!
74 string vector vector-length vector->list list->vector vector-fill!
75 procedure? map for-each apply force call-with-current-continuation
76 input-port? output-port? current-input-port current-output-port
77 call-with-input-file call-with-output-file open-input-file
78 open-output-file close-input-port close-output-port load
79 read eof-object? read-char peek-char write display write-char
80 newline with-input-from-file with-output-to-file eval char-ready?
81 imag-part real-part magnitude numerator denominator
82 scheme-report-environment null-environment interaction-environment
85 (define geiser-r5rs-symbols
87 '(abs acos and angle append apply asin assoc assq assv atan begin
88 boolean? caar cadr call-with-current-continuation
89 call-with-input-file call-with-output-file call-with-values
90 car case cdddar cddddr cdr ceiling char->integer char-alphabetic?
91 char-ci<=? char-ci<? char-ci=? char-ci>=? char-ci>? char-downcase
92 char-lower-case? char-numeric? char-ready? char-upcase
93 char-upper-case? char-whitespace? char<=? char<? char=? char>=?
94 char>? char? close-input-port close-output-port complex? cond cons
95 cos current-input-port current-output-port define define-syntax
96 delay denominator display do dynamic-wind else eof-object? eq?
97 equal? eqv? eval even? exact->inexact exact? exp expt floor
98 for-each force gcd if imag-part inexact->exact inexact? input-port?
99 integer->char integer? interaction-environment lambda lcm length
100 let let* let-syntax letrec letrec-syntax list list->string
101 list->vector list-ref list-tail list? load log magnitude make-polar
102 make-rectangular make-string make-vector map max member memq memv
103 min modulo negative? newline not null-environment null?
104 number->string number? numerator odd? open-input-file
105 open-output-file or output-port? pair? peek-char port? positive?
106 procedure? quasiquote quote quotient rational? rationalize read
107 read-char real-part real? remainder reverse round
108 scheme-report-environment set! set-car! set-cdr! setcar sin sqrt
109 string string->list string->number string->symbol string-append
110 string-ci<=? string-ci<? string-ci=? string-ci>=? string-ci>?
111 string-copy string-fill! string-length string-ref string-set!
112 string<=? string<? string=? string>=? string>? string? substring
113 symbol->string symbol? syntax-rules tan transcript-off transcript-on
114 truncate values vector vector->list vector-fill! vector-length
115 vector-ref vector-set! vector? with-input-from-file with-output-to-file
116 write write-char zero?)))
118 (define geiser-r7rs-small-symbols
120 '(* + - ... / < <= = => > >= abs and append apply assoc assq
121 assv begin binary-port? boolean=? boolean? bytevector
122 bytevector-append bytevector-copy bytevector-copy! bytevector-length
123 bytevector-u8-ref bytevector-u8-set! bytevector? caar cadr
124 call-with-current-continuation call-with-port call-with-values call/cc
125 car case cdar cddr cdr ceiling char->integer char-ready? char<=?
126 char<? char=? char>=? char>? char? close-input-port
127 close-output-port close-port complex? cond cond-expand cons
128 current-error-port current-input-port current-output-port
129 define define-record-type define-syntax define-values denominator do
130 dynamic-wind else eof-object? equal? error error-object-message
131 even? exact-integer-sqrt exact? features floor floor-remainder
132 flush-output-port gcd get-output-string if include-ci inexact?
133 input-port? integer? lcm let let*-values let-values letrec* list
134 list->vector list-ref list-tail make-bytevector make-parameter
135 make-vector max memq min negative? not number->string numerator
136 open-input-bytevector open-output-bytevector or output-port?
137 parameterize peek-u8 positive? quasiquote quotient raise-continuable
138 rationalize read-bytevector! read-error? read-string real? reverse
139 set! set-cdr! string string->number string->utf8 string-append
140 eof-object eq? eqv? error-object-irritants error-object? exact
141 exact-integer? expt file-error? floor-quotient floor/ for-each
142 get-output-bytevector guard include inexact input-port-open?
143 integer->char lambda length let* let-syntax letrec letrec-syntax
144 list->string list-copy list-set! list? make-list make-string map
145 member memv modulo newline null? number? odd? open-input-string
146 open-output-string output-port-open? pair? peek-char port?
147 procedure? quote raise rational? read-bytevector read-char read-line
148 read-u8 remainder round set-car! square string->list string->symbol
149 string->vector string-copy string-copy! string-for-each string-map
150 string-set! string<? string>=? string? symbol->string symbol?
151 syntax-rules truncate truncate-remainder u8-ready? unquote
152 utf8->string vector vector->string vector-copy vector-fill!
153 vector-length vector-ref vector? with-exception-handler write-char
154 write-u8 string-fill! string-length string-ref string<=?
155 string=? string>? substring symbol=? syntax-error textual-port?
156 truncate-quotient truncate/ unless unquote-splicing values
157 vector->list vector-append vector-copy! vector-for-each vector-map
158 vector-set! when write-bytevector write-string zero?)))
160 (define geiser-chicken-builtin-symbols
162 '(and-let* assume compiler-typecase cond-expand condition-case cut cute declare define-constant
163 define-inline define-interface define-record define-record-type define-specialization
164 define-syntax-rule define-type define-values dotimes ecase fluid-let foreign-lambda
165 foreign-lambda* foreign-primitive foreign-safe-lambda foreign-safe-lambda* functor
166 handle-exceptions import let*-values let-location let-optionals let-optionals*
167 let-values letrec* letrec-values match-letrec module parameterize regex-case
168 require-extension select set! unless use when with-input-from-pipe match
169 match-lambda match-lambda* match-let match-let* receive)))
171 (define geiser-chicken-crunch-symbols
173 '(* + - / < <= = > >= abs acos add1 argc argv-ref arithmetic-shift asin
174 atan atan2 bitwise-and bitwise-ior bitwise-not bitwise-xor
175 blob->f32vector blob->f32vector/shared blob->f64vector
176 blob->f64vector/shared blob->s16vector blob->s16vector/shared
177 blob->s32vector blob->s32vector/shared blob->s8vector
178 blob->s8vector/shared blob->string blob->string/shared blob->u16vector
179 blob->u16vector/shared blob->u32vector blob->u32vector/shared
180 blob->u8vector blob->u8vector/shared ceiling char->integer
181 char-alphabetic? char-ci<=? char-ci<? char-ci=? char-ci>=? char-ci>?
182 char-downcase char-lower-case? char-numeric? char-upcase
183 char-upper-case? char-whitespace? char<=? char<? char=? char>=? char>?
184 cond-expand cos display display eq? equal? eqv? error even?
185 exact->inexact exact? exit exp expt f32vector->blob
186 f32vector->blob/shared f32vector-length f32vector-ref f32vector-set!
187 f64vector->blob f64vector->blob/shared f64vector-length f64vector-ref
188 f64vector-set! floor flush-output inexact->exact inexact?
189 integer->char integer? log make-f32vector make-f64vector make-s16vector
190 make-s32vector make-s8vector make-string make-u16vector make-u32vector
191 make-u8vector max min modulo negative? newline not number->string odd?
192 pointer-f32-ref pointer-f32-set! pointer-f64-ref pointer-f64-set!
193 pointer-s16-ref pointer-s16-set! pointer-s32-ref pointer-s32-set!
194 pointer-s8-ref pointer-s8-set! pointer-u16-ref pointer-u16-set!
195 pointer-u32-ref pointer-u32-set! pointer-u8-ref pointer-u8-set!
196 positive? quotient rec remainder round s16vector->blob
197 s16vector->blob/shared s16vector-length s16vector-ref s16vector-set!
198 s32vector->blob s32vector->blob/shared s32vector-length s32vector-ref
199 s32vector-set! s8vector->blob s8vector->blob/shared s8vector-length
200 s8vector-ref s8vector-set! sin sqrt string->blob string->blob/shared
201 string->number string-append string-ci<=? string-ci<? string-ci=?
202 string-ci>=? string-ci>? string-copy string-fill! string-length
203 string-ref string-set! string<=? string<? string=? string>=? string>?
204 sub1 subf32vector subf64vector subs16vector subs32vector subs8vector
205 substring subu16vector subu32vector subu8vector switch tan truncate
206 u16vector->blob u16vector->blob/shared u16vector-length u16vector-ref
207 u16vector-set! u32vector->blob u32vector->blob/shared u32vector-length
208 u32vector-ref u32vector-set! u8vector->blob u8vector->blob/shared
209 u8vector-length u8vector-ref u8vector-set! unless void when write-char
212 ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
214 ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
216 (define geiser-chicken-use-debug-log (make-parameter #f))
218 (define find-module ##sys#find-module)
219 (define current-module ##sys#current-module)
220 (define switch-module ##sys#switch-module)
221 (define module-name ##sys#module-name)
222 (define (list-modules) (map car ##sys#module-table))
224 (define empty-symbol (string->symbol ""))
226 (define (symbol-information-list partial-string)
228 (let* ((module (if (eq? empty-symbol (caar lst)) #f (caar lst)))
230 (append (list name module) (cdr lst))))
231 (apropos-information-list partial-string #:macros? #t)))
233 (define debug-log (make-parameter #f))
234 (define (write-to-log form)
235 (when (geiser-chicken-use-debug-log)
236 (when (not (debug-log))
237 (debug-log (file-open "geiser.log" (+ open/wronly open/append open/text open/creat)))
238 (set-file-position! (debug-log) 0 seek/end))
239 (file-write (debug-log) (with-all-output-to-string (lambda () (write form) (newline))))
240 (file-write (debug-log) "\n")))
242 (define (string-has-prefix? s prefix)
244 ((= 0 (string-length prefix)) #t)
245 ((= 0 (string-length s)) #f)
246 ((eq? (string-ref s 0) (string-ref prefix 0))
247 (string-has-prefix? (substring/shared s 1) (substring/shared prefix 1)))
250 ;; This really should be a chicken library function
251 (define (write-exception exn)
252 (define (write-call-entry call)
253 (let ((type (vector-ref call 0))
254 (line (vector-ref call 1)))
256 ((equal? type "<syntax>")
257 (display (string-append type " ")) (write line) (newline))
258 ((equal? type "<eval>")
259 (display (string-append type " ")) (write line) (newline)))))
261 (display (format "Error: (~s) ~s: ~s"
262 ((condition-property-accessor 'exn 'location) exn)
263 ((condition-property-accessor 'exn 'message) exn)
264 ((condition-property-accessor 'exn 'arguments) exn)))
266 (display "Call history: ") (newline)
267 (map write-call-entry ((condition-property-accessor 'exn 'call-chain) exn))
270 ;; And this should be a chicken library function as well
271 (define (with-all-output-to-string thunk)
272 (with-output-to-string
274 (with-error-output-to-port
275 (current-output-port)
278 (define (maybe-call func val)
279 (if val (func val) #f))
281 ;; Wraps output from geiser functions
282 (define (call-with-result module thunk)
283 (let* ((result (if #f #f))
285 (module (maybe-call (lambda (v) (find-module module)) module))
286 (original-module (current-module)))
289 (handle-exceptions exn
290 (with-all-output-to-string
291 (lambda () (write-exception exn)))
292 (with-all-output-to-string
294 (switch-module module)
295 (call-with-values thunk (lambda v (set! result v)))))))
297 (switch-module original-module)
302 (map (lambda (v) (with-output-to-string (lambda () (write v)))) result))
303 ((eq? result (if #f #t))
306 (list (with-output-to-string (lambda () (write result)))))))
310 (output . ,output))))
312 (write-to-log '[[RESPONSE]])
313 (write-to-log out-form))
317 (define (find-standards-with-symbol sym)
319 (if (any (cut eq? <> sym) (geiser-r4rs-symbols))
322 (if (any (cut eq? <> sym) (geiser-r5rs-symbols))
325 (if (any (cut eq? <> sym) (geiser-r7rs-small-symbols))
328 (if (any (cut eq? <> sym) (geiser-chicken-builtin-symbols))
331 (if (any (cut eq? <> sym) (geiser-chicken-crunch-symbols))
335 ;; Locates any paths at which a particular symbol might be located
336 (define (find-library-paths sym types)
337 ;; Removes the given sym from the node path
338 (define (remove-self sym path)
340 ((not (list? path)) path)
343 (if (eq? (car path) sym)
347 (cons (car path) (remove-self sym (cdr path))))))
352 (find-standards-with-symbol sym))
355 (remove-self sym (node-path node)))
358 (let ((type (node-type n)))
359 (any (cut eq? type <>) types)))
360 (match-nodes sym)))))
362 (define (make-module-list sym module-sym)
365 (find-standards-with-symbol sym)
366 (cons module-sym (find-standards-with-symbol sym)))))
369 (with-input-from-string str (lambda () (read))))
373 ((symbol? str) (eval str))
374 ((string? str) (eval (read* str)))
375 (else (eval* (->string str)))))
378 (let* ((mod (cadr node))
381 (type (if (or (list? rest) (pair? rest)) (car rest) rest))
382 (mod-list (make-module-list sym mod)))
384 ((equal? 'macro type)
385 `(,sym ("args" (("required" <macro>)
388 ("module" ,@mod-list)))
389 ((or (equal? 'variable type)
390 (equal? 'constant type))
392 `(,sym ("value" . ,(eval* sym)))
393 (let* ((original-module (current-module))
394 (desired-module (find-module mod))
395 (value (begin (switch-module desired-module)
397 (switch-module original-module)
398 `(,sym ("value" . ,value)
399 ("module" ,@mod-list)))))
404 (args (if (or (list? rest) (pair? rest)) (cdr rest) '())))
406 (define (clean-arg arg)
407 (let ((s (->string arg)))
408 (read* (substring/shared s 0 (add1 (string-skip-right s char-set:digit))))))
410 (define (collect-args args #!key (reqs? #t) (opts? #f) (keys? #f))
411 (when (not (null? args))
413 ((or (pair? args) (list? args))
415 ((eq? '#!key (car args))
416 (collect-args (cdr args) reqs?: #f opts?: #f keys?: #t))
417 ((eq? '#!optional (car args))
418 (collect-args (cdr args) reqs?: #f opts?: #t keys?: #f))
423 (set! reqs (append reqs (list (clean-arg (car args))))))
425 (set! opts (append opts (list (cons (clean-arg (caar args)) (cdar args))))))
427 (set! keys (append keys (list (cons (clean-arg (caar args)) (cdar args)))))))
428 (collect-args (cdr args))))))
430 (set! opts (list (clean-arg args) '...))))))
434 `(,sym ("args" (("required" ,@reqs)
437 ("module" ,@mod-list)))))))
439 ;; Builds a signature list from an identifier
440 (define (find-signatures sym)
441 (let ((result (symbol-information-list sym)))
444 ;; Builds the documentation from Chicken Doc for a specific symbol
445 (define (make-doc symbol #!optional (filter-for-type #f))
446 (with-output-to-string
449 (display (string-append "= Node: " (->string (node-id node)) " " " =\n"))
454 (or (not filter-for-type)
455 (eq? (node-type n) filter-for-type)))
456 (match-nodes symbol))))))
459 ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
460 ;; Geiser core functions
461 ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
463 ;; Basically all non-core functions pass through geiser-eval
465 (define (form-has-safe-geiser? form)
466 (any (cut eq? (car form) <>)
467 '(geiser-no-values geiser-newline geiser-completions
468 geiser-autodoc geiser-object-signature geiser-symbol-location
469 geiser-symbol-documentation geiser-module-exports
470 geiser-module-path geiser-module-location
471 geiser-module-completions geiser-chicken-use-debug-log)))
473 (define (form-has-any-geiser? form)
474 (string-has-prefix? (->string (car form)) "geiser-"))
476 (define (form-defines-any-module? form)
478 ;; Geiser seems to send buffers as (begin ..buffer contents..)
479 (and (eq? (car form) 'begin)
480 (form-defines-any-module? (cadr form)))
481 (any (cut eq? (car form) <>)
482 '(module define-library))))
484 (define (module-matches-defined-module? module)
485 (any (cut eq? module <>) (list-modules)))
487 (define (geiser-eval module form . rest)
488 (when (and module (not (symbol? module)))
489 (error "Module should be a symbol"))
491 ;; All calls start at toplevel
492 (let* ((is-safe-geiser? (form-has-safe-geiser? form))
493 (host-module (and (not is-safe-geiser?)
494 (not (form-has-any-geiser? form))
495 (not (form-defines-any-module? form))
496 (module-matches-defined-module? module)
498 (thunk (lambda () (eval form))))
500 (write-to-log `[[REQUEST host-module: ,host-module]])
504 (call-with-result #f thunk)
505 (call-with-result host-module thunk))))
509 (define (geiser-load-file file)
510 (let* ((file (if (symbol? file) (symbol->string file) file))
511 (found-file (geiser-find-file file)))
515 (load found-file))))))
517 ;; The no-values identity
519 (define (geiser-no-values)
522 ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
524 ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
528 (define (geiser-newline . rest)
531 ;; Spawn a server for remote repl access
533 (define (geiser-start-server . rest)
534 (let* ((listener (tcp-listen 0))
535 (port (tcp-listener-port listener)))
536 (define (remote-repl)
537 (receive (in out) (tcp-accept listener)
538 (current-input-port in)
539 (current-output-port out)
540 (current-error-port out)
544 (thread-start! (make-thread remote-repl))
546 (write-to-log `(geiser-start-server . ,rest))
547 (write-to-log `(port ,port))
549 (write `(port ,port))
552 ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
553 ;; Completions, Autodoc and Signature
554 ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
556 (define (geiser-completions prefix . rest)
557 (let ((prefix (->string prefix)))
558 (filter (cut string-has-prefix? <> prefix)
559 (map ->string (map car (symbol-information-list prefix))))))
561 (define (geiser-module-completions prefix . rest)
562 (let ((prefix (->string prefix)))
563 (filter (cut string-has-prefix? <> prefix) (map ->string (list-modules)))))
565 (define (geiser-autodoc ids . rest)
569 (geiser-autodoc (list ids)))
571 (let ((details (find-signatures (car ids))))
573 (geiser-autodoc (cdr ids))
576 (define (geiser-object-signature name object . rest)
577 (let* ((sig (geiser-autodoc `(,name))))
578 (if (null? sig) '() (car sig))))
580 ;; TODO: Divine some way to support this functionality
582 (define (geiser-symbol-location symbol . rest)
583 '(("file") ("line")))
585 (define (geiser-symbol-documentation symbol . rest)
586 (let* ((sig (find-signatures symbol)))
587 `(("signature" ,@(car sig))
588 ("docstring" . ,(make-doc symbol)))))
590 ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
591 ;; File and Buffer Operations
592 ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
594 (define geiser-chicken-load-paths (make-parameter '("" ".")))
596 (define (geiser-find-file file . rest)
598 (let ((paths (geiser-chicken-load-paths)))
599 (define (try-find file paths)
602 ((file-exists? (string-append (car paths) file))
603 (string-append (car paths) file))
604 (else (try-find file (cdr paths)))))
605 (try-find file paths))))
607 (define (geiser-add-to-load-path directory . rest)
608 (let* ((directory (if (symbol? directory)
609 (symbol->string directory)
611 (directory (if (not (equal? #\/ (string-ref directory (- (string-length directory)))))
612 (string-append directory "/")
616 (when (directory-exists? directory)
617 (geiser-chicken-load-paths (cons directory (geiser-chicken-load-paths))))))))
619 (define (geiser-compile-file file . rest)
620 (let* ((file (if (symbol? file) (symbol->string file) file))
621 (found-file (geiser-find-file file)))
625 (compile-file found-file))))))
627 ;; TODO: Support compiling regions
629 (define (geiser-compile form module . rest)
630 (error "Chicken does not support compiling regions"))
632 ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
634 ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
637 ;; '(("modules" . sub-modules) ("procs" . procedures) ("syntax" . macros) ("vars" . variables))
638 (define (geiser-module-exports module-name . rest)
639 (let* ((nodes (match-nodes module-name)))
648 (let ((type (node-type node))
649 (name (node-id node))
650 (path (node-path node)))
652 ((memq type '(unit egg))
653 (set! mod (cons name mod)))
654 ((memq type '(procedure record setter class method))
655 (set! proc (cons name proc)))
656 ((memq type '(read syntax))
657 (set! syn (cons name syn)))
658 ((memq type '(parameter constant))
659 (set! var (cons name var))))))
666 ;; Returns the path for the file in which an egg or module was defined
668 (define (geiser-module-path module-name . rest)
672 ;; `(("file" . ,(module-path name)) ("line"))
674 (define (geiser-module-location name . rest)
677 ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
679 ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
681 (define (geiser-macroexpand form . rest)
682 (with-output-to-string
684 (write (expand form)))))