rust-unofficial/patterns

Add double panic mentioning for RAII guards

Ouverte

#327 ouverte le 27 nov. 2022

Voir sur GitHubGuide contributeur
 (1 commentaire) (0 réaction) (0 personne assignée)Shell (292 forks)batch import
A-patternC-amendmentgood first issue

Métriques du dépôt

Stars
 (6 622 étoiles)
Métriques de merge PR
 (Aucune PR mergée en 30 j)

Description

I think it would be nice to mention that one should be careful when writing drop implementations on guards relatively to the double panic possibility when they find out about this pattern for the first time or are unaware of double panicking generally.

It might help someone inexperienced I suppose.

Guide contributeur

Direction de recherche
Familiarisez vous avec le modèle existant de gardiens RAII dans le dépôt Rust Patterns. Comprenez le comportement de double panique en Rust (paniquer pendant une panique provoque un abandon). Proposez un ajout concis à la documentation qui met en garde contre l'implémentation de Drop sur des gardiens susceptibles de paniquer et suggérez les meilleures pratiques (par exemple, ne pas paniquer dans Drop).
Stack technique
rust
Domaine
documentation
Type d'issue
Documentation
DifficultéDifficulté estimée pour un nouveau contributeur, de 1 pour un très petit changement à 5 pour un travail expert.
1
Temps estiméFourchette de temps approximative pour investiguer, implémenter, tester et préparer une pull request.
Moins d'une heure
Statut d'activitéDisponibilité apparente de l'issue : fraîche, active, ancienne, bloquée ou en attente d'un mainteneur.
Active
ClartéClarté avec laquelle l'issue explique le changement attendu, les critères d'acceptation et la prochaine étape.
Claire
Prérequis
RustRAIIpanic safety
Accessibilité débutantScore de 1 à 100 estimant l'accessibilité de cette issue pour un premier contributeur.
90