pyTooling.CLIAbstraction.OptionalValuedFlag

Todo

Write module documentation.

Classes

• OptionalValuedFlag: Class and base-class for all OptionalValuedFlag classes, which represents a flag argument with data.

• ShortOptionalValuedFlag: Represents a OptionalValuedFlag with a single dash.

• LongOptionalValuedFlag: Represents a OptionalValuedFlag with a double dash.

• WindowsOptionalValuedFlag: Represents a OptionalValuedFlag with a single slash.

---

Classes

class pyTooling.CLIAbstraction.OptionalValuedFlag.OptionalValuedFlag

Class and base-class for all OptionalValuedFlag classes, which represents a flag argument with data.

An optional valued flag is a flag name followed by a value. The default delimiter sign is equal (=). Name and value are passed as one argument to the executable even if the delimiter sign is a whitespace character. If the value is None, no delimiter sign and value is passed.

Example: width=100

Inheritance

static __new__(cls, *args, **kwargs)

Parameters:

• args (Any)

• kwargs (Any)

__init__(value=None)

Parameters:

value (str | None)

Return type:

None

property Value: str | None

Get the internal value.

Returns:

Internal value.

AsArgument()

Convert this argument instance to a string representation with proper escaping using the matching pattern based on the internal name and optional value.

Return type:

Union[str, Iterable[str]]

Returns:

Formatted argument.

Raises:

ValueError – If internal name is None.

__str__()

Return a string representation of this argument instance.

Return type:

str

Returns:

Argument formatted and enclosed in double quotes.

__repr__()

Return a string representation of this argument instance.

Return type:

str

Returns:

Argument formatted and enclosed in double quotes.

property Name: str

Get the internal name.

Returns:

Internal name.

class pyTooling.CLIAbstraction.OptionalValuedFlag.ShortOptionalValuedFlag

Represents a OptionalValuedFlag with a single dash.

Example: -optimizer=on

Inheritance

static __new__(cls, *args, **kwargs)

Parameters:

• args (Any)

• kwargs (Any)

AsArgument()

Convert this argument instance to a string representation with proper escaping using the matching pattern based on the internal name and optional value.

Return type:

Union[str, Iterable[str]]

Returns:

Formatted argument.

Raises:

ValueError – If internal name is None.

property Name: str

Get the internal name.

Returns:

Internal name.

property Value: str | None

Get the internal value.

Returns:

Internal value.

__init__(value=None)

Parameters:

value (str | None)

Return type:

None

__repr__()

Return a string representation of this argument instance.

Return type:

str

Returns:

Argument formatted and enclosed in double quotes.

__str__()

Return a string representation of this argument instance.

Return type:

str

Returns:

Argument formatted and enclosed in double quotes.

class pyTooling.CLIAbstraction.OptionalValuedFlag.LongOptionalValuedFlag

Represents a OptionalValuedFlag with a double dash.

Example: --optimizer=on

Inheritance

static __new__(cls, *args, **kwargs)

Parameters:

• args (Any)

• kwargs (Any)

AsArgument()

Convert this argument instance to a string representation with proper escaping using the matching pattern based on the internal name and optional value.

Return type:

Union[str, Iterable[str]]

Returns:

Formatted argument.

Raises:

ValueError – If internal name is None.

property Name: str

Get the internal name.

Returns:

Internal name.

property Value: str | None

Get the internal value.

Returns:

Internal value.

__init__(value=None)

Parameters:

value (str | None)

Return type:

None

__repr__()

Return a string representation of this argument instance.

Return type:

str

Returns:

Argument formatted and enclosed in double quotes.

__str__()

Return a string representation of this argument instance.

Return type:

str

Returns:

Argument formatted and enclosed in double quotes.

class pyTooling.CLIAbstraction.OptionalValuedFlag.WindowsOptionalValuedFlag

Represents a OptionalValuedFlag with a single slash.

Example: /optimizer:on

Inheritance

AsArgument()

Convert this argument instance to a string representation with proper escaping using the matching pattern based on the internal name and optional value.

Return type:

Union[str, Iterable[str]]

Returns:

Formatted argument.

Raises:

ValueError – If internal name is None.

property Name: str

Get the internal name.

Returns:

Internal name.

property Value: str | None

Get the internal value.

Returns:

Internal value.

__init__(value=None)

Parameters:

value (str | None)

Return type:

None

static __new__(cls, *args, **kwargs)

Parameters:

• args (Any)

• kwargs (Any)

__repr__()

Return a string representation of this argument instance.

Return type:

str

Returns:

Argument formatted and enclosed in double quotes.

__str__()

Return a string representation of this argument instance.

Return type:

str

Returns:

Argument formatted and enclosed in double quotes.