module Di::KeyParser

Overview

Shared key parsing utilities for Registry and Scope. Handles Crystal namespaced types (e.g. "NS::C:name") correctly.

Key format:

• "Type" → default concrete registration
• "Type:name" → named concrete registration
• "~Type:Impl" → interface binding (unnamed)
• "~Type:Impl:name" → interface binding (named)

The "~" prefix ensures interface bindings don't leak into concrete resolution.

Direct including types

• Di::Registry
• Di::Scope

Defined in:

di/key_parser.cr

Constant Summary

INTERFACE_PREFIX = "~"

Marker prefix for interface binding keys.

Instance Method Summary

• #interface_prefix(interface_type : String) : String

  Build interface lookup prefix for scanning.

• #key(type : String, impl : String | Nil = nil, name : String | Nil = nil) : String

  Build a registry key from segments joined by ':'.

• #parse_key(key : String) : Tuple(String, String | Nil)

  Parse a registry key into (type_name, service_name) tuple.

• #resolve_ambiguous(matches : Array(Provider::Base), interface_type : String, name : String) : Provider::Base

  Check for ambiguous named matches and return single provider or raise.

• #resolve_ambiguous?(matches : Array(Provider::Base), interface_type : String) : Provider::Base | Nil

  Like resolve_ambiguous, but returns nil instead of raising ServiceNotFound.

Instance Method Detail