stundu 0.3.0__py3-none-any.whl

cli/__init__.py

@@ -0,0 +1,36 @@
+# CLI infrastructure module - configuration and i18n
+from .config import (
+    get_config_path,
+    get_config_dir,
+    config_exists,
+    is_first_run,
+    load_config,
+    save_config,
+    get_config_value,
+    get_data_file,
+    ENV_CONFIG_FILE,
+    ENV_DATA_FILE,
+    DEFAULT_CONFIG_DIR,
+    DEFAULT_CONFIG_FILE,
+    DEFAULT_DATA_FILE,
+)
+from .i18n_setup import setup_i18n, t, get_locale
+
+__all__ = [
+    "get_config_path",
+    "get_config_dir",
+    "config_exists",
+    "is_first_run",
+    "load_config",
+    "save_config",
+    "get_config_value",
+    "get_data_file",
+    "ENV_CONFIG_FILE",
+    "ENV_DATA_FILE",
+    "DEFAULT_CONFIG_DIR",
+    "DEFAULT_CONFIG_FILE",
+    "DEFAULT_DATA_FILE",
+    "setup_i18n",
+    "t",
+    "get_locale",
+]

cli/config.py

@@ -0,0 +1,182 @@
+"""Configuration management for stundu CLI."""
+
+import os
+import json
+from pathlib import Path
+from typing import Optional, Any
+
+# Environment variable names
+ENV_CONFIG_FILE = "STUNDU_CONFIG"
+ENV_DATA_FILE = "STUNDU_DATA"
+
+# Default config location
+DEFAULT_CONFIG_DIR = Path.home() / ".config" / "stundu"
+DEFAULT_CONFIG_FILE = "config.json"
+DEFAULT_DATA_FILE = "stundu_data.csv"
+
+
+def get_config_path() -> Path:
+    """Get the path to the config file.
+
+    Precedence: STUNDU_CONFIG env var > snap user dir > default location
+    """
+    env_path = os.environ.get(ENV_CONFIG_FILE)
+    if env_path:
+        return Path(env_path)
+    snap_common = os.environ.get("SNAP_USER_COMMON")
+    if snap_common:
+        return Path(snap_common) / DEFAULT_CONFIG_FILE
+    return DEFAULT_CONFIG_DIR / DEFAULT_CONFIG_FILE
+
+
+def get_config_dir() -> Path:
+    """Get the path to the config directory."""
+    return get_config_path().parent
+
+
+def config_exists() -> bool:
+    """Check if a config file exists."""
+    return get_config_path().exists()
+
+
+def is_first_run() -> bool:
+    """Check if this is the first run (no config and no env vars)."""
+    # If env vars are set, it's not a first run
+    if os.environ.get(ENV_CONFIG_FILE) or os.environ.get(ENV_DATA_FILE):
+        return False
+    # If config file exists, it's not a first run
+    if config_exists():
+        return False
+    return True
+
+
+def load_config() -> dict[str, Any]:
+    """Load configuration from config file.
+
+    Returns:
+        Configuration dictionary, empty dict if file doesn't exist or is invalid.
+    """
+    config_path = get_config_path()
+    if config_path.exists():
+        try:
+            return json.loads(config_path.read_text())
+        except (json.JSONDecodeError, IOError):
+            pass
+    return {}
+
+
+def save_config(config: dict[str, Any]) -> None:
+    """Save configuration to config file.
+
+    Args:
+        config: Configuration dictionary to save
+    """
+    config_path = get_config_path()
+    config_dir = config_path.parent
+
+    # Create config directory if it doesn't exist
+    config_dir.mkdir(parents=True, exist_ok=True)
+
+    # Write config file
+    config_path.write_text(json.dumps(config, indent=2) + "\n")
+
+
+VALID_STYLES = {
+    "plain",
+    "simple",
+    "github",
+    "grid",
+    "simple_grid",
+    "rounded_grid",
+    "heavy_grid",
+    "double_grid",
+    "fancy_grid",
+    "outline",
+    "simple_outline",
+    "rounded_outline",
+    "heavy_outline",
+    "double_outline",
+    "fancy_outline",
+    "presto",
+    "pretty",
+    "psql",
+    "pipe",
+}
+
+_LIGHT_STYLES = {
+    "simple_grid",
+    "rounded_grid",
+    "outline",
+    "simple_outline",
+    "rounded_outline",
+}
+
+_HEAVY_STYLES = {
+    "heavy_grid",
+    "double_grid",
+    "fancy_grid",
+    "heavy_outline",
+    "double_outline",
+    "fancy_outline",
+}
+
+
+def get_table_style() -> str:
+    """Get the configured table style, defaulting to 'simple'."""
+    return get_config_value("style", "simple")
+
+
+def get_divider_char() -> str:
+    """Get the divider character matching the current table style.
+
+    Three tiers: ascii (-), light (─), heavy (━).
+    """
+    style = get_table_style()
+    if style in _LIGHT_STYLES:
+        return "─"
+    if style in _HEAVY_STYLES:
+        return "━"
+    return "-"
+
+
+def get_config_value(key: str, default: Any = None) -> Any:
+    """Get a configuration value.
+
+    Args:
+        key: Configuration key
+        default: Default value if key doesn't exist
+
+    Returns:
+        Configuration value or default
+    """
+    config = load_config()
+    return config.get(key, default)
+
+
+def get_data_file(cli_override: Optional[str] = None) -> str:
+    """Get the data file path.
+
+    Precedence: CLI override > env var > config file > default
+
+    Args:
+        cli_override: Path from CLI --data option
+
+    Returns:
+        Path to the data file
+    """
+    # 1. CLI override (highest priority)
+    if cli_override:
+        return cli_override
+
+    # 2. Environment variable
+    env_path = os.environ.get(ENV_DATA_FILE)
+    if env_path:
+        return env_path
+
+    # 3. Config file
+    config_value = get_config_value("data_file")
+    if config_value:
+        return config_value
+
+    # 4. Default
+    return DEFAULT_DATA_FILE

