raj-devpulse-cli 1.0.1__py3-none-any.whl

devpulse/__init__.py

@@ -0,0 +1,8 @@
+"""
+DevPulse — Terminal-based developer productivity tracker.
+Track streaks, log tasks, monitor hours, and stay motivated.
+"""
+
+__version__ = "1.0.0"
+__author__ = "Your Name"
+__email__ = "you@example.com"

devpulse/cli.py

@@ -0,0 +1,278 @@
+"""
+cli.py — DevPulse command-line interface.
+
+Commands
+--------
+  devpulse start   – Begin a coding session
+  devpulse stop    – End the current session
+  devpulse log     – Log a completed task
+  devpulse stats   – Full productivity dashboard
+  devpulse streak  – Show current coding streak
+  devpulse quote   – Display a motivational quote
+  devpulse heatmap – Show activity heatmap
+  devpulse weekly  – Weekly summary
+  devpulse export  – Export report (txt or json)
+"""
+
+import sys
+import time
+import click
+from datetime import date
+from rich.console import Console
+from rich.progress import Progress, SpinnerColumn, TextColumn
+
+from devpulse import db, ui, quotes, heatmap, export
+
+console = Console()
+
+
+# ── Helper: ensure DB is ready before every command ──────────────────────────
+
+def _init():
+    db.init_db()
+
+
+# ── CLI group ─────────────────────────────────────────────────────────────────
+
+@click.group()
+@click.version_option(version="1.0.0", prog_name="DevPulse")
+def cli():
+    """
+    \b
+    ⚡ DevPulse — Developer Productivity Tracker
+    Track streaks, sessions, tasks, and stay motivated.
+    """
+    _init()
+
+
+# ── devpulse start ────────────────────────────────────────────────────────────
+
+@cli.command()
+def start():
+    """Start a new coding session."""
+    # Check if a session is already open
+    active = db.get_active_session()
+    if active:
+        console.print(
+            f"[yellow]⚠  A session is already running (ID #{active['id']}, "
+            f"started {active['start_ts'][:19]}).[/yellow]\n"
+            f"   Run [cyan]devpulse stop[/cyan] first."
+        )
+        sys.exit(1)
+
+    with Progress(
+        SpinnerColumn(spinner_name="dots", style="cyan"),
+        TextColumn("[cyan]Starting session…"),
+        transient=True,
+        console=console,
+    ) as progress:
+        progress.add_task("", total=None)
+        time.sleep(0.8)
+
+    session_id = db.start_session()
+    ui.print_session_started(session_id)
+
+    # Show today's quote for motivation
+    q, author = quotes.get_quote_of_the_day()
+    console.print()
+    ui.print_quote(q, author)
+
+
+# ── devpulse stop ─────────────────────────────────────────────────────────────
+
+@cli.command()
+def stop():
+    """End the current coding session."""
+    active = db.get_active_session()
+    if not active:
+        console.print("[yellow]⚠  No active session found. Run [cyan]devpulse start[/cyan] first.[/yellow]")
+        sys.exit(1)
+
+    with Progress(
+        SpinnerColumn(spinner_name="dots", style="cyan"),
+        TextColumn("[cyan]Saving session…"),
+        transient=True,
+        console=console,
+    ) as progress:
+        progress.add_task("", total=None)
+        time.sleep(0.6)
+
+    hours = db.end_session(active["id"])
+    ui.print_session_stopped(hours)
+
+
+# ── devpulse log ──────────────────────────────────────────────────────────────
+
+@cli.command()
+@click.argument("task", nargs=-1, required=True)
+def log(task):
+    """Log a completed task.
+
+    \b
+    Example:
+        devpulse log Fixed login bug
+        devpulse log "Refactored auth module"
+    """
+    description = " ".join(task)
+    task_id = db.add_task(description)
+    console.print(
+        f"[green]✔  Task #{task_id} logged:[/green] [white]{description}[/white]"
+    )
+
+
+# ── devpulse stats ────────────────────────────────────────────────────────────
+
+@cli.command()
+def stats():
+    """Show the full productivity dashboard."""
+    with Progress(
+        SpinnerColumn(spinner_name="dots", style="cyan"),
+        TextColumn("[cyan]Loading stats…"),
+        transient=True,
+        console=console,
+    ) as progress:
+        progress.add_task("", total=None)
+        time.sleep(0.5)
+
+    ui.print_banner()
+
+    today = date.today().isoformat()
+    hours_today = db.get_daily_hours(today)
+    hours_map = db.get_hours_by_date(90)
+    total_hours = sum(hours_map.values())
+    active_dates = db.get_all_active_dates()
+    current_streak, longest_streak = db.compute_streak(active_dates)
+    tasks_today = db.get_tasks(today)
+    active_session = db.get_active_session()
+
+    # Stat cards row
+    session_label = f"#{active_session['id']} running" if active_session else "No active session"
+    ui.print_stat_row([
+        ("Today's Hours",   f"{hours_today:.1f} h",      "🕐", "cyan"),
+        ("Current Streak",  f"{current_streak} days",    "🔥", "yellow"),
+        ("Total Hours",     f"{total_hours:.1f} h",      "📈", "green"),
+        ("Session Status",  session_label,               "💻", "magenta"),
+    ])
+    console.print()
+
+    # Weekly summary
+    ui.print_weekly_summary(hours_map)
+    console.print()
+
+    # Heatmap
+    console.print(heatmap.render_heatmap(hours_map, weeks=18))
+    console.print()
+
+    # Today's tasks
+    ui.print_tasks(tasks_today, title=f"Today's Tasks ({today})")
+
+
+# ── devpulse streak ───────────────────────────────────────────────────────────
+
+@cli.command()
+def streak():
+    """Display your current coding streak."""
+    active_dates = db.get_all_active_dates()
+    current, longest = db.compute_streak(active_dates)
+    ui.print_streak(current, longest)
+
+
+# ── devpulse quote ────────────────────────────────────────────────────────────
+
+@cli.command()
+@click.option("--random", "use_random", is_flag=True, default=False,
+              help="Show a random quote instead of the daily one.")
+def quote(use_random):
+    """Display a motivational quote."""
+    if use_random:
+        q, author = quotes.get_random_quote()
+    else:
+        q, author = quotes.get_quote_of_the_day()
+    ui.print_quote(q, author)
+
+
+# ── devpulse heatmap ──────────────────────────────────────────────────────────
+
+@cli.command()
+@click.option("--weeks", default=18, show_default=True, help="Number of weeks to display.")
+def heatmap_cmd(weeks):
+    """Show the GitHub-style activity heatmap."""
+    hours_map = db.get_hours_by_date(weeks * 7)
+
+    with Progress(
+        SpinnerColumn(spinner_name="dots", style="cyan"),
+        TextColumn("[cyan]Rendering heatmap…"),
+        transient=True,
+        console=console,
+    ) as progress:
+        progress.add_task("", total=None)
+        time.sleep(0.4)
+
+    console.print(heatmap.render_heatmap(hours_map, weeks=weeks))
+
+
+# Register heatmap under the name "heatmap" (not "heatmap-cmd")
+cli.add_command(heatmap_cmd, name="heatmap")
+
+
+# ── devpulse weekly ───────────────────────────────────────────────────────────
+
+@cli.command()
+def weekly():
+    """Show the weekly productivity summary."""
+    hours_map = db.get_hours_by_date(7)
+    ui.print_weekly_summary(hours_map)
+
+
+# ── devpulse export ───────────────────────────────────────────────────────────
+
+@cli.command()
+@click.option("--format", "fmt", type=click.Choice(["txt", "json"]), default="txt",
+              show_default=True, help="Output format.")
+@click.option("--output", "-o", default=None, help="Output file path (optional).")
+@click.option("--days", default=30, show_default=True, help="Number of days to include.")
+def export_cmd(fmt, output, days):
+    """Export a productivity report to a file."""
+    with Progress(
+        SpinnerColumn(spinner_name="dots", style="cyan"),
+        TextColumn(f"[cyan]Exporting {fmt.upper()} report…"),
+        transient=True,
+        console=console,
+    ) as progress:
+        progress.add_task("", total=None)
+        time.sleep(0.5)
+
+    if fmt == "json":
+        path = export.export_json(output, days)
+    else:
+        path = export.export_txt(output, days)
+
+    console.print(f"[green]✔  Report saved to:[/green] [cyan]{path}[/cyan]")
+
+
+cli.add_command(export_cmd, name="export")
+
+
+# ── devpulse tasks ────────────────────────────────────────────────────────────
+
+@cli.command()
+@click.option("--all", "show_all", is_flag=True, default=False, help="Show all tasks, not just today's.")
+def tasks(show_all):
+    """List logged tasks."""
+    if show_all:
+        t = db.get_all_tasks()
+        ui.print_tasks(t, title="All Tasks")
+    else:
+        today = date.today().isoformat()
+        t = db.get_tasks(today)
+        ui.print_tasks(t, title=f"Tasks for {today}")
+
+
+# ── Entry point ───────────────────────────────────────────────────────────────
+
+def main():
+    cli()
+
+
+if __name__ == "__main__":
+    main()

