将时间分配记录稳定化为公共 API

• 是否有这方面的建议?

• [x]我已经搜索了现有的建议

您的特性请求与问题有关吗 ?

这是637号的更窄的后续. FileReader.get temperal aldication records ()'已经披露了时间火焰图所用的分配寿命数据,而Temperal Aldicord Record'和Interval'则以 memray.py'予以宣布。 然而,公共API文档中没有记录时间界面,其记录类型不从顶级"memray"命名空间导出.

因此,想要机器可读时间分配数据的用户无法分辨此界面是否被支持,或是否必须依赖于私人执行细节或解析生成的HTML报告.

描述你想要的解决方案

澄清并稳定现有的时间分配接口作为支持的公用API,而无需改变捕获格式或引入新的索引引擎.

狭义的第一个版本可包括:

• 记录`FileReader.get temperal aldication records ()'及其相接间隔的语义;
• 通过经核准的公共进口途径揭露临时分配记录 ' 和Interval ' ,或确定另一种可取的公共代表;
• 记录 " 相接线 " 、无期限寿命以及间隔指数和记忆快照之间的关系;
• 增加测试,将机器可读时间记录作为辅助接口,并对照现有时间火焰图所消耗的数据加以验证。

您是否希望直接稳定现有的记录类, 还是引入一个单独的文件包装或结果类型 ? 我很乐意实施你喜欢的狭义方法,包括类型声明、API文件和回归测试。

这一建议有意不包括持久性索引,新的捕获格式,模块或函数分组,或更高层次的查询引擎. 在支持基本的时间数据接口之后,可以分别审议这些问题。

您认为的替代品

用户目前可以调用现有方法,依靠`memray. memray'的类别,但这取决于强调的执行模块和无文件的语义。 解析时间火焰图 HTML 是另一个工作轮廓, 但它将下游分析结合到一个演示格式。 实施第637号文件提出的更广泛的分析,将同时处理更多的使用案例,但需要比这一更狭窄的第一步多得多的API和建筑设计.