stage-cli 1.0.0__py3-none-any.whl

stage/tui/state.py

@@ -0,0 +1,160 @@
+from dataclasses import dataclass, field, replace
+from pathlib import Path
+from typing import Any
+
+from stage.domain import (
+    DEFAULT_WINDOW_DAYS,
+    JobFilters,
+    Language,
+    LocationBucket,
+    RoleCategory,
+)
+
+DEBOUNCE_SECONDS = 0.04
+PAGE_SIZE = 200
+
+LAST_DAYS_CHOICES: tuple[int, ...] = (7, 14, 30, 0)
+
+FILTER_FIELDS: tuple[tuple[str, str, tuple[str, ...]], ...] = (
+    ("role", "Role", tuple(value.value for value in RoleCategory if value.value != "hardware")),
+    ("location", "Location", tuple(value.value for value in LocationBucket)),
+    ("language", "Language", tuple(value.value for value in Language)),
+)
+
+_ENUMS: dict[str, Any] = {
+    "role": RoleCategory,
+    "location": LocationBucket,
+    "language": Language,
+}
+
+_OPEN_FIELDS: tuple[tuple[str, str], ...] = (("company", "Company"),)
+
+
+def filter_rows(
+    state: "FilterState", employer: str | None = None
+) -> tuple[tuple[str, str, str, bool], ...]:
+    rows: list[tuple[str, str, str, bool]] = []
+    for name, label, options in FILTER_FIELDS:
+        for option in options:
+            if option == "unknown":
+                continue
+            rows.append((name, option, f"{label}: {option}", state.values.get(name) == option))
+    window = state.last_days
+    for days in LAST_DAYS_CHOICES:
+        shown = "any date" if days == 0 else f"last {days} days"
+        rows.append(("last_days", str(days), f"Window: {shown}", window == days))
+    rows.append(("only_new", "on", "Only what the last sync brought in", state.only_new))
+    rows.append(("show_all", "on", "Show every match, not just a page", state.show_all))
+    chosen = state.values.get("company")
+    if chosen is not None:
+        rows.append(("company", chosen, f"Employer: {chosen}", True))
+    elif employer is not None:
+        rows.append(("company", employer, f"Employer: {employer}", False))
+    return tuple(rows)
+
+
+@dataclass
+class FilterState:
+    query: str = ""
+    limit: int = PAGE_SIZE
+    values: dict[str, str] = field(default_factory=dict)
+    last_days: int = DEFAULT_WINDOW_DAYS
+    only_new: bool = False
+    show_all: bool = False
+
+    def toggle(self, name: str, value: str) -> None:
+        if self.values.get(name) == value:
+            self.values.pop(name, None)
+            return
+        self.values[name] = value
+
+    def clear(self) -> None:
+        self.values.clear()
+        self.query = ""
+        self.limit = PAGE_SIZE
+        self.last_days = DEFAULT_WINDOW_DAYS
+        self.only_new = False
+        self.show_all = False
+
+    def widen(self) -> None:
+        self.limit += PAGE_SIZE
+
+    def narrow(self) -> bool:
+        if self.limit <= PAGE_SIZE:
+            return False
+        self.limit = max(PAGE_SIZE, self.limit - PAGE_SIZE)
+        return True
+
+    def choose(self, name: str, value: str) -> None:
+        if name == "last_days":
+            self.last_days = int(value)
+        elif name == "only_new":
+            self.only_new = not self.only_new
+        elif name == "show_all":
+            self.show_all = not self.show_all
+        else:
+            self.toggle(name, value)
+        self.limit = PAGE_SIZE
+
+    @property
+    def window_days(self) -> int | None:
+        return self.last_days or None
+
+    @property
+    def active(self) -> tuple[tuple[str, str], ...]:
+        named = tuple(name for name, _, _ in FILTER_FIELDS)
+        ordered = (*named, *(name for name, _ in _OPEN_FIELDS))
+        return tuple((name, self.values[name]) for name in ordered if name in self.values)
+
+    def as_filters(self) -> JobFilters:
+        chosen: dict[str, Any] = {}
+        for name, value in self.values.items():
+            enum = _ENUMS.get(name)
+            if enum is None:
+                if any(name == field_name for field_name, _ in _OPEN_FIELDS):
+                    chosen[name] = value
+                continue
+            try:
+                chosen[name] = enum(value)
+            except ValueError:
+                continue
+        return JobFilters(limit=None if self.show_all else self.limit, **chosen)
+
+
+def theme_path() -> Path:
+    from stage.paths import data_dir
+
+    return data_dir() / "tui-theme"
+
+
+def load_theme(path: Path | None = None) -> str | None:
+    target = path or theme_path()
+    try:
+        name = target.read_text(encoding="utf-8").strip()
+    except OSError:
+        return None
+    return name or None
+
+
+def store_theme(name: str, path: Path | None = None) -> bool:
+    target = path or theme_path()
+    try:
+        target.parent.mkdir(parents=True, exist_ok=True)
+        target.write_text(name, encoding="utf-8")
+    except OSError:
+        return False
+    return True
+
+
+__all__ = [
+    "DEBOUNCE_SECONDS",
+    "FILTER_FIELDS",
+    "LAST_DAYS_CHOICES",
+    "PAGE_SIZE",
+    "FilterState",
+    "filter_rows",
+    "load_theme",
+    "replace",
+    "store_theme",
+    "theme_path",
+]

