Choose an instance lifetime

_{Beginner. Pick how long things live.}

	Existence	One instance per	Use it for
🟢	`unique`	Process (frame)	Config, pools, caches
🟢	`unique_per_conduit`	Scope	Request / session state
🟢	`many`	Nothing — new every meld	Stateless workers, DTOs
🟡	`unique_per_conduit_lineage`	A scope and its children	Shared context down a tree
🟡	`unique_per_spell_space`	A request-local space	Ephemeral request scoping
🟡	`managed_spell_quantity`	Nothing — leased from a pool the root keeps	Costly objects reused across holders
🟠	`unique_per_conduit_cluster`	A named group of scopes	Cross-scope coordination

The first three are the beginner set — they cover most systems and need nothing but a static conjure. The rest arrive with the need that gives them meaning: lineage and spell spaces once you have nested scopes, managed pools once an object costs more to build than to lend, clusters once conduits link into groups.

For the intermediate leasing and release example, see Managed Spell Quantities.

Callables are always unique. Want a fresh object every time? Bind a class as many.

Runnable examples

Lifecycles unique vs many — Beginner 02
Existence unique — Beginner 13
Existence many — Beginner 14
Existence unique per conduit — Beginner 15
Many state isolation — Beginner 29

All beginner examples · Level contents · Full contents

Canonical page source