Локальный календарь событий
Показывает месяц с событиями, хранит их в JSON и экспортирует в ICS.
Что делает скрипт
Календарь выводит сетку месяца и отмечает дни, на которые есть события. Записи добавляются в локальный 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:00python local_calendar.py list --days 30python local_calendar.py export --output plans.ics
Что понадобится
winget install Python.Python.3.12
brew install python
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())
Скрипты работают с файлами и настройками системы. Перед запуском прочитайте код и проверьте пути. Особенно если скрипт удаляет, перезаписывает или перемещает данные.