fossi-foundation/ciel

Introduce ciel-specific Python exceptions

Aberta

#131 aberto em 15 de jun. de 2026

Ver no GitHub
 (2 comentários) (0 reação) (0 responsável)Python (11 forks)auto 404
enhancementgood first issue

Métricas do repositório

Stars
 (56 estrelas)
Métricas de merge de PR
 (Nenhuma PRs mesclada em 30d)

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.

Guia do colaborador

Direção de pesquisa
Crie classes de exceção personalizadas que herdam de ValueError, RuntimeError, etc., e substitua todos os lançamentos diretos de exceções internas no código do ciel por essas exceções personalizadas.
Pilha de tecnologia
python
Domain
developer experience
Tipo Issue
Refatoração
DifficultyDificuldade de implementação estimada para um novo contribuidor, de 1 para alterações muito pequenas a 5 para trabalho de nível especializado.
1
Tempo estimadoUm intervalo de tempo aproximado para um colaborador experiente investigar, implementar, testar e preparar um pull request.
Menos de 1 hora
Status da atividadeQuão disponível o issue aparece agora: novo, ativo, obsoleto, bloqueado ou aguardando entrada do mantenedor.
Ativo
ClarityCom que clareza o issue explica a mudança esperada, os critérios de aceitação e a próxima etapa.
Claro
Prerequisites
Python
Simpatia para novatosUma pontuação de 1 a 100 que estima o quão acessível este issue é para colaboradores iniciantes.
90