yera.config.schema.profiles

Yera profile schemas: top-level environment context.

Symbols

class Profile — A Yera profile — one named environment context.
class ProfileModelDefaults — Yera profile model default values.
class ProfileProviderConnections — Yera profile provider connection config.
class Profiles — Yera profiles config loaded from ``yera.toml``.

Profile

Inherits: BaseModel

A Yera profile — one named environment context.

Ties together a set of provider connections and optional model defaults. The active profile is resolved via CLI --profile flag → pyproject.toml → yera.toml default.

Attributes

description
type: str | None

Optional human-readable description of this profile, e.g. "Work AWS account with EU endpoints".

providers
type: ProfileProviderConnections

Map of provider type to connection name, e.g. {"aws": "work", "ollama": "local"}. Only providers needed by this profile need to be listed.

model_defaults
type: ProfileModelDefaults

Map of model type to default model id, e.g. {"llm": "aws.meta.llama3"}. Optional — missing defaults are a runtime error when a default is actually needed.

ProfileModelDefaults

Inherits: BaseModel

Yera profile model default values.

ProfileProviderConnections

Inherits: BaseModel

Yera profile provider connection config.

Methods

empty — Check if none of the profile's provider connections are configured.

ProfileProviderConnections.empty

empty() → bool

Check if none of the profile's provider connections are configured.

Returns

type: bool

True if none of the profile's provider connections are configured,

Profiles

Inherits: BaseModel

Yera profiles config loaded from yera.toml.

Attributes

default
type: str | None

Name of the profile to use when no override is set. Required — setup creates a default profile automatically.

profiles
type: dict[str, Profile]

Named Yera profiles, keyed by profile name.

Raises

ValueError

If default is not a key in profiles.

Methods

default_profile_exists — Check that the default profile name exists in profiles.

Profiles.default_profile_exists

default_profile_exists() → Profiles

Check that the default profile name exists in profiles.

Raises

ValueError

If default is not a key in profiles.