fossi-foundation/ciel

Introduce ciel-specific Python exceptions

Aperta

#131 aperta il 15 giu 2026

Vedi su GitHub
 (2 commenti) (0 reazioni) (0 assegnatari)Python (11 fork)auto 404
enhancementgood first issue

Metriche repository

Star
 (56 stelle)
Metriche merge PR
 (Metriche PR in attesa)

Descrizione

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.

Guida contributor

Direzione di ricerca
Crea classi di eccezione personalizzate che ereditano da ValueError, RuntimeError, ecc., e sostituisci tutti i sollevamenti diretti di eccezioni integrate nel codebase di ciel con queste eccezioni personalizzate.
Tech stack
python
Dominio
developer experience
Tipo issue
Refactoring
DifficoltàQuanto dovrebbe essere impegnativa per un nuovo contributor.
1
Tempo stimatoTempo stimato per completare e verificare uno scope piccolo.
Meno di 1 ora
Stato attivitàQuanto è probabile che la issue sia ancora attiva e reviewable.
Attiva
ChiarezzaQuanto chiaramente la issue descrive problema, scope e risultato atteso.
Chiara
Prerequisiti
Python
Adatta ai principiantiQuanto la issue è adatta a contributor alla prima esperienza.
90