Трекер привычек
Записывает отметки привычек в JSONL и считает текущую и лучшую серию дней.
Что делает скрипт
Привычки и отметки хранятся отдельными событиями, поэтому файл только дополняется. Команда 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 "Чтение"
Что понадобится
winget install Python.Python.3.12
brew install python
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())
Скрипты работают с файлами и настройками системы. Перед запуском прочитайте код и проверьте пути. Особенно если скрипт удаляет, перезаписывает или перемещает данные.