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.
@@ -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
+ ![PyPI version](https://img.shields.io/pypi/v/devpulse-cli?color=00d4ff&style=for-the-badge)
33
+ ![Python](https://img.shields.io/pypi/pyversions/devpulse-cli?color=00d4ff&style=for-the-badge)
34
+ ![License](https://img.shields.io/github/license/yourname/devpulse?color=00d4ff&style=for-the-badge)
35
+ ![Stars](https://img.shields.io/github/stars/yourname/devpulse?color=00d4ff&style=for-the-badge)
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
+ ![PyPI version](https://img.shields.io/pypi/v/devpulse-cli?color=00d4ff&style=for-the-badge)
6
+ ![Python](https://img.shields.io/pypi/pyversions/devpulse-cli?color=00d4ff&style=for-the-badge)
7
+ ![License](https://img.shields.io/github/license/yourname/devpulse?color=00d4ff&style=for-the-badge)
8
+ ![Stars](https://img.shields.io/github/stars/yourname/devpulse?color=00d4ff&style=for-the-badge)
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>
@@ -0,0 +1,8 @@
1
+ """
2
+ DevPulse — Terminal-based developer productivity tracker.
3
+ Track streaks, log tasks, monitor hours, and stay motivated.
4
+ """
5
+
6
+ __version__ = "1.0.0"
7
+ __author__ = "Your Name"
8
+ __email__ = "you@example.com"