class
Di::Scope
- Di::Scope
- Reference
- Object
Overview
A scope provides isolated provider registration with parent inheritance. Child scopes shadow parent providers without modifying them. Thread-safe for multi-threaded Crystal (-Dpreview_mt).
Defined in:
di/scope.crConstructors
Instance Method Summary
-
#clear : Nil
Clear local providers only (does not affect parent).
-
#each(& : String, Provider::Base -> )
Iterate over local providers only.
- #fallback_registry : Registry | Nil
-
#get(key : String) : Provider::Base
Get a provider by key, raising ServiceNotFound if not in scope chain.
-
#get?(key : String) : Provider::Base | Nil
Get a provider by key, checking parent scope then fallback registry.
-
#local?(key : String) : Bool
Check if a provider is registered locally in this scope only.
- #name : Symbol
-
#order : Array(String)
Return keys in registration order for this scope only.
- #parent : Scope | Nil
-
#register(key : String, provider : Provider::Base) : Nil
Register a provider with the given key.
-
#registered?(key : String) : Bool
Check if a provider is registered in this scope, parent, or fallback registry.
-
#reverse_order : Array(String)
Return keys in reverse order for shutdown (this scope only).
-
#size : Int32
Number of local providers.
-
#snapshot : Hash(String, Provider::Base)
Return a snapshot of local providers for iteration without holding mutex.
Constructor Detail
Instance Method Detail
Iterate over local providers only. Note: Holds mutex for the duration of iteration.
Get a provider by key, raising ServiceNotFound if not in scope chain.
Get a provider by key, checking parent scope then fallback registry.
Register a provider with the given key. Raises AlreadyRegistered if the key already exists in this scope.
Check if a provider is registered in this scope, parent, or fallback registry.
Return a snapshot of local providers for iteration without holding mutex. Use this when callbacks may call back into Di (e.g., health checks).