stage/tui/theme.tcss

@@ -0,0 +1,205 @@
+$blue: $primary;
+$on-blue: $text-primary;
+$blue-deep: $primary-muted;
+$blue-dim: $primary-darken-2;
+$new: $success;
+$warn: $warning;
+$bad: $error;
+
+Screen {
+    background: $surface;
+}
+
+Header {
+    background: $blue-deep;
+    color: $on-blue;
+}
+
+#splash {
+    align: center middle;
+    background: $surface;
+}
+
+#splash-art {
+    color: $text;
+    text-style: bold;
+    text-align: center;
+    width: auto;
+}
+
+#splash-stats {
+    color: $text-muted;
+    text-align: center;
+    margin-top: 1;
+    width: auto;
+}
+
+#chips {
+    height: auto;
+    min-height: 1;
+    padding: 0 1;
+    background: $panel;
+    color: $text-muted;
+    border-bottom: solid $blue-dim;
+}
+
+#chips .active {
+    color: $blue;
+    text-style: bold;
+}
+
+#chips.busy {
+    color: $blue;
+}
+
+#overall {
+    margin: 0 1;
+}
+
+#sources {
+    padding: 1;
+}
+
+#warnings {
+    padding: 0 1;
+    color: $warn;
+}
+
+#filters {
+    height: auto;
+    max-height: 12;
+    padding: 0 1;
+    background: $panel;
+    border-bottom: solid $blue;
+    scrollbar-size-vertical: 1;
+}
+
+#filters:focus {
+    border-bottom: solid $blue;
+}
+
+#filters > .option-list--option-highlighted {
+    background: $blue-deep;
+    color: $on-blue;
+    text-style: bold;
+}
+
+#filters.hidden {
+    display: none;
+}
+
+#results {
+    height: 1fr;
+    min-height: 3;
+    scrollbar-size-vertical: 1;
+}
+
+#results > .datatable--header {
+    background: $panel;
+    color: $blue;
+    text-style: bold;
+}
+
+#results > .datatable--cursor {
+    background: $blue-deep;
+    color: $on-blue;
+    text-style: bold;
+}
+
+#results > .datatable--hover {
+    background: $blue-dim;
+}
+
+DataTable {
+    height: 1fr;
+}
+
+DataTable > .datatable--cursor {
+    background: $blue-deep;
+    color: $on-blue;
+}
+
+DataTable > .datatable--header {
+    background: $panel;
+    color: $blue;
+    text-style: bold;
+}
+
+#detail {
+    height: 9;
+    min-height: 3;
+    padding: 1 2;
+    background: $panel;
+    border-top: solid $blue;
+}
+
+#detail.expanded {
+    height: 22;
+}
+
+#detail-title {
+    color: $blue;
+    text-style: bold;
+}
+
+#search-bar {
+    height: 3;
+    padding: 0 1;
+    display: none;
+}
+
+#search-bar.visible {
+    display: block;
+}
+
+Input {
+    border: tall $blue-dim;
+}
+
+Input:focus {
+    border: tall $blue;
+}
+
+.empty {
+    color: $text-muted;
+    text-align: center;
+    padding: 2;
+}
+
+#stats-grid {
+    height: 1fr;
+    padding: 1;
+}
+
+.bar {
+    color: $blue;
+}
+
+.stat-label {
+    color: $text-muted;
+}
+
+Footer {
+    background: $panel;
+}
+
+.narrow #filters {
+    max-height: 8;
+}
+
+#help {
+    display: none;
+}
+
+#help.visible {
+    display: block;
+    layer: overlay;
+    dock: top;
+    width: 46;
+    height: auto;
+    margin: 2 0 0 4;
+    padding: 1 2;
+    background: $panel;
+    border: round $blue;
+    color: $text;
+}