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

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
tm_timer-2.1/PKG-INFO ADDED
@@ -0,0 +1,116 @@
1
+ Metadata-Version: 2.4
2
+ Name: tm-timer
3
+ Version: 2.1
4
+ Summary: Minimalistic terminal-based timer with Study/Train tracking
5
+ Author: ph4nt01
6
+ Author-email: Ph4nt01 <ph4nt0.84@email.com>
7
+ License: MIT
8
+ Requires-Python: >=3.6
9
+ Description-Content-Type: text/markdown
10
+ Dynamic: author
11
+ Dynamic: requires-python
12
+
13
+ # In The Name of God
14
+
15
+ ---
16
+ # ⏱️ tm-timer
17
+ >Minimalistic Terminal timer with Study session tracking
18
+
19
+ ## Features
20
+
21
+ - Countdown timer:
22
+ - `tm 10s`, `tm 25m`, `tm 1h30m`
23
+ - Study/Train modes:
24
+ - `tm --study` → track study sessions (resets daily, accumulates across multiple runs)
25
+ - `tm --train` → track training sessions (same behavior, separate table)
26
+ - Daily logging:
27
+ - Records totals in `~/.tm_timer/data.json`
28
+ - Each day resets at midnight
29
+ - Statistics:
30
+ - Average daily hours
31
+ - Standard Deviation of Time
32
+ - Status report:
33
+ - **Very Good** (SD < AVG/2)
34
+ - **Good** (SD = AVG/2)
35
+ - **Not Good** (SD > AVG/2)
36
+ - Export:
37
+ - `tm --studystatus` → show study table + stats
38
+ - `tm --trainstatus` → show train table + stats
39
+ - `tm --tables` → export both tables to `tables.md`
40
+ - Controls:
41
+ - `p` → pause/resume
42
+ - `q` → quit and save
43
+
44
+ ---
45
+
46
+ ## Installation
47
+
48
+ ```bash
49
+ sudo apt install pipx # if not installed
50
+ pipx install tm-timer # install tm-timer
51
+ pipx ensurepath # add tm to PATH
52
+ exec $SHELL # reload shell
53
+ ````
54
+
55
+ ---
56
+
57
+ ## Example Usage
58
+
59
+ ```bash
60
+ # Start a study session
61
+ tm --study
62
+
63
+ # Check study stats
64
+ tm --studystatus
65
+
66
+ # Start a train session
67
+ tm --train
68
+
69
+ # Export tables to tables.md
70
+ tm --tables
71
+ ```
72
+
73
+ ---
74
+
75
+ ## Example Tables Output
76
+
77
+ ```markdown
78
+ # tm_timer Tables
79
+
80
+ ---
81
+
82
+ ## STUDY Table
83
+
84
+ | Date | Day | Time |
85
+ | ---------- | --- | ------ |
86
+ | 2025-10-03 | FRI | 05:00:00 |
87
+ | 2025-10-02 | THU | 02:50:00 |
88
+ | 2025-09-29 | MON | 04:05:00 |
89
+ | 2025-09-27 | SAT | 03:36:00 |
90
+
91
+ **[AVG] = 3.98h [Standard Deviation of Time] = 0.75h Status = Very Good**
92
+
93
+ ---
94
+
95
+ ## TRAIN Table
96
+
97
+ | Date | Day | Time |
98
+ | ---------- | --- | ------ |
99
+ | 2025-10-03 | FRI | 00:57:00 |
100
+ | 2025-10-02 | THU | 00:50:00 |
101
+ | 2025-09-30 | SUN | 00:35:00 |
102
+ | 2025-09-28 | SAT | 01:36:00 |
103
+
104
+ **[AVG] = 1.05h [Standard Deviation of Time] = 0.38h Status = Very Good**
105
+ ```
106
+
107
+ ---
108
+
109
+ ## Preview
110
+
111
+
112
+ ![Timer preview](demo1.gif)
113
+
114
+ ![Timer preview](demo2.gif)
115
+
116
+ ![Timer preview](demo3.gif)
tm_timer-2.1/README.md ADDED
@@ -0,0 +1,104 @@
1
+ # In The Name of God
2
+
3
+ ---
4
+ # ⏱️ tm-timer
5
+ >Minimalistic Terminal timer with Study session tracking
6
+
7
+ ## Features
8
+
9
+ - Countdown timer:
10
+ - `tm 10s`, `tm 25m`, `tm 1h30m`
11
+ - Study/Train modes:
12
+ - `tm --study` → track study sessions (resets daily, accumulates across multiple runs)
13
+ - `tm --train` → track training sessions (same behavior, separate table)
14
+ - Daily logging:
15
+ - Records totals in `~/.tm_timer/data.json`
16
+ - Each day resets at midnight
17
+ - Statistics:
18
+ - Average daily hours
19
+ - Standard Deviation of Time
20
+ - Status report:
21
+ - **Very Good** (SD < AVG/2)
22
+ - **Good** (SD = AVG/2)
23
+ - **Not Good** (SD > AVG/2)
24
+ - Export:
25
+ - `tm --studystatus` → show study table + stats
26
+ - `tm --trainstatus` → show train table + stats
27
+ - `tm --tables` → export both tables to `tables.md`
28
+ - Controls:
29
+ - `p` → pause/resume
30
+ - `q` → quit and save
31
+
32
+ ---
33
+
34
+ ## Installation
35
+
36
+ ```bash
37
+ sudo apt install pipx # if not installed
38
+ pipx install tm-timer # install tm-timer
39
+ pipx ensurepath # add tm to PATH
40
+ exec $SHELL # reload shell
41
+ ````
42
+
43
+ ---
44
+
45
+ ## Example Usage
46
+
47
+ ```bash
48
+ # Start a study session
49
+ tm --study
50
+
51
+ # Check study stats
52
+ tm --studystatus
53
+
54
+ # Start a train session
55
+ tm --train
56
+
57
+ # Export tables to tables.md
58
+ tm --tables
59
+ ```
60
+
61
+ ---
62
+
63
+ ## Example Tables Output
64
+
65
+ ```markdown
66
+ # tm_timer Tables
67
+
68
+ ---
69
+
70
+ ## STUDY Table
71
+
72
+ | Date | Day | Time |
73
+ | ---------- | --- | ------ |
74
+ | 2025-10-03 | FRI | 05:00:00 |
75
+ | 2025-10-02 | THU | 02:50:00 |
76
+ | 2025-09-29 | MON | 04:05:00 |
77
+ | 2025-09-27 | SAT | 03:36:00 |
78
+
79
+ **[AVG] = 3.98h [Standard Deviation of Time] = 0.75h Status = Very Good**
80
+
81
+ ---
82
+
83
+ ## TRAIN Table
84
+
85
+ | Date | Day | Time |
86
+ | ---------- | --- | ------ |
87
+ | 2025-10-03 | FRI | 00:57:00 |
88
+ | 2025-10-02 | THU | 00:50:00 |
89
+ | 2025-09-30 | SUN | 00:35:00 |
90
+ | 2025-09-28 | SAT | 01:36:00 |
91
+
92
+ **[AVG] = 1.05h [Standard Deviation of Time] = 0.38h Status = Very Good**
93
+ ```
94
+
95
+ ---
96
+
97
+ ## Preview
98
+
99
+
100
+ ![Timer preview](demo1.gif)
101
+
102
+ ![Timer preview](demo2.gif)
103
+
104
+ ![Timer preview](demo3.gif)
@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
4
4
 
