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

{tm_timer-2.1 → tm_timer-2.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: tm-timer
-Version: 2.1
+Version: 2.2
 Summary: Minimalistic terminal-based timer with Study/Train tracking
 Author: ph4nt01
 Author-email: Ph4nt01 <ph4nt0.84@email.com>
@@ -14,18 +14,19 @@ Dynamic: requires-python
 
 ---
 # ⏱️ tm-timer
->Minimalistic Terminal timer with Study session tracking
+> Minimalistic Terminal timer with dynamic activity tracking
 
 ## Features
 
 - Countdown timer:
   - `tm 10s`, `tm 25m`, `tm 1h30m`
-- Study/Train modes:
-  - `tm --study` → track study sessions (resets daily, accumulates across multiple runs)
-  - `tm --train` → track training sessions (same behavior, separate table)
+- 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
+  - Each day resets at midnight (splits time correctly if a session crosses midnight)
 - Statistics:
   - Average daily hours
   - Standard Deviation of Time
@@ -33,13 +34,13 @@ Dynamic: requires-python
     - **Very Good** (SD < AVG/2)  
     - **Good** (SD = AVG/2)  
     - **Not Good** (SD > AVG/2)
-- Export:
-  - `tm --studystatus` → show study table + stats
-  - `tm --trainstatus` → show train table + stats
-  - `tm --tables` → export both tables to `tables.md`
+- 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
+  - `p` -> pause/resume
+  - `q` -> quit and save
 
 ---
 
@@ -58,16 +59,22 @@ exec $SHELL                 # reload shell
 
 ```bash
 # Start a study session
-tm --study
+tm -a study
 
 # Check study stats
-tm --studystatus
+tm -s study
 
 # Start a train session
-tm --train
+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 --tables
+tm -t
 ```
 
 ---
@@ -75,10 +82,6 @@ tm --tables
 ## Example Tables Output
 
 ```markdown
-# tm_timer Tables
-
----
-
 ## STUDY Table
 
 | Date       | Day | Time   |
@@ -88,9 +91,8 @@ tm --tables
 | 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**
+[AVG] = 3.98h    [Standard Deviation of Time] = 0.75h    Status = Very Good
 
----
 
 ## TRAIN Table
 
@@ -101,16 +103,6 @@ tm --tables
 | 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**
+[AVG] = 1.05h    [Standard Deviation of Time] = 0.38h    Status = Very Good
 ```
 
----
-
-## Preview
-
-
-![Timer preview](demo1.gif)
-
-![Timer preview](demo2.gif)
-
-![Timer preview](demo3.gif)

{tm_timer-2.1 → tm_timer-2.2}/README.md

@@ -2,18 +2,19 @@
 
 ---
 # ⏱️ tm-timer
->Minimalistic Terminal timer with Study session tracking
+> Minimalistic Terminal timer with dynamic activity tracking
 
 ## Features
 
 - Countdown timer:
   - `tm 10s`, `tm 25m`, `tm 1h30m`
-- Study/Train modes:
-  - `tm --study` → track study sessions (resets daily, accumulates across multiple runs)
-  - `tm --train` → track training sessions (same behavior, separate table)
+- 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
+  - Each day resets at midnight (splits time correctly if a session crosses midnight)
 - Statistics:
   - Average daily hours
   - Standard Deviation of Time
@@ -21,13 +22,13 @@
     - **Very Good** (SD < AVG/2)  
     - **Good** (SD = AVG/2)  
     - **Not Good** (SD > AVG/2)
-- Export:
-  - `tm --studystatus` → show study table + stats
-  - `tm --trainstatus` → show train table + stats
-  - `tm --tables` → export both tables to `tables.md`
+- 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
+  - `p` -> pause/resume
+  - `q` -> quit and save
 
 ---
 
@@ -46,16 +47,22 @@ exec $SHELL                 # reload shell
 
 ```bash
 # Start a study session
-tm --study
+tm -a study
 
 # Check study stats
-tm --studystatus
+tm -s study
 
 # Start a train session
-tm --train
+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 --tables
+tm -t
 ```
 
 ---
@@ -63,10 +70,6 @@ tm --tables
 ## Example Tables Output
 
 ```markdown
-# tm_timer Tables
-
----
-
 ## STUDY Table
 
 | Date       | Day | Time   |
@@ -76,9 +79,8 @@ tm --tables
 | 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**
+[AVG] = 3.98h    [Standard Deviation of Time] = 0.75h    Status = Very Good
 
----
 
 ## TRAIN Table
 
@@ -89,16 +91,6 @@ tm --tables
 | 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**
+[AVG] = 1.05h    [Standard Deviation of Time] = 0.38h    Status = Very Good
 ```
 
----
-
-## Preview
-
-
-![Timer preview](demo1.gif)
-
-![Timer preview](demo2.gif)
-
-![Timer preview](demo3.gif)

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

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "tm-timer"
-version = "2.1"
+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.1 → tm_timer-2.2}/setup.py

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

{tm_timer-2.1 → 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())
@@ -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.1 → tm_timer-2.2}/tm_timer.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: tm-timer
-Version: 2.1
+Version: 2.2
 Summary: Minimalistic terminal-based timer with Study/Train tracking
 Author: ph4nt01
 Author-email: Ph4nt01 <ph4nt0.84@email.com>
@@ -14,18 +14,19 @@ Dynamic: requires-python
 
 ---
 # ⏱️ tm-timer
->Minimalistic Terminal timer with Study session tracking
+> Minimalistic Terminal timer with dynamic activity tracking
 
 ## Features
 
 - Countdown timer:
   - `tm 10s`, `tm 25m`, `tm 1h30m`
-- Study/Train modes:
-  - `tm --study` → track study sessions (resets daily, accumulates across multiple runs)
-  - `tm --train` → track training sessions (same behavior, separate table)
+- 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
+  - Each day resets at midnight (splits time correctly if a session crosses midnight)
 - Statistics:
   - Average daily hours
   - Standard Deviation of Time
@@ -33,13 +34,13 @@ Dynamic: requires-python
     - **Very Good** (SD < AVG/2)  
     - **Good** (SD = AVG/2)  
     - **Not Good** (SD > AVG/2)
-- Export:
-  - `tm --studystatus` → show study table + stats
-  - `tm --trainstatus` → show train table + stats
-  - `tm --tables` → export both tables to `tables.md`
+- 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
+  - `p` -> pause/resume
+  - `q` -> quit and save
 
 ---
 
@@ -58,16 +59,22 @@ exec $SHELL                 # reload shell
 
 ```bash
 # Start a study session
-tm --study
+tm -a study
 
 # Check study stats
-tm --studystatus
+tm -s study
 
 # Start a train session
-tm --train
+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 --tables
+tm -t
 ```
 
 ---
@@ -75,10 +82,6 @@ tm --tables
 ## Example Tables Output
 
 ```markdown
-# tm_timer Tables
-
----
-
 ## STUDY Table
 
 | Date       | Day | Time   |
@@ -88,9 +91,8 @@ tm --tables
 | 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**
+[AVG] = 3.98h    [Standard Deviation of Time] = 0.75h    Status = Very Good
 
----
 
 ## TRAIN Table
 
@@ -101,16 +103,6 @@ tm --tables
 | 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**
+[AVG] = 1.05h    [Standard Deviation of Time] = 0.38h    Status = Very Good
 ```
 
----
-
-## Preview
-
-
-![Timer preview](demo1.gif)
-
-![Timer preview](demo2.gif)
-
-![Timer preview](demo3.gif)