devpulse/db.py

@@ -0,0 +1,244 @@
+"""
+db.py — Database layer for DevPulse.
+Handles all SQLite operations: sessions, tasks, and quotes.
+"""
+
+import sqlite3
+import os
+from pathlib import Path
+from datetime import date, datetime
+
+
+# Store data in user's home directory under ~/.devpulse/
+DATA_DIR = Path.home() / ".devpulse"
+DB_PATH = DATA_DIR / "devpulse.db"
+
+
+def get_connection() -> sqlite3.Connection:
+    """Return a sqlite3 connection, creating the DB file if needed."""
+    DATA_DIR.mkdir(parents=True, exist_ok=True)
+    conn = sqlite3.connect(DB_PATH)
+    conn.row_factory = sqlite3.Row  # allows dict-like access to rows
+    return conn
+
+
+def init_db() -> None:
+    """Create all tables if they don't exist yet."""
+    conn = get_connection()
+    cur = conn.cursor()
+
+    # sessions: one row per coding session
+    cur.execute("""
+        CREATE TABLE IF NOT EXISTS sessions (
+            id        INTEGER PRIMARY KEY AUTOINCREMENT,
+            date      TEXT NOT NULL,          -- ISO date: YYYY-MM-DD
+            start_ts  TEXT NOT NULL,          -- ISO datetime
+            end_ts    TEXT,                   -- NULL while session is open
+            hours     REAL DEFAULT 0.0        -- computed when session ends
+        )
+    """)
+
+    # tasks: user-logged completed items
+    cur.execute("""
+        CREATE TABLE IF NOT EXISTS tasks (
+            id          INTEGER PRIMARY KEY AUTOINCREMENT,
+            date        TEXT NOT NULL,
+            description TEXT NOT NULL,
+            created_at  TEXT NOT NULL
+        )
+    """)
+
+    # quotes cache (populated from bundled list)
+    cur.execute("""
+        CREATE TABLE IF NOT EXISTS shown_quotes (
+            id         INTEGER PRIMARY KEY AUTOINCREMENT,
+            quote_text TEXT NOT NULL,
+            shown_at   TEXT NOT NULL
+        )
+    """)
+
+    conn.commit()
+    conn.close()
+
+
+# ── Session helpers ──────────────────────────────────────────────────────────
+
+def start_session() -> int:
+    """Open a new coding session. Returns the new session id."""
+    conn = get_connection()
+    cur = conn.cursor()
+    now = datetime.now().isoformat()
+    today = date.today().isoformat()
+    cur.execute(
+        "INSERT INTO sessions (date, start_ts) VALUES (?, ?)",
+        (today, now),
+    )
+    session_id = cur.lastrowid
+    conn.commit()
+    conn.close()
+    return session_id
+
+
+def end_session(session_id: int) -> float:
+    """Close an open session and compute hours worked. Returns hours."""
+    conn = get_connection()
+    cur = conn.cursor()
+    now = datetime.now()
+
+    row = cur.execute(
+        "SELECT start_ts FROM sessions WHERE id = ?", (session_id,)
+    ).fetchone()
+
+    if not row:
+        conn.close()
+        return 0.0
+
+    start = datetime.fromisoformat(row["start_ts"])
+    hours = (now - start).total_seconds() / 3600
+
+    cur.execute(
+        "UPDATE sessions SET end_ts = ?, hours = ? WHERE id = ?",
+        (now.isoformat(), round(hours, 4), session_id),
+    )
+    conn.commit()
+    conn.close()
+    return hours
+
+
+def get_active_session() -> dict | None:
+    """Return the most recent open session, or None."""
+    conn = get_connection()
+    cur = conn.cursor()
+    row = cur.execute(
+        "SELECT * FROM sessions WHERE end_ts IS NULL ORDER BY id DESC LIMIT 1"
+    ).fetchone()
+    conn.close()
+    return dict(row) if row else None
+
+
+def get_daily_hours(iso_date: str) -> float:
+    """Sum of hours for all completed sessions on a given date."""
+    conn = get_connection()
+    cur = conn.cursor()
+    row = cur.execute(
+        "SELECT COALESCE(SUM(hours), 0) AS total FROM sessions WHERE date = ? AND end_ts IS NOT NULL",
+        (iso_date,),
+    ).fetchone()
+    conn.close()
+    return float(row["total"])
+
+
+def get_hours_by_date(days: int = 90) -> dict[str, float]:
+    """Return {iso_date: hours} for the last `days` days."""
+    conn = get_connection()
+    cur = conn.cursor()
+    rows = cur.execute(
+        """
+        SELECT date, COALESCE(SUM(hours), 0) AS total
+        FROM sessions
+        WHERE end_ts IS NOT NULL
+          AND date >= date('now', ?)
+        GROUP BY date
+        """,
+        (f"-{days} days",),
+    ).fetchall()
+    conn.close()
+    return {r["date"]: float(r["total"]) for r in rows}
+
+
+# ── Task helpers ─────────────────────────────────────────────────────────────
+
+def add_task(description: str) -> int:
+    """Insert a completed task for today. Returns new task id."""
+    conn = get_connection()
+    cur = conn.cursor()
+    now = datetime.now().isoformat()
+    today = date.today().isoformat()
+    cur.execute(
+        "INSERT INTO tasks (date, description, created_at) VALUES (?, ?, ?)",
+        (today, description, now),
+    )
+    task_id = cur.lastrowid
+    conn.commit()
+    conn.close()
+    return task_id
+
+
+def get_tasks(iso_date: str) -> list[dict]:
+    """Return all tasks for a given date."""
+    conn = get_connection()
+    cur = conn.cursor()
+    rows = cur.execute(
+        "SELECT * FROM tasks WHERE date = ? ORDER BY created_at",
+        (iso_date,),
+    ).fetchall()
+    conn.close()
+    return [dict(r) for r in rows]
+
+
+def get_all_tasks(limit: int = 200) -> list[dict]:
+    """Return most recent tasks across all dates."""
+    conn = get_connection()
+    cur = conn.cursor()
+    rows = cur.execute(
+        "SELECT * FROM tasks ORDER BY created_at DESC LIMIT ?", (limit,)
+    ).fetchall()
+    conn.close()
+    return [dict(r) for r in rows]
+
+
+# ── Streak helpers ────────────────────────────────────────────────────────────
+
+def get_all_active_dates() -> list[str]:
+    """Return sorted list of dates that have ≥1 completed session OR ≥1 task."""
+    conn = get_connection()
+    cur = conn.cursor()
+    rows = cur.execute(
+        """
+        SELECT DISTINCT date FROM sessions WHERE end_ts IS NOT NULL
+        UNION
+        SELECT DISTINCT date FROM tasks
+        ORDER BY date
+        """
+    ).fetchall()
+    conn.close()
+    return [r["date"] for r in rows]
+
+
+def compute_streak(active_dates: list[str]) -> tuple[int, int]:
+    """
+    Given a sorted list of active ISO dates, compute:
+      - current streak (consecutive days ending today or yesterday)
+      - longest streak ever
+    Returns (current_streak, longest_streak).
+    """
+    if not active_dates:
+        return 0, 0
+
+    from datetime import date, timedelta
+
+    date_set = {date.fromisoformat(d) for d in active_dates}
+    today = date.today()
+
+    # ── longest streak ──
+    longest = 1
+    current_run = 1
+    sorted_dates = sorted(date_set)
+    for i in range(1, len(sorted_dates)):
+        if sorted_dates[i] - sorted_dates[i - 1] == timedelta(days=1):
+            current_run += 1
+            longest = max(longest, current_run)
+        else:
+            current_run = 1
+
+    # ── current streak (must include today or yesterday) ──
+    if today not in date_set and (today - timedelta(days=1)) not in date_set:
+        return 0, longest
+
+    streak = 0
+    check = today if today in date_set else today - timedelta(days=1)
+    while check in date_set:
+        streak += 1
+        check -= timedelta(days=1)
+
+    return streak, longest

