Expose message ID list from `ReferencesHeader`

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

Inizia leggendo ReferencesHeader e l’API esistente di AddressHeader, quindi esamina come ReferencesHeader espone attualmente i propri dati privati _parse_tree. Rendi disponibili gli ID dei messaggi tramite l’interfaccia pubblica degli header, in modo che l’uso mostrato di In-Reply-To e References funzioni senza accesso privato, e verifica che i valori esposti conservino le informazioni esistenti sugli ID dei messaggi.