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

Локальный календарь событий

Показывает месяц с событиями, хранит их в JSON и экспортирует в ICS.

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

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

Календарь выводит сетку месяца и отмечает дни, на которые есть события. Записи добавляются в локальный JSON-файл, а экспорт создаёт новый файл ICS для импорта в любой календарь. Внешние API и сетевые запросы не используются.

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

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

python local_calendar.py show --month 2026-11

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

Примеры

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

  • python local_calendar.py add --date 2026-11-12 --title "Встреча" --time 10:00
  • python local_calendar.py list --days 30
  • python local_calendar.py export --output plans.ics
Зависимости

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

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

local_calendar.py

#!/usr/bin/env python3
"""Локальный календарь с экспортом в ICS."""
from __future__ import annotations

import argparse
import calendar as month_calendar
import json
import os
import tempfile
from datetime import date, datetime, timedelta
from pathlib import Path

DEFAULT_DATA = Path.home() / ".productivity" / "events.json"
WEEKDAYS = ["Пн", "Вт", "Ср", "Чт", "Пт", "Сб", "Вс"]
MONTHS = [
    "январь", "февраль", "март", "апрель", "май", "июнь",
    "июль", "август", "сентябрь", "октябрь", "ноябрь", "декабрь",
]


def load(path: Path) -> list[dict]:
    if not path.exists():
        return []
    try:
        data = json.loads(path.read_text(encoding="utf-8"))
    except json.JSONDecodeError as error:
        raise SystemExit(f"Файл событий повреждён: {error}")
    if not isinstance(data, list):
        raise SystemExit("Ожидался список событий")
    return data


def save(path: Path, items: list[dict]) -> None:
    path.parent.mkdir(parents=True, exist_ok=True)
    if path.exists():
        path.with_name(path.name + ".bak").write_bytes(path.read_bytes())
    fd, temp_name = tempfile.mkstemp(prefix=path.name, suffix=".tmp", dir=path.parent)
    try:
        with os.fdopen(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 parse_month(value: str) -> tuple[int, int]:
    try:
        parsed = datetime.strptime(value, "%Y-%m")
    except ValueError:
        raise SystemExit("Месяц указывается в формате YYYY-MM")
    return parsed.year, parsed.month


def command_show(args: argparse.Namespace) -> int:
    if args.month:
        year, month = parse_month(args.month)
    else:
        today = date.today()
        year, month = today.year, today.month
    events = load(args.data)
    days = {item["date"] for item in events if item.get("date", "").startswith(f"{year:04d}-{month:02d}")}
    print(f"{MONTHS[month - 1]} {year}")
    print(" ".join(f"{name:>2}" for name in WEEKDAYS))
    for week in month_calendar.monthcalendar(year, month):
        cells = []
        for day in week:
            if day == 0:
                cells.append("  ")
            else:
                key = f"{year:04d}-{month:02d}-{day:02d}"
                cells.append(f"{day:2d}*" if key in days else f"{day:2d} ")
        print(" ".join(cells))
    print("* - есть событие")
    return 0


def command_add(args: argparse.Namespace) -> int:
    try:
        day = date.fromisoformat(args.date)
    except ValueError:
        raise SystemExit("Дата указывается в формате YYYY-MM-DD")
    if args.time:
        try:
            datetime.strptime(args.time, "%H:%M")
        except ValueError:
            raise SystemExit("Время указывается в формате HH:MM")
    if not args.title.strip():
        raise SystemExit("Название события пустое")
    events = load(args.data)
    events.append({"date": day.isoformat(), "time": args.time, "title": args.title.strip()})
    events.sort(key=lambda item: (item.get("date", ""), item.get("time", "")))
    save(args.data, events)
    print(f"Событие добавлено: {day.isoformat()} {args.title}")
    return 0


def command_list(args: argparse.Namespace) -> int:
    events = load(args.data)
    today = date.today()
    limit = today + timedelta(days=args.days)
    upcoming = [
        item for item in events
        if item.get("date") and today <= date.fromisoformat(item["date"]) <= limit
    ]
    if not upcoming:
        print("Событий в выбранном периоде нет.")
        return 0
    for item in sorted(upcoming, key=lambda row: (row["date"], row.get("time", ""))):
        prefix = f"{item['date']} {item.get('time', ''):>5}".rstrip()
        print(f"{prefix}  {item['title']}")
    return 0


def command_export(args: argparse.Namespace) -> int:
    output = args.output.expanduser()
    if output.exists() and not args.force:
        raise SystemExit(f"Файл уже существует: {output}. Добавьте --force для замены.")
    output.parent.mkdir(parents=True, exist_ok=True)
    lines = [
        "BEGIN:VCALENDAR",
        "VERSION:2.0",
        "PRODID:-//Popov.Dev//Local Calendar//RU",
        "CALSCALE:GREGORIAN",
    ]
    for index, item in enumerate(load(args.data), start=1):
        day = item.get("date", "")
        if not day:
            continue
        title = str(item.get("title", "Событие")).replace("\\", "\\\\").replace(";", "\\;").replace(",", "\\,")
        if item.get("time"):
            start = day.replace("-", "") + "T" + item["time"].replace(":", "") + "00"
            lines.extend([
                "BEGIN:VEVENT",
                f"UID:{day}-{index}@example.com",
                f"DTSTART:{start}",
                f"SUMMARY:{title}",
                "END:VEVENT",
            ])
        else:
            start = day.replace("-", "")
            lines.extend([
                "BEGIN:VEVENT",
                f"UID:{day}-{index}@example.com",
                f"DTSTART;VALUE=DATE:{start}",
                f"SUMMARY:{title}",
                "END:VEVENT",
            ])
    lines.append("END:VCALENDAR")
    output.write_text("\n".join(lines) + "\n", encoding="utf-8")
    print(f"Экспортировано в {output}")
    return 0


def build_parser() -> argparse.ArgumentParser:
    parser = argparse.ArgumentParser(description="Локальный календарь")
    parser.add_argument("--data", type=Path, default=DEFAULT_DATA)
    sub = parser.add_subparsers(dest="command", required=True)

    show_parser = sub.add_parser("show", help="Показать месяц")
    show_parser.add_argument("--month", default="")
    show_parser.set_defaults(func=command_show)

    add_parser = sub.add_parser("add", help="Добавить событие")
    add_parser.add_argument("--date", required=True)
    add_parser.add_argument("--title", required=True)
    add_parser.add_argument("--time", default="")
    add_parser.set_defaults(func=command_add)

    list_parser = sub.add_parser("list", help="Показать ближайшие события")
    list_parser.add_argument("--days", type=int, default=30)
    list_parser.set_defaults(func=command_list)

    export_parser = sub.add_parser("export", help="Экспорт в ICS")
    export_parser.add_argument("--output", type=Path, required=True)
    export_parser.add_argument("--force", action="store_true")
    export_parser.set_defaults(func=command_export)
    return parser


def main() -> int:
    args = build_parser().parse_args()
    if getattr(args, "days", 1) < 0:
        raise SystemExit("--days не может быть отрицательным")
    return args.func(args)


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

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

CLI 1.0.0

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

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

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

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

Категория

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

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