devpulse/export.py

@@ -0,0 +1,86 @@
+"""
+export.py — Export DevPulse data to TXT or JSON files.
+"""
+
+import json
+from datetime import date, timedelta
+from pathlib import Path
+
+from devpulse import db
+
+
+def _collect_report_data(days: int = 30) -> dict:
+    """Gather all stats needed for a report."""
+    today = date.today()
+    hours_map = db.get_hours_by_date(days)
+    active_dates = db.get_all_active_dates()
+    current_streak, longest_streak = db.compute_streak(active_dates)
+
+    total_hours = sum(hours_map.values())
+    total_days = len(hours_map)
+    avg_hours = total_hours / total_days if total_days else 0.0
+
+    # Recent tasks
+    tasks = db.get_all_tasks(limit=100)
+
+    return {
+        "generated_at": today.isoformat(),
+        "period_days": days,
+        "total_hours": round(total_hours, 2),
+        "average_hours_per_day": round(avg_hours, 2),
+        "active_days": total_days,
+        "current_streak": current_streak,
+        "longest_streak": longest_streak,
+        "hours_by_date": hours_map,
+        "recent_tasks": tasks,
+    }
+
+
+def export_json(output_path: str | None = None, days: int = 30) -> Path:
+    """Export report as JSON. Returns the path written."""
+    data = _collect_report_data(days)
+    path = Path(output_path) if output_path else Path.cwd() / f"devpulse_report_{data['generated_at']}.json"
+    path.write_text(json.dumps(data, indent=2, default=str), encoding="utf-8")
+    return path
+
+
+def export_txt(output_path: str | None = None, days: int = 30) -> Path:
+    """Export report as plain text. Returns the path written."""
+    data = _collect_report_data(days)
+    path = Path(output_path) if output_path else Path.cwd() / f"devpulse_report_{data['generated_at']}.txt"
+
+    lines = [
+        "=" * 60,
+        "  DEVPULSE — PRODUCTIVITY REPORT",
+        f"  Generated : {data['generated_at']}",
+        f"  Period    : Last {data['period_days']} days",
+        "=" * 60,
+        "",
+        "SUMMARY",
+        "-------",
+        f"  Total hours coded   : {data['total_hours']} h",
+        f"  Active days         : {data['active_days']}",
+        f"  Avg hours / day     : {data['average_hours_per_day']} h",
+        f"  Current streak      : {data['current_streak']} days 🔥",
+        f"  Longest streak      : {data['longest_streak']} days",
+        "",
+        "DAILY HOURS",
+        "-----------",
+    ]
+
+    for iso_date, h in sorted(data["hours_by_date"].items()):
+        bar = "█" * int(h) + ("▌" if h % 1 >= 0.5 else "")
+        lines.append(f"  {iso_date}  {h:5.2f} h  {bar}")
+
+    lines += [
+        "",
+        "RECENT TASKS",
+        "------------",
+    ]
+    for task in data["recent_tasks"][:30]:
+        lines.append(f"  [{task['date']}] {task['description']}")
+
+    lines += ["", "=" * 60, "  Keep shipping! 🚀", "=" * 60]
+
+    path.write_text("\n".join(lines), encoding="utf-8")
+    return path