cli/formats.py

@@ -0,0 +1,179 @@
+"""Date and time formatting with Babel localization."""
+
+from datetime import datetime, timedelta
+from typing import Optional
+
+from babel.dates import format_date, format_time, format_datetime
+from babel import Locale, UnknownLocaleError
+
+from cli.config import get_config_value
+
+# Map our 2-letter codes to Babel locale codes
+LOCALE_MAP = {
+    "en": "en_US",
+    "de": "de_DE",
+    "es": "es_ES",
+    "et": "et_EE",
+    "fr": "fr_FR",
+    "it": "it_IT",
+    "lt": "lt_LT",
+    "lv": "lv_LV",
+    "pl": "pl_PL",
+    "pt": "pt_PT",
+    "uk": "uk_UA",
+}
+
+# Default format styles (Babel format names: full, long, medium, short)
+DEFAULT_DATE_FORMAT = "medium"
+DEFAULT_TIME_FORMAT = "short"
+DEFAULT_DATETIME_FORMAT = "medium"
+
+# Module-level locale cache
+_current_locale: Optional[str] = None
+_babel_locale: Optional[str] = None
+
+
+def set_format_locale(locale: str) -> None:
+    """Set the locale for date/time formatting.
+
+    Args:
+        locale: Two-letter language code (e.g., 'en', 'lv')
+    """
+    global _current_locale, _babel_locale
+    _current_locale = locale
+    _babel_locale = LOCALE_MAP.get(locale, "en_US")
+
+    # Validate the Babel locale
+    try:
+        Locale.parse(_babel_locale)
+    except UnknownLocaleError:
+        _babel_locale = "en_US"
+
+
+def get_babel_locale() -> str:
+    """Get the current Babel locale string."""
+    return _babel_locale or "en_US"
+
+
+def _get_format(format_type: str, default: str) -> str:
+    """Get format from config or return default.
+
+    Config can specify:
+    - Babel format names: "full", "long", "medium", "short"
+    - Custom patterns: "dd.MM.yyyy", "HH:mm", etc.
+
+    Args:
+        format_type: One of "date", "time", "datetime"
+        default: Default format to use
+
+    Returns:
+        Format string or Babel format name
+    """
+    formats = get_config_value("formats", {})
+    return formats.get(format_type, default)
+
+
+def _is_babel_format(fmt: str) -> bool:
+    """Check if format is a Babel format name."""
+    return fmt in ("full", "long", "medium", "short")
+
+
+def fmt_date(dt: Optional[datetime], format: Optional[str] = None) -> str:
+    """Format a date with localization.
+
+    Args:
+        dt: Datetime to format (None returns "-")
+        format: Override format (Babel name or pattern)
+
+    Returns:
+        Formatted date string
+    """
+    if dt is None:
+        return "-"
+
+    fmt = format or _get_format("date", DEFAULT_DATE_FORMAT)
+    locale = get_babel_locale()
+
+    if _is_babel_format(fmt):
+        return format_date(dt, format=fmt, locale=locale)
+    else:
+        # Custom pattern
+        return format_date(dt, format=fmt, locale=locale)
+
+
+def fmt_time(dt: Optional[datetime], format: Optional[str] = None) -> str:
+    """Format a time with localization.
+
+    Args:
+        dt: Datetime to format (None returns "-")
+        format: Override format (Babel name or pattern)
+
+    Returns:
+        Formatted time string
+    """
+    if dt is None:
+        return "-"
+
+    fmt = format or _get_format("time", DEFAULT_TIME_FORMAT)
+    locale = get_babel_locale()
+
+    if _is_babel_format(fmt):
+        return format_time(dt, format=fmt, locale=locale)
+    else:
+        return format_time(dt, format=fmt, locale=locale)
+
+
+def fmt_datetime(dt: Optional[datetime], format: Optional[str] = None) -> str:
+    """Format a datetime with localization.
+
+    Args:
+        dt: Datetime to format (None returns "-")
+        format: Override format (Babel name or pattern)
+
+    Returns:
+        Formatted datetime string
+    """
+    if dt is None:
+        return "-"
+
+    fmt = format or _get_format("datetime", DEFAULT_DATETIME_FORMAT)
+    locale = get_babel_locale()
+
+    if _is_babel_format(fmt):
+        return format_datetime(dt, format=fmt, locale=locale)
+    else:
+        return format_datetime(dt, format=fmt, locale=locale)
+
+
+def fmt_duration(delta: Optional[timedelta]) -> str:
+    """Format a timedelta as a human-readable string.
+
+    This uses simple formatting (not locale-dependent) as duration
+    formatting varies significantly and Babel doesn't handle it well.
+
+    Args:
+        delta: Timedelta to format (None returns "-")
+
+    Returns:
+        Formatted duration string (e.g., "2h 30m", "45m 12s")
+    """
+    if delta is None:
+        return "-"
+
+    total_seconds = int(delta.total_seconds())
+    if total_seconds < 0:
+        return "-"
+
+    hours, remainder = divmod(total_seconds, 3600)
+    minutes, seconds = divmod(remainder, 60)
+
+    # Omit seconds when duration >= 10 minutes
+    if hours > 0 or minutes >= 10:
+        if hours > 0:
+            return f"{hours}h {minutes}m"
+        else:
+            return f"{minutes}m"
+    elif minutes > 0:
+        return f"{minutes}m {seconds}s"
+    else:
+        return f"{seconds}s"

