python / python/cpython

Expose message ID list from `ReferencesHeader`

Ouverte Adaptée aux débutants
#148,797 3 commentaires 0 réactions 0 personnes assignées Voir sur GitHub

Personne n'a encore pris cette issue.

stdlib topic-email type-feature
Langage dominant
Python
Étoiles
77.2k
Forks
35.9k
Métriques de merge des PR
Métriques de PR en attente

Description

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

Guide de contribution

Ouvrir le guide de contribution

Par où commencer

  1. Lisez l'issue en entier, puis le guide de contribution du projet.
  2. Signalez en commentaire que vous la prenez — cela évite que deux personnes fassent le même travail.
  3. Forkez le dépôt et travaillez sur une branche.
  4. Ouvrez une pull request qui référence le numéro de l'issue.

Piste de recherche

Commencez par lire ReferencesHeader et l’API existante de AddressHeader, puis examinez comment ReferencesHeader expose actuellement ses données privées _parse_tree. Rendez les IDs de message disponibles via l’interface publique des headers afin que l’utilisation présentée de In-Reply-To et References fonctionne sans accès privé, et vérifiez que les valeurs exposées préservent les informations existantes des IDs de message.

Rédigé par le modèle d'indexation à partir du texte de l'issue.

Évaluation

Stack technique
python
Domaine
backend
Type d'issue
Fonctionnalité
Difficulté
2/5
Temps estimé
1-3 heures
Activité
Calme
Clarté
Plutôt claire
Accessibilité débutants
70/100

Recevez les nouvelles issues par e-mail

Un résumé court des issues GitHub adaptées aux débutants.