#lang scribble/manual
@(require scribble/eval
          "utils.rkt"
          (for-label racket/base
                     racket/runtime-path
                     unstable/lazy-require))

@title[#:tag "lazy-require"]{Lazy Require}

@defmodule[unstable/lazy-require]

@unstable[@author+email["Ryan Culpepper" "ryanc@racket-lang.org"]]

@defform/subs[#:literals (unquote)
              (lazy-require [mod (imported-fun-id ...)] ...)
              ([mod module-path
                   (unquote module-path-expr)])
              #:contracts ([module-path-expr module-path?])]{

Defines each @racket[imported-fun-id] as a function that, when called,
dynamically requires the export named @racket['imported-fun-id] from
the module specified by @racket[mod] and calls it with the same
arguments.

The module @racket[mod] can be specified as a @racket[_module-path]
(see @racket[require]) or as an @racket[unquote]-escaped expression
that computes a module path. As with
@racket[define-runtime-module-path-index], a @racket[module-path-expr]
is evaluated both in phase 0 and phase 1.
}