topmark.toml.enums

topmark / toml / enums

Enums for TopMark TOML export and rendering helpers.

This module contains small enums that influence how TopMark TOML documents or TOML tables are serialized for export, debugging, or copy/paste-friendly CLI output.

FilesSerializationMode

Bases: str, Enum

How to serialize the [files] section when exporting configuration.

Modes

REBASED: Emit flattened lists that are meaningful from the current working directory (CWD), e.g. [files].include_patterns, [files].exclude_patterns, and *_from path lists. This is the default "as seen from here" view used for copy/paste friendly dumps.

ORIGIN: Emit provenance-oriented structured tables that retain each declaring base directory, e.g. [[files.*_pattern_groups]] and [[files.*_from_sources]]. In this mode, the flattened lists are omitted.