Metadata-Version: 2.4
Name: raj-devpulse-cli
Version: 1.0.2
Summary: ⚡ Terminal-based developer productivity tracker — streaks, sessions, heatmaps & more.
Author-email: Your Name <you@example.com>
License: MIT
Project-URL: Homepage, https://github.com/yourname/devpulse
Project-URL: Repository, https://github.com/yourname/devpulse
Project-URL: Bug Tracker, https://github.com/yourname/devpulse/issues
Keywords: productivity,cli,developer,streak,terminal,coding
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Utilities
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: click>=8.1
Requires-Dist: rich>=13.0
Dynamic: license-file

# ⚡ DevPulse

<div align="center">

![PyPI version](https://img.shields.io/pypi/v/devpulse-cli?color=00d4ff&style=for-the-badge)
![Python](https://img.shields.io/pypi/pyversions/devpulse-cli?color=00d4ff&style=for-the-badge)
![License](https://img.shields.io/github/license/yourname/devpulse?color=00d4ff&style=for-the-badge)
![Stars](https://img.shields.io/github/stars/yourname/devpulse?color=00d4ff&style=for-the-badge)

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

</div>

---

## ✨ 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)

```bash
pip install devpulse-cli
```

### From source

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

---

## 📖 Usage

### Start a coding session
```bash
devpulse start
```

### Stop and save session
```bash
devpulse stop
```

### Log a completed task
```bash
devpulse log Fixed the authentication bug
devpulse log "Wrote unit tests for the payment module"
```

### Full productivity dashboard
```bash
devpulse stats
```

### View your streak
```bash
devpulse streak
```

### Get a motivational quote
```bash
devpulse quote           # today's quote (same all day)
devpulse quote --random  # random quote
```

### Activity heatmap
```bash
devpulse heatmap           # last 18 weeks
devpulse heatmap --weeks 8 # custom range
```

### Weekly summary
```bash
devpulse weekly
```

### View tasks
```bash
devpulse tasks        # today's tasks
devpulse tasks --all  # all tasks
```

### Export a report
```bash
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

```bash
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
```bash
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)
```bash
twine upload --repository testpypi dist/*
pip install --index-url https://test.pypi.org/simple/ devpulse-cli
```

### 5. Publish to PyPI
```bash
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](https://github.com/yourname)

---

<div align="center">
Made with ❤️ and ☕ — <em>Keep shipping!</em> 🚀
</div>