devpulse/heatmap.py

@@ -0,0 +1,95 @@
+"""
+heatmap.py — Render a GitHub-style activity heatmap in the terminal using Rich.
+Columns = weeks (oldest → newest, left → right).
+Rows    = days of week (Mon–Sun).
+"""
+
+from datetime import date, timedelta
+from rich.console import Console
+from rich.text import Text
+from rich.panel import Panel
+
+
+# ── Colour palette (hours → colour) ──────────────────────────────────────────
+# Each level maps to a Rich colour string.
+LEVELS = [
+    (0,    "grey23"),       # no activity
+    (0.5,  "dark_green"),   # tiny bit
+    (1.5,  "green3"),       # ~1-1.5 h
+    (3.0,  "green1"),       # ~1.5-3 h
+    (5.0,  "chartreuse1"),  # ~3-5 h
+    (999,  "bright_white"), # 5+ h — beast mode
+]
+
+BLOCK = "■ "   # each "cell" in the heatmap
+EMPTY = "· "   # placeholder for future dates
+
+
+def _colour_for_hours(h: float) -> str:
+    """Map a float hours value to a Rich colour name."""
+    for threshold, colour in LEVELS:
+        if h <= threshold:
+            return colour
+    return LEVELS[-1][1]
+
+
+def render_heatmap(hours_by_date: dict[str, float], weeks: int = 18) -> Panel:
+    """
+    Build and return a Rich Panel containing the heatmap.
+
+    Args:
+        hours_by_date: mapping of ISO date string → hours coded that day.
+        weeks:         how many weeks to show (default 18 ≈ ~4 months).
+    """
+    today = date.today()
+
+    # Align start to the Monday of the week `weeks` ago
+    start = today - timedelta(days=today.weekday() + 7 * (weeks - 1))
+
+    # Day-of-week labels
+    day_labels = ["Mon", "Tue", "Wed", "Thu", "Fri", "Sat", "Sun"]
+
+    # Build a 7-row grid: rows = weekdays, cols = weeks
+    grid: list[list[tuple[str, float]]] = [[] for _ in range(7)]
+
+    for week in range(weeks):
+        for dow in range(7):          # 0=Mon … 6=Sun
+            d = start + timedelta(days=week * 7 + dow)
+            iso = d.isoformat()
+            h = hours_by_date.get(iso, 0.0)
+            # Mark future dates differently
+            is_future = d > today
+            grid[dow].append(("future" if is_future else iso, h))
+
+    # ── Assemble Rich Text row by row ────────────────────────────────────────
+    lines: list[Text] = []
+    for dow in range(7):
+        line = Text()
+        line.append(f"{day_labels[dow]} ", style="bold cyan")
+        for iso_or_tag, h in grid[dow]:
+            if iso_or_tag == "future":
+                line.append(EMPTY, style="grey19")
+            else:
+                colour = _colour_for_hours(h)
+                line.append(BLOCK, style=colour)
+        lines.append(line)
+
+    # ── Legend ────────────────────────────────────────────────────────────────
+    legend = Text("\n  Less ", style="dim")
+    for _, colour in LEVELS:
+        legend.append(BLOCK, style=colour)
+    legend.append(" More", style="dim")
+
+    # Combine rows + legend
+    combined = Text()
+    for line in lines:
+        combined.append_text(line)
+        combined.append("\n")
+    combined.append_text(legend)
+
+    return Panel(
+        combined,
+        title="[bold cyan]⬛ Activity Heatmap[/bold cyan]",
+        border_style="cyan",
+        padding=(1, 2),
+    )

