yera.opaque.function

Function introspection and configuration extraction for opaque callables.

Symbols

def extract_function_config — Extract serializable configuration from a callable.
class FunctionConfig — Extracted configuration for a Python function, used to reconstruct or analyse it.
class ParameterInfo — Metadata describing a single function parameter.
class ParameterKind — Enumeration of supported parameter kinds, mirroring inspect.Parameter.kind.

extract_function_config

extract_function_config(
    func: Callable,
) → FunctionConfig

Extract serializable configuration from a callable.

Parameters

func
type: Callable

Python callable to inspect.

Returns

type: FunctionConfig

Its source body, signature, annotations, and module metadata.

FunctionConfig

Inherits: BaseModel

Extracted configuration for a Python function, used to reconstruct or analyse it.

Fields

content
type: str (required)
name
type: str (required)
parameters
type: list[yera.opaque.function.ParameterInfo] (required)
output_signature
type: str (required)
module_path
type: str | None = None

ParameterInfo

Inherits: BaseModel

Metadata describing a single function parameter.

Fields

name
type: str (required)
type_annotation
type: str (required)
kind
type: yera.opaque.function.ParameterKind (required)
default
type: typing.Any | None = None

Methods

validate_default_for_kind — Validate parameter defaults and warn about mutable defaults.

ParameterInfo.validate_default_for_kind

validate_default_for_kind(
    v: object,
    info: ValidationInfo,
) → object

Validate parameter defaults and warn about mutable defaults.

Parameters

v
type: object

Candidate default value.

info
type: ValidationInfo

Validation context containing the parameter name and kind.

Returns

type: object

The accepted default value unchanged.

Raises

ValueError

If a variadic parameter declares a default value.

ParameterKind

Inherits: StrEnum

Enumeration of supported parameter kinds, mirroring inspect.Parameter.kind.