cli/i18n_setup.py

@@ -0,0 +1,94 @@
+"""Internationalization setup for stundu CLI."""
+
+import os
+from pathlib import Path
+from typing import Optional
+
+import i18n
+
+from cli.config import get_config_value
+
+
+def get_locales_path() -> Path:
+    """Get the path to the locales directory."""
+    return Path(__file__).parent / "locales"
+
+
+def get_locale_from_env() -> Optional[str]:
+    """Get locale from environment variables."""
+    for var in ("LC_ALL", "LC_MESSAGES", "LANG"):
+        value = os.environ.get(var)
+        if value and value != "C" and value != "POSIX":
+            # Extract language code: "lv_LV.UTF-8" → "lv"
+            return value.split("_")[0].split(".")[0]
+    return None
+
+
+def get_locale(cli_override: Optional[str] = None) -> str:
+    """Get locale with precedence: CLI > config > environment > fallback.
+
+    Args:
+        cli_override: Language code from CLI --lang option
+
+    Returns:
+        Two-letter language code (e.g., 'en', 'lv')
+    """
+    # 1. CLI override (highest priority)
+    if cli_override:
+        return cli_override
+
+    # 2. Config file
+    config_locale = get_config_value("locale")
+    if config_locale:
+        return config_locale
+
+    # 3. Environment variables
+    env_locale = get_locale_from_env()
+    if env_locale:
+        return env_locale
+
+    # 4. Fallback
+    return "en"
+
+
+def setup_i18n(cli_override: Optional[str] = None) -> str:
+    """Initialize i18n with the appropriate locale.
+
+    Args:
+        cli_override: Language code from CLI --lang option
+
+    Returns:
+        The locale that was set
+    """
+    from cli.formats import set_format_locale
+
+    locales_path = get_locales_path()
+
+    i18n.set("load_path", [str(locales_path)])
+    i18n.set("file_format", "json")
+    i18n.set("filename_format", "{locale}.{format}")
+    i18n.set("fallback", "en")
+    i18n.set("enable_memoization", True)
+
+    locale = get_locale(cli_override)
+    i18n.set("locale", locale)
+
+    # Initialize date/time formatting locale
+    set_format_locale(locale)
+
+    return locale
+
+
+def t(key: str, **kwargs) -> str:
+    """Translate a key with optional parameters.
+
+    This is a convenience wrapper around i18n.t().
+
+    Args:
+        key: Translation key (e.g., 'app.no_active_task')
+        **kwargs: Placeholder values
+
+    Returns:
+        Translated string
+    """
+    return i18n.t(key, **kwargs)

