subtemplate/private/template-subscripts.rkt

441 lines
19 KiB
Racket

#lang racket/base
(require racket/require
racket/list
racket/string
racket/function
"optcontract.rkt"
phc-toolkit/untyped
phc-toolkit/untyped-only/syntax-parse
racket/stxparam
stxparse-info/parse
stxparse-info/case
stxparse-info/current-pvars
stxparse-info/parse/experimental/template
(prefix-in - stxparse-info/parse/private/residual)
(prefix-in dbg: stxparse-info/parse/private/runtime)
syntax/id-table
(subtract-in racket/syntax stxparse-info/case)
"copy-attribute.rkt"
"lifted-variables-communication.rkt"
(for-syntax (subtract-in racket/base srfi/13)
"patch-arrows.rkt"
"subscripts.rkt"
racket/format
stxparse-info/parse
racket/private/sc
racket/syntax
racket/list
racket/function
phc-toolkit/untyped
syntax/strip-context
srfi/13
(subtract-in racket/string srfi/13)
syntax/contract
"optcontract.rkt"))
(provide subtemplate
quasisubtemplate
derive
ellipsis-count/c) ;; TODO: don't provide this here.
(define derived-valvar-cache (make-weak-hash))
(begin-for-syntax
(define/contract (nest-ellipses stx n)
(-> syntax? exact-nonnegative-integer? syntax?)
(if (= n 0)
stx
#`(#,(nest-ellipses stx (sub1 n))
( )))))
;; Checks that all the given attribute values have the same structure.
;;
;; ellipsis-count/c works with the value of pattern variables and of attributes
;; too, including those missing (optional) elements in the lists, at any level.
;;
;; The lists must have the same lengths across all attribute values, including
;; the missing #f elements.
;;
;; If same-shape is #true, a #f in one attribute value implies #f in all other
;; attribute values at the same position. The same-shape check is not
;; performed on the bottommost #f values (as they do not influence the shape of
;; the tree).
(define/contract (ellipsis-count/c depth
[bottom-predicate any/c]
#:same-shape [same-shape #f])
(->* {exact-nonnegative-integer?}
{flat-contract?
#:same-shape boolean?}
flat-contract?)
;; Must be lazy, otherwise ellipsis-count/c would immediately call itself
(define (recur/c sublists)
((ellipsis-count/c (sub1 depth) bottom-predicate #:same-shape same-shape)
sublists))
(flat-named-contract
(apply build-compound-type-name
(list* 'ellipsis-count/c depth bottom-predicate
(if same-shape
(list '#:same-shape same-shape)
(list))))
(λ (l*)
(true?
(and (list? l*)
(if (and same-shape (> depth 0))
(or (andmap false? l*) ;; all #f
(andmap identity l*)) ;; all non-#f
#t)
(let ([l* (filter identity l*)])
(if (= depth 0)
(andmap bottom-predicate l*)
(let ([lengths (map length l*)])
(and (or (< (length lengths) 2) (apply = lengths))
(or (empty? l*)
(apply andmap
(λ sublists
(recur/c sublists))
l*)))))))))))
(define/contract (map-merge-stx-depth f l* depth)
(->i {[f (-> (listof any/c) any/c)]
[l* (depth) (ellipsis-count/c depth any/c)]
[depth exact-nonnegative-integer?]}
{result (depth l*)
(λ (r) ((ellipsis-count/c depth) (cons r l*)))})
(let ([l* (filter identity l*)])
(if (= depth 0)
(f l*)
(if (empty? l*)
#f
(apply map
(λ sublists
(map-merge-stx-depth f
sublists
(sub1 depth)))
l*)))))
(define-for-syntax (sub*template self-form tmpl-form get-attribute*)
(syntax-parser
[(self {~optional {~and #:force-no-stxinfo force-no-stxinfo}}
{~optkw #:props (prop:id ...)}
;; #: marks end of options (so that we can have implicit ?@ later)
{~optional #:}
tmpl)
(unless (attribute force-no-stxinfo)
(for ([sym (in-list '(syntax-parse define/syntax-parse syntax-parser
syntax-case define/with-syntax with-syntax))])
(let ([shadower (datum->syntax #'self sym)];syntax-local-get-shadower ?
[good (datum->syntax #'here sym)])
(when (or (not (identifier-binding shadower))
(not (free-identifier=? shadower good)))
(raise-syntax-error self-form
(~a sym (if (identifier-binding shadower)
(~a " resolves to the official "
sym ",")
" seems undefined,")
" but subtemplate needs the patched"
" version from stxparse-info. Use (require"
" stxparse-info/parse) and (require"
" stxparse-info/case) to fix this. This"
" message can be disabled with (" self-form
" #:force-no-stxinfo …), if you know what"
" you're doing."))))))
(define acc '())
;; Finds identifiers of the form zᵢ, and return a list of existing xᵢ
;; bindings
(define (fold-process stx rec)
(syntax-case stx ()
[(id . _) (and (identifier? #'id)
(free-identifier=? #'id #'unsyntax))
stx]
[id (identifier? #'id)
(let ([binders+info (find-subscript-binders #'id)])
(when binders+info
(set! acc (cons binders+info acc)))
#'id)]
[other (rec #'other)]))
;; Process the syntax, extract the derived bindings into acc
;; Does not take zᵢ identifiers generated by template metafunctions into
;; account for now.
(fold-syntax fold-process #'tmpl)
;; define the result, which looks like (template . tmpl) or
;; like (quasitemplate . tmpl)
(define result
(quasisyntax/top-loc #'self
(#,tmpl-form tmpl
#,@(if (attribute props) #'(#:props (prop ...)) #'()))))
;; Make sure that we remove duplicates, otherwise we'll get errors if we
;; define the same derived id twice.
(define/with-syntax ([bound
(binder )
unique-at-runtime-ids
ellipsis-depth]
)
(remove-duplicates acc bound-identifier=? #:key car))
(define/with-syntax whole-form-id (generate-temporary 'whole-subtemplate))
(define lift-target (lift-late-pvars-target))
(if lift-target
(let ()
(define/with-syntax ([token . to-insert] )
(stx-map lifted-pvar
(stx-map syntax-e #'(bound )) ;; name
#`([lifted-var-macro bound] )))
#`(let-values ()
(quote-syntax (to-insert ))
(copy-raw-syntax-attribute bound
(hash-ref #,lift-target 'token)
ellipsis-depth
#f) ;; TODO: #t iff the original was #t
#,(if get-attribute*
#'(list (attribute* bound ) )
result)))
#`(let-values ()
(define-values (whole-form-id) (quote-syntax #,this-syntax))
(derive bound
(binder )
unique-at-runtime-ids
ellipsis-depth
whole-form-id)
#,(if get-attribute*
#'(list (attribute* bound ) )
#`(let-values ()
;; check that all the binders for a given bound are
;; compatible.
((ellipsis-count/c ellipsis-depth)
(list (attribute* binder) ))
;; actually call template or quasitemplate
#,result))))]))
(define-syntax (lifted-var-macro stx)
(syntax-case stx ()
[(_ bound)
#`(car (subtemplate/attribute* bound))]))
(define-syntax subtemplate/attribute*
(sub*template 'subtemplate #'template #t))
(define-syntax subtemplate
(sub*template 'subtemplate #'template #f))
(define-syntax quasisubtemplate
(sub*template 'quasisubtemplate #'quasitemplate #f))
(define/contract (multi-hash-ref! h keys)
;; This assumes that the hash does not get mutated during the execution of
;; this function.
(-> (and/c (hash/c symbol? any/c #:immutable #f) hash-weak?)
(listof symbol?)
any/c)
(define val (or (for/or ([k (in-list keys)]) (hash-ref h k #f))
(make-free-id-table))) ;; create an empty table by default.
;; Set the existing value (or new to-set if none) on all keys which
;; are not present in the hash table.
(for ([k (in-list keys)]) (hash-ref! h k val))
val)
(define formattable/c (or/c number? string? symbol? bytes?))
(define (generate-nested-ids-check-ellipsis-match-count
l* depth attribute-names whole-form bound)
(if ((ellipsis-count/c depth) l*)
#t
(raise-syntax-error
(syntax-case whole-form ()
[(self . _) (syntax-e #'self)]
[_ 'subtemplate])
"incompatible ellipsis match counts for subscripted variables:"
whole-form
bound
attribute-names)))
(module+ test-private
(provide generate-nested-ids))
(define generate-nested-ids-full-contract
(->i {[depth exact-nonnegative-integer?]
[bound identifier?]
[binder₀ identifier?]
[format (-> formattable/c string?)]
[l* (depth) (listof (attribute-val/c depth))]
[attribute-names (l*) (and/c (listof identifier?)
(λ (a) (= (length l*) (length a))))]
[whole-form syntax?]}
#:pre (l* depth attribute-names whole-form bound)
(generate-nested-ids-check-ellipsis-match-count
l* depth attribute-names whole-form bound)
{result (depth l*)
(and/c (attribute-val/c depth identifier?)
(λ (r) ((ellipsis-count/c depth) (cons r l*))))}))
(define/contract/alt
(generate-nested-ids depth bound binder₀ format l* attribute-names whole-form)
generate-nested-ids-full-contract
(generate-nested-ids-check-ellipsis-match-count
l* depth attribute-names whole-form bound)
(define (gen bottom*)
(define v
(let ([vs (filter-map (λ (v)
(cond [(formattable/c v) v]
[(formattable/c (syntax-e v)) (syntax-e v)]
[else #f]))
bottom*)])
(if (empty? vs)
(syntax-e (generate-temporary binder₀))
(car vs))))
(datum->syntax ((make-syntax-introducer) bound)
(string->symbol (format v))))
(map-merge-stx-depth gen l* depth))
(define-syntax/case (derive bound
(binder₀ binderᵢ )
(unique-at-runtime-idᵢ )
ellipsis-depth
whole-form-id) ()
(define depth (syntax-e #'ellipsis-depth))
(define/with-syntax bound-ddd (nest-ellipses #'bound depth))
(define/with-syntax tmp-id
(format-id #'here "~a/~a" #'binder₀ (drop-subscripts #'bound)))
(define/with-syntax tmp-str
(datum->syntax #'tmp-id
(symbol->string
(syntax-e
(format-id #'here "~~a/~a" (drop-subscripts #'bound))))))
(define/with-syntax tmp-ddd (nest-ellipses #'tmp-id depth))
(define/with-syntax binder-ddd (nest-ellipses #'binder₀ depth))
;; Draw arrows in DrRacket.
(with-arrows
(define bound-subscripts (extract-subscripts #'bound))
(define binder-subscripts (extract-subscripts #'binder₀))
(define bound-id-str (identifier->string #'bound))
(for ([binder (in-list (syntax->list #'(binder₀ binderᵢ )))])
(define binder-id-str (identifier->string binder))
(record-sub-range-binders! (vector #'bound
(- (string-length bound-id-str)
(string-length bound-subscripts))
(string-length bound-subscripts)
binder
(- (string-length binder-id-str)
(string-length binder-subscripts))
(string-length binder-subscripts))))
#;(define binder0-id-str (identifier->string #'binder0))
#;(record-sub-range-binders! (vector #'bound
(- (string-length bound-id-str)
(string-length subscripts))
(string-length subscripts)
#'binder0
(- (string-length binder0-id-str)
(string-length subscripts))
(string-length subscripts)))
(define/with-syntax temp-derived (generate-temporary #'bound))
(define/with-syntax temp-valvar (generate-temporary #'bound))
(define/with-syntax temp-cached (generate-temporary #'bound))
(define/with-syntax temp-generated (generate-temporary #'bound))
(define/with-syntax temp-id-table (generate-temporary #'bound))
;; HERE: cache the define-temp-ids in the free-id-table, and make sure
;; that we retrieve the cached ones, so that two subtemplate within the same
;; syntax-case or syntax-parse clause use the same derived ids.
;;
;; We mark specially those bindings bound by (derive …) so that they are
;; not seen as original bindings in nested subtemplates (e.g. with an
;; "unsyntax"), otherwise that rule may not hold anymore, e.g.
;; (syntax-parse #'(a b c)
;; [(xᵢ …)
;; (quasisubtemplate (yᵢ …
;; #,(quasisubtemplate zᵢ …) ;; must be from xᵢ, not yᵢ
;; zᵢ …))])
;; the test above is not exactly right (zᵢ will still have the correct
;; binding), but it gives the general idea.
#`(begin
(define-values (temp-generated)
(generate-nested-ids 'ellipsis-depth
(quote-syntax bound)
(quote-syntax binder₀)
(λ (v) (format tmp-str v))
(list (attribute* binder₀)
(attribute* binderᵢ)
)
(list (quote-syntax binder₀)
(quote-syntax binderᵢ)
)
whole-form-id))
(define-values (temp-id-table)
(multi-hash-ref! derived-valvar-cache
(list unique-at-runtime-idᵢ
)))
(define-values (temp-cached)
(free-id-table-ref! temp-id-table
(quote-syntax bound)
temp-generated))
(check-derived-ellipsis-shape ellipsis-depth
temp-generated
temp-id-table
(quote-syntax whole-form-id)
(quote-syntax bound))
(copy-raw-syntax-attribute bound
temp-cached
ellipsis-depth
#f)))) ;; TODO: #t iff the original was #t
(define (check-derived-ellipsis-shape ellipsis-depth
temp-generated
temp-id-table
whole-form-id
bound)
;; Check that all derived pvars for this subscript from all binders
;; have the same shape, i.e. we wouldn't want some elements to be missing
;; (as in ~optional) at some position from one derived pvar, but not from
;; others. This check implies that the original binder used did not
;; introduce new elements compared to the binders used for other derived
;; pvars, e.g:
;; (syntax-parse #'([1 2 3] #f)
;; [({~and {~or (xᵢ ...) #f}} ...)
;; (subtemplate ({?? (yᵢ ...) _} ...)) ;; => ((1/y 2/y 3/y) _)
;; (syntax-case #'([a b c] [d e]) ()
;; ;; introduces elements [d e] which were unknown when yᵢ was
;; ;; generated:
;; [((wᵢ ...) ...)
;; ;; Would give ((a/z b/z c/z) (d/z e/z)), but this is
;; ;; inconsistent with the shape of yᵢ.
;; (subtemplate ({?? (zᵢ ...) _} ...))])])
;; The check must also compare temp-generated, even if it was not
;; assigned to #'bound, so that it also cathes the error if we replace
;; zᵢ with yᵢ in the example above.
(unless ((ellipsis-count/c ellipsis-depth #:same-shape #t)
(cons temp-generated
(free-id-table-map temp-id-table (λ (k v) v))))
;; TODO: For now this will just blow up, a better error message would
;; be nice. Especially saying which one failed.
(raise-syntax-error
'sublist
(format (string-append
"some derived variables do not have the same ellipsis shape\n"
" depth: ~a\n"
" attributes...:\n"
" ~a\n"
" attribute ~a if it were generated here...:\n"
" ~a")
'ellipsis-depth
(string-join (free-id-table-map
temp-id-table
(λ (k v)
(format "~a => ~a"
(syntax-e k)
(syntax->datum
(datum->syntax #f v)))))
"\n ")
'bound
(syntax->datum
(datum->syntax #f temp-generated)))
whole-form-id
bound
(free-id-table-map temp-id-table (λ (k v) k)))))