tm-timer 2.0__tar.gz → 2.2__tar.gz

tm_timer-2.2/PKG-INFO

@@ -0,0 +1,108 @@
+Metadata-Version: 2.4
+Name: tm-timer
+Version: 2.2
+Summary: Minimalistic terminal-based timer with Study/Train tracking
+Author: ph4nt01
+Author-email: Ph4nt01 <ph4nt0.84@email.com>
+License: MIT
+Requires-Python: >=3.6
+Description-Content-Type: text/markdown
+Dynamic: author
+Dynamic: requires-python
+
+# In The Name of God
+
+---
+# ⏱️ tm-timer
+> Minimalistic Terminal timer with dynamic activity tracking
+
+## Features
+
+- Countdown timer:
+  - `tm 10s`, `tm 25m`, `tm 1h30m`
+- Dynamic Activity modes (track anything):
+  - `tm -a study` -> track study sessions
+  - `tm -a train` -> track training sessions
+  - `tm -a reading` -> track custom activities (resets daily, accumulates across multiple runs)
+- Daily logging:
+  - Records totals in `~/.tm_timer/data.json`
+  - Each day resets at midnight (splits time correctly if a session crosses midnight)
+- Statistics:
+  - Average daily hours
+  - Standard Deviation of Time
+  - Status report:
+    - **Very Good** (SD < AVG/2)  
+    - **Good** (SD = AVG/2)  
+    - **Not Good** (SD > AVG/2)
+- Export & Management:
+  - `tm -s study` -> show study table + stats
+  - `tm --list` -> list all tracked activities and their total time
+  - `tm -t` -> export all activity tables to `tables.md`
+- Controls:
+  - `p` -> pause/resume
+  - `q` -> quit and save
+
+---
+
+## Installation
+
+```bash
+sudo apt install pipx       # if not installed
+pipx install tm-timer       # install tm-timer
+pipx ensurepath             # add tm to PATH
+exec $SHELL                 # reload shell
+````
+
+---
+
+## Example Usage
+
+```bash
+# Start a study session
+tm -a study
+
+# Check study stats
+tm -s study
+
+# Start a train session
+tm -a train
+
+# Start a custom activity session (e.g., reading)
+tm -a reading
+
+# List all recorded activities
+tm --list
+
+# Export tables to tables.md
+tm -t
+```
+
+---
+
+## Example Tables Output
+
+```markdown
+## STUDY Table
+
+| Date       | Day | Time   |
+| ---------- | --- | ------ |
+| 2025-10-03 | FRI | 05:00:00 |
+| 2025-10-02 | THU | 02:50:00 |
+| 2025-09-29 | MON | 04:05:00 |
+| 2025-09-27 | SAT | 03:36:00 |
+
+[AVG] = 3.98h    [Standard Deviation of Time] = 0.75h    Status = Very Good
+
+
+## TRAIN Table
+
+| Date       | Day | Time   |
+| ---------- | --- | ------ |
+| 2025-10-03 | FRI | 00:57:00 |
+| 2025-10-02 | THU | 00:50:00 |
+| 2025-09-30 | SUN | 00:35:00 |
+| 2025-09-28 | SAT | 01:36:00 |
+
+[AVG] = 1.05h    [Standard Deviation of Time] = 0.38h    Status = Very Good
+```
+

tm_timer-2.2/README.md

@@ -0,0 +1,96 @@
+# In The Name of God
+
+---
+# ⏱️ tm-timer
+> Minimalistic Terminal timer with dynamic activity tracking
+
+## Features
+
+- Countdown timer:
+  - `tm 10s`, `tm 25m`, `tm 1h30m`
+- Dynamic Activity modes (track anything):
+  - `tm -a study` -> track study sessions
+  - `tm -a train` -> track training sessions
+  - `tm -a reading` -> track custom activities (resets daily, accumulates across multiple runs)
+- Daily logging:
+  - Records totals in `~/.tm_timer/data.json`
+  - Each day resets at midnight (splits time correctly if a session crosses midnight)
+- Statistics:
+  - Average daily hours
+  - Standard Deviation of Time
+  - Status report:
+    - **Very Good** (SD < AVG/2)  
+    - **Good** (SD = AVG/2)  
+    - **Not Good** (SD > AVG/2)
+- Export & Management:
+  - `tm -s study` -> show study table + stats
+  - `tm --list` -> list all tracked activities and their total time
+  - `tm -t` -> export all activity tables to `tables.md`
+- Controls:
+  - `p` -> pause/resume
+  - `q` -> quit and save
+
+---
+
+## Installation
+
+```bash
+sudo apt install pipx       # if not installed
+pipx install tm-timer       # install tm-timer
+pipx ensurepath             # add tm to PATH
+exec $SHELL                 # reload shell
+````
+
+---
+
+## Example Usage
+
+```bash
+# Start a study session
+tm -a study
+
+# Check study stats
+tm -s study
+
+# Start a train session
+tm -a train
+
+# Start a custom activity session (e.g., reading)
+tm -a reading
+
+# List all recorded activities
+tm --list
+
+# Export tables to tables.md
+tm -t
+```
+
+---
+
+## Example Tables Output
+
+```markdown
+## STUDY Table
+
+| Date       | Day | Time   |
+| ---------- | --- | ------ |
+| 2025-10-03 | FRI | 05:00:00 |
+| 2025-10-02 | THU | 02:50:00 |
+| 2025-09-29 | MON | 04:05:00 |
+| 2025-09-27 | SAT | 03:36:00 |
+
+[AVG] = 3.98h    [Standard Deviation of Time] = 0.75h    Status = Very Good
+
+
+## TRAIN Table
+
+| Date       | Day | Time   |
+| ---------- | --- | ------ |
+| 2025-10-03 | FRI | 00:57:00 |
+| 2025-10-02 | THU | 00:50:00 |
+| 2025-09-30 | SUN | 00:35:00 |
+| 2025-09-28 | SAT | 01:36:00 |
+
+[AVG] = 1.05h    [Standard Deviation of Time] = 0.38h    Status = Very Good
+```
+

