Method _format_label

xtop/core/navigation.py:213–258

Return a human-readable label for the provided column name.

(cls, column: str)

    @classmethod
    def _format_label(cls, column: str) -> str:
        """Return a human-readable label for the provided column name."""
        if column is None:
            return ""

        raw = str(column).strip()
        if not raw:
            return raw

        key = raw.lower()

        override = cls._LABEL_OVERRIDES.get(key)
        if override:
            return override

        if "." in key:
            prefix, suffix = key.split(".", 1)
            prefix_display = cls._PREFIX_DISPLAY.get(prefix, prefix.upper())

            suffix_label = cls._LATENCY_SUFFIX_LABELS.get(suffix)
            if suffix_label:
                return f"{prefix_display} {suffix_label}"

            parts = suffix.split("_")
            words = []
            unit: Optional[str] = None

            for part in parts:
                if part in cls._UNIT_SUFFIXES:
                    unit = cls._UNIT_SUFFIXES[part]
                    continue

                if part.isalpha():
                    words.append(part.capitalize())
                else:
                    words.append(part.upper())

            if words and unit:
                return f"{prefix_display} {' '.join(words)} ({unit})"
            if words:
                return f"{prefix_display} {' '.join(words)}"
            if unit:
                return f"{prefix_display} ({unit})"
            return prefix_display

        return raw
    
    def reset(self, group_cols: Optional[List[str]] = None):
        """Reset navigation to initial state"""