valska.external_tools.bayeseor.cli_sweep

CLI entrypoint for preparing and optionally submitting BayesEoR sweeps.

Functions

build_parser()	Build the CLI argument parser for valska-bayeseor-sweep.
main([argv])	CLI entrypoint for valska-bayeseor-sweep.

valska.external_tools.bayeseor.cli_sweep._build_rerunnable_sweep_cmd(*, beam_model: str, sky_model: str, data_arg: Path, run_id: str, perturb_parameter: Literal['fwhm_deg', 'antenna_diameter'], fwhm_fracs: list[float] | None, fwhm_fracs_file: Path | None, antenna_diameter_fracs: list[float] | None, antenna_diameter_fracs_file: Path | None, template_arg: str | None, variant: str | None, results_root_arg: Path | None, bayeseor_repo_arg: Path | None, conda_sh_arg: str | None, conda_env_arg: str | None, overrides: list[str], unique: bool, hypothesis: str, depend_afterok: str | None, sbatch_exe: str | None, submit_dry_run: bool, force: bool, resubmit: bool, submit_stage: Literal['none', 'cpu', 'gpu', 'all']) → str

Construct a copy/paste-ready valska-bayeseor-sweep command that mirrors user args. We intentionally only include flags that are relevant and were explicitly specified (or are needed to re-run in the same environment).

valska.external_tools.bayeseor.cli_sweep._derive_variant_from_template_path(template_yaml: Path) → str

Derive a variant key from a template filename.

valska.external_tools.bayeseor.cli_sweep._parse_beam_sky(*, beam: str | None, sky: str | None, scenario: str | None) → tuple[str, str, str]

Preferred: –beam and –sky.

Deprecated: –scenario in the form ‘<beam>/<sky>’ or ‘<beam>__<sky>’.

Returns (beam_model, sky_model, source_tag) where source_tag is one of:

• “CLI(–beam/–sky)”

• “DEPRECATED(–scenario)”

valska.external_tools.bayeseor.cli_sweep._parse_fracs(vals: list[str], *, label: str) → list[float]

Parse a list of strings into float perturbation values.

valska.external_tools.bayeseor.cli_sweep._parse_fracs_file(path: Path, *, label: str) → list[float]

Parse a text file containing one float per line.

Supports: - blank lines - comments starting with ‘#’

valska.external_tools.bayeseor.cli_sweep._parse_overrides(kvs: list[str]) → dict[str, str]

Parse KEY=VALUE override arguments into a dict.

valska.external_tools.bayeseor.cli_sweep._print_submit_results(submit_results: Any) → None

Pretty-print submit results from sweep_res.submit_results.

Expected shapes:

• list[dict] with keys like: run_dir, commands (list[str]), error (str), jobs (dict)

• anything else: printed via json for debugging

valska.external_tools.bayeseor.cli_sweep._shell_quote(s: str) → str

Conservative shell quoting for printing copy/paste-ready commands. Uses single quotes and escapes embedded single quotes safely.

Example:

abc’d -> ‘abc’”’“‘d’

valska.external_tools.bayeseor.cli_sweep.build_parser() → ArgumentParser

Build the CLI argument parser for valska-bayeseor-sweep.

valska.external_tools.bayeseor.cli_sweep.main(argv: list[str] | None = None) → int

CLI entrypoint for valska-bayeseor-sweep.