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

Трекер времени по проектам

Запускает и останавливает учёт времени, сохраняя сессии в JSONL-журнал.

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

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

Команда start фиксирует проект, заметку и время начала, а stop считает длительность и дописывает запись в журнал. Состояние хранится отдельно, поэтому незакрытую сессию видно через status. Журнал только дополняется, что упрощает последующий отчёт.

Запуск

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

python time_tracker.py start --project website --note "Правки макета"

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

Примеры

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

  • python time_tracker.py start --project website
  • python time_tracker.py status
  • python time_tracker.py stop
Зависимости

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

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

time_tracker.py

#!/usr/bin/env python3
"""Учёт времени по проектам с журналом JSONL."""
from __future__ import annotations

import argparse
import json
from datetime import datetime
from pathlib import Path

DEFAULT_DIR = Path.home() / ".productivity"
DEFAULT_LOG = DEFAULT_DIR / "time.jsonl"
DEFAULT_STATE = DEFAULT_DIR / "time_state.json"


def now() -> datetime:
    return datetime.now().astimezone()


def read_state(path: Path) -> dict | None:
    if not path.exists():
        return None
    try:
        with path.open(encoding="utf-8") as handle:
            data = json.load(handle)
    except json.JSONDecodeError:
        raise SystemExit(f"Состояние повреждено: {path}")
    return data if isinstance(data, dict) else None


def write_state(path: Path, data: dict) -> None:
    path.parent.mkdir(parents=True, exist_ok=True)
    path.write_text(json.dumps(data, ensure_ascii=False, indent=2) + "\n", encoding="utf-8")


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


def command_start(args: argparse.Namespace) -> int:
    if read_state(args.state):
        raise SystemExit("Сессия уже идёт. Сначала выполните stop или status.")
    state = {"project": args.project, "note": args.note, "start": now().isoformat()}
    write_state(args.state, state)
    print(f"Старт: {args.project} в {state['start']}")
    return 0


def command_stop(args: argparse.Namespace) -> int:
    state = read_state(args.state)
    if not state:
        raise SystemExit("Активной сессии нет")
    start = datetime.fromisoformat(state["start"])
    end = now()
    seconds = max(0, int((end - start).total_seconds()))
    event = {
        "project": state["project"],
        "note": state.get("note", ""),
        "start": start.isoformat(),
        "end": end.isoformat(),
        "seconds": seconds,
    }
    append_event(args.log, event)
    args.state.unlink(missing_ok=True)
    print(f"Стоп: {event['project']}, {format_duration(seconds)}")
    return 0


def command_status(args: argparse.Namespace) -> int:
    state = read_state(args.state)
    if not state:
        print("Активной сессии нет.")
        return 0
    start = datetime.fromisoformat(state["start"])
    seconds = max(0, int((now() - start).total_seconds()))
    print(f"Проект: {state['project']}")
    print(f"Начало: {start.strftime('%Y-%m-%d %H:%M:%S')}")
    print(f"Прошло: {format_duration(seconds)}")
    return 0


def command_list(args: argparse.Namespace) -> int:
    if not args.log.exists():
        print("Журнал пуст.")
        return 0
    events = []
    for line in args.log.read_text(encoding="utf-8").splitlines():
        if not line.strip():
            continue
        try:
            events.append(json.loads(line))
        except json.JSONDecodeError:
            continue
    for event in events[-args.limit :]:
        print(
            f"{event.get('start', '')[:16]}  {event.get('project', '?'):20}  "
            f"{format_duration(int(event.get('seconds', 0)))}  {event.get('note', '')}"
        )
    return 0


def format_duration(seconds: int) -> str:
    hours, remainder = divmod(seconds, 3600)
    minutes, secs = divmod(remainder, 60)
    if hours:
        return f"{hours}ч {minutes:02d}м"
    return f"{minutes}м {secs:02d}с"


def build_parser() -> argparse.ArgumentParser:
    parser = argparse.ArgumentParser(description="Трекер времени")
    parser.add_argument("--log", type=Path, default=DEFAULT_LOG)
    parser.add_argument("--state", type=Path, default=DEFAULT_STATE)
    sub = parser.add_subparsers(dest="command", required=True)

    start_parser = sub.add_parser("start", help="Начать сессию")
    start_parser.add_argument("--project", required=True)
    start_parser.add_argument("--note", default="")
    start_parser.set_defaults(func=command_start)

    stop_parser = sub.add_parser("stop", help="Завершить сессию")
    stop_parser.set_defaults(func=command_stop)

    status_parser = sub.add_parser("status", help="Показать текущую сессию")
    status_parser.set_defaults(func=command_status)

    list_parser = sub.add_parser("list", help="Показать последние сессии")
    list_parser.add_argument("--limit", type=int, default=20)
    list_parser.set_defaults(func=command_list)
    return parser


def main() -> int:
    args = build_parser().parse_args()
    if getattr(args, "limit", 1) < 1:
        raise SystemExit("--limit должен быть положительным")
    return args.func(args)


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

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

CLI 1.0.0

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

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

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

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

Категория

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

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