selftracker / database.py
Nakvi's picture
Upload 14 files
cd7bed1 verified
"""
FocusTrack - Database Layer
SQLite-based local storage. Zero cloud, zero accounts.
"""
import sqlite3
import json
import logging
from pathlib import Path
from datetime import datetime, date
from typing import Optional, List, Dict, Any
import threading
logger = logging.getLogger("focustrack.database")
DB_PATH = Path(__file__).parent / "data" / "activity.db"
class Database:
"""Thread-safe SQLite database manager for FocusTrack."""
def __init__(self, db_path: Path = DB_PATH):
self.db_path = db_path
self.db_path.parent.mkdir(exist_ok=True)
self._local = threading.local()
def _get_conn(self) -> sqlite3.Connection:
"""Get thread-local database connection."""
if not hasattr(self._local, "conn") or self._local.conn is None:
self._local.conn = sqlite3.connect(
str(self.db_path),
detect_types=sqlite3.PARSE_DECLTYPES | sqlite3.PARSE_COLNAMES,
check_same_thread=False,
)
self._local.conn.row_factory = sqlite3.Row
self._local.conn.execute("PRAGMA journal_mode=WAL")
self._local.conn.execute("PRAGMA synchronous=NORMAL")
return self._local.conn
@property
def conn(self) -> sqlite3.Connection:
return self._get_conn()
def initialize(self):
"""Create tables and default data."""
self.conn.executescript("""
CREATE TABLE IF NOT EXISTS activities (
id INTEGER PRIMARY KEY AUTOINCREMENT,
timestamp DATETIME NOT NULL,
app_name TEXT NOT NULL,
window_title TEXT NOT NULL,
duration_seconds INTEGER DEFAULT 0,
category TEXT DEFAULT 'uncategorized',
is_idle BOOLEAN DEFAULT 0
);
CREATE INDEX IF NOT EXISTS idx_activities_timestamp
ON activities(timestamp);
CREATE INDEX IF NOT EXISTS idx_activities_app
ON activities(app_name);
CREATE TABLE IF NOT EXISTS settings (
key TEXT PRIMARY KEY,
value TEXT NOT NULL
);
CREATE TABLE IF NOT EXISTS categories (
id INTEGER PRIMARY KEY AUTOINCREMENT,
name TEXT UNIQUE NOT NULL,
color TEXT DEFAULT '#6366f1',
keywords TEXT DEFAULT '[]',
apps TEXT DEFAULT '[]'
);
""")
self.conn.commit()
self._seed_defaults()
logger.info(f"Database ready at {self.db_path}")
def _seed_defaults(self):
"""Insert default settings and categories if not present."""
defaults = {
"idle_threshold_seconds": "300",
"heartbeat_interval": "5",
"theme": "dark",
"auto_start": "false",
"ignored_apps": '["Finder", "explorer.exe"]',
"tracker_running": "true",
}
for key, value in defaults.items():
self.conn.execute(
"INSERT OR IGNORE INTO settings (key, value) VALUES (?, ?)",
(key, value)
)
default_categories = [
("coding", "#22d3ee", '["code", "terminal", "vim", "emacs", "debug"]', '["code", "cursor", "vscode", "pycharm", "intellij", "xcode", "terminal", "iterm", "warp", "alacritty", "sublime", "atom", "neovim"]'),
("browsing", "#f59e0b", '["http", "www", "chrome", "firefox", "safari"]', '["chrome", "firefox", "safari", "edge", "brave", "opera"]'),
("communication", "#10b981", '["mail", "slack", "teams", "discord", "zoom"]', '["slack", "discord", "teams", "zoom", "meet", "mail", "outlook", "telegram", "whatsapp"]'),
("design", "#a78bfa", '["figma", "sketch", "photoshop", "illustrator"]','["figma", "sketch", "photoshop", "illustrator", "xd", "canva", "affinity"]'),
("documents", "#fb923c", '["word", "excel", "sheets", "docs", "notion"]', '["word", "excel", "notion", "obsidian", "pages", "numbers", "libreoffice"]'),
("media", "#f43f5e", '["youtube", "spotify", "vlc", "netflix"]', '["spotify", "vlc", "quicktime", "itunes", "music"]'),
("system", "#64748b", '["settings", "finder", "explorer"]', '["finder", "explorer", "systempreferences", "taskmanager"]'),
("idle", "#374151", '[]', '[]'),
]
for cat in default_categories:
self.conn.execute(
"INSERT OR IGNORE INTO categories (name, color, keywords, apps) VALUES (?,?,?,?)",
cat
)
self.conn.commit()
# ─── Activity CRUD ───────────────────────────────────────────────────────
def log_activity(self, timestamp: datetime, app_name: str, window_title: str,
duration_seconds: int, category: str, is_idle: bool):
self.conn.execute(
"""INSERT INTO activities
(timestamp, app_name, window_title, duration_seconds, category, is_idle)
VALUES (?,?,?,?,?,?)""",
(timestamp.isoformat(), app_name, window_title,
duration_seconds, category, int(is_idle))
)
self.conn.commit()
def get_activities(self, start: datetime, end: datetime,
search: str = "", limit: int = 500, offset: int = 0) -> List[Dict]:
query = """
SELECT * FROM activities
WHERE timestamp BETWEEN ? AND ?
"""
params: list = [start.isoformat(), end.isoformat()]
if search:
query += " AND (app_name LIKE ? OR window_title LIKE ? OR category LIKE ?)"
params += [f"%{search}%", f"%{search}%", f"%{search}%"]
query += " ORDER BY timestamp DESC LIMIT ? OFFSET ?"
params += [limit, offset]
rows = self.conn.execute(query, params).fetchall()
return [dict(r) for r in rows]
def get_activity_count(self, start: datetime, end: datetime, search: str = "") -> int:
query = "SELECT COUNT(*) FROM activities WHERE timestamp BETWEEN ? AND ?"
params: list = [start.isoformat(), end.isoformat()]
if search:
query += " AND (app_name LIKE ? OR window_title LIKE ? OR category LIKE ?)"
params += [f"%{search}%", f"%{search}%", f"%{search}%"]
return self.conn.execute(query, params).fetchone()[0]
def get_summary(self, start: datetime, end: datetime) -> Dict[str, Any]:
"""Aggregate stats for dashboard cards."""
row = self.conn.execute("""
SELECT
SUM(CASE WHEN is_idle=0 THEN duration_seconds ELSE 0 END) as focus_seconds,
SUM(CASE WHEN is_idle=1 THEN duration_seconds ELSE 0 END) as idle_seconds,
SUM(duration_seconds) as total_seconds,
COUNT(DISTINCT app_name) as unique_apps
FROM activities
WHERE timestamp BETWEEN ? AND ?
""", (start.isoformat(), end.isoformat())).fetchone()
return dict(row) if row else {}
def get_by_category(self, start: datetime, end: datetime) -> List[Dict]:
rows = self.conn.execute("""
SELECT category,
SUM(duration_seconds) as total_seconds,
COUNT(*) as sessions
FROM activities
WHERE timestamp BETWEEN ? AND ? AND is_idle=0
GROUP BY category
ORDER BY total_seconds DESC
""", (start.isoformat(), end.isoformat())).fetchall()
return [dict(r) for r in rows]
def get_by_app(self, start: datetime, end: datetime, limit: int = 10) -> List[Dict]:
rows = self.conn.execute("""
SELECT app_name, category,
SUM(duration_seconds) as total_seconds,
COUNT(*) as sessions
FROM activities
WHERE timestamp BETWEEN ? AND ? AND is_idle=0
GROUP BY app_name
ORDER BY total_seconds DESC
LIMIT ?
""", (start.isoformat(), end.isoformat(), limit)).fetchall()
return [dict(r) for r in rows]
def get_hourly_timeline(self, target_date: date) -> List[Dict]:
start = datetime.combine(target_date, datetime.min.time())
end = datetime.combine(target_date, datetime.max.time())
rows = self.conn.execute("""
SELECT strftime('%H', timestamp) as hour,
category,
SUM(duration_seconds) as total_seconds
FROM activities
WHERE timestamp BETWEEN ? AND ? AND is_idle=0
GROUP BY hour, category
ORDER BY hour
""", (start.isoformat(), end.isoformat())).fetchall()
return [dict(r) for r in rows]
def get_daily_totals(self, start: datetime, end: datetime) -> List[Dict]:
rows = self.conn.execute("""
SELECT date(timestamp) as day,
SUM(CASE WHEN is_idle=0 THEN duration_seconds ELSE 0 END) as focus_seconds,
SUM(CASE WHEN is_idle=1 THEN duration_seconds ELSE 0 END) as idle_seconds
FROM activities
WHERE timestamp BETWEEN ? AND ?
GROUP BY day
ORDER BY day
""", (start.isoformat(), end.isoformat())).fetchall()
return [dict(r) for r in rows]
def get_latest_activity(self) -> Optional[Dict]:
row = self.conn.execute(
"SELECT * FROM activities ORDER BY timestamp DESC LIMIT 1"
).fetchone()
return dict(row) if row else None
# ─── Settings ────────────────────────────────────────────────────────────
def get_setting(self, key: str, default: Any = None) -> Any:
row = self.conn.execute(
"SELECT value FROM settings WHERE key=?", (key,)
).fetchone()
return row[0] if row else default
def set_setting(self, key: str, value: Any):
self.conn.execute(
"INSERT OR REPLACE INTO settings (key, value) VALUES (?,?)",
(key, str(value))
)
self.conn.commit()
def get_all_settings(self) -> Dict[str, str]:
rows = self.conn.execute("SELECT key, value FROM settings").fetchall()
return {r[0]: r[1] for r in rows}
# ─── Categories ──────────────────────────────────────────────────────────
def get_categories(self) -> List[Dict]:
rows = self.conn.execute("SELECT * FROM categories ORDER BY name").fetchall()
return [dict(r) for r in rows]
def upsert_category(self, name: str, color: str, keywords: list, apps: list):
self.conn.execute("""
INSERT OR REPLACE INTO categories (name, color, keywords, apps)
VALUES (?,?,?,?)
""", (name, color, json.dumps(keywords), json.dumps(apps)))
self.conn.commit()
def delete_category(self, name: str):
self.conn.execute("DELETE FROM categories WHERE name=?", (name,))
self.conn.commit()
# ─── Maintenance ─────────────────────────────────────────────────────────
def clear_all_data(self):
self.conn.execute("DELETE FROM activities")
self.conn.commit()
logger.warning("All activity data cleared")
def get_db_size_mb(self) -> float:
try:
return self.db_path.stat().st_size / (1024 * 1024)
except Exception:
return 0.0