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.
Reflect dependency metadata from callables, constructors, and methods.
| Function | _build |
Categorize explicit parameters after descriptor binding has been applied. |
| Function | _cached |
Return the cached dependency signature for target. |
| Function | _clear |
Invalidate shared signatures and registered derived metadata explicitly. |
| Function | _get |
Return dependency metadata without caching a bound method's receiver. |
| Function | _get |
Return the cached inspect signature for a target. |
| Function | _inspect |
Read annotations while preserving unknown native deferred references. |
| Function | _inspect |
Inspect a signature while preserving unavailable native annotations. |
| Function | _parameter |
Describe one non-variadic parameter using its default or annotation. |
| Function | _register |
Register one dependent cache clearer without retaining reloaded callbacks. |
| Function | _resolve |
Resolve a parameter annotation into its module, name, and type components. |
| Function | _resolve |
Resolve available string annotations in a callable signature. |
| Function | _resolve |
Resolve one string hint independently of other unavailable references. |
| Constant | _ANY |
Any full path used by reflection. |
| Constant | _ANY |
Any type used by reflection. |
| Constant | _SKIP |
Skip kinds used by reflection. |
| Variable | _signature |
Dependent cache clearers keyed by stable consumer identifiers. |
Categorize explicit parameters after descriptor binding has been applied.
| Parameters | |
signature:inspect.Signature | Signature containing only caller-supplied parameters. |
| Returns | |
orionis.introspection.dependencies.entities.signature.Signature | Resolved and unresolved dependencies in declaration order. |
object, *, 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:object | Object whose inspectable signature is resolved into dependencies. |
bound:bool, optional | Whether the first positional parameter is supplied by method binding. |
| Returns | |
orionis.introspection.dependencies.entities.signature.Signature | Dependency signature built from the target's inspectable signature. |
| Raises | |
ValueError | Raised when the target signature cannot be inspected. |
Return dependency metadata without caching a bound method's receiver.
| Parameters | |
target:object | Callable whose parameters are inspected. |
| Returns | |
orionis.introspection.dependencies.entities.signature.Signature | Shared metadata keyed by the underlying function and binding mode. |
object) -> inspect.Signature:
(source)
¶
Return the cached inspect signature for a target.
| Parameters | |
target:object | Callable, method, function, or class to inspect. |
| Returns | |
inspect.Signature | Cached signature object for the provided target. |
Inspect a signature while preserving unavailable native annotations.
| Parameters | |
target:object | Callable, method, function, or class to inspect. |
| Returns | |
inspect.Signature | Runtime values where available, with ForwardRef values for unknown names. |
Describe one non-variadic parameter using its default or annotation.
| Parameters | |
parameter:inspect.Parameter | Explicit parameter whose dependency metadata is required. |
| Returns | |
orionis.introspection.dependencies.entities.argument.Argument | Resolution metadata preserving the parameter's declared name and kind. |
Register one dependent cache clearer without retaining reloaded callbacks.
| Parameters | |
key:str | Stable identifier of the internal cache consumer. |
callback:collections.abc.Callable[[], None] | Function clearing that consumer's derived metadata. |
| Returns | |
None | No return value. |
Resolve a parameter annotation into its module, name, and type components.
| Parameters | |
annotation:object | The annotation object from an inspect.Parameter. May be a string (forward reference) or an actual type/class. |
| Returns | |
tuple[str, str, object] | 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). |
object, signature: inspect.Signature) -> inspect.Signature:
(source)
¶
Resolve available string annotations in a callable signature.
| Parameters | |
target:object | 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. |
Resolve one string hint independently of other unavailable references.
| Parameters | |
annotation:str | Parameter annotation requiring evaluation. |
globalns:dict[str, typing.Any] | Namespace of the callable's defining module. |
| Returns | |
object | Resolved annotation, or None if the reference cannot be evaluated. |
Skip kinds used by reflection.
| Value |
|