raj-devpulse-cli 1.0.3

⚡ Terminal-based developer productivity tracker — streaks, sessions, heatmaps & more.

⚡ DevPulse

A futuristic terminal productivity tracker for developers.
Track coding sessions, streaks, tasks, and stay motivated — all from your terminal.

---

✨ Features

Feature	Description
🔥 Coding Streaks	Daily streak tracker with all-time best
🕐 Session Timer	Start/stop coding sessions, auto-track hours
✅ Task Logger	Log completed tasks with timestamps
📈 Activity Heatmap	GitHub-style heatmap in your terminal
📅 Weekly Summary	Hours per day with progress bars
✨ Daily Quote	Deterministic motivational quote each day
📤 Export Reports	TXT or JSON productivity reports
💾 Local SQLite	All data stored privately on your machine

---

🚀 Installation

From PyPI (recommended)

pip install devpulse-cli

From source

git clone https://github.com/yourname/devpulse.git
cd devpulse
pip install -e .

---

📖 Usage

Start a coding session

devpulse start

Stop and save session

devpulse stop

Log a completed task

devpulse log Fixed the authentication bug
devpulse log "Wrote unit tests for the payment module"

Full productivity dashboard

devpulse stats

View your streak

devpulse streak

Get a motivational quote

devpulse quote           # today's quote (same all day)
devpulse quote --random  # random quote

Activity heatmap

devpulse heatmap           # last 18 weeks
devpulse heatmap --weeks 8 # custom range

Weekly summary

devpulse weekly

View tasks

devpulse tasks        # today's tasks
devpulse tasks --all  # all tasks

Export a report

devpulse export                        # TXT report (last 30 days)
devpulse export --format json          # JSON report
devpulse export --days 90 -o report.txt

---

🗂 Project Structure

devpulse/
├── devpulse/
│   ├── __init__.py   # Version info
│   ├── cli.py        # All CLI commands (Click)
│   ├── db.py         # SQLite data layer
│   ├── ui.py         # Rich terminal UI components
│   ├── heatmap.py    # GitHub-style heatmap renderer
│   ├── quotes.py     # Motivational quotes
│   └── export.py     # TXT / JSON export
├── tests/
│   └── test_core.py  # Unit tests
├── pyproject.toml    # Package config & metadata
├── requirements.txt  # Dependencies
├── LICENSE           # MIT
└── README.md

---

🗄 Data Storage

All data is stored locally in ~/.devpulse/devpulse.db (SQLite).
No network requests, no accounts, no telemetry.

---

🧪 Running Tests

pip install pytest pytest-cov
pytest -v
pytest --cov=devpulse --cov-report=term-missing

---

📦 Publishing to PyPI

1. Set up accounts

• Create account at https://pypi.org
• Install tools: pip install build twine

2. Update metadata

Edit pyproject.toml — update name, authors, urls.

3. Build the package

python -m build

This creates dist/devpulse_cli-1.0.0.tar.gz and dist/devpulse_cli-1.0.0-py3-none-any.whl.

4. Test on TestPyPI first (optional but recommended)

twine upload --repository testpypi dist/*
pip install --index-url https://test.pypi.org/simple/ devpulse-cli

5. Publish to PyPI

twine upload dist/*

---

🤝 Contributing

1. Fork the repo
2. Create a feature branch: git checkout -b feat/your-feature
3. Commit your changes: git commit -m "feat: add your feature"
4. Push and open a Pull Request

---

📄 License

MIT © Your Name

---

Made with ❤️ and ☕ — Keep shipping! 🚀