`packages_distributions` relies on setuptools implementation detail

Ouverte Adaptée aux débutants
#526 6 commentaires 0 réactions 0 personnes assignées Voir sur GitHub

Personne n'a encore pris cette issue.

Évaluation

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

Piste de recherche

Commencez par lire la documentation de packages_distributions et la section liée de importlib_metadata/init.py. Mettez à jour la documentation pour expliquer que les installations modifiables ne sont généralement pas censées fournir de noms de niveau supérieur, setuptools constituant l’exception historique, tout en mentionnant l’impact futur possible de PEP 794.

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

Description

documentation help wanted

This is a follow-up to https://github.com/python/importlib_metadata/issues/402.

packages_distributions reads top_level.txt to determine the names. This file isn't part of any PEP and to my knowledge only implemented by setuptools, as a historical artifact from eggs. This leads users to believe that build backends not supporting this function have a bug (https://github.com/astral-sh/uv/issues/16423).

Would it be possible to update the documentation to accurately reflect that this is not a problem with some PEP 660 build backends not supplying top-level names, but that this function is generally not expected to work with editable installs at all, with the historical exception of setuptools?

(This may change with PEP 794)

https://github.com/python/importlib_metadata/blob/95ecf2aa573a68d4624506f801ca70992a337f41/importlib_metadata/__init__.py#L1133-L1134

Langage dominant
Python
Étoiles
142
Forks
97
Aucune PR mergée en 30 j

Guide de contribution

Aucun guide de contribution indexé pour ce dépôt

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.

Autres issues de python/importlib_metadata

Toutes les issues de python/importlib_metadata

Issues similaires

Plus d'issues Python

Recevez les nouvelles issues par e-mail

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