Layouts

A layout controls how help output is rendered.

from interfacy import Interfacy
from interfacy.appearance import ClapLayout

Interfacy(help_layout=ClapLayout()).run(main)

The command behavior does not change. Only the help presentation changes.

Built-in layouts

• InterfacyLayout

• StandardLayout

• ArgparseLayout

• Aligned

• AlignedTyped

• Modern

• ClapLayout

from interfacy.appearance import Aligned, Modern, StandardLayout

Interfacy(help_layout=Aligned()).run(main)
Interfacy(help_layout=Modern()).run(main)
Interfacy(help_layout=StandardLayout()).run(main)

Layout settings

Layouts expose formatting options as constructor keyword arguments.

from interfacy.appearance import Aligned

layout = Aligned(
    help_position=32,
    command_indent=4,
    command_group_spacing=1,
)

Interfacy(help_layout=layout).run(main)

Common settings include:

• help_position for the description column

• command_indent for command rows

• command_group_spacing for grouped command sections

• help_option_sort_default for option order

• help_subcommand_sort_default for command order

Parser-level override

Interfacy(help_position=...) can override the layout’s help column for one parser.

Interfacy(
    help_layout=Aligned(),
    help_position=36,
).run(main)

This sets one column width without creating a custom layout subclass.

API reference

See Appearance for the full layout API.