Повторяющиеся задачи
Создаёт задачи по правилам daily, weekly и monthly на выбранный период.
Что делает скрипт
Правила хранятся в 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-15python recurring_tasks.py --rules rules.json --output tasks.mdpython recurring_tasks.py --sample --output rules.example.json
Что понадобится
winget install Python.Python.3.12
brew install python
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())
Скрипты работают с файлами и настройками системы. Перед запуском прочитайте код и проверьте пути. Особенно если скрипт удаляет, перезаписывает или перемещает данные.