{tm_timer-2.0 → tm_timer-2.2}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "tm-timer"
-version = "2.0"
+version = "2.2"
 description = "Minimalistic terminal-based timer with Study/Train tracking"
 readme = "README.md"
 authors = [{ name="Ph4nt01", email="ph4nt0.84@email.com" }]

{tm_timer-2.0 → tm_timer-2.2}/setup.py

@@ -2,7 +2,7 @@ from setuptools import setup, find_packages
 
 setup(
     name="tm-timer",
-    version="2.0",
+    version="2.2",
     packages=find_packages(),
     entry_points={
         "console_scripts": [

{tm_timer-2.0 → tm_timer-2.2}/tm_timer/cli.py

@@ -57,18 +57,21 @@ DATA_FILE = DATA_DIR / "data.json"
 
 def load_data():
     if not DATA_FILE.exists():
-        return {"study": {}, "train": {}}
+        return {}
     try:
         with DATA_FILE.open("r", encoding="utf-8") as f:
             data = json.load(f)
     except Exception:
-        return {"study": {}, "train": {}}
-    # Ensure keys
-    if "study" not in data:
-        data["study"] = {}
-    if "train" not in data:
-        data["train"] = {}
-    return data
+        return {}
+    if not isinstance(data, dict):
+        return {}
+    # normalize: every value must be a dict of {date_str: int_seconds}
+    cleaned = {}
+    for activity, days in data.items():
+        if not isinstance(days, dict):
+            continue
+        cleaned[activity] = {str(k): int(v) for k, v in days.items()}
+    return cleaned
 
 
 def save_data(data):
@@ -159,11 +162,12 @@ def print_activity_table(activity):
 def write_tables_md(path="tables.md"):
     data = load_data()
     lines = []
-    for activity in ("study", "train"):
+    for activity in sorted(data.keys()):
         lines.append(f"## {activity.upper()} Table\n")
         lines.append("| Date | Day | Time |\n")
         lines.append("| ---- | --- | ---- |\n")
-        items = sorted(data.get(activity, {}).items(), key=lambda kv: kv[0], reverse=True)
+        items = sorted(data.get(activity, {}).items(),
+                       key=lambda kv: kv[0], reverse=True)
         for date_str, secs in items:
             try:
                 dt = datetime.datetime.strptime(date_str, "%Y-%m-%d").date()
@@ -171,13 +175,17 @@ def write_tables_md(path="tables.md"):
             except Exception:
                 day_name = ""
             lines.append(f"| {date_str} | {day_name} | {format_hms(secs)} |\n")
+
         stats = compute_stats_for_activity(activity)
         if stats["n"] < 2:
             lines.append("\nNot enough recording for statistics (need 2+ days).\n\n")
         else:
             lines.append(
-                f"\n[AVG] = {stats['avg']:.2f}h    [Standard Deviation of Time] = {stats['sd']:.2f}h    Status = {status_from_avg_sd(stats['avg'], stats['sd'])}\n\n"
+                f"\n[AVG] = {stats['avg']:.2f}h    "
+                f"[Standard Deviation of Time] = {stats['sd']:.2f}h    "
+                f"Status = {status_from_avg_sd(stats['avg'], stats['sd'])}\n\n"
             )
+
     out_path = Path.cwd() / path
     out_path.write_text("".join(lines), encoding="utf-8")
     return str(out_path.resolve())
@@ -215,10 +223,10 @@ def run_activity(activity):
     stats_before = compute_stats_for_activity(activity)
     if stats_before["n"] >= 2:
         print(
-            f"[Before] [AVG] = {stats_before['avg']:.2f}h    [Standard Deviation of Time] = {stats_before['sd']:.2f}h    Status = {status_from_avg_sd(stats_before['avg'], stats_before['sd'])}"
+            f"[AVG] = {stats_before['avg']:.2f}h    [Standard Deviation of Time] = {stats_before['sd']:.2f}h    Status = {status_from_avg_sd(stats_before['avg'], stats_before['sd'])}"
         )
     else:
-        print("[Before] Not enough recordings to compute AVG/SD (need 2+ days).")
+        print("Not enough recordings to compute AVG/SD (need 2+ days).")
 
     # input listener thread
     def input_listener():
@@ -337,37 +345,93 @@ def run_countdown(target_seconds, target_input):
     print("Timer stopped.")
 
 
-# --- CLI entrypoint ---
+# Back-compat alias map: old flag -> activity name
+# LEGACY_ALIASES = {
+#     "study": "study",
+#     "train": "train",
+#     "studystatus": "study",   # for --studystatus
+#     "trainstatus": "train",   # for --trainstatus
+# }
+
+
 def main():
-    parser = argparse.ArgumentParser(description="tm_timer - terminal timer with study/train logging")
-    parser.add_argument("--study", action="store_true", help="Run study timer (no limit until 'q')")
-    parser.add_argument("--train", action="store_true", help="Run train timer (no limit until 'q')")
-    parser.add_argument("--studystatus", action="store_true", help="Show study daily table and SD")
-    parser.add_argument("--trainstatus", action="store_true", help="Show train daily table and SD")
-    parser.add_argument("--tables", action="store_true", help="Export tables.md to current directory")
-    parser.add_argument("duration", nargs="?", help="Optional duration e.g. 1h30m (if not using --study/--train)")
+    parser = argparse.ArgumentParser(
+        description="tm_timer - terminal timer with per-activity logging",
+        formatter_class=argparse.RawDescriptionHelpFormatter,
+        epilog=(
+            "Examples:\n"
+            "  tm_timer -a study            # start study timer\n"
+            "  tm_timer -a reading          # start a custom 'reading' timer\n"
+            "  tm_timer -s study            # show study table + stats\n"
+            "  tm_timer -t                  # export tables.md\n"
+            "  tm_timer 25m                 # plain countdown\n"
+        ),
+    )
+    parser.add_argument(
+        "-a", "--activity", metavar="NAME",
+        help="Run timer for the given activity (any name you like).",
+    )
+    parser.add_argument(
+        "-s", "--status", metavar="NAME",
+        help="Show daily table and statistics for the given activity.",
+    )
+    parser.add_argument(
+        "--list", action="store_true",
+        help="List all activities recorded so far.",
+    )
+    parser.add_argument(
+        "-t", "--tables", action="store_true",
+        help="Export tables.md (all activities) to the current directory.",
+    )
+
+    # Deprecated back-compat aliases
+    # parser.add_argument("--study",        action="store_true", help="(deprecated) alias for -a study")
+    # parser.add_argument("--train",        action="store_true", help="(deprecated) alias for -a train")
+    # parser.add_argument("--studystatus",  action="store_true", help="(deprecated) alias for --status study")
+    # parser.add_argument("--trainstatus",  action="store_true", help="(deprecated) alias for --status train")
+
+    parser.add_argument("duration", nargs="?",
+                        help="Optional duration e.g. 1h30m (countdown mode).")
     args = parser.parse_args()
 
-    # priority actions
-    if args.studystatus:
-        print_activity_table("study")
-        return
-    if args.trainstatus:
-        print_activity_table("train")
+    # Resolve legacy aliases into the new flags
+    activity  = args.activity
+    status_of = args.status
+    # if args.study:        activity  = activity  or "study"
+    # if args.train:        activity  = activity  or "train"
+    # if args.studystatus:  status_of = status_of or "study"
+    # if args.trainstatus:  status_of = status_of or "train"
+
+    # 1) status
+    if status_of:
+        print_activity_table(status_of)
         return
+
+    # 2) tables export
     if args.tables:
         out = write_tables_md("tables.md")
         print(f"created {out}")
         return
 
-    if args.study:
-        run_activity("study")
+    # 3) list activities
+    if args.list:
+        data = load_data()
+        if not data:
+            print("No activities recorded yet.")
+            return
+        print("Activities:")
+        for name in sorted(data):
+            n_days = len(data[name])
+            total  = sum(data[name].values())
+            print(f"  - {name:<15} {n_days:>3} days   total {format_hms(total)}")
         return
-    if args.train:
-        run_activity("train")
+
+    # 4) run an activity timer
+    if activity:
+        run_activity(activity)
         return
 
-    # fallback: duration countdown (compat)
+    # 5) plain countdown (backward compatible)
     if args.duration:
         try:
             target_seconds = parse_time_input(args.duration)
@@ -375,8 +439,9 @@ def main():
             print(e)
             sys.exit(1)
         run_countdown(target_seconds, args.duration)
-    else:
-        parser.print_help()
+        return
+
+    parser.print_help()
 
 
 if __name__ == "__main__":

tm_timer-2.2/tm_timer.egg-info/PKG-INFO

@@ -0,0 +1,108 @@
+Metadata-Version: 2.4
+Name: tm-timer
+Version: 2.2
+Summary: Minimalistic terminal-based timer with Study/Train tracking
+Author: ph4nt01
+Author-email: Ph4nt01 <ph4nt0.84@email.com>
+License: MIT
+Requires-Python: >=3.6
+Description-Content-Type: text/markdown
+Dynamic: author
+Dynamic: requires-python
+
+# In The Name of God
+
+---
+# ⏱️ tm-timer
+> Minimalistic Terminal timer with dynamic activity tracking
+
+## Features
+
+- Countdown timer:
+  - `tm 10s`, `tm 25m`, `tm 1h30m`
+- Dynamic Activity modes (track anything):
+  - `tm -a study` -> track study sessions
+  - `tm -a train` -> track training sessions
+  - `tm -a reading` -> track custom activities (resets daily, accumulates across multiple runs)
+- Daily logging:
+  - Records totals in `~/.tm_timer/data.json`
+  - Each day resets at midnight (splits time correctly if a session crosses midnight)
+- Statistics:
+  - Average daily hours
+  - Standard Deviation of Time
+  - Status report:
+    - **Very Good** (SD < AVG/2)  
+    - **Good** (SD = AVG/2)  
+    - **Not Good** (SD > AVG/2)
+- Export & Management:
+  - `tm -s study` -> show study table + stats
+  - `tm --list` -> list all tracked activities and their total time
+  - `tm -t` -> export all activity tables to `tables.md`
+- Controls:
+  - `p` -> pause/resume
+  - `q` -> quit and save
+
+---
+
+## Installation
+
+```bash
+sudo apt install pipx       # if not installed
+pipx install tm-timer       # install tm-timer
+pipx ensurepath             # add tm to PATH
+exec $SHELL                 # reload shell
+````
+
+---
+
+## Example Usage
+
+```bash
+# Start a study session
+tm -a study
+
+# Check study stats
+tm -s study
+
+# Start a train session
+tm -a train
+
+# Start a custom activity session (e.g., reading)
+tm -a reading
+
+# List all recorded activities
+tm --list
+
+# Export tables to tables.md
+tm -t
+```
+
+---
+
+## Example Tables Output
+
+```markdown
+## STUDY Table
+
+| Date       | Day | Time   |
+| ---------- | --- | ------ |
+| 2025-10-03 | FRI | 05:00:00 |
+| 2025-10-02 | THU | 02:50:00 |
+| 2025-09-29 | MON | 04:05:00 |
+| 2025-09-27 | SAT | 03:36:00 |
+
+[AVG] = 3.98h    [Standard Deviation of Time] = 0.75h    Status = Very Good
+
+
+## TRAIN Table
+
+| Date       | Day | Time   |
+| ---------- | --- | ------ |
+| 2025-10-03 | FRI | 00:57:00 |
+| 2025-10-02 | THU | 00:50:00 |
+| 2025-09-30 | SUN | 00:35:00 |
+| 2025-09-28 | SAT | 01:36:00 |
+
+[AVG] = 1.05h    [Standard Deviation of Time] = 0.38h    Status = Very Good
+```
+

{tm_timer-2.0 → tm_timer-2.2}/tm_timer.egg-info/SOURCES.txt

@@ -1,4 +1,3 @@
-LICENSE
 README.md
 pyproject.toml
 setup.py

tm_timer-2.0/LICENSE

@@ -1,22 +0,0 @@
-MIT License
-
-Copyright (c) 2025 Ph4nt01
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights  
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell  
-copies of the Software, and to permit persons to whom the Software is  
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in  
-all copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR  
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,  
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE  
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER  
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING  
-FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER  
-DEALINGS IN THE SOFTWARE.
-

tm_timer-2.0/PKG-INFO

@@ -1,67 +0,0 @@
-Metadata-Version: 2.4
-Name: tm-timer
-Version: 2.0
-Summary: Minimalistic terminal-based timer with Study/Train tracking
-Author: ph4nt01
-Author-email: Ph4nt01 <ph4nt0.84@email.com>
-License: MIT
-Requires-Python: >=3.6
-Description-Content-Type: text/markdown
-License-File: LICENSE
-Dynamic: author
-Dynamic: license-file
-Dynamic: requires-python
-
-# In The Name of God
-
----
-
-## ⏱ tm : Minimalistic Terminal-based timer with Study/Train tracking
-
-### Features:
-
-- Run from terminal:  
-  - Countdown timer: `tm 10s`, `tm 25m`, `tm 1h30m`  
-  - Study session: `tm --study` (tracks across sessions, resets daily)  
-  - Train session: `tm --train` (tracks across sessions, resets daily)
-- Daily study/train totals saved in `~/.tm_timer/data.json`
-- Tables and statistics:
-  - `tm --studystatus` / `tm --trainstatus` → show daily table and Standard Deviation
-  - `tm --tables` → export `tables.md`
-- Statistics:
-  - Average daily hours
-  - Standard Deviation of daily hours
-  - Status report (Very Good / Good / Not Good)
-- Controls:
-  - Press `p` to pause/resume
-  - Press `q` to quit early
-- Supports human durations like `2h45m30s`
-- Simple, no graphical BLOAT.
-
----
-
-### Installation:
-
-```bash
-sudo apt install pipx       # if not installed
-pipx install tm-timer       # to install tm-timer
-pipx ensurepath             # to add tm to PATH
-exec $SHELL                 # reload shell
-
-#or run locally with using cli.py
-python3 cli.py 3h40m
-```
-
-Example Usage:
-bash
-Copy code
-tm --study
-# Timer starts, press 'q' to stop, progress saved daily
-
-tm --studystatus
-# Shows study table and stats
-
-tm --tables
-# Exports study/train tables as tables.md
-⏱ tm preview:
-

tm_timer-2.0/README.md

@@ -1,53 +0,0 @@
-# In The Name of God
-
----
-
-## ⏱ tm : Minimalistic Terminal-based timer with Study/Train tracking
-
-### Features:
-
-- Run from terminal:  
-  - Countdown timer: `tm 10s`, `tm 25m`, `tm 1h30m`  
-  - Study session: `tm --study` (tracks across sessions, resets daily)  
-  - Train session: `tm --train` (tracks across sessions, resets daily)
-- Daily study/train totals saved in `~/.tm_timer/data.json`
-- Tables and statistics:
-  - `tm --studystatus` / `tm --trainstatus` → show daily table and Standard Deviation
-  - `tm --tables` → export `tables.md`
-- Statistics:
-  - Average daily hours
-  - Standard Deviation of daily hours
-  - Status report (Very Good / Good / Not Good)
-- Controls:
-  - Press `p` to pause/resume
-  - Press `q` to quit early
-- Supports human durations like `2h45m30s`
-- Simple, no graphical BLOAT.
-
----
-
-### Installation:
-
-```bash
-sudo apt install pipx       # if not installed
-pipx install tm-timer       # to install tm-timer
-pipx ensurepath             # to add tm to PATH
-exec $SHELL                 # reload shell
-
-#or run locally with using cli.py
-python3 cli.py 3h40m
-```
-
-Example Usage:
-bash
-Copy code
-tm --study
-# Timer starts, press 'q' to stop, progress saved daily
-
-tm --studystatus
-# Shows study table and stats
-
-tm --tables
-# Exports study/train tables as tables.md
-⏱ tm preview:
-

tm_timer-2.0/tm_timer.egg-info/PKG-INFO

@@ -1,67 +0,0 @@
-Metadata-Version: 2.4
-Name: tm-timer
-Version: 2.0
-Summary: Minimalistic terminal-based timer with Study/Train tracking
-Author: ph4nt01
-Author-email: Ph4nt01 <ph4nt0.84@email.com>
-License: MIT
-Requires-Python: >=3.6
-Description-Content-Type: text/markdown
-License-File: LICENSE
-Dynamic: author
-Dynamic: license-file
-Dynamic: requires-python
-
-# In The Name of God
-
----
-
-## ⏱ tm : Minimalistic Terminal-based timer with Study/Train tracking
-
-### Features:
-
-- Run from terminal:  
-  - Countdown timer: `tm 10s`, `tm 25m`, `tm 1h30m`  
-  - Study session: `tm --study` (tracks across sessions, resets daily)  
-  - Train session: `tm --train` (tracks across sessions, resets daily)
-- Daily study/train totals saved in `~/.tm_timer/data.json`
-- Tables and statistics:
-  - `tm --studystatus` / `tm --trainstatus` → show daily table and Standard Deviation
-  - `tm --tables` → export `tables.md`
-- Statistics:
-  - Average daily hours
-  - Standard Deviation of daily hours
-  - Status report (Very Good / Good / Not Good)
-- Controls:
-  - Press `p` to pause/resume
-  - Press `q` to quit early
-- Supports human durations like `2h45m30s`
-- Simple, no graphical BLOAT.
-
----
-
-### Installation:
-
-```bash
-sudo apt install pipx       # if not installed
-pipx install tm-timer       # to install tm-timer
-pipx ensurepath             # to add tm to PATH
-exec $SHELL                 # reload shell
-
-#or run locally with using cli.py
-python3 cli.py 3h40m
-```
-
-Example Usage:
-bash
-Copy code
-tm --study
-# Timer starts, press 'q' to stop, progress saved daily
-
-tm --studystatus
-# Shows study table and stats
-
-tm --tables
-# Exports study/train tables as tables.md
-⏱ tm preview:
-