Yera Set

The set command writes individual configuration values to yera.toml or pyproject.toml. Use it for non-interactive config changes: setting a named hub as the default, pointing a project at a credential group, activating a profile, or writing a settings field. Most subcommands accept a --project flag to write the value into the project-local pyproject.toml rather than the shared yera.toml.

yera set

Set config entries and Yera object data.

yera set setting

Write a setting value to yera.toml or pyproject.toml.

Args:
    setting_name: Settings field name to write.
    value: Literal value to store (e.g. a number, ``true``/``false``, or
        text). For ``log_level``, use a standard logging level name such as
        ``DEBUG`` or ``INFO``.
    project: If true, write under ``pyproject.toml`` ``[tool.yera]``;
        otherwise write under ``yera.toml`` ``[settings]``.

yera set setting SETTING_NAME VALUE [--project]

Arguments

SETTING_NAME
type: str (required)

Settings field name: one of enable_telemetry, log_level, max_retries, timeout_seconds.

VALUE
type: str (required)

Literal value to store (e.g. a number, true/false, or text). For log_level, use a standard logging level name such as DEBUG or INFO.

Options

--project
type: bool = False

If true, write under pyproject.toml [tool.yera]; otherwise write under yera.toml [settings].

yera set hub

Set the default hub name.

Args:
    hub_name: Name of a hub that already exists in ``yera.toml``. Hub URLs
        are not defined in ``pyproject.toml`` — only the default name is set.
    project: If true, write the project-level ``hub`` key in ``pyproject.toml``
        ``[tool.yera]``; otherwise write ``[hubs] default`` in ``yera.toml``.

yera set hub HUB_NAME [--project]

Arguments

HUB_NAME
type: str (required)

Name of a hub that already exists in yera.toml. Hub URLs are not defined in pyproject.toml — only the default name is set.

Options

--project
type: bool = False

If true, write the project-level hub key in pyproject.toml [tool.yera]; otherwise write [hubs] default in yera.toml.

yera set cred-group

Set [tool.yera.overrides] cred-group in pyproject.toml.

Non-interactive: does not touch credentials.json or authorised_roots.

Args:
    name: Credential group name to write under ``[tool.yera.overrides]``.

yera set cred-group NAME

Arguments

NAME
type: str (required)

Credential group name to write under [tool.yera.overrides].

yera set profile

Set the active Yera profile.

Args:
    profile_name: Name of a Yera profile that already exists in ``yera.toml``.
    project: If true, write the project-level profile override in
        ``pyproject.toml`` ``[tool.yera.profiles]``; otherwise write
        ``[profiles] default`` in ``yera.toml``.

yera set profile PROFILE_NAME [--project]

Arguments

PROFILE_NAME
type: str (required)

Yera profile name to set as active.

Options

--project
type: bool = False

If true, write the project-level profile override in pyproject.toml [tool.yera.profiles]; otherwise write [profiles] default in yera.toml.