pub struct CompiledScript { /* private fields */ }Expand description
An immutable compiled Nybl program, ready to instantiate any number
of NyblInstances without re-parsing or re-compiling.
The artifact owns the validated root chunk (and, transitively, every
nested function body) behind Arc, so Clone is a reference-count
bump and the value is Send + Sync: compile once on any thread, hand
clones to worker threads, and call NyblInstance::from_compiled on
each worker. Instances themselves stay single-threaded (!Send) —
the supported cross-thread pattern is create-on-worker from a shared
artifact.
Self::compile covers the root program only, preserving the legacy
host-resolved module path. Self::compile_with_modules opts into a
closed, immutable graph whose module bytecode is shared as well.
Implementations§
Source§impl CompiledScript
impl CompiledScript
Sourcepub fn compile(source: &str) -> Result<Self, NyblError>
pub fn compile(source: &str) -> Result<Self, NyblError>
Parse, compile, and validate a program without executing it.
No host is needed: top-level statements run later, at
NyblInstance::from_compiled time, once per instance.
Sourcepub fn compile_with_modules<F>(
source: &str,
resolver: F,
) -> Result<Self, NyblError>
pub fn compile_with_modules<F>( source: &str, resolver: F, ) -> Result<Self, NyblError>
Parse, compile, and validate a program plus its complete reachable module graph without executing anything.
resolver has the same result shape as NyblHost::resolve_module:
None means not found, Some(Err(_)) forwards a host-defined error,
and Some(Ok(source)) supplies the module source. Every unique module
path is resolved exactly once, including transitive, diamond, and
cyclic references. Module top-level code remains lazy and executes
with fresh state in each NyblInstance.
Unlike Self::compile, instances from this artifact never ask their
runtime host to resolve module source. Resolver inputs should therefore
include standard-library modules referenced by the program too.