240 行
9.6 KiB
Python
240 行
9.6 KiB
Python
|
|
# -*- coding: utf-8 -*-
|
||
|
|
from __future__ import annotations
|
||
|
|
|
||
|
|
import calendar
|
||
|
|
import uuid
|
||
|
|
from datetime import datetime, timedelta
|
||
|
|
from typing import Any, Callable
|
||
|
|
|
||
|
|
from .helpers import _safe_float, _single_line
|
||
|
|
|
||
|
|
|
||
|
|
MEMO_NOTE_COLORS = {"yellow", "blue", "green", "rose", "gray"}
|
||
|
|
MEMO_NOTE_REPEATS = {"none", "daily", "weekly", "monthly", "yearly"}
|
||
|
|
|
||
|
|
|
||
|
|
def clean_memo_note_content(value: Any, limit: int = 800) -> str:
|
||
|
|
text = str(value or "").replace("\r\n", "\n").replace("\r", "\n").strip()
|
||
|
|
lines = [" ".join(line.split()) for line in text.split("\n")]
|
||
|
|
return "\n".join(line for line in lines if line).strip()[:limit]
|
||
|
|
|
||
|
|
|
||
|
|
def normalize_memo_note(raw: Any, *, now: float = 0.0) -> dict[str, Any] | None:
|
||
|
|
if not isinstance(raw, dict):
|
||
|
|
return None
|
||
|
|
note_id = _single_line(raw.get("id"), 64)
|
||
|
|
title = _single_line(raw.get("title"), 60)
|
||
|
|
content = clean_memo_note_content(raw.get("content"), 800)
|
||
|
|
if not note_id or not (title or content):
|
||
|
|
return None
|
||
|
|
current = now if now > 0 else datetime.now().timestamp()
|
||
|
|
status = _single_line(raw.get("status"), 20).lower()
|
||
|
|
if status not in {"active", "completed"}:
|
||
|
|
status = "active"
|
||
|
|
repeat = _single_line(raw.get("repeat"), 20).lower()
|
||
|
|
if repeat not in MEMO_NOTE_REPEATS:
|
||
|
|
repeat = "none"
|
||
|
|
color = _single_line(raw.get("color"), 20).lower()
|
||
|
|
if color not in MEMO_NOTE_COLORS:
|
||
|
|
color = "yellow"
|
||
|
|
due_at = max(0.0, _safe_float(raw.get("due_at"), 0.0))
|
||
|
|
created_at = max(0.0, _safe_float(raw.get("created_at"), current)) or current
|
||
|
|
updated_at = max(created_at, _safe_float(raw.get("updated_at"), created_at))
|
||
|
|
return {
|
||
|
|
"id": note_id,
|
||
|
|
"title": title,
|
||
|
|
"content": content,
|
||
|
|
"color": color,
|
||
|
|
"pinned": bool(raw.get("pinned")),
|
||
|
|
"status": status,
|
||
|
|
"due_at": due_at,
|
||
|
|
"repeat": repeat,
|
||
|
|
"repeat_anchor_day": max(0, min(31, int(_safe_float(raw.get("repeat_anchor_day"), 0.0)))),
|
||
|
|
"repeat_anchor_month": max(0, min(12, int(_safe_float(raw.get("repeat_anchor_month"), 0.0)))),
|
||
|
|
"remind_enabled": bool(raw.get("remind_enabled", True)) and due_at > 0,
|
||
|
|
"created_at": created_at,
|
||
|
|
"updated_at": updated_at,
|
||
|
|
"completed_at": max(0.0, _safe_float(raw.get("completed_at"), 0.0)),
|
||
|
|
"last_completed_at": max(0.0, _safe_float(raw.get("last_completed_at"), 0.0)),
|
||
|
|
"completion_count": max(0, int(_safe_float(raw.get("completion_count"), 0.0))),
|
||
|
|
"last_reminder_offer_at": max(0.0, _safe_float(raw.get("last_reminder_offer_at"), 0.0)),
|
||
|
|
"last_reminder_attempt_at": max(0.0, _safe_float(raw.get("last_reminder_attempt_at"), 0.0)),
|
||
|
|
}
|
||
|
|
|
||
|
|
|
||
|
|
def memo_note_due_state(note: dict[str, Any], *, now: float) -> str:
|
||
|
|
if str(note.get("status") or "") == "completed":
|
||
|
|
return "completed"
|
||
|
|
due_at = _safe_float(note.get("due_at"), 0.0)
|
||
|
|
if due_at <= 0:
|
||
|
|
return "none"
|
||
|
|
delta = due_at - now
|
||
|
|
if delta < -60:
|
||
|
|
return "overdue"
|
||
|
|
if delta <= 30 * 60:
|
||
|
|
return "due"
|
||
|
|
if delta <= 24 * 3600:
|
||
|
|
return "today"
|
||
|
|
return "upcoming"
|
||
|
|
|
||
|
|
|
||
|
|
def advance_recurring_memo_due(
|
||
|
|
due_at: float,
|
||
|
|
repeat: str,
|
||
|
|
*,
|
||
|
|
now: float,
|
||
|
|
fromtimestamp: Callable[[float], datetime] = datetime.fromtimestamp,
|
||
|
|
anchor_day: int = 0,
|
||
|
|
anchor_month: int = 0,
|
||
|
|
) -> float:
|
||
|
|
repeat_key = str(repeat or "none").lower()
|
||
|
|
if due_at <= 0 or repeat_key not in MEMO_NOTE_REPEATS - {"none"}:
|
||
|
|
return 0.0
|
||
|
|
candidate = fromtimestamp(due_at)
|
||
|
|
target = fromtimestamp(now)
|
||
|
|
for _ in range(500):
|
||
|
|
if repeat_key == "daily":
|
||
|
|
candidate += timedelta(days=1)
|
||
|
|
elif repeat_key == "weekly":
|
||
|
|
candidate += timedelta(days=7)
|
||
|
|
elif repeat_key == "monthly":
|
||
|
|
year = candidate.year + (1 if candidate.month == 12 else 0)
|
||
|
|
month = 1 if candidate.month == 12 else candidate.month + 1
|
||
|
|
day = min(anchor_day or candidate.day, calendar.monthrange(year, month)[1])
|
||
|
|
candidate = candidate.replace(year=year, month=month, day=day)
|
||
|
|
elif repeat_key == "yearly":
|
||
|
|
year = candidate.year + 1
|
||
|
|
month = anchor_month or candidate.month
|
||
|
|
day = min(anchor_day or candidate.day, calendar.monthrange(year, month)[1])
|
||
|
|
candidate = candidate.replace(year=year, month=month, day=day)
|
||
|
|
if candidate > target:
|
||
|
|
return candidate.timestamp()
|
||
|
|
return 0.0
|
||
|
|
|
||
|
|
|
||
|
|
def memo_note_sort_key(note: dict[str, Any], *, now: float) -> tuple[Any, ...]:
|
||
|
|
status = str(note.get("status") or "active")
|
||
|
|
due_at = _safe_float(note.get("due_at"), 0.0)
|
||
|
|
due_bucket = 0 if due_at > 0 and due_at <= now else 1 if due_at > 0 else 2
|
||
|
|
due_sort = due_at if due_at > 0 else float("inf")
|
||
|
|
return (
|
||
|
|
1 if status == "completed" else 0,
|
||
|
|
0 if note.get("pinned") else 1,
|
||
|
|
due_bucket,
|
||
|
|
due_sort,
|
||
|
|
-_safe_float(note.get("updated_at"), 0.0),
|
||
|
|
)
|
||
|
|
|
||
|
|
|
||
|
|
def apply_memo_note_action(
|
||
|
|
raw_notes: Any,
|
||
|
|
payload: dict[str, Any],
|
||
|
|
*,
|
||
|
|
now: float,
|
||
|
|
fromtimestamp: Callable[[float], datetime] = datetime.fromtimestamp,
|
||
|
|
partial: bool = False,
|
||
|
|
) -> tuple[list[dict[str, Any]], dict[str, Any]]:
|
||
|
|
"""Apply one memo mutation and return normalized notes plus the affected note."""
|
||
|
|
source = raw_notes if isinstance(raw_notes, list) else []
|
||
|
|
notes = [note for note in (normalize_memo_note(item, now=now) for item in source) if note]
|
||
|
|
action = _single_line(payload.get("action"), 20).lower() or "save"
|
||
|
|
note_id = _single_line(payload.get("id"), 64)
|
||
|
|
existing = next((item for item in notes if item.get("id") == note_id), None) if note_id else None
|
||
|
|
|
||
|
|
if action == "delete":
|
||
|
|
if not existing:
|
||
|
|
raise ValueError("没有找到这张便签")
|
||
|
|
deleted = dict(existing)
|
||
|
|
return [item for item in notes if item.get("id") != note_id][-200:], deleted
|
||
|
|
|
||
|
|
if action in {"complete", "reopen", "pin", "unpin"}:
|
||
|
|
if not existing:
|
||
|
|
raise ValueError("没有找到这张便签")
|
||
|
|
if action == "reopen":
|
||
|
|
existing["status"] = "active"
|
||
|
|
existing["completed_at"] = 0.0
|
||
|
|
elif action == "pin":
|
||
|
|
existing["pinned"] = True
|
||
|
|
elif action == "unpin":
|
||
|
|
existing["pinned"] = False
|
||
|
|
elif existing.get("repeat") != "none" and _safe_float(existing.get("due_at"), 0.0) > 0:
|
||
|
|
existing["due_at"] = advance_recurring_memo_due(
|
||
|
|
_safe_float(existing.get("due_at"), 0.0),
|
||
|
|
str(existing.get("repeat") or "none"),
|
||
|
|
now=now,
|
||
|
|
fromtimestamp=fromtimestamp,
|
||
|
|
anchor_day=int(_safe_float(existing.get("repeat_anchor_day"), 0.0)),
|
||
|
|
anchor_month=int(_safe_float(existing.get("repeat_anchor_month"), 0.0)),
|
||
|
|
)
|
||
|
|
existing["status"] = "active"
|
||
|
|
existing["last_completed_at"] = now
|
||
|
|
existing["completion_count"] = int(_safe_float(existing.get("completion_count"), 0.0)) + 1
|
||
|
|
existing["last_reminder_offer_at"] = 0.0
|
||
|
|
existing["last_reminder_attempt_at"] = 0.0
|
||
|
|
else:
|
||
|
|
existing["status"] = "completed"
|
||
|
|
existing["completed_at"] = now
|
||
|
|
existing["last_completed_at"] = now
|
||
|
|
existing["completion_count"] = int(_safe_float(existing.get("completion_count"), 0.0)) + 1
|
||
|
|
existing["updated_at"] = now
|
||
|
|
return notes[-200:], existing
|
||
|
|
|
||
|
|
if action != "save":
|
||
|
|
raise ValueError("不支持的便签操作")
|
||
|
|
|
||
|
|
def value_for(key: str, default: Any) -> Any:
|
||
|
|
if partial and existing is not None and key not in payload:
|
||
|
|
return existing.get(key, default)
|
||
|
|
return payload.get(key, default)
|
||
|
|
|
||
|
|
title = _single_line(value_for("title", ""), 60)
|
||
|
|
content = clean_memo_note_content(value_for("content", ""), 800)
|
||
|
|
if not title and not content:
|
||
|
|
raise ValueError("标题和内容至少填写一项")
|
||
|
|
repeat = _single_line(value_for("repeat", "none"), 20).lower() or "none"
|
||
|
|
if repeat not in MEMO_NOTE_REPEATS:
|
||
|
|
repeat = "none"
|
||
|
|
color = _single_line(value_for("color", "yellow"), 20).lower() or "yellow"
|
||
|
|
if color not in MEMO_NOTE_COLORS:
|
||
|
|
color = "yellow"
|
||
|
|
due_at = max(0.0, _safe_float(value_for("due_at", 0.0), 0.0))
|
||
|
|
if due_at > datetime(2100, 1, 1).timestamp():
|
||
|
|
raise ValueError("到期时间超出支持范围")
|
||
|
|
if repeat != "none" and due_at <= 0:
|
||
|
|
raise ValueError("重复便签需要设置到期时间")
|
||
|
|
|
||
|
|
if existing is None:
|
||
|
|
existing = {
|
||
|
|
"id": f"memo-{uuid.uuid4().hex[:16]}",
|
||
|
|
"created_at": now,
|
||
|
|
"status": "active",
|
||
|
|
"completed_at": 0.0,
|
||
|
|
"last_completed_at": 0.0,
|
||
|
|
"completion_count": 0,
|
||
|
|
"last_reminder_offer_at": 0.0,
|
||
|
|
"last_reminder_attempt_at": 0.0,
|
||
|
|
}
|
||
|
|
notes.append(existing)
|
||
|
|
prior_due_at = _safe_float(existing.get("due_at"), 0.0)
|
||
|
|
existing.update({
|
||
|
|
"title": title,
|
||
|
|
"content": content,
|
||
|
|
"color": color,
|
||
|
|
"pinned": bool(value_for("pinned", False)),
|
||
|
|
"due_at": due_at,
|
||
|
|
"repeat": repeat,
|
||
|
|
"remind_enabled": bool(value_for("remind_enabled", True)) and due_at > 0,
|
||
|
|
"updated_at": now,
|
||
|
|
})
|
||
|
|
if due_at > 0 and due_at != prior_due_at:
|
||
|
|
due_dt = fromtimestamp(due_at)
|
||
|
|
existing["repeat_anchor_day"] = due_dt.day
|
||
|
|
existing["repeat_anchor_month"] = due_dt.month
|
||
|
|
if existing.get("status") == "completed" and bool(payload.get("reopen")):
|
||
|
|
existing["status"] = "active"
|
||
|
|
existing["completed_at"] = 0.0
|
||
|
|
if due_at != prior_due_at:
|
||
|
|
existing["last_reminder_offer_at"] = 0.0
|
||
|
|
existing["last_reminder_attempt_at"] = 0.0
|
||
|
|
return notes[-200:], existing
|