fossi-foundation/ciel

Introduce ciel-specific Python exceptions

Ouverte

#131 ouverte le 15 juin 2026

Voir sur GitHub
 (2 commentaires) (0 réaction) (0 personne assignée)Python (11 forks)auto 404
enhancementgood first issue

Métriques du dépôt

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

Description

Description

Ciel currently raises normal ValueErrors, RuntimeErrors, etc. This is theoretically fine. but practically that means we have to capture all exceptions for purposes of presenting them to the users, which can include exceptions in other libraries and/or the Python standard library, and not show a traceback. This is a pretty poor user/developer experience.

Proposal

New exception classes should inherit from ValueErrors/RuntimeErrors to match the declared APIs, but ciel should raise exclusively these classes.

Guide contributeur

Direction de recherche
Créez des classes d'exception personnalisées héritant de ValueError, RuntimeError, etc., et remplacez tous les lancements directs d'exceptions intégrées dans la base de code de ciel par ces exceptions personnalisées.
Stack technique
python
Domaine
developer experience
Type d'issue
Refactorisation
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
Python
Accessibilité débutantScore de 1 à 100 estimant l'accessibilité de cette issue pour un premier contributeur.
90