devpulse/quotes.py

@@ -0,0 +1,53 @@
+"""
+quotes.py — Curated motivational quotes for developers.
+"""
+
+import random
+
+QUOTES: list[tuple[str, str]] = [
+    ("First, solve the problem. Then, write the code.", "John Johnson"),
+    ("Code is like humor. When you have to explain it, it's bad.", "Cory House"),
+    ("Any fool can write code that a computer can understand. Good programmers write code that humans can understand.", "Martin Fowler"),
+    ("The best error message is the one that never shows up.", "Thomas Fuchs"),
+    ("Fix the cause, not the symptom.", "Steve Maguire"),
+    ("Simplicity is the soul of efficiency.", "Austin Freeman"),
+    ("Make it work, make it right, make it fast.", "Kent Beck"),
+    ("Talk is cheap. Show me the code.", "Linus Torvalds"),
+    ("Programs must be written for people to read, and only incidentally for machines to execute.", "Harold Abelson"),
+    ("Every great developer you know got there by solving problems they were unqualified to solve until they did it.", "Patrick McKenzie"),
+    ("It's not a bug — it's an undocumented feature.", "Anonymous"),
+    ("The only way to go fast is to go well.", "Robert C. Martin"),
+    ("Debugging is twice as hard as writing the code in the first place.", "Brian Kernighan"),
+    ("One bad programmer can easily create two new jobs a year.", "David Parnas"),
+    ("In order to be irreplaceable, one must always be different.", "Coco Chanel"),
+    ("The function of good software is to make the complex appear simple.", "Grady Booch"),
+    ("Measuring programming progress by lines of code is like measuring aircraft building progress by weight.", "Bill Gates"),
+    ("Don't comment bad code — rewrite it.", "Brian Kernighan"),
+    ("Perfection is achieved not when there is nothing more to add, but when there is nothing left to take away.", "Antoine de Saint-Exupéry"),
+    ("The most disastrous thing that you can ever learn is your first programming language.", "Alan Kay"),
+    ("Software is eating the world.", "Marc Andreessen"),
+    ("The best way to predict the future is to invent it.", "Alan Kay"),
+    ("Weeks of coding can save you hours of planning.", "Anonymous"),
+    ("A ship in harbor is safe, but that is not what ships are for.", "John A. Shedd"),
+    ("Consistency is the key to mastery.", "Robin Sharma"),
+    ("Small steps every day lead to big leaps over time.", "Anonymous"),
+    ("Your limitation — it's only your imagination.", "Anonymous"),
+    ("Push yourself, because no one else is going to do it for you.", "Anonymous"),
+    ("Dream it. Wish it. Do it.", "Anonymous"),
+    ("Great things never come from comfort zones.", "Anonymous"),
+]
+
+
+def get_random_quote() -> tuple[str, str]:
+    """Return a random (quote, author) tuple."""
+    return random.choice(QUOTES)
+
+
+def get_quote_of_the_day() -> tuple[str, str]:
+    """
+    Return a deterministic daily quote based on today's date.
+    Same quote all day, different each day.
+    """
+    from datetime import date
+    idx = date.today().toordinal() % len(QUOTES)
+    return QUOTES[idx]

