time-manager 0.2.20__py3-none-any.whl

tui/countdown.py

@@ -0,0 +1,94 @@
+from textual.app import App, ComposeResult
+from textual.containers import Container
+from textual.widgets import Digits, Footer, Header, Static
+from textual.reactive import reactive
+from core.formatting import format_time
+from core.termclock import Countdown
+
+
+class CountdownTui(App):
+    """A countdown timer app."""
+
+    TITLE = "Time Manager"
+    SUB_TITLE = "Countdown"
+
+    CSS_PATH = "theme.tcss"
+
+    BINDINGS = [
+        ("q", "quit", "Quit"),
+        ("space", "toggle_pause", "Pause/Resume"),
+    ]
+
+    time_left = reactive(0.0)
+
+    def __init__(self, seconds: int) -> None:
+        super().__init__()
+        self.countdown = Countdown(seconds)
+        self._finished_announced = False
+
+    def compose(self) -> ComposeResult:
+        yield Header(show_clock=True)
+        with Container(id="content"):
+            with Container(id="card-row"):
+                with Container(id="display-container"):
+                    with Container(id="time-row"):
+                        yield Digits("00:00", id="countdown")
+                    with Container(id="status-row"):
+                        yield Static("Running", id="status", classes="running")
+        yield Footer()
+
+    def on_mount(self) -> None:
+        self.time_left = self.countdown.time_left
+        self.update_display()
+        self._sync_status()
+        self.set_interval(0.1, self.tick)
+
+    def tick(self) -> None:
+        self.countdown.tick()
+        self.time_left = self.countdown.time_left
+
+        if self.countdown.is_finished and not self._finished_announced:
+            self._finished_announced = True
+            self.notify("Time's up!", severity="error", timeout=10)
+            self.bell()
+            self.query_one("#status", Static).update("Time's Up!")
+            self.query_one("#status", Static).set_class(True, "danger")
+
+        self.update_display()
+        self._sync_status()
+
+    def update_display(self) -> None:
+        time_str = format_time(self.time_left, show_centiseconds=False)
+        digits = self.query_one("#countdown", Digits)
+        digits.update(time_str)
+
+        # Subtle urgency cue while still respecting the palette.
+        is_finished = self.countdown.is_finished
+        is_paused = (not self.countdown.is_running) and (not is_finished)
+        is_urgent = (not is_paused) and (is_finished or self.time_left < 10)
+
+        digits.set_class(is_paused, "muted")
+        digits.set_class(is_urgent, "danger")
+
+    def action_toggle_pause(self) -> None:
+        self.countdown.toggle()
+        self._sync_status()
+
+    def _sync_status(self) -> None:
+        status_widget = self.query_one("#status", Static)
+
+        is_finished = self.countdown.is_finished
+        if is_finished:
+            status_widget.update("Time's Up!")
+            status_widget.set_class(True, "danger")
+            status_widget.set_class(False, "running", "paused")
+            return
+
+        if self.countdown.is_running:
+            status_widget.update("Running")
+            status_widget.set_class(True, "running")
+            status_widget.set_class(False, "paused", "danger")
+        else:
+            status_widget.update("Paused")
+            status_widget.set_class(True, "paused")
+            status_widget.set_class(False, "running", "danger")

tui/stopwatch.py

