class Di::Scope

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).

Included Modules

Defined in:

di/scope.cr

Constructors

Instance Method Summary

Instance methods inherited from module Di::KeyParser

interface_prefix(interface_type : String) : String interface_prefix, key(type : String, impl : String | Nil = nil, name : String | Nil = nil) : String key, parse_key(key : String) : Tuple(String, String | Nil) parse_key, resolve_ambiguous(matches : Array(Provider::Base), interface_type : String, name : String) : Provider::Base resolve_ambiguous, resolve_ambiguous?(matches : Array(Provider::Base), interface_type : String) : Provider::Base | Nil resolve_ambiguous?

Constructor Detail

def self.new(name : Symbol, parent : Scope | Nil = nil, fallback_registry : Registry | Nil = nil) #

[View source]

Instance Method Detail

def clear : Nil #

Clear local providers only (does not affect parent).


[View source]
def count_implementations(interface_type : String) : Int32 #

Count implementations for an interface type across scope chain.


[View source]
def delete(key : String) : Nil #

Remove a provider by key (used for rollback on partial registration failure).


[View source]
def each(& : String, Provider::Base -> ) #

Iterate over local providers only.


[View source]
def fallback_registry : Registry | Nil #

[View source]
def find_all_by_name(interface_type : String, name : String) : Array(Provider::Base) #

Find all named interface providers matching ~Type:Impl:name across scope chain. Child shadows parent by ALIAS NAME, not by full key.


[View source]
def find_all_by_name_keyed(interface_type : String, name : String) : Hash(String, Provider::Base) #

Find all named interface providers keyed for deduplication in child scopes.


[View source]
def find_by_name(interface_type : String, name : String) : Provider::Base #

Find a named interface provider, raising on ambiguity or not found.


[View source]
def get(key : String) : Provider::Base #

Get a provider by key, raising ServiceNotFound if not in scope chain.


[View source]
def get?(key : String) : Provider::Base | Nil #

Get a provider by key, checking parent scope then fallback registry.


[View source]
def get_all(interface_type : String) : Array(Provider::Base) #

Get all providers for an interface type across scope chain. Child shadows parent by IMPL KEY (Type:Impl segment).


[View source]
def get_all_keyed(interface_type : String) : Hash(String, Provider::Base) #

Get all providers keyed by full key for deduplication in child scopes.


[View source]
def implementation_names(interface_type : String) : Array(String) #

Get implementation names for an interface type across scope chain.


[View source]
def local?(key : String) : Bool #

Check if a provider is registered locally in this scope only.


[View source]
def name : Symbol #

[View source]
def order : Array(String) #

Return keys in registration order for this scope only.


[View source]
def parent : Scope | Nil #

[View source]
def register(key : String, provider : Provider::Base) : Nil #

Register a provider with the given key. Raises AlreadyRegistered if the key already exists in this scope.


[View source]
def registered?(key : String) : Bool #

Check if a provider is registered in this scope, parent, or fallback registry.


[View source]
def reverse_order : Array(String) #

Return keys in reverse order for shutdown (this scope only).


[View source]
def size : Int32 #

Number of local providers.


[View source]
def snapshot : Hash(String, Provider::Base) #

Return a snapshot of local providers for iteration without holding mutex.


[View source]