ExecutableCache

Construct an empty cache with the default LRU cap (32 entries). Use set_max_entries to override before inserting.

Destructor — releases every cached CompiledExecutable via destroy_executable before the map is torn down.

Process-global session cache. First call honours the LUCID_COMPILE_MAX_CACHE environment variable (positive integer). Subsequent calls return the same instance.

Release every stored executable.

Look up an executable.

Returns the borrowed pointer on hit (and bumps the entry to most-recent in the LRU order) or nullptr on miss.

Insert exec under key, taking ownership. Replaces any existing entry (releasing the previous executable). If the resulting size exceeds max_entries, evicts least-recently used entries until back at capacity.

Override the LRU cap. Honoured by subsequent inserts; existing entries are not evicted retroactively. Default is 32.

Number of currently-cached entries.