@@ -0,0 +1,105 @@
+from textual.app import App, ComposeResult
+from textual.containers import Container
+from textual.widgets import Header, Footer, Digits, Button, Static
+from textual.reactive import reactive
+from core.formatting import format_time
+from core.termclock import Stopwatch
+
+
+def _format_stopwatch(seconds: float) -> str:
+    """Always format stopwatch as HH:MM:SS"""
+    time_str = format_time(seconds, show_centiseconds=False)
+    if time_str.count(":") == 1:
+        return f"00:{time_str}"
+    return time_str
+
+
+class StopwatchTui(App):
+    """A simple stopwatch app."""
+
+    TITLE = "Time Manager"
+    SUB_TITLE = "Stopwatch"
+
+    CSS_PATH = "theme.tcss"
+
+    BINDINGS = [
+        ("q", "quit", "Quit"),
+        ("space", "toggle_timer", "Start/Stop"),
+        ("r", "reset_timer", "Reset"),
+    ]
+
+    time_elapsed = reactive(0.0)
+
+    def __init__(self) -> None:
+        super().__init__()
+        self.stopwatch = Stopwatch()
+
+    def compose(self) -> ComposeResult:
+        yield Header(show_clock=True)
+        with Container(id="content"):
+            with Container(id="card-row"):
+                with Container(id="display-container"):
+                    with Container(id="time-row"):
+                        yield Digits("00:00:00", id="time-display")
+                    with Container(id="hint-row"):
+                        yield Static("HH:MM:SS", id="format-hint")
+                    with Container(id="status-row"):
+                        yield Static("Ready", id="status", classes="ready")
+            with Container(id="buttons-row"):
+                with Container(id="buttons"):
+                    # Don't use `variant=` here; we want fully deterministic styling via TCSS.
+                    yield Button("START", id="start", classes="start", flat=True)
+                    yield Button(
+                        "STOP", id="stop", classes="stop", disabled=True, flat=True
+                    )
+                    yield Button("RESET", id="reset", classes="reset", flat=True)
+        yield Footer()
+
+    def on_mount(self) -> None:
+        self.set_interval(1 / 60, self.update_time)
+        self.update_buttons()
+
+    def update_time(self) -> None:
+        self.time_elapsed = self.stopwatch.elapsed
+        time_str = _format_stopwatch(self.time_elapsed)
+        self.query_one("#time-display", Digits).update(time_str)
+
+    def action_toggle_timer(self) -> None:
+        self.stopwatch.toggle()
+        self.update_buttons()
+
+    def action_reset_timer(self) -> None:
+        self.stopwatch.reset()
+        self.time_elapsed = 0.0
+        self.query_one("#time-display", Digits).update("00:00:00")
+        self.update_buttons()
+
+    def on_button_pressed(self, event: Button.Pressed) -> None:
+        if event.button.id == "start":
+            self.stopwatch.start()
+        elif event.button.id == "stop":
+            self.stopwatch.stop()
+        elif event.button.id == "reset":
+            self.stopwatch.reset()
+            self.time_elapsed = 0.0
+            self.query_one("#time-display", Digits).update("00:00:00")
+
+        self.update_buttons()
+
+    def update_buttons(self) -> None:
+        running = self.stopwatch.is_running
+        if running:
+            self.query_one("#start").disabled = True
+            self.query_one("#stop").disabled = False
+        else:
+            self.query_one("#start").disabled = False
+            self.query_one("#stop").disabled = True
+
+        status = (
+            "Running" if running else ("Ready" if self.time_elapsed == 0 else "Paused")
+        )
+        status_widget = self.query_one("#status", Static)
+        status_widget.update(status)
+        status_widget.set_class(running, "running")
+        status_widget.set_class((not running) and self.time_elapsed == 0, "ready")
+        status_widget.set_class((not running) and self.time_elapsed > 0, "paused")

tui/theme.tcss

