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

Повторяющиеся задачи

Создаёт задачи по правилам daily, weekly и monthly на выбранный период.

Python Windows macOS Linux Продвинутый
Скачать recurring_tasks.py
Описание

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

Правила хранятся в JSON: название, частота, дата начала и необязательная дата окончания. Скрипт разворачивает их в Markdown-чекбоксы с тегом @due и сохраняет результат в новый файл. Существующие файлы не перезаписываются без явного флага.

Перед запуском
  • Итоговый файл создаётся заново и не перезаписывается без --force.
Запуск

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

python recurring_tasks.py --rules rules.json --from 2026-11-09 --to 2026-11-30

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

Примеры

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

  • python recurring_tasks.py --rules rules.json --from 2026-11-09 --to 2026-11-15
  • python recurring_tasks.py --rules rules.json --output tasks.md
  • python recurring_tasks.py --sample --output rules.example.json
Зависимости

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

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

recurring_tasks.py

#!/usr/bin/env python3
"""Разворачивание повторяющихся задач в Markdown."""
from __future__ import annotations

import argparse
import calendar
import json
from datetime import date, timedelta
from pathlib import Path

FREQUENCIES = {"daily", "weekly", "monthly"}
SAMPLE = {
    "rules": [
        {"title": "Проверить почту", "every": "daily", "start": "2026-11-09", "tag": "work"},
        {"title": "Планёрка", "every": "weekly", "start": "2026-11-09", "tag": "team"},
        {"title": "Закрыть месяц", "every": "monthly", "start": "2026-11-30", "tag": "finance"},
    ]
}


def add_month(day: date) -> date:
    month = day.month
    year = day.year
    month += 1
    if month > 12:
        month = 1
        year += 1
    last = calendar.monthrange(year, month)[1]
    return date(year, month, min(day.day, last))


def load_rules(path: Path) -> list[dict]:
    try:
        data = json.loads(path.read_text(encoding="utf-8"))
    except json.JSONDecodeError as error:
        raise SystemExit(f"Ошибка JSON: {error}")
    rules = data.get("rules") if isinstance(data, dict) else data
    if not isinstance(rules, list):
        raise SystemExit("Ожидался список правил или объект с ключом rules")
    return rules


def expand(rule: dict, start: date, end: date) -> list[date]:
    title = str(rule.get("title", "")).strip()
    every = str(rule.get("every", "")).lower()
    if not title:
        raise SystemExit("У правила пустое поле title")
    if every not in FREQUENCIES:
        raise SystemExit(f"Неизвестная частота: {every}")
    try:
        current = date.fromisoformat(str(rule.get("start", "")))
    except ValueError:
        raise SystemExit(f"Неверная дата start в правиле: {title}")
    stop = end
    if rule.get("until"):
        try:
            stop = min(stop, date.fromisoformat(str(rule["until"])))
        except ValueError:
            raise SystemExit(f"Неверная дата until в правиле: {title}")
    result = []
    while current <= stop:
        if current >= start:
            result.append(current)
        if every == "daily":
            current += timedelta(days=1)
        elif every == "weekly":
            current += timedelta(days=7)
        else:
            current = add_month(current)
    return result


def main() -> int:
    parser = argparse.ArgumentParser(description="Повторяющиеся задачи")
    parser.add_argument("--rules", type=Path)
    parser.add_argument("--from", dest="start", default=date.today().isoformat())
    parser.add_argument("--to", dest="end", default=(date.today() + timedelta(days=30)).isoformat())
    parser.add_argument("--output", type=Path)
    parser.add_argument("--force", action="store_true")
    parser.add_argument("--sample", action="store_true", help="Записать пример правил")
    args = parser.parse_args()

    if args.sample:
        if not args.output:
            parser.error("Для --sample укажите --output")
        output = args.output.expanduser()
        if output.exists() and not args.force:
            parser.error(f"Файл уже существует: {output}")
        output.parent.mkdir(parents=True, exist_ok=True)
        output.write_text(json.dumps(SAMPLE, ensure_ascii=False, indent=2) + "\n", encoding="utf-8")
        print(f"Пример правил сохранён: {output}")
        return 0

    if not args.rules:
        parser.error("Укажите --rules или --sample")
    try:
        start = date.fromisoformat(args.start)
        end = date.fromisoformat(args.end)
    except ValueError:
        parser.error("Даты указываются в формате YYYY-MM-DD")
    if start > end:
        parser.error("--from не может быть позже --to")

    rows = []
    for rule in load_rules(args.rules.expanduser()):
        for day in expand(rule, start, end):
            tag = str(rule.get("tag", "")).strip()
            suffix = f" #{tag}" if tag else ""
            rows.append((day, f"- [ ] {rule['title']} @due({day.isoformat()}){suffix}"))
    rows.sort(key=lambda item: item[0])

    lines = ["# Повторяющиеся задачи", ""]
    current_day = None
    for day, line in rows:
        if day != current_day:
            lines.append(f"## {day.isoformat()}")
            lines.append("")
            current_day = day
        lines.append(line)
    text = "\n".join(lines).rstrip() + "\n"

    if args.output:
        output = args.output.expanduser()
        if output.exists() and not args.force:
            parser.error(f"Файл уже существует: {output}. Добавьте --force.")
        output.parent.mkdir(parents=True, exist_ok=True)
        output.write_text(text, encoding="utf-8")
        print(f"Сохранено задач: {len(rows)} в {output}")
    else:
        print(text, end="")
    return 0


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

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

CLI 1.0.0

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

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

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

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

Категория

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

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