Продуктивность

Трекер привычек

Записывает отметки привычек в JSONL и считает текущую и лучшую серию дней.

Python Windows macOS Linux Средний
Скачать habit_tracker.py
Описание

Что делает скрипт

Привычки и отметки хранятся отдельными событиями, поэтому файл только дополняется. Команда stats показывает общее число выполнений и серии подряд. Повторная отметка за один день не создаёт дубликат.

Запуск

Быстрый старт

python habit_tracker.py add "Зарядка"

Скачайте файл, откройте терминал в папке со скриптом и выполните команду. В Linux и macOS интерпретатор может называться python3, в Windows - python или py.

Примеры

Другие варианты

  • python habit_tracker.py add "Чтение"
  • python habit_tracker.py done "Чтение"
  • python habit_tracker.py stats "Чтение"
Зависимости

Что понадобится

Python 3.10+ Только стандартная библиотека
Windows winget install Python.Python.3.12
macOS brew install python
Linux sudo apt install python3
Исходник

habit_tracker.py

#!/usr/bin/env python3
"""Трекер привычек на append-only журнале JSONL."""
from __future__ import annotations

import argparse
import json
from datetime import date, timedelta
from pathlib import Path

DEFAULT_DATA = Path.home() / ".productivity" / "habits.jsonl"


def read_events(path: Path) -> list[dict]:
    if not path.exists():
        return []
    events = []
    for line in path.read_text(encoding="utf-8").splitlines():
        if not line.strip():
            continue
        try:
            event = json.loads(line)
        except json.JSONDecodeError:
            continue
        if isinstance(event, dict):
            events.append(event)
    return events


def append_event(path: Path, event: dict) -> None:
    path.parent.mkdir(parents=True, exist_ok=True)
    with path.open("a", encoding="utf-8") as handle:
        handle.write(json.dumps(event, ensure_ascii=False) + "\n")


def habits_of(events: list[dict]) -> list[str]:
    return sorted({event.get("habit", "") for event in events if event.get("type") == "habit"})


def command_add(args: argparse.Namespace) -> int:
    name = args.habit.strip()
    if not name:
        raise SystemExit("Название привычки пустое")
    events = read_events(args.data)
    if name in habits_of(events):
        print("Такая привычка уже есть.")
        return 0
    append_event(args.data, {"type": "habit", "habit": name, "created": date.today().isoformat()})
    print(f"Привычка добавлена: {name}")
    return 0


def command_done(args: argparse.Namespace) -> int:
    name = args.habit.strip()
    events = read_events(args.data)
    if name not in habits_of(events):
        raise SystemExit(f"Привычка не найдена: {name}")
    day = date.fromisoformat(args.date) if args.date else date.today()
    for event in events:
        if event.get("type") == "done" and event.get("habit") == name and event.get("date") == day.isoformat():
            print("Отметка за этот день уже есть.")
            return 0
    append_event(args.data, {"type": "done", "habit": name, "date": day.isoformat()})
    print(f"Отмечено: {name}, {day.isoformat()}")
    return 0


def command_list(args: argparse.Namespace) -> int:
    events = read_events(args.data)
    habits = habits_of(events)
    if not habits:
        print("Привычек нет.")
        return 0
    for name in habits:
        count = sum(1 for event in events if event.get("type") == "done" and event.get("habit") == name)
        print(f"{name}: {count} отметок")
    return 0


def streaks(days: list[date]) -> tuple[int, int]:
    if not days:
        return 0, 0
    ordered = sorted(set(days))
    longest = 1
    current = 1
    for previous, following in zip(ordered, ordered[1:]):
        if following == previous + timedelta(days=1):
            current += 1
            longest = max(longest, current)
        else:
            current = 1
    today = date.today()
    latest = ordered[-1]
    if latest not in {today, today - timedelta(days=1)}:
        return 0, longest
    run = 1
    index = len(ordered) - 1
    while index > 0 and ordered[index] - ordered[index - 1] == timedelta(days=1):
        run += 1
        index -= 1
    return run, longest


def command_stats(args: argparse.Namespace) -> int:
    events = read_events(args.data)
    name = args.habit.strip()
    if name not in habits_of(events):
        raise SystemExit(f"Привычка не найдена: {name}")
    days = []
    for event in events:
        if event.get("type") != "done" or event.get("habit") != name:
            continue
        try:
            days.append(date.fromisoformat(str(event.get("date", ""))))
        except ValueError:
            continue
    current, longest = streaks(days)
    print(f"Привычка: {name}")
    print(f"Всего отметок: {len(set(days))}")
    print(f"Текущая серия: {current} дн.")
    print(f"Лучшая серия: {longest} дн.")
    return 0


def build_parser() -> argparse.ArgumentParser:
    parser = argparse.ArgumentParser(description="Трекер привычек")
    parser.add_argument("--data", type=Path, default=DEFAULT_DATA)
    sub = parser.add_subparsers(dest="command", required=True)

    add_parser = sub.add_parser("add", help="Добавить привычку")
    add_parser.add_argument("habit")
    add_parser.set_defaults(func=command_add)

    done_parser = sub.add_parser("done", help="Отметить выполнение")
    done_parser.add_argument("habit")
    done_parser.add_argument("--date", default="")
    done_parser.set_defaults(func=command_done)

    list_parser = sub.add_parser("list", help="Показать привычки")
    list_parser.set_defaults(func=command_list)

    stats_parser = sub.add_parser("stats", help="Показать серии")
    stats_parser.add_argument("habit")
    stats_parser.set_defaults(func=command_stats)
    return parser


def main() -> int:
    args = build_parser().parse_args()
    return args.func(args)


if __name__ == "__main__":
    raise SystemExit(main())

Скрипты работают с файлами и настройками системы. Перед запуском прочитайте код и проверьте пути. Особенно если скрипт удаляет, перезаписывает или перемещает данные.

CLI 1.0.0

Скачать без браузера

Команда скачает этот файл в текущую папку. CLI работает на Windows, macOS и Linux.

scriptdock get productivity-habit-tracker
  • Поиск по всему каталогу
  • Python 3.10+
  • Без внешних пакетов
Скачать CLI

GUI-версия готовится. Подробнее

Категория

Продуктивность

Заметки, время, задачи, напоминания и автоматизация рутины.