@@ -0,0 +1,229 @@
+/* Shared Textual theme for time-manager TUIs
+ *
+ * Primary:   #081e32
+ * Secondary: #d5b77c
+ *
+ * Note: Textual TCSS doesn't support `linear-gradient(...)` or `box-shadow`,
+ * so the "glass" / glow effect is approximated with alpha backgrounds + outline.
+ *
+ * Linter note: Properties like `text-style`, `text-opacity`, `content-align`,
+ * `layout`, and `align` are valid Textual TCSS extensions, not standard CSS.
+ * These warnings can be safely ignored.
+ */
+
+Screen {
+    background: #081e32;
+    color: #d5b77c;
+}
+
+Header {
+    background: transparent;
+    color: #d5b77c;
+}
+
+Footer {
+    background: transparent;
+    color: #d5b77c 60%;
+}
+
+/* Footer "keycaps" */
+FooterLabel {
+    background: transparent;
+    color: #d5b77c 60%;
+}
+
+.footer-key--key {
+    background: #d5b77c 10%;
+    color: #d5b77c;
+    padding: 0 1;
+    text-style: bold;
+}
+
+.footer-key--description {
+    background: transparent;
+    color: #d5b77c 60%;
+}
+
+/* Main content area */
+#content {
+    /* Container defaults to height: 1fr; we keep that behavior (no hard-coded heights). */
+    /* Use explicit axis alignment types:
+       - vertical: https://textual.textualize.io/css_types/vertical/
+       - horizontal: https://textual.textualize.io/css_types/horizontal/ */
+    align-vertical: middle;
+    align-horizontal: center;
+    padding: 1 2;
+}
+
+/* Center “card” */
+#display-container {
+    outline: round #d5b77c 20%;
+    layout: vertical;
+    align-horizontal: center;
+    align-vertical: middle;
+    padding: 3 10;
+    margin: 1 0 2 0;
+    width: auto;
+    height: auto;
+    /* With width:auto, use content-box so padding expands the card instead of
+       shrinking the content area (prevents Digits from being clipped). */
+    box-sizing: content-box;
+}
+
+/* Center each section independently so we don't need width/min-width coupling */
+#card-row,
+#buttons-row {
+    layout: horizontal;
+    height: auto;
+    align-horizontal: center;
+    align-vertical: middle;
+}
+
+/* Center the time + status using horizontal rows (more reliable for multi-line Digits) */
+#time-row,
+#hint-row,
+#status-row {
+    layout: horizontal;
+    # width: auto;
+    height: auto;
+    align-vertical: middle;
+    align-horizontal: center;
+}
+
+#hint-row {
+    margin-top: 1;
+}
+
+#status-row {
+    margin-top: 1;
+}
+
+
+Digits {
+    color: #d5b77c;
+    text-opacity: 100%;
+    width: auto;
+    content-align: center middle;
+    text-align: center;
+}
+
+#time-display {
+    width: auto;
+}
+
+Digits.muted {
+    text-opacity: 70%;
+}
+
+Digits.danger {
+    color: #8b3a3a;
+    text-opacity: 100%;
+}
+
+#status {
+    width: auto;
+    text-style: italic;
+    text-opacity: 70%;
+    color: #d5b77c;
+    content-align: center middle;
+}
+
+#status.running {
+    text-opacity: 100%;
+}
+
+#status.paused,
+#status.ready {
+    text-opacity: 70%;
+}
+
+#status.danger {
+    color: #8b3a3a;
+    text-opacity: 100%;
+}
+
+/* Stopwatch time format hint */
+#format-hint {
+    width: auto;
+    text-style: italic;
+    text-opacity: 60%;
+    color: #d5b77c;
+    content-align: center middle;
+}
+
+/* Buttons (stopwatch only) */
+#buttons {
+    layout: horizontal;
+    height: auto;
+    width: auto;
+    align-vertical: middle;
+    align-horizontal: center;
+    margin-top: 1;
+}
+
+Button {
+    /* Flatten Textual's default "3D" button styling (which can show as internal
+       border lines). See Button docs: https://textual.textualize.io/widgets/button/ */
+    background: #d5b77c 15%;
+    color: #d5b77c;
+    border: none;
+    border-top: none;
+    border-bottom: none;
+    line-pad: 1;
+    height: auto;
+    padding: 1 7;
+    margin: 0 1;
+}
+
+Button:disabled {
+    /* Avoid full-widget opacity: terminals blend alpha differently which can make disabled
+       buttons appear to "disappear" in some emulators. */
+    opacity: 100%;
+    background: #d5b77c 8%;
+    color: #d5b77c 45%;
+    border: none;
+}
+
+/* Hover effects should be color-only (no offsets) */
+
+Button.start {
+    background: #d5b77c;
+    color: #081e32;
+    border: none;
+    text-style: bold;
+}
+
+Button.start:hover {
+    background: #d5b77c 75%;
+    color: #8b3a3a;
+}
+
+Button.stop {
+    background: #8b3a3a;
+    color: #fffaf0;
+    border: none;
+    text-style: bold;
+}
+
+Button.stop:hover {
+    background: #a04545 50%;
+}
+
+Button.stop:disabled {
+    background: #8b3a3a 25%;
+    color: #fffaf0 55%;
+    border: none;
+}
+
+Button.reset {
+    background: #d5b77c 15%;
+    color: #d5b77c;
+    border: none;
+    # outline: round #d5b77c;
+    text-style: bold;
+}
+
+Button.reset:hover {
+    background: #d5b77c 25%;
+    color: #8b3a3a;
+}