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

Список задач в JSON

Локальный список задач с идентификаторами, сроками и отметкой выполнения без облака.

Python Windows macOS Linux Новичок
Скачать todo.py
Описание

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

Скрипт хранит задачи в одном 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-10
  • python todo.py list --today
  • python todo.py done 3
Зависимости

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

Python 3.10+ Только стандартная библиотека
Windows winget install Python.Python.3.12
macOS brew install python
Linux 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())

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

CLI 1.0.0

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

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

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

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

Категория

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

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

Теги