biolm.cli package

Submodules

biolm.cli.entry module

Entry point wrapper to suppress urllib3 warnings.

class biolm.cli.entry.FilteredStderr(original_stderr)

Bases: object

flush()

write(text)

biolm.cli.theme module

Terminal-aware Rich theme for the biolm CLI.

biolm.cli.theme.build_theme(*, dark: bool, plain: bool = False) → Theme

biolm.cli.theme.create_console(*, no_color: bool | None = None, theme_mode: Literal['auto', 'light', 'dark'] | None = None) → Console

Create a Rich Console with terminal-appropriate colors.

biolm.cli.theme.no_color_requested() → bool

True when NO_COLOR is set (https://no-color.org/).

biolm.cli.theme.resolve_theme_mode(explicit: Literal['auto', 'light', 'dark'] | None = None) → Literal['auto', 'light', 'dark']

Resolve theme mode from flag, BIOLM_CLI_THEME env, or auto.

biolm.cli.theme.terminal_is_dark() → bool

Best-effort detection of dark terminal background (xterm COLORFGBG).

Only treats unambiguously light backgrounds as light. Solarized Dark and similar themes often use palette index 8–11 for the background, which is still visually dark but was previously misclassified as light.

Module contents

Console script for biolm.

class biolm.cli.RichCommand(name: str | None, context_settings: MutableMapping[str, Any] | None = None, callback: Callable[[...], Any] | None = None, params: list[click.core.Parameter] | None = None, help: str | None = None, epilog: str | None = None, short_help: str | None = None, options_metavar: str | None = '[OPTIONS]', add_help_option: bool = True, no_args_is_help: bool = False, hidden: bool = False, deprecated: bool | str = False)

Bases: Command

Custom Click Command with Rich help formatting.

format_help(ctx, formatter)

Format help output using Rich with styled organization.

write_usage(ctx, formatter)

Write usage line with Rich formatting.

class biolm.cli.RichGroup(name: str | None = None, commands: MutableMapping[str, Command] | Sequence[Command] | None = None, invoke_without_command: bool = False, no_args_is_help: bool | None = None, subcommand_metavar: str | None = None, chain: bool = False, result_callback: Callable[[...], Any] | None = None, **kwargs: Any)

Bases: Group

Custom Click Group with Rich help formatting.

command_class

alias of RichCommand

format_help(ctx, formatter)

Format help output using Rich with styled organization.

write_usage(ctx, formatter)

Write usage line with Rich formatting.

class biolm.cli.RichHelpFormatter(indent_increment: int = 2, width: int | None = None, max_width: int | None = None)

Bases: HelpFormatter

Custom help formatter using Rich for styled output.

write_dl(rows, col_max=30, col_spacing=2)

Write definition list (command/option + description) with Rich formatting.

write_heading(heading)

Write section heading with Rich formatting.

write_usage(prog, args='', prefix='Usage: ')

Write usage line with Rich formatting.

biolm.cli.display_env_vars_table()

Display environment variables in a formatted Rich table.