l0.DependencyControl.Finalizer¶

MoonScriptLua

Finalizer = require "l0.DependencyControl.Finalizer"

local Finalizer = require("l0.DependencyControl.Finalizer")

Finalizer ¶

Runs a cleanup action when a value is garbage-collected — a last-resort release for OS handles, locks, and the like when a caller forgets to release explicitly.

Class methods¶

create ¶

MoonScriptLua

Finalizer.create cleanup

Finalizer.create(cleanup)

Creates a finalizer that runs the given cleanup once, when it is collected. Store it on the object whose lifetime should trigger the cleanup. The cleanup must capture the resources it frees, not the owning object — capturing the owner keeps it reachable, so the finalizer never runs.

param	type	description
cleanup	`fun()`	Runs once when the finalizer is collected; its errors are swallowed.

Returns:

finalizer userdata — An opaque value to anchor; it exposes no usable fields.

guard ¶

MoonScriptLua

Finalizer.guard anchor, cleanup

Finalizer.guard(anchor, cleanup)

Creates a finalizer and pins it to the anchor under a private key, so the cleanup runs when the anchor is collected. Pass an instance to release its resources on GC, or a class to tie the cleanup to the module's lifetime. The cleanup must capture the resources it frees, not the anchor.

param	type	description
anchor	`table`	The instance or class whose collection triggers the cleanup.
cleanup	`fun()`	Runs once when the anchor is collected; its errors are swallowed.

Returns:

anchor table — The same anchor, for chaining.