Document behavior of Path.symlink_to() when source already exists
Ouverte
Personne n'a encore pris cette issue.
docs
topic-pathlib
- Langage dominant
- Python
- Étoiles
- 77.2k
- Forks
- 35.9k
- Métriques de merge des PR
- Métriques de PR en attente
Description
Documentation
The documentation for Path.symlink_to() [1] does not mention what happens when the source already exists, e.g.:
>>> from pathlib import Path
>>> Path("source").symlink_to("target1")
>>> Path("source").symlink_to("target2")
Traceback (most recent call last):
File "<python-input-2>", line 1, in <module>
Path("source").symlink_to("target2")
~~~~~~~~~~~~~~~~~~~~~~~~~^^^^^^^^^^^
File "/usr/lib/python3.13/pathlib/_local.py", line 789, in symlink_to
os.symlink(target, self, target_is_directory)
~~~~~~~~~~^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
FileExistsError: [Errno 17] File exists: 'target2' -> 'source'
(The same applies to os.symlink [2] by the way)
Linked PRs
- gh-132704
- gh-132810
Guide de contribution
Ouvrir le guide de contribution
Par où commencer
- Lisez l'issue en entier, puis le guide de contribution du projet.
- Signalez en commentaire que vous la prenez — cela évite que deux personnes fassent le même travail.
- Forkez le dépôt et travaillez sur une branche.
- Ouvrez une pull request qui référence le numéro de l'issue.
Piste de recherche
Commencez par la documentation de pathlib.Path.symlink_to() liée dans l’issue, puis comparez la documentation de os.symlink() pour le même comportement. C’est terminé lorsque les deux entrées expliquent ce qui se passe lorsque le chemin de destination existe déjà, y compris l’exemple de FileExistsError présenté ici.
Rédigé par le modèle d'indexation à partir du texte de l'issue.
Évaluation
- Stack technique
- python
- Domaine
- documentation
- Type d'issue
- Documentation
- Difficulté
- 2/5
- Temps estimé
- 1-3 heures
- Activité
- À l'abandon
- Clarté
- Clairement spécifiée
- Accessibilité débutants
- 25/100