5
5
  [project]
6
6
  name = "tm-timer"
7
- version = "2.0"
7
+ version = "2.1"
8
8
  description = "Minimalistic terminal-based timer with Study/Train tracking"
9
9
  readme = "README.md"
10
10
  authors = [{ name="Ph4nt01", email="ph4nt0.84@email.com" }]
@@ -2,7 +2,7 @@ from setuptools import setup, find_packages
2
2
 
3
3
  setup(
4
4
  name="tm-timer",
5
- version="2.0",
5
+ version="2.1",
6
6
  packages=find_packages(),
7
7
  entry_points={
8
8
  "console_scripts": [
@@ -215,10 +215,10 @@ def run_activity(activity):
215
215
  stats_before = compute_stats_for_activity(activity)
216
216
  if stats_before["n"] >= 2:
217
217
  print(
218
- 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'])}"
218
+ 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'])}"
219
219
  )
220
220
  else:
221
- print("[Before] Not enough recordings to compute AVG/SD (need 2+ days).")
221
+ print("Not enough recordings to compute AVG/SD (need 2+ days).")
222
222
 
223
223
  # input listener thread
224
224
  def input_listener():
@@ -0,0 +1,116 @@
1
+ Metadata-Version: 2.4
2
+ Name: tm-timer
3
+ Version: 2.1
4
+ Summary: Minimalistic terminal-based timer with Study/Train tracking
5
+ Author: ph4nt01
6
+ Author-email: Ph4nt01 <ph4nt0.84@email.com>
7
+ License: MIT
8
+ Requires-Python: >=3.6
9
+ Description-Content-Type: text/markdown
10
+ Dynamic: author
11
+ Dynamic: requires-python
12
+
13
+ # In The Name of God
14
+
15
+ ---
16
+ # ⏱️ tm-timer
17
+ >Minimalistic Terminal timer with Study session tracking
18
+
19
+ ## Features
20
+
21
+ - Countdown timer:
22
+ - `tm 10s`, `tm 25m`, `tm 1h30m`
23
+ - Study/Train modes:
24
+ - `tm --study` → track study sessions (resets daily, accumulates across multiple runs)
25
+ - `tm --train` → track training sessions (same behavior, separate table)
26
+ - Daily logging:
27
+ - Records totals in `~/.tm_timer/data.json`
28
+ - Each day resets at midnight
29
+ - Statistics:
30
+ - Average daily hours
31
+ - Standard Deviation of Time
32
+ - Status report:
33
+ - **Very Good** (SD < AVG/2)
34
+ - **Good** (SD = AVG/2)
35
+ - **Not Good** (SD > AVG/2)
36
+ - Export:
37
+ - `tm --studystatus` → show study table + stats
38
+ - `tm --trainstatus` → show train table + stats
39
+ - `tm --tables` → export both tables to `tables.md`
40
+ - Controls:
41
+ - `p` → pause/resume
42
+ - `q` → quit and save
43
+
44
+ ---
45
+
46
+ ## Installation
47
+
48
+ ```bash
49
+ sudo apt install pipx # if not installed
50
+ pipx install tm-timer # install tm-timer
51
+ pipx ensurepath # add tm to PATH
52
+ exec $SHELL # reload shell
53
+ ````
54
+
55
+ ---
56
+
57
+ ## Example Usage
58
+
59
+ ```bash
60
+ # Start a study session
61
+ tm --study
62
+
63
+ # Check study stats
64
+ tm --studystatus
65
+
66
+ # Start a train session
67
+ tm --train
68
+
69
+ # Export tables to tables.md
70
+ tm --tables
71
+ ```
72
+
73
+ ---
74
+
75
+ ## Example Tables Output
76
+
77
+ ```markdown
78
+ # tm_timer Tables
79
+
80
+ ---
81
+
82
+ ## STUDY Table
83
+
84
+ | Date | Day | Time |
85
+ | ---------- | --- | ------ |
86
+ | 2025-10-03 | FRI | 05:00:00 |
87
+ | 2025-10-02 | THU | 02:50:00 |
88
+ | 2025-09-29 | MON | 04:05:00 |
89
+ | 2025-09-27 | SAT | 03:36:00 |
90
+
91
+ **[AVG] = 3.98h [Standard Deviation of Time] = 0.75h Status = Very Good**
92
+
93
+ ---
94
+
95
+ ## TRAIN Table
96
+
97
+ | Date | Day | Time |
98
+ | ---------- | --- | ------ |
99
+ | 2025-10-03 | FRI | 00:57:00 |
100
+ | 2025-10-02 | THU | 00:50:00 |
101
+ | 2025-09-30 | SUN | 00:35:00 |
102
+ | 2025-09-28 | SAT | 01:36:00 |
103
+
104
+ **[AVG] = 1.05h [Standard Deviation of Time] = 0.38h Status = Very Good**
105
+ ```
106
+
107
+ ---
108
+
109
+ ## Preview
110
+
111
+
112
+ ![Timer preview](demo1.gif)
113
+
114
+ ![Timer preview](demo2.gif)
115
+
116
+ ![Timer preview](demo3.gif)
@@ -1,4 +1,3 @@
1
- LICENSE
2
1
  README.md
3
2
  pyproject.toml
4
3
  setup.py
tm_timer-2.0/LICENSE DELETED
@@ -1,22 +0,0 @@
1
- MIT License
2
-
3
- Copyright (c) 2025 Ph4nt01
4
-
5
- Permission is hereby granted, free of charge, to any person obtaining a copy
6
- of this software and associated documentation files (the "Software"), to deal
7
- in the Software without restriction, including without limitation the rights
8
- to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
- copies of the Software, and to permit persons to whom the Software is
10
- furnished to do so, subject to the following conditions:
11
-
12
- The above copyright notice and this permission notice shall be included in
13
- all copies or substantial portions of the Software.
14
-
15
- THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
- IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
- FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
- AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
- LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
20
- FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
21
- DEALINGS IN THE SOFTWARE.
22
-
tm_timer-2.0/PKG-INFO DELETED
@@ -1,67 +0,0 @@
1
- Metadata-Version: 2.4
2
- Name: tm-timer
3
- Version: 2.0
4
- Summary: Minimalistic terminal-based timer with Study/Train tracking
5
- Author: ph4nt01
6
- Author-email: Ph4nt01 <ph4nt0.84@email.com>
7
- License: MIT
8
- Requires-Python: >=3.6
9
- Description-Content-Type: text/markdown
10
- License-File: LICENSE
11
- Dynamic: author
12
- Dynamic: license-file
13
- Dynamic: requires-python
14
-
15
- # In The Name of God
16
-
17
- ---
18
-
19
- ## ⏱ tm : Minimalistic Terminal-based timer with Study/Train tracking
20
-
21
- ### Features:
22
-
23
- - Run from terminal:
24
- - Countdown timer: `tm 10s`, `tm 25m`, `tm 1h30m`
25
- - Study session: `tm --study` (tracks across sessions, resets daily)
26
- - Train session: `tm --train` (tracks across sessions, resets daily)
27
- - Daily study/train totals saved in `~/.tm_timer/data.json`
28
- - Tables and statistics:
29
- - `tm --studystatus` / `tm --trainstatus` → show daily table and Standard Deviation
30
- - `tm --tables` → export `tables.md`
31
- - Statistics:
32
- - Average daily hours
33
- - Standard Deviation of daily hours
34
- - Status report (Very Good / Good / Not Good)
35
- - Controls:
36
- - Press `p` to pause/resume
37
- - Press `q` to quit early
38
- - Supports human durations like `2h45m30s`
39
- - Simple, no graphical BLOAT.
40
-
41
- ---
42
-
43
- ### Installation:
44
-
45
- ```bash
46
- sudo apt install pipx # if not installed
47
- pipx install tm-timer # to install tm-timer
48
- pipx ensurepath # to add tm to PATH
49
- exec $SHELL # reload shell
50
-
51
- #or run locally with using cli.py
52
- python3 cli.py 3h40m
53
- ```
54
-
55
- Example Usage:
56
- bash
57
- Copy code
58
- tm --study
59
- # Timer starts, press 'q' to stop, progress saved daily
60
-
61
- tm --studystatus
62
- # Shows study table and stats
63
-
64
- tm --tables
65
- # Exports study/train tables as tables.md
66
- ⏱ tm preview:
67
-
tm_timer-2.0/README.md DELETED
@@ -1,53 +0,0 @@
1
- # In The Name of God
2
-
3
- ---
4
-
5
- ## ⏱ tm : Minimalistic Terminal-based timer with Study/Train tracking
6
-
7
- ### Features:
8
-
9
- - Run from terminal:
10
- - Countdown timer: `tm 10s`, `tm 25m`, `tm 1h30m`
11
- - Study session: `tm --study` (tracks across sessions, resets daily)
12
- - Train session: `tm --train` (tracks across sessions, resets daily)
13
- - Daily study/train totals saved in `~/.tm_timer/data.json`
14
- - Tables and statistics:
15
- - `tm --studystatus` / `tm --trainstatus` → show daily table and Standard Deviation
16
- - `tm --tables` → export `tables.md`
17
- - Statistics:
18
- - Average daily hours
19
- - Standard Deviation of daily hours
20
- - Status report (Very Good / Good / Not Good)
21
- - Controls:
22
- - Press `p` to pause/resume
23
- - Press `q` to quit early
24
- - Supports human durations like `2h45m30s`
25
- - Simple, no graphical BLOAT.
26
-
27
- ---
28
-
29
- ### Installation:
30
-
31
- ```bash
32
- sudo apt install pipx # if not installed
33
- pipx install tm-timer # to install tm-timer
34
- pipx ensurepath # to add tm to PATH
35
- exec $SHELL # reload shell
36
-
37
- #or run locally with using cli.py
38
- python3 cli.py 3h40m
39
- ```
40
-
41
- Example Usage:
42
- bash
43
- Copy code
44
- tm --study
45
- # Timer starts, press 'q' to stop, progress saved daily
46
-
47
- tm --studystatus
48
- # Shows study table and stats
49
-
50
- tm --tables
51
- # Exports study/train tables as tables.md
52
- ⏱ tm preview:
53
-
@@ -1,67 +0,0 @@
1
- Metadata-Version: 2.4
2
- Name: tm-timer
3
- Version: 2.0
4
- Summary: Minimalistic terminal-based timer with Study/Train tracking
5
- Author: ph4nt01
6
- Author-email: Ph4nt01 <ph4nt0.84@email.com>
7
- License: MIT
8
- Requires-Python: >=3.6
9
- Description-Content-Type: text/markdown
10
- License-File: LICENSE
11
- Dynamic: author
12
- Dynamic: license-file
13
- Dynamic: requires-python
14
-
15
- # In The Name of God
16
-
17
- ---
18
-
19
- ## ⏱ tm : Minimalistic Terminal-based timer with Study/Train tracking
20
-
21
- ### Features:
22
-
23
- - Run from terminal:
24
- - Countdown timer: `tm 10s`, `tm 25m`, `tm 1h30m`
25
- - Study session: `tm --study` (tracks across sessions, resets daily)
26
- - Train session: `tm --train` (tracks across sessions, resets daily)
27
- - Daily study/train totals saved in `~/.tm_timer/data.json`
28
- - Tables and statistics:
29
- - `tm --studystatus` / `tm --trainstatus` → show daily table and Standard Deviation
30
- - `tm --tables` → export `tables.md`
31
- - Statistics:
32
- - Average daily hours
33
- - Standard Deviation of daily hours
34
- - Status report (Very Good / Good / Not Good)
35
- - Controls:
36
- - Press `p` to pause/resume
37
- - Press `q` to quit early
38
- - Supports human durations like `2h45m30s`
39
- - Simple, no graphical BLOAT.
40
-
41
- ---
42
-
43
- ### Installation:
44
-
45
- ```bash
46
- sudo apt install pipx # if not installed
47
- pipx install tm-timer # to install tm-timer
48
- pipx ensurepath # to add tm to PATH
49
- exec $SHELL # reload shell
50
-
51
- #or run locally with using cli.py
52
- python3 cli.py 3h40m
53
- ```
54
-
55
- Example Usage:
56
- bash
57
- Copy code
58
- tm --study
59
- # Timer starts, press 'q' to stop, progress saved daily
60
-
61
- tm --studystatus
62
- # Shows study table and stats
63
-
64
- tm --tables
65
- # Exports study/train tables as tables.md
66
- ⏱ tm preview:
67
-
File without changes
File without changes