orionis.introspection.dependencies.reflection

THE ORIONIS API

Build with clarity.

Explore the building blocks of an async-first Python framework. Every module, class, and method — connected, searchable, and ready to build with.

Explore modules View classes

module documentation

(source)

Undocumented

Function	`_build_dependencies`	Categorize signature parameters as resolved or unresolved dependencies.
Function	`_cached_resolved_signature`	Return the cached dependency signature for `target`.
Function	`_get_resolved_signature`	Return dependency metadata without caching a bound method's receiver.
Function	`_get_signature`	Return the cached inspect signature for a target.
Function	`_resolve_annotation`	Resolve a parameter annotation into its module, name, and type components.
Function	`_resolve_future_annotations`	Resolve available string annotations in a callable signature.
Function	`_resolve_parameter_hint`	Resolve one string hint independently of other unavailable references.
Constant	`_ANY_FULL_PATH`	Undocumented
Constant	`_ANY_TYPE`	Undocumented
Constant	`_SKIP_KINDS`	Undocumented
Constant	`_SKIP_NAMES`	Undocumented

def _build_dependencies(signature: inspect.Signature) -> Signature: (source) ¶

Categorize signature parameters as resolved or unresolved dependencies.

Parameters
signature:`inspect.Signature`	The signature object to analyze.

Returns
`Signature`	An object containing categorized resolved and unresolved parameter dependencies.

@functools.lru_cache(maxsize=1024)

def _cached_resolved_signature(target: Any, *, bound: bool = False) -> Signature: (source) ¶

Return the cached dependency signature for target.

Notes

Cached exceptions are not stored by functools.lru_cache, so failures are raised again on subsequent calls.

Parameters
target:`Any`	Object whose inspectable signature is resolved into dependencies.
bound:`bool, optional`	Whether the first positional parameter is supplied by method binding.

Returns
`Signature`	Dependency signature built from the target's inspectable signature.

Raises
`ValueError`	Raised when the target signature cannot be inspected.

def _get_resolved_signature(target: Any) -> Signature: (source) ¶

Return dependency metadata without caching a bound method's receiver.

Parameters
target:`Any`	Callable whose parameters are inspected.

Returns
`Signature`	Shared metadata keyed by the underlying function and binding mode.

@functools.lru_cache(maxsize=1024)

def _get_signature(target: Any) -> inspect.Signature: (source) ¶

Return the cached inspect signature for a target.

Parameters
target:`Any`	Callable, method, function, or class to inspect.

Returns
`inspect.Signature`	Cached signature object for the provided target.

def _resolve_annotation(annotation: Any) -> tuple[str, str, Any]: (source) ¶

Resolve a parameter annotation into its module, name, and type components.

Parameters
annotation:`Any`	The annotation object from an `inspect.Parameter`. May be a string (forward reference) or an actual type/class.

Returns
`tuple[str, str, Any]`	A three-element tuple `(module_name, class_name, type_or_annotation)` where `module_name` and `class_name` identify the annotation's origin, and `type_or_annotation` is the resolved type (or `str` for forward references).

def _resolve_future_annotations(target: Any, signature: inspect.Signature) -> inspect.Signature: (source) ¶

Resolve available string annotations in a callable signature.

Parameters
target:`Any`	Callable declaring the annotations.
signature:`inspect.Signature`	Signature whose parameters may contain string annotations.

Returns
`inspect.Signature`	Signature with available types substituted and defaults preserved.

def _resolve_parameter_hint(annotation: str, globalns: dict[str, Any]) -> object: (source) ¶

Resolve one string hint independently of other unavailable references.

Parameters
annotation:`str`	Parameter annotation requiring evaluation.
globalns:`dict[str, Any]`	Namespace of the callable's defining module.

Returns
`object`	Resolved annotation, or None if the reference cannot be evaluated.

_ANY_FULL_PATH: str = (source) ¶

Undocumented

Value

f'{_ANY_MODULE}.{_ANY_NAME}'

_ANY_TYPE: type = (source) ¶

Undocumented

Value

type(Any)

_SKIP_KINDS: frozenset[int] = (source) ¶

Undocumented

Value

frozenset(set([inspect.Parameter.VAR_POSITIONAL, inspect.Parameter.VAR_KEYWORD])↵
)

_SKIP_NAMES: frozenset[str] = (source) ¶

Undocumented

Value

frozenset(set(['self', 'cls']))