Source code for hed.models.model_constants

"""Defined constants for definitions, def labels, and expanded labels."""

from enum import IntEnum

# The whitespace that may not begin or end a column name or a top-level sidecar key (specification 3.2.10):
# blank, tab, line feed and carriage return only. A non-breaking space is not padding.
NAME_WHITESPACE = " \t\n\r"




class TopTagReturnType(IntEnum):
    """Return-type selector for :meth:`~hed.models.HedString.find_top_level_tags`.

    Pass one of these constants as the ``include_groups`` argument to control
    whether the method returns anchor tags, containing groups, or (tag, group) pairs.

    Attributes:
        TAGS: Return only the anchor :class:`~hed.models.HedTag` objects.
        GROUPS: Return only the :class:`~hed.models.HedGroup` objects that contain each anchor tag.
        BOTH: Return ``(tag, group)`` tuples pairing each anchor tag with its containing group.
    """

    TAGS = 0
    GROUPS = 1
    BOTH = 2





class DefTagNames:
    """Source names for definitions, def labels, and expanded labels."""

    DEF_KEY = "Def"
    DEF_EXPAND_KEY = "Def-expand"
    DEFINITION_KEY = "Definition"

    ONSET_KEY = "Onset"
    OFFSET_KEY = "Offset"
    INSET_KEY = "Inset"
    DURATION_KEY = "Duration"
    DELAY_KEY = "Delay"

    TEMPORAL_KEYS = {ONSET_KEY, OFFSET_KEY, INSET_KEY}
    DURATION_KEYS = {DURATION_KEY, DELAY_KEY}

    ALL_TIME_KEYS = TEMPORAL_KEYS.union(DURATION_KEYS)
    TIMELINE_KEYS = {ONSET_KEY, OFFSET_KEY, INSET_KEY, DELAY_KEY}