| |
| """ |
| Formatting utilities for consistently presenting data to the user. |
| """ |
| from typing import Any |
|
|
| def coalesce(*values: Any, default: Any = "") -> Any: |
| """Returns the first non-None value in the provided arguments.""" |
| return next((v for v in values if v is not None), default) |
|
|
| def fmt_bytes(n: int) -> str: |
| """Formats an integer number of bytes into a human-readable string.""" |
| if not isinstance(n, int) or n < 0: |
| return "N/A" |
| if n == 0: |
| return "0 B" |
| units = ["B", "KB", "MB", "GB", "TB"] |
| p = 1024.0 |
| i = 0 |
| val = float(n) |
| while val >= p and i < len(units) - 1: |
| val /= p |
| i += 1 |
| return f"{int(val)} {units[i]}" if i == 0 else f"{val:.2f} {units[i]}" |
|
|
| def fmt_list(title: str, items: list[str]) -> str: |
| """Formats a list of strings into a titled, bulleted list.""" |
| if not items: |
| return f"{title}\n- (vazio)" |
| header = f"{title}\n" |
| body = "\n".join(f"- {item}" for item in items) |
| return header + body |
|
|
| def truncate(text: str, limit: int) -> str: |
| """Truncates a string if it exceeds the specified limit, adding an indicator.""" |
| if not isinstance(text, str) or len(text) <= limit: |
| return text |
| if limit <= 20: |
| return text[:limit] |
| return text[:limit - 15] + "...[truncado]..." |
|
|
