chronaxis.batch.publication

把批量报告写入独占命名的新 JSON 文件。先完成写入和关闭，再用平台不覆盖原语发布：Windows 使用重命名，Linux 使用 renameat2 的 RENAME_NOREPLACE。目标已存在或平台能力不足时失败；不会因此删除已完成任务的结果。

这是模块参考。日常调用先查公开API索引；下划线对象和嵌套函数供维护者查阅。签名来自固定源码，公开类构造签名经实际Python接口核对。

相关类型

BatchReport、Path

对象导航

from pathlib import Path
from .models import BatchReport

write_batch_report

发布带本批时间的汇总文件。

write_batch_report(report: BatchReport) -> Path

参数

返回说明

实际报告路径。

异常说明

report 类型错误抛 TypeError；平台接口缺失或实际文件系统不支持不覆盖发布时抛 NotImplementedError。已有目标、写入、关闭或移动错误原样传播；关闭失败不安装报告。报告已发布后另有收尾失败时，异常的 published_report_path 指向实际报告；不删除已完成任务的结果。

副作用说明

只写本批目录的唯一暂存文件，失败不删除任务结果或覆盖已有报告。

返回类型：Path。

源码：src/chronaxis/batch/publication.py:14（行号属于 8904c2f744951857659abd40aaa3535d57faf53c）。

_write_batch_report

先完成可选的 fast 总量计算，再一次发布同一批报告。

_write_batch_report(report, extra)

参数

源码：src/chronaxis/batch/publication.py:23（行号属于 8904c2f744951857659abd40aaa3535d57faf53c）。