Список задач в JSON
Локальный список задач с идентификаторами, сроками и отметкой выполнения без облака.
Что делает скрипт
Скрипт хранит задачи в одном JSON-файле и умеет добавлять, показывать, закрывать и удалять записи. Просроченные и сегодняшние задачи фильтруются отдельными флагами. Перед изменением файла создаётся резервная копия, а удаление требует явного подтверждения.
- Файл задач изменяется при add, done и remove. Рядом создаётся копия .bak.
Быстрый старт
python todo.py add "Позвонить клиенту" --due 2026-11-12
Скачайте файл, откройте терминал в папке со скриптом и выполните команду.
В Linux и macOS интерпретатор может называться python3, в Windows - python или py.
Другие варианты
python todo.py add "Проверить отчёт" --due 2026-11-10python todo.py list --todaypython todo.py done 3
Что понадобится
winget install Python.Python.3.12
brew install python
sudo apt install python3
todo.py
#!/usr/bin/env python3
"""Локальный список задач в JSON без облака."""
from __future__ import annotations
import argparse
import json
import os
import tempfile
from datetime import date
from pathlib import Path
DEFAULT_DATA = Path.home() / ".productivity" / "tasks.json"
def load(path: Path) -> list[dict]:
if not path.exists():
return []
try:
with path.open(encoding="utf-8") as handle:
data = json.load(handle)
except json.JSONDecodeError as error:
raise SystemExit(f"Файл задач повреждён: {error}")
if not isinstance(data, list):
raise SystemExit("Ожидался список задач в JSON")
return data
def save(path: Path, items: list[dict]) -> None:
path.parent.mkdir(parents=True, exist_ok=True)
if path.exists():
backup = path.with_name(path.name + ".bak")
backup.write_bytes(path.read_bytes())
handle_fd, temp_name = tempfile.mkstemp(prefix=path.name, suffix=".tmp", dir=path.parent)
try:
with os.fdopen(handle_fd, "w", encoding="utf-8") as handle:
json.dump(items, handle, ensure_ascii=False, indent=2)
handle.write("\n")
os.replace(temp_name, path)
finally:
if os.path.exists(temp_name):
os.unlink(temp_name)
def next_id(items: list[dict]) -> int:
return max((int(item.get("id", 0)) for item in items), default=0) + 1
def parse_due(value: str) -> str:
if not value:
return ""
try:
return date.fromisoformat(value).isoformat()
except ValueError:
raise SystemExit("Дата должна быть в формате YYYY-MM-DD")
def add_task(args: argparse.Namespace) -> int:
title = args.title.strip()
if not title:
raise SystemExit("Заголовок не может быть пустым")
items = load(args.data)
item = {
"id": next_id(items),
"title": title,
"done": False,
"created": date.today().isoformat(),
"due": parse_due(args.due),
}
items.append(item)
save(args.data, items)
print(f"Добавлено #{item['id']}: {item['title']}")
return 0
def list_tasks(args: argparse.Namespace) -> int:
items = load(args.data)
today = date.today().isoformat()
rows = []
for item in items:
if item.get("done") and not args.all:
continue
due = item.get("due", "")
if args.today and due != today:
continue
if args.overdue and (not due or due >= today or item.get("done")):
continue
rows.append(item)
rows.sort(key=lambda item: (item.get("due") or "9999-12-31", item.get("id", 0)))
if not rows:
print("Задач нет.")
return 0
for item in rows:
mark = "x" if item.get("done") else " "
due = f" до {item['due']}" if item.get("due") else ""
print(f"[{mark}] #{item['id']:>3} {item['title']}{due}")
return 0
def complete_task(args: argparse.Namespace) -> int:
items = load(args.data)
for item in items:
if int(item.get("id", 0)) == args.id:
if item.get("done"):
print(f"Задача #{args.id} уже выполнена.")
return 0
item["done"] = True
item["completed"] = date.today().isoformat()
save(args.data, items)
print(f"Выполнено #{args.id}: {item['title']}")
return 0
raise SystemExit(f"Задача #{args.id} не найдена")
def remove_task(args: argparse.Namespace) -> int:
items = load(args.data)
kept = [item for item in items if int(item.get("id", 0)) != args.id]
if len(kept) == len(items):
raise SystemExit(f"Задача #{args.id} не найдена")
if not args.yes:
raise SystemExit("Удаление меняет файл задач. Добавьте --yes для подтверждения.")
save(args.data, kept)
print(f"Удалено задач: {len(items) - len(kept)}")
return 0
def build_parser() -> argparse.ArgumentParser:
parser = argparse.ArgumentParser(description="Локальный список задач")
parser.add_argument("--data", type=Path, default=DEFAULT_DATA, help="Файл задач JSON")
sub = parser.add_subparsers(dest="command", required=True)
add_parser = sub.add_parser("add", help="Добавить задачу")
add_parser.add_argument("title")
add_parser.add_argument("--due", default="", help="Срок в формате YYYY-MM-DD")
add_parser.set_defaults(func=add_task)
list_parser = sub.add_parser("list", help="Показать задачи")
list_parser.add_argument("--all", action="store_true", help="Включая выполненные")
list_parser.add_argument("--today", action="store_true", help="Только на сегодня")
list_parser.add_argument("--overdue", action="store_true", help="Только просроченные")
list_parser.set_defaults(func=list_tasks)
done_parser = sub.add_parser("done", help="Отметить задачу выполненной")
done_parser.add_argument("id", type=int)
done_parser.set_defaults(func=complete_task)
remove_parser = sub.add_parser("remove", help="Удалить задачу")
remove_parser.add_argument("id", type=int)
remove_parser.add_argument("--yes", action="store_true", help="Подтвердить удаление")
remove_parser.set_defaults(func=remove_task)
return parser
def main() -> int:
args = build_parser().parse_args()
return args.func(args)
if __name__ == "__main__":
raise SystemExit(main())
Скрипты работают с файлами и настройками системы. Перед запуском прочитайте код и проверьте пути. Особенно если скрипт удаляет, перезаписывает или перемещает данные.