pttm 0.1.0__tar.gz

pttm-0.1.0/PKG-INFO

@@ -0,0 +1,96 @@
+Metadata-Version: 2.4
+Name: pttm
+Version: 0.1.0
+Summary: Pomodoro Terminal Timer & Manager
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+Requires-Dist: linkify-it-py==2.1.0
+Requires-Dist: markdown-it-py==4.2.0
+Requires-Dist: mdit-py-plugins==0.6.1
+Requires-Dist: mdurl==0.1.2
+Requires-Dist: platformdirs==4.10.0
+Requires-Dist: Pygments==2.20.0
+Requires-Dist: rich==15.0.0
+Requires-Dist: textual==8.2.7
+Requires-Dist: typing_extensions==4.15.0
+Requires-Dist: uc-micro-py==2.0.0
+
+# PTTM - Pomodoro Terminal Timer & Manager
+
+PTTM is a terminal-based Pomodoro app built with [Textual](https://textual.textualize.io/). It provides a timer, task tracking, and configurable work/break settings in a compact TUI.
+
+## Features
+
+- Pomodoro timer with focus, short break, and long break modes
+- Task list with per-task Pomodoro counts
+- Persistent configuration stored as JSON
+- Keyboard shortcuts for common timer and task actions
+- In-app settings tab for adjusting timing values
+
+## Requirements
+
+- Python 3.10 or newer
+
+## Installation
+
+Install the dependencies from the project root:
+
+```bash
+pip install -r requirements.txt
+```
+
+## Run
+
+From the repository root, start the app with:
+
+```bash
+python pttm.py
+```
+
+You can also run the app module directly:
+
+```bash
+python -m pttm.app
+```
+
+## Keyboard Shortcuts
+
+- `q` quit
+- `s` start or pause the timer
+- `r` reset the current timer
+- `ctrl+r` reset the full session
+- `k` skip to the next timer mode
+- `f` switch to focus mode
+- `g` switch to short break mode
+- `b` switch to long break mode
+- `t` focus the new task input
+- `ctrl+p` show or hide the shortcuts screen
+
+## Configuration
+
+The app reads and writes a JSON config file. By default, the file is stored in your user config directory. You can override the location by setting `PMO_CONFIG_PATH` before launch.
+
+Example:
+
+```bash
+export PMO_CONFIG_PATH=./pmo_config.json
+python pttm.py
+```
+
+The config includes timer settings, completed focus session count, and task data.
+
+## Tests
+
+Run the test suite with:
+
+```bash
+python -m unittest test_pttm.py
+```
+
+## Project Layout
+
+- `pttm/app.py` application entry point
+- `pttm/config.py` config load/save helpers
+- `pttm/clock.py` ASCII clock rendering
+- `pttm/widgets/` UI components
+- `pttm/pttm.css` Textual stylesheet

pttm-0.1.0/README.md

@@ -0,0 +1,79 @@
+# PTTM - Pomodoro Terminal Timer & Manager
+
+PTTM is a terminal-based Pomodoro app built with [Textual](https://textual.textualize.io/). It provides a timer, task tracking, and configurable work/break settings in a compact TUI.
+
+## Features
+
+- Pomodoro timer with focus, short break, and long break modes
+- Task list with per-task Pomodoro counts
+- Persistent configuration stored as JSON
+- Keyboard shortcuts for common timer and task actions
+- In-app settings tab for adjusting timing values
+
+## Requirements
+
+- Python 3.10 or newer
+
+## Installation
+
+Install the dependencies from the project root:
+
+```bash
+pip install -r requirements.txt
+```
+
+## Run
+
+From the repository root, start the app with:
+
+```bash
+python pttm.py
+```
+
+You can also run the app module directly:
+
+```bash
+python -m pttm.app
+```
+
+## Keyboard Shortcuts
+
+- `q` quit
+- `s` start or pause the timer
+- `r` reset the current timer
+- `ctrl+r` reset the full session
+- `k` skip to the next timer mode
+- `f` switch to focus mode
+- `g` switch to short break mode
+- `b` switch to long break mode
+- `t` focus the new task input
+- `ctrl+p` show or hide the shortcuts screen
+
+## Configuration
+
+The app reads and writes a JSON config file. By default, the file is stored in your user config directory. You can override the location by setting `PMO_CONFIG_PATH` before launch.
+
+Example:
+
+```bash
+export PMO_CONFIG_PATH=./pmo_config.json
+python pttm.py
+```
+
+The config includes timer settings, completed focus session count, and task data.
+
+## Tests
+
+Run the test suite with:
+
+```bash
+python -m unittest test_pttm.py
+```
+
+## Project Layout
+
+- `pttm/app.py` application entry point
+- `pttm/config.py` config load/save helpers
+- `pttm/clock.py` ASCII clock rendering
+- `pttm/widgets/` UI components
+- `pttm/pttm.css` Textual stylesheet

pttm-0.1.0/pttm/__init__.py

@@ -0,0 +1,3 @@
+# Pomodoro TUI Package Public API
+from pttm.config import load_config, save_config, CONFIG_FILE
+from pttm.clock import make_clock_ascii

pttm-0.1.0/pttm/app.py

@@ -0,0 +1,183 @@
+import json
+import os
+from textual.app import App, ComposeResult
+from textual.widgets import Header, TabbedContent, TabPane, Label, Input
+from pttm.config import load_config, save_config
+from pttm.widgets.dashboard import Dashboard
+from pttm.widgets.settings_tab import SettingsTab
+from pttm.widgets.shortcuts_screen import ShortcutsScreen
+from pttm.widgets.timer_widget import TimerWidget
+from pttm.widgets.task_list_widget import TaskListWidget
+
+class PomodoroApp(App):
+    CSS_PATH = "pttm.css"
+    TITLE = "TS PMO"
+    COMMANDS = set()
+    ENABLE_COMMAND_PALETTE = False
+
+    BINDINGS = [
+        ("q", "quit", "Quit"),
+        ("s", "toggle_timer", "Start/Pause"),
+        ("r", "reset_timer", "Reset"),
+        ("ctrl+r", "reset_session", "Reset Session"),
+        ("k", "skip_timer", "Skip"),
+        ("f", "set_mode_focus", "Focus Mode"),
+        ("g", "set_mode_short", "Short Break"),
+        ("b", "set_mode_long", "Long Break"),
+        ("t", "focus_todo_input", "Focus Todo"),
+        ("ctrl+p", "toggle_shortcuts", "Shortcuts"),
+    ]
+
+    def __init__(self, **kwargs):
+        super().__init__(**kwargs)
+        self.config = load_config()
+        # Log config to startup file next to config file
+        from pttm.config import CONFIG_FILE
+        log_dir = os.path.dirname(CONFIG_FILE)
+        if log_dir:
+            os.makedirs(log_dir, exist_ok=True)
+            log_file = os.path.join(log_dir, "pmo_startup.log")
+        else:
+            log_file = "pmo_startup.log"
+        try:
+            with open(log_file, "w") as f:
+                f.write(json.dumps(self.config, indent=4))
+        except Exception:
+            pass
+        self.active_task_id = None
+
+    def compose(self) -> ComposeResult:
+        # yield Header(show_clock=True)
+        with TabbedContent(initial="timer-tab"):
+            with TabPane("Timer", id="timer-tab"):
+                yield TimerWidget()
+            with TabPane("Tasks", id="tasks-tab"):
+                yield TaskListWidget()
+            with TabPane("Settings", id="settings-tab"):
+                yield SettingsTab()
+
+    def action_toggle_timer(self) -> None:
+        try:
+            timer_widget = self.query_one(TimerWidget)
+            timer_widget.is_running = not timer_widget.is_running #type: ignore
+        except Exception:
+            pass
+
+    def action_reset_timer(self) -> None:
+        try:
+            timer_widget = self.query_one(TimerWidget)
+            timer_widget.reset_timer_to_mode()
+        except Exception:
+            pass
+
+    def action_skip_timer(self) -> None:
+        try:
+            timer_widget = self.query_one(TimerWidget)
+            timer_widget.transition_to_next()
+        except Exception:
+            pass
+
+    def action_set_mode_focus(self) -> None:
+        try:
+            timer_widget = self.query_one(TimerWidget)
+            timer_widget.mode = "Focus"
+            timer_widget.reset_timer_to_mode()
+        except Exception:
+            pass
+
+    def action_set_mode_short(self) -> None:
+        try:
+            timer_widget = self.query_one(TimerWidget)
+            timer_widget.mode = "Short Break"
+            timer_widget.reset_timer_to_mode()
+        except Exception:
+            pass
+
+    def action_set_mode_long(self) -> None:
+        try:
+            timer_widget = self.query_one(TimerWidget)
+            timer_widget.mode = "Long Break"
+            timer_widget.reset_timer_to_mode()
+        except Exception:
+            pass
+
+    def action_focus_todo_input(self) -> None:
+        try:
+            input_box = self.query_one("#new-task-input", Input)
+            input_box.focus()
+        except Exception:
+            pass
+
+    def action_toggle_shortcuts(self) -> None:
+        if isinstance(self.screen, ShortcutsScreen):
+            self.pop_screen()
+        else:
+            self.push_screen(ShortcutsScreen())
+
+    def action_reset_session(self) -> None:
+        try:
+            timer_widget = self.query_one(TimerWidget)
+            timer_widget.is_running = False #type: ignore
+            timer_widget.completed_focus_sessions = 0
+            self.config["completed_focus_sessions"] = 0
+            save_config(self.config)
+
+            timer_widget.query_one("#session-count-display", Label).update("Completed: 0 sessions")
+            timer_widget.mode = "Focus"
+            timer_widget.reset_timer_to_mode()
+            self.notify("Pomodoro session reset completely.", title="Session Reset", severity="information")
+        except Exception:
+            pass
+
+    def update_active_task_display(self) -> None:
+        try:
+            timer_widget = self.query_one(TimerWidget)
+            active_label = timer_widget.query_one("#active-task-display", Label)
+
+            active_task = None
+            if self.active_task_id:
+                for task in self.config.get("tasks", []):
+                    if task["id"] == self.active_task_id:
+                        active_task = task
+                        break
+
+            if active_task:
+                active_label.update(f"Active Task: [bold #f9e2af]{active_task['title']}[/bold #f9e2af]")
+                timer_widget.query_one("#timer-clock").add_class("timer-clock-active")
+            else:
+                active_label.update("No active task selected")
+                timer_widget.query_one("#timer-clock").remove_class("timer-clock-active")
+        except Exception:
+            pass
+
+    def increment_active_task_pomodoro(self) -> None:
+        if not self.active_task_id:
+            return
+
+        for task in self.config["tasks"]:
+            if task["id"] == self.active_task_id:
+                task["pomodoros"] += 1
+                self.notify(f"Pomodoro recorded for: {task['title']}", title="Task Updated", severity="success") #type: ignore
+                break
+        save_config(self.config)
+
+        try:
+            task_list_widget = self.query_one(TaskListWidget)
+            task_list_widget.refresh_tasks()
+        except Exception:
+            pass
+
+    def on_settings_updated(self) -> None:
+        try:
+            timer_widget = self.query_one(TimerWidget)
+            if not timer_widget.is_running:
+                timer_widget.reset_timer_to_mode()
+        except Exception:
+            pass
+
+def main():
+    app = PomodoroApp()
+    app.run()
+
+if __name__ == "__main__":
+    main()

pttm-0.1.0/pttm/clock.py

@@ -0,0 +1,28 @@
+# Big blocky font digits for the clock
+DIGITS = {
+    '0': ["███", "█ █", "█ █", "█ █", "███"],
+    '1': [" █ ", "██ ", " █ ", " █ ", "███"],
+    '2': ["███", "  █", "███", "█  ", "███"],
+    '3': ["███", "  █", "███", "  █", "███"],
+    '4': ["█ █", "█ █", "███", "  █", "  █"],
+    '5': ["███", "█  ", "███", "  █", "███"],
+    '6': ["███", "█  ", "███", "█ █", "███"],
+    '7': ["███", "  █", "  █", "  █", "  █"],
+    '8': ["███", "█ █", "███", "█ █", "███"],
+    '9': ["███", "█ █", "███", "  █", "███"],
+    ':': ["   ", " █ ", "   ", " █ ", "   "],
+    ' ': ["   ", "   ", "   ", "   ", "   "]
+}
+
+def make_clock_ascii(seconds: int) -> str:
+    mins = seconds // 60
+    secs = seconds % 60
+    time_str = f"{mins:02d}:{secs:02d}"
+
+    lines = ["", "", "", "", ""]
+    for char in time_str:
+        char_lines = DIGITS.get(char, DIGITS[' '])
+        for idx in range(5):
+            lines[idx] += char_lines[idx] + "  "
+
+    return "\n".join(lines)

pttm-0.1.0/pttm/config.py

@@ -0,0 +1,53 @@
+import json
+import os
+import platformdirs
+
+CONFIG_PATH_ENV = os.getenv("PMO_CONFIG_PATH")
+if CONFIG_PATH_ENV:
+    CONFIG_FILE = CONFIG_PATH_ENV
+else:
+    CONFIG_DIR = platformdirs.user_config_dir("pttm", appauthor=False)
+    CONFIG_FILE = os.path.join(CONFIG_DIR, "pttm_config.json")
+
+DEFAULT_CONFIG = {
+    "settings": {
+        "focus_time": 25,
+        "short_break_time": 5,
+        "long_break_time": 15,
+        "long_break_interval": 4
+    },
+    "completed_focus_sessions": 0,
+    "tasks": [
+        {"id": "1", "title": "Task 1", "completed": True, "pomodoros": 1},
+        {"id": "2", "title": "Task 2", "completed": False, "pomodoros": 0},
+        {"id": "3", "title": "Task 3", "completed": False, "pomodoros": 0}
+    ]
+}
+
+def load_config():
+    if os.path.exists(CONFIG_FILE):
+        try:
+            with open(CONFIG_FILE, "r") as f:
+                config = json.load(f)
+                # Ensure all sections exist
+                if "settings" not in config:
+                    config["settings"] = DEFAULT_CONFIG["settings"]
+                if "tasks" not in config:
+                    config["tasks"] = DEFAULT_CONFIG["tasks"]
+                if "completed_focus_sessions" not in config:
+                    config["completed_focus_sessions"] = 0
+                return config
+        except Exception:
+            return DEFAULT_CONFIG.copy()
+    return DEFAULT_CONFIG.copy()
+
+def save_config(config):
+    try:
+        dir_name = os.path.dirname(CONFIG_FILE)
+        if dir_name:
+            os.makedirs(dir_name, exist_ok=True)
+        with open(CONFIG_FILE, "w") as f:
+            json.dump(config, f, indent=4)
+    except Exception:
+        pass
+