devpulse/ui.py

@@ -0,0 +1,201 @@
+"""
+ui.py — Reusable Rich UI components for DevPulse.
+All terminal rendering lives here to keep cli.py clean.
+"""
+
+from datetime import date
+from rich.console import Console
+from rich.panel import Panel
+from rich.table import Table
+from rich.text import Text
+from rich.align import Align
+from rich.columns import Columns
+from rich import box
+
+console = Console()
+
+# ── Brand colours (used as Rich style strings) ────────────────────────────
+PRIMARY   = "bold cyan"
+ACCENT    = "bold green"
+DIM       = "dim white"
+WARN      = "bold yellow"
+ERROR     = "bold red"
+MUTED     = "grey62"
+
+
+# ── Banner ────────────────────────────────────────────────────────────────────
+
+BANNER = r"""
+ ██████╗ ███████╗██╗   ██╗██████╗ ██╗   ██╗██╗     ███████╗███████╗
+ ██╔══██╗██╔════╝██║   ██║██╔══██╗██║   ██║██║     ██╔════╝██╔════╝
+ ██║  ██║█████╗  ██║   ██║██████╔╝██║   ██║██║     ███████╗█████╗  
+ ██║  ██║██╔══╝  ╚██╗ ██╔╝██╔═══╝ ██║   ██║██║     ╚════██║██╔══╝  
+ ██████╔╝███████╗ ╚████╔╝ ██║     ╚██████╔╝███████╗███████║███████╗
+ ╚═════╝ ╚══════╝  ╚═══╝  ╚═╝      ╚═════╝ ╚══════╝╚══════╝╚══════╝
+"""
+
+
+def print_banner() -> None:
+    """Print the DevPulse ASCII banner with a tagline."""
+    console.print(BANNER, style="bold cyan", highlight=False)
+    console.print(
+        Align.center("[dim cyan]⚡ Developer Productivity Tracker  •  v1.0.0[/dim cyan]")
+    )
+    console.print()
+
+
+# ── Stat cards ────────────────────────────────────────────────────────────────
+
+def stat_card(label: str, value: str, icon: str = "", colour: str = "cyan") -> Panel:
+    """Return a small Rich Panel acting as a stat card."""
+    body = Text(justify="center")
+    body.append(f"{icon} " if icon else "", style=f"bold {colour}")
+    body.append(value, style=f"bold {colour}")
+    return Panel(body, title=f"[dim]{label}[/dim]", border_style=colour, padding=(0, 2))
+
+
+def print_stat_row(stats: list[tuple[str, str, str, str]]) -> None:
+    """
+    Print a row of stat cards.
+    Each stat is (label, value, icon, colour).
+    """
+    cards = [stat_card(label, value, icon, colour) for label, value, icon, colour in stats]
+    console.print(Columns(cards, equal=True, expand=True))
+
+
+# ── Quote display ─────────────────────────────────────────────────────────────
+
+def print_quote(quote: str, author: str) -> None:
+    """Render a motivational quote in a styled panel."""
+    text = Text(justify="center")
+    text.append(f'"{quote}"\n\n', style="italic white")
+    text.append(f"— {author}", style="bold cyan")
+
+    console.print(
+        Panel(
+            Align.center(text),
+            title="[bold cyan]✨ Quote of the Day[/bold cyan]",
+            border_style="cyan",
+            padding=(1, 4),
+        )
+    )
+
+
+# ── Streak display ────────────────────────────────────────────────────────────
+
+def print_streak(current: int, longest: int) -> None:
+    """Render streak info with a flame visual."""
+    flame_colours = ["red", "dark_orange", "orange1", "yellow1", "bright_yellow"]
+
+    # build a little flame bar proportional to the streak
+    width = min(current, 30)
+    flame_bar = Text()
+    for i in range(width):
+        colour = flame_colours[i % len(flame_colours)]
+        flame_bar.append("🔥", style=colour)
+
+    body = Text(justify="center")
+    body.append(f"\n{current}", style="bold bright_yellow")
+    body.append(" day streak\n\n", style="bold white")
+    body.append_text(flame_bar)
+    body.append(f"\n\nAll-time best: ", style="dim white")
+    body.append(f"{longest} days", style="bold cyan")
+
+    console.print(
+        Panel(
+            Align.center(body),
+            title="[bold yellow]🔥 Coding Streak[/bold yellow]",
+            border_style="yellow",
+            padding=(1, 4),
+        )
+    )
+
+
+# ── Task list ─────────────────────────────────────────────────────────────────
+
+def print_tasks(tasks: list[dict], title: str = "Today's Tasks") -> None:
+    """Render a list of tasks in a Rich table."""
+    table = Table(
+        title=title,
+        box=box.SIMPLE_HEAD,
+        border_style="cyan",
+        header_style="bold cyan",
+        show_lines=False,
+    )
+    table.add_column("#", style="dim", width=4)
+    table.add_column("Date", style="cyan", width=12)
+    table.add_column("Task", style="white")
+
+    for i, task in enumerate(tasks, start=1):
+        table.add_row(str(i), task["date"], task["description"])
+
+    if not tasks:
+        console.print(Panel("[dim]No tasks logged yet.[/dim]", border_style="dim"))
+    else:
+        console.print(table)
+
+
+# ── Weekly summary table ──────────────────────────────────────────────────────
+
+def print_weekly_summary(hours_by_date: dict[str, float]) -> None:
+    """Print last 7 days as a table with a simple bar chart."""
+    from datetime import timedelta
+
+    today = date.today()
+    table = Table(
+        title="[bold cyan]📅 Last 7 Days[/bold cyan]",
+        box=box.SIMPLE_HEAD,
+        border_style="cyan",
+        header_style="bold cyan",
+        show_lines=False,
+    )
+    table.add_column("Date", style="cyan", width=12)
+    table.add_column("Day", width=5)
+    table.add_column("Hours", justify="right", width=8)
+    table.add_column("Progress", min_width=20)
+
+    day_names = ["Mon", "Tue", "Wed", "Thu", "Fri", "Sat", "Sun"]
+    total = 0.0
+
+    for offset in range(6, -1, -1):
+        d = today - timedelta(days=offset)
+        iso = d.isoformat()
+        h = hours_by_date.get(iso, 0.0)
+        total += h
+        bar_len = int(h * 4)           # 4 blocks per hour
+        bar = "█" * bar_len
+        colour = "green" if h >= 2 else ("yellow" if h > 0 else "grey30")
+        table.add_row(
+            iso,
+            day_names[d.weekday()],
+            f"{h:.1f} h",
+            f"[{colour}]{bar}[/{colour}]",
+        )
+
+    console.print(table)
+    console.print(f"  [bold]Weekly total:[/bold] [cyan]{total:.1f} h[/cyan]  |  "
+                  f"[bold]Average:[/bold] [cyan]{total/7:.1f} h/day[/cyan]")
+
+
+# ── Session status ────────────────────────────────────────────────────────────
+
+def print_session_started(session_id: int) -> None:
+    console.print(
+        Panel(
+            f"[bold green]▶  Session #{session_id} started[/bold green]\n"
+            f"[dim]Run [cyan]devpulse stop[/cyan] when you're done.[/dim]",
+            border_style="green",
+            padding=(1, 2),
+        )
+    )
+
+
+def print_session_stopped(hours: float) -> None:
+    console.print(
+        Panel(
+            f"[bold cyan]⏹  Session ended[/bold cyan]\n"
+            f"[green]Logged [bold]{hours:.2f} hours[/bold] — great work! 💪[/green]",
+            border_style="cyan",
+            padding=(1, 2),
+        )
+    )

