raj-devpulse-cli 1.0.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.
- raj_devpulse_cli-1.0.1/LICENSE +21 -0
- raj_devpulse_cli-1.0.1/PKG-INFO +221 -0
- raj_devpulse_cli-1.0.1/README.md +194 -0
- raj_devpulse_cli-1.0.1/devpulse/__init__.py +8 -0
- raj_devpulse_cli-1.0.1/devpulse/cli.py +278 -0
- raj_devpulse_cli-1.0.1/devpulse/db.py +244 -0
- raj_devpulse_cli-1.0.1/devpulse/export.py +86 -0
- raj_devpulse_cli-1.0.1/devpulse/heatmap.py +95 -0
- raj_devpulse_cli-1.0.1/devpulse/quotes.py +53 -0
- raj_devpulse_cli-1.0.1/devpulse/ui.py +201 -0
- raj_devpulse_cli-1.0.1/pyproject.toml +46 -0
- raj_devpulse_cli-1.0.1/raj_devpulse_cli.egg-info/PKG-INFO +221 -0
- raj_devpulse_cli-1.0.1/raj_devpulse_cli.egg-info/SOURCES.txt +17 -0
- raj_devpulse_cli-1.0.1/raj_devpulse_cli.egg-info/dependency_links.txt +1 -0
- raj_devpulse_cli-1.0.1/raj_devpulse_cli.egg-info/entry_points.txt +2 -0
- raj_devpulse_cli-1.0.1/raj_devpulse_cli.egg-info/requires.txt +2 -0
- raj_devpulse_cli-1.0.1/raj_devpulse_cli.egg-info/top_level.txt +1 -0
- raj_devpulse_cli-1.0.1/setup.cfg +4 -0
- raj_devpulse_cli-1.0.1/tests/test_core.py +127 -0
|
@@ -0,0 +1,21 @@
|
|
|
1
|
+
MIT License
|
|
2
|
+
|
|
3
|
+
Copyright (c) 2025 Your Name
|
|
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 all
|
|
13
|
+
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 FROM,
|
|
20
|
+
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
|
21
|
+
SOFTWARE.
|
|
@@ -0,0 +1,221 @@
|
|
|
1
|
+
Metadata-Version: 2.4
|
|
2
|
+
Name: raj-devpulse-cli
|
|
3
|
+
Version: 1.0.1
|
|
4
|
+
Summary: ⚡ Terminal-based developer productivity tracker — streaks, sessions, heatmaps & more.
|
|
5
|
+
Author-email: Your Name <you@example.com>
|
|
6
|
+
License: MIT
|
|
7
|
+
Project-URL: Homepage, https://github.com/yourname/devpulse
|
|
8
|
+
Project-URL: Repository, https://github.com/yourname/devpulse
|
|
9
|
+
Project-URL: Bug Tracker, https://github.com/yourname/devpulse/issues
|
|
10
|
+
Keywords: productivity,cli,developer,streak,terminal,coding
|
|
11
|
+
Classifier: Development Status :: 4 - Beta
|
|
12
|
+
Classifier: Environment :: Console
|
|
13
|
+
Classifier: Intended Audience :: Developers
|
|
14
|
+
Classifier: License :: OSI Approved :: MIT License
|
|
15
|
+
Classifier: Operating System :: OS Independent
|
|
16
|
+
Classifier: Programming Language :: Python :: 3
|
|
17
|
+
Classifier: Programming Language :: Python :: 3.10
|
|
18
|
+
Classifier: Programming Language :: Python :: 3.11
|
|
19
|
+
Classifier: Programming Language :: Python :: 3.12
|
|
20
|
+
Classifier: Topic :: Utilities
|
|
21
|
+
Requires-Python: >=3.10
|
|
22
|
+
Description-Content-Type: text/markdown
|
|
23
|
+
License-File: LICENSE
|
|
24
|
+
Requires-Dist: click>=8.1
|
|
25
|
+
Requires-Dist: rich>=13.0
|
|
26
|
+
Dynamic: license-file
|
|
27
|
+
|
|
28
|
+
# ⚡ DevPulse
|
|
29
|
+
|
|
30
|
+
<div align="center">
|
|
31
|
+
|
|
32
|
+

|
|
33
|
+

|
|
34
|
+

|
|
35
|
+

