Трекер времени по проектам
Запускает и останавливает учёт времени, сохраняя сессии в JSONL-журнал.
Что делает скрипт
Команда start фиксирует проект, заметку и время начала, а stop считает длительность и дописывает запись в журнал. Состояние хранится отдельно, поэтому незакрытую сессию видно через status. Журнал только дополняется, что упрощает последующий отчёт.
Быстрый старт
python time_tracker.py start --project website --note "Правки макета"
Скачайте файл, откройте терминал в папке со скриптом и выполните команду.
В Linux и macOS интерпретатор может называться python3, в Windows - python или py.
Другие варианты
python time_tracker.py start --project websitepython time_tracker.py statuspython time_tracker.py stop
Что понадобится
winget install Python.Python.3.12
brew install python
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())
Скрипты работают с файлами и настройками системы. Перед запуском прочитайте код и проверьте пути. Особенно если скрипт удаляет, перезаписывает или перемещает данные.