raj_devpulse_cli-1.0.1.dist-info/METADATA

@@ -0,0 +1,221 @@
+Metadata-Version: 2.4
+Name: raj-devpulse-cli
+Version: 1.0.1
+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>

raj_devpulse_cli-1.0.1.dist-info/RECORD

@@ -0,0 +1,13 @@
+devpulse/__init__.py,sha256=yKkppoybJkwiJoXyKxkNde-oh_KBjieVXQpo8MbmUpk,207
+devpulse/cli.py,sha256=TKGg2rNNuOyugjfYAhP-WQGsl7oWEKNqKO2sTTNzQYM,9783
+devpulse/db.py,sha256=lM-UIqES-Q4qbC4cLMLWhx9FyTt8i7amOq2oj_JrJaU,7428
+devpulse/export.py,sha256=-NdOCmFc-W_MIAMQcYIxKS2XUO86rGu4a5sJTrtcdj8,2839
+devpulse/heatmap.py,sha256=uWnbXB5hAQxQSY1FT2HMsT7V43HUQeB5gd9kWVVMc8Q,3403
+devpulse/quotes.py,sha256=pLfsrfk_yQ8GEREnMzIR5JOM5s2ty2TseJ63V-ag-pQ,3027
+devpulse/ui.py,sha256=LcTG8otogdorIqEgnC0TE1jJGVc__hZ7gSTqSjeaSc0,8223
+raj_devpulse_cli-1.0.1.dist-info/licenses/LICENSE,sha256=OphKV48tcMv6ep-7j-8T6nycykPT0g8ZlMJ9zbGvdPs,1066
+raj_devpulse_cli-1.0.1.dist-info/METADATA,sha256=5Jt1R7Y5CRqa5FrT_Aa5ISNoaNpAUKxXTMY-19xi6sU,5344
+raj_devpulse_cli-1.0.1.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
+raj_devpulse_cli-1.0.1.dist-info/entry_points.txt,sha256=HUztpqE7DJJPJsO2zf2b6q-WtauEKQ4c_nThB0sXngc,47
+raj_devpulse_cli-1.0.1.dist-info/top_level.txt,sha256=XpqTfIq2CyIy--wH624_mgbzG1Q1rDdqK1BbH9ScHkY,9
+raj_devpulse_cli-1.0.1.dist-info/RECORD,,

raj_devpulse_cli-1.0.1.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (82.0.1)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

raj_devpulse_cli-1.0.1.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+devpulse = devpulse.cli:main

raj_devpulse_cli-1.0.1.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Your Name
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

raj_devpulse_cli-1.0.1.dist-info/top_level.txt

@@ -0,0 +1 @@
+devpulse