cli/locales/de.json

@@ -0,0 +1,174 @@
+{
+  "de": {
+    "app": {
+      "no_active_task": "Keine aktive Aufgabe.",
+      "run_help": "Führen Sie 'stundu --help' aus, um verfügbare Befehle anzuzeigen.",
+      "currently_tracking": "Aktuelle Erfassung: %{tags}",
+      "started_at": "Gestartet um: %{time}",
+      "elapsed": "Vergangen: %{duration}",
+      "error": "Fehler: %{message}"
+    },
+    "duration": {
+      "hours_minutes": "%{hours}Std %{minutes}Min",
+      "minutes_seconds": "%{minutes}Min %{seconds}s",
+      "seconds": "%{seconds}s",
+      "running": "%{duration} (läuft)"
+    },
+    "start": {
+      "started_tracking": "Erfassung gestartet: %{tags}"
+    },
+    "stop": {
+      "stopped_tracking": "Erfassung gestoppt: %{tags}",
+      "duration": "Dauer: %{duration}"
+    },
+    "status": {
+      "no_active_entry": "Kein aktiver Eintrag. Verwenden Sie 'start' um die Erfassung zu beginnen."
+    },
+    "log": {
+      "no_entries": "Keine Einträge gefunden.",
+      "no_entries_today": "No entries today. Use --all to show all entries.",
+      "total": "Gesamt: %{duration} (%{count} Einträge)",
+      "headers": {
+        "num": "#",
+        "start": "Start",
+        "end": "Ende",
+        "duration": "Dauer",
+        "tags": "Tags",
+        "status": "Status"
+      },
+      "active": "AKTIV"
+    },
+    "cancel": {
+      "no_active_entry": "Kein aktiver Eintrag zum Abbrechen.",
+      "cancelled": "Abgebrochen: %{tags}",
+      "discarded": "Gestartet um: %{time} (verworfen)"
+    },
+    "continue": {
+      "already_tracking": "Fehler: Erfassung läuft bereits: %{tags}",
+      "stop_first": "Stoppen Sie zuerst den aktuellen Eintrag.",
+      "no_previous": "Keine vorherigen Einträge zum Fortsetzen.",
+      "continuing": "Fortsetzen: %{tags}"
+    },
+    "set_rate": {
+      "success": "Satz festgelegt für '%{tag}': %{amount} %{currency}/Stunde"
+    },
+    "set_workday": {
+      "invalid_format": "Fehler: Format muss 'HH:MM-HH:MM' sein (z.B. 9:00-18:00)",
+      "success_tag": "Arbeitstag festgelegt für '%{tag}': %{hours}",
+      "success_global": "Globaler Arbeitstag festgelegt: %{hours}"
+    },
+    "set_afterhours": {
+      "success": "Überstunden-Modifikator festgelegt für '%{tag}': %{multiplier}x Basissatz"
+    },
+    "set_holiday": {
+      "success": "Feiertags-/Wochenend-Modifikator festgelegt für '%{tag}': %{multiplier}x Basissatz"
+    },
+    "set_style": {
+      "success": "Tabellenstil festgelegt: %{style}",
+      "invalid": "Ungültiger Stil '%{style}'. Gültige Stile: %{valid}"
+    },
+    "report": {
+      "no_entries": "Keine Einträge gefunden.",
+      "no_entries_range": "Keine Einträge im angegebenen Datumsbereich gefunden.",
+      "no_entries_tag": "Keine Einträge mit Tag '%{tag}' gefunden.",
+      "no_completed": "Keine abgeschlossenen Einträge gefunden.",
+      "invalid_date": "Ungültiges Datumsformat: %{date}. Verwenden Sie JJJJ-MM-TT.",
+      "header": "Bericht",
+      "header_for_tag": "für '%{tag}'",
+      "header_range": "(%{start} bis %{end})",
+      "header_from": "(ab %{start})",
+      "header_until": "(bis %{end})",
+      "total_time": "Gesamtzeit: %{duration}",
+      "by_tag": "Nach Tag:",
+      "total": "Gesamt:",
+      "no_billable": "Kein abrechenbarer Betrag (keine Sätze für Tags konfiguriert)",
+      "headers": {
+        "date": "Datum",
+        "start": "Start",
+        "end": "Ende",
+        "duration": "Dauer",
+        "tags": "Tags",
+        "cost": "Kosten"
+      }
+    },
+    "delete": {
+      "no_entries": "Keine Einträge gefunden.",
+      "not_found": "Fehler: Eintrag @%{num} nicht gefunden. Gültiger Bereich: @1 bis @%{max}",
+      "invalid_number": "Fehler: Ungültige Eintragsnummer '%{ref}'",
+      "no_entries_tag": "Keine Einträge mit Tag '%{tag}' gefunden.",
+      "will_delete": "%{count} Einträge werden gelöscht:",
+      "and_more": "  ... und %{count} weitere",
+      "confirm": "Diese Einträge löschen?",
+      "cancelled": "Abgebrochen.",
+      "deleted": "%{count} Einträge gelöscht."
+    },
+    "modify": {
+      "no_entries": "Keine Einträge gefunden.",
+      "invalid_ref": "Fehler: Referenz muss mit @ beginnen (z.B. @3)",
+      "not_found": "Fehler: Eintrag @%{num} nicht gefunden. Gültiger Bereich: @1 bis @%{max}",
+      "invalid_number": "Fehler: Ungültige Eintragsnummer '%{ref}'",
+      "parse_error_start": "Fehler beim Parsen der Startzeit: %{error}",
+      "parse_error_end": "Fehler beim Parsen der Endzeit: %{error}",
+      "no_modifications": "Keine Änderungen angegeben. Verwenden Sie --add-tag, --remove-tag, --start oder --end.",
+      "modified": "Eintrag @%{num} geändert:",
+      "tags": "  Tags: %{tags}",
+      "start": "  Start: %{time}",
+      "end": "  Ende: %{time}",
+      "duration": "  Dauer: %{duration}"
+    },
+    "rates": {
+      "no_billable": "Keine abrechenbaren Tags konfiguriert. Verwenden Sie 'set-rate' zum Hinzufügen.",
+      "headers": {
+        "tag": "Tag",
+        "rate": "Satz",
+        "workday": "Arbeitstag",
+        "afterhours": "Überstunden",
+        "holiday": "Feiertag"
+      }
+    },
+    "setup": {
+      "welcome": "Willkommen bei Stundu!",
+      "first_run": "Dies scheint Ihr erster Start zu sein.",
+      "prompt_create_config": "Möchten Sie eine Konfigurationsdatei erstellen?",
+      "data_file_prompt": "Geben Sie den Pfad zur Datendatei ein",
+      "data_file_default": "(Standard: %{default})",
+      "config_created": "Konfiguration gespeichert unter: %{path}",
+      "skipped": "Einrichtung übersprungen. Standardwerte werden verwendet.",
+      "already_configured": "Konfiguration existiert bereits: %{path}",
+      "reconfigure_prompt": "Möchten Sie neu konfigurieren?",
+      "run_setup": "Führen Sie 'stundu setup' aus, um zu konfigurieren."
+    },
+    "set_my": {
+      "success": "%{field} festgelegt: %{value}"
+    },
+    "set_client": {
+      "success": "%{field} für '%{tag}' festgelegt: %{value}"
+    },
+    "invoice": {
+      "no_entries": "Keine Einträge gefunden.",
+      "no_entries_tag": "Keine Einträge mit Tag '%{tag}' gefunden.",
+      "no_completed": "Keine abgeschlossenen Einträge gefunden.",
+      "no_billable": "Keine abrechenbaren Einträge gefunden. Setzen Sie Sätze mit 'configure rate'.",
+      "multiple_currencies": "Mehrere Währungen gefunden (%{currencies}). Erstellen Sie separate Rechnungen für jede Währung.",
+      "invalid_date": "Ungültiges Datumsformat: %{date}. Verwenden Sie JJJJ-MM-TT.",
+      "created_html": "Rechnung erstellt: %{path}",
+      "created_pdf": "Rechnung erstellt: %{path}"
+    },
+    "import": {
+      "available": "Verfügbare Importierer:",
+      "usage": "Verwendung: stundu import <importierer> [OPTIONEN]",
+      "importer_not_found": "Importierer '%{name}' nicht gefunden.",
+      "source_not_found": "Quelle nicht gefunden: %{path}",
+      "invalid_date": "Ungültiges Datumsformat: %{date}. Verwenden Sie JJJJ-MM-TT.",
+      "importing": "Importiere von %{source}...",
+      "errors": "Fehler aufgetreten:",
+      "summary": "%{count} Einträge gefunden (%{skipped} durch Filter übersprungen).",
+      "no_entries": "Keine Einträge zum Importieren.",
+      "preview": "Vorschau:",
+      "dry_run": "Testlauf - keine Änderungen gespeichert.",
+      "confirm": "Diese Einträge importieren?",
+      "cancelled": "Import abgebrochen.",
+      "success": "%{count} Einträge erfolgreich importiert."
+    }
+  }
+}