Skip to content

feat(core): cron 表达式解析与调度器(#72) - #80

Merged
Antruly merged 3 commits into
masterfrom
feat/cron
Nov 21, 2026
Merged

Antruly merged 3 commits into
masterfrom
feat/cron

Conversation

@Antruly

@Antruly Antruly commented Nov 21, 2026 •

Copy link
Copy Markdown
Owner

Closes #72.

内容

新增 uvcpp_cron_schedule + uvcpp_cron(核心层,无外部依赖):

  • 表达式:5 段(分 时 日 月 周)或 6 段(秒 分 时 日 月 周);支持 *、n、a-b、a-b/n、逗号列表;越界/倒序/步长 0/段数不对 → 解析失败并给原因,不猜 JAN/@daily/L/W/#;
  • UTC 基准(容器/CI 里可复现;本地时间由调用方换算);
  • 日与周同时受限按 Vixie 的或语义:0 0 13 * 5 = 13 号或周五;
  • next_utc() 严格晚于给定时刻;5 年上限内无解返回 false(0 0 30 2 *);
  • uvcpp_cron 绑一条 uvcpp_loop,每任务一个 uvcpp_timer;错过不补、回调异常被吞掉并计 stats().errors;start/stop/clear/stats;
  • 解析与求下次时间可脱离循环单独用(纯函数)。

用例

cron_func:

  • 17 条解析(含 12 条非法:60 分、24 点、0 日、13 月、周 8、倒序区间、步长 0、非数字、空列表项…);
  • UTC 匹配:周一 10:30、13 号(周二)与周五(16 号)都命中、周三 14 号不命中(证"或"而非"与");
  • next_utc:*/15 10:07→10:15、跨月到 2/1 00:00、6 段下一秒、2 月 30 号无解;
  • 真循环调度:3 秒窗口里每任务 ≥1 拍;抛异常任务 errors≥1 且不影响正常任务。

验证

build-all 163/163、build-h3 / build-default 编过;check_docs / check_doc_lines / check_doc_versions / check_ci_layout 全绿。文档 doc/lowlevel-guide.md §11。

新增 `uvcpp_cron_schedule` + `uvcpp_cron`(`src/uvcpp/uvcpp_cron.*`):

- 表达式:5 段(分 时 日 月 周)或 6 段(秒 分 时 日 月 周),支持 `*`、`n`、
  `a-b`、`a-b/n`、逗号列表;越界/倒序/步长 0/段数不对一律解析失败并给原因,
  不猜 `JAN`/`@daily`/`L/W/#` 这些扩展;
- 时间基准 **UTC**(不读本机时区,容器/CI 里可复现);
- 日与周同时受限时按 Vixie 语义取"或"(`0 0 13 * 5` = 13 号或周五);
- `next_utc()` 严格晚于给定时刻,5 年上限内无解返回 false(`0 0 30 2 *`);
- `uvcpp_cron` 绑一条 `uvcpp_loop`,每任务一个 `uvcpp_timer`;错过不补,
  回调异常被吞掉并计 `stats().errors`,`start/stop/clear/stats` 齐全;
- 解析与求下次时间是纯函数,可脱离循环单独用。

用例 `cron_func`:17 条解析(含 12 条非法)、UTC 匹配(周一/13 号或周五的
"或"语义)、`*/15` 跨刻、跨月、6 段下一秒、2 月 30 号无解,以及真
`uvcpp_loop` 上每秒触发的调度(正常任务 + 抛异常任务并行,errors/runs/jobs
对账)。文档 `doc/lowlevel-guide.md` §11。

本地 build-all 163/163、build-h3/default 编过;文档门禁全绿。
@Antruly
Antruly merged commit ccb244f into master Nov 21, 2026
47 of 49 checks passed
@Antruly
Antruly deleted the feat/cron branch November 21, 2026 17:25
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

feat(webapp): add cron scheduler with timezone and overlap policy

1 participant