Struct GlobalEnv 

pub struct GlobalEnv {
    pub namespaces: RwLock<HashMap<Arc<str>, GcPtr<Namespace>>>,
    pub source_paths: RwLock<Vec<PathBuf>>,
    pub loaded: Mutex<HashSet<Arc<str>>>,
    pub loading: Mutex<HashSet<Arc<str>>>,
    pub builtin_sources: RwLock<HashMap<Arc<str>, &'static str>>,
    pub gc_config: RwLock<Option<Arc<GcConfig>>>,
    pub compiler_ready: Atomic<bool>,
    pub eval_fn: fn(&Form, &mut Env) -> Result<Value, EvalError>,
    pub call_cljrs_fn: fn(&CljxFn, &[Value], &mut Env) -> Result<Value, EvalError>,
    /* private fields */
}

The global mutable store of all namespaces.

Fields

namespaces: RwLock<HashMap<Arc<str>, GcPtr<Namespace>>>

source_paths: RwLock<Vec<PathBuf>>

Directories to search when resolving namespace names to files.

loaded: Mutex<HashSet<Arc<str>>>

Namespaces that have been fully loaded from a file (idempotent guard).

loading: Mutex<HashSet<Arc<str>>>

Namespaces currently being loaded (cycle detection).

builtin_sources: RwLock<HashMap<Arc<str>, &'static str>>

Built-in namespace sources embedded in the binary. Checked by load_ns before falling back to source-path search.

gc_config: RwLock<Option<Arc<GcConfig>>>

GC configuration for automatic collection based on memory pressure.

compiler_ready: Atomic<bool>

True once the Clojure compiler namespaces have been loaded and IR lowering is available. Before this, all functions use tree-walking.

eval_fn: fn(&Form, &mut Env) -> Result<Value, EvalError>

Evaluator function. Evaluates form given env, produces an EvalResult.

call_cljrs_fn: fn(&CljxFn, &[Value], &mut Env) -> Result<Value, EvalError>

Call a cljrs function.

Implementations

impl GlobalEnv

pub fn new( eval_fn: fn(&Form, &mut Env) -> Result<Value, EvalError>, call_cljrs_fn: fn(&CljxFn, &[Value], &mut Env) -> Result<Value, EvalError>, on_fn_defined: Option<fn(&CljxFn, &mut Env)>, ) -> Arc<GlobalEnv>

pub fn set_source_paths(&self, paths: Vec<PathBuf>)

Replace the source path list.

pub fn register_builtin_source(&self, ns: &str, src: &'static str)

Register an embedded namespace source (called by cljrs-stdlib at startup).

pub fn builtin_source(&self, ns: &str) -> Option<&'static str>

Look up an embedded source for a namespace, if one has been registered.

pub fn mark_loaded(&self, ns: &str)

Mark a namespace as fully loaded from a file.

pub fn is_loaded(&self, ns: &str) -> bool

True if the namespace has already been loaded from a file.

pub fn set_gc_config(&self, config: Arc<GcConfig>)

Set the GC configuration for automatic memory pressure management.

pub fn gc_config(&self) -> Option<Arc<GcConfig>>

Get the GC configuration, if one has been set.

pub fn resolve_alias(&self, current_ns: &str, alias: &str) -> Option<Arc<str>>

Resolve a short alias to a full namespace name in current_ns.

pub fn get_or_create_ns(&self, name: &str) -> GcPtr<Namespace>

Return the namespace with this name, creating it if it doesn’t exist.

pub fn intern(&self, ns_name: &str, name: Arc<str>, val: Value) -> GcPtr<Var>

Intern name with val in the given namespace, returning the Var.

pub fn lookup_var(&self, ns_name: &str, sym_name: &str) -> Option<GcPtr<Var>>

Look up a Var in the named namespace (interns only).

pub fn lookup_in_ns(&self, ns_name: &str, sym_name: &str) -> Option<Value>

Look up a value in ns_name: checks interns then refers. Routes through the dynamic binding stack so binding overrides work.

pub fn lookup_var_in_ns( &self, ns_name: &str, sym_name: &str, ) -> Option<GcPtr<Var>>

Look up the raw Var (not its value) in ns_name: interns then refers.

pub fn refer_all(&self, dst_ns: &str, src_ns: &str)

Copy all interns from src_ns into dst_ns as refers.

pub fn refer_named(&self, dst_ns: &str, src_ns: &str, names: &[Arc<str>])

Copy selected interns from src_ns into dst_ns as refers.

pub fn add_alias(&self, current_ns: &str, alias: &str, full_ns: &str)

Register alias → full_ns in current_ns’s alias table.

pub fn eval(&self, form: &Form, env: &mut Env) -> Result<Value, EvalError>

Evaluate form given env.

pub fn call_cljrs_fn( &self, func: &CljxFn, args: &[Value], env: &mut Env, ) -> Result<Value, EvalError>

Call the given cljrs function.

pub fn on_fn_defined(&self, f: &CljxFn, env: &mut Env)

Callback hook for new functions defined.

pub fn set_on_fn_defined(&mut self, hook: fn(&CljxFn, &mut Env))

Sets the on-new-function-defined hook.

Trait Implementations

impl Debug for GlobalEnv

fn fmt(&self, f: &mut Formatter<'_>) -> Result<(), Error>

Formats the value using the given formatter.