|
|
36
|
+
|
|
37
|
+
**A futuristic terminal productivity tracker for developers.**
|
|
38
|
+
Track coding sessions, streaks, tasks, and stay motivated — all from your terminal.
|
|
39
|
+
|
|
40
|
+
</div>
|
|
41
|
+
|
|
42
|
+
---
|
|
43
|
+
|
|
44
|
+
## ✨ Features
|
|
45
|
+
|
|
46
|
+
| Feature | Description |
|
|
47
|
+
|---|---|
|
|
48
|
+
| 🔥 **Coding Streaks** | Daily streak tracker with all-time best |
|
|
49
|
+
| 🕐 **Session Timer** | Start/stop coding sessions, auto-track hours |
|
|
50
|
+
| ✅ **Task Logger** | Log completed tasks with timestamps |
|
|
51
|
+
| 📈 **Activity Heatmap** | GitHub-style heatmap in your terminal |
|
|
52
|
+
| 📅 **Weekly Summary** | Hours per day with progress bars |
|
|
53
|
+
| ✨ **Daily Quote** | Deterministic motivational quote each day |
|
|
54
|
+
| 📤 **Export Reports** | TXT or JSON productivity reports |
|
|
55
|
+
| 💾 **Local SQLite** | All data stored privately on your machine |
|
|
56
|
+
|
|
57
|
+
---
|
|
58
|
+
|
|
59
|
+
## 🚀 Installation
|
|
60
|
+
|
|
61
|
+
### From PyPI (recommended)
|
|
62
|
+
|
|
63
|
+
```bash
|
|
64
|
+
pip install devpulse-cli
|
|
65
|
+
```
|
|
66
|
+
|
|
67
|
+
### From source
|
|
68
|
+
|
|
69
|
+
```bash
|
|
70
|
+
git clone https://github.com/yourname/devpulse.git
|
|
71
|
+
cd devpulse
|
|
72
|
+
pip install -e .
|
|
73
|
+
```
|
|
74
|
+
|
|
75
|
+
---
|
|
76
|
+
|
|
77
|
+
## 📖 Usage
|
|
78
|
+
|
|
79
|
+
### Start a coding session
|
|
80
|
+
```bash
|
|
81
|
+
devpulse start
|
|
82
|
+
```
|
|
83
|
+
|
|
84
|
+
### Stop and save session
|
|
85
|
+
```bash
|
|
86
|
+
devpulse stop
|
|
87
|
+
```
|
|
88
|
+
|
|
89
|
+
### Log a completed task
|
|
90
|
+
```bash
|
|
91
|
+
devpulse log Fixed the authentication bug
|
|
92
|
+
devpulse log "Wrote unit tests for the payment module"
|
|
93
|
+
```
|
|
94
|
+
|
|
95
|
+
### Full productivity dashboard
|
|
96
|
+
```bash
|
|
97
|
+
devpulse stats
|
|
98
|
+
```
|
|
99
|
+
|
|
100
|
+
### View your streak
|
|
101
|
+
```bash
|
|
102
|
+
devpulse streak
|
|
103
|
+
```
|
|
104
|
+
|
|
105
|
+
### Get a motivational quote
|
|
106
|
+
```bash
|
|
107
|
+
devpulse quote # today's quote (same all day)
|
|
108
|
+
devpulse quote --random # random quote
|
|
109
|
+
```
|
|
110
|
+
|
|
111
|
+
### Activity heatmap
|
|
112
|
+
```bash
|
|
113
|
+
devpulse heatmap # last 18 weeks
|
|
114
|
+
devpulse heatmap --weeks 8 # custom range
|
|
115
|
+
```
|
|
116
|
+
|
|
117
|
+
### Weekly summary
|
|
118
|
+
```bash
|
|
119
|
+
devpulse weekly
|
|
120
|
+
```
|
|
121
|
+
|
|
122
|
+
### View tasks
|
|
123
|
+
```bash
|
|
124
|
+
devpulse tasks # today's tasks
|
|
125
|
+
devpulse tasks --all # all tasks
|
|
126
|
+
```
|
|
127
|
+
|
|
128
|
+
### Export a report
|
|
129
|
+
```bash
|
|
130
|
+
devpulse export # TXT report (last 30 days)
|
|
131
|
+
devpulse export --format json # JSON report
|
|
132
|
+
devpulse export --days 90 -o report.txt
|
|
133
|
+
```
|
|
134
|
+
|
|
135
|
+
---
|
|
136
|
+
|
|
137
|
+
## 🗂 Project Structure
|
|
138
|
+
|
|
139
|
+
```
|
|
140
|
+
devpulse/
|
|
141
|
+
├── devpulse/
|
|
142
|
+
│ ├── __init__.py # Version info
|
|
143
|
+
│ ├── cli.py # All CLI commands (Click)
|
|
144
|
+
│ ├── db.py # SQLite data layer
|
|
145
|
+
│ ├── ui.py # Rich terminal UI components
|
|
146
|
+
│ ├── heatmap.py # GitHub-style heatmap renderer
|
|
147
|
+
│ ├── quotes.py # Motivational quotes
|
|
148
|
+
│ └── export.py # TXT / JSON export
|
|
149
|
+
├── tests/
|
|
150
|
+
│ └── test_core.py # Unit tests
|
|
151
|
+
├── pyproject.toml # Package config & metadata
|
|
152
|
+
├── requirements.txt # Dependencies
|
|
153
|
+
├── LICENSE # MIT
|
|
154
|
+
└── README.md
|
|
155
|
+
```
|
|
156
|
+
|
|
157
|
+
---
|
|
158
|
+
|
|
159
|
+
## 🗄 Data Storage
|
|
160
|
+
|
|
161
|
+
All data is stored locally in `~/.devpulse/devpulse.db` (SQLite).
|
|
162
|
+
No network requests, no accounts, no telemetry.
|
|
163
|
+
|
|
164
|
+
---
|
|
165
|
+
|
|
166
|
+
## 🧪 Running Tests
|
|
167
|
+
|
|
168
|
+
```bash
|
|
169
|
+
pip install pytest pytest-cov
|
|
170
|
+
pytest -v
|
|
171
|
+
pytest --cov=devpulse --cov-report=term-missing
|
|
172
|
+
```
|
|
173
|
+
|
|
174
|
+
---
|
|
175
|
+
|
|
176
|
+
## 📦 Publishing to PyPI
|
|
177
|
+
|
|
178
|
+
### 1. Set up accounts
|
|
179
|
+
- Create account at https://pypi.org
|
|
180
|
+
- Install tools: `pip install build twine`
|
|
181
|
+
|
|
182
|
+
### 2. Update metadata
|
|
183
|
+
Edit `pyproject.toml` — update `name`, `authors`, `urls`.
|
|
184
|
+
|
|
185
|
+
### 3. Build the package
|
|
186
|
+
```bash
|
|
187
|
+
python -m build
|
|
188
|
+
```
|
|
189
|
+
This creates `dist/devpulse_cli-1.0.0.tar.gz` and `dist/devpulse_cli-1.0.0-py3-none-any.whl`.
|
|
190
|
+
|
|
191
|
+
### 4. Test on TestPyPI first (optional but recommended)
|
|
192
|
+
```bash
|
|
193
|
+
twine upload --repository testpypi dist/*
|
|
194
|
+
pip install --index-url https://test.pypi.org/simple/ devpulse-cli
|
|
195
|
+
```
|
|
196
|
+
|
|
197
|
+
### 5. Publish to PyPI
|
|
198
|
+
```bash
|
|
199
|
+
twine upload dist/*
|
|
200
|
+
```
|
|
201
|
+
|
|
202
|
+
---
|
|
203
|
+
|
|
204
|
+
## 🤝 Contributing
|
|
205
|
+
|
|
206
|
+
1. Fork the repo
|
|
207
|
+
2. Create a feature branch: `git checkout -b feat/your-feature`
|
|
208
|
+
3. Commit your changes: `git commit -m "feat: add your feature"`
|
|
209
|
+
4. Push and open a Pull Request
|
|
210
|
+
|
|
211
|
+
---
|
|
212
|
+
|
|
213
|
+
## 📄 License
|
|
214
|
+
|
|
215
|
+
MIT © [Your Name](https://github.com/yourname)
|
|
216
|
+
|
|
217
|
+
---
|
|
218
|
+
|
|
219
|
+
<div align="center">
|
|
220
|
+
Made with ❤️ and ☕ — <em>Keep shipping!</em> 🚀
|
|
221
|
+
</div>
|
|
@@ -0,0 +1,194 @@
|
|
|
1
|
+
# ⚡ DevPulse
|
|
2
|
+
|
|
3
|
+
<div align="center">
|
|
4
|
+
|
|
5
|
+

|
|
6
|
+

|
|
7
|
+

|
|
8
|
+

|
|
9
|
+
|
|
10
|
+
**A futuristic terminal productivity tracker for developers.**
|
|
11
|
+
Track coding sessions, streaks, tasks, and stay motivated — all from your terminal.
|
|
12
|
+
|
|
13
|
+
</div>
|
|
14
|
+
|
|
15
|
+
---
|
|
16
|
+
|
|
17
|
+
## ✨ Features
|
|
18
|
+
|
|
19
|
+
| Feature | Description |
|
|
20
|
+
|---|---|
|
|
21
|
+
| 🔥 **Coding Streaks** | Daily streak tracker with all-time best |
|
|
22
|
+
| 🕐 **Session Timer** | Start/stop coding sessions, auto-track hours |
|
|
23
|
+
| ✅ **Task Logger** | Log completed tasks with timestamps |
|
|
24
|
+
| 📈 **Activity Heatmap** | GitHub-style heatmap in your terminal |
|
|
25
|
+
| 📅 **Weekly Summary** | Hours per day with progress bars |
|
|
26
|
+
| ✨ **Daily Quote** | Deterministic motivational quote each day |
|
|
27
|
+
| 📤 **Export Reports** | TXT or JSON productivity reports |
|
|
28
|
+
| 💾 **Local SQLite** | All data stored privately on your machine |
|
|
29
|
+
|
|
30
|
+
---
|
|
31
|
+
|
|
32
|
+
## 🚀 Installation
|
|
33
|
+
|
|
34
|
+
### From PyPI (recommended)
|
|
35
|
+
|
|
36
|
+
```bash
|
|
37
|
+
pip install devpulse-cli
|
|
38
|
+
```
|
|
39
|
+
|
|
40
|
+
### From source
|
|
41
|
+
|
|
42
|
+
```bash
|
|
43
|
+
git clone https://github.com/yourname/devpulse.git
|
|
44
|
+
cd devpulse
|
|
45
|
+
pip install -e .
|
|
46
|
+
```
|
|
47
|
+
|
|
48
|
+
---
|
|
49
|
+
|
|
50
|
+
## 📖 Usage
|
|
51
|
+
|
|
52
|
+
### Start a coding session
|
|
53
|
+
```bash
|
|
54
|
+
devpulse start
|
|
55
|
+
```
|
|
56
|
+
|
|
57
|
+
### Stop and save session
|
|
58
|
+
```bash
|
|
59
|
+
devpulse stop
|
|
60
|
+
```
|
|
61
|
+
|
|
62
|
+
### Log a completed task
|
|
63
|
+
```bash
|
|
64
|
+
devpulse log Fixed the authentication bug
|
|
65
|
+
devpulse log "Wrote unit tests for the payment module"
|
|
66
|
+
```
|
|
67
|
+
|
|
68
|
+
### Full productivity dashboard
|
|
69
|
+
```bash
|
|
70
|
+
devpulse stats
|
|
71
|
+
```
|
|
72
|
+
|
|
73
|
+
### View your streak
|
|
74
|
+
```bash
|
|
75
|
+
devpulse streak
|
|
76
|
+
```
|
|
77
|
+
|
|
78
|
+
### Get a motivational quote
|
|
79
|
+
```bash
|
|
80
|
+
devpulse quote # today's quote (same all day)
|
|
81
|
+
devpulse quote --random # random quote
|
|
82
|
+
```
|
|
83
|
+
|
|
84
|
+
### Activity heatmap
|
|
85
|
+
```bash
|
|
86
|
+
devpulse heatmap # last 18 weeks
|
|
87
|
+
devpulse heatmap --weeks 8 # custom range
|
|
88
|
+
```
|
|
89
|
+
|
|
90
|
+
### Weekly summary
|
|
91
|
+
```bash
|
|
92
|
+
devpulse weekly
|
|
93
|
+
```
|
|
94
|
+
|
|
95
|
+
### View tasks
|
|
96
|
+
```bash
|
|
97
|
+
devpulse tasks # today's tasks
|
|
98
|
+
devpulse tasks --all # all tasks
|
|
99
|
+
```
|
|
100
|
+
|
|
101
|
+
### Export a report
|
|
102
|
+
```bash
|
|
103
|
+
devpulse export # TXT report (last 30 days)
|
|
104
|
+
devpulse export --format json # JSON report
|
|
105
|
+
devpulse export --days 90 -o report.txt
|
|
106
|
+
```
|
|
107
|
+
|
|
108
|
+
---
|
|
109
|
+
|
|
110
|
+
## 🗂 Project Structure
|
|
111
|
+
|
|
112
|
+
```
|
|
113
|
+
devpulse/
|
|
114
|
+
├── devpulse/
|
|
115
|
+
│ ├── __init__.py # Version info
|
|
116
|
+
│ ├── cli.py # All CLI commands (Click)
|
|
117
|
+
│ ├── db.py # SQLite data layer
|
|
118
|
+
│ ├── ui.py # Rich terminal UI components
|
|
119
|
+
│ ├── heatmap.py # GitHub-style heatmap renderer
|
|
120
|
+
│ ├── quotes.py # Motivational quotes
|
|
121
|
+
│ └── export.py # TXT / JSON export
|
|
122
|
+
├── tests/
|
|
123
|
+
│ └── test_core.py # Unit tests
|
|
124
|
+
├── pyproject.toml # Package config & metadata
|
|
125
|
+
├── requirements.txt # Dependencies
|
|
126
|
+
├── LICENSE # MIT
|
|
127
|
+
└── README.md
|
|
128
|
+
```
|
|
129
|
+
|
|
130
|
+
---
|
|
131
|
+
|
|
132
|
+
## 🗄 Data Storage
|
|
133
|
+
|
|
134
|
+
All data is stored locally in `~/.devpulse/devpulse.db` (SQLite).
|
|
135
|
+
No network requests, no accounts, no telemetry.
|
|
136
|
+
|
|
137
|
+
---
|
|
138
|
+
|
|
139
|
+
## 🧪 Running Tests
|
|
140
|
+
|
|
141
|
+
```bash
|
|
142
|
+
pip install pytest pytest-cov
|
|
143
|
+
pytest -v
|
|
144
|
+
pytest --cov=devpulse --cov-report=term-missing
|
|
145
|
+
```
|
|
146
|
+
|
|
147
|
+
---
|
|
148
|
+
|
|
149
|
+
## 📦 Publishing to PyPI
|
|
150
|
+
|
|
151
|
+
### 1. Set up accounts
|
|
152
|
+
- Create account at https://pypi.org
|
|
153
|
+
- Install tools: `pip install build twine`
|
|
154
|
+
|
|
155
|
+
### 2. Update metadata
|
|
156
|
+
Edit `pyproject.toml` — update `name`, `authors`, `urls`.
|
|
157
|
+
|
|
158
|
+
### 3. Build the package
|
|
159
|
+
```bash
|
|
160
|
+
python -m build
|
|
161
|
+
```
|
|
162
|
+
This creates `dist/devpulse_cli-1.0.0.tar.gz` and `dist/devpulse_cli-1.0.0-py3-none-any.whl`.
|
|
163
|
+
|
|
164
|
+
### 4. Test on TestPyPI first (optional but recommended)
|
|
165
|
+
```bash
|
|
166
|
+
twine upload --repository testpypi dist/*
|
|
167
|
+
pip install --index-url https://test.pypi.org/simple/ devpulse-cli
|
|
168
|
+
```
|
|
169
|
+
|
|
170
|
+
### 5. Publish to PyPI
|
|
171
|
+
```bash
|
|
172
|
+
twine upload dist/*
|
|
173
|
+
```
|
|
174
|
+
|
|
175
|
+
---
|
|
176
|
+
|
|
177
|
+
## 🤝 Contributing
|
|
178
|
+
|
|
179
|
+
1. Fork the repo
|
|
180
|
+
2. Create a feature branch: `git checkout -b feat/your-feature`
|
|
181
|
+
3. Commit your changes: `git commit -m "feat: add your feature"`
|
|
182
|
+
4. Push and open a Pull Request
|
|
183
|
+
|
|
184
|
+
---
|
|
185
|
+
|
|
186
|
+
## 📄 License
|
|
187
|
+
|
|
188
|
+
MIT © [Your Name](https://github.com/yourname)
|
|
189
|
+
|
|
190
|
+
---
|
|
191
|
+
|
|
192
|
+
<div align="center">
|
|
193
|
+
Made with ❤️ and ☕ — <em>Keep shipping!</em> 🚀
|
|
194
|
+
</div>
|