ddp_utils.cli

import ddp_utils.cli

Parse command-line input into positional and keyword argument collections.

The helpers accept either sys.argv or an arbitrary command-like string. Tokens shaped as key=value become keyword arguments, while other tokens remain positional. Recognized values are converted to booleans, None, integers, or floats.

Examples

Use this public operation:

from ddp_utils.cli import parse_cli_string

args, kwargs = parse_cli_string("build release=true retries=3")
ddp_utils.cli.argi_parse() → Tuple[List[str], Dict[str, Any]]

Parse sys.argv[1:] into (args, kwargs).

Supported forms:

  • key=value -> kwargs

  • standalone tokens -> args

  • automatic value conversion: bool / None / int / float (best-effort)

Returns

Type

Description

Tuple[List[str], Dict[str, Any]]

(args, kwargs)

Examples

Use this public operation:

result = ddp_utils.cli.argi_parse()
ddp_utils.cli.argi_parse_str(line: str) → Tuple[List[str], Dict[str, Any]]

Parse a CLI-like string into (args, kwargs) using shlex.split.

Parameters

Name

Type

Description

line

str

CLI string, e.g. 'foo=1 bar baz=true'.

Returns

Type

Description

Tuple[List[str], Dict[str, Any]]

(args, kwargs)

Note

  • On parsing errors (unbalanced quotes), returns ([], {}) and logs via stderr_log.

Examples

Use this public operation:

result = ddp_utils.cli.argi_parse_str(line=line_value)