python / python/cpython

Expose message ID list from `ReferencesHeader`

未关闭 适合新手
#148,797 3 条评论 0 个 reaction 已指派 0 人 在 GitHub 查看

还没有人认领这个 Issue。

stdlib topic-email type-feature
主要语言
Python
星标
77.2k
派生
35.9k
PR 合并指标
PR 指标待抓取

描述

Feature or enhancement

Proposal:

When sending, parsing or validating mails which are replies to other mails it is necessary to access the message IDs from the In-Reply-To and References headers. These, however, are currently not exposed.

# Example use case
if "In-Reply-To" in msg and "References" in msg:
    [in_reply_to_token] = msg["In-Reply-To"].message_ids
    [*_, most_recent_reference_token] = msg["References"].message_ids

    if in_reply_to_token.value != most_recent_reference_token.value:
        raise ValueError(f"Error: References list end must match In-Reply-To message ID")

A workaround is to access the private _parse_tree property which does expose the message_id, though like any private property that should obviously be avoided. This is comparable to AddressHeader which already exposes addresses.

Has this already been discussed elsewhere?

This is a minor feature, which does not need previous discussion elsewhere

Links to previous discussion of this feature:

No response

贡献指南

打开贡献指南

从这里开始

  1. 先读完整个 Issue,再读项目的贡献指南。
  2. 在 Issue 下留言说明你要接手 —— 这能避免两个人做同样的事。
  3. Fork 仓库,在一个分支上完成修改。
  4. 提交 Pull Request,并在描述里引用这个 Issue 编号。

调研方向

先阅读 ReferencesHeader 和现有的 AddressHeader API,然后检查 ReferencesHeader 当前如何公开其私有的 _parse_tree 数据。通过公共 header 接口提供消息 ID,使所示的 In-Reply-To 和 References 用法无需私有访问即可工作,并验证公开的值保留现有的消息 ID 信息。

由索引模型根据 Issue 内容生成。

评估

技术栈
python
领域
backend
Issue 类型
功能
难度
2/5
预计耗时
1-3 小时
活跃度
冷清
描述清晰度
基本清楚
新手友好度
70/100

把新 issue 发到你的邮箱

精选适合新手参与